Skip to the content
Documentation
Help Start
Reading in:
  • German: 9,110 of 9,110 pages
About the help in other languages
All help pages

Forms with the information collector

How visitor forms work in Exponential - collector attributes, the content/action post, validation, the result page, mail to a receiver, form types (form, feedback, poll) in collect.ini, and where submissions are stored.

Download as PDF

Address: https://doc.exponential.earth/exphelp/viewer/help/creators/website-creators/forms-with-the-information-collector.md

On this page

Forms with the information collector

This page is for website creators who build forms visitors fill in: contact forms, feedback forms, polls, lead forms. Exponential does this with the information collector: a class whose attributes are marked Information collector, an object of it shown as a form, and a stored collection for every submission (Collected information).

Contents

  1. How it works
  2. The form template
  3. Form types: form, feedback, poll
  4. Mail to a receiver
  5. After sending
  6. Privacy

How it works

  1. A class (the shipped Feedback form, feedback_form) has attributes marked Information collector: sender name, e-mail, subject, message. Other attributes (a description) are written by editors as usual.
  2. An editor creates an object of the class; its full view shows the form.
  3. The visitor posts the form to content/action with the button ActionCollectInformation; the kernel's content/collectinformation view validates each collector attribute with its datatype.
  4. On success one collection is stored, a mail may be sent, and the visitor sees the result page or is redirected.
  5. Editors read and export the collections in Setup > Collected information (Reading and exporting form submissions).

The form template

The shipped ezwebin template (extension/ezwebin/design/ezwebin/override/templates/full/feedback_form.tpl) shows the pattern:

{include name=Validation uri='design:content/collectedinfo_validation.tpl'
         class='message-warning' validation=$validation collection_attributes=$collection_attributes}
<form method="post" action={'content/action'|ezurl}>
  <label for="sender">{$node.data_map.sender_name.contentclass_attribute.name|wash}</label>
  {attribute_view_gui attribute=$node.data_map.sender_name}
  ...
  <input type="submit" name="ActionCollectInformation" value="{'Send form'|i18n( 'design/mysite' )}">
  <input type="hidden" name="ContentNodeID" value="{$node.node_id}">
  <input type="hidden" name="ContentObjectID" value="{$node.object.id}">
  <input type="hidden" name="ViewMode" value="full">
</form>

A collector attribute's view template renders its input field. The form token that protects POST forms is added by the ezformtoken extension; leave it active (Spam protection for forms).

Form types: form, feedback, poll

settings/collect.ini decides behavior per type. The type of an object comes from its collection_type attribute, else [InfoSettings] Type=form:

BlockKeyShippedMeaning
InfoSettingsTypeList[]poll, form, feedbackknown types
EmailSettingsSendEmail, SendEmailList[poll]enabled, disabled for pollsmail on submission
DisplaySettingsDisplay, RedirectURLresult, /show the result page or redirect
CollectionSettingsCollectAnonymousDataenabledvisitors who are not logged in may send
CollectionSettingsCollectionUserData, CollectionUserDataList[poll]multiple, uniquea poll can be answered once per user

The result templates are content/collectedinfo/<type>.tpl (form, feedback, poll in design/standard), the mail templates content/collectedinfomail/<type>.tpl; override them in your design.

Mail to a receiver

site.ini [InformationCollectionSettings] EmailReceiver is the default receiver. The mail template can set the receiver per form with {set-block scope=root variable=email_receiver}...{/set-block}; the ezwebin mail templates (extension/ezwebin/design/ezwebin/templates/content/collectedinfomail/feedback.tpl) take it from a recipient attribute of the form object when it has one, so each form can mail its own team. The same templates can set redirect_to_node_id to send the visitor to a node afterwards. Mail goes through the site's mail settings (10.4 Mail); test with the file transport first.

After sending

Display=result shows content/collectedinfo/<type>.tpl with the values; Display=redirect sends the visitor to RedirectURL (a "thank you" page). Use the redirect so a reload does not resend.

Privacy

Forms collect personal data. Collect only what you need, say what happens with it next to the form, limit infocollector/read to the people who process it, and remove collections when they are no longer needed.

Become an Exponential Partner

Partners share their information, provide funding, contribute back and develop the products with us, and that is how Exponential grows. A partner website and dashboard are planned for mid-2027: please become a partner today to speed up our growth rate and land new features faster.

Something wrong on this page? Report an error

Documentation license

This documentation is free documentation, licensed under the GNU Free Documentation License 1.3 or later.

Exponential Copyright © 1998-2026 Exponential Foundation and 7x