Benutzerhandbuch für die Komponente. CKForms. Version 1.3.2

Transkript

1 Benutzerhandbuch für die Komponente CKForms Version Dieses Benutzerhandbuch erklärt die Hauptfunktionen der Komponente CK Forms und des Moduls und dem Plug-in. CKForms 1.3 ist die neue Version der Komponente für Joomla 1.5. Diese Komponente generiert Formulare und Felder ohne Programmierkenntnisse. Neben der Einfachheit in der Handhabung bietet es die Möglichkeit, Daten in einer Datenbank zu speichern und diese Daten als csv zu exportieren. Felder können validiert werden als Text, Nummer, Datum und . Auch eine Datei-upload -Möglichkeit ist vorhanden. Die Formulare können gespeichert und wiederhergestellt werden ohne Kenntnisse über Datenbankoperationen. Neben der Möglichkeit einen HTML-Editor einzubinden ist noch ein Sicherheitscode Captcha verfügbar, um die Formulare abzusichern. Weiterhin gibt es ein Plug-in und ein Modul, um die Formulare entweder in einem Artikel oder an einer Modulposition darzustellen. CKForms ist kompatibel zu Joomfish. Anmerkung: Der Formulargenerator CKForms ist nur für die Joomla Version 1.5 verfügbar! 1

2 Inhaltsverzeichnis 1. Installieren / Deinstallieren...3 A Installation...3 B Deinstallation Formulare...6 A Reiter General...7 B Reiter Result...8 C Reiter D Reiter Advanced...10 E Liste der Formulare Felder...12 A Gemeinsame Eigenschaften aller Felder...12 B Hinzufügen eines Feldtyps Text Datentyp Passwort Datentyp Datentyp Datum Datentyp Nummer...14 C Hinzufügen eines Feldes Versteckt (hidden)...15 D Hinzufügen eines Feldes Textarea...15 E Hinzufügen eines Feldes Checkbox...16 F Hinzufügen eines Feldes Radio button...17 G Hinzufügen eines Feldes Select...18 H Hinzufügen eines Feldes File upload...18 I Hinzufügen eines Feldes Button...19 J Hinzufügen eines Feldes Field seperator...19 K Liste der Formularfelder Daten...21 A Details anzeigen...21 B Löschen eines Datensatzes...21 C Daten exportieren Editieren des CSS style sheet Sicherung / Wiederherstellung von Formularen und Datensätzen...24 A Sicherung der Formulare und Daten...24 B Wiederherstellen der Formulare und der Daten Formulare anzeigen...25 A Menü mit Link zu einem Formular...25 B Formular in einem Artikel anzeigen...27 C Formular in einem Modul anzeigen Formularansicht...28 Weitere Informationen:

3 1. Installieren / Deinstallieren Achtung: Falls bereits eine Version von CKForms installiert ist und Sie die Formulare und gespeicherten Daten behalten wollen, müssen Sie vor der Deinstallation der Komponente eine Sicherung durchführen und nach der Neuinstallation eine Wiederherstellung durchführen. Dies wird aus dem Backend in der Komponente CKForms durchgeführt, indem die Schalter Backup für das Sichern und der Schalter Restore für die Wiederherstellung angeklickt wird. Falls Sie die CSS-Datei modifiziert haben, muss diese manuell vor der Deinstallation der Komponente gesichert werden. Diese Datei befindet sich in folgendem Verzeichnis: <joomla root> / components / com_ckforms / css / ckforms.css In einer späteren Version wird dies in der Sicherung enthalten sein. A Installation Die Installation der Komponente, des Plug-in und des Moduls erfolgt über das Installationsmenü im Backend von Joomla! Eine Installationsbestätigung wird jeweils nach der Installation der Komponente, des Plugin und des Moduls von Joomla! ausgegeben. 3

4 Das Plug-in lässt sich unter Erweiterungen Plug-ins anzeigen. B Deinstallation Die Deinstallation der Komponente, des Plug-in und des Moduls wird über das Modul Erweiterungen von Joomla durchgeführt: unter dem Reiter Komponenten wird die Komponente deinstalliert unter dem Reiter Module wird das Modul deinstalliert unter dem Reiter Plugins wird das Plug-in deinstalliert Achtung!: Falls Sie die Formulare und Daten behalten möchten, müssen Sie eine Sicherung vor der Deinstallation machen. 4

