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.