Benutzer-Werkzeuge

Webseiten-Werkzeuge


addons:modules:blackforms

Unterschiede

Hier werden die Unterschiede zwischen zwei Versionen gezeigt.

Link zu dieser Vergleichsansicht

Beide Seiten der vorigen Revision Vorhergehende Überarbeitung
Nächste Überarbeitung
Vorhergehende Überarbeitung
addons:modules:blackforms [2014/08/06 17:43]
shadowcat [Einrichtung]
addons:modules:blackforms [2014/08/13 00:00] (aktuell)
Zeile 2: Zeile 2:
  
 blackForms ist ein neues Formularmodul,​ welches speziell für BlackCat CMS geschrieben wurde bzw. wird. Es setzt das Bibliotheksmodul lib_wblib voraus. blackForms ist ein neues Formularmodul,​ welches speziell für BlackCat CMS geschrieben wurde bzw. wird. Es setzt das Bibliotheksmodul lib_wblib voraus.
 +
 +Aktuelle Testversionen:​ http://​forum.blackcat-cms.org/​viewtopic.php?​f=21&​t=99&​p=1439#​p1439
 +
 +Das Modul wurde sowohl mit BlackCat v1.0.3 als auch mit v1.1 getestet, befindet sich derzeit aber noch in der Entwicklung. Ein produktiver Einsatz wird im Augenblick **nicht** empfohlen!
  
 ===== Funktionen (Zusammenfassung) ===== ===== Funktionen (Zusammenfassung) =====
Zeile 16: Zeile 20:
 Nachdem eine blackForms-Sektion hinzugefügt (oder eine entsprechende Seite angelegt) wurde, muß zunächst ein Preset gewählt werden. Nachdem eine blackForms-Sektion hinzugefügt (oder eine entsprechende Seite angelegt) wurde, muß zunächst ein Preset gewählt werden.
  
-{{:​addons:​modules:​blackforms_preset.png?​direct&​200|}}+{{:​addons:​modules:​blackforms_preset.png?​nolink|}}
  
 <WRAP center round tip 100%> <WRAP center round tip 100%>
Zeile 22: Zeile 26:
 </​WRAP>​ </​WRAP>​
  
-Nachdem dieses ausgewählt wurde, springt blackForms automatisch zu den Einstellungen. Folgende Einstellungen werden standardmäßig vorgenommen und können angepaßt werden:+Nachdem dieses ausgewählt wurde, springt blackForms automatisch zu den Einstellungen. ​ 
 + 
 +==== Einstellungen ==== 
 + 
 +Folgende Einstellungen werden standardmäßig vorgenommen und können angepaßt werden:
  
 {{:​addons:​modules:​2014-08-05_192500.png?​nolink|}} {{:​addons:​modules:​2014-08-05_192500.png?​nolink|}}
Zeile 55: Zeile 63:
   ; Erfolgreich Text : Dieser Text wird dem Besucher im Browser angezeigt, wenn der Versand erfolgreich war   ; Erfolgreich Text : Dieser Text wird dem Besucher im Browser angezeigt, wenn der Versand erfolgreich war
   ; Bei Erfolg auf Seite weiterleiten : Als Alternative zum "​Erfolgreich Text" kann auf eine CMS-Seite weitergeleitet werden. Diese kann dann besser ausgestaltet werden als ein simpler Info-Text.   ; Bei Erfolg auf Seite weiterleiten : Als Alternative zum "​Erfolgreich Text" kann auf eine CMS-Seite weitergeleitet werden. Diese kann dann besser ausgestaltet werden als ein simpler Info-Text.
 +
  
 ==== Platzhalter - Formulardaten in Mails und Erfolgreich-Seite ==== ==== Platzhalter - Formulardaten in Mails und Erfolgreich-Seite ====
Zeile 62: Zeile 71:
 Beispiel: Es gibt ein Feld namens ''​sendername''​. Der Platzhalter sieht dann so aus: ''​{$sendername}''​ Beispiel: Es gibt ein Feld namens ''​sendername''​. Der Platzhalter sieht dann so aus: ''​{$sendername}''​
  
 +Ein etwas ausführlicheres Beispiel:
 +
 +    Liebe(r) {$title} {$sendername},​
 +    ​
 +    vielen Dank für Ihre Einsendung. Bitte prüfen Sie noch einmal Ihre Versandadresse:​
 +    ​
 +    {$street}
 +    {$zip} {$city}
 +    ​
 +    Sollten Sie diese Mail...(usw.)
 ===== Bearbeiten des Formulars ===== ===== Bearbeiten des Formulars =====
  
