Einsatzleiterwiki

Diese Seite ist nicht editierbar. Sie können den Quelltext sehen, jedoch nicht verändern. Kontaktieren Sie den Administrator, wenn Sie glauben, dass hier ein Fehler vorliegt.
====== bureaucracy-Plugin: Formulare erstellen und aus den Eingabewerten des Formulars Mails versenden oder Wiki-Seiten erzeugen ======

:!: **Diese Anleitung ist noch nicht fertig** :!:

Mit dem bureaucracy-Plugin können HTML-Formulare auf Wiki-Seiten angezeigt werden. Die in das Formular eingegebenen Daten können entweder

  * per Email an eine oder mehrere Email-Adressen verschickt oder
  * zum Erzeugen von neuen Wiki-Seiten verwendet werden, in denen die Inhalte der Formularfelder an den definierten Stellen eingetragen werden.

Das bureaucracy-Plugin ist ein sehr mächtiges Werkzeug mit einem großen Funktionsumfang. Trotz dass die Erzeugung von einfachen Mail-Formularen bzw. die Erzeugung von Wiki-Seiten auch für Anfänger möglich ist, lassen sich mit dem Plugin komplexe Konstrukte umsetzen. Ebenso ist eine Interaktion mit anderen Plugins wie dem [[hilfe:plugins:optional:struct|struct-Plugin]] möglich.

Aufgrund des großen Funktionsumfangs kann das Plugin hier bei weitem nicht erschöpfend erklärt werden. Es wird daher auf die [[doku>plugin:bureaucracy|Dokumentation des bureaucracy-Plugins auf dokuwiki.org]] verwiesen.

Nachfolgend werden einige Beispiele beschrieben.

===== Versand von Formulardaten per Email =====

Der einfachste vorstellbare Fall eines Formulardatenversands ist auf der Seite [[https://einsatzleiterwiki.de/doku.php?id=kontakt_rechtliches|Kontakt / Rechtliches]] zu sehen - hier kann in ein Textfeld die eigene Email-Adresse eingegeben werden, die dann an eine vordefinierte Mailadresse geschickt wird.

Der Code für das Formular lautet folgendermaßen:

<code>
<form>
Action mail info@einsatzleiterwiki.de
Thanks "Danke für Ihre Anfrage. Sie erhalten schnellstmöglich den Einladungslink für die Telegram-Gruppe."
email "E-Mail-Adresse" "=@MAIL@"
hidden "Anliegen" "=Anforderung Einladungslink Telegram-Gruppe"
submit "Einladungslink für Telegram-Gruppe anfordern"
</form>
</code>

In der ersten Zeile wird definiert, ob bei Formularversand eine Seite angelegt oder eine Mail verschickt werden soll, hier ist letzteres der Fall (''Action mail''). Danach wird die Adresse des Empfängers angegeben ([[info@einsatzleiterwiki.de]]).

In der zweiten Zeile wird die Nachricht angegeben, die dem Benutzer nach dem Absenden des Formulars angezeigt werden soll (''Thanks "Danke für Ihre Anfrage. Sie erhalten schnellstmöglich den Einladungslink für die Telegram-Gruppe."'').

In der dritten Zeile beginnt das eigentliche Formular. Mittels des Steuerkommandos ''email'' wird hier angegeben, dass es sich nicht nur um ein normales Textfeld, sondern um ein Eingabefeld für eine Email-Adresse handelt. Das bureaucracy-Plugin prüft beim Absenden, ob es sich beim angegebenen Wert um eine Email-Adresse handelt, und würde eine Fehlermeldung ausgeben wenn beispielsweise kein @ in der Eingabe enthalten ist.\\
An zweiter Stelle wird in der Zeile der Feldname für dieses Eingabefeld angegeben (''"E-Mail-Adresse"'').\\
An dritter Stelle ist der Standardwert für das Feld angegeben, mit dem dieses vorausgefüllt wird. Es können hier feste Werte angegeben werden, aber auch Variablen, wie in diesem Fall. ''"=@MAIL@"'' steht für die Email-Adresse des derzeit angemeldeten Nutzers. Ist der Benutzer ein Gast, also nicht angemeldet, bleibt das Feld standardmäßig leer.

In der vierten Zeile wird ein verstecktes Feld definiert. Der Nutzer sieht es nicht, aber es wird in der Email mit übermittelt. Stellen Sie sich vor, Sie hätten auf einer Wiki Seite mehrere ähnliche Formulare. Beim Empfang der Email wird Ihnen angezeigt von welcher Seite es verschickt wurde, aber Sie wüssten nicht durch welches Formular. ''hidden "Anliegen" "=Anforderung Einladungslink Telegram-Gruppe"'' ist also nur ein fest vorgegebener, nicht veränderbarer Text.

Durch die fünfte Zeile wird der Absendeknopf des Formulars erzeugt. Hier kann der Text mit dem der Knopf beschrieben wird eingegeben werden (''submit "Einladungslink für Telegram-Gruppe anfordern"'').

Das eben erzeugte Formular sieht dann so aus:

{{hilfe:plugins:optional:bureaucracy:bureaucracy_telegram-formular.png?nolink|Screenshot für ein einfaches Mail-Formular}}

Beim Empfänger würde nach dem Absenden folgende Email eintreffen:

{{hilfe:plugins:optional:bureaucracy:bureaucracy_empfangene_mail.png?nolink|Screenshot einer Email mit den übermittelten Daten}}

Dies ist alles, was zum Versenden eines einfachen Formulars nötig ist.

===== Installation des Plugins =====

Dieses Plugin ist in der Standard-Einsatzleiterwiki-Installation nicht enthalten. Eine Anleitung, wie Sie ein Plugin installieren, finden Sie auf [[hilfe:plugins:plugins_installieren|dieser Seite]].

<WRAP center round info 100%>
Für den Mail-Versand von Formulardaten durch das bureaucracy-Plugin muss das Wiki Emails verschicken können. Falls auf dem Server kein Mailserver verfügbar ist, kann stattdessen das [[hilfe:plugins:standard:smtp|smtp-Plugin]] verwendet werden, um den Mailversand zu ermöglichen.
</WRAP>

[[doku>plugin:bureaucracy|Dokumentation des bureaucracy-Plugins auf dokuwiki.org]]