django-admin-app-names-singleton

Django admin enhancer


License
MIT
Install
pip install django-admin-app-names-singleton==1.0

Documentation

Translate app names and allow singletons

This is a simple Django app to enable translation of app names in Django admin and allow the use of singletons. When an object is marked as a singleton only one instance will be allowed to exist.

Detailed documentation is in the "docs" directory.

Quick start

  1. Add "django_singleton_app_name" to your INSTALLED_APPS setting like this::

    INSTALLED_APPS = ( ... 'django_singleton_app_name', )

  2. Copy templates from django-admin-app-names-singleton/templates to your project's template directory. All app names will now be translated when possible. In order to add app names to .po files via "makemessages" create a python file "app_names.py" next to your "settings.py" file and paste the following import into it: "from django.utils.translation import ugettext_lazy as _". For each app you want to mark for translation add a line such as the following: _("") Example: _("auth")

  3. To mark a model as a singleton you must subclass that model from "django_singleton_app_name.models.SingletonBaseModel" And create a ModelAdmin for that model that subclasses "django_singleton_app_name.admin.SingletonModelAdmin" and overwrite the ModelAdmin's member "model" with the Model's class Example: class ContactInformation(SingletonBaseModel): address = models.CharField(max_length=65) email = models.EmailField()

    class ContactInfoAdmin(SingletonModelAdmin): model = ContactInformation