django-frontendadmin A a set of templatetags to allow an easy and unobstrusive way to edit model-data in the frontend of your page. ==================== django-frontendadmin ==================== django-frontendadmin is a set of templatetags to allow an easy and unobstrusive way to edit model-data in the frontend of your page. Example project =============== This package provides an easy example project, a weblog with comments. Here is a quick step-by-step guide how to get this running quickly: 1. Open your terminal and cd to the ``django-frontendadmin/example_project/`` directory. 2. ``$ ./manage.py syncdb`` and create a superuser. 3. ``$ ./manage.py loaddata testdata.json`` to load some sample data. 4. ``$ ./manage.py runserver`` and point your browser to ``http://127.0.0.1:8000/admin/``. 5. Authenticate yourself with the username/password you provided in step 2. 6. Go to the frontpage ``http://127.0.0.1:8000/`` and start playing. 7. Put some beer in your fridge and call me. :-) Quick installation instruction ============================== 1. Put ``frontendadmin`` in your ``INSTALLED_APPS`` in the settings.py of your django project. 2. Add ``django.core.context_processors.request`` to your ``TEMPLATE_CONTEXT_PROCESSORS`` in the settings.py of your django project. If this is not available (default since some days) put this snippet into your settings:: TEMPLATE_CONTEXT_PROCESSORS = ( 'django.core.context_processors.request', 'django.core.context_processors.auth', 'django.core.context_processors.debug', 'django.core.context_processors.i18n', 'django.core.context_processors.media', ) 3. Include frontendadmin urls in your urlsconf:: (r'^frontendadmin/', include('frontendadmin.urls')), 4. Load the ``frontendadmin_tags`` library in every template you want to use the frontendamin links. (see below):: {% load frontendadmin_tags %} 5. There are three templatetags to either create, change or delete objects:: {% frontendadmin_add queryset_of_objects %} {% frontendadmin_change object_to_change %} {% frontendadmin_delete object_to_delete %} Assumed that you have a weblog application and using generic-views, your template might look so:: {% for entry in object_list %} <div> <h2>{{ entry.title }}</h2> {{ entry.body }} <div> {% endfor %} A proper implementation of frontendadmin would be:: {% frontendadmin_add object_list %} {% for entry in object_list %} <div> <h2>{{ entry.title }}</h2> {{ entry.body }} {% frontendadmin_change entry %} {% frontendadmin_delete entry %} <div> {% endfor %} 6. Thats all. Frontendadmin will automatically check whether the current user has add/change/delete permissions for the given model. Frontendadmin has build-in ajax support using the jquery library. See the template-sources for details. License ======= The application is licensed under the ``New BSD License``. See the LICENSE File for details. Martin Mahner f931388de104836000e5231625a63bb561f9cc5b 0.3