PHPackages                             am-impact/amforms - PHPackages - PHPackages  [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register)

1. [Directory](/)
2. /
3. [Utility & Helpers](/categories/utility)
4. /
5. am-impact/amforms

ActiveCraft-plugin[Utility & Helpers](/categories/utility)

am-impact/amforms
=================

Forms plugin for Craft

1.8.0(8y ago)1202.6k21[60 issues](https://github.com/am-impact/amforms/issues)[6 PRs](https://github.com/am-impact/amforms/pulls)PHP

Since Jul 20Pushed 7y ago14 watchersCompare

[ Source](https://github.com/am-impact/amforms)[ Packagist](https://packagist.org/packages/am-impact/amforms)[ RSS](/packages/am-impact-amforms/feed)WikiDiscussions master Synced 1mo ago

READMEChangelog (10)Dependencies (1)Versions (33)Used By (0)

amforms
=======

[](#amforms)

*Forms in Craft, made easy*

CP functionality
----------------

[](#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.

### Forms

[](#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.

[![NewForm](https://raw.githubusercontent.com/am-impact/am-impact.github.io/master/img/readme/amforms/newform.png "NewForm")](https://raw.githubusercontent.com/am-impact/am-impact.github.io/master/img/readme/amforms/newform.png)

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.

[![Notifications](https://raw.githubusercontent.com/am-impact/am-impact.github.io/master/img/readme/amforms/notifications.png "Notifications")](https://raw.githubusercontent.com/am-impact/am-impact.github.io/master/img/readme/amforms/notifications.png)

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.

**This tab is only available to admins.**

[![Templates](https://raw.githubusercontent.com/am-impact/am-impact.github.io/master/img/readme/amforms/templates.png "Templates")](https://raw.githubusercontent.com/am-impact/am-impact.github.io/master/img/readme/amforms/templates.png)

### Fields

[](#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.

[![Fields](https://raw.githubusercontent.com/am-impact/am-impact.github.io/master/img/readme/amforms/fields.png "Fields")](https://raw.githubusercontent.com/am-impact/am-impact.github.io/master/img/readme/amforms/fields.png)

### Export

[](#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.

[![NewExport](https://raw.githubusercontent.com/am-impact/am-impact.github.io/master/img/readme/amforms/newexport.png "NewExport")](https://raw.githubusercontent.com/am-impact/am-impact.github.io/master/img/readme/amforms/newexport.png)

[![ExportCriteria](https://raw.githubusercontent.com/am-impact/am-impact.github.io/master/img/readme/amforms/exportcriteria.png "ExportCriteria")](https://raw.githubusercontent.com/am-impact/am-impact.github.io/master/img/readme/amforms/exportcriteria.png)

[![ExportOverview](https://raw.githubusercontent.com/am-impact/am-impact.github.io/master/img/readme/amforms/exportoverview.png "ExportOverview")](https://raw.githubusercontent.com/am-impact/am-impact.github.io/master/img/readme/amforms/exportoverview.png)

### Settings

[](#settings)

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

[![General](https://raw.githubusercontent.com/am-impact/am-impact.github.io/master/img/readme/amforms/general.png "General")](https://raw.githubusercontent.com/am-impact/am-impact.github.io/master/img/readme/amforms/general.png)

[![Exports](https://raw.githubusercontent.com/am-impact/am-impact.github.io/master/img/readme/amforms/exports.png "Exports")](https://raw.githubusercontent.com/am-impact/am-impact.github.io/master/img/readme/amforms/exports.png)

[![AntiSpam](https://raw.githubusercontent.com/am-impact/am-impact.github.io/master/img/readme/amforms/antispam.png "AntiSpam")](https://raw.githubusercontent.com/am-impact/am-impact.github.io/master/img/readme/amforms/antispam.png)

[![reCAPTCHA](https://raw.githubusercontent.com/am-impact/am-impact.github.io/master/img/readme/amforms/recaptcha.png "reCAPTCHA")](https://raw.githubusercontent.com/am-impact/am-impact.github.io/master/img/readme/amforms/recaptcha.png)

Display your forms
------------------

[](#display-your-forms)

### Simple tag

[](#simple-tag)

This will only display basic fields!

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

```

### Simple field tag

[](#simple-field-tag)

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

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

```

### Simple field tag (using a namespace)

[](#simple-field-tag-using-a-namespace)

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

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

```

### Custom HTML

[](#custom-html)

```

    {{ getCsrfInput() }}

    {# This should always be here! #}

    {# Insert your form's handle. #}

    {# Optional: Redirect URL. Will redirect to current page by default. #}

    {# Optional: Anti-spam protection. #}
    {{ craft.amForms.displayAntispam() }}

    {# Optional: Google reCAPTCHA protection. #}
    {{ craft.amForms.displayRecaptcha() }}

    {# Place the HTML of your fields here #}

```

### Custom HTML with displayField

[](#custom-html-with-displayfield)

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

    {{ getCsrfInput() }}

    {# This should always be here! #}

    {# Insert your form's handle. #}

    {# This will namespace your inputs (for IDs and such), but it's not required though #}

    {# Optional: Anti-spam protection. #}
    {{ craft.amForms.displayAntispam() }}

    {# Optional: Google reCAPTCHA protection. #}
    {{ craft.amForms.displayRecaptcha() }}

    {# Place the HTML of your fields here #}
    {{ form.displayField('fieldHandle') }}
    {{ form.displayField('aFieldHandle') }}
    {{ form.displayField('anotherFieldHandle') }}

```

### Custom field HTML

[](#custom-field-html)

Change **formHandle** to your form's handle.

```

    Comment

    {% if formHandle is defined %}
        {{ errorList(formHandle.getErrors('comment')) }}
    {% endif %}

```

### Custom Matrix field

[](#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

[](#errorlist-macro)

```
{% macro errorList(errors) %}
    {% if errors %}

            {% for error in errors %}
                {{ error }}
            {% endfor %}

    {% endif %}
{% endmacro %}

```

If you want to include it on the template itself, use:

```
{% from _self import errorList %}

```

Dashboard widget
----------------

[](#dashboard-widget)

Display your recent submissions on your dashboard.

[![WidgetSettings](https://raw.githubusercontent.com/am-impact/am-impact.github.io/master/img/readme/amforms/widgetsettings.png "WidgetSettings")](https://raw.githubusercontent.com/am-impact/am-impact.github.io/master/img/readme/amforms/widgetsettings.png)

[![WidgetSmall](https://raw.githubusercontent.com/am-impact/am-impact.github.io/master/img/readme/amforms/widgetsmall.png "WidgetSmall")](https://raw.githubusercontent.com/am-impact/am-impact.github.io/master/img/readme/amforms/widgetsmall.png)

[![WidgetBig](https://raw.githubusercontent.com/am-impact/am-impact.github.io/master/img/readme/amforms/widgetbig.png "WidgetBig")](https://raw.githubusercontent.com/am-impact/am-impact.github.io/master/img/readme/amforms/widgetbig.png)

###  Health Score

38

—

LowBetter than 85% of packages

Maintenance10

Infrequent updates — may be unmaintained

Popularity33

Limited adoption so far

Community22

Small or concentrated contributor base

Maturity74

Established project with proven stability

 Bus Factor1

Top contributor holds 68.4% of commits — single point of failure

How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window.

**Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores.

**Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement.

**Maturity (30%)** — Project age, version count, PHP version support, and release stability.

###  Release Activity

Cadence

Every ~34 days

Recently: every ~129 days

Total

29

Last Release

3002d ago

### Community

Maintainers

![](https://www.gravatar.com/avatar/ae37e8bdbd8456b5140fe0bec73129ffde4751deb7f98c5bafb1608e988759b5?d=identicon)[hubertprein](/maintainers/hubertprein)

---

Top Contributors

[![hubertprein](https://avatars.githubusercontent.com/u/6221899?v=4)](https://github.com/hubertprein "hubertprein (26 commits)")[![FrankZwiers](https://avatars.githubusercontent.com/u/1741077?v=4)](https://github.com/FrankZwiers "FrankZwiers (4 commits)")[![raymondelooff](https://avatars.githubusercontent.com/u/9716806?v=4)](https://github.com/raymondelooff "raymondelooff (4 commits)")[![bvangennep](https://avatars.githubusercontent.com/u/12080429?v=4)](https://github.com/bvangennep "bvangennep (1 commits)")[![BryceBubbles](https://avatars.githubusercontent.com/u/3781435?v=4)](https://github.com/BryceBubbles "BryceBubbles (1 commits)")[![scornelissen](https://avatars.githubusercontent.com/u/43202516?v=4)](https://github.com/scornelissen "scornelissen (1 commits)")[![vinnietech](https://avatars.githubusercontent.com/u/3481954?v=4)](https://github.com/vinnietech "vinnietech (1 commits)")

### Embed Badge

![Health badge](/badges/am-impact-amforms/health.svg)

```
[![Health](https://phpackages.com/badges/am-impact-amforms/health.svg)](https://phpackages.com/packages/am-impact-amforms)
```

###  Alternatives

[rainlab/blog-plugin

Blog plugin for October CMS

17257.7k](/packages/rainlab-blog-plugin)[rainlab/builder-plugin

Builder plugin for October CMS

17147.2k1](/packages/rainlab-builder-plugin)[pfefferle/wordpress-activitypub

The ActivityPub protocol is a decentralized social networking protocol based upon the ActivityStreams 2.0 data format.

5671.4k1](/packages/pfefferle-wordpress-activitypub)[civicrm/civicrm-drupal-8

Open source constituent relationship management for non-profits, NGOs and advocacy organizations.

18238.1k2](/packages/civicrm-civicrm-drupal-8)[mediawiki/semantic-glossary

A terminology markup extension with a Semantic MediaWiki back-end

1352.4k](/packages/mediawiki-semantic-glossary)[humanmade/lottie-lite

A lightweight Lottie Animations Extension for WordPress

374.3k](/packages/humanmade-lottie-lite)

PHPackages © 2026

[Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)