Version vom 15. Februar 2012, 13:56 Uhr

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

Insert-Tag Beschreibung

• {{link::*}} Dieses Tag wird mit einem Link zu einer interne Seite ersetzt (ersetzen Sie * mit der ID oder dem Alias).
• {{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.

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

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.