Insert-Tags

Aus Contao Community Documentation

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

IRC -> einziger fortlaufend sich selbst aktualisierender Comic.

Tristan Lins
Navigation
Verstehen
Verwenden
Entwickeln
Verschiedenes
Werkzeuge