Updating readme

main
Thu Trang Pham 2020-11-01 21:11:33 -08:00
parent a63d4292b1
commit ca1019765b
6 changed files with 72 additions and 9 deletions

68
README.md 100644
View File

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

View File

View File

@ -0,0 +1 @@

View File

@ -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

View File

@ -1,3 +1 @@
Django>=2.2.0 Django>=1.7.0
Sphinx~=3.2.1
sphinx-rtd-theme==0.1.8

View File

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