Zeige letzte Bearbeiter
1 {{content/}}
2
3 == Auswahl der Erweiterung ==
4
5 {{figure image="FCTypo.png" width="400"}}
6 Auswahl der Erweiterung: Schritt 1
7 {{/figure}}
8
9 {{figure image="typo3_extension_use_2.png" width="400"}}
10 Auswahl der Erweiterung: Schritt 2
11 {{/figure}}
12
13 {{figure image="typo3_extension_use_3.png" width="400"}}
14 Auswahl der Erweiterung: Schritt 3
15 {{/figure}}
16
17 Die Extension wird als //General Plugin// in TYPO3 bereitgestellt.
18
19 1. Wählen Sie in TYPO3 die Installation eine //General Plugins// aus.
20 1. Wählen Sie //Insert Plugin// unter //Type// aus.
21 1. Wählen Sie nun unser Plugin //FormCycle Integrator// aus.
22
23 == Aktivieren in Templates ==
24
25 Gegebenenfalls muss die Erweiterung //Formcycle (xm_formcycle)// in den Templates im Reiter //Includes// noch für die entsprechenden Seiten eingebunden werden.
26
27 == Arbeiten mit der Erweiterung ==
28
29 Nach der Auswahl des Plugins auf der entsprechenden Seite stehen fünf neue Reiter zur Auswahl:
30
31 === Formular (form) ===
32
33 {{lightbox image="extension_use_form.png" width="400"/}}
34
35 In diesem Reiter werden alle zur Verfügung stehenden Formulare angezeigt. Wählen Sie das entsprechende Formular. Wenn Sie den Formularinhalt ändern möchten, klicken Sie auf die Schaltfläche //Designer//. Der {{designer/}} wird jetzt im neuen Fenster mit dem ausgewählten Formular geöffnet. Über die Schaltfläche //refresh// werden die Formulare erneut vom {{fcserver case="dat"/}} geladen. Weitere Informationen zum Arbeiten mit dem {{designer case="dat"/}} erhalten Sie [[hier.>>doc:Formcycle.FormDesigner.WebHome]]
36
37 {{info}}
38 Wurden in der Konfiguration keine Benutzerangaben gemacht, erhalten Sie beim Öffnen des Reiters eine Login-Aufforderung. Geben Sie hier ihre Anmeldedaten für Ihren Account auf dem {{fcserver case="dat"/}} ein.
39 {{/info}}
40
41 {{lightbox image="extension_login.png" width="400"/}}
42
43 === Antwortseiten (response pages) ===
44
45 {{lightbox image="extension_use_resp.png" width="400"/}}
46
47 Nach dem Absenden des Formulars (POST-Request) muss eine Antwortseite angezeigt werden. Hier definieren Sie die Antwortseite bei erfolgreichem und fehlerhaften Absenden der Formulardaten. Fehler treten in der Regel bei falsch konfigurierten Aktionen bzw. bei Nichterreichbarkeit externer Komponenten auf.
48
49 === JavaScript und CSS ===
50
51 {{lightbox image="extension_use_css.png" width="400"/}}
52
53 Die im {{designer case="dat"/}} erstellten Formulare verwenden einige Javascript-Frameworks wie z.B. jQuery, sowie teilweise auch benutzerdefinierte CSS-Dateien. Wurde im TYPO3-Projekt bereits jQuery eingebunden, muss FormCycle nicht zusätzlich jQuery laden und einbinden. Über die Checkboxen kann eingestellt werden, welche Scripte geladen bzw. nicht geladen werden sollen. Bei den CSS- Dateien verhält es sich etwas anders. Die hier angegeben CSS-Dateien werden beim Aufruf des {{designer case="gen"/}} mit geladen und stehen dann im CSS-Bereich der Elemente als CSS-Klassen zur Verfügung.
54
55 * {{litem title="Vorhandenes CSS verwenden (Use available css)"}}Hier können eine oder mehrere CSS-Dateien angegeben werden. Bitte stellen Sie sicher, dass diese CSS Dateien später auch auf der Seite eingebunden sind.{{/litem}}
56 * {{litem title="Von FormCycle bereitgestelltes jQuery-Framework verwenden (Use the jQuery framework provided by FormCycle)"}}Ist die Checkbox aktiviert (default), wird das jQuery Framework (jquery-xxx.min.js) vom Formular geladen.{{/litem}}
57 * {{litem title="Von FormCycle bereitgestelltes jQuery UI Framework verwenden (Use the jQuery UI framework provided by FormCycle)"}}Haben Sie im Formular jQuery UI Komponenten eingebunden (z.B. Datepicker ...) muss diese Checkbox aktiviert bzw. die entsprechende Datei in einem TYPO3 Template definiert werden.{{/litem}}
58 * {{litem title="Von FormCycle bereitgestelltes response.js Framework verwenden (Use the responsejs framework provided by FormCycle)"}}Wurden //Responsive Design//-Funktionen (deprecated) im Formular verwendet, muss diese Checkbox aktiviert bzw. die entsprechende Datei in einem TYPO3-Template definiert werden.{{/litem}}
59
60 {{warning}}
61 Wird die Checkbox //Von FormCycle bereitgestelltes jQuery-Framework verwenden// deaktiviert, muss sichergestellt sein, dass im entsprechenden TYPO3-Template das jQuery-Framework am Anfang der Seite geladen wurde!
62 {{/warning}}
63
64 === Parameter ===
65
66 {{lightbox image="extension_use_params.png" width="400"/}}
67
68 Im Feld //Parameter// können sog. URL Parameter für den Aufruf des Formulars mitgegeben werden. Diese stehen dann im aufgerufenen Formular zur weiteren Verarbeitung zur Verfügung.
69
70 {{info}}
71 Die oder die eingegebenen Parameter müssen immer mit einem Und-Zeichen {{code language="none"}}&{{/code}} beginnen. Jeder weitere Parameter muss ebenfalls mit einem Und-Zeichen beginnen.
72
73 **Richtig:**
74 &param1=wert1&param2=wert2
75
76 **Falsch:**
77 param1=wert1&param2=wert2
78 ?param1=wert1&param2=wert2
79 &param1=wert1 param2=wert2
80 ....
81 {{/info}}
82
83 Ab Version 7.2.0 der TYPO3-Extension können über einen Platzhaltermechanismus Werte von URL-Parametern verwendet werden. Diese müssen wie folgt benutzt werden:
84
85 {{code language="none"}}&param1={NAME_DES_URL_PARAMETERS}{{/code}}
86
87 Weitere Informationen zur Weiterverarbeitung der eingegeben Parameter im {{designer case="dat"/}} bzw. Formular finden Sie im Bereich [[URL-Parameter>>doc:Formcycle.FormDesigner.URLParameter]].
88
89 === Administration ===
90
91 {{figure image="extension_use_admin.png" width="400"}}
92 Das Login der Verwaltungsoberfläche von {{formcycle case="dat"/}}, in der Ihnen alle Konfigurationsmöglichkeiten bereitstehen.
93 {{/figure}}
94
95 Hier kommen Sie direkt zum Login der Verwaltungsoberfläche von {{formcycle case="dat"/}}, in der Ihnen alle Konfigurationsmöglichkeiten bereitstehen.
Copyright 2000-2025