413

Product support

Get help in the plugin support forum.

  • Added on Oct 13, 2021
  • Current version: 1.0.8
  • Compatibility
    October CMS v3.x not tested
    October CMS v2.x use latest
    October CMS v1.x use latest
  • Created by
  • Public repository

Categories

This plugin is intended for developers. Allows you to simplify the implementation of forms on the site, organize the management of forms for the customer.

The plugin uses an Ajax handler via the standard data-attributes-api. All events are managed in the administrative interface.

The plugin provides basic partials for drawing forms. Standard blanks are quite flexible, but in some cases you will have to write your own based on the example of the basic ones.

Integration of forms with SendPulse is available out of the box. To do this, you need to fill in the SendPulse API settings.

Additional features. Integration of shopaholic orders with SendPulse. Requires the OrdersForShopaholic plugin.

Many options for managing the handler. Choosing mail templates for forms.

Documentation in Russian

Attention! Do not give customers full root access to the system, otherwise they may disrupt the plugin by making incorrect settings. The rights are prepared in the plugin. Create a new user and assign - Manager permission.

Getting forms

First, create a form and the necessary fields. After the form is created, it will be assigned a code. Throw the Forms component to the desired site pages or layout.

There are 2 ways to get a form in total.

1. Get By ID

{% set form = Forms.getByID(1) %}

I do not recommend this method, since when deleting the form you will have to replace the call in the code.

2. Get By code

{% set form = Forms.getByCode('code') %}

This method is preferable, because you can always assign a code to the form. (Developer rights are required)

Render of the page (Macros)

Import the macro into the template

{% import 'catdesign.forms::macros' as Constructor %}

Get form

{% set form = Forms.getByCode('code') %}

Open form

{{ Constructor.open('css_id', form, 'css_classes', {additional_data_one: value, additional_data_two: value}) }}

Render form title

{{ Constructor.title(form, 'css_title_classes', 'css_description_classes') }}

Render all fields

{{ Constructor.fields(form, 'css_wrapper_classes') }}

Or Render individual field

{{ Constructor.hidden(form, 'field_code', 'css_classes', 'css_field_id') }}

{{ Constructor.text(form, 'field_code', 'css_classes', 'css_wrapper_classes', 'css_field_id') }}

{{ Constructor.select(form, 'field_code', 'css_classes', 'css_wrapper_classes', 'css_field_id') }}

{{ Constructor.number(form, 'field_code', 'css_classes', 'css_wrapper_classes', 'css_field_id') }}

{{ Constructor.checkbox(form, 'field_code', 'css_classes', 'css_wrapper_classes', 'css_field_id') }}

{{ Constructor.radio(form, 'field_code', 'css_classes', 'css_wrapper_classes', 'css_field_id') }}

{{ Constructor.textarea(form, 'field_code', 'css_classes', 'css_wrapper_classes', 'css_field_id') }}

Render submit button

{{ Constructor.submit(form, 'css_classes', 'css_wrapper_classes', 'css_field_id') }}

Close form

{{ Constructor.close() }}

Example of drawing a simple feedback form from 2 fields

{% import 'catdesign.forms::macros' as Constructor %}
{% set form= Forms.getByCode('feedback') %}

{{ Constructor.open('feedback', form, 'form', {current_url: this.page.url}) }}
    {{ Constructor.title(form, 'form__title', 'form__description') }}
    {{ Constructor.text(form, 'name', 'form-group__field', 'form__group', 'feedback-name') }}
    {{ Constructor.text(form, 'phone', 'form-group__field', 'form__group', null) }}
    {{ Constructor.submit(form, 'button button__green', 'form__button', null) }}
{{ Constructor.close() }}

Note that macro variables are optional. You can pass null if, for example, you don't need css_classes

  • Found the plugin useful on 12 Feb, 2022

    A very good plugin. Lots of features out of the box. You can flexibly customize the fields. Don't think about sending handlers.

    There is integration with SendPulse. The first implementation may seem complicated, all subsequent ones are already going very fast. I usually copy the macro from the default folder of the component and redo it for myself.

    Thanks to the author for the work!

1.0.8

Remove unique field name validation

Feb 20, 2022

1.0.7

Updated translations.

Dec 11, 2021

1.0.6

The fields for entering the field code have been unblocked.

Nov 14, 2021

1.0.5

Big update. Macros have been added for more convenient and flexible rendering of forms

Nov 13, 2021

1.0.4

Fixed a bug with the absence of OrdersFormShopaholic

Oct 13, 2021

1.0.3

Added English localization

Oct 13, 2021

1.0.2

Added integration with SendPulse

Oct 13, 2021

1.0.1

Initializing the plugin

Oct 13, 2021