5 5

6 2. Formulare Wählen Sie in der Menüleiste Komponenten CK Forms Danach klicken Sie auf Neu, um ein neues Formular zu erstellen, welches sich aus den folgenden Reitern zusammensetzt (die Erklärung folgt auf den nächsten Seiten): A Reiter General B Reiter Result C Reiter D Reiter Advanced 6

7 A Reiter General Der Reiter General beinhaltet: den Namen des Formulars in der Datenbank die Überschrift des Formulars den Publikationsstatus des Formulars ein beschreibender Text, welcher oberhalb des Formulars angezeigt wird 7

8 B Reiter Result Der Reiter Result beinhaltet: ob der Eintrag in der Datenbank gespeichert wird ein Text, der dem Nutzer angezeigt wird, nachdem das Formular abgeschickt wurde eine URL, zu der der Nutzer umgeleitet wird, nachdem das Formular verschickt wurde 8

9 C Reiter Der Reiter beinhaltet: ob Formulardaten per verschickt werden den Namen des Absenders (FROM) den Namen des Empfängers (TO) -Empfänger für Kopien (CC) -Empfänger mit Blindkopien (BCC) den Betreff der hochgeladene Dateien senden ja/nein ob eine Empfangsbestätigung an den Formularausfüller gesendet wird den Betreff der Empfangsbestätigung den Text der -Bestätigung die zusammengefassten Daten der -Bestätigung ob die angefügten Dateien in der -Bestätigung geschickt werden 9

10 D Reiter Advanced Der Reiter Advanced beinhaltet: das Aktivieren des anti-spam den Kontextext für anti-spam den angepassten Text bei einem Eingabefehler des ant-spam eine für das Formular spezifische CSS-Klasse die Pfadangabe für gespeicherte Dateien, die über das Formular gesendet wurden die maximale Größe für Anhänge die Anzeige der Urheberrechtsinformation über CKForms Achtung!: Falls Sie das anti-spam (Captcha) nutzen wollen, muss die PHP-Bibliothek GD auf dem Server installiert sein. Falls Sie sich unsicher sind, fragen Sie bitte Ihren Provider. 10

11 E Liste der Formulare In dieser Listenansicht können Sie: ein Formular freigeben oder sperren Formulare löschen ein Formular zum Editieren öffnen ein neues Formular erzeugen ein vorhandenes Formular duplizieren die mit dem Formular verbundene Style-Datei editieren eine Sicherung oder Wiederherstellung machen die Felder eines Formulars editieren, um diese zu modifizieren oder in der Reihenfolge zu ändern anzeigen von gespeicherten Daten 11

12 3. Felder Um die Felderliste anzuzeigen klicken Sie auf das Icon Felder in der Liste. A Gemeinsame Eigenschaften aller Felder Alle Feldtypen haben folgende Eigenschaften gemeinsam: weisen Sie einen einzigartigen Namen jedem Formular zu, dieser darf keine Leerzeichen oder Sonderzeichen enthalten. Weiterhin dürfen keine von MySQL reservierten Worte als Feldnamen verwendet werden. Eine komplette Liste der reservierten MySQL-Worte finden Sie unter weisen Sie einen Titel zu, der die Funktion des Feldes erklärt setzen Sie das Feld auf freigegeben oder gesperrt wählen Sie eventuell eine CSS-Klasse für das Label wählen Sie eventuell eine CSS-Klasse für das Feld wählen Sie den Typ des Feldes aus der Auswahlbox tragen Sie eventuell einen vordefinierten Text für das Feld ein wählen Sie eventuell eine CSS-Klasse für den vordefinierten Text 12

13 B Hinzufügen eines Feldtyps Text Das Feld Text besteht aus einem einzeiligen Feld. Sie müssen: bestimmen, ob es sich um ein Pflichtfeld handelt bestimmen, ob das Feld ein Nur-Lese-Feld ist einen Text für das Tool-Tip eingeben (optional) einen Fehlertext erstellen, der angezeigt wird, wenn ein Pflichtfeld nicht oder nicht richtig ausgefüllt wird (optional) die maximal zulässige Anzahl von Zeichen für dieses Feld festlegen (optional) die minimale Anzahl an Zeichen für dieses Feld festlegen (optional) einen vordefinierten Text für das Feld erstellen (optional) den Datentyp für das Textfeld festlegen. Diese Auswahl bestimmt die Überprüfung des Inhalts. 1 Datentyp Passwort Der Datentyp Passwort erzeugt ein Textfeld, in dem die Zeichen bei der Eingabe versteckt dargestellt werden 2 Datentyp Der Datentyp überprüft, ob enthalten ist. 3 Datentyp Datum Der Datentyp Datum ist ein Textfeld, welches das Datumsformat überprüft 13

