Random Image
My Account

Forms Plugin

Create custom forms to be filled out by site visitors. Form data may be saved, emailed to the form's owner, or both.

Based on code from the Profile plugin, several different field types are supported.


  • glFusion v1.2.0 or newer
  • PHP 5.1 or newer


This plugin uses the glFusion automated plugin installer. Simply upload the distribtuion using the glFusion plugin installer located in the Plugin Administration page.

The plugin may be installed manually, if necessary.


The upgrade process is identical to the installation process, simply upload the distribution from the Plugin Administration page.


  • Several types of fields are supported:
    • Text
    • Textarea
    • Select
    • Radio Buttons
    • Checkboxes
    • Static text or HTML
    • Calculated based on static numbers or other fields
  • Fields may be re-ordered as needed.
  • Support for autotags.
    • [forms:show form:#] includes form “#” in another page.
    • [forms:results form:#] include a results table for form “#”
  • Each form has an Owner and Group associated with it that are able to edit the form and view or download results.
  • Access to fill out the form or view the results can be limited to specific groups.
  • Results may be downloaded as CSV files for importing into spreadsheets.
  • Individual form submissions can be printed for reference (useful for complex forms).
  • Fields can be set as Normal, Read-Only, Hidden, and Required. Note that for checkboxes, Required means that the box must be checked in order for the form to be submitted.


Creating Forms

Forms are created by clicking “New Form” from the Forms administration menu. Each field has a help icon which will give information to help you make choices.

After a form is created and saved, you'll be returned to the form's edit screen. Scroll to the bottom and click “New Field” to start adding fields to the form.

If you wish to delete a field, you have the option of removing the field from the form, or removing it and its data. Either way the field's data will not be available, but if you leave the data in place then you have the option of re-adding the field and the existing data will again be available (except for users who've filled out the form in the meantime).

The form name does not have to be unique. However, that may change in the future and it's a good idea to use a unique name for each form

Form IDThis is the ID that will be used to refer to the form in articles.
NameThis will be used in cases where the form is displayed by itself. Use some descriptive name to help you find it in the admin list.
Intro TextThis text will be displayed before the form fields only when the form is displayed (see Permissions)
Message After SubmissionThis message will be displayed after a successful submission, such as “Thank you for your submission”
Message shown if user can't access the formIf the current user is not allowed to view the form, this message will be displayed. Typically something like “Please log in to sign up”
Redirect URL after submissionEnter a URL if you want to redirect the submitter to a specific page. The home page will be shown if left blank.
EnabledIf this checkbox is blank the form will not be displayed, nor will the no-access message. Be sure to check this if you copy an existing form.
Action upon SubmissionOne or more actions should be taken after submission. Options are: Save to Database, Display Results (of the submission), Email the form owner, Email the form group, Email the site admin and Email other addresses. Any number of these may be selected. Typically Save to Database and Email Owner are used.
ModerateCheck this to require administrator approval before a submission is included in the displayed results. Untested
Show in BlockChanges the display of the form making it a standalone page
Max Total SubmissionsEnter the maximum number of submissions that will be accepted. The message described below is displayed when the limit is reached. Leave blank for unlimited.
Message if the max submissions is reachedEnter the message to display if the maximum number of submissions is reached
Per-User Submission LimitSelect whether users can submit multiple submissions, only one submission, or if they can edit their existing submissions.
Message if user can't resubmit the formIf “One Entry- No Edit” is chosen above, this message will be displayed when the user views the form again.
OwnerEnter the person designated as the form owner. Used for notifications above.
GroupEnter the group designated as the form group. Used for notifications above.
Group that can fill outSelect the group of site users that can see and fill out the form. The no-access message is displayed for users that are not part of this group.
Group that can see resultsSelect the group of site users that will be able to see the results when displayed with an article or page. Nothing is displayed to users that are not part of this group.
Require CAPTCHASelect whether CAPTCHA will be used for this form. Whether CAPTCHA is shown for all users or only anonymous users is determined in the global site configuration.
Reset Field PermissionsResets the permissions of all fields to match the form. Recommended if you copy an existing form.

Creating Fields

Form fields are created by clicking “List Fields”, then “New Field”, from the Forms administration menu.

A field may be one of several types:


Text fields are simple single-line text fields. The user may enter anything into this field. If “required”, then the field may not be left blank.


This is a single checkbox, which may or may not be selected. The “required” parameter does not apply to checkboxes since either “checked” or “unchecked” are valid responses.


This is a checkbox variable, where none or multiple items may be selected.

Refer to “Defining Multi-Value Fields” for instructions on setting up the options.

This creates a single-selection drop-down selection of the specified values. See “Checkbox” above regarding how to specify the values.

Refer to “Defining Multi-Value Fields” for instructions on setting up the options.

Radio Buttons

Radio Buttons work the same as Dropdowns. The “Required” parameter indicates that one item must be selected. Refer to “Defining Multi-Value Fields” for instructions on setting up the options.


The date field is used to collect a date and store it as a SQL-formatted date string (YYYY-MM-DD hh:mm:ss). If there is no time entry, the time value is set to “00:00:00”.

Dates use selections for the month and day, and a text box for the year. Any integer year value is supported; there may be some validation options added later.

The date format refers to which predefined format is used. Currently only “mm/dd/yyyy” and “dd/mm/yyyy” are supported.


Static fields simply display exactly what is entered as the Value. These can be used to insert a blank line in a form or display instructions.


Calculated fields use the Value parameter to perform calculations. The Value should be a comma-separated list of numbers and/or other field names. Complex calculations such as “(A + B) * C” are not supported. Recursive calculations (using another calculated field as an argument) is supported, but be careful not to create a loop. For example, consider a tax calculation:

Field: tax
Type: multiplication
Value: .0875,amount

Field: total
Type: addition
Value: amount,tax

This would cause undefined behavior:
Field: amount
Type: any
Value: 3,tax

There is a safeguard in place to ignore any references by a field to itself.

Some examples:

  • Addition
    • Value: 1,2,3
    • Result: 1 + 2 + 3 = 6
  • Subtraction
    • Value: 10,4,3
    • Result: 10 - 4 -3 = 3
  • Multiplication
    • Value: 2,3,5
    • Result: 2 * 3 * 5 = 30
  • Division
    • Value: 10,5,2
    • Result: 10 / 5 / 2 = 2.5
  • Average
    • Value: 5,8,11
    • Result: (5 + 8 + 11) / 3 = 24 / 3 = 8

Defining multi-value fields

For single-value fields, such as text or date fields, the definition form should be fairly easy to use. For multi-value fields, such as radio buttons and dropdown selections, the creation of the options is a little less intuitive.

To add new fields, click on the small icon next to the “Value” prompt. An empty spot will appear where you can type the fields value. The radio button to the right is used to select the default value.

To remove an option from a multi-value field, simply erase the text. Empty fields are not saved with the field definition.

Displaying Forms

Forms will normally be displayed via an autotag (“forms:”) embedded within an article or other content. Forms can also be displayed by accessing {site_url}/forms/index.php?frm_id=XX, where “XX” is the numeric ID number of the form. If the current user is not allowed to fill out the form, they will be returned to the home page.

To embed a form by autotag, specify “[forms:show form:XX]”, where XX is the form's ID number. Additionally, you may add an additional variable to specify a particular template file. You'll need to create this template, and it should be based on the “forms.thtml” file included with the plugin. This is an experimental feature. For example, to use a custom template to display form #3, you would use “[forms:show form:3 template:custom.thtml]”. The custom template feature is only available when displaying a form via an autotag.

formsYesArgument must be “form” to display the form
form or idYesID number of the form
templateNoName of a custom template file. Any custom templates should reside in the {private_dir}/plugins/forms/templates/custom directory.

Forms are only displayed to users who are members of the “Group that can see results” defined for the form.

Displaying Results

To display results within a page or article, the autotag would look like this:

[forms:results form:3 fields:address1,address2,city']

The available parameters are:

formsYesArgument must be “results” to display the results
form or idYesID number of the form
fieldsNoComma-separated list of fields. All fields, except for the user ID/Name and submission date, will be displayed if this parameter is omitted. To include these as well, add “res_user” and “res_date”, respectively

Form results are only displayed to users who are members of the correct group.


Configuration Options

Display glFusion BlocksThis governs which glFusion blocks are displayed when a form is called via http://site_url/forms/?frm_id=X. It has no effect upon forms displayed via autotags.
Default group to fill formsSelect the user group to be given access to fill out new forms, by default. This may be changed during or after the form's creation.
Default group to view resultsSelect the user group to be given access to view form results. If the current user is not a member of this group (or a form owner), then the results will be hidden from view when the “forms:results” autotag is used.
Default Text Field SizeEnter the number to be used as the default “size” parameter for text fields.
Default “maxlen” for Text FieldsEnter the number to be used as the default “maxlen” parameter for text fields.
Default textarea “rows” valueEnter the number to be used as the default “rows” parameter for textarea fields.
Default textarea “cols” valueEnter the number to be used as the default “cols” parameter for textarea fields.


This program is free software; you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation; either version 2 of the License, or (at your option) any later version.

Logged in as: Guest (anonymous)
glfusion/glforms/start.txt · Last modified: 2015/03/20 23:06 by lee
Except where otherwise noted, content on this wiki is licensed under the following license: GNU Free Documentation License 1.3
Random Image
My Account