Metadata-Version: 2.0
Name: singleton-admin
Version: 1.0.0
Summary: A Django app that will only allow one instance of a model to be created via the admin site.
Home-page: https://github.com/tdsymonds/singleton_admin
Author: Tom Symonds
Author-email: tdsymonds@hotmail.com
License: MIT License
Keywords: admin singleton
Platform: UNKNOWN
Classifier: Environment :: Web Environment
Classifier: Framework :: Django
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: MIT License
Classifier: Operating System :: OS Independent
Classifier: Programming Language :: Python
Classifier: Programming Language :: Python :: 2.7
Classifier: Topic :: Internet :: WWW/HTTP
Classifier: Topic :: Internet :: WWW/HTTP :: Dynamic Content

===============
singleton-admin
===============

Using singleton-admin will allow users to only add one instance of a model via the django admin site. Once created, the instance can be updated and deleted, but additional instances cannot be created. 

This is useful if you'd like to store a page content in the database for example.

I found myself using this package (https://github.com/tttallis/django-singletons) a lot, but some of the code has now been depreciated through newer releases of Django.

I originally had the intention of forking the package and making the fixes, but in the end I ended up re-writing from scratch. The end goal is the same, but with a different approach.

I appreciate that there are probably plenty of packages out there that offer similar functionality, but as I've put this together and have used in my own projects, I thought I'd get it out there.




Quick start
-----------

1. Install singleton-admin.

2. Add "singleton_admin" to your INSTALLED_APPS::

    INSTALLED_APPS = [
        ...
        'singleton_admin',
    ]

3. In your apps admin.py file to make your model a singleton-admin you can either do::

    from singleton_admin.admin import SingletonAdmin

    admin.site.register(your_model, SingletonAdmin)


Or if you'd like to add your own admin class::

    from singleton_admin.admin import SingletonAdmin

    class your_model_admin(SingletonAdmin):
    	...

    admin.site.register(your_model, your_model_admin)




