Insert-Tags: Unterschied zwischen den Versionen
Aus Contao Community Documentation
Lucina (Diskussion | Beiträge) (→Benutzereigenschaften) |
Lucina (Diskussion | Beiträge) (→Umgebungsvariablen) |
||
Zeile 101: | Zeile 101: | ||
Mit den folgenden Inserttags können Umgebungsvariablen wie z.B. der Seitenname oder der Request-String ausgegeben werden. | Mit den folgenden Inserttags können Umgebungsvariablen wie z.B. der Seitenname oder der Request-String ausgegeben werden. | ||
− | Insert-Tag Beschreibung | + | {| border="0" cellspacing="1" cellpadding="2" |
− | + | ! Insert-Tag !! Beschreibung | |
− | + | |- | |
− | + | | <nowiki>{{env::page_id}}</nowiki> || Dieses Tag wird mit der ID der aktuellen Seite ersetzt. | |
− | + | |- | |
− | + | | <nowiki>{{env::page_alias}}</nowiki> || Dieses Tag wird mit dem Alias der aktuellen Seite ersetzt. | |
− | + | |- | |
− | + | | <nowiki>{{env::page_name}}</nowiki> || Dieses Tag wird mit dem Namen der aktuellen Seite ersetzt. | |
− | + | |- | |
− | + | | <nowiki>{{env::page_title}}</nowiki> || Dieses Tag wird mit dem Titel der aktuellen Seite ersetzt. | |
− | + | |- | |
− | + | | <nowiki>{{env::page_language}}</nowiki> || Dieses Tag wird mit der Sprache der aktuellen Seite ersetzt. | |
− | + | |- | |
− | + | | <nowiki>{{env::parent_alias}}</nowiki> || Dieses Tag wird mit dem Alias der übergeordneten Seite ersetzt. | |
− | + | |- | |
− | + | | <nowiki>{{env::parent_name}}</nowiki> || Dieses Tag wird mit dem Namen der übergeordneten Seite ersetzt. | |
− | + | |- | |
− | + | | <nowiki>{{env::parent_title}}</nowiki> || Dieses Tag wird mit dem Titel der übergeordneten Seite ersetzt. | |
− | + | |- | |
− | + | | <nowiki>{{env::main_alias}}</nowiki> || Dieses Tag wird mit dem Alias der übergeordneten Hauptseite ersetzt. | |
+ | |- | ||
+ | | <nowiki>{{env::main_name}}</nowiki> || Dieses Tag wird mit dem Namen der übergeordneten Hauptseite ersetzt. | ||
+ | |- | ||
+ | | <nowiki>{{env::main_title}}</nowiki> || Dieses Tag wird mit dem Titel der übergeordneten Hauptseite ersetzt. | ||
+ | |- | ||
+ | | <nowiki>{{env::website_title}}</nowiki> || Dieses Tag wird mit dem Titel der Webseite ersetzt. | ||
+ | |- | ||
+ | | <nowiki>{{env::host}}</nowiki> || Dieses Tag wird mit dem aktuellen Hostnamen ersetzt. Hinzugefügt in Version 2.9.0. | ||
+ | |- | ||
+ | | <nowiki>{{env::url}}</nowiki> || Dieses Tag wird mit dem Hostnamen und dem Protokoll ersetzt. | ||
+ | |- | ||
+ | | <nowiki>{{env::path}}</nowiki> || Dieses Tag wird mit der aktuellen Basis-URL samt Pfad zum Contao-Verzeichnis ersetzt. | ||
+ | |- | ||
+ | | <nowiki>{{env::request}}</nowiki> || Dieses Tag wird mit dem aktuellen Request-String ersetzt. | ||
+ | |- | ||
+ | | <nowiki>{{env::referer}}</nowiki> || Dieses Tag wird mit der URL der zuletzt besuchten Seite ersetzt. | ||
+ | |- | ||
+ | | <nowiki>{{env::ip}}</nowiki> || Dieses Tag wird mit der IP-Adresse des aktuellen Besuchers ersetzt. | ||
+ | |- | ||
+ | | colspan="2" | | ||
+ | |} | ||
=== Include-Elemente === | === Include-Elemente === |
Version vom 15. Februar 2012, 14:27 Uhr
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}}.
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}}
- {{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).