Wiki source code of Verwendung
Show last authors
author | version | line-number | content |
---|---|---|---|
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 | ¶m1=wert1¶m2=wert2 | ||
78 | |||
79 | **Wrong:** | ||
80 | param1=wert1¶m2=wert2 | ||
81 | ?param1=wert1¶m2=wert2 | ||
82 | ¶m1=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"}}¶m1={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]]. |