Contao Community Documentation - Benutzerbeiträge [de]

Template Variablen anzeigen

2014-12-19T07:54:05Z

Samson1964:

[[Category:Dev_Snippets]]
Bei einer Fehlersuche kann es manchmal sinnvoll sein, sich sämtliche Daten eines Templates anzeigen zu lassen.
Um sich die Daten anzeigen zu lassen, wird einfach folgender Code möglichst am Anfang des entsprechenden Templates einfügen:
<source lang="php"><?php $this->showTemplateVars(); ?></source>

noch mehr Informationen:
<source lang="php">
<?php echo $this->dumpTemplateVars(); ?>
</source>

In beiden Varianten erfolgt die Ausgabe präformatiert (HTML-Tag pre).

Einzelne Spaltenwerte können wie folgt ausgegeben werden:
<source lang="php">
<?php echo $this->spaltenname; ?>
</source>

== Besonders wichtig: ==
{{Achtung|Nicht vergessen, den Code nach erfolgreicher Fehlersuche wieder aus dem Template zu entfernen!}}
Die Ausgabe gibt möglicherweise die '''Zugangsdaten zur Datenbank''' (und beim SafeModeHack '''auch FTP''') preis!

Darum auch möglichst NICHT in einem HTML-Kommentar ausgeben (wird zu leicht vergessen).
'''Generell möglichst nur auf lokalen Systemen und nicht auf öffentlich zugänglichen Servern verwenden.'''
----

Die Ausgabe von showTemplateVars kann mit FirePHP an die Firebug Console gesendet werden. Dann wird das Template Layout nicht tangiert. Mehr dazu: [[PHP_Debugging]]

Template Variablen anzeigen

2014-12-19T07:52:52Z

Samson1964: Präformatierung ist Standard

[[Category:Dev_Snippets]]
Bei einer Fehlersuche kann es manchmal sinnvoll sein, sich sämliche Daten eines Templates anzeigen zu lassen.
Um sich die Daten anzeigen zu lassen, wird einfach folgender Code möglichst am Anfang des entsprechenden Templates einfügen:
<source lang="php"><?php $this->showTemplateVars(); ?></source>

noch mehr Informationen:
<source lang="php">
<?php echo $this->dumpTemplateVars(); ?>
</source>

In beiden Varianten erfolgt die Ausgabe präformatiert (HTML-Tag pre).

Einzelne Spaltenwerte können wie folgt ausgegeben werden:
<source lang="php">
<?php echo $this->spaltenname; ?>
</source>

== Besonders wichtig: ==
{{Achtung|Nicht vergessen, den Code nach erfolgreicher Fehlersuche wieder aus dem Template zu entfernen!}}
Die Ausgabe gibt möglicherweise die '''Zugangsdaten zur Datenbank''' (und beim SafeModeHack '''auch FTP''') preis!

Darum auch möglichst NICHT in einem HTML-Kommentar ausgeben (wird zu leicht vergessen).
'''Generell möglichst nur auf lokalen Systemen und nicht auf öffentlich zugänglichen Servern verwenden.'''
----

Die Ausgabe von showTemplateVars kann mit FirePHP an die Firebug Console gesendet werden. Dann wird das Template Layout nicht tangiert. Mehr dazu: [[PHP_Debugging]]

System-Log

2014-09-04T05:54:30Z

Samson1964: /* Für Entwickler */

[[Category:Core]]
[[Category:Fehlersuche]]
[[Category:Development]]
[[en:System-Log]]
== Funktionen ==
Der System-Log ist dafür da, Aktionen, die rund um Contao geschehen, zu dokumentieren und registrieren.
Er steht auch jedem Entwickler zur Verfügung, der Logs für seine Erweiterungen schreiben möchte (siehe auch die Rubrik [[:Kategorie:Development|Für Entwickler]]).

Eingefärbt werden die Logeinträge aktuell nach den folgenden Kriterien:

* Konfiguration und Repository: blau
[[Datei:syslog-repo.png|Systemlog Repository Eintrag]]
* Cron-Jobs: grün
[[Datei:syslog-cron.png|Systemlog Cron Eintrag]]
* Fehler: rot
[[Datei:syslog-error.png|Systemlog Error Eintrag]]
* Alle anderen Kategorien: schwarz
[[Datei:syslog-normal.png|Systemlog Standard Eintrag]]

== Für Entwickler ==

Die Methode System::log() erledigt bequem die Einträge.
Da wahrscheinlich jede Klasse mindestens von System erbt, kann man Einträge wie folgt registrieren lassen:

<source lang="php">
$this->log($strText, $strFunction, $strAction);
</source>

* $strText = frei wählbarer Text
* $strFunction = Klasse Methode()
* $strAction = Kategorie

Ein Beispiel für einen Cronjob-Eintrag wäre also zum Beispiel:

<source lang="php">
$this->log('Running daily cron jobs', 'CronJobs run()', TL_CRON);
</source>

Die zur Verfügung stehenden Kategorien findet man übrigens in der system/constants.php (Contao 3: system/config/constants.php).
Aktuell gibt es die folgenden:

* TL_ERROR
* TL_ACCESS
* TL_GENERAL
* TL_FILES
* TL_CRON
* TL_FORMS
* TL_CONFIGURATION
* TL_NEWSLETTER
* TL_REPOSITORY

Datenbank Klasse verwenden

2014-08-07T11:32:33Z

Samson1964: Beispeil einer Ausgabe nach Lesezugriff

{{stub}}

= Informationen zur Datenbank-Klasse =

Contao bietet für Entwickler eine Klasse an, um mit der Datenbank zu kommunizieren. Diese sollte beim Entwickeln von Erweiterungen unbedingt verwendet werden!

