Skip to main content

The Wagtail Form Builder functionalities available for your models/snippets.

Project description

Wagtail Model Forms

Version CI

The Wagtail Form Builder functionalities available for your models/snippets.

Features

  • Well-known Form Builder functionalities
  • Form block for StreamField support
  • Extensible models (Form, FormSubmission, UploadedFile & FormBlock)
  • Inspect, edit and delete views for form submissions
  • File uploads
  • Reports
  • Email notifications
  • Webhooks & API integrations
  • Crispy forms support

Requirements

  • Python >= 3.8
  • Django >= 4.2
  • Wagtail >= 5.2

Installation

Install the package

pip install wagtail-model-forms

Add wagtail_model_forms to your INSTALLED_APPS

INSTALLED_APPS = [
    ...
    "wagtail_model_forms",
]

Create your models

from django.utils.functional import cached_property
from modelcluster.fields import ParentalKey
from wagtail.core.models import Page
from wagtail.snippets.models import register_snippet
from wagtail_model_forms.mixins import FormSnippetMixin
from wagtail_model_forms.models import AbstractForm, AbstractUploadedFile, AbstractFormSubmission


class FormSubmission(AbstractFormSubmission):
    form = models.ForeignKey(
        "Form",
        on_delete=models.CASCADE,
        related_name="+",
        verbose_name=_("Form"),
    )


class UploadedFile(AbstractUploadedFile):
    pass


@register_snippet
class Form(AbstractForm):
    @cached_property
    def edit_url(self):
        # return your url here, commonly your own modeladmin configuration
        url_helper = FormModelAdmin().url_helper
        return url_helper.get_action_url("edit", self.id)


class MyPage(FormSnippetMixin, Page):
    pass

In order to let the page now that there is a form on it (handle post methods, caching etc.) we need to make sure the method page_has_form returns True. To make your life easier you can set the property streamfields with the names of the StreamField which can have the form added. Also make sure the name of the block is matched, commonly called form in your list of blocks. In some cases you might want to override this method and implement your own bespoke logic here.

from wagtail_model_forms.blocks import FormBlock


class MyPage(FormSnippetMixin, Page):
    block_type = "form" # has by default already the value form
    streamfields = ["content"] # the name of your streamfields
    
    content = StreamField([
      # your other blocks
      ("form", FormBlock()),
    ])

More advanced with your bespoke implementation

from django.utils.functional import cached_property


class MyPage(FormSnippetMixin, Page):
    @cached_property
    def page_has_form(self):
        # your bespoke import in order to determine a form is on the page

It's not mandatory to use the register_snippet functionality. You can e.g. use wagtailmodelchooser for it or any other bespoke implementation in order to put the form on your page.

Settings

WAGTAIL_MODEL_FORMS_ADD_NEVER_CACHE_HEADERS`

Default True

WAGTAIL_MODEL_FORMS_FORM_MODEL

Must be of the form app_label.model_name

WAGTAIL_MODEL_FORMS_SUBMISSION_MODEL

Must be of the form app_label.model_name

WAGTAIL_MODEL_FORMS_UPLOADED_FILE_MODEL

Must be of the form app_label.model_name

WAGTAIL_MODEL_FORMS_REPORTS`

Default True

WAGTAIL_MODEL_FORMS_CIRSPY_FORMS_FORM_TAG

Default False

Templates

wagtail_model_forms/form.html

{% if not request.form_success is self.form.id %}
<form action="" method="POST" novalidate>
    {% csrf_token %}
    <input type="hidden" name="form_id" value="{{ self.form.id }}">
    {{ form.as_ul }}
    <button type="submit">Submit</button>
</form>
{% else %}
    <p>Form success</p>
{% endif %}

FAQ

The form is not submitted

Make sure you have added the FormSnippetMixin and implemented the page_has_form method correctly.

Request is not available in get_context of FormBlock

Make sure you render your blocks in your templates with include_block, see https://docs.wagtail.org/en/stable/topics/streamfield.html.

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

wagtail-model-forms-0.8.7.tar.gz (15.8 kB view details)

Uploaded Source

Built Distribution

wagtail_model_forms-0.8.7-py2.py3-none-any.whl (21.0 kB view details)

Uploaded Python 2Python 3

File details

Details for the file wagtail-model-forms-0.8.7.tar.gz.

File metadata

  • Download URL: wagtail-model-forms-0.8.7.tar.gz
  • Upload date:
  • Size: 15.8 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/5.1.1 CPython/3.11.9

File hashes

Hashes for wagtail-model-forms-0.8.7.tar.gz
Algorithm Hash digest
SHA256 549912c602db142566757bccfb6e5cefbb7d61979434ba26903645afd9045c37
MD5 4ef328ebf1e7e88914aa802ae5f88378
BLAKE2b-256 303f354cbf87208713193a78d4e31e7b76bac659606581176284cd7241e61130

See more details on using hashes here.

File details

Details for the file wagtail_model_forms-0.8.7-py2.py3-none-any.whl.

File metadata

File hashes

Hashes for wagtail_model_forms-0.8.7-py2.py3-none-any.whl
Algorithm Hash digest
SHA256 730a2940415e0052a8184fc7a7480724457dc72eafa9cec7c69d0d0ccaf215d2
MD5 a0d478a9abe14be48dafbeb30430ca25
BLAKE2b-256 7781d0c5ec230b9f6225d42bb22632ea7f8ae997bca45d83efdc56b72bad19fd

See more details on using hashes here.

Supported by

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