Insert-Tags: Unterschied zwischen den Versionen

Aus Contao Community Documentation

K (LastLogin)
K (Seitenbezogene Inserttags)
 
(31 dazwischenliegende Versionen von 8 Benutzern werden nicht angezeigt)
Zeile 1: Zeile 1:
{{stub}}
 
 
{{AppliesTo
 
{{AppliesTo
 
|Version=Alle Versionen
 
|Version=Alle Versionen
 
}}
 
}}
 
+
[[Category: Core]]
 
[[Category:Dev HOWTOS]]
 
[[Category:Dev HOWTOS]]
 +
[[Category:Anwender und Redakteure]]
 +
 
= Insert-Tags =
 
= Insert-Tags =
 
Contao bietet die Möglichkeit, mittels so genannter Insert-Tags Inhalte oder Funktionen zu referenzieren.
 
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>.
 
Der Aufbau ist in der Regel <nowiki>{{Tagname::Argument}}</nowiki>.
{{Achtung|Eine Verschachtelung - also der Aufruf eines Insert-Tags innerhalb eines anderen - ist nicht möglich.}}
+
{{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 ==
 
== Liste der Insert-Tags ==
Zeile 17: Zeile 20:
 
! '''Insert-Tag''' !! '''Beschreibung'''
 
! '''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::*}}</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::back}}</nowiki> || Dieses Tag wird mit der zuletzt besuchte Seite ersetzt. Kann auch mit link_open, link_url und link_title verwendet werden.
Zeile 98: Zeile 101:
 
| colspan="2" |
 
| colspan="2" |
 
|}
 
|}
 +
Mit der Insert-Tag-Methode <nowiki>{{user::variable}}</nowiki> können auch andere Eigenschaften von Usern abgefragt werden.
  
 
=== Umgebungsvariablen ===
 
=== Umgebungsvariablen ===
Zeile 116: Zeile 120:
 
| <nowiki>{{env::page_language}}</nowiki> || Dieses Tag wird mit der Sprache 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. || ||
+
| <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. || ||
+
| <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. || ||
+
| <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. || ||
+
| <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. || ||
+
| <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. || ||
+
| <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::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::host}}</nowiki> || Dieses Tag wird mit dem aktuellen Hostnamen ersetzt.  || 2.9.0||
 +
|-
 +
| <nowiki>{{env::http_host}}</nowiki> || Dieses Tag wird mit dem aktuellen HTTP-Host ersetzt.  || unbekannt||
 
|-
 
|-
 
| <nowiki>{{env::url}}</nowiki> || Dieses Tag wird mit dem Hostnamen und dem Protokoll ersetzt. || ||
 
| <nowiki>{{env::url}}</nowiki> || Dieses Tag wird mit dem Hostnamen und dem Protokoll ersetzt. || ||
Zeile 159: Zeile 165:
 
|-
 
|-
 
| <nowiki>{{page::pageTitle}}</nowiki> || Dieses Tag wird mit dem Titel 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::description}}</nowiki> || Dieses Tag wird mit der Beschreibung 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::language}}</nowiki> || Dieses Tag wird mit der Sprache der aktuellen Seite ersetzt. || 2.11.x ||  
Zeile 181: Zeile 189:
 
=== Include-Elemente ===
 
=== Include-Elemente ===
  
Mit den folgenden Inserttags können Ressourcen wie z.B. Artikel, Module oder Dateien aus dem templates-Verzeichnis eingebunden werden.
+
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"
 
{| border="0" cellspacing="1" cellpadding="2"
Zeile 201: Zeile 209:
 
|-
 
|-
 
| <nowiki>{{insert_form::*}}</nowiki> || Dieses Tag wird mit dem referenzierten Formular ersetzt (ersetzen Sie * mit der ID oder dem Alias).
 
| <nowiki>{{insert_form::*}}</nowiki> || Dieses Tag wird mit dem referenzierten Formular ersetzt (ersetzen Sie * mit der ID oder dem Alias).
 +
|-
 +
| colspan="2" |
 +
|}
 +
 +
=== Systempfade ===
 +
 +
Mit den folgenden Inserttags können Systempfade referenzenziert werden:
 +
 +
{| border="0" cellspacing="1" cellpadding="2"
 +
! '''Insert-Tag''' !! '''Beschreibung'''
 +
|-
 +
| <nowiki>{{files_url}}</nowiki> || Liefert den Pfad zum Verzeichnis für /files
 +
|-
 +
| <nowiki>{{assets_url}}</nowiki> || Liefert den Pfad zum Verzeichnis für /assets
 +
|-
 +
| <nowiki>{{plugins_url}}</nowiki> || Liefert den Pfad zum Verzeichnis für /plugins
 +
|-
 +
| <nowiki>{{script_url}}</nowiki> || Liefert den Pfad zum Verzeichnis für /scripts
 
|-
 
|-
 
| colspan="2" |  
 
| colspan="2" |  
Zeile 222: Zeile 248:
 
| <nowiki>{{email::*}}</nowiki> || Dieses Tag wird mit einem verschlüsselten Link zu einer E-Mail-Adresse 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_open::*}}</nowiki> || Erstellt einfach nur ein öffenden Link || 2.11 ||
 
|-
 
|-
| <nowiki>{{email_url::*}}</nowiki> || '''???''' || 2.11 ||
+
| <nowiki>{{news_feed::*}}</nowiki> || Bindet den Newsfeed aus /share/ID über die ID ein || 3.1.3 ||
 
|-
 
|-
 +
| <nowiki>{{calendar_feed::*}}</nowiki> || Bindet den Kalenderfeed aus /share/ID über die ID ein || 3.1.3 ||
 +
|-
 +
 +
 
| <nowiki>{{lang::*}}</nowiki> || Mit diesem Tag können fremdsprachige Wörter in einem Text markiert werden: <nowiki>{{lang::fr}}Au revoir{{lang}}</nowiki><br />
 
| <nowiki>{{lang::*}}</nowiki> || Mit diesem Tag können fremdsprachige Wörter in einem Text markiert werden: <nowiki>{{lang::fr}}Au revoir{{lang}}</nowiki><br />
 
Wird ersetzt mit <nowiki><span lang="fr" xml:lang="fr">Au revoir</span></nowiki>. || ||
 
Wird ersetzt mit <nowiki><span lang="fr" xml:lang="fr">Au revoir</span></nowiki>. || ||
Zeile 240: Zeile 270:
 
*class CSS-Klasse
 
*class CSS-Klasse
 
*rel rel-Attribut (z.B. "lightbox")
 
*rel rel-Attribut (z.B. "lightbox")
*mode Modus ("proportional", "crop" oder "box") || ||
+
*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>.<br />Beachten Sie, dass innerhalb des Pfads zur Bezeichnung nur einfache Doppelpunkte verwendet werden. || ||
 
| <nowiki>{{label::*}}</nowiki> || Dieses Tag wird mit einer Übersetzung ersetzt: <nowiki>{{label::CNT:au}}</nowiki> oder <nowiki>{{label::tl_article:title:0}}</nowiki>.<br />Beachten Sie, dass innerhalb des Pfads zur Bezeichnung nur einfache Doppelpunkte verwendet werden. || ||
Zeile 246: Zeile 276:
 
| <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><span abbr="AGG">Allgemeines Gleichstellungsgesetz</span></nowiki>. || 2.9.2 ||
 
| <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><span abbr="AGG">Allgemeines Gleichstellungsgesetz</span></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><span acronym="PISA">Programme for International Student Assessment</span></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><span acronym="PISA">Programme for International Student Assessment</span></nowiki>. || 2.9.2 ||  
 
| colspan="3" |  
 
| colspan="3" |  
 
|}
 
|}
  
 
=== Weitere Inserttags ===
 
=== Weitere Inserttags ===
*<nowiki>{{env::ua}}</nowiki> - liefert den Usergent zurück
+
*<nowiki>{{env::ua}}</nowiki> - liefert den Useragent 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::ip}}</nowiki> - liefert IP
 
*<nowiki>{{env::http_host}}</nowiki> - liefert den HTTP-Host
 
*<nowiki>{{env::http_host}}</nowiki> - liefert den HTTP-Host
Zeile 261: Zeile 288:
 
*<nowiki>{{version}}</nowiki> - Version
 
*<nowiki>{{version}}</nowiki> - Version
 
*<nowiki>{{last_update}}</nowiki> - letztes Update
 
*<nowiki>{{last_update}}</nowiki> - letztes Update
*<nowiki>{{calendar_feed::xx}}</nowiki> - Kalender-Feed
+
*<nowiki>{{post}} - $arrCache[$strTag] = \Input::post($elements[1]);</nowiki>
*<nowiki>{{news_feed::xx}}</nowiki> - News-Feed
+
*<nowiki>{{toggle_view}}</nowiki> - Wechselt das Seitenlayout von Desktop zu Mobil und vice versa
 +
*<nowiki>{{br}}</nowiki> - fügt einen Zeilenumbruch ein (ab Version 3.2. RC1, nützlich in Elementen, die kein HTML erlauben)
 +
 
 +
== 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 ==
 
== Eigene Insert-Tags erstellen ==
Zeile 273: Zeile 309:
  
 
=== LastLogin ===
 
=== LastLogin ===
Die Insert-Tags der Extension "LastLogin" sind unter [[LastLogin#Letzter_Login]] aufgelistet.
+
Die Insert-Tags der Extension "LastLogin" sind ab [[LastLogin#Letzter_Login]] aufgelistet.
  
 
=== Visitors ===
 
=== Visitors ===
Zeile 280: Zeile 316:
 
=== Tags ===
 
=== Tags ===
  
Die Insert-Tags der Extension "Tags sind unter [[Tags#Insert_Tags]] aufgelistet.
+
Die Insert-Tags der Extension "Tags" sind unter [[Tags#Insert_Tags]] aufgelistet.
 +
 
 +
=== MetaModels ===
 +
 
 +
Die Insert-Tags der Extensions "MetaModels" sind unter [[MetaModels_Insert-Tags]] aufgelistet.

Aktuelle Version vom 6. Mai 2015, 14:25 Uhr

betrifft
Contao Version Alle Versionen

Insert-Tags

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

Der Aufbau ist in der Regel {{Tagname::Argument}}.

Achtung.png Achtung: Eine Verschachtelung – also der Aufruf eines Insert-Tags innerhalb eines anderen – ist nur mit {{iflng::*}} möglich. Andere Insert-Tags können nicht verschachtelt werden.


Achtung.png 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 Contao.org. Über die dort dokumentierten Insert-Tags hinaus gibt es weitere Insert-Tags. Bitte vervollständige die Liste.

Link-Elemente

Insert-Tag Beschreibung
{{link::*}} 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).
{{link::back}} Dieses Tag wird mit der zuletzt besuchte Seite ersetzt. Kann auch mit link_open, link_url und link_title verwendet werden.
{{link::login}} Dieses Tag wird mit einem Link zur Anmeldeseite des aktuellen Frontend-Benutzers (falls vorhanden) ersetzt.
{{link_open::*}} Wird mit dem öffnenden Tag eines Links zu einer internen Seite ersetzt: {{link_open::12}}Click here{{link_close}}.
{{link_url::*}} Dieses Tag wird mit der URL einer internen Seite ersetzt: <a href="{{link_url::12}}">Click here</a>.
{{link_title::*}} Dieses Tag wird mit dem Titel einer internen Seite ersetzt: <a title="{{link_title::12}}">Click here</a>.
{{article::*}} Dieses Tag wird mit einem Link zu einem Artikel ersetzt (ersetzen Sie * mit der ID oder dem Alias).
{{article_open::*}} Wird mit dem öffnenden Tag eines Links zu einem Artikel ersetzt: {{article_open::12}}Click here{{link_close}}.
{{article_url::*}} Dieses Tag wird mit der URL eines Artikels ersetzt: <a href="{{article_url::12}}">Click here</a>.
{{article_title::*}} Dieses Tag wird mit dem Titel eines Artikels ersetzt: <a title="{{article_title::12}}">Click here</a>.
{{news::*}} Dieses Tag wird mit einem Link zu einer Nachricht ersetzt (ersetzen Sie * mit der ID oder dem Alias).
{{news_open::*}} Wird mit dem öffnenden Tag eines Links zu einer Nachricht ersetzt: {{news_open::12}}Click here{{link_close}}.
{{news_url::*}} Dieses Tag wird mit der URL einer Nachricht ersetzt: <a href="{{news_url::12}}">Click here</a>.
{{news_title::*}} Dieses Tag wird mit dem Titel einer Nachricht ersetzt: <a title="{{news_title::12}}">Click here</a>.
{{event::*}} Dieses Tag wird mit einem Link zu einem Event ersetzt (ersetzen Sie * mit der ID oder dem Alias).
{{event_open::*}} Wird mit dem öffnenden Tag eines Links zu einem Event ersetzt: {{event_open::12}}Click here{{link_close}}.
{{event_url::*}} Dieses Tag wird mit der URL eines Events ersetzt: <a href="{{event_url::12}}">Click here</a>.
{{event_title::*}} Dieses Tag wird mit dem Titel eines Events ersetzt: <a title="{{event_title::12}}">Click here</a>.
{{faq::*}} Dieses Tag wird mit einem Link zu einer häufig gestellten Frage ersetzt (ersetzen Sie * mit der ID oder dem Alias).
{{faq_open::*}} Wird mit dem öffnenden Tag eines Links zu einer Frage ersetzt: {{faq_open::12}}Click here{{link_close}}.
{{faq_url::*}} Dieses Tag wird mit der URL einer Frage ersetzt: <a href="{{faq_url::12}}">Click here</a>.
{{faq_title::*}} Dieses Tag wird mit dem Titel einer Frage ersetzt: <a title="{{faq_title::12}}">Click here</a>.

Benutzereigenschaften

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

Insert-Tag Beschreibung
{{user::firstname}} Dieses Tag wird mit dem Vornamen des angemeldeten Benutzers ersetzt.
{{user::lastname}} Dieses Tag wird mit dem Nachnamen des angemeldeten Benutzers ersetzt.
{{user::company}} Dieses Tag wird mit dem Firmennamen des angemeldeten Benutzers ersetzt.
{{user::phone}} Dieses Tag wird mit der Telefonnummer des angemeldeten Benutzers ersetzt.
{{user::mobile}} Dieses Tag wird mit der Handynummer des angemeldeten Benutzers ersetzt.
{{user::fax}} Dieses Tag wird mit der Faxnummer des angemeldeten Benutzers ersetzt.
{{user::email}} Dieses Tag wird mit der E-Mail-Adresse des angemeldeten Benutzers ersetzt.
{{user::website}} Dieses Tag wird mit der Internetadresse des angemeldeten Benutzers ersetzt.
{{user::street}} Dieses Tag wird mit dem Staßennamen des angemeldeten Benutzers ersetzt.
{{user::postal}} Dieses Tag wird mit der Postleitzahl des angemeldeten Benutzers ersetzt.
{{user::city}} Dieses Tag wird mit der Stadt des angemeldeten Benutzers ersetzt.
{{user::country}} Dieses Tag wird mit dem Land des angemeldeten Benutzers ersetzt.
{{user::username}} Dieses Tag wird mit dem Benutzernamen des angemeldeten Benutzers ersetzt.

Mit der Insert-Tag-Methode {{user::variable}} können auch andere Eigenschaften von Usern abgefragt werden.

Umgebungsvariablen

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

Insert-Tag Beschreibung ab Version bis Version
{{env::page_id}} Dieses Tag wird mit der ID der aktuellen Seite ersetzt. 2.10.x
{{env::page_alias}} Dieses Tag wird mit dem Alias der aktuellen Seite ersetzt. 2.10.x
{{env::page_name}} Dieses Tag wird mit dem Namen der aktuellen Seite ersetzt. 2.10.x
{{env::page_title}} Dieses Tag wird mit dem Titel der aktuellen Seite ersetzt. 2.10.x
{{env::page_language}} Dieses Tag wird mit der Sprache der aktuellen Seite ersetzt. 2.10.x
{{env::parent_alias}} Dieses Tag wird mit dem Alias der übergeordneten Seite ersetzt. 2.10.x
{{env::parent_name}} Dieses Tag wird mit dem Namen der übergeordneten Seite ersetzt. 2.10.x
{{env::parent_title}} Dieses Tag wird mit dem Titel der übergeordneten Seite ersetzt. 2.10.x
{{env::main_alias}} Dieses Tag wird mit dem Alias der übergeordneten Hauptseite ersetzt. 2.10.x
{{env::main_name}} Dieses Tag wird mit dem Namen der übergeordneten Hauptseite ersetzt. 2.10.x
{{env::main_title}} Dieses Tag wird mit dem Titel der übergeordneten Hauptseite ersetzt. 2.10.x
{{env::website_title}} Dieses Tag wird mit dem Titel der Webseite ersetzt.
{{env::host}} Dieses Tag wird mit dem aktuellen Hostnamen ersetzt. 2.9.0
{{env::http_host}} Dieses Tag wird mit dem aktuellen HTTP-Host ersetzt. unbekannt
{{env::url}} Dieses Tag wird mit dem Hostnamen und dem Protokoll ersetzt.
{{env::path}} Dieses Tag wird mit der aktuellen Basis-URL samt Pfad zum Contao-Verzeichnis ersetzt.
{{env::request}} Dieses Tag wird mit dem aktuellen Request-String ersetzt.
{{env::referer}} Dieses Tag wird mit der URL der zuletzt besuchten Seite ersetzt.
{{env::ip}} Dieses Tag wird mit der IP-Adresse des aktuellen Besuchers ersetzt.

Seitenbezogene Inserttags

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

Insert-Tag Beschreibung ab Version bis Version
{{page::id}} Dieses Tag wird mit der ID der aktuellen Seite ersetzt. 2.11.x
{{page::alias}} Dieses Tag wird mit dem Alias der aktuellen Seite ersetzt. 2.11.x
{{page::title}} Dieses Tag wird mit dem Namen der aktuellen Seite ersetzt. 2.11.x
{{page::pageTitle}} Dieses Tag wird mit dem Titel der aktuellen Seite ersetzt. 2.11.x
{{page::description}} Dieses Tag wird mit der Beschreibung der aktuellen Seite ersetzt. 2.11.x
{{page::language}} Dieses Tag wird mit der Sprache der aktuellen Seite ersetzt. 2.11.x
{{page::parentAlias}} Dieses Tag wird mit dem Alias der übergeordneten Seite ersetzt. 2.11.x
{{page::parentTitle}} Dieses Tag wird mit dem Namen der übergeordneten Seite ersetzt. 2.11.x
{{page::parentPageTitle}} Dieses Tag wird mit dem Titel der übergeordneten Seite ersetzt. 2.11.x
{{page::mainAlias}} Dieses Tag wird mit dem Alias der übergeordneten Hauptseite ersetzt. 2.11.x
{{page::mainTitle}} Dieses Tag wird mit dem Namen der übergeordneten Hauptseite ersetzt. 2.11.x
{{page::mainPageTitle}} Dieses Tag wird mit dem Titel der übergeordneten Hauptseite ersetzt. 2.11.x
{{page::rootTitle}} Dieses Tag wird mit dem Titel der Webseite ersetzt. 2.11.x

Include-Elemente

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

Insert-Tag Beschreibung
{{insert_article::*}} Dieses Tag wird mit dem referenzierten Artikel ersetzt (ersetzen Sie * mit der ID oder dem Alias).
{{insert_content::*}} Dieses Tag wird mit dem referenzierten Inhaltselement ersetzt (ersetzen Sie * mit der ID des Elements).
{{insert_module::*}} Dieses Tag wird mit dem referenzierten Modul ersetzt (ersetzen Sie * mit der ID des Moduls).
{{article_teaser::*}} Dieses Tag wird mit dem Teaser eines Artikels ersetzt (ersetzen Sie * mit der ID des Artikels).
{{news_teaser::*}} Dieses Tag wird mit dem Teaser einer Nachricht ersetzt (ersetzen Sie * mit der ID der Nachricht).
{{event_teaser::*}} Dieses Tag wird mit dem Teaser eines Events ersetzt (ersetzen Sie * mit der ID des Events).
{{file::*}} 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: {{file::file.php?arg1=val&arg2=val}}
{{insert_form::*}} Dieses Tag wird mit dem referenzierten Formular ersetzt (ersetzen Sie * mit der ID oder dem Alias).

Systempfade

Mit den folgenden Inserttags können Systempfade referenzenziert werden:

Insert-Tag Beschreibung
{{files_url}} Liefert den Pfad zum Verzeichnis für /files
{{assets_url}} Liefert den Pfad zum Verzeichnis für /assets
{{plugins_url}} Liefert den Pfad zum Verzeichnis für /plugins
{{script_url}} Liefert den Pfad zum Verzeichnis für /scripts

Verschiedenes

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

Insert-Tag Beschreibung ab Version bis Version
{{date}} Dieses Tag wird mit dem aktuellen Datum gemäß des globalen Datumsformats ersetzt.
{{date::*}} Dieses Tag wird mit dem aktuellen Datum gemäß eines individuellen Datumsformats ersetzt.
{{last_update}} Dieses Tag wird mit dem Datum der letzten Aktualisierung gemäß des globalen Datumsformats ersetzt.
{{last_update::*}} Dieses Tag wird mit Datum der letzten Aktualisierung gemäß eines individuellen Datumsformats ersetzt.
{{email::*}} Dieses Tag wird mit einem verschlüsselten Link zu einer E-Mail-Adresse ersetzt.
{{email_open::*}} Erstellt einfach nur ein öffenden Link 2.11
{{news_feed::*}} Bindet den Newsfeed aus /share/ID über die ID ein 3.1.3
{{calendar_feed::*}} Bindet den Kalenderfeed aus /share/ID über die ID ein 3.1.3
{{lang::*}} Mit diesem Tag können fremdsprachige Wörter in einem Text markiert werden: {{lang::fr}}Au revoir{{lang}}

Wird ersetzt mit <span lang="fr" xml:lang="fr">Au revoir</span>. || ||

{{iflng::*}} Dieses Tag wird komplett entfernt, wenn die Sprache der Seite nicht mit der Tag-Sprache übereinstimmt. Sie können so sprachspezifische Bezeichnungen erstellen:

{{iflng::en}}Your name{{iflng}}{{iflng::de}}Ihr Name{{iflng}} || ||

{{image::*}} Dieses Tag wird mit der Vorschauansicht eines Bildes ersetzt: {{image::tl_files/image.jpg?width=200&height=150}}

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 ||
{{label::*}} Dieses Tag wird mit einer Übersetzung ersetzt: {{label::CNT:au}} oder {{label::tl_article:title:0}}.
Beachten Sie, dass innerhalb des Pfads zur Bezeichnung nur einfache Doppelpunkte verwendet werden.
{{abbr::Abkürzungserklärung}}Abkürzung{{abbr}} - Mit diesem Tag können Abkürzungen in einem Text markiert werden: {{abbr::AGG}}Allgemeines Gleichstellungsgesetz{{abbr}} wird ersetzt mit <span abbr="AGG">Allgemeines Gleichstellungsgesetz</span>. 2.9.2
{{acronym::Akronymerklärung}}Akronym{{acronym}} - Mit diesem Tag können Akronyme in einem Text markiert werden: {{acronym::PISA}}Programme for International Student Assessment{{acronym}} wird ersetzt mit <span acronym="PISA">Programme for International Student Assessment</span>. 2.9.2

Weitere Inserttags

  • {{env::ua}} - liefert den Useragent zurück
  • {{env::ip}} - liefert IP
  • {{env::http_host}} - liefert den HTTP-Host
  • {{ifnlng::XX}} - if not language
  • {{request_token}} - Request Token
  • {{version}} - Version
  • {{last_update}} - letztes Update
  • {{post}} - $arrCache[$strTag] = \Input::post($elements[1]);
  • {{toggle_view}} - Wechselt das Seitenlayout von Desktop zu Mobil und vice versa
  • {{br}} - fügt einen Zeilenumbruch ein (ab Version 3.2. RC1, nützlich in Elementen, die kein HTML erlauben)

Inserttags in Templates verwenden

Hinweis.png 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.

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

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.

MetaModels

Die Insert-Tags der Extensions "MetaModels" sind unter MetaModels_Insert-Tags aufgelistet.

Ansichten
Meine Werkzeuge

Contao Community Documentation

noch 4 mal das Wort Abstraktion und ich beginne Zigaretten zu rauchen...

Martin Mildner
Navigation
Verstehen
Verwenden
Entwickeln
Verschiedenes
Werkzeuge