Benutzerhandbuch für die Komponente. CKForms. Version 1.3.3

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...4 A Installation...4 B Deinstallation Formulare...7 A Reiter Allgemein...8 B Reiter Result...9 C Reiter D Reiter Fortgeschritten...11 E - Reiter Frontend-Display...12 F Reiter Hilfe...13 G Liste der Formulare Felder...15 A Reiter Allgemein...16 A.1 Hinzufügen eines Feldtyps Text...16 a Hinzufügen eines Feldtyps Passwort...17 b Hinzufügen eines Feldtyps c Hinzufügen eines Feldtyps Datum...17 d Hinzufügen eines Feldtyps Numerisch (in der augenblicklichen deutschen Sprachdatei als Anzahl bezeichnet)...17 A.2 Hinzufügen eines Feldes Versteckt (hidden)...18 A.3 Hinzufügen eines Feldes Textarea (Textbereich)...18 A.4 Hinzufügen eines Feldes Checkbox (Kontrollkästchen)...19 A.5 Hinzufügen eines Feldes Radio button...20 A.6 Hinzufügen eines Feldes Select Box (Listenfeld)...21 A.7 Hinzufügen eines Feldes File upload (Datei hochladen)...22 A.8 Hinzufügen eines Feldes Button...22 A.9 Hinzufügen eines Feldes Field separator...23 B Reiter Layout...23 C Reiter Fortgeschritten...24 D Reiter Hilfe...24 K Liste der Formularfelder Daten...26 A Details anzeigen...26 B Löschen eines Datensatzes...27 C Daten exportieren Editieren des CSS style sheet Sicherung / Wiederherstellung von Formularen und Datensätzen...29 A Sicherung der Formulare und Daten...29 B Wiederherstellen der Formulare und der Daten Formulare anzeigen...30 A Menü mit Link zu einem Formular...30 B Formular in einem Artikel anzeigen...32 C Formular in einem Modul anzeigen...33 D - Formularansicht

3 8. Daten im Frontend anzeigen...35 A Ein Menü mit einem Link zur Datentabelle erzeugen...35 Weitere Informationen:

4 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. Das Plug-in lässt sich unter Erweiterungen Plug-ins anzeigen. 4

5 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. 5

6 6

7 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 Allgemein B Reiter Ergebnis C Reiter D Reiter Fortgeschritten E Reiter Frontend-Display F Reiter Hilfe 7

8 A Reiter Allgemein Der Reiter Allgemein beinhaltet: den Namen des Formulars in der Datenbank (der Formularname darf nur die folgenden Zeichen enthalten: abcdefghijklmnopqrstuvwxyzabcdefghijklmnopqrstuvwxyz ) die Überschrift des Formulars den Publikationsstatus des Formulars ein beschreibender Text, welcher oberhalb des Formulars angezeigt wird 8

9 B Reiter Result Der Reiter Ergebnis 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 Achtung!: Falls ein Text angezeigt wird und die Weiterleitungs-URL leer ist, wird CKForms nach dem Absenden nur einen leeren Bildschirm anzeigen. 9

10 C Reiter Der Reiter beinhaltet: ob Formulardaten per verschickt werden den Namen des Absenders ( von) den Namen des Empfängers ( an) -Empfänger für Kopien (CC) -Empfänger mit Blindkopien (BCC) den Betreff der hoch geladene 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 10

11 D Reiter Fortgeschritten Der Reiter Fortgeschritten beinhaltet: das Aktivieren des anti-spam den Kontextext für anti-spam den angepassten Text bei einem Eingabefehler des anti-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. 11

12 E - Reiter Frontend-Display Die Anzeige der Daten, die über ein CKForms Formular gespeichert wurden, im Frontend ist eine neue Eigenschaft der Version (siehe xxx für die Einstellung) Der Reiter Frontend-Display beinhaltet: Anzeige der IP-Adresse (als Spalte in der Tabellenansicht und horizontal in der Detailanzeige) Anzeige der detaillierten Datenbankoperationen Titel der Datentabelle Beschreibung als Anzeige vor der Datentabelle 12

13 F Reiter Hilfe In der Version wurde ein neuer Reiter Hilfe eingefügt. Darin sind Informationen zur Konfiguration eines Formulars. 13

14 G Liste der Formulare In dieser Listenansicht können Sie: ein Formular freigeben oder sperren Formulare löschen ein Formular zum Editieren öffnen (anklicken von Titel oder Name) 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 14

15 3. Felder Um die Feldliste anzuzeigen klicken Sie auf das Icon Felder in der Liste. Danach klicken Sie auf Neu, um das Fenster zur Erzeugung neuer Felder anzuzeigen. Dieses Fenster setzt sich aus folgenden Reitern zusammen (Beschreibung auf den folgenden Seiten): A Reiter Allgemein B Reiter Layout C Reiter Fortgeschritten D Reiter Hilfe 15

16 A Reiter Allgemein Der Reiter Allgemein beinhaltet: einen eindeutigen Namen des Formularfeldes ohne Leerzeichen oder Sonderzeichen (der Feldname darf nur die folgenden Zeichen enthalten: abcdefghijklmnopqrstuvwxyzabcdefghijklmnopqrstuvwxyz ) Feldbezeichnung für das Formular. Dieser darf alle Zeichen enthalten. ob das Feld freigegeben ist oder nicht die Auswahl des Feldtyps; wird nachfolgend erläutert. A.1 Hinzufügen eines Feldtyps Text 16

