pbp_com/apps/adzone/managers.py

import datetime

from django.db import models
from django.db.models import Q


class AdManager(models.Manager):
    """ A Custom Manager for ads """

    def get_random_ad(self, ad_category, ad_zone):
        """
        Returns a random advert that belongs to the specified category and zone
        
        """
        now = datetime.datetime.now()
        if ad_category=='':
            try:
                ad = self.get_query_set().filter(
                    zone__slug=ad_zone, enabled=True).filter(
                    # is expired or no expiration
                    Q(expires_on__gt=now) | Q(expires_on__isnull=True)
                ).order_by('?')[0]
            except IndexError:
                return None
        else:
            try:
                ad = self.get_query_set().filter(
                    category__slug=ad_category, zone__slug=ad_zone,
                    enabled=True).filter(
                    # is expired or no expiration
                    Q(expires_on__gt=now) | Q(expires_on__isnull=True)
                ).order_by('?')[0]
            except IndexError:
                return None

        return ad

    def enabled(self):
        return self.get_query_set().filter(enabled=True)