Django Admin Help
(django-admin is no longer supported!)
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
- http://github.com/semente/django-adminhelp
Installing & Setup
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 have to add 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', )
Contributing
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!
Copying conditions
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/.