am-impact/amforms

Forms plugin for Craft

Wednesday, June 13, 2018
by hubertprein
Repository
13 Watchers
126 Stars
2,457 Installations

PHP
0 Dependents
0 Suggesters
20 Forks
67 Open issues
33 Versions
1 % Grown

The README.md

amforms

Forms in Craft, made easy, _(*1)

CP functionality

When users have permission to access the plugin, they can do various stuff in the CP. There's an extra setting that'll allow users to control the plugin's settings., _(*2)

Forms

You're able to activate submissions and / or notifications. This means you could choose to ignore the submissions if you want to, but only receive notifications when a form was submitted., _(*3)

NewForm , _(*4)

Notifications are activated, and all information will be filled out by default. The Sender name and email addresses fields will automatically contain the information from your email settings in Craft's CP., _(*5)

Notifications , _(*6)

The plugin will use it's own templates to display forms and email submissions. You have the option to override these templates in general or per form! Just create your own folder in the templates folder (e.g.: _amforms) and create a template that you would like to override. You can see the default template names in the placeholders, so if you create your own template with the same name, you could choose to make this your default templates for all your forms. When you create a template with a different name, you could create a template per form., _(*7)

This tab is only available to admins., _(*8)

Templates , _(*9)

Fields

When you install the plugin, you get some commonly used fields by default. The fields that are created are stored in a different context / scope than Craft's fields. This means that you're able to reuse these fields in any form and that they won't be shown in Craft's field list., _(*10)

Fields , _(*11)

Export

You have the option to export your submissions per form. You'll be able to choose which fields you'd like to be included in your export (Matrix supported!). When you create an export, it'll start a task that export your submissions into a file located in your storage folder. When it's done, you're able to download the file or restart the export., _(*12)

NewExport , _(*13)

ExportCriteria , _(*14)

ExportOverview , _(*15)

Settings

By default, the anti-spam is activated for your forms, but there's also an option to activate Google reCAPTCHA., _(*16)

General , _(*17)

Exports , _(*18)

AntiSpam , _(*19)

reCAPTCHA , _(*20)

Display your forms

Simple tag

This will only display basic fields!, _(*21)

{{ craft.amForms.displayForm('formHandle') }}

Simple field tag

{% set form = craft.amForms.getForm('formHandle') %}

{{ form.displayField('fieldHandle') }}

Simple field tag (using a namespace)

{% set form = craft.amForms.getForm('formHandle') %}
<input type="hidden" name="namespace" value="{{ form.getNamespace() }}">

{{ form.displayField('fieldHandle') }}

Custom HTML

Custom HTML with displayField

{% set form = craft.amForms.getForm('formHandle') %}

Custom field HTML

Change formHandle to your form's handle., _(*22)

<div class="field">
    <label for="frm_comment">Comment</label>
    <input type="text" id="frm_comment" name="fields[comment]" value="{% if formHandle.comment is defined %}{{ formHandle.comment }}{% endif %}">
    {% if formHandle is defined %}
        {{ errorList(formHandle.getErrors('comment')) }}
    {% endif %}
</div>

Custom Matrix field




    {#
        Notify Craft which Matrix block (handle) will be inserted.

        Our field name for this example is: Persons
        Our block name for this example is: Person
    #}
    

    {# Block fields #}
    First name
    
    Last name
    
    {% if formHandle is defined %}
        {{ errorList(formHandle.getErrors('persons')) }}
    {% endif %}

Errorlist macro

{% macro errorList(errors) %}
    {% if errors %}
        <ul class="errors">
            {% for error in errors %}
                <li>{{ error }}</li>
            {% endfor %}
        </ul>
    {% endif %}
{% endmacro %}

If you want to include it on the template itself, use:, _(*23)

{% from _self import errorList %}

Display your recent submissions on your dashboard., _(*24)

WidgetSettings , _(*25)

WidgetSmall , _(*26)

WidgetBig , _(*27)

The Versions

13/06 2018

dev-master

9999999-dev

Forms plugin for Craft

craft-plugin amforms

Forms plugin for Craft

am-impact/amforms

The README.md

amforms

CP functionality

Forms

Fields

Export

Settings

Display your forms

Simple tag

Simple field tag

Simple field tag (using a namespace)

Custom HTML

Custom HTML with displayField

Custom field HTML

Custom Matrix field

Errorlist macro

Dashboard widget

The Versions

dev-master

The Requires

by Hubert Prein

dev-Empty-date-fix

The Requires

by Hubert Prein

1.8.0

The Requires

by Hubert Prein

dev-craft3

The Requires

by a&m impact

dev-dev

The Requires

by Hubert Prein

1.7.0

The Requires

by Hubert Prein

1.6.1

The Requires

by Hubert Prein

1.6.0

The Requires

by Hubert Prein

1.4.5

The Requires

by Hubert Prein

1.4.4

The Requires

by Hubert Prein

1.4.3

The Requires

by Hubert Prein

1.4.2

The Requires

by Hubert Prein

1.4.1

The Requires

by Hubert Prein

1.4.0

The Requires

by Hubert Prein

1.3.8

The Requires

by Hubert Prein

1.3.7

The Requires

by Hubert Prein

1.3.6

The Requires

by Hubert Prein

1.3.5

The Requires

by Hubert Prein

1.3.4

The Requires

by Hubert Prein

1.3.3

The Requires