Form Builder Documentation¶

User friendly html form builder. A customized Django Wagtail app. Wagtail as a standalone builder for form pages or simply forms.

Work in progress

This documentation is work in progress and certainly not complete. If you have any questions, please contact Thomas Breitner or simply open an issue.

Getting started¶

Example public form rendered by the form builder

Features¶

Building upon the feature set of Wagtail form builder and customized to provide the following additional features.

Branding with custom Logos, Favicon, colors etc.
Expose API endpoint for forms, authentification via token (optional, configurable per form)
Custom form fields:
- Document file field
- Image file field
- Typeahead-Multiselect field (“select2”)
- Datetime and time fields with time picker for Firefox
Embed page content - without header, footer etc. - via url?embed=true. Useful for embedding only the form on third party sites.
- iFrame autoresizing
- Handles Content Security Policy (CSP). See .env.
Multilingual
Captcha (optional, configurable per form)
Protect uploaded files (images and documents) via
- filenames prefixed with an UUID
- files could only be fetched from an authenticated request, and/or a whitelisted IP address
Validates incoming files for:
- maximum file size
- file extension
- file mime type
- virus scan (via clamav in docker, done async via task queue huey)

iFrame¶

<style>
  iframe#waf-iframe {
    width: 1px;
    min-width: 100%;
  }
</style>
<iframe id="waf-iframe" src="https://fqdn.com/wagtail/formpage.html"></iframe>
<script src="https://fqdn/static/iframeresizer/iframeResizer.js"></script> 
<script>
  iFrameResize({ log: false }, '#waf-iframe')
</script>

Snippet from https://github.com/davidjbradshaw/iframe-resizer#typical-setup. Thanks to davidjbradshaw