Installation¶
Installing django-adminactions is as simple as checking out the source and adding it to
your project or PYTHONPATH.
- First of all follow the instruction to install django_admin application,
- Either check out django-adminactions from GitHub or to pull a release off PyPI. Doing
pip install django-adminactionsoreasy_install django-adminactionsis all that should be required. - Either symlink the
adminactionsdirectory into your project or copy the directory in. What ever works best for you.
Install test dependencies¶
If you want to run adminactions tests you need extra requirements
pip install -U django-adminactions[tests]
Configuration¶
Add adminactions to your INSTALLED_APPS:
INSTALLED_APPS = (
'adminactions',
'django.contrib.admin',
'django.contrib.messages',
)
Add the actions to your site:
from django.contrib.admin import site
import adminactions.actions as actions
# register all adminactions
actions.add_to_site(site)
Add service url to your urls.py
urlpatterns = patterns('',
...
url(r'^adminactions/', include('adminactions.urls')),
)
- Bonus:
add AdminActionPermMixin to your ModelAdmin:
- class MyModelAdmin(AdminActionPermMixin, admin.ModelAdmin):
- pass
Add defaults for the Export to CSV to the Django Config. See all available settings at _export_as_csv.:
import csv
ADMINACTIONS_CSV_OPTIONS_DEFAULT = {
'date_format': 'Y-m-d',
'datetime_format': 'Y-m-d G:i:s O',
'time_format': 'G:i:s',
'header': True,
'quotechar': '"',
'quoting': csv.QUOTE_ALL,
'delimiter': ',',
'escapechar': '\\',
}