Reusable singleton models for Django
django-singleton is a fork of Thomas Ashelford’s [django-singletons](https://github.com/tttallis/django-singletons).
I forked his code to include Django 1.4 compatibility, as well as to remove the delete button within the admin (see credit below). I had to rename the repository so that I could submit this to the Python Package Index.
[Code from Chris Church’s fork](https://github.com/ninemoreminutes/django-singletons/commit/9b231666b9027d3bd1159f3db8bce34701193bdd) - I am merely synthesizing all this..
## In Thomas’s words
I keep finding myself re-using this simple bit of code, so I thought I should open-source it, even though it’s not much more than a snippet.
A SingletonModel is a django model that only ever has one record. You can’t use the admin to create a new instance, or delete the existing one.
Some might argue that singleton models are an inefficient way of using a relational database, but in practice it’s no biggie - most web sites have some important one-off content (eg. the Home Page), and singleton models map well to how content editors generally think.
I suspect I have cadged some of this code from someone else (likely ex-colleague http://github.com/jphalip/), but a quick Google doesn’t show up anything like this already out there. So here it is. I hope you find it useful.
pip install django-singleton
To get the custom admin templates working, you need to add “singleton_models” to your INSTALLED_APPS
### Example Usage
from singleton_models.models import SingletonModel
- class HomePage(SingletonModel):
welcome = models.TextField()
- def __unicode__(self):
- return u”The Home Page” # something like this will make admin message strings more coherent
- class Meta:
- verbose_name = “Home Page” # once again this will make sure your admin UI doesn’t have illogical text verbose_name_plural = “Home Page”
from singleton_models.admin import SingletonModelAdmin from models import HomePage