|
|
||
|---|---|---|
| admin_confirm | ||
| tests | ||
| .gitignore | ||
| LICENSE | ||
| MANIFEST.in | ||
| Makefile | ||
| README.md | ||
| coverage.svg | ||
| pytest.ini | ||
| requirements.txt | ||
| screenshot.png | ||
| setup.py | ||
| tox.ini | ||
README.md
Django Admin Confirm
AdminConfirmMixin is a mixin for ModelAdmin to add confirmations to changes and additions.
It can be configured to add a confirmation page upon saving changes and/or additions on ModelAdmin.
Typical Usage:
from admin_confirm import AdminConfirmMixin
class MyModelAdmin(AdminConfirmMixin, ModelAdmin):
confirm_change = True
confirmation_fields = ['field1', 'field2']
Installation
Install django-admin-confirm by running:
pip install django-admin-confirm
Add to INSTALLED_APPS in your project settings before django.contrib.admin:
INSTALLED_APPS = [
...
'admin_confirm',
'django.contrib.admin',
...
]
Note that this project follows the template override rules of Django.
To override a template, your app should be listed before admin_confirm in INSTALLED_APPS.
Configuration Options
confirm_changeOptional[bool] - decides if changes should trigger confirmationconfirm_addOptional[bool] - decides if additions should trigger confirmationconfirmation_fieldsOptional[Array[string]] - sets which fields changes should trigger confirmationchange_confirmation_templateOptional[string] - path to custom html template to use
Note that setting confirmation_fields without setting confirm_change or confirm_add would not trigger confirmation.
Contribution & Appreciation
Contributions are most welcome :) Feel free to:
- address an issue
- raise an issue
- add more test cases
- add feature requests
Your appreciation is also very welcome :) Feel free to:
- star the project
- open an issue just to share your thanks
Feature List
This is a list of features which could potentially be added in the future. Some of which might make more sense in their own package.
- confirmations on changelist actions
- global actions on changelist page
- instance actions on change/view page
- action logs (adding actions to history of instances)
- add help tooltip/popover to any field for more info
- add help tooltop/popover/help button to admin actions on changelist
- run scripts from admin
- completed action summary page
- add top and bottom areas to instance pages which can be configured for any content
Support
If you are having issues, please let us know through raising an issue.
License
The project is licensed under the Apache 2.0 license.
