Show last authors
1 {{content/}}
2
3 == Selecting the extension ==
4
5 {{figure image="FCTypo.png" width="400"}}
6 Selecting the extension, step 1.
7 {{/figure}}
8
9 {{figure image="typo3_extension_use_2.png"}}
10 Selecting the extension, step 2.
11 {{/figure}}
12
13 {{figure image="typo3_extension_use_3.png"}}
14 Selecting the extension, step 1.
15 {{/figure}}
16
17 The extension is a //General// plugin for TYPO3.
18
19 1. Go to the TYPO3 page for general plugins.
20 1. Click on //Type// and choose //Insert Plugin//.
21 1. Select the plugin.
22
23 == Include the extension ==
24
25 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)//.
26
27
28 == Working with the extension ==
29
30 After selecting the plugin, the following five tabs become available.
31
32 === form ===
33
34 {{figure image="extension_use_form.png"/}}
35
36 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 {{designer/}}.>>doc:Formcycle.FormDesigner.WebHome]].
37
38 {{info}}
39 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.
40 {{/info}}
41
42 {{figure image="extension_login.png"/}}
43
44 === response pages ===
45
46 {{figure image="extension_use_resp.png"/}}
47
48 The page the user will see after having submitted a form. Common errors that occur often are wrongly [[configured actions>>doc:Formcycle.UserInterface.MyForms.WorkflowProcessing.Actions.WebHome]] or unavailable external web services or pages.
49
50 === JavaScript and CSS ===
51
52 {{figure image="extension_use_css.png"/}}
53
54 Forms created with {{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 {{formcycle/}} from loading jQuery again. The options in this tab let you select which JavaScript files should be loaded.
55
56 The CSS files you can select on this tab are loaded automatically when opening the {{designer/}} and will be available in the [[CSS panel>>doc:Formcycle.FormDesigner.ElementProperties.CSSClasses]] of the {{designer/}}.
57
58 * {{litem title="Use available CSS"}}Select the CSS you want to include in the page.{{/litem}}
59 * {{litem title="Use the jQuery framework provided by FORMCYCLE"}}When checked, the jQuery library will be loaded by {{formcycle/}}.{{/litem}}
60 * {{litem title="Use the jQuery UI framework provided by FormCycle"}}When checked, the jQuery UI library will be loaded by {{formcycle/}}.{{/litem}}
61 * {{litem title="Use the responseJS framework provided by FormCycle"}}Deprecated, do not use this.{{/litem}}
62
63 {{warning}}
64 When not using the jQuery library provided by {{formcycle/}}, make certain jQuery will be loaded by the TYPO3 page before the form gets loaded.
65 {{/warning}}
66
67 === Parameters ===
68
69 {{figure image="extension_use_params.png"/}}
70
71 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.
72
73 {{info}}
74 Always use an ampersand sign at the beginning and as the separator of URL parameters.
75
76 **Correct:**
77 &param1=wert1&param2=wert2
78
79 **Wrong:**
80 param1=wert1&param2=wert2
81 ?param1=wert1&param2=wert2
82 &param1=wert1 param2=wert2
83 {{/info}}
84
85 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:
86
87 {{code language="none"}}&param1={NAME_OF_URL_PARAM}{{/code}}
88
89 See the help pages on [[URL parameter>>doc:Formcycle.FormDesigner.URLParameter]] for special parameters used by {{formcycle/}}.
90
91 === Administration ===
92
93 {{figure image="extension_use_admin.png"}}
94 Login to the administration pages of {{formcycle/}}.
95 {{/figure}}
96
97 This will open the administration pages for {{formcycle/}}. For more details, see the help pages on [[modules>>doc:Formcycle.UserInterface.WebHome]] and [[system settings>>doc:Formcycle.SystemSettings.WebHome]].
Copyright 2000-2025