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

ich werde mir ein Aquarium kaufen...mit lauter Blowfishen..und die nenne ich dann bcrypt, sha1 und md5.

Leo Unglaub
Navigation
Verstehen
Verwenden
Entwickeln
Verschiedenes
Werkzeuge