Insert-Tags
Aus Contao Community Documentation
Version vom 6. Mai 2015, 14:25 Uhr von BugBuster (Diskussion | Beiträge)
| betrifft | |
|---|---|
| Contao Version | Alle Versionen |
Inhaltsverzeichnis
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: 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: 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:
| |||||
| {{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: 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.
