Download the PHP package resknow/form without Composer

Form Config

There are a number of options when building forms, below is a breakdown of what options you have and field types that can be added.

Options

These options are required by the form plugin to setup a form for you. They belong in your .config.yml file under the forms key.

Note: The honeypot feature creates a field with the key how, so avoid using that key for your own fields.

Fields

Fields are defined under the fields key of your form's configuration. There are a number of field types, which are listed below along with their available options.

Most field types support HTML attributes as options too.

Text field

Textarea field

Select field

Datepicker field

Provides a Datepicker UI for dealing with dates.

Choice field

Provides a button based UI for small groups of choices

WYSIWYG field

Content field

Allows you to include custom content inside your form. Note: Labels are never shown for this field type and values are not included in user input.

Group field

Allows you to group multiple fields, it uses CSS Grid by default but you can role your own styles if you need to.

Note: Grid layouts only support up to 4 fields in a row.

Validation & Filters

Field validation and filtering is done by GUMP. Form also provides a spam filter validator, which allows you to invalidate a form if you find spam.

See inc/functions.php in the Form plugin for more details.

The validator for this is spam_filter. Add this to your validation rules to apply the spam checks.

Render a form!

Once you've created your form, to render it on your page, include the following where you'd like it to display:

Twig

PHP

Switch out my-form for your actual form ID :)

Also note that the example screenshot above includes custom styling, the Form plugin tries not to give you opinionated styles, that's on you as the designer.