-
- GitHub
- GitLab
- Bitbucket
-
By logging in you accept
our terms of service
and privacy policy
Mark a single record in a model as featured
pip install django-featured-item==0.4.1
Set up a model so that only one record can be featured at a time.
Think of the featured story on a news site. Only one article may be featured at a time. Similar to this, only one record have have a featured field be true at a time.
Models can have more than one featured field. Only one record can hold the featured spot per field.
Add featured_item to your INSTALLED_APPS:
INSTALLEDAPPS += ( 'featureditem', )
Add a FeaturedField to your model:
from django.db import models
from featured_item.fields import FeaturedField
class Story(models.Model):
title = models.CharField(max_length=255)
body = models.TextField()
featured = FeaturedField()
That is it! Now, only one record in model can have featured = True.
You can have multiple FeaturedFields per model:
class Story(models.Model):
title = models.CharField(max_length=255)
body = models.TextField()
home_page_feature = FeaturedField()
side_bar_feature = FeaturedField()
A featured item field can be unique amongst a subset of the collection, by
using the unique_on option. In the following example, each Author can have
one featured Book. There could be multiple featured Books in the whole
collection, but only one per Author:
from django.db import models
from featured_items.fields import FeaturedField
class Author(models.Model):
name = models.CharField(max_length=255)
class Book(models.Model):
name = models.CharField(max_length=255)
author = models.ForeignKey(Author)
featured = FeaturedField(unique_on=('author'))
The Tidelift Subscription provides access to a continuously curated stream of human-researched and maintainer-verified data on open source packages and their licenses, releases, vulnerabilities, and development practices.
Learn more →Something wrong with this page? Make a suggestion
Export .ABOUT file for this package
Last synced: 2021-12-15 14:15:43 UTC
Login to resync this project