Zeile 72: Zeile 91:
 ==== Feld bearbeiten ==== ==== Feld bearbeiten ====
  
-Derzeit kann man nur die Beschriftung bearbeiten sowie die Einstellung,​ ob das Feld ein Pflichtfeld ist oder nicht. ​Pflichtfelder werden beim Absenden des Formulars automatisch daraufhin überprüft,​ ob sie ausgefüllt wurden.+Nicht alle Eigenschaften eines Formularfeldes können nachträglich geändert werden; so ist die Änderung des Namens etwa nicht möglichDieser wird im Bearbeiten-Dialog als ausgegrautes Feld angezeigt.
  
-{{:​addons:​modules:​2014-08-05_194605.png?​nolink|}}+{{:​addons:​modules:​2014-08-08_154058.png?​nolink|}} 
 + 
 +'​Optionen'​ sind nur für Selectboxen (Dropdown), Radiogruppen oder Checkboxen sinnvoll. Hier gibt es zwei Möglichkeiten:​ 
 + 
 +  - Ein Wert pro Zeile\\ ​ Der Wert wird sowohl als Wert als auch für die Beschriftung verwendet. 
 +  - <​Wert>​|<​Beschriftung>​ (jeweils ein Eintrag pro Zeile)\\ ​ Hinter dem Wert, der gespeichert wird, wird mit einem Pipe-Symbol separiert die Beschriftung angegeben. 
 + 
 +<WRAP center round important 100%> 
 +Es ist zu beachten, daß die beiden Varianten nicht gemischt werden sollten! 
 +</​WRAP>​
  
 ==== Feld hinzufügen ==== ==== Feld hinzufügen ====
  
-Das Formular zum Hinzufügen eines neuen Feldes wird sich noch ändern. Derzeit sieht es so aus:+Das Formular zum Hinzufügen eines neuen Feldes wird sich möglicherweise ​noch ändern. Derzeit sieht es so aus:
  
