From 3a45fea0832c5910acee6e0d29f230f347a50462 Mon Sep 17 00:00:00 2001
From: Carlton Gibson <carlton.gibson@noumenal.es>
Date: Tue, 13 Jul 2021 16:06:12 +0200
Subject: Fixed #21936 -- Allowed DeleteView to work with custom Forms and
 SuccessMessageMixin.

Thanks to Mariusz Felisiak for review.

Co-authored-by: Demetris Stavrou <demestav@gmail.com>
Co-authored-by: Caroline Simpson <github@hoojiboo.com>
---
 docs/ref/class-based-views/generic-editing.txt | 21 +++++++++++++++++++++
 1 file changed, 21 insertions(+)

(limited to 'docs/ref')

diff --git a/docs/ref/class-based-views/generic-editing.txt b/docs/ref/class-based-views/generic-editing.txt
index cf0b7bc13c..cb03b531cc 100644
--- a/docs/ref/class-based-views/generic-editing.txt
+++ b/docs/ref/class-based-views/generic-editing.txt
@@ -275,12 +275,26 @@ editing content:
     * :class:`django.views.generic.base.TemplateResponseMixin`
     * :class:`django.views.generic.edit.BaseDeleteView`
     * :class:`django.views.generic.edit.DeletionMixin`
+    * :class:`django.views.generic.edit.FormMixin`
+    * :class:`django.views.generic.base.ContextMixin`
     * :class:`django.views.generic.detail.BaseDetailView`
     * :class:`django.views.generic.detail.SingleObjectMixin`
     * :class:`django.views.generic.base.View`
 
     **Attributes**
 
+    .. attribute:: form_class
+
+        .. versionadded:: 4.0
+
+        Inherited from :class:`~django.views.generic.edit.BaseDeleteView`. The
+        form class that will be used to confirm the request. By default
+        :class:`django.forms.Form`, resulting in an empty form that is always
+        valid.
+
+        By providing your own ``Form`` subclass, you can add additional
+        requirements, such as a confirmation checkbox, for example.
+
     .. attribute:: template_name_suffix
 
         The ``DeleteView`` page displayed to a ``GET`` request uses a
@@ -305,6 +319,7 @@ editing content:
 
         <form method="post">{% csrf_token %}
             <p>Are you sure you want to delete "{{ object }}"?</p>
+            {{ form }}
             <input type="submit" value="Confirm">
         </form>
 
@@ -319,4 +334,10 @@ editing content:
     This view inherits methods and attributes from the following views:
 
     * :class:`django.views.generic.edit.DeletionMixin`
+    * :class:`django.views.generic.edit.FormMixin`
     * :class:`django.views.generic.detail.BaseDetailView`
+
+    .. versionchanged:: 4.0
+
+        In older versions, ``BaseDeleteView`` does not inherit from
+        ``FormMixin``.
-- 
cgit v1.3