xodigital / formerly
Craft Plugin that allows users to build their own forms and view form submissions
Installs: 2 141
Dependents: 0
Suggesters: 0
Security: 0
Stars: 60
Watchers: 8
Forks: 24
Type:craft-plugin
Requires
- composer/installers: ~1.0
This package is not auto-updated.
Last update: 2024-04-17 08:24:49 UTC
README
Installing
- Copy the
formerly
directory into yourcraft/plugins
directory - Browse to Settings > Plugins in the Craft CP
- Click on the Install button next to Formerly
Setting up forms
Users (both admin and client) can easily create forms in the Formerly admin section, under the Forms tab. A form consists of:
- A name, used as the title of the form that a visitor to the site may see
- A handle, used to programatically refer to this form
- Several emails that will be sent upon the submission of a form by a visitor
- Several questions which make up the form
Outputting the form
A form can be rendered using, e,g.
{% set form = craft.formerly.form('handle') %} {% include 'form.html' with { form: form } %}
Where form.html
is Twig code that iterates through the form's questions,
creating form markup. An example form.html
is provided with the source code
for this plugin.
You can also obtain a form instance by having a content editor select a form using the Formerly field type, e.g.
{% include 'form.html' with { form: entry.form } %}
Viewing submissions
Form submissions are a Craft Element, which means that you can query them using
regular ElementCriteriaModel
s. For example, to list submissions to the
competition
form who have selected Australia as their country:
{% set submissions = craft.formerly.submissions('competition') .country('Australia') .sort('dateCreated desc') %} {% for submission in submissions %} Name: {{ submission.formhandle_name }} Email: {{ submission.formhandle_email }} {# ... #} {% endfor %}
Subscribe to Mailchimp Lists
This function allows for subscribers to be directly subscribed to your mailchimp list.
- When adding a form, switch
ON
the Mailchimp toggle. - Enter your Mailchimp username - used to sign in to mailchimp
- Enter your Mailchimp API key
- Enter your Mailchimp List Id
- For each question, if you have a Custom Merge Tag set in Mailchimp, you must add it under
Mailchimp Merge Tag
Each submission will then be added to the list in Mailchimp
Todo
- Better validation
- More question attributes, e.g. placeholder, error messages