Updating readme
parent
a63d4292b1
commit
ca1019765b
|
|
@ -0,0 +1,68 @@
|
||||||
|
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.admin 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_change` Optional[bool] - decides if changes should trigger confirmation
|
||||||
|
- `confirm_add` Optional[bool] - decides if additions should trigger confirmation
|
||||||
|
- `confirmation_fields` Optional[Array[string]] - sets which fields changes/additions should trigger confirmation
|
||||||
|
- `change_confirmation_template` Optional[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
|
||||||
|
|
||||||
|
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.
|
||||||
|
|
@ -0,0 +1 @@
|
||||||
|
|
||||||
|
|
@ -1,4 +1,3 @@
|
||||||
|
|
||||||
from django.contrib.admin.exceptions import DisallowedModelAdminToField
|
from django.contrib.admin.exceptions import DisallowedModelAdminToField
|
||||||
from django.contrib.admin.utils import flatten_fieldsets, unquote
|
from django.contrib.admin.utils import flatten_fieldsets, unquote
|
||||||
from django.core.exceptions import PermissionDenied
|
from django.core.exceptions import PermissionDenied
|
||||||
|
|
@ -6,10 +5,7 @@ from django.template.response import TemplateResponse
|
||||||
from django.contrib.admin.options import TO_FIELD_VAR
|
from django.contrib.admin.options import TO_FIELD_VAR
|
||||||
from django.utils.translation import gettext as _
|
from django.utils.translation import gettext as _
|
||||||
|
|
||||||
|
|
||||||
class AdminConfirmMixin(object):
|
class AdminConfirmMixin(object):
|
||||||
"""Generic AdminConfirm Mixin"""
|
|
||||||
|
|
||||||
# Should we ask for confirmation for changes?
|
# Should we ask for confirmation for changes?
|
||||||
confirm_change = None
|
confirm_change = None
|
||||||
|
|
||||||
|
|
|
||||||
|
|
@ -1,3 +1 @@
|
||||||
Django>=2.2.0
|
Django>=1.7.0
|
||||||
Sphinx~=3.2.1
|
|
||||||
sphinx-rtd-theme==0.1.8
|
|
||||||
4
setup.py
4
setup.py
|
|
@ -2,13 +2,13 @@ import os
|
||||||
from setuptools import setup
|
from setuptools import setup
|
||||||
|
|
||||||
here = os.path.abspath(os.path.dirname(__file__))
|
here = os.path.abspath(os.path.dirname(__file__))
|
||||||
README = open(os.path.join(here, 'README.rst')).read()
|
README = open(os.path.join(here, 'README.md')).read()
|
||||||
|
|
||||||
setup(
|
setup(
|
||||||
name='django-admin-confirm',
|
name='django-admin-confirm',
|
||||||
version='0.1',
|
version='0.1',
|
||||||
packages=['admin_confirm'],
|
packages=['admin_confirm'],
|
||||||
description='Adds confirmation to Django Admin change',
|
description='Adds confirmation to Django Admin changes and additions',
|
||||||
long_description=README,
|
long_description=README,
|
||||||
author='Thu Trang Pham',
|
author='Thu Trang Pham',
|
||||||
author_email='thuutrangpham@gmail.com',
|
author_email='thuutrangpham@gmail.com',
|
||||||
|
|
|
||||||
Loading…
Reference in New Issue