Insert-Tags: Unterschied zwischen den Versionen
Aus Contao Community Documentation
Lucina (Diskussion | Beiträge) (→Benutzereigenschaften) |
Lucina (Diskussion | Beiträge) (→Benutzereigenschaften) |
||
| Zeile 95: | Zeile 95: | ||
| <nowiki>{{user::username}}</nowiki> || Dieses Tag wird mit dem Benutzernamen des angemeldeten Benutzers ersetzt. | | <nowiki>{{user::username}}</nowiki> || Dieses Tag wird mit dem Benutzernamen des angemeldeten Benutzers ersetzt. | ||
| colspan="2" | | | colspan="2" | | ||
| + | |} | ||
=== Umgebungsvariablen === | === Umgebungsvariablen === | ||
Version vom 15. Februar 2012, 14:23 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).
