README

The forms plugin utilizes Attributize and Conditions to create custom forms for frontend and backend use.

Redirect after submission
Save entries to the database
Automatically purge saved entries
Throttle frontend entry creation via Laravel Rate Limiting
Send entry notifications via the RainLab Notify integration
Events for extensibility

Installation

Requirements

OctoberCMS 3.x
Sixgweb.Attributize
- Mysql 5.7+ or Postgres 12+
- Bootstrap 5.x (injectable via plugin settings)
Sixgweb.Conditions
Sixgweb.ConditionsAttributize

Marketplace

Add the plugin to your project via the OctoberCMS Marketplace and run the following command in your project root:

php artisan project:sync

Composer

Install via composer by running the following command in your project root:

composer require sixgweb/forms-plugin

Forms Controller

The forms area contains all of the forms for your project and provides the following configuration:

Details Tab

Settings Tab

Fields Tab

The Attributize fields editor is available, after the form has been created.

Displays the Attributize field editor.

::: tip Automatic Conditions Fields created under the Fields Tab will automatically have a condition created for the current form. :::

Conditions Tab

Displays the form Conditions editor, allowing conditions required to view the form.

Entries Controller

The Entries Controller displays all the form submissions for your website, filterable by Form and/or Creation Date.

Once a form is selected in the Form filter, you will have the corresponding fields available in the List Setup and any fields with the setting Is Filterable added to the filter widget.

Entry Editor

Fields without form conditions will alway be visible. Fields with form conditions will appear/hide based on the selected form value.

Entry Import/Export

Form entries can be exported directly from the list view or via the export behavior. Entries can be imported via the import behavior. Read the Documentation to learn more about OctoberCMS import/export behaviors.

List View Export

Set up your desired list columns and filter values and press the Download Results button to export the current list to a .csv file

Export Behavior

Press the Export button to view the entry exporter. Selecting a Form value in the exporter will update the available columns.

Import Behavior

Press the Import button to view the entry importer. Selecting a Form value in the importer will update the available columns.

Twig Functions

The following functions are provided by the Forms plugin.

entryFieldValuesToHTML(): string

Generates nested HTML from the model's field values.

{% set options = {'container':'div', 'wrapper':'div', 'label':'strong', 'labelSeparator':' - ' } %}
{{ entryFieldValuesToHTML(entry, options)}}

Parameters

model

Fieldable model. In this case, the Entry model

sixgweb / forms-plugin

Maintainers

Details