17 Das Feld vom Typ Text ist ein einzeiliges Textfeld, das ausgefüllt werden soll. Dazu müssen Sie: auswählen, ob es sich um ein Pflichtfeld handelt auswählen, ob es sich um ein Nur-Lese-Feld handelt einen Text als Tool-tipp Information eintragen (optional) einen Fehlertext eintragen, der angezeigt wird, wenn ein Feld nicht oder nicht richtig ausgefüllt wird (optional) die maximale Anzahl an Zeichen festlegen, die in das Feld eingegeben werden dürfen (optional) die minimale Anzahl an Zeichen festlegen, die in das Feld eingetragen werden müssen (optional) einen Startwert eingeben (Text, der als Vorbelegung erscheint) (optional) den Datentyp bestimmen, der in das Feld eingetragen werden soll. a Hinzufügen eines Feldtyps Passwort Das Feld Passwort ist ein Textfeld, bei dem die eingegebenen Zeichen versteckt werden. b Hinzufügen eines Feldtyps Das Feld ist ein Textfeld, das auf eine -Adresse prüft (...@...) c Hinzufügen eines Feldtyps Datum Das Feld Datum ist ein Textfeld, das die Validität eines Datums überprüft und eine Hilfe zur Datumseingabe bereit stellt. Im Typ Datum gibt es noch die Optionen, das Datumsformat auszuwählen, falls Sie das voreingestellte Format überschreiben wollen (das voreingestellte Format basiert auf der Ländereinstellung) den augenblicklichen Tag als Vorbelegung zu wählen d Hinzufügen eines Feldtyps Numerisch (in der augenblicklichen deutschen Sprachdatei als Anzahl bezeichnet) Das Feld Numerisch ist ein Textfeld, welches nur Ziffern enthalten darf 17

18 A.2 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. A.3 Hinzufügen eines Feldes Textarea (Textbereich) 18

19 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 Physisch übernimmt Zeilenumbruchzeichen (z.b. ENTER-Taste) des Nutzers A.4 Hinzufügen eines Feldes Checkbox (Kontrollkästchen) Der Feldtyp Checkbox (Ankreuzfeld) ermöglicht die Auswahl einer Option. Es kann bestimmt werden, ob die Auswahl bereits ausgewählt erscheint. 19

20 A.5 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 RadioButtons 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 20

21 A.6 Hinzufügen eines Feldes Select Box (Listenfeld) 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 21

22 A.7 Hinzufügen eines Feldes File upload (Datei hochladen) 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. A.8 Hinzufügen eines Feldes Button Der Feldtyp Button (Schaltfläche) ermöglicht das Absenden oder Zurücksetzen eines Formulars. 22

23 A.9 Hinzufügen eines Feldes Field separator Der Feldtyp Field separator (Feldtrenner) wird benutzt, um eine Gruppierung von Feldern zu ermöglichen. Dabei kann eine Linie gezeichnet werden oder nicht bei Benutzung der Schaltfläche Linie nicht sichtbar B Reiter Layout Der Reiter Layout beinhaltet die Möglichkeiten: CSS-Klasse für die Feldbezeichnung (Etiketten) CSS-Klasse für das Formularansicht CSS-Klasse für den nutzerspezifischen Text zu definieren. 23

24 C Reiter Fortgeschritten Unter dem Reiter Fortgeschritten können Sie: bestimmen, ob der Text im Frontend angezeigt werden soll, den benutzerdefinierten Text, wenn er erscheinen soll, eingeben D Reiter Hilfe In der Version gibt es einen neuen Reiter Hilfe. Unter diesem finden Sie Informationen zur Konfiguration des Feldes. 24

25 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. 25

26 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 exportieren (csv-daten können von Kalkulationsprogrammen wie z.b. MS-Excel gelesen werden). Setzen, ob die Daten publiziert werden im Front-end A Details anzeigen Durch Anklicken eines Datensatzes werden die Details des Datensatzes angezeigt. 26

27 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. 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. 27

28 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. 28

29 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! 29

30 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. 30

31 Wählen Sie dann einen entsprechenden Namen und das anzuzeigende Formular aus der Dropdown-Liste. Positionieren Sie danach den eben erstellten Menüpunkt an die Stelle des Menüs, an der der Eintrag erscheinen soll. 31

32 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. 32

33 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. In diesem Modul wählen Sie die Überschrift und die Position des Moduls aus und in der Auswahlliste das anzuzeigende Modul 33

34 D - Formularansicht Das Formular wird je nach erstellten Feldern im Frontend z.b. so angezeigt 34

35 8. Daten im Frontend anzeigen Die Daten werden auf folgendem Weg angezeigt: in einer eigenen Seite (definiert über einen Link in einem Menü) A Ein Menü mit einem Link zur Datentabelle erzeugen Im Menümanager von Joomla wählen Sie das Menü, in dem der Link erzeugt werden soll Danach klicken Sie auf Neu, um einen neuen Menülink zu erzeugen. Für weitere Informationen zu Menüs greifen Sie bitte auf das Joomla Handbuch zu. Wählen Sie Standard data CKForms CSS Layout und geben den Titel ein. Danach wählen Sie den Datensatz aus. 35

36 Bestimmen Sie weiterhin, ob die Spaltenköpfe und der Tabellenrahmen angezeigt werden sollen. Die dann angezeigten Daten im Frontend könnten dann so aussehen: 36

37 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. Dieses Handbuch darf frei verwendet werden. Die Vermarktung ist ausdrücklich untersagt. Handbuch-Version: vom 15. Oktober 2009 übersetzt von nfr Das Kopieren von Text und Bildern ist gesperrt. 37