Usage

Content [ Hide ]

Selecting the extension
Include the extension
Working with the extension

Selecting the extension

Selecting the extension, step 1.

Selecting the extension, step 2.

Selecting the extension, step 1.

The extension is a General plugin for TYPO3.

Go to the TYPO3 page for general plugins.
Click on Type and choose Insert Plugin.
Select the plugin.

Include the extension

You may also need to include the extension in the templates first. Go to the template of your page and click on the includes tab and select Formcycle (xm_formcycle).

Working with the extension

After selecting the plugin, the following five tabs become available.

form

This tab lists all available forms. Choose the form you want to edit and click on designer to open the form editor in a new window or tab. After you are done editing, click on refresh to reload the form. See our help pages on working with the Xima® Formcycle Designer..

When no login details have been specified on the configuration page, you will be redirected to the login page. Enter the username and password of your account.

response pages

The page the user will see after having submitted a form. Common errors that occur often are wrongly configured actions or unavailable external web services or pages.

JavaScript and CSS

Forms created with Xima® Formcycle use certain JavaScript libaries, mainly jQuery, as well as custom CSS files. When jQuery has been included with TYPO3 already, you can save bandwidth by preventing Xima® Formcycle from loading jQuery again. The options in this tab let you select which JavaScript files should be loaded.

The CSS files you can select on this tab are loaded automatically when opening the Xima® Formcycle Designer and will be available in the CSS panel of the Xima® Formcycle Designer.

Use available CSS
Select the CSS you want to include in the page.
Use the jQuery framework provided by FORMCYCLE
When checked, the jQuery library will be loaded by Xima® Formcycle.
Use the jQuery UI framework provided by FormCycle
When checked, the jQuery UI library will be loaded by Xima® Formcycle.
Use the responseJS framework provided by FormCycle
Deprecated, do not use this.

When not using the jQuery library provided by Xima® Formcycle, make certain jQuery will be loaded by the TYPO3 page before the form gets loaded.

Parameters

You can specify additional URL parameters for the URL used to open the form. These parameters can be accessed by custom JavaScript files included in the form.

Always use an ampersand sign at the beginning and as the separator of URL parameters.

Correct:
&param1=wert1&param2=wert2

Wrong:
param1=wert1&param2=wert2
?param1=wert1&param2=wert2
&param1=wert1 param2=wert2

Starting with version 7.2.0 of the TYPO3 extension, values of URL parameters can be used via a placeholder mechanism. These must be used as follows:

&param1={NAME_OF_URL_PARAM}

See the help pages on URL parameter for special parameters used by Xima® Formcycle.

Administration

This will open the administration pages for Xima® Formcycle. For more details, see the help pages on modules and system settings.

Tags: