Skip to main content

A help application for Django admin

Project description

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 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',
)

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 for sponsoring the project. Donate you too!

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

Project details


Release history Release notifications

This version
History Node

0.1.2

History Node

0.1.1

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Filename, size & hash SHA256 hash help File type Python version Upload date
django-adminhelp-0.1.2.tar.gz (10.9 kB) Copy SHA256 hash SHA256 Source None May 15, 2012

Supported by

Elastic Elastic Search Pingdom Pingdom Monitoring Google Google BigQuery Sentry Sentry Error logging CloudAMQP CloudAMQP RabbitMQ AWS AWS Cloud computing DataDog DataDog Monitoring Fastly Fastly CDN DigiCert DigiCert EV certificate StatusPage StatusPage Status page