This plugin is no longer under maintenance!

Use new Kirby Form Block Suite with a lot of new features.

This form plugin for Kirby offers you maximum flexibility and usability. It can be used as a block anywhere you needed. Even multiple times per page.

Based on the great features of Kirby 3.6.

Packed with a rich set of features: 🎉

✅   Editors can flexibly organise the form fields.

✅   Spam protection with an integrated honeypot. (Since V2.0)

✅   Create a custom form field easely by added with just 2 files (Blueprint & Template).

✅   A newly created form block will be automatically filled by default data from a JSON file (which you can copy from a existing form block).

✅   Incoming requests can be viewed and managed within the block. (optional)

✅   You and/or the visitors will receive an email on incoming requests. (If desired)

✅   Custom form data can be defined in the config file. (E.g. for using of the IP address, etc.).

✅   Language support for English and German. Messages are fully customizable/expandable for developers and/or editors.

Do you miss a feature? Post a feature request and donate something. I can't guarantee that your suggestion will make it into the next release.

For use with Kirby 3.6+ only! (update here!) Download and copy this repository to your plugin folder: /site/plugins/

Composer

composer require microman/kirby-form-blocks

Just put form in your fieldsets of your blocks field:

fields:
  my_block:
    type: blocks
    fieldsets:
      - form
      ...

If you're not familar with Kirbys blocks field check this out.

On the blocks preview, you can set the name of your form and also check, if there's new requests. Inside the blocks settings you have 3 tabs:

• Inbox: Shows you all requests. Set them to (un)read, delete it or change the view of the individual entries with placeholders. (Change display text)
• Form fields Manage the form fields that will displayed to the visitors. You can add more types of form fields. (more later)
• Options Sets the behavior on receipt of the request. Can be extended this with other fields

If your editor use more or less the same form multiple time, it can be usefull to set the default setting. To define the default form fields and form options follow these steps:

1. Create a form block
2. Fill it as desiered
3. Copy the form block
4. Paste it into ´site/config/formblock_default.json´

If your site is multilanguage, you can set a postfix behind the filename for each language on your site. (e.g formblock_default_de.json)

Quick and easy: Copy site/plugins/kirby-form-blocks/snippets/blocks/ to site/snippets/blocks/ and edit the files.

Following form field types are available by default:

	Name	Output
1	input
2	textarea
3	select
4	checkbox
5	radio

Add a custom form field types

Let's say you want to create an form field that shows some information to your visitors:

site/blueprints/blocks/formfields/info.yml

name: Information
icon: alert

fields:
  title:
    type: text
    width: 1/2
  color:
    type: select
    width: 1/2
    options:
      green: Green
      orange: Orange
      red: Red
  info:
    label: form.block.fromfields.select.placeholder
    type: writer

site/snippets/formfields/info.php

<div class="info-field" id="<?= $formfield->slug() ?>" style="background:<?= $formfield->color() ?>">
    
    <?php if($formfield->title()->isNotEmpty()): ?>  
        <h3><?= $formfield->title() ?></h3>
    <?php endif ?>

    <?= $formfield->info() ?>

</div>

Et voilà. You just created a new form field type:

To sort the fields in panel, you can use prefix like 05_fieldname on blueprints filename. Default fields stays on top.

Modify default form field types

Just copy site/plugins/kirby-form-field/blueprints/blocks/formfields to site/blueprints/blocks/formfields and edit it.

To disable a default form field type, just remove the content of the file.

Each form field has by default following fields:

Make shure that the unique identifier is only just once used in the whole form block!

Add custom fields to all form field types

Let's make an example and adding a field for the width:

site/blueprints/blocks/customfields.yml

width:
  label: Width
  type: select
  options:
    col-12: "1/1"
    col-6: "1/2"
    col-4: "1/3"

Output:

<?php foreach ($form->fields() as $field) : ?>

  <div class="<?= $field->width() ?>">

    <?= $field->toHtml() ?>

  </div>
<?php endforeach ?> 

Messages are text fragments, that can be used in your code like this: $form->my_message().

Following messages are available by default:

There are 3 ways to change/add messages (in order of priority):

1. Translation-Files inside the plugin site/plugins/kirby-form-field/lib/languages/*.php -> form.block.*
2. In the config with translations
3. As custom field in the option tab. To modify fields in the option tab, copy site/plugins/kirby-form-field/blueprints/snippets/form_options.yml to site/blueprints/snippets and edit the blueprint:

success_message:
  label: Custom success message
  type: writer

my_custom_message:
  label: Custom Message
  type: writer

As you see, you can also insert fields for the default messages to let the editor customize it.

There are also form_confirm.yml and form_notify.yml in that snippets folder. DO NOT modify them! Better disable the underlying function in the config.

Use placeholder for every messages like this: Hello {{given-name}}. For more info read in the config->placeholders.

The form object provides you with a few useful methods that help you to work with the form block: (e.g. $form->showForm())

* Use only if you like to send extra emails. By default, the emails are sent automatically by the plugin after successful completion.

'microman.formblock' => [
    'from_email' => '[email protected]'
],

Default: no-reply@[the root url of your website]

If the domain is differ from the website domain check the DMARC to ensure that the emails will not rejected.

You probably get an SMTP-Error on localhost environments. Test the email function on a server!

In addition to the incoming form data, extra placeholders can be defined. (Which can be used with {{}} in your messages) For example, to determine the IP address of the sender:

'microman.formblock' => [
  'placeholders' => [
    'ip' => [
      'label' => "IP address",
      'value' => function ($fields) {
        return $_SERVER['REMOTE_ADDR'];
      }
    ]
  ]
],

Functions like request saving, notification email or confirmation email can be disabled:

'microman.formblock' => [
  'disable_inbox' => true,
  'disable_confirm' => true,
  'disable_notify' => true,
],

The corresponding function will be no longer executed and in the panel the tab/fields won't be visible anymore.

To ensure that the visitor does not submit the form more than once (for example by refreshing the page), this Plugin checks whether a form with the same content has been submitted already. In this case, an error message is shown to the visitor.

This function is automatically enabled and can be disabled with this example:

'microman.formblock' => [
  'verify_content' => false,
],

See chapter Messages for mor information

'microman.formblock' => [
  'translations' => [
    'en' => [
        'success_message' => 'Form send!'
    ],
    'de' => [
        'success_message' => 'Formular versendet!'
    ]
  ]
],

If you have any questions or something is not working properly, please let me know.

Hope you will enjoy this plugin. Stay tuned!