Skip to main content

Adds confirmation to Django Admin changes and additions

Project description

Django Admin Confirm

coverage

AdminConfirmMixin is a mixin for ModelAdmin to add confirmations to changes and additions.

Screenshot of Confirmation Page

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

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

Project details


Download files

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

Source Distribution

django-admin-confirm-0.1-1.tar.gz (4.4 kB view hashes)

Uploaded Source

Built Distributions

django_admin_confirm-0.1-py3-none-any.whl (6.3 kB view hashes)

Uploaded Python 3

django_admin_confirm-0.1-1-py3-none-any.whl (5.0 kB view hashes)

Uploaded Python 3

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page