Custom document upload form¶
Wagtail provides a way to use a custom document form by modifying the WAGTAILDOCS_DOCUMENT_FORM_BASE
setting. This setting allows you to extend the default document form with your custom fields and logic.
Here’s an example:
# settings.py
WAGTAILDOCS_DOCUMENT_FORM_BASE = 'myapp.forms.CustomDocumentForm'
# myapp/forms.py
from django import forms
from wagtail.documents.forms import BaseDocumentForm
class CustomDocumentForm(BaseDocumentForm):
terms_and_conditions = forms.BooleanField(
label="I confirm that this document was not created by AI.",
required=True,
)
def clean(self):
cleaned_data = super().clean()
if not cleaned_data.get("terms_and_conditions"):
raise forms.ValidationError(
"You must confirm the document was not created by AI."
)
return cleaned_data
Note
Any custom document form should extend the built-in BaseDocumentForm
class.