Forms
=====

Create a new form
-----------------

To create a new form, go to the admin interface and click on "Formularium" in the navigation menu.

.. image:: images/form-browse-empty.png

Then click on "Add new form"

.. image:: images/form-add-empty.png

Give it a name, then click on "Add a component" to add your first component.

.. image:: images/form-add-component-sidebar.png

In the sidebar, select the type of component you want to add, for instance
"User e-mail address", and complete the component's settings form.

.. image:: images/form-add-first-component.png

You can add as many components as you want and reorder them. You may also add
actions. Actions are executed after a successful form submission.

.. image:: images/form-add-complete.png

Once you're done, click on "Add" to save the form.

.. image:: images/form-browse.png

See :doc:`form-components` and :doc:`form-actions` to get more details about their settings.

Add the form to a site page
---------------------------

To make the form visible to your users, you must add the "Formularium" block to
a site page, and select your form in the block settings.

.. image:: images/site-page.png

The page will look like this (with the default theme):

.. image:: images/site-form.png

Form submissions can be viewed and managed in :doc:`the form submissions page <form-submissions>`