Insert-Tags

Aus Contao Community Documentation

MsgError.png Unvollständiger Artikel: dieser Artikel ist noch nicht sauber bearbeitet.

Bitte erweitere ihn und entferne erst anschliessend diesen Hinweis.


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

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::*}} ??? 2.11
{{email_url::*}} ??? 2.11
{{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{{abbr}} wird ersetzt mit <nowili>Programme for International Student Assessment</nowiki>. 2.9.2

Weitere Inserttags

  • {{env::ua}} - liefert den Usergent zurück
  • {{env::plugins_url}} - liefert TL_PLUGINS_URL;
  • {{env::script_url}} - liefert TL_SCRIPT_URL;
  • {{env::files_url}} - liefert TL_FILES_URL;
  • {{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
  • {{calendar_feed::xx}} - Kalender-Feed
  • {{news_feed::xx}} - News-Feed

Inserttags in Templates verwenden

Hinweiß: 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 werden. ?>

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.

Ansichten
Meine Werkzeuge

Contao Community Documentation

Nur weil es bei Nachbarseite XYZ was gibt, wird automatisch oft davon ausgegangen, dass das fertige Bauteil einsatzbereit auf der Straße liegt.

Marie Dietz
Navigation
Verstehen
Verwenden
Entwickeln
Verschiedenes
Werkzeuge