* [http://api.contao.org/Library/_libraries---Database.php.html Dokumentation der Klasse]

Die Datenbank-Klasse bietet mehrere Vorteile:
* Die Daten werden "gesäubert" und störende Zeichen maskiert
* Ein Objekt der Klasse Database_Result wird zurückgegeben. Dieses enthält alle Informationen zum Query
* Ersparnis von Schreibarbeit

= Operationen auf der Datenbank =

Die Beispiele setzen voraus, dass zuvor das Datenbank-Modul geladen wurde:

<source lang="php">
$this->import('Database');
</source>

== Datensätze lesen ==

'''Lesen von Datensätzen ohne Bedingung'''

<source lang="php">
$result = $this->Database->prepare("SELECT * FROM tl_log")->execute();
</source>

'''Ausgeben der Datensätze'''

<source lang="php">
echo $result->numRows; // Anzahl der gefundenen Datensätze ausgeben
echo $result->id; // ID des 1. Datensatzes ausgeben
// Und alle anderen ID's ausgeben
while($result->next())
{
echo $result->id;
}
</source>

'''Lesen von Datensätzen mit Bedingung'''

<source lang="php">
$result = $this->Database->prepare("SELECT * FROM tl_log WHERE id=?")->execute(1);
$result = $this->Database->prepare("SELECT * FROM tl_log WHERE id=? OR id=?")->execute(1, 5);
</source>

Die Fragezeichen sind Wildcards. Sie werden der Reihenfolge nach von den Parametern der execute-Funktion ersetzt. Dabei werden die parameter escaped, also für die Datenbank aufbereitet.
Das schützt allerdings '''nicht''' vor boshaften Benutzereingaben. Diese sollten immer mit der Input-Klasse verarbeitet werden!

== Datensätze schreiben ==

Datensätze können auch über die Datenbank-Klasse geschrieben werden. Es gibt dafür zwei Möglichkeiten.

'''Einzelne Werte per Wildcard setzten'''

<source lng="php">
$this->Database->prepare("UPDATE tl_log SET source = ? WHERE id=?")->execute('BE', 12345);
</source>

'''Mehrere Werte per set-Methode setzten'''
<source lng="php">
$set = array('tstamp' => time(), 'source' => 'BE', 'action' => 'GENERAL');
$this->Database->prepare("UPDATE tl_log %s WHERE id=?")->set($set)->execute(12345);
</source>

Diese Methode funktioniert natürlich auch mit einem INSERT Statement.

== Das Ergebnis auswerten ==

= Tipps & Tricks =
* [[SQL Like Abfrage in doppelten Prozentzeichen]]

[[Category:Dev HOWTOS]]

2013-12-04T18:41:14Z

Samson1964: /* Die Datei 'mail_default.tpl' */ Ergänzung

{{stub}}
[[Category:Anwender_und_Redakteure]]
[[Category:Core]]

== Einen Newsletter vorbereiten ==
Das '''Newsletter-Modul''' ist Teil der Core-Distribution und bietet eine integrierte Newsletterfunktion mit [[w:de:Double_Opt-in#Double_Opt-in|Double-Opt In]]-Newsletterverwaltung.

Newsletter können in den Formaten Text und HTML erstellt und versendet werden.

Der Import von Empfängerlisten ist aus einer [[w:de:CSV_(Dateiformat)|CSV-Datei]] heraus möglich.

Versendete Newsletter können innerhalb der Webseite aufgelistet und angezeigt werden.

Es besteht die Möglichkeit, einen Newsletter für Mitglieder zu personalisieren.

=== Einen neuen Newsletter anlegen ===
Beim ersten Aufruf ist das Newsletter-Modul weitgehend leer. Ein neuer Newsletter wird angelegt, indem man auf das Icon 'neuer Verteiler anlegen klickt:

[[Datei:Mod_newsletter_be_uebersicht_newsletter_0.jpg|Newsletter Übersicht]]

Im darauf folgenden Fenster werden die Grunddaten des neuen Newsletters eingegeben:
* Der Titel des Newsletters;
* Die Weiterleitungsseite, die später dafür benutzt wird, um ein Lesen des Newsletters im Browser zu ermöglichen;
* eventuell notwendige Einstellungen, um den Newsletter nicht über die Contao-eigene Mailfunktion sondern über einen (externen) Mailserver zu versenden.

[[Datei:Mod_newsletter_be_neuernewsletter.jpg|Newsletter erstellen]]

Nach Bestätigung der Angaben mit ''Speichern und Schließen'' gelang man erneut in die Newsletter-Übersicht.

=== Ein Newsletter-Template einbinden ===

==== Die Datei 'mail_default.tpl' (Contao 2.x) / 'mail_default.html5' (Contao 3.x) ====

Diese Datei bildet die Basis einer HTML-Newsletter-Mail. Legen Sie unter Layout -> Templates eine Kopie dieser Datei '''direkt im Verzeichnis templates''' an und bearbeiten Sie diese anschließend. Den Prefix mail_ müssen Sie beibehalten.

<source lang="html4strict">
<!DOCTYPE html PUBLIC \"-//W3C//DTD HTML 3.2//EN\"> 
<html> 
<head> 
<meta http-equiv="Content-Type" content="text/html; charset=<?php echo $this->charset; ?>"> 
<meta name="Generator" content="TYPOlight Open Source CMS"> 
<title><?php echo $this->title; ?></title> 
<?php echo $this->css; ?> 
</head> 
<body> 
<?php echo $this->body; ?> 
</body> 
</html> 
</source>

Der Text des Newsletters wird mit der Anweisung
<source lang="php">
<?php echo $this->body; ?>
</source>
vom Template ausgegeben. Für Header, CSS-Stylesheets und den Titel des Newsletters ist das Template zuständig.

==== Tabellenbasiertes Newsletter-Theme ====
Angesichts der Vielfalt an Mailclients ist es kaum möglich, einen Newsletter mit modernen CSS-Methoden zu formatieren. Insbesondere werden Floats und verschiedene Positionierungsmethoden bis heute nur sehr unzureichend unterstützt.

Für das Layout eines Newsletters ist es daher günstiger, auf das (eigentlich verpönte) Tabellenlayout auszuweichen. Nur so kann eine zum größten Teil konsistente Darstellung der Newsletter-Mail in unterschiedlichen Mailclients erreicht werden.

Eine Übersicht über die von Mailclients unterstützen CSS-Eigenschaften ist beispielsweise unter http://www.campaignmonitor.com/css zu finden.

Da nahezu jeder Mailclient dabei eigene Ansichten vertritt ist es eine gute Idee, nicht der Layouttabelle selbst sondern jeder einzelnen Zelle eine Größe zuzuweisen. Da manche Mailclients auch Prozentangaben nicht auswerten sind Pixelwerte zu bevorzugen:

<source lang="html4strict">
<table cellspacing="0" cellpadding="10" border="0">
<tr>
<td width="80"></td>
<td width="280"></td>
</tr>
</table>
</source>

Die Breite eines Mailtemplates sollte 600 Pixel nicht überschreiten. Auch wenn einige Mailclients auf Mobilgeräten einen geringeren Viewport bieten (beim iPhone und Palm Pre ab 320 Pixel über den Blackberry mit zur Zeit 360 Pixeln bis zu Android-Geräten mit 480 Px) sollten Mails auch auf diesen Geräten korrekt skaliert angezeigt werden.

==== CSS für einen Newsletter einbinden ====

Das Contao-Framework sorgt dafür, dass eine vorhandene CSS-Datei mit dem Namen 'newsletter.css' automatisch dem Newsletter im Kopfbereich hinzugefügt wird. In dieser Datei vorhandene CSS-Definitionen werden als Inline-CSS im Newsletter ausgegeben.

Dies ist notwendig, da Mailclients in der Regel keine externen Stylesheets unterstützen.

Eine Liste der CSS-Anweisungen im Hinblick auf unterschiedliche Mailclients findet sich unter [http://www.campaignmonitor.com/css http://www.campaignmonitor.com/css]

=== Personalisierung des Newsletters ===

==== Verteiler importieren ====

==== Personalisierte Felder hinzufügen ====

Das Newsletter-Modul benutzt die Benutzerverwaltung und generiert aus einer definierten Benutzerguppe heraus die Liste der zu versendenden Mails.

Grundsätzlich ist es daher möglich, die in der Benutzerverwaltung hinterlegten Daten zur Personalisierung von Newslettern zu verwenden. Dazu werden die gewünschten Spalten der Tabelle tl_member innerhalb des Newslettertextes nach folgendem Muster eingesetzt:

<source lang="text">
Sehr geehrte/r ##firstname## ##lastname##
</source>

Das Ergebnis sieht im versendeten Newsletter dann so aus:

<source lang="text">
Sehr geehrte/r Angelika Mustermann
</source>

{{Hinweis|Die personalisierten Felder werden bei einem Testversand nicht durch Inhalte ersetzt, sondern erst beim endgültigen Mailversand.}}

=== Anzeige im Browser einrichten ===

== Einen Newsletter versenden ==

=== Verteiler auswählen ===

=== Testsendung ===

=== Newsletter senden ===

== Einen Newsletter verwalten ==

Survey ce

2013-07-25T16:25:11Z

Samson1964: /* surveyFinished */ Fehler korrigiert

[[Kategorie:Extensions]]

Umfragewerkzeug zum Erstellen und Durchführen von Umfragen.

{{ExtInfo
| Dev=Helmut Schottmüller ([[User:hschottm|hschottm]])
| DevSite=http://www.aurealis.de
| ExtVersion=1.1.0
| Version=2.9.0 - 2.9.1
| TLVersion=2.7.1 - 2.8.4
| ERLink=http://www.contao.org/erweiterungsliste/view/survey_ce.de.html
| DonateLink=http://aurealis.de/spenden.html
}}

== Survey (Community Edition) - Umfragewerkzeug ==

survey_ce ist eine Anwendung, um mit Contao Umfragen zu erstellen und durchzuführen. Nutzen Sie Ihre Contao-Erfahrung, um

* unkompliziert und schnell Online-Fragebögen zu erstellen
* Umfragen selbst kostengünstig und online durchzuführen, ohne weitere anfallende Kosten
* auf Umfrageergebnisse zuzugreifen und diese mit Microsoft Excel weiterzuverarbeiten

=== Erstellung von Umfragen ===

Um eine neue Umfrage zu erstellen, wählt man den Punkt '''Umfragen''' in der Liste der Backend-Module im Contao-Backend aus.

[[Datei:umfrage_backend_module.png |Umfrage-Elemente in der Liste der Backend-Module|center|frame]]

Im Umfragebereich des Hauptfensters kann man nun über die Anweisung '''Neue Umfrage''' eine Umfrage als Container für Ihren Fragebogen erstellen. Der Fragebogen wird natürlich erst dann als Umfrage online gestellt, wenn man die Umfrage in der Contao-Frontend integriert, dazu aber später mehr.
==== Elemente einer Umfrage ====

===== Titel und Beschreibung =====

In der Sektion Titel und Beschreibung gibt man den '''Titel''' der Umfrage an, wählt den '''Autor''' der Umfrage aus der Liste der Backend-Benutzer aus und gibt optional eine detaillierte '''Beschreibung''' der Umfrage und eine '''Sprache''' für die Umfrage an. Wenn man eine Sprache angibt, wird Contao alle vom Umfragewerkzeug erstellten Zeichenketten immer in der ausgewählten Sprache ausgeben (sofern eine Übersetzung für diese Sprache vorhanden ist), selbst wenn vom Frontend-Benutzer eine andere Sprache verwendet wird.

[[Datei:umfrage_titel_beschreibung.png |Titel und Beschreibung einer Umfrage|center|frame]]

===== Aktivierung =====

In der Sektion Aktivierung legt man einen Aktivierungszeitraum für die Umfrage fest. Wenn man die Felder '''Aktiviert ab''' und '''Aktiviert bis''' leer lässt, steht die Umfrage, wenn sie in eine Seite des Frontends eingebunden ist, sofort zur Verfügung. In '''Aktiviert ab''' kann man ein Datum eingeben, ab dem die Umfrage aktiviert werden soll. Vor Erreichen dieses Datums wird das Inhaltselement der Umfrage nicht auf dem Bildschirm ausgegeben. In '''Aktiviert bis''' kann man ein Datum eingeben, bis zu dem die Umfrage aktiviert bleiben soll. Sobald dieses Datum verstrichen ist, wird das Inhaltselement der Umfrage nicht mehr auf dem Bildschirm ausgegeben.

[[Datei:umfrage_aktivierung.png |Aktivierung einer Umfrage|center|frame]]

===== Zugriff =====

Bei einer Umfrage hat man generell die Wahl zwischen drei unterschiedlichen Zugriffsverfahren:

* Anonymisierte Umfrage
* Anonymisierte Umfrage mit TAN
* personalisierte Umfrage

Den Status einer bereits begonnenen Umfrage kann man über das Kontrollkästchen '''Teilnehmer wiedererkennen''' in einem Browser-Cookie auf dem System der Teilnehmer ablegen, sofern diese die Speicherung eines Cookie zulassen.

====== Anonymisierte Umfrage ======

Eine anonymisierte Umfrage steht prinzipiell jedem zur Verfügung. Allerdings kann dort auch nicht festgestellt werden, ob ein Teilnehmer eine Umfrage bereits durchgeführt hat oder nicht. Eine solche Umfrage sollte also nicht verwendet werden, um einen repräsentativen Datensatz zu erhalten. Die Teilnehmerdatensätze können bei der Auswertung nicht mehr zu den eigentlichen Teilnehmern zugeordnet werden. Alle persönlichen Daten sind anonymisiert.

[[Datei:umfrage_anonymisiert.png |Einstellungen für eine anonymisierte Umfrage|center|frame]]

====== Anonymisierte Umfrage mit TAN ======

Eine anonymisierte Umfrage mit TAN kann nur mit einem speziellen Umfrage-Code (TAN-Code, Transaktionsnummer) durchgeführt werden. Die Teilnehmerdatensätze können bei der Auswertung nicht mehr zu den eigentlichen Teilnehmern zugeordnet werden, wohl aber zu den jeweiligen Transaktionsnummern. Alle persönlichen Daten sind anonymisiert. Durch den TAN-Code ist sichergestellt, dass die Umfrage für jede TAN nur genau ein Mal durchgeführt werden kann. Man erhält also einen repräsentativen Datensatz. Die TAN-Codes für eine Umfrage werden in einem zusätzlichen Bereich der Umfrage erstellt und verwaltet.

[[Datei:umfrage_anonymisiert_tan.png |Einstellungen für eine anonymisierte Umfrage mit TAN-Code|center|frame]]

====== Personalisierte Umfrage ======

Eine personalisierte Umfrage ist nur für angemeldeten Benutzern des Contao-Frontends durchführbar. Die Teilnehmerdatensätze können in der Auswertung jederzeit mit dem Namen des Teilnehmers in Verbindung gebracht werden. Durch die Anmeldung im Frontend ist sichergestellt, dass die Umfrage für jedes Mitglied nur genau ein Mal durchgeführt werden kann. Man erhält also einen repräsentativen Datensatz. Über das Kontrollkästchen '''Limitieren auf Mitgliedergruppen''' kann man den Zugriff auf die Umfrage weiter einschränken, indem man die Umfrage nur für ausgewählte Mitgliedergruppen durchführbar macht. Hierfür muss man die gewünschten Mitgliedergruppen in der Liste '''Mitgliedergruppen''' auswählen.

[[Datei:umfrage_personalisiert.png |Einstellungen für eine personalisierte Umfrage|center|frame]]

{{msgImportant|Wenn eine Umfrage verwendet wurde, d.h. wenn Teilnehmerdatensätze existieren, wird aus Sicherheitsgründen die Bearbeitung des Zugriffs deaktiviert, damit das Zugriffsverfahren für alle Teilnehmer gleich ist. Um die Bearbeitung wieder zu ermöglichen, müssen die Teilnehmerdatensätze gelöscht werden.}}

===== Einleitende und abschließende Bemerkung =====

Im Textfeld '''Einleitender Text''' kann man eine Einleitung erstellen, die vor dem Start der Umfrage im Inhaltselement der Umfrage angezeigt wird. Im Textfeld '''Abschließender Text ''' kann man einen abschließenden Text verfassen, der den Teilnehmern nach Beenden der Umfrage angezeigt wird.

[[Datei:umfrage_intro_outro.png |Einleitende und abschließende Bemerkung einer Umfrage|center|frame]]

===== Einstellungen für die Kopfzeile =====

Mit dem Kontrollkästchen '''Umfragetitel anzeigen''' wird der Titel der Umfrage während der gesamten Ausgabe der Umfrage in einer Kopfzeile über der Umfrage ausgegeben. Das Kontrollkästchen '''Diese Umfrage beenden''' erzeugt während der Ausgabe der Umfrage ein Kommando '''Diese Umfrage beenden''' in der Kopfzeile der Umfrage. Durch Anklicken dieses Kommandos können Teilnehmer die Umfrage jederzeit unterbrechen.

[[Datei:umfrage_head_settings.png |Einstellungen für die Kopfzeile: Umfragetitel, "Diese Umfrage beenden"|center|frame]]

===== Allgemeine Einstellungen =====

* '''Zurückgehen erlauben''': Hier legt man fest, ob den Teilnehmern die Möglichkeit gegeben werden soll, während der Umfrage eine Seite zurück zu navigieren. Dies ist natürlich nur möglich, wenn die Umfrage aus mehreren Seiten besteht.
* '''Weiterleitung zu Seite''': Wenn man hier eine Seite der Contao-Installation auswählt, werden die Teilnehmer nach dem Abschließen der Umfrage auf die ausgewählte Seite weitergeleitet. Der abschließende Text entfällt damit, auch wenn er weiter oben definiert wurde.

[[Datei:umfrage_allgemeine_einstellungen.png |Allgemeine Einstellungen einer Umfrage|center|frame]]

==== Verwenden mehrerer Seiten in einer Umfrage ====

Die Strukturierung des Fragebogens ist freigestellt. Die survey_ce-Umfragen arbeiten mit einem Seitenprinzip, das es ermöglicht, mehrere Bildschirmseiten für die Umfrage zu verwenden. Sollte man die Umfrage nur auf einer einzigen Seite durchführen wollen, so muss man auch nur eine Seite anlegen. Anderenfalls legt man so viele Seiten an, wie man für die Umfrage benötigt.

Im Bearbeitungsmodus einer Umfrage fügt man eine neue Seite zur Umfrage hinzu, indem man den Befehl '''Neue Seite''' auswählt und die notwendigen Felder für die Erstellung einer neuen Seite ausfüllt.

[[Datei:umfrage_neue_seite.png |Erstellen einer neuen Seite in einer Umfrage|center|frame]]

===== Erstellen einer neuen Seite für eine Umfrage =====

Man füllt in der Sektion Titel und Beschreibung das Feld '''Titel''' aus, um eine neue Seite für Ihre Umfrage zu erstellen. Der Titel wird während der Umfrage im Kopf der Seite angezeigt. Optional kann man auch noch eine '''Beschreibung''' für diese Seite angeben.

[[Datei:umfrage_neue_seite_titel.png |Titel und Beschreibung einer neuen Seite|center|frame]]

In der Sektion Einleitender Text kann man im gleichnamigen Feld eine Einleitung eingeben, die unter dem Seitentitel während der Umfrage angezeigt wird.

[[Datei:umfrage_neue_seite_einleitung.png |Einleitender Text einer neuen Seite|center|frame]]

In der Sektion Seitentemplate hat man die Möglichkeit eine Vorlagendatei für die Ausgabe der Fragen auf der Seite auszuwählen.

[[Datei:umfrage_seite_template.png |Auswahl eines Seitentemplates für die Darstellung der Fragen auf einer Umfrage-Seite|center|frame]]

Man schliesst das Anlegen der neuen Seite mit '''Speichern und Bearbeiten''' ab, um nun endlich zum Anlegen der Fragen für die Umfrage zu kommen.

{{msgImportant|Wenn eine Umfrage verwendet wurde, d.h. wenn Teilnehmerdatensätze existieren, wird aus Sicherheitsgründen die Erstellung und Bearbeitung der Seiten und die Erstellung und Bearbeitung von Fragen für diese Umfrage deaktiviert, damit die Umfrage nicht verändert werden kann. Um die Bearbeitung wieder zu ermöglichen, müssen die Teilnehmerdatensätze gelöscht werden.}}

==== Erstellen von Fragen ====

Man legt eine neue Frage an, indem man im Seiteneditor den Befehl '''Neue Frage''' auswählt.

[[Datei:umfrage_neue_frage.png |Erstellen einer neuen Frage im Seiteneditor|center|frame]]

Für die Umfrage stehen die folgenden Fragentypen zur Verfügung:

{|border="1" cellpadding="5" cellspacing="0"
! Fragentyp
! Untertyp
! Beschreibung
|-
| Offene Frage
| Einzeilig
| Einzeiliges Textfeld für beliebige Texteingaben
|-
| Offene Frage
| Mehrzeilig
| Mehrzeiliges Textfeld für beliebige Texteingaben
|-
| Offene Frage
| Ganzzahl
| Einzeiliges Textfeld für ganze Zahlen
|-
| Offene Frage
| Kommazahl
| Einzeiliges Textfeld für Kommazahlen
|-
| Offene Frage
| Datum
| Einzeiliges Textfeld für Datumsangaben
|-
| Offene Frage
| Uhrzeit
| Einzeiliges Textfeld für Uhrzeiten
|-
| Multiple Choice Frage
| Einfachauswahl
| Multiple Choice Fragen mit Einfachauswahl (eine Auswahlmöglichkeit)
|-
| Multiple Choice Frage
| Mehrfachauswahl
| Multiple Choice Fragen mit Mehrfachauswahl (mehrere Auswahlmöglichkeiten)
|-
| Multiple Choice Frage
| Dichotom (Ja/Nein)
| Sonderfall der Multiple Choice Frage mit Einfachauswahl und den Antwortmöglichkeiten Ja und Nein
|-
| Matrixfrage
| Einfachauswahl
| Matrixfrage (mehrere Fragen und Antwortmöglichkeiten in Tabellenform). Eine Auswahl pro Zeile
|-
| Matrixfrage
| Mehrfachauswahl
| Matrixfrage (mehrere Fragen und Antwortmöglichkeiten in Tabellenform). Mehrere Auswahlmöglichkeiten pro Zeile
|-
| Feste Summe
|
| Textfrage mit mehreren Einzelzeilen zum Erfassen von Werten, die einen bestimmten Gesamtwert erreichen müssen oder nicht überschreiten dürfen
|}

===== Gemeinsamkeiten aller Fragentypen =====

Allen Fragen gemeinsam sind die Sektionen '''Titel und Fragentyp''', '''Fragentext''' und '''Pflichteingabe'''.

* '''Titel''' definiert den Fragentitel der als Überschrift über jeder Frage in der Umfrage erscheint.
* Den '''Autor''' der Frage wählt man aus der Auswahlliste der verfügbaren Backend-Benutzer aus.
* Über '''Untertyp''' kann man bei den meisten Fragentypen die verfügbaren Untertypen auswählen.
* Das Feld '''Beschreibung''' kann eine ausführliche Beschreibung der Frage beinhalten. Da es durchsucht werden kann, ist es geeignet z.B. Metainformationen aufzunehmen, die nicht durch die angebotenen Felder abgedeckt werden.
* Mit dem Feld '''Fragentitel ausblenden''' kann der verpflichtende Fragentitel in der Umfrage ausgeblendet werden.
* '''Hilfetext''' zeigt den eingegebenen Text als zusätzliche Erläuterung zur Frage unter dem Fragentitel an. Dies kann bei etwas komplizierteren Fragestellungen als Hilfe genutzt werden.
* Über das Auswahlfeld '''Sprache''' legt man die Sprache der Frage fest.

[[Datei:umfrage_offen_titel.png |Titel und Fragentyp einer Frage|center|frame]]

In das Feld '''Fragentext''' trägt man den ausführlichen Fragentext ein, der den Teilnehmern die Fragenstellung verdeutlichen soll. Bei intuitiven Fragestellungen kann man dieses Feld natürlich auch leer lassen. Der Fragentext wird unterhalb des Fragentitels und über den angebotenen Antwortfeldern angezeigt.

[[Datei:umfrage_offen_fragentext.png |Fragentext einer Frage|center|frame]]

Wenn man eine offene Frage zur Pflichteingabe macht, muss das Textfeld vom Teilnehmer ausgefüllt werden. Pflichtfragen werden mit einem kleinen Sternchen neben dem Fragentitel als Pflichtfragen gekennzeichnet, um die Frage als Pflichtfrage visuell zu kennzeichnen.

[[Datei:umfrage_offen_pflicht.png |Festlegung einer Frage als Pflichtfrage|center|frame]]

===== Offene Fragen =====

Bei offenen Fragen können die Teilnehmer frei ihre Antwort, Einstellung oder Überzeugung formulieren und werden nicht durch vorgegebene Antwortmöglichkeiten in ein Raster gezwungen. survey_ce unterscheidet zwischen verschiedenen Untertypen von offenen Fragen.

====== Untertyp: Einzeilig ======

Eine einzeilige offene Frage besteht aus einem einzeiligen Eingabefeld, in das die Teilnehmer ihre Antwort eintragen. Über die Felder '''Beschriftung vor Textfeld''' und '''Beschriftung nach Textfeld''' kann man auf Höhe des Eingabefeldes noch einen Text vor dem Eingabefeld (z.B. für eine kurze Beschriftung) bzw. einen Text nach dem Eingabefeld (z.B. für eine Einheit, Mengenangabe etc.) eintragen.

In das Feld '''Vorbelegung''' kann man einen Text eintragen, der beim ersten Aufrufen der Frage in dem Textfeld angezeigt wird. Mittels '''Breite''' und '''maximale Länge''' kann man die Breite des Eingabefeldes in Zeichen bzw. die maximale Anzahl von Zeichen, die das Eingabefeld zulassen soll steuern.

[[Datei:umfrage_offen_einzeilig.png |Fragenspezifische Einstellungen einer einzeiligen offenen Frage|center|frame]]

====== Untertyp: Mehrzeilig ======

Eine mehrzeilige offene Frage besteht aus einem mehrzeiligen Eingabefeld, einer sogenannten Textarea (= Textbereich), in das die Teilnehmer ihre Antwort eintragen. Im Unterschied zum einzeiligen Eingabefeld kann man hier statt der Breite des Eingabefeldes in Zeichen die Anzahl der '''Zeilen''' und '''Spalten''' des Eingabefeldes festlegen.

[[Datei:umfrage_offen_mehrzeilig.png | Fragenspezifische Einstellungen einer mehrzeiligen offenen Frage|center|frame]]

====== Untertyp: Ganzzahl ======

Ganzzahl ist eine offene Frage, die aus einem einzeiligen Eingabefeld besteht, in das die Teilnehmer eine ganzzahlige Antwort eintragen müssen.
Zusätzlich zu den Einstellungen für ein normales einzeiliges Eingabefeld kann man über die Felder '''Wertebereich von''' und '''Wertebereich bis''' den Eingabebereich der Teilnehmer eingrenzen.

Das Ganzzahl-Eingabefeld wird natürlich auf die Eingabe von ganzen Zahlen überprüft.

[[Datei:umfrage_offen_ganzzahl.png |Fragenspezifische Einstellungen einer ganzzahligen, einzeiligen offenen Frage|center|frame]]

====== Untertyp: Kommazahl ======

Kommazahl ist eine offene Frage, die aus einem einzeiligen Eingabefeld besteht, in das die Teilnehmer eine Fließkommazahl als Antwort eintragen müssen. Die Einstellungen sind identisch zum Ganzzahl-Eingabefeld.

Das Kommazahl-Eingabefeld wird natürlich auf die Eingabe von Fließkommazahlen überprüft.

[[Datei:umfrage_offen_kommazahl.png |Fragenspezifische Einstellungen einer einzeiligen offenen Frage mit einer Fließkommazahl|center|frame]]

====== Untertyp: Datum ======

Datum ist eine offene Frage, die aus einem einzeiligen Eingabefeld besteht, in das die Teilnehmer ein Datum eintragen müssen. Zusätzlich zu den Einstellungen für ein normales einzeiliges Eingabefeld kann man über die Felder '''Wertebereich von''' und '''Wertebereich bis''' den Eingabebereich der Teilnehmer auf bestimmte Daten eingrenzen.

Das Datum-Eingabefeld wird natürlich auf die Eingabe eines gültigen Datums überprüft.

[[Datei:umfrage_offen_datum.png |Fragenspezifische Einstellungen einer einzeiligen offenen Frage mit einem Datum|center|frame]]

====== Untertyp: Uhrzeit ======

Datum ist eine offene Frage, die aus einem einzeiligen Eingabefeld besteht, in das die Teilnehmer eine Uhrzeit eintragen müssen. Zusätzlich zu den Einstellungen für ein normales einzeiliges Eingabefeld kann man über die Felder '''Wertebereich von''' und '''Wertebereich bis''' den Eingabebereich der Teilnehmer auf bestimmte Uhrzeiten eingrenzen.

Das Uhrzeit-Eingabefeld wird natürlich auf die Eingabe einer gültigen Uhrzeit überprüft.

[[Datei:umfrage_offen_uhrzeit.png |Fragenspezifische Einstellungen einer einzeiligen offenen Frage mit einer Uhrzeit|center|frame]]

===== Multiple Choice Fragen =====

Bei Multiple Choice Fragen handelt es sich um Fragen mit vorgegebenen Antworten, aus denen die Teilnehmer eine oder mehrere Antworten auswählen sollen. survey_ce unterscheidet zwischen verschiedenen Untertypen von Multiple Choice Fragen.

====== Untertyp: Einfachauswahl ======

Bei Multiple Choice Fragen mit Einfachauswahl sollen die Teilnehmer aus den vorgegebenen Antworten nur genau eine auswählen. Über den '''Antworten''' Eingabeassistenten kann man eine beliebige Anzahl von Antworten vorgeben. Da sich bei Multiple Choice Fragen viele Antworten oftmals aus vorgegebenen Antwortskalen zusammensetzen, in denen häufig Informationen wie Einstellung oder Meinungen, Überzeugungen, Verhalten oder Eigenschaften abgefragt werden, bietet survey_ce die Möglichkeit, diese sogenannten Skalen aus einer Liste von vorgegebenen Skalen abzurufen, die man mit dem in survey_ce integrierten Skaleneditor erstellen kann.
Weitere Details zum Thema Skalen entnehmen Sie bitte dem Abschnitt [[Hinzufügen von vordefinierten Skalen]].

Mit dem Kontrollkästchen '''Andere Antwort erlauben''' wird den Antworten eine zusätzliche letzte Antwort in Form eines leeren Textfeldes hinzugefügt, das die Teilnehmer auswählen und beschriften können, wenn keine der vorgegebenen Antworten zutreffend ist. Man kann zusätzlich eine Beschreibung für dieses Textfeld erstellen, die vor dem Textfeld angezeigt wird, wenn man das Feld '''Titel der anderen Antwort''' ausfüllt.

Die Darstellung der Antworten kann man über das entsprechende Auswahlfeld steuern. Zur Auswahl stehen hier eine vertikale Ausrichtung, bei der die Antworten untereinander angeboten werden, eine horizontale Ausrichtung, bei der die Antworten nebeneinander angeboten werden (meist nur für wenige Antworten aus Platzgründen sinnvoll) und die Ausgabe als Dropdown-Feld, in dem immer nur eine Antwort sichtbar ist. Im Falle des Dropdown-Feldes hat die Auswahl einer anderen Antwort keine Auswirkung.

[[Datei:umfrage_mc_sr.png |Fragenspezifische Einstellungen einer Multiple Choice Frage mit Einfachauswahl|center|frame]]

====== Untertyp: Mehrfachauswahl ======

Bei Multiple Choice Fragen mit Mehrfachauswahl dürfen die Teilnehmer aus den vorgegebenen Antworten eine beliebige Anzahl auswählen. Die Einstellungen für Fragen mit Mehrfachauswahl entsprechen denen für Fragen mit Einfachauswahl. Da Fragen mit Mehrfachauswahl keine fertigen Skalen verwenden, entfällt die Option der Skalenauswahl bei diesem Untertyp.

[[Datei:umfrage_mc_mr.png |Fragenspezifische Einstellungen einer Multiple Choice Frage mit Mehrfachauswahl|center|frame]]

====== Untertyp: Dichotom (Ja/Nein) ======

Dichotome Fragen sind ein Spezialfall der Multiple Choice Frage mit Einfachauswahl. Sie verfügen über zwei feste Antwortvorgaben, nämlich Ja und Nein. Dementsprechend entfallen auch die Konfigurationsmöglichkeiten für diesen Fragentyp. Lediglich die Auswahl der Antwortdarstellung kann getroffen werden.

[[Datei:umfrage_mc_dichotom.png |Fragenspezifische Einstellungen einer dichotomen Frage|center|frame]]

===== Matrixfragen =====

Bei Matrixfragen handelt es sich um einen Spezialfall der Multiple Choice Fragen. In einer Matrixfrage werden mehrere Fragen mit gleichen Antworten / Skalen in einer Matrix, also in Zeilen und Spalten angeordnet. Dabei werden die Antworten normalerweise in Spalten angeordnet, während die Fragen in Zeilen angeordnet werden. Die Vorteile einer Matrixfrage liegen auf der Hand: Die Darstellung ist sehr effizient, es lässt sich eine hohe Datenfülle bei gleichzeitiger guter Ausnutzung des Bildschirms erreichen. Allerdings können Matrixfragen auch sehr schnell unübersichtlich werden.

Ähnlich wie die Multiple Choice Fragen lassen sich auch die Matrixfragen in Untertypen einteilen.

====== Untertyp: Einfachauswahl ======

Bei einer Matrixfrage mit Einfachauswahl müssen die Teilnehmer genau eine Antwort pro Zeile auswählen. Über den '''Zeilen''' Eingabeassistenten kann man eine beliebige Anzahl von Fragen vorgeben. Über den '''Spalten''' Eingabeassistenten kann man eine beliebige Anzahl von Antworten vorgeben.

Mit dem Kontrollkästchen '''Neutrale Spalte erlauben''' wird den Antworten eine zusätzliche Spalte angefügt, die jedoch etwas abgesetzt dargestellt wird, da sie als neutrale Spalte dazu dient, für den Fall, dass keine der vorgegebenen Antworten zutreffend ist, eine Auswahl getroffen werden kann.

Mit dem Kontrollkästchen '''Entgegengesetzte Pole anzeigen''' kann man die Wirkung einer Antwortskala noch weiter verstärken, indem man jeweils für den äußeren "Pol", also die jeweils extremste Ausprägung eine Beschreibung in den Feldern '''Linker Pol''' und '''Rechter Pol''' definiert, die dann je nach Auswahl unter '''Position der Pole''' Links und Rechts der Spalten oder aber über den Spaltenbezeichnern angezeigt werden.

[[Datei:umfrage_matrix_sr.png |Fragenspezifische Einstellungen einer Matrixfrage mit Einfachauswahl|center|frame]]

====== Untertyp: Mehrfachauswahl ======

Bei einer Matrixfrage mit Mehrfachauswahl dürfen die Teilnehmer eine beliebige Anzahl von Antworten pro Zeile auswählen. Die Einstellungen sind identisch zu den Einstellungen der Matrixfrage mit Einfachauswahl.

===== Feste Summe =====

Bei einer festen Summe dürfen die Teilnehmer eine bestimmte Anzahl von Punkten auf vorgegebene Antworten verteilen. Man kann festlegen, ob die Summe der vergebenen Punkte genau der Vorgabesumme entsprechen muss oder ob eine geringere Anzahl von Punkten verteilt werden darf. Über den '''Antworten''' Eingabeassistenten kann man eine beliebige Anzahl von Antworten vorgeben. Hinter jeder Antwort befindet sich in der Ausgabe ein Textfeld für die Eingabe der Punkte. Mit Hilfe der Option '''Eingabefelder vor den Antworten anzeigen''' kann man die Textfelder auch vor den Antworten ausgaben lassen.

In der Sektion Summenberechnung legt man die zu vergebende Gesamtpunktezahl im Feld '''Summe''' fest. Mit der '''Berechnungsoption''' legt man dann noch fest, ob die zu den Antworten eingetragenen Punktewerte exakt der Summenvorgabe entsprechen müssen, oder ob die Punktewerte auch niedriger als die Summenvorgabe sein dürfen.

[[Datei:umfrage_summe.png |Fragenspezifische Einstellungen einer Frage vom Typ Feste Summe|center|frame]]

=== Generieren und Verwalten von TAN Codes ===

Um TAN Codes für eine Umfrage zu erstellen oder zu verwalten, wählt man den Punkt '''TAN-Erzeugung''' in den Bearbeitungsoptionen der Umfrage aus.

[[Datei:umfrage_tan_gen.png |TAN-Erzeugung und Verwaltung von TAN-Listen öffnen|center|frame]]
==== Erzeugen von TAN-Codes ====

Man erzeugt neue TAN-Codes für eine Umfrage, indem man die Aktion '''TAN-Codes erzeugen''' auswählt.

[[Datei:umfrage_tan_erzeugen.png |TAN-Codes erzeugen|center|frame]]

In dem sich öffnenden Formular gibt man lediglich die Anzahl der gewünschten TAN-Codes ein und bestätigen das Formular mit erzeugen. Die neu erstellten TAN-Codes werden dann in der TAN-Liste angezeigt.

[[Datei:umfrage_tan_erzeugen_dialog.png |Dialog zum Erzeugen von TAN-Codes|center|frame]]

Die TAN-Codes in der TAN-Liste werden mit einem Status-Symbol (grün = neue, nicht verwendete TAN, orange = bereits verwendete TAN), der TAN-Nummer und dem Datum der Erstellung in der TAN-Liste angezeigt.

[[Datei:umfrage_tan_liste.png |Ausschnitt aus der TAN-Liste|center|frame]]
==== Exportieren von TAN-Codes ====

Falls man die TAN-Codes exportieren muss, weil man z.B einen Serienbrief mit einer Einladung zu einer Umfrage an eine größere Gruppe von Teilnehmern versenden will, muss man die Aktion '''TAN-Codes exportieren''' auswählen.

[[Datei:umfrage_tan_exportieren.png |TAN-Codes exportieren|center|frame]]

Im folgenden Formular hat man die Möglichkeit, die Contao-Seite auszuwählen, auf der man die Umfrage durchführen wird. Wenn man eine Seite auswählt, wird Contao zusätzlich eine URL auf die Seite der Umfrage exportieren. Diese URL enthält bereits den TAN-Code, so dass ein Teilnehmer bei Eingabe der URL bereits die Startseite der Umfrage mit ausgefüllter TAN-Eingabe erhält.

Auf jeden Fall exportiert werden die TAN-Codes und die Information, ob ein TAN-Code bereits verwendet wurde oder nicht (0 = nicht verwendet, 1 = verwendet).

Man bestätigen die Export-Einstellungen mit der Schaltfläche '''Exportieren''', wird Contao eine Excel-Datei generieren, welche die TAN-Liste enthält. Die Excel-Datei wird direkt zum Download angeboten.

[[Datei:umfrage_tan_exportieren_dialog.png |Export einer TAN-Liste für die externe Weiterverarbeitung im Excel XLS-Format|center|frame]]

=== Verwalten der Teilnehmerdaten ===

Um die Teilnehmerdaten für eine Umfrage zu verwalten, wählt man den Punkt '''Teilnehmerdaten''' in den Bearbeitungsoptionen der Umfrage aus.

[[Datei:umfrage_teilnehmer.png |Verwaltung der Teilnehmerdaten|center|frame]]

Alle Teilnehmer, die an der Umfrage teilgenommen haben oder gerade an der Umfrage teilnehmen, werden in der Teilnehmerliste angezeigt. Bei anonymen Umfragen sieht man statt des Teilnehmernamens lediglich einen Zufallscode, der zur Anonymisierung der Daten generiert werden. In Klammern hinter dem Namen findt man den Status des Teilnehmers. Die folgenden Statusmeldungen sind möglich:

* '''begonnen''': Der Teilnehmer hat die Umfrage begonnen aber noch nicht abgeschlossen
* '''beendet''': Der Teilnehmer hat die Umfrage beendet
* in Klammern die Anzahl der bearbeiteten Seiten und die Gesamtzahl der Seiten der Umfrage

[[Datei:umfrage_teilnehmerliste.png |Teilnehmerliste einer anonymen Umfrage|center|frame]]

Man kann einzelne Teilnehmer oder alle Teilnehmer löschen. In diesem Fall werden auch die Umfragedaten (Eingaben) dieser Teilnehmer aus der Datenbank gelöscht.
Mit der Option '''Detaillierter Export''' führt man einen detaillierten Export aller Teilnehmerdaten nach Microsoft Excel durch.

=== Umfrage-Statistik ===

Um die statistische Auswertung einer Umfrage zu erhalten, wählt man den Punkt '''Statistik''' in den Bearbeitungsoptionen der Umfrage aus.

[[Datei:umfrage_statistik.png |Statistik der Umfrage anzeigen|center|frame]]

In der Statistikansicht werden alle Fragen in der Reihenfolge ihres Auftretens in der Umfrage angezeigt und durchnummeriert. Neben dem Fragentitel, dem Fragentext und dem Fragentyp wird angezeigt, wie oft eine Frage beantwortet wurde und wie oft sie übersprungen wurde.

[[Datei:umfrage_statistik_liste.png |Statistikansicht mit einer Liste der Fragen und der Anzahl der beantworteten und übersprungenen Fragen|center|frame]]

Durch einen Klick auf die Details-Schaltfläche auf der rechten Seite eines jeden Eintrags gelangt man in die Statistik-Details für diese Frage.
Die Statistik-Details listen neben den Fragendaten die detaillierte kumulierte Verteilung der Antworten auf.

[[Datei:umfrage_statistik_details.png |Statistik-Details für eine Multiple Choice Frage|center|frame]]

Um die kumulierte Statistik mit allen Details mit einem externen System weiter zu verarbeiten, kann man in der Statistikansicht über den Befehl '''Umfrageergebnisse in Excel exportieren''' die Statistik der Umfrage in eine Microsoft Excel-Datei exportieren.

=== Einfügen einer Umfrage in das Frontend ===

Um eine bestehende Umfrage in das Contao Frontend einzufügen, damit sie auf Ihrer Website angezeigt wird, wechselt man im Backend in den Artikelbaum und bearbeiten den Artikel der Seite, in die man die Umfrage einbetten möchte. Man erstellt hierzu ein neues Inhaltselement und wählt den Elementtyp '''Umfrage''' aus.

Aus der Liste der verfügbaren Umfragen wählt man nun bitte die gewünschte Umfrage und speichern dann die Eingabe.

Die Umfrage ist nun bereit für die Verwendung. Herzlichen Glückwunsch!

=== Durchführen einer Umfrage ===

Wenn eine Umfrage im Frontend verfügbar ist, wird auf der Seite, in der das Inhaltselement '''Umfrage''' eingebettet ist, der einleitende Text zur Umfrage und eine Schaltfläche zum Starten der Umfrage angezeigt. Handelt es sich um eine anonymisierte Umfrage mit Zugangscodes (TAN-Codes), dann erscheint zusätzlich vor der '''Umfrage starten''' Schaltfläche noch ein Textfeld zur Eingabe eines TAN-Codes.

[[Datei:umfrage_beispiel_einleitung.png |Beispiel für die Startseite einer Umfrage mit einem einführenden Text|center|frame]]

In der Umfrage können die Teilnehmer am Ende einer Seite über die '''Weiter'''-Schaltfläche auf die nächste Seite gelangen. Wenn in den Umfrage-Einstellungen das Zurück gehen erlaubt wurde, wird zusätzlich eine Schaltfläche '''Zurück''' angeboten, um auf die vorige Seite zu gelangen.

Auf der letzten Seite kann die Umfrage mit der Schaltfläche '''Umfrage beenden''' abgeschlossen werden. In personalisierten Umfragen und Umfragen mit Zugangscode kann eine nicht beendete, abgebrochene Umfrage an der letzten bekannten Position wieder aufgenommen werden. survey_ce merkt sich die letzte Position und leitet die Teilnehmer beim erneuten Start direkt auf die letzte bekannte Seite der Umfrage weiter.
Anonymisierte Umfragen ohne Zugangscode können nach einem Abbruch nur dann wieder neu aufgesetzt werden, wenn das Wiedererkennen der Teilnehmer über einen Browser Cookie erlaubt wurde. In allen anderen Fällen werden diese Umfragen sonst wieder mit einem neuen Teilnehmerdatensatz von vorne begonnen.

Beispiele für Fragen in einer Umfrage sind z.B.

[[Datei:umfrage_beispiel_offen.png|Beispiel für eine offene Frage|center|frame]]

Beispiel für eine offene Frage

[[Datei:umfrage_beispiel_mc.png|Beispiel für Multiple Choice Fragen|center|frame]]

Beispiel für Multiple Choice Fragen

[[Datei:umfrage_beispiel_matrix.png|Beispiel für eine Matrixfrage|center|frame]]

Beispiel für eine Matrixfrage
=== Fortschrittsanzeige ===
Ab survey_ce Version 1.1.0 wird im Standard-Template der Umfrage ein Codeblock für eine Fortschrittsanzeige ausgegeben:

<source lang="html4strict">
<div class="progressbar_container">
<div class="progressbar" style="width: 20.0%">
Seite 1 von 5
</div>
</div>
</source>

Dieser Codeblock kann wahlweise für die Ausgabe der jeweiligen Seite und der Anzahl der Gesamtseiten verwendet werden oder aber, wie im mitgelieferten Beispiel-CSS decent_blue.css als Fortschrittsbalken. Dabei gibt der Style-Parameter der CSS-Klasse progressbar den Fortschritt in Prozent an.

[[Datei:survey_progress.png |Mit CSS gestaltete Fortschrittsanzeige einer Umfrage|center|frame]]

=== Hinweise für Entwickler ===

Der Aufbau des Umfragewerkzeugs survey_ce ist an den hierarchischen Aufbau der meisten Contao-Daten angelehnt. Eine Umfrage besteht aus den folgenden Komponenten:

* Umfrage ('''tl_survey''')
** Seite ('''tl_survey_page''')
*** Frage ('''tl_survey_question''')
** Umfrageteilnehmer ('''tl_survey_participant''')
** Umfrageergebnisse ('''tl_survey_result''')
** TAN-Listen ('''tl_survey_pin_tan''')
** Skalen-Ordner ('''tl_survey_scale_folder''')
*** Skalen ('''tl_survey_scale''')

Die Ausgabe einer Umfrage wird durch das Inhaltselement Umfrage (ContentSurvey.php) durchgeführt. Jeder Fragentyp ist ein eigenes Widget: 
Multiple Choice Frage = FormMultipleChoiceQuestion.php 
Offene Frage = FormOpenEndedQuestion.php 
MatrixFrage = FormMatrixQuestion.php 
Konstante Summe = FormConstanSumQuestion.php. 
Die Fragen erben alle von einem gemeinsamen Basis-Widget (FormQuestionWidget.php).

Für die Berechnung der Umfrageergebnisse und den Export gibt es für jeden Fragentyp eine eigene Dienstklasse. Damit diese Dienstklassen korrekt eingebunden werden, muss man Klassennamen besitzen, die einem festen Schema folgen: SurveyQuestion<Fragentyp>. <Fragentyp> ist dabei der Wert des Fragentyps (questiontype-Feld der tl_survey_question-Tabelle) der Frage, wobei der erste Buchstabe groß geschrieben wird und der Rest klein geschrieben wird. Für den Fragentyp Multiple Choice Frage mit dem Typ 'multiplechoice' lautet der Name der Dienstklasse dann SurveyQuestionMultiplechoice.

Mit dieser Kenntnis sollte es dann möglich sein, eigene Fragentypen zu entwickeln und zu integrieren.

==== Hooks ====

survey_ce bietet einige Hooks für Entwickler an, um ohne aufwändiges Überschreiben von bestehenden Klassen an bestimmte Umfragedaten zu gelangen. Ein Hook wird mit seinem Funktionsnamen in die zentrale Contao Hook-Struktur integriert und besteht aus einem Array mit dem Namen der Klasse der aufzurufenden Hookfunktion und dem Namen der aufzurufenden Hookfunktion:

<source lang="php"><?php $GLOBALS['TL_HOOKS']['surveyFinished'][] = array('MySurveyExtension', 'surveyFinished'); ?></source>

Verfügbare Hooks sind:

===== surveyQuestionsValidated =====
Der surveyQuestionsValidated Hook wird aufgerufen, wenn die Fragen auf einer Umfrageseite von einem Teilnehmer abgeschickt und validiert wurden. Übergeben wird ein Array mit den instanziierten, validierten Widgets und ein assoziatives Array mit den Datenbankfeldern der aktuellen Umfrageseite.

<source lang="php"><?php
// config.php
$GLOBALS['TL_HOOKS']['surveyQuestionsValidated'][] = array('MyClass', 'surveyQuestionsValidated');

// MyClass.php
public function surveyQuestionsValidated($widgets, $pagedata)
{
// Do something
}
?></source>

===== surveyQuestionsLoaded =====
Der surveyQuestionsLoaded Hook wird aufgerufen, wenn die Fragen auf einer Umfrageseite aus der Datenbank geladen und ggfs. mit Werten gefüllt wurden. Übergeben wird ein Array mit den instanziierten, validierten Widgets und ein assoziatives Array mit den Datenbankfeldern der aktuellen Umfrageseite.

<source lang="php"><?php
// config.php
$GLOBALS['TL_HOOKS']['surveyQuestionsLoaded'][] = array('MyClass', 'surveyQuestionsLoaded');

// MyClass.php
public function surveyQuestionsLoaded($widgets, $pagedata)
{
// Do something
}
?></source>

===== surveyFinished =====
Der surveyFinished Hook wird aufgerufen, wenn ein Teilnehmer eine Umfrage beendet. Übergeben wird ein assoziatives Array mit den Datenbankfeldern der Umfrage.

<source lang="php"><?php
// config.php
$GLOBALS['TL_HOOKS']['surveyFinished'][] = array('MyClass', 'surveyFinished');

// MyClass.php
public function surveyFinished($surveydata)
{
// Do something, e.g. send confirmation mail to participant etc.
}
?></source>

--[[Benutzer:Hschottm|Hschottm]] 10:30, 11. Sep. 2010 (CEST)

FEN

2013-06-15T17:39:21Z

Samson1964:

[[Datei:fen_diagramm.jpg|Diagramm mit den mitgelieferten Voreinstellungen. Der Schatten wurde später per CSS generiert.|right|400px]]
'''FEN''' ist ein Inhaltselement, um Schachdiagramme auf Grundlage der [http://de.wikipedia.org/wiki/Forsyth-Edwards-Notation '''F'''orsyth-'''E'''dwards-'''N'''otation] anzuzeigen. Die Diagramme erscheinen als komplexe Grafik, die vom [https://code.google.com/p/chessimager/ Chess Imager] generiert wird. Der Chess Imager ist im Paket enthalten.

{{AppliesTo|TLVersion=ab 3.0}}

= Einführung =

Neben der Auswahl mehrerer Figurensätze lassen sich die Farben der hellen und dunklen Felder einstellen. Optional zuschaltbar sind die Brettkoordinaten, ein äußerer Rand (Dicke und Farbe) und eine Diagrammunterschrift. Optional ist ebenfalls das Drehen des Diagramms, mit den schwarzen Steinen unten.

Die Diagramme können in zwei Größen dargestellt werden: mit 25 und 35 Pixel Feldbreite. Neben der Diagrammunterschrift kann optional ein längerer Text über, unter oder neben dem Diagramm angezeigt werden.

= Installation =

Es empfiehlt sich die Installation über den Menüpunkt '''Erweiterungskatalog''' im Bereich '''System''' im Backend von Contao vorzunehmen. 
Bei der manuellen Installation muß der im Downloadpaket enthaltene Ordner '''fen''' in das Verzeichnis ''/system/modules'' kopiert werden. Danach sollte die Datenbank aktualisiert werden, entweder über install.php oder im Backend über die '''Systemwartung'''.

= Benutzung =

[[Datei:fen_backend-inhaltselement_alles.jpg|right|400px]]

Bei der Erstellung von Artikeln gibt es im Bereich '''Schach-Elemente''' ein neues Inhaltselement '''FEN-Diagramm'''. Nach dessen Auswahl sieht das Eingabeformular etwa wie nebenstehend aus.

Im Eingabefeld für den '''FEN-Code''' ist die Angabe der Stellung ausreichend. Parameter wie Rochadestatus, Zugrecht oder En-Passant-Status werden vom Chess Imager nicht interpretiert und sind unnötig. In der Voreinstellung wird hier immer die Grundstellung angezeigt.

Experimentieren Sie ein wenig mit den Einstellungen der Farben, um die Diagrammdarstellung auf Ihre Website abzustimmen. Damit Sie oder Ihre Redakteure nicht bei jedem Diagramm ein Farbmassaker veranstalten, empfehle ich Ihnen in den Einstellungen im Systembereich eine Grundeinstellung dauerhaft vorzugeben.
<div style="clear:both"></div>

== Voreinstellungen ==

[[Datei:fen_backend-einstellungen.jpg|right|400px]]

Wenn Sie ein Farb- und Diagrammschema für die gesamte Website gültig machen wollen, dann stellen Sie dieses in den Backend-Einstellungen ein und setzen danach ein Häkchen bei ''Immer Voreinstellungen benutzen''. Eventuell andere Einstellungen in den jeweiligen Inhaltselementen werden dabei nicht überschrieben, sondern werden nur nicht beachtet. Wenn Sie das Häkchen wieder entfernen, sind die Inhaltselement-Einstellungen wieder gültig.

Mit der aktivierten Option ''Immer Voreinstellungen benutzen'' kann im Inhaltselement nur noch die Ausrichtung des Diagramms und die Drehung des Diagramms bestimmt werden. Die Optionen Figurensatz, Diagrammgröße, Randbreite, Randfarbe, Koordinatenanzeige und die Feldfarben sind nicht mehr einstellbar.

== Template ce_fen ==

Die Ausgabe des Diagramms erfolgt im Template ce_fen. Die dortigen Einstellungen sollten weitgehend aus anderen Inhaltselement-Templates bekannt sein.

[[Category:Extensions]]

Datei:Fen diagramm.jpg

2013-06-15T17:04:41Z

Samson1964:

Datei:Fen backend-inhaltselement gekuerzt.jpg

2013-06-15T17:03:55Z

Samson1964:

Datei:Fen backend-inhaltselement alles.jpg

2013-06-15T17:03:03Z

Samson1964:

Datei:Fen backend-einstellungen.jpg

2013-06-15T17:02:06Z

Samson1964:

FEN

2013-06-15T17:00:29Z

Samson1964:

'''FEN''' ist ein Inhaltselement, um Schachdiagramme auf Grundlage der [http://de.wikipedia.org/wiki/Forsyth-Edwards-Notation '''F'''orsyth-'''E'''dwards-'''N'''otation] anzuzeigen. Die Diagramme erscheinen als komplexe Grafik, die vom [https://code.google.com/p/chessimager/ Chess Imager] generiert wird. Der Chess Imager ist im Paket enthalten.

{{AppliesTo|TLVersion=ab 3.0}}

= Einführung =

Neben der Auswahl mehrerer Figurensätze lassen sich die Farben der hellen und dunklen Felder einstellen. Optional zuschaltbar sind die Brettkoordinaten, ein äußerer Rand (Dicke und Farbe) und eine Diagrammunterschrift. Optional ist ebenfalls das Drehen des Diagramms, mit den schwarzen Steinen unten.

Die Diagramme können in zwei Größen dargestellt werden: mit 25 und 35 Pixel Feldbreite. Neben der Diagrammunterschrift kann nach ein längerer Text über, unter oder neben dem Diagramm angezeigt werden.

= Installation =

...

[[Category:Extensions]]

FEN

2013-06-15T14:26:51Z

Samson1964: Die Seite wurde neu angelegt: „Category:Extensions {{AppliesTo|TLVersion=ab 3.0}} = Einführung = '''FEN''' ist eine Erweiterung, um Schachdiagramme auf Grundlage der [http://de.wikipedia…“

[[Category:Extensions]]
{{AppliesTo|TLVersion=ab 3.0}}

= Einführung =

'''FEN''' ist eine Erweiterung, um Schachdiagramme auf Grundlage der [http://de.wikipedia.org/wiki/Forsyth-Edwards-Notation '''F'''orsyth-'''E'''dwards-'''N'''otation] anzuzeigen. Die Diagramme erscheinen als komplexe Grafik, die vom [https://code.google.com/p/chessimager/ Chess Imager] generiert wird. Der Chess Imager ist im Paket enthalten.

Neben der Auswahl mehrerer Figurensätze lassen sich die Farben der hellen und dunklen Felder einstellen. Optional zuschaltbar sind die Brettkoordinaten, ein äußerer Rand (Dicke und Farbe) und eine Diagrammunterschrift.

= Installation =

...

Insert-Tags

2013-06-15T13:47:05Z

Samson1964: /* Link-Elemente */ link-Tag angepaßt

{{AppliesTo
|Version=Alle Versionen
}}
[[Category: Core]]
[[Category:Dev HOWTOS]]
[[Category:Anwender und Redakteure]]

= Insert-Tags =
Contao bietet die Möglichkeit, mittels so genannter Insert-Tags Inhalte oder Funktionen zu referenzieren.

Der Aufbau ist in der Regel <nowiki>{{Tagname::Argument}}</nowiki>.
{{Achtung|Eine Verschachtelung – also der Aufruf eines Insert-Tags innerhalb eines anderen – ist nur mit <nowiki>{{iflng::*}}</nowiki> möglich. Andere Insert-Tags können nicht verschachtelt werden.}}
{{Achtung|Werden Elemente inkludiert, die auf Javascript basieren, wird das Javascript nicht geladen. Abhilfe: [[Inserttags_Javascript_Support]]}}

== Liste der Insert-Tags ==
Die Liste stammt im Wesentlichen von [http://www.contao.org/typolight-insert-tags.html Contao.org]. Über die dort dokumentierten Insert-Tags hinaus gibt es weitere Insert-Tags. Bitte vervollständige die Liste.
=== Link-Elemente ===
{| border="0" cellspacing="1" cellpadding="2"
! '''Insert-Tag''' !! '''Beschreibung'''
|-
| <nowiki>{{link::*}}</nowiki> || Dieses Tag wird mit einem Link zu einer internen Seite oder einer externen URL ersetzt (ersetzen Sie * mit der ID oder dem Alias der Seite oder der URL).
|-
|<nowiki>{{link::back}}</nowiki> || Dieses Tag wird mit der zuletzt besuchte Seite ersetzt. Kann auch mit link_open, link_url und link_title verwendet werden.
|-
|<nowiki>{{link::login}}</nowiki> || Dieses Tag wird mit einem Link zur Anmeldeseite des aktuellen Frontend-Benutzers (falls vorhanden) ersetzt.
|-
|<nowiki>{{link_open::*}}</nowiki> || Wird mit dem öffnenden Tag eines Links zu einer internen Seite ersetzt: <nowiki>{{link_open::12}}</nowiki>Click here<nowiki>{{link_close}}</nowiki>.
|-
|<nowiki>{{link_url::*}}</nowiki> || Dieses Tag wird mit der URL einer internen Seite ersetzt: <nowiki><a href="{{link_url::12}}">Click here</a>.</nowiki>
|-
|<nowiki>{{link_title::*}}</nowiki> || Dieses Tag wird mit dem Titel einer internen Seite ersetzt: <nowiki><a title="{{link_title::12}}">Click here</a></nowiki>.
|-
|<nowiki>{{article::*}}</nowiki> || Dieses Tag wird mit einem Link zu einem Artikel ersetzt (ersetzen Sie * mit der ID oder dem Alias).
|-
|<nowiki>{{article_open::*}}</nowiki> || Wird mit dem öffnenden Tag eines Links zu einem Artikel ersetzt: <nowiki>{{article_open::12}}Click here{{link_close}}.</nowiki>
|-
|<nowiki>{{article_url::*}}</nowiki> || Dieses Tag wird mit der URL eines Artikels ersetzt: <nowiki><a href="{{article_url::12}}">Click here</a></nowiki>.
|-
|<nowiki>{{article_title::*}}</nowiki> || Dieses Tag wird mit dem Titel eines Artikels ersetzt: <nowiki><a title="{{article_title::12}}">Click here</a></nowiki>.
|-
|<nowiki>{{news::*}}</nowiki> || Dieses Tag wird mit einem Link zu einer Nachricht ersetzt (ersetzen Sie * mit der ID oder dem Alias).
|-
|<nowiki>{{news_open::*}}</nowiki> || Wird mit dem öffnenden Tag eines Links zu einer Nachricht ersetzt: <nowiki>{{news_open::12}}Click here{{link_close}}</nowiki>.
|-
|<nowiki>{{news_url::*}}</nowiki> || Dieses Tag wird mit der URL einer Nachricht ersetzt: <nowiki><a href="{{news_url::12}}">Click here</a></nowiki>.
|-
|<nowiki>{{news_title::*}}</nowiki> || Dieses Tag wird mit dem Titel einer Nachricht ersetzt: <nowiki><a title="{{news_title::12}}">Click here</a></nowiki>.
|-
|<nowiki>{{event::*}}</nowiki> || Dieses Tag wird mit einem Link zu einem Event ersetzt (ersetzen Sie * mit der ID oder dem Alias).
|-
|<nowiki>{{event_open::*}}</nowiki> || Wird mit dem öffnenden Tag eines Links zu einem Event ersetzt: <nowiki>{{event_open::12}}Click here{{link_close}}</nowiki>.
|-
|<nowiki>{{event_url::*}}</nowiki> || Dieses Tag wird mit der URL eines Events ersetzt: <nowiki><a href="{{event_url::12}}">Click here</a></nowiki>.
|-
|<nowiki>{{event_title::*}}</nowiki> || Dieses Tag wird mit dem Titel eines Events ersetzt: <nowiki><a title="{{event_title::12}}">Click here</a></nowiki>.
|-
|<nowiki>{{faq::*}}</nowiki> || Dieses Tag wird mit einem Link zu einer häufig gestellten Frage ersetzt (ersetzen Sie * mit der ID oder dem Alias).
|-
|<nowiki>{{faq_open::*}}</nowiki> || Wird mit dem öffnenden Tag eines Links zu einer Frage ersetzt: <nowiki>{{faq_open::12}}Click here{{link_close}}</nowiki>.
|-
|<nowiki>{{faq_url::*}}</nowiki> || Dieses Tag wird mit der URL einer Frage ersetzt: <nowiki><a href="{{faq_url::12}}">Click here</a></nowiki>.
|-
|<nowiki>{{faq_title::*}}</nowiki> || Dieses Tag wird mit dem Titel einer Frage ersetzt: <nowiki><a title="{{faq_title::12}}">Click here</a>.</nowiki>
|-
| colspan="2" |
|}

=== Benutzereigenschaften ===

Mit den folgenden Inserttags können Eigenschaften des angemeldeten Benutzers ausgebeben werden.

{| border="0" cellspacing="1" cellpadding="2"
! '''Insert-Tag''' !! '''Beschreibung'''
|-
| <nowiki>{{user::firstname}}</nowiki> ||Dieses Tag wird mit dem Vornamen des angemeldeten Benutzers ersetzt.
|-
| <nowiki>{{user::lastname}}</nowiki> || Dieses Tag wird mit dem Nachnamen des angemeldeten Benutzers ersetzt.
|-
| <nowiki>{{user::company}}</nowiki> || Dieses Tag wird mit dem Firmennamen des angemeldeten Benutzers ersetzt.
|-
| <nowiki>{{user::phone}}</nowiki> || Dieses Tag wird mit der Telefonnummer des angemeldeten Benutzers ersetzt.
|-
| <nowiki>{{user::mobile}}</nowiki> || Dieses Tag wird mit der Handynummer des angemeldeten Benutzers ersetzt.
|-
| <nowiki>{{user::fax}}</nowiki> || Dieses Tag wird mit der Faxnummer des angemeldeten Benutzers ersetzt.
|-
| <nowiki>{{user::email}}</nowiki> || Dieses Tag wird mit der E-Mail-Adresse des angemeldeten Benutzers ersetzt.
|-
| <nowiki>{{user::website}}</nowiki> || Dieses Tag wird mit der Internetadresse des angemeldeten Benutzers ersetzt.
|-
| <nowiki>{{user::street}}</nowiki> || Dieses Tag wird mit dem Staßennamen des angemeldeten Benutzers ersetzt.
|-
| <nowiki>{{user::postal}}</nowiki> || Dieses Tag wird mit der Postleitzahl des angemeldeten Benutzers ersetzt.
|-
| <nowiki>{{user::city}}</nowiki> || Dieses Tag wird mit der Stadt des angemeldeten Benutzers ersetzt.
|-
| <nowiki>{{user::country}}</nowiki> || Dieses Tag wird mit dem Land des angemeldeten Benutzers ersetzt.
|-
| <nowiki>{{user::username}}</nowiki> || Dieses Tag wird mit dem Benutzernamen des angemeldeten Benutzers ersetzt.
| colspan="2" |
|}

=== Umgebungsvariablen ===

Mit den folgenden Inserttags können Umgebungsvariablen wie z.B. der Seitenname oder der Request-String ausgegeben werden.

{| border="0" cellspacing="1" cellpadding="2"
! '''Insert-Tag''' !! '''Beschreibung''' !! '''ab Version''' || '''bis Version'''
|-
| <nowiki>{{env::page_id}}</nowiki> || Dieses Tag wird mit der ID der aktuellen Seite ersetzt. || || 2.10.x
|-
| <nowiki>{{env::page_alias}}</nowiki> || Dieses Tag wird mit dem Alias der aktuellen Seite ersetzt. || || 2.10.x
|-
| <nowiki>{{env::page_name}}</nowiki> || Dieses Tag wird mit dem Namen der aktuellen Seite ersetzt. || || 2.10.x
|-
| <nowiki>{{env::page_title}}</nowiki> || Dieses Tag wird mit dem Titel der aktuellen Seite ersetzt. || || 2.10.x
|-
| <nowiki>{{env::page_language}}</nowiki> || Dieses Tag wird mit der Sprache der aktuellen Seite ersetzt. || || 2.10.x
|-
| <nowiki>{{env::parent_alias}}</nowiki> || Dieses Tag wird mit dem Alias der übergeordneten Seite ersetzt. || || 2.10.x
|-
| <nowiki>{{env::parent_name}}</nowiki> || Dieses Tag wird mit dem Namen der übergeordneten Seite ersetzt. || || 2.10.x
|-
| <nowiki>{{env::parent_title}}</nowiki> || Dieses Tag wird mit dem Titel der übergeordneten Seite ersetzt. || || 2.10.x
|-
| <nowiki>{{env::main_alias}}</nowiki> || Dieses Tag wird mit dem Alias der übergeordneten Hauptseite ersetzt. || || 2.10.x
|-
| <nowiki>{{env::main_name}}</nowiki> || Dieses Tag wird mit dem Namen der übergeordneten Hauptseite ersetzt. || || 2.10.x
|-
| <nowiki>{{env::main_title}}</nowiki> || Dieses Tag wird mit dem Titel der übergeordneten Hauptseite ersetzt. || || 2.10.x
|-
| <nowiki>{{env::website_title}}</nowiki> || Dieses Tag wird mit dem Titel der Webseite ersetzt. || ||
|-
| <nowiki>{{env::host}}</nowiki> || Dieses Tag wird mit dem aktuellen Hostnamen ersetzt. || 2.9.0||
|-
| <nowiki>{{env::url}}</nowiki> || Dieses Tag wird mit dem Hostnamen und dem Protokoll ersetzt. || ||
|-
| <nowiki>{{env::path}}</nowiki> || Dieses Tag wird mit der aktuellen Basis-URL samt Pfad zum Contao-Verzeichnis ersetzt. || ||
|-
| <nowiki>{{env::request}}</nowiki> || Dieses Tag wird mit dem aktuellen Request-String ersetzt. || ||
|-
| <nowiki>{{env::referer}}</nowiki> || Dieses Tag wird mit der URL der zuletzt besuchten Seite ersetzt. || ||
|-
| <nowiki>{{env::ip}}</nowiki> || Dieses Tag wird mit der IP-Adresse des aktuellen Besuchers ersetzt. || ||
|-
| colspan="2" |
|}

=== Seitenbezogene Inserttags===

Mit den folgenden Inserttags können Umgebungsvariablen wie z.B. der Seitenname.

{| border="0" cellspacing="1" cellpadding="2"
! '''Insert-Tag''' !! '''Beschreibung''' !! '''ab Version''' || '''bis Version'''
|-
| <nowiki>{{page::id}}</nowiki> || Dieses Tag wird mit der ID der aktuellen Seite ersetzt. || 2.11.x ||
|-
| <nowiki>{{page::alias}}</nowiki> || Dieses Tag wird mit dem Alias der aktuellen Seite ersetzt. || 2.11.x ||
|-
| <nowiki>{{page::title}}</nowiki> || Dieses Tag wird mit dem Namen der aktuellen Seite ersetzt. || 2.11.x ||
|-
| <nowiki>{{page::pageTitle}}</nowiki> || Dieses Tag wird mit dem Titel der aktuellen Seite ersetzt. || 2.11.x ||
|-
| <nowiki>{{page::language}}</nowiki> || Dieses Tag wird mit der Sprache der aktuellen Seite ersetzt. || 2.11.x ||
|-
| <nowiki>{{page::parentAlias}}</nowiki> || Dieses Tag wird mit dem Alias der übergeordneten Seite ersetzt. || 2.11.x ||
|-
| <nowiki>{{page::parentTitle}}</nowiki> || Dieses Tag wird mit dem Namen der übergeordneten Seite ersetzt. || 2.11.x ||
|-
| <nowiki>{{page::parentPageTitle}}</nowiki> || Dieses Tag wird mit dem Titel der übergeordneten Seite ersetzt. || 2.11.x||
|-
| <nowiki>{{page::mainAlias}}</nowiki> || Dieses Tag wird mit dem Alias der übergeordneten Hauptseite ersetzt. || 2.11.x ||
|-
| <nowiki>{{page::mainTitle}}</nowiki> || Dieses Tag wird mit dem Namen der übergeordneten Hauptseite ersetzt. || 2.11.x ||
|-
| <nowiki>{{page::mainPageTitle}}</nowiki> || Dieses Tag wird mit dem Titel der übergeordneten Hauptseite ersetzt. || 2.11.x ||
|-
| <nowiki>{{page::rootTitle}}</nowiki> || Dieses Tag wird mit dem Titel der Webseite ersetzt. || 2.11.x ||
|-
| colspan="2" |
|}

=== Include-Elemente ===

Mit den folgenden Inserttags können Ressourcen wie z.B. Artikel, Module oder Dateien aus dem templates-Verzeichnis eingebunden werden.

{| border="0" cellspacing="1" cellpadding="2"
! '''Insert-Tag''' !! '''Beschreibung'''
|-
| <nowiki>{{insert_article::*}}</nowiki> || Dieses Tag wird mit dem referenzierten Artikel ersetzt (ersetzen Sie * mit der ID oder dem Alias).
|-
| <nowiki>{{insert_content::*}}</nowiki> || Dieses Tag wird mit dem referenzierten Inhaltselement ersetzt (ersetzen Sie * mit der ID des Elements).
|-
| <nowiki>{{insert_module::*}}</nowiki> || Dieses Tag wird mit dem referenzierten Modul ersetzt (ersetzen Sie * mit der ID des Moduls).
|-
| <nowiki>{{article_teaser::*}}</nowiki> || Dieses Tag wird mit dem Teaser eines Artikels ersetzt (ersetzen Sie * mit der ID des Artikels).
|-
| <nowiki>{{news_teaser::*}}</nowiki> || Dieses Tag wird mit dem Teaser einer Nachricht ersetzt (ersetzen Sie * mit der ID der Nachricht).
|-
| <nowiki>{{event_teaser::*}}</nowiki> || Dieses Tag wird mit dem Teaser eines Events ersetzt (ersetzen Sie * mit der ID des Events).
|-
| <nowiki>{{file::*}}</nowiki> || Dieses Tag wird mit dem Inhalt einer .php- oder .tpl-Datei aus dem templates-Verzeichnis ersetzt (ersetzen Sie * mit dem Namen). Bei Bedarf können Sie Argumente übergeben: <nowiki>{{file::file.php?arg1=val&arg2=val}}</nowiki>
|-
| <nowiki>{{insert_form::*}}</nowiki> || Dieses Tag wird mit dem referenzierten Formular ersetzt (ersetzen Sie * mit der ID oder dem Alias).
|-
| colspan="2" |
|}

=== Verschiedenes ===

Mit den folgenden Inserttags können Sie verschiedene Aufgaben erledigen und z.B. das aktuelle Datum oder ein Lightbox-Bild einfügen.

{| border="0" cellspacing="1" cellpadding="2"
! '''Insert-Tag''' !! '''Beschreibung''' !! '''ab Version''' || '''bis Version'''
|-
| <nowiki>{{date}}</nowiki> || Dieses Tag wird mit dem aktuellen Datum gemäß des globalen Datumsformats ersetzt. || ||
|-
| <nowiki>{{date::*}}</nowiki> || Dieses Tag wird mit dem aktuellen Datum gemäß eines individuellen Datumsformats ersetzt. || ||
|-
| <nowiki>{{last_update}}</nowiki> || Dieses Tag wird mit dem Datum der letzten Aktualisierung gemäß des globalen Datumsformats ersetzt. || ||
|-
| <nowiki>{{last_update::*}}</nowiki> || Dieses Tag wird mit Datum der letzten Aktualisierung gemäß eines individuellen Datumsformats ersetzt. || ||
|-
| <nowiki>{{email::*}}</nowiki> || Dieses Tag wird mit einem verschlüsselten Link zu einer E-Mail-Adresse ersetzt. || ||
|-
| <nowiki>{{email_open::*}}</nowiki> || Erstellt einfach nur ein öffenden Link || 2.11 ||
|-
| <nowiki>{{email_url::*}}</nowiki> || Dieser Tag wird mit der E-Mailadresse ersetzt und dann wird ein mailto mit der verschlüsselten E-Mailadresse erstellt || 2.11 ||
|-
| <nowiki>{{lang::*}}</nowiki> || Mit diesem Tag können fremdsprachige Wörter in einem Text markiert werden: <nowiki>{{lang::fr}}Au revoir{{lang}}</nowiki> 
Wird ersetzt mit <nowiki>Au revoir</nowiki>. || ||
|-
| <nowiki>{{iflng::*}}</nowiki> || Dieses Tag wird komplett entfernt, wenn die Sprache der Seite nicht mit der Tag-Sprache übereinstimmt. Sie können so sprachspezifische Bezeichnungen erstellen: 
<nowiki>{{iflng::en}}Your name{{iflng}}{{iflng::de}}Ihr Name{{iflng}}
</nowiki> || ||
|-
| <nowiki>{{image::*}}</nowiki> || Dieses Tag wird mit der Vorschauansicht eines Bildes ersetzt: <nowiki>{{image::tl_files/image.jpg?width=200&height=150}}</nowiki> 
Argumente sind: 
*width - Breite des Vorschaubildes
*height - Höhe des Vorschaubildes
*alt - Alternativer Text
*class CSS-Klasse
*rel rel-Attribut (z.B. "lightbox")
*mode Modus ("proportional", "crop" oder "box") || 2.8.2 ||
|-
| <nowiki>{{label::*}}</nowiki> || Dieses Tag wird mit einer Übersetzung ersetzt: <nowiki>{{label::CNT:au}}</nowiki> oder <nowiki>{{label::tl_article:title:0}}</nowiki>. Beachten Sie, dass innerhalb des Pfads zur Bezeichnung nur einfache Doppelpunkte verwendet werden. || ||
|-
| <nowiki>{{abbr::Abkürzungserklärung}}Abkürzung{{abbr}}</nowiki> || - Mit diesem Tag können Abkürzungen in einem Text markiert werden: <nowiki>{{abbr::AGG}}Allgemeines Gleichstellungsgesetz{{abbr}}</nowiki> wird ersetzt mit <nowiki>Allgemeines Gleichstellungsgesetz</nowiki>. || 2.9.2 ||
|-
| <nowiki>{{acronym::Akronymerklärung}}Akronym{{acronym}}</nowiki> || - Mit diesem Tag können Akronyme in einem Text markiert werden: <nowiki>{{acronym::PISA}}Programme for International Student Assessment{{acronym}}</nowiki> wird ersetzt mit <nowiki>Programme for International Student Assessment</nowiki>. || 2.9.2 ||
| colspan="3" |
|}

=== Weitere Inserttags ===
*<nowiki>{{env::ua}}</nowiki> - liefert den Usergent zurück
*<nowiki>{{env::plugins_url}}</nowiki> - liefert TL_PLUGINS_URL;
*<nowiki>{{env::script_url}}</nowiki> - liefert TL_SCRIPT_URL;
*<nowiki>{{env::files_url}}</nowiki> - liefert TL_FILES_URL;
*<nowiki>{{env::ip}}</nowiki> - liefert IP
*<nowiki>{{env::http_host}}</nowiki> - liefert den HTTP-Host
*<nowiki>{{ifnlng::XX}}</nowiki> - if '''not''' language
*<nowiki>{{request_token}}</nowiki> - Request Token
*<nowiki>{{version}}</nowiki> - Version
*<nowiki>{{last_update}}</nowiki> - letztes Update
*<nowiki>{{calendar_feed::xx}}</nowiki> - Kalender-Feed
*<nowiki>{{news_feed::xx}}</nowiki> - News-Feed

== Inserttags in Templates verwenden ==

{{Hinweis|Dieser Abschnitt richtet sich eher an Entwickler.}}

Falls man einmal ein Insert-Tags innerhalb eines Templates verwenden möchte. Ist folgender Contao-Methode sehr wichtig.

<source lang="php"><?php echo $this->replaceInsertTags('{{link::1}}'); //Hier würde ein Link zum Artikel 1 erzeugt ?></source>

== Eigene Insert-Tags erstellen ==
Darüber hinaus gibt es Möglichkeiten, um eigene Insert-Tags zu erstellen Siehe auch: [[Eigene_insert_tags_erstellen]].

== Insert-Tags von Extensions ==

=== dlstats ===
Die Insert-Tags der Extension "dlstats" sind unter [[Dlstats#Insert-Tag_Nutzung]] aufgelistet.

=== LastLogin ===
Die Insert-Tags der Extension "LastLogin" sind ab [[LastLogin#Letzter_Login]] aufgelistet.

=== Visitors ===
Die Insert-Tags der Extension "Visitors" sind unter [[Visitors#Insert-Tags]] aufgelistet.

=== Tags ===

Die Insert-Tags der Extension "Tags" sind unter [[Tags#Insert_Tags]] aufgelistet.

Benutzer:Samson1964

2013-06-15T12:16:44Z

Samson1964: Die Seite wurde neu angelegt: „'''Nick:''' Samson1964 '''Realer Name:''' Frank Hoppe '''Geburtstag:''' 19.09.1964 '''Wohnort:''' Berlin '''Arbeit''': Angestellter '''Tätigk…“

'''Nick:''' Samson1964 
'''Realer Name:''' Frank Hoppe 
'''Geburtstag:''' 19.09.1964 
'''Wohnort:''' Berlin 
'''Arbeit''': Angestellter 
'''Tätigkeit:''' Garagenwart bei [http://www.apcoa.de/ APCOA] 
'''Hobbies:''' Programmieren (BASIC, Perl, PHP, C, CSS, HTML), Schach, Fotografieren 
'''Private Website:''' [http://blog.schachbulle.de/ Schachbulle] 
'''Websites als Webmaster:''' [http://www.schachbund.de/ Deutscher Schachbund], [http://www.berlinerschachverband.de Berliner Schachverband] 
'''Bisher benutzte CMS:''' [http://www.phpcms.de/ phpCMS], [http://wpde.org/ WordPress], [http://mozilo.de/ moziloCMS], [http://www.joomla.de/ Joomla!], Limbo, [http://pivotx.net/ PivotX], Contao und testweise [http://www.drupal.de/ Drupal] 
'''Forum:''' [https://community.contao.org/de/member.php?10642-Samson1964 Samson1964]

Ich benutze Contao seit Mai 2013 und will damit die neue Webpräsenz des Deutschen Schachbundes umsetzen. Bisher setze ich hier auf das altbewährte phpCMS und PivotX - beides ohne MySQL-Datenbank.