A help application for Django administration.
Python HTML
Switch branches/tags
Nothing to show
Latest commit 3536e4f Jul 16, 2015 @semente Update README.rst
Permalink
Failed to load latest commit information.
adminhelp release 0.1.2 May 15, 2012
.gitignore release 0.1.2 May 15, 2012
AUTHORS Added setup.py. Apr 13, 2010
COPYING.LESSER Added setup.py. Apr 13, 2010
MANIFEST.in add missing MANIFEST.in May 15, 2012
README.rst Update README.rst Jul 16, 2015
setup.py fix issue #3 May 15, 2012

README.rst

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:

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/.