-{{:​addons:​modules:​2014-08-06_132341.png?​nolink|}}+{{:​addons:​modules:​2014-08-08_154713.png?​nolink|}}
  
   ; Name : Der interne Feldname (Kleinschreibung,​ keine Leer- oder Sonderzeichen)   ; Name : Der interne Feldname (Kleinschreibung,​ keine Leer- oder Sonderzeichen)
   ; Typ : Standard ist das einzeilige Eingabefeld,​ es sind aber auch Textareas, Radiogruppen etc. möglich   ; Typ : Standard ist das einzeilige Eingabefeld,​ es sind aber auch Textareas, Radiogruppen etc. möglich
   ; Beschriftung : Die Beschriftung,​ die der Besucher zu sehen bekommt   ; Beschriftung : Die Beschriftung,​ die der Besucher zu sehen bekommt
 +  ; Vorgabewert : Dieser Wert wird bei Textfeldern automatisch eingetragen;​ bei Select-, Radio- oder Checkboxen wird der entsprechende Wert vorausgewählt
 +  ; Optionen : Optionen für Selectfelder,​ Radiogruppen oder Checkboxen; wird bei allen anderen Feldtypen ignoriert
   ; Pflichtfeld : Ob es sich um ein Pflichtfeld handelt oder nicht   ; Pflichtfeld : Ob es sich um ein Pflichtfeld handelt oder nicht
   ; Position : Standardmäßig ist "​hinter..."​ ausgewählt,​ was sich auf das nächste Feld mit der Liste der bereits vorhandenen Formularelemente bezieht. Weitere Möglichkeiten sind "am Anfang"​ und "am Ende"   ; Position : Standardmäßig ist "​hinter..."​ ausgewählt,​ was sich auf das nächste Feld mit der Liste der bereits vorhandenen Formularelemente bezieht. Weitere Möglichkeiten sind "am Anfang"​ und "am Ende"
   ; Feld : Hat nur Auswirkungen im Zusammenhang mit "​hinter..."​ im Feld "​Position"​. Standardmäßig ist das Feld ausgewählt,​ neben dem das Plus-Icon angeklickt wurde.   ; Feld : Hat nur Auswirkungen im Zusammenhang mit "​hinter..."​ im Feld "​Position"​. Standardmäßig ist das Feld ausgewählt,​ neben dem das Plus-Icon angeklickt wurde.
 +
 +==== Feldtypen ====
 +
 +blackForms unterstützt eine ganze Reihe Feldtypen, von denen einige sehr speziell sind.
 +
 +  ; Eingabefeld (einzeilig) : Der Standard. Ein einzeiliges Feld für kurze Texte.
 +  ; Textfeld (mehrzeilig) : Ein Textfeld für längere Texte.
 +  ; Select (Dropdown) : Eine Auswahlliste mit Vorgabewerten.
 +  ; Radiogroup : Mehrere Optionen, von denen eine ausgewählt werden kann.
 +  ; Checkboxgroup : Mehrere Optionen, von denen mehrere ausgewählt werden können.
 +  ; Legend : Eine Legende beginnt ein neues Fieldset. Sie dient zur Abgrenzung mehrerer Formularbereiche (wie eine Überschrift).
 +  ; Infotext : Ein Hinweistext,​ der nur im Formular erscheint, jedoch nicht mit übertragen und gespeichert wird.
 +  ; Länderauswahl : Eine Liste von Ländern als Auswahlliste.
 +  ; Bildauswahl : Eine Auswahlliste mit Bildern.
 +  ; Verstecktes Feld : Das Feld wird dem Besucher nicht angezeigt. Der sinnvolle Einsatz erfordert einen Vorgabewert.
 +
  
 ==== Felder sortieren ==== ==== Felder sortieren ====
Zeile 96: Zeile 142:
  
 Hier wird das Feld "​Faxnummer"​ verschoben. Der gelbe Rahmen zeigt den Bereich an, in den das Feld eingefügt wird, wenn die Maustaste losgelassen wird. Hier wird das Feld "​Faxnummer"​ verschoben. Der gelbe Rahmen zeigt den Bereich an, in den das Feld eingefügt wird, wenn die Maustaste losgelassen wird.
 +
 +===== Einträge verwalten =====
 +
 +Standardmäßig öffnet blackForms beim Aufruf der Seite im Backend den Reiter [Einträge]. Hier werden die vorhandenen Einträge mit Größe und Absender (Benutzerkennung) aufgelistet.
 +
 +{{:​addons:​modules:​2014-08-13_131043.png?​nolink|}}
 +
 +Über das Icon in der Spalte "​Details"​ können die gespeicherten Formulardaten eingesehen werden. Hier ist auch eine einmalige Mailantwort an den Absender möglich. Wurde eine solche Antwort bereits versendet, ist das an dem grünen Häkchen in der Spalte "​Beantwortet"​ ersichtlich.
 +
 +Die gespeicherten Formulardaten können in eine CSV-Datei exportiert werden. Hierzu die entsprechenden Einträge anhaken - oder alternativ die Checkbox in der Kopfzeile anhaken, um alle Einträge zu markieren -, aus dem Select-Feld "​Ausgewählte..."​ -> "​Exportieren"​ wählen und auf [Absenden] klicken. Die vorhandenen Sicherungen bzw. Exporte werden auf dem Reiter [Exporte] aufgelistet und können von dort auch heruntergeladen werden.
 +
 +Über das Mülleimer-Symbol am Ende der Zeile können einzelne Einträge gelöscht werden. Alternativ geht das auch über Anhaken -> "​Ausgewählte..."​ -> "​Löschen"​ -> [Absenden].
 +
 +In der Spalte "​Absender"​ steht der Name des BlackCat CMS Backend Benutzers, wenn dieser zum Zeitpunkt der Versendung angemeldet war. Ansonsten steht dort "​Besucher (nicht angemeldet)"​.
addons/modules/blackforms.1407339821.txt.gz · Zuletzt geändert: 2014/08/06 00:00 (Externe Bearbeitung)