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}}.

Liste der Insert-Tags

Link-Elemente

Benutzereigenschaften

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

Umgebungsvariablen

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

Insert-Tag Beschreibung

• {{env::page_id}} Dieses Tag wird mit der ID der aktuellen Seite ersetzt.
• {{env::page_alias}} Dieses Tag wird mit dem Alias der aktuellen Seite ersetzt.
• {{env::page_name}} Dieses Tag wird mit dem Namen der aktuellen Seite ersetzt.
• {{env::page_title}} Dieses Tag wird mit dem Titel der aktuellen Seite ersetzt.
• {{env::page_language}} Dieses Tag wird mit der Sprache der aktuellen Seite ersetzt.
• {{env::parent_alias}} Dieses Tag wird mit dem Alias der übergeordneten Seite ersetzt.
• {{env::parent_name}} Dieses Tag wird mit dem Namen der übergeordneten Seite ersetzt.
• {{env::parent_title}} Dieses Tag wird mit dem Titel der übergeordneten Seite ersetzt.
• {{env::main_alias}} Dieses Tag wird mit dem Alias der übergeordneten Hauptseite ersetzt.
• {{env::main_name}} Dieses Tag wird mit dem Namen der übergeordneten Hauptseite ersetzt.
• {{env::main_title}} Dieses Tag wird mit dem Titel der übergeordneten Hauptseite ersetzt.
• {{env::website_title}} Dieses Tag wird mit dem Titel der Webseite ersetzt.
• {{env::host}} Dieses Tag wird mit dem aktuellen Hostnamen ersetzt. Hinzugefügt in Version 2.9.0.
• {{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.

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).

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

• {{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.
• {{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")
• {{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.

Eigene Insert-Tags erstellen

Darüber hinaus gibt es Möglichkeiten, um eigene Insert-Tags zu erstellen Siehe auch:(siehe auch Eigene_insert_tags_erstellen).