Contao Community Documentation - Benutzerbeiträge [de]

Zeit und Datum Ausgabe anpassen

2012-06-28T11:38:49Z

Darknukel:

{{stub}}
Gerade in der Event-Darstellung möchte man oft eine ansprechendere Ausgabe der Zeit- und Datumsangaben erreichen.

Neben der Möglichkeit, die uns Contao unter Einstellungen bietet, steht die Anpassung über die Templates offen.

Mit Hilfe der date() Funktin lässt sich der Timestamp in ein ansprechendes Format bringen, jedoch mit der Einschränkung, dass die englische Schreibweise bei der Monats- und Tagesbezeichnung verwendet wird.

Die Contao Funktion parseDate() schafft hier Abhilfe und greift bei der Generierung auf die Sprachdateien zurück.

Die Verwendung des parseDate-Befehls von Contao sieht wie folgt aus:

<source lang="php"><?php echo $this->parseDate('', $datum_unformatiert); // Als erster Parameter kann das Format in date() PHP-Syntax angegeben werden, lässt man den Wert leer, wird der Default aus der Konfiguration verwendet ?></source>

Zeit und Datum Ausgabe anpassen

2012-06-28T11:38:15Z

Darknukel: Hinzugefügt, wie man parseDate in Contao verwendet

{{stub}}
Gerade in der Event-Darstellung möchte man oft eine ansprechendere Ausgabe der Zeit- und Datumsangaben erreichen.

Neben der Möglichkeit, die uns Contao unter Einstellungen bietet, steht die Anpassung über die Templates offen.

Mit Hilfe der date() Funktin lässt sich der Timestamp in ein ansprechendes Format bringen, jedoch mit der Einschränkung, dass die englische Schreibweise bei der Monats- und Tagesbezeichnung verwendet wird.

Die Contao Funktion parseDate() schafft hier Abhilfe und greift bei der Generierung auf die Sprachdateien zurück.

Die Verwendung des parseDate-Befehls von Contao sieht wie folgt aus:

<source lang="php"><?php echo $this->parseDate('', $datum_unformatiert); // Als erster Parameter kann das Format in date() PHP-Syntax, angegeben werden, lässt man den Wert lerr, wird der Default aus der Konfiguration verwendet ?></source>

Insert-Tags

2012-06-26T15:01:11Z

Darknukel: /* Inserttags in Templates verwenden */

{{stub}}
{{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 interne Seite ersetzt (ersetzen Sie * mit der ID oder dem Alias).
|-
|<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{{abbr}}</nowiki> wird ersetzt mit <nowili>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.

Insert-Tags

2012-05-31T10:49:35Z

Darknukel: /* Verschiedenes */ E-Mail weiter dokumentiert

{{stub}}
{{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 interne Seite ersetzt (ersetzen Sie * mit der ID oder dem Alias).
|-
|<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{{abbr}}</nowiki> wird ersetzt mit <nowili>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 ===

''Hinweiß: 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 werden. ?></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.

Insert-Tags

2012-05-31T10:44:51Z

Darknukel: Hinzugefügt, wie man Inserttags innerhalb von Variablen benutzt,

{{stub}}
{{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 interne Seite ersetzt (ersetzen Sie * mit der ID oder dem Alias).
|-
|<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> || '''???''' || 2.11 ||
|-
| <nowiki>{{email_url::*}}</nowiki> || '''???''' || 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{{abbr}}</nowiki> wird ersetzt mit <nowili>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 ===

''Hinweiß: 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 werden. ?></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.