Del

Guide: Forms


FirstMagic standard Contact Form

The Contact Form is built in, and can be turned on in FirstMagic Preferences, Tab 4 (the Guest Account must be enabled first). Postings on this form will arrive at the email address you have in the Meta tab (tab 2). This email address should go to a FirstClass Conference, not a FirstClass User.

The Contact Form has a reply-to button. It will only work if the recipient of the form is a conference.

FirstMagic FormBuilder Forms

If you are the FirstClass Administrator, you can find stationary for FirstMagic Forms in the Stationary Menu. If you are not an Admin, ask your Admin to give you a folder with fresh FirstMagic Forms Stationary. Use these to build custom forms and surveys.

There are two modules:

• Formbuilder and
• QuizBuilder

These work as normal FirstClass stationary, and can be configured in the FirstClass Client. They are templates from which you can build a wide range of forms, simply by clicking selections and filling in field labels. Place them in any FirstMagic Container and they will become popup forms on the web.

NOTE: for a form to work, it must have a recipient. This should be a FirstClass Conference, not a FirstClass User. Further: to make them available to anonymous visitors, the Guest Account must be configured; else, a login dialog will appear when they load, and only people with FirstClass Accounts can use them.

If you add an email field for the visitor to fill in, the visitor will be unable to submit the form without supplying an email address. She will also receive a receipt after the form is submitted. If the visitor is an authenticated FirstClass User, she will receive a copy of the submitted form in her mailbox: if you want the user to be able to read this copy, you must make the FirstMagic Settings File available to her.


Best practice for all forms

• Create a Conference, and give it it´s own email address. Allow All Users Send privileges to it.

• In the Send To-field in your forms, write the email address of the conference. You can leave this field blank, but then all forms will be delivered to your webmaster email address (the email address you have in the Meta tab in FirstMagic Preferences).

• Get a copy of the FirstMagic Settings file, and drop it in the Rules Folder of the recipient conference (this makes it easy to share the incoming forms with other users that do not have access to your FirstMagic installation).

If you are the Administrator, FirstMagic Settings files in common languages can be found in the Extras folder of the FirstMagic installer download. Distribute it to your users for this purpose. If you are not the Admin, ask the Admin for a FirstMagic Settings file in your language. Place it in your Recipient Conference´s Rules Folder.

FormBuilder

The FormBuilder(Click the image to view it in full size)


Use this template to create Contact Forms, Order Forms, etc. The meta fields in the first row are necessary - the rest is optional.

To build the form, use the widgets to the right of each row to add, change or remove fields. You can skip a field by not giving it a field label.

The guide texts in the label fields are suggestions - you can label them any way you like. The only fields that have dedicated functions are the Name and Email fields.

If you add the Name field, it will be filled in automatically if the user is a logged-in FirstClass user. If you add the Email field, the form cannot be submitted without an email address filled in by the visitor.

When you are happy with the form, you can publish it on the web simply by placing it in the Top Menu or Sidebar (or in a container inside one of these menus). To give it a title, just fill in the Subject Field in it´s Properties window.


Fields
(Click the image above for a map of the list below):

A [required]: Introduction - a text field introducing the form - on the web, this becomes the form´s Sidebar. You can mix plain text and HTML in this box.

B [required]: Save as - The filename of this form.

C [required]: Send to - The email address to the recipient of this form. Must be a conference for reply-to to work. If this field is left empty, the recipient will be the default webmaster email address (see Tab 2 in FM Preferences).

D: Subject - The Message Subject. Can be pre-filled and hidden from the visitor.

E: Message - The Message Box. Can be omitted, or moved to the end of the form.

F: Name - the Name field. Can be expanded to include an Email field and other contact information fields via the widget box.

G: Configurable fields - create, modify or delete fields with the widget box [ H ], and give them field names by filling in the labels to the left of each one. Fields without labels will be skipped on the web.

Note: the very first configurable field must be a checkbox or text field. The following fields can also be number fields. If you start with a number field as #2 (right after the very first field), you can add number fields in neat rows of three. The "number" label simply means the fields are shorter - they can be used as text fields too.


QuizBuilder

The QuizBuilder(Click the image to view it in full size)


Use this template to create quizzes, surveys, etc. The meta fields in the first row are necessary - the rest is optional.

The QuizBuilder template can gather contact information and up to 20 multiple choice questions (up to 100 fields). It can be timed and self-grading, and has a secure mode for delivering results if you want to use it for more serious tests.

To build the form, use the widgets to the right of each row to add, change or remove fields. You can skip a field by not giving it a field label.

The guide texts in the label fields are suggestions - you can label them any way you like. The only fields that have dedicated functions are the Name and Email fields.

If you add the Name field, it will be filled in automatically if the user is a logged-in FirstClass user. If you add the Email field, the form cannot be submitted without an email address filled in by the visitor.

When you are happy with the form, you can publish it on the web simply by placing it in the Top Menu or Sidebar (or in a container inside one of these menus). To give it a title, just fill in the Subject Field in it´s Properties window.


Fields
(Click the image above for a map of the list below):

A [required]: Filename - the filename of this form.

B [required]: Quiz Title - the title of the form

C [required]: Send to - The email address to the recipient of this form. Should be a conference. If this field is left empty, the recipient will be the default webmaster email address (see Tab 2 in FM Preferences).

D [required]: Preface - a text field introducing the Quiz - on the web, this is the form´s Sidebar. You can mix text and HTML here.

E: Postscript - a message after the Quiz (for after the form is submitted, if Display Score is enabled).

F: Test time - set a time limit (in minutes); if higher than 0, the form will automatically submit when the time is up.

G: Ask for User Information - adds a group of meta-fields to collect information about the visitor.

H: Display Score - if checked, the form will grade itself and deliver a report to the user after submit. If unchecked, only authenticated users will get it - via a copy of the submitted form to their FirstClass Mailbox.

I: [Padlock] - The Padlock Icon means some calculations are not performed on the score, making the form more secure. The User Icon means no security measures in the source code, in exchange for more verbose score output.

J: The question for the first multiple-choice group.

K: An optional in-depht description of the question.

L: The submitter´s response field. Do *not* check this field.

M: The alternatives. Use up to five options. Empty options are not rendered on the web.

N: The correct answer. Check this field if you want the form to be self-grading. This field is not visible to the user.

O: Click the pencil icon to create the next next multiple-choice group.