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.
- Project page
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
or:
easy_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:
- Django 1.2+
- django-positions 0.4.1
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/.