A help application for Django admin
Django Admin Help is a pluggable help system for Django Web Framework to be used with administration application.
Admin Help was inspired by help system of Django Grappelli.
Admin Help is in the Python Package Index (PyPI) and you can easily install the latest stable version of it using the tools pip or easy_install. Try:
pip install django-adminhelp
Alternatively, you can install Admin Help from source code running the follow command on directory that contains the file setup.py:
python setup.py install
Admin Help needs these softwares to run properly:
After installation you need configure your project to recognizes the Admin Help application adding 'adminhelp' to your INSTALLED_APPS setting and setup the project URLConf like follow:
urlpatterns = patterns('', # ... (r'^admin/help/', include('adminhelp.urls')), # put it before admin urls (r'^admin/', include(admin.site.urls)), )
Don’t forget to run the command syncdb.
Admin Help also provides templates to show a “help” button on some admin pages. You can setup the ModelAdmin you are interested like follow:
class ExampleAdmin(admin.ModelAdmin): change_list_template = 'adminhelp/admin/change_list.html' change_form_template = 'adminhelp/admin/change_form.html' ...
You will need add the django.core.context_processors.request on your TEMPLATE_CONTEXT_PROCESSORS to use these templates and the template tags help_link and help_list_item.
TEMPLATE_CONTEXT_PROCESSORS = ( # ... 'django.core.context_processors.request', )
If you find any problems in the code or documentation, please take 30 seconds to fill out a issue here.
The contributing with code or translation is MUCH-APPRECIATED. You feel free to fork or send patchs.
See AUTHORS file for a complete authors list of this application.
Thanks to Interaction Consortium for sponsoring the project. Donate you too!
Django Admin Help is free software; you can redistribute it and/or modify it under the terms of the GNU Lesser General Public License as published by the Free Software Foundation; either version 3 of the License, or (at your option) any later version.
Django Admin Help is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU Lesser General Public License for more details.
You should have received a copy of the GNU Lesser General Public License along with this program; see the file COPYING.LESSER. If not, see http://www.gnu.org/licenses/.