14 4 Datentyp Nummer Der Datentyp Nummer ist ein Textfeld, in dem auf numerische Werte überprüft wird 14

15 C Hinzufügen eines Feldes Versteckt (hidden) Der Feldtyp versteckt wird im Formular nicht angezeigt. Dieses Feld ermöglicht Informationen über das Formular oder bestimmte Felder zu sammeln und kann an verschiedenen Stellen innerhalb des Formulars eingefügt werden. Jedes Feld vom Typ versteckt muss einen eindeutigen Namen erhalten. Weiterhin kann hier ausgewählt werden, ob eine eindeutige ID automatisch vergeben wird mit dem Wert, der im Feld Value angegeben ist. D Hinzufügen eines Feldes Textarea 15

16 Der Feldtyp Textarea dient zur Aufnahme längerer Texte. Dazu ist es möglich, den in Joomla eingestellten Editor zur Verfügung zu stellen. Falls Sie den Editor nicht nutzen wollen, können Sie folgendes einstellen: Spalten geben an, wie viele Zeichen in einer Zeile erscheinen, bevor ein automatischer Zeilenumbruch erfolgt Zeilen geben an, wie viele Zeilen auf dem Bildschirm sichtbar sein sollen. Wrap aktiviert den Zeilenumbruch o Standard entspricht der Einstellung Virtual o Aus verhindert den Zeilenumbruch o Virtual Zeilenumbruch erfolgt am Ende des sichtbaren Fensters o Physical übernimmt Zeilenumbruchzeichen (z.b. ENTER-Taste) des Nutzers E Hinzufügen eines Feldes Checkbox Der Feldtyp Checkbox (Ankreuzfeld) ermöglicht die Auswahl einer Option. Es kann bestimmt werden, ob die Auswahl bereits ausgewählt erscheint. 16

17 F Hinzufügen eines Feldes Radio button Der Feldtyp Radio button (Auswahlknopf) sind eine Gruppe von beschrifteten Knöpfen, von denen der Anwender einen auswählen kann. Es kann immer nur einer der Radio-Buttons ausgewählt sein. Sie können: die Anzahl der Radio-Buttons bestimmen einen Radio-Button als vorausgewählt einstellen die Anzeige der Buttons bestimmen horizontal oder vertikal 17

18 G Hinzufügen eines Feldes Select Der Feldtyp Select (Auswahl) funktioniert im Prinzip wie der Feldtyp Radio Button. Sie können: mehrere Zeilen zur Auswahl anbieten eine Auswahl als vorbelegt definieren Mehrfachauswahlen erlauben H Hinzufügen eines Feldes File upload 18

19 Der Feldtyp File-upload (Datei-hochladen) ermöglicht das Übertragen einer Datei von Ihrer Festplatte zum Server, wenn das Formular abgeschickt wird. Die Datei wird dabei in das Verzeichnis gespeichert, welches bei der Formulardefinition festgelegt wurde. I Hinzufügen eines Feldes Button Der Feldtyp Button (Schaltfläche) ermöglicht das Absenden oder Zurücksetzen eines Formulars. J Hinzufügen eines Feldes Field seperator Der Feldtyp Field seperator (Feldtrenner) wird benutzt, um eine Gruppierung von Feldern zu ermöglichen. Dabei kann eine Linie gezeichnet werden oder nicht bei Benutzung der Schaltfläche Border not visible 19

20 K Liste der Formularfelder Hier wird eine Liste der Formularfelder dargestellt, die gerade behandelt wurden. Die Reihenfolge der Felder kann in dieser Liste verändert werden. Ebenso können Felder dupliziert oder gelöscht werden. 20

21 4. Daten Falls Sie das Speichern der Daten eines Formulars in der Konfiguration des Formulars gewählt haben, können Sie sich diese Daten ansehen und auch exportieren. Um diese Daten anzuzeigen, klicken Sie auf Daten anzeigen. Sie können: Die Einzelheiten jedes Datensatzes anzeigen Datensätze löschen Daten in eine csv-datei exporteieren (csv-daten können von Kalkulationsprogrammen wie z.b. MS-Excel gelesen werden). A Details anzeigen Durch Anklicken eines Datensatzes werden die Details des Datensatzes angezeigt. B Löschen eines Datensatzes Ein Datensatz wird gelöscht indem dieser Datensatz in der Liste ausgewählt wird und die Schaltfläche Löschen angeklickt wird. 21

22 C Daten exportieren Daten werden exportiert durch das Anklicken der Schaltfläche Export. Die Daten werden im Datei-Format csv exportiert, welches von Texteditoren und Kalkulationsprogrammen gelesen werden können. 22

23 5. Editieren des CSS style sheet Sie können das Erscheinungsbild eines Formulars Ihren Wünschen anpassen, indem das CSS style sheet editiert wird durch Anklicken des Schalters Edit CSS in der Formularliste. Achtung!: Falls Sie das CSS style sheet modifiziert haben, müssen Sie es manuell sichern, falls Sie ein update der Komponente vornehmen. Diese Datei finden Sie unter: <joomla root> / components / com_ckforms / css / ckforms.css Diese manuelle Sicherung wird in einer Folgeversion von ckforms in der Sicherungsroutine eingeschlossen werden. 23

24 6. Sicherung / Wiederherstellung von Formularen und Datensätzen A Sicherung der Formulare und Daten CKForms ermöglicht das Sichern Ihrer Formulare und der gespeicherten Daten (falls das Speichern eingeschaltet ist). Dies speichert alle Daten der CKForms-Tabellen aus der Datenbank auf Ihre Festplatte. Diese Daten können dann editiert werden. B Wiederherstellen der Formulare und der Daten CKForms ermöglicht die Wiederherstellung von Formularen und Daten auf dem Server durch die Back-up-Datei von Ihrer Festplatte. Dabei werden alle - wie Formulare, Felder und Daten übertragen. Achtung!: Falls Sie Daten wiederherstellen, werden alle augenblicklich vorhandenen Daten überschrieben! 24

25 7. Formulare anzeigen Formulare können folgendermaßen angezeigt werden: durch Verlinkung eines Menüpunktes im Inhalt eines Artikels durch das Plug-in in Modulpositionen A Menü mit Link zu einem Formular In der Schaltfläche Menüs (Joomla-Backend) wählen Sie das Menü, in dem der Eintrag erscheinen soll. Danach klicken Sie auf Neu, um einen neuen Menülink zu erstellen. Wählen Sie als Menütyp CKForms. Zur Zeit ist nur das Standardlayout von CKForms zur Auswahl verfügbar. 25

26 Wählen Sie dann einen entsprechenden Namen und das anzuzeigende Formular aus der Dropdown-Liste. 26

27 Positionieren Sie danach den eben erstellten Menüpunkt an die Stelle des Menüs, an der der Eintrag erscheinen soll. B Formular in einem Artikel anzeigen Um ein CKForms-Formular in einem Artikel anzuzeigen, muss das Plug-in CK-Forms installiert und aktiviert sein. Im Plug-in können Sie auswählen, ob der Formulartitel mit angezeigt werden soll. Das Einfügen in einen Artikel wird durch folgenden Tag erreicht {ckform name-des-formulars} wobei name-des-formulars ersetzt werden muss durch den Namen Ihres anzuzeigenden Formulars. C Formular in einem Modul anzeigen Bei der Installation des Moduls wird bereits ein Modul angelegt. Dieses können Sie für die Anzeige nutzen. Falls Sie ein weiteres Modul mit einem anderen Formular nutzen wollen, müssen Sie im Modulmanager ein neues Modul CKForms erstellen. 27

28 In diesem Modul wählen Sie die Überschrift und die Position des Moduls aus und in der Auswahlliste das anzuzeigende Modul 8. Formularansicht Das Formular wird je nach erstellten Feldern im Frontend z.b. so angezeigt 28

29 29

30 Weitere Informationen: CKForms wird hergestellt von Zusätzliche Informationen werden auf der Projektseite CKForms angezeigt Dort können Sie Fehler melden und Wünsche anmelden Handbuch-Version: vom 30. September übersetzt von nfr Das Kopieren von Text und Bildern ist gesperrt. 30