Insert-Tags: Unterschied zwischen den Versionen
Aus Contao Community Documentation
Lucina (Diskussion | Beiträge) (→Include-Elemente) |
Lucina (Diskussion | Beiträge) (→Link-Elemente) |
||
Zeile 12: | Zeile 12: | ||
=== Link-Elemente === | === Link-Elemente === | ||
− | Insert-Tag Beschreibung | + | {| border="0" cellspacing="1" cellpadding="2" |
− | + | ! Insert-Tag !! Beschreibung | |
− | + | |- | |
− | + | | <nowiki>{{link::*}}</nowiki> || Dieses Tag wird mit einem Link zu einer interne Seite ersetzt (ersetzen Sie * mit der ID oder dem Alias). | |
− | + | |- | |
− | + | |<nowiki>{{link::back}}</nowiki> || Dieses Tag wird mit der zuletzt besuchte Seite ersetzt. Kann auch mit link_open, link_url und link_title verwendet werden. | |
− | + | |- | |
− | + | |<nowiki>{{link::login}}</nowiki> || Dieses Tag wird mit einem Link zur Anmeldeseite des aktuellen Frontend-Benutzers (falls vorhanden) ersetzt. | |
− | + | |- | |
− | + | |<nowiki>{{link_open::*}}</nowiki> || Wird mit dem öffnenden Tag eines Links zu einer internen Seite ersetzt: <nowiki>{{link_open::12}}</nowiki>Click here<nowiki>{{link_close}}</nowiki>. | |
− | + | |- | |
− | + | |<nowiki>{{link_url::*}}</nowiki> || Dieses Tag wird mit der URL einer internen Seite ersetzt: <nowiki><a href="{{link_url::12}}">Click here</a>.</nowiki> | |
− | + | |- | |
− | + | |<nowiki>{{link_title::*}}</nowiki> || Dieses Tag wird mit dem Titel einer internen Seite ersetzt: <nowiki><a title="{{link_title::12}}">Click here</a></nowiki>. | |
− | + | |- | |
− | + | |<nowiki>{{article::*}}</nowiki> || Dieses Tag wird mit einem Link zu einem Artikel ersetzt (ersetzen Sie * mit der ID oder dem Alias). | |
− | + | |- | |
− | + | |<nowiki>{{article_open::*}}</nowiki> || Wird mit dem öffnenden Tag eines Links zu einem Artikel ersetzt: <nowiki>{{article_open::12}}Click here{{link_close}}.</nowiki> | |
− | + | |- | |
− | + | |<nowiki>{{article_url::*}}</nowiki> || Dieses Tag wird mit der URL eines Artikels ersetzt: <nowiki><a href="{{article_url::12}}">Click here</a></nowiki>. | |
− | + | |- | |
− | + | |<nowiki>{{article_title::*}}</nowiki> || Dieses Tag wird mit dem Titel eines Artikels ersetzt: <nowiki><a title="{{article_title::12}}">Click here</a></nowiki>. | |
− | + | |- | |
− | + | |<nowiki>{{news::*}}</nowiki> || Dieses Tag wird mit einem Link zu einer Nachricht ersetzt (ersetzen Sie * mit der ID oder dem Alias). | |
+ | |- | ||
+ | |<nowiki>{{news_open::*}}</nowiki> || Wird mit dem öffnenden Tag eines Links zu einer Nachricht ersetzt: <nowiki>{{news_open::12}}Click here{{link_close}}</nowiki>. | ||
+ | |- | ||
+ | |<nowiki>{{news_url::*}}</nowiki> || Dieses Tag wird mit der URL einer Nachricht ersetzt: <nowiki><a href="{{news_url::12}}">Click here</a></nowiki>. | ||
+ | |- | ||
+ | |<nowiki>{{news_title::*}}</nowiki> || Dieses Tag wird mit dem Titel einer Nachricht ersetzt: <nowiki><a title="{{news_title::12}}">Click here</a></nowiki>. | ||
+ | |- | ||
+ | |<nowiki>{{event::*}}</nowiki> || Dieses Tag wird mit einem Link zu einem Event ersetzt (ersetzen Sie * mit der ID oder dem Alias). | ||
+ | |- | ||
+ | |<nowiki>{{event_open::*}}</nowiki> || Wird mit dem öffnenden Tag eines Links zu einem Event ersetzt: <nowiki>{{event_open::12}}Click here{{link_close}}</nowiki>. | ||
+ | |- | ||
+ | |<nowiki>{{event_url::*}}</nowiki> || Dieses Tag wird mit der URL eines Events ersetzt: <nowiki><a href="{{event_url::12}}">Click here</a></nowiki>. | ||
+ | |- | ||
+ | |<nowiki>{{event_title::*}}</nowiki> || Dieses Tag wird mit dem Titel eines Events ersetzt: <nowiki><a title="{{event_title::12}}">Click here</a></nowiki>. | ||
+ | |- | ||
+ | |<nowiki>{{faq::*}}</nowiki> || Dieses Tag wird mit einem Link zu einer häufig gestellten Frage ersetzt (ersetzen Sie * mit der ID oder dem Alias). | ||
+ | |- | ||
+ | |<nowiki>{{faq_open::*}}</nowiki> || Wird mit dem öffnenden Tag eines Links zu einer Frage ersetzt: <nowiki>{{faq_open::12}}Click here{{link_close}}</nowiki>. | ||
+ | |- | ||
+ | |<nowiki>{{faq_url::*}}</nowiki> || Dieses Tag wird mit der URL einer Frage ersetzt: <nowiki><a href="{{faq_url::12}}">Click here</a></nowiki>. | ||
+ | |- | ||
+ | |<nowiki>{{faq_title::*}}</nowiki> || Dieses Tag wird mit dem Titel einer Frage ersetzt: <nowiki><a title="{{faq_title::12}}">Click here</a>.</nowiki> | ||
+ | |- | ||
+ | | colspan="2" | | ||
+ | |} | ||
=== Benutzereigenschaften === | === Benutzereigenschaften === |
Version vom 15. Februar 2012, 14:19 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).