Contao Community Documentation - Benutzerbeiträge [de]

Code Styleguide

2013-05-26T10:23:15Z

Babelfisch: /* Dateinamen */ Klassennamen in UpperCamelCase, Objekte dann ggf. in LowerCamelCase

{{stub}}
[[en:Code_Styleguide]]

Diese Seite soll einen allgemeinen Styleguide für Entwicklung von Contao Extensions darstellen.
Die hier gemachten Angaben entstanden aus der Auswertung des Contao Core, erheben jedoch keinen Anspruch auf Vollständigkeit, Richtigkeit oder gar Übereinstimmung mit den Ansichten des Core Entwicklers Leo Feyer.

==Dateien==
===Dateinamen===
In jeder Datei sollte nur eine Klasse enthalten sein. Ausgenommen sind Hilfsklassen, die nur von der einen Klasse aufgerufen werden, oder deren Aufruf die Einbindung der einen Klasse voraussetzt (siehe [[Database]], [[Database_Statement]], [[Database_Result]]).

Der Dateiname muss, damit die Klasse automatisch geladen werden kann (siehe [[Autoloader]]), gleich wie der Klassenname sein. Gross- und Kleinschreibung muss beachtet werden, da ansonsten auf Unix-/Linux-Servern die Klasse nicht gefunden werden kann.

Der Klassenname sollte, sofern er aus mehreren Worten besteht, in [[w:de:CamelCase|UpperCamelCase]] geschrieben werden.

===Header===
In jeder Datei sollte oben ein Header enthalten sein, welcher mindestens folgende Informationen beinhalten sollte:
* die Lizenz, unter deren der Code veröffentlicht wurde.
* der Name des Autors.
* ggf. der Name der Firma, für welche der Code geschrieben wurde und deren geistiges Eigentum er somit ist.
* das Paket, zu welchem die Datei gehört.

Diese Informationen sollten bestenfalls in [[w:de:PhpDocumentor|PhpDocumentor Notation]] vorgenommen werden.
Beispiel:

<source lang="php">
/**
* Contao Open Source CMS
* Copyright (C) 2005-2010 Leo Feyer
*
* Formerly known as TYPOlight Open Source CMS.
*
* This program is free software: you can redistribute it and/or
* modify it under the terms of the GNU Lesser General Public
* License as published by the Free Software Foundation, either
* version 3 of the License, or (at your option) any later version.
*
* This program is distributed in the hope that it will be useful,
* but WITHOUT ANY WARRANTY; without even the implied warranty of
* MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
* Lesser General Public License for more details.
*
* You should have received a copy of the GNU Lesser General Public
* License along with this program. If not, please visit the Free
* Software Foundation website at <http://www.gnu.org/licenses/>.
*
* PHP version 5
* @copyright Some Company 2010
* @author Max Mustercoder <mustercoder@somedomain.tld>
* @package RealCoolExtension
* @license http://opensource.org/licenses/lgpl-3.0.html
*/
</source>

==Code==

===Einrückung===
In Contao werden zum Einrücken von Code in der Regel normale TABulatoren (ASCII 0x09) und keine Leerzeichen verwendet. Eine Ausnahme hiervon stellen Einrückungen von zwei bis drei Leerzeichen dar, welche zur Formatierung von beispielsweise Datenbankabfragen eingefügt werden können.

===Klammerung, Leerzeichen und Kommata===
In Contao werden geschweifte Klammern grundsätzlich auf eine neue Zeile geschoben. Nach öffnenden und vor schließenden runden Klammern wird kein Leerzeichen geschrieben. Nach einem Komma und Schleifen-Schlüsselwörtern (if, while, for, foreach) wird ein Leerzeichen eingefügt.

Beispiel:

<source lang="php">
public function somefunction($param)
{
if ($param=='foo')
{
// do something
}
else
{
// do something else
}
}
</source>

===Leerzeilen===
Leerzeilen sollten verwendet werden um logische Codeabschnitte zu gruppieren. Leerzeilen sollten von allen Tabulator- und Leerzeichen bereinigt werden und wirkliche Leerzeilen sein.

Nach einer Funktion (bzw. Methode) sollten zwei Leerzeilen folgen, nach einer Objekt-Variable jeweils eine Leerzeile.

===Zeilenlänge===
Abweichend vom Contao Core sollte Code in Erweiterungen so geschrieben werden, dass er möglichst auf einen Blick sichtbar und damit wartbar ist, insbesondere sollte es nur in Ausnahmefällen nötig sein, horizontal zu rollen. Eine feste Maximal-Breite kann nicht sinnvoll definiert werden, weil das von zu vielen Dingen abhängt (verfügbare Pixel des Bildschirms, Größe der Schrift, Komplexität und Einrücktiefe des Codes). Dennoch kann man sich an der Lesbarkeit/Erfassbarkeit für Menschen orientieren (60-80 Zeichen/Zeile). Das ist verflixt wenig ... und kann nicht immer eingehalten werden. Jedoch erlauben sowohl PHP wie auch SQL Zeilen-Umbrüche, so dass man z.B. ein komplexes IF Statement auf mehrere kurze Zeilen verteilen kann (Beispiel folgt). Bei SQL Statements (im Core durchgängig auf einer Zeile mit teilweise mehreren hundert Zeichen) kann man den Query-String ohne weiteres auf mehrere Zeilen verteilen und damit erheblich leichter verständlich machen ... die Klasse "Database" bzw. die DB räumt überflüssige Leerzeichen automatisch auf. Beispiel:

<source lang="sql">
SELECT exp.*,
cty.city AS city_name
FROM tl_immo_expose AS exp,
tl_immo_city AS cty
WHERE exp.city = cty.id
AND object_category = ?
AND object_status = ?
AND object_type LIKE ?
AND cty.city LIKE ?
ORDER BY rooms ASC,
stories ASC
</source>

ist lesbar und halbwegs nachvollziehbar, jedoch das gleiche Statement auf einer einzigen Zeile (mit mehr als 220 Zeichen) ist nicht mehr wartbar:

<source lang="sql">
SELECT exp.*,cty.city AS city_name FROM tl_immo_expose AS exp,tl_immo_city AS cty WHERE exp.city = cty.id AND object_category = ? AND object_status = ? AND object_type LIKE ? AND cty.city LIKE ? ORDER BY rooms ASC,stories ASC
</source>

Diskussion:Domainweiterleitungen / Domainaliase

2012-04-04T12:16:39Z

Babelfisch: /* RewriteRule ^(.*)$ */

== RewriteRule ^(.*)$ ==
Ich hab das wieder geändert
RewriteRule ^(.*) http://example.org/$1 [L,R=301]
Da es so funktioniert und sich bewährt hat.
Bitte überprüfen und bestätigen, ob es mit
RewriteRule ^(.*)$ http://example.org/$1 [L,R=301]
funktioniert. example.net/seite.html muss auch an example.org/seite.html weitergeleitet werden. -- 19:04, 1. Apr. 2012 Andreas

:Natürlich funktioniert die Änderung von mir (sonst hätte ich sie nicht gemacht :). In regulären Ausdrücken steht ^ für den Anfang der Zeile und $ für das Ende. ^(.*)$ fasst also immer die komplette Zeile. ^(.*) funktioniert in Apache zwar auch, weil dort ''greedy'' (gierig) gesucht wird aber sicherer ist es, gleich den richtigen Ausdruck zu schreiben. --[[Benutzer:Babelfisch|Babelfisch]] 10:04, 3. Apr. 2012 (CEST)

Ich hab's jetzt wieder geändert. Hast du es auch getestet mit einer Seite? -- 14:42, 3. Apr. 2012 Andreas
:Ich nutze diese Schreibweise überall und du findest sie auch in der .htaccess.default von Contao. --[[Benutzer:Babelfisch|Babelfisch]] 14:16, 4. Apr. 2012 (CEST)

Diskussion:Domainweiterleitungen / Domainaliase

2012-04-03T08:05:51Z

Babelfisch:

Diskussion:Domainweiterleitungen / Domainaliase

2012-04-03T08:04:37Z

Babelfisch: /* RewriteRule ^(.*)$ */ Antwort

Domainweiterleitungen / Domainaliase

2012-03-31T08:53:51Z

Babelfisch: /* Domainweiterleitungen / Domainaliase */

{{AppliesTo
|Version=Alle Versionen}}
{{stub}}
[[Category:Erste Schritte]]
=Domainweiterleitungen / Domainaliase=
Hat man mehrere Domains für seinen Internetauftritt erworben, so möchte man, dass in der Browser-Adressleiste immer nur eine, die Hauptdomain, angezeigt wird. Das ist auch zu empfehlen, da gleiche Inhalte nicht unter verschiedenen Adressen veröffentlicht werden sollen.

Als Beispiel befinden sich folgende Domains in ihrem Besitz:
* example.org
* example.com
* example.net

Der Internetauftritt soll jedoch nur unter example.org laufen.

Bei seinem Provider schaut man im Server-Setup nach einer Möglichkeit um die Domains example.com und example.net als Weiterleitungen auf die Domain example.org einzurichten. Achtung, nicht einfach diese Domains auch in den Ordner leiten, in welchem Contao installiert ist, sondern wirklich eine Weiterleitung direkt auf die Hauptdomain setzen.

Auch die Subdomains www.example.org, www.example.com und www.example.net als Weiterleitungen auf die Hauptdomain einrichten. Bei einigen Providern muss man diese Subdomains vorher anlegen. Das ist zu empfehlen, da einige User immer noch den Prefix www. vor die eigentliche Domain setzen und sonst keine Seite geliefert bekämen.

Bei einigen Providern kann man für die Hauptdomain „Aliase“ anlegen. In dem Fall legt man die 5 zusätzlichen Domains als Aliase für die Hauptdomain an. Achtung, darauf achten, dass die Domains nicht in der Browser-Adresszeile stehen bleiben, dort muss die Hauptdomain erscheinen, auch wenn man eine Alias-Domain eingegeben hat. Sollte dies nicht der Fall sein, so unterstützt der Provider diese Art der Weiterleitung nicht. In diesem Fall richtet man die Weiterleitung in der .htaccess ein. Obiges Verfahren hat allerdings Priorität.

Für den Fall, dass man die Weiterleitung über die .htaccess steuern muss, ist in der .htaccess.default schon ein Code für die Weiterleitung vorbereitet aber durch die Rauten vor den Zeilen deaktiviert. Außerdem wird mit diesem Code die Domain auf die Subdomain weitergeleitet also umgekehrt.

<source lang="apache">
##
# Uncomment the following lines and replace "domain.com" with your domain
# name to redirect requests without "www" to the correct domain.
##
#RewriteCond %{HTTP_HOST} ^domain\.com [NC]
#RewriteRule (.*) http://www.domain.com/$1 [R=301,L]
</source>

Etwas einfacher ist folgendes Rewriting, da man hiermit bei dem Provider jederzeit Domains für den Auftritt hinzuordern kann, ohne noch einmal die .htaccess verändern zu müssen. Hiermit wird dann auch von den Subdomains auf die Domain weitergeleitet.

<source lang="apache">
##
# Leite alle Anfragen, die in diesem Ordner ankommen und bei denen der Host nicht mit
# "example.org" beginnt und nicht leer ist auf http://example.org" um.
# Ausnahmen sind 127.0.0.1 und localhost für die Bearbeitung auf einem lokalen Server.
# Diese Lösung ist einfacher als obige, da man so weitere Domains als Aliase für
# diese Internet-Präsenz hinzuordern kann, ohne hier noch einmal Änderungen vorzunehmen.
# Das Ausrufezeichen '!' bedeutet 'nicht'.
# Optimal wäre allerdings, wenn der Provider die Möglichkeit bietet direkt im Server-Setup
# diese Weiterleitungen zu setzen. Damit sind keine Weiterleitung in einen Ordner, sondern
# Weiterleitungen direkt auf die Hauptdomain gemeint.
##
RewriteCond %{HTTP_HOST} !^127\.0\.0\.1
RewriteCond %{HTTP_HOST} !^localhost [NC]
RewriteCond %{HTTP_HOST} !^example\.org [NC]
RewriteCond %{HTTP_HOST} !^$
RewriteRule ^(.*)$ http://example.org/$1 [L,R=301]
</source>

Benutzer:Babelfisch

2012-03-13T16:39:28Z

Babelfisch: Die Seite wurde neu angelegt: „Name: Mario Müller Contao-Erweiterung unter: https://github.com/4t2“

Name: Mario Müller

Contao-Erweiterung unter: https://github.com/4t2

Diskussion:Einfaches Gästebuch

2012-03-13T14:44:06Z

Babelfisch: /* Änderungen an fremden Texten */

==Änderungen an fremden Texten==
Texte in Erstellung redigieren zu wollen, halte ich für wenig zielführen.
Typos korrigieren gerne.
Ungefragt Sätze umstellen und ändern, nur weil einem der eigene Schreibstil besser gefällt, halte ich für sehr fraglich und außerdem wenig motivierend. Die dafür aufgewendete Zeit kann sinnvoller in neue Artikel investiert werden. --[[Benutzer:Rost|Rost]] 17:24, 12. Mär. 2012 (CET)
:Die Änderungen von Lucina waren doch absolut in Ordnung und du solltest dich eher dafür bedanken, dass jemand deine Arbeit an dem Artikel unterstützt. Bedenke bitte auch, dass dies ein Wiki ist und es hier keine ''fremden'' Texte gibt. Jeder kann hier mitarbeiten und solange Änderungen zu Verbesserungen führen, gibt es auch keinen Grund, sich darüber zu beschweren. --[[Benutzer:Babelfisch|›<°‹‹‹<]] 00:30, 13. Mär. 2012 (CET)

----
Sorry, ich hatte das für einen Darstellungsfehler gehalten - im Übrigen ist sollte das keine Signatur sein sondern der lesbare Link / Titel auf die persönliche Seite (seufz) ... ;-)
--[[Benutzer:Lucina|Lucina]] 15:29, 13. Mär. 2012 (CET)
:Den Text der Signatur kann man in den Einstellungen frei vergeben und (zumindest in der Wikipedia) ist es auch nicht unüblich, dort etwas ausgefallene ASCII „Art“ (soll eine Art Fisch sein :) zu verwenden. Schließlich ist das ja nur für Diskussionen und da erkennt man auch so, wer mit wem diskutiert. Sollte es hier aber andere Regeln geben, ändere ich es gerne aber ein entsprechender Hinweise wäre dann ganz hilfreich. --[[Benutzer:Babelfisch|›<°‹‹‹<]] 15:44, 13. Mär. 2012 (CET)

Diskussion:Einfaches Gästebuch

2012-03-13T13:27:34Z

Babelfisch: Änderung 5094 von Lucina (Diskussion) wurde rückgängig gemacht. Meine Signatur darf ich mir doch bitte selber aussuchen.

Diskussion:Einfaches Gästebuch

2012-03-12T23:30:29Z

Babelfisch: /* Änderungen an fremden Texten */

Sitemap erstellen

2012-03-09T10:59:11Z

Babelfisch: H1 nur für Lemma-Title

[[Category:Admin_HOWTOS]]
Diese Anleitung befasst sich mit der Erstellung einer Sitemap in einer Contao-Installation. Auf die Formatierung der erstellten Sitemap wird bewusst verzichtet. Voraussetzung für diese Anleitung ist eine vorhandene [[Seitenstruktur]], eine [[ModulNavigation|Navigation]] und dass mehrere Seiten existieren. Für diese Anleitung bedarf es Zugang als Administrator zu der entsprechenden Contao-Installation. Zur besseren Nachvollziehbarkeit wird in dieser Anleitung mit der Beispiel-Website ''MusicAcademy'' gearbeitet.

==Sitemap-Modul hinzufügen==
Als erster Schritt muss ein Modul ''Sitemap'' erstellt werden. Dazu geht man im Backend unter ''Layout'' auf ''Themes'' (siehe auch [[Aktionsbereiche]]) und wechselt im Theme ''MusicAcademy'' in den Module-Manager.

[[Datei:sitemap_modulemanager.png|Modulemanager]]

Ein Klick auf den Button ''Neues Modul'' öffnet den bekannten Bearbeitungsbereich mit seinen Eingabefeldern und Drop-Down-Auswahlmenüs.

[[Datei:sitemap_newmodule.png|Neues Modul anlegen]]

Im Feld ''Titel'' gibt man z.B. Sitemap ein. Aus dem Drop-Down-Menü wählt man im Bereich Navigation den Modultyp ''Sitemap'' aus. Optional kann man dem Modul noch eine Überschrift hinzufügen.

[[Datei:sitemap_modulesettings-1.png|Modul Einstellungen 1]]

Das Auswahlfeld ''Wurzelseite als Startseite'' wählt man aus, wenn man für die Webseite keinen ''Startpunkt'' in der [[Seitenstruktur]] erstellt hat. Da man jedoch '''immer''' in der Seitenstruktur einen '''''Startpunkt einer Webseite''''' definieren sollte, sollte die Einstellung ''Wurzelverzeichnis'' nicht verwenden.

Referenzseite:
Sofern man einen Startpunkt für eine Webseite erstellt hat oder nur für einen Teil der Website die Sitemap will, klickt man hier ''Auswahl ändern'' und wählt aus der sich öffnenden Liste mit der Seitenstruktur die Startseite der Sitemap als Referenzseite aus. Diese Eingaben sind nur erforderlich, wenn man anstelle der Wurzelseite eine andere Seite als Startpunkt für die Sitemap wünscht. Für diese Anleitung wird diese Möglichkeit gewählt.

[[Datei:sitemap_modulesettings-2.png|Modul Einstellungen 2]]

Für das Modul Sitemap sind alle notwendigen Angaben und Einstellungen definiert, daher kann es abgespeichert werden.

==Seitenstruktur erweitern==
Als nächstes wird die Seitenstruktur um eine Seite ''Sitemap'' erweitert. Man wählt dazu aus dem Layout-Bereich den Punkt ''Seitenstruktur'' und fügt dann über ''Neue Seite'' eine neue Seite in die Struktur der Website ein. In diesem Beispiel soll die neue Seite in der Hauptebene unterhalb der Seite ''Services'' angezeigt werden.

[[Datei:sitemap_sitestructure.png|Seitenstruktur]]

Es öffnet sich der Bearbeitungsbereich zur Definition der neuen Seite. Folgende Eingaben sind zwingend/mindestens zu machen:

Eingabefeld ''Seitenname'': Hier definiert man, wie die Seite im Navigationsmenü erscheinen soll. Sinnigerweise benennt man die neue Seite ''Sitemap''.<br />
Eingabefeld ''Seitenalias'': Als eindeutige Referenz zur Umschreibung der ID in der URL zum Seitenaufruf definiert man hier z.B. ''sitemap''.<br />
Den Seitentyp belässt man bei ''Reguläre Seite''.

[[Datei:sitemap_sitesettings-1.png|Einstellungen der neuen Seite 1]]

Im Bereich ''Veröffentlichung'' aktiviert man das Häkchen ''Seite veröffentlichen'', damit die Seite später im Frontend angezeigt wird. Alle anderen Eingabefelder sind selbsterklärend und für die grundsätzliche Funktion nicht zwingend notwendig, weshalb sie hier nicht weiter besprochen werden sollen. Die Eingabe schließt man nun mit einem Klick auf "Speichern und schließen" ab.

[[Datei:sitemap_sitesettings-2.png|Einstellungen der neuen Seite 2]]

==Neuen Artikel erstellen==
Um die Sitemap in Frontend anzuzeigen, fügt man das Modul nun noch dem Artikel in der Seite ''Sitemap'' hinzu.

Man wählt aus den Backend-Modulen im Inhaltsmodul den Eintrag ''Artikel''. Es öffnet sich die Liste der bereits erstellten Seiten und Artikel. Seit Contao 2.9 wird, sobald man eine neue Seite anlegt, ein dazu gehöriger Artikel angelegt. Dieser muss nun bearbeitet werden. Dazu klickt man mit der rechten Maustaste auf das Bearbeiten-Symbol (Bleistift) des entsprechenden Artikels und im sich öffnenden Popup wählt man ''Artikel-Einstellungen bearbeiten''.

[[Datei:sitemap_article.png|Artikel bearbeiten]]

Für den Artikel definiert man die folgenden Einträge in dem sich öffnenden Arbeitsbereich:

Eingabefeld ''Titel'': Man wählt z.B. ''Sitemap'' als Titel des Artikels.<br />
Eingabefeld ''Artikelalias'': Hier schreibt man z.B. 'sitemap'<br />
Außerdem muss man die Option ''Veröffentlicht'' wählen, damit die Sitemap später angezeigt werden kann. Auch diese Eingaben schließt man mit ''Speichern und schließen'' wie gewohnt ab.

[[Datei:sitemap_articlesetting.png|Artikel Einstellungen]]

==Sitemap einbinden==
Wenn man sich das bisher Erstellte in der Frontend-Vorschau anschaut, so gibt es einen Navigationsmenüeintrag und eine Seite mit der Sitemap. Leider noch ohne Sitemap! Als nächstes bindet man nun das Sitemap-Modul in die Seite ein, damit das Modul beim Seitenaufruf die gewünschten Inhalte generieren kann.

So wie vorhin klickt man mit der rechten Maustaste auf das Bearbeiten-Symbol; nur wählt man jetzt ''Artikel bearbeiten''. Es öffnet sich der Bearbeitungsbereich für den Artikel. Mit einen Klick auf ''Neues Element'' und anschließend das Pfeil-Symbol, um das neue Element zu positionieren, wird das Element am Seitenanfang des Artikels eingefügt.

[[Datei:sitemap_articleedit.png|Artikel Element einfügen]]

Es öffnet sich der Bearbeitungsbereich, in dem folgende Eingaben zu machen sind:

Drop-Down-Auswahl ''Elementtyp'': Hierüber erstellt man jetzt die Verbindung zur Sitemap. Dazu wählt man am Ende der Liste aus den Include-Elementen den Eintrag ''Modul''. Der geänderte Bearbeitungsbereich zeigt nun eine Liste aller Module in der Webseite. Hier wählt man das Modul ''Sitemap''. Die Eingabe schließt man mit "Speichern und schließen" ab.

[[Datei:sitemap_cesetting.png|Content Element Einstellungen]]

Der Artikel ist nun um einen Moduleintrag erweitert, der als Inhalt eine Zeile mit dem Text: '### SITEMAP ###' enthält.

[[Datei:sitemap_articlecontent.png|Artikel Inhalt]]

==Die fertige Sitemap==
Die fertige Sitemap kann man nun in der Frontend-Vorschau betrachten.

[[Datei:sitemap_frontend.png|Fertige Sitemap im Frontend]]

Hauptseite

2012-03-07T09:09:47Z

Babelfisch: doppelten Absatz raus und Link zur Anmeldeseite hinzugefügt

[[en:Main Page]]
[[pt:Página_principal]]
{| border="0" cellpadding="0" cellspacing="20" id="front-page-table"
|-
|[[Datei:Einsteiger.png|60px|verweis=Einsteiger|Neu hier?]]
|<h3>Neu hier?</h3>
<p>[[Einsteiger|In diesem Bereich]] findest du alle grundlegenden Informationen zu Contao, seiner Entstehung, der Zukunftsentwicklung und ob „contao“ nun was zu Essen ist oder nicht? ;)</p>
|-
|[[Datei:Installation.png|60px|verweis=Installation|Contao installieren]]
|<h3>Installation</h3>
<p>Wie installiere ich Contao? Was ist der „Safe-Mode-Hack“? Und warum ist es eine gute Idee, sich bei der Provider-Wahl etwas Zeit zu nehmen?</p>
<p>In diesem Bereich findest du alle Informationen zur [[Installation|Installation von Contao]]!</p>
|-
|[[Datei:Erste Schritte.png|60px|verweis=:Kategorie:Erste Schritte|Erstkonfiguration nach der Installation]]
|<h3>Erste Schritte</h3>
<p>Wie konfiguriere ich Contao? Welche Module kann ich benutzen? Und wie funktioniert der Katalog?</p>
<p>Die [[:Kategorie:Erste Schritte|ersten Schritte]] liefern dir alle Informationen und helfen dir dabei Contao zu konfigurieren.</p>
|-
|[[Datei:Contao_Fanpage_Web-small.png|60px|verweis=ccdde:Portal|Contao Community Documentation Portal]]
|<p>Ziel des „Contao Community Documentation“ Projektes ist es, Anwendern, Verwaltern und Entwicklern Informationen zum Content Management System Contao zur Verfügung zu stellen.</p>
<p>'''Das ganze Projekt lebt vor allem von der Mithilfe seiner User. Solltest du Lust haben, selbst mitzumachen, [[Spezial:Anmelden|melde dich an]] und dokumentiere mit.'''</p>
<p>Das '''ccd''' ist keine offizielle Seite des Contao Projekts, sondern von engagierten Anwendern derselbigen Software ins Leben gerufen worden.
Bitte meldet Fehler, Anmerkungen und grundsätzliches Gemecker an dieser Dokumentation daher nicht beim offiziellen Team von Contao sondern bei uns.
Das offizielle Team von Contao hat so schon genug zu tun. :)</p>
'''Komm doch zu uns in den [[Chat HowTo‎|Chat]] auf einen ungezwungenen und freundlichen Austausch zu Contao.'''
|-
|}

<div style="float:right;text-align:center;margin-bottom: 2em;">Dies ist eine<br/>[[Datei:Contao_Fanpage_Web.png|Contao unofficial fanpage]]<br/>[http://www.contao.org http://www.contao.org]</div>

Einsteiger

2012-03-06T23:06:13Z

Babelfisch: H1 Überschrift ist nur für das Lemma da

Im Folgenden bekommt man einen fundierten Überblick über die Hintergründe rund um Contao.<br>
Eine Anleitung zur Intallation ist hier zu finden:[[Installation]]<br>
Eine Übersicht der ersten Schritte im System findet man auf der Seite [[:Kategorie:Erste_Schritte]] oder man versucht sich direkt an [[Die_erste_Webseite|der ersten Seite]].

{{stub}}
[[en:Beginner]]

==Was ist Contao?==
===Entstehungsgeschichte===

Die Geschichte von Contao begann im Jahre 2006 unter dem Namen TYPOlight.

Seit dem Release 2.9 (2010) wird das Projekt unter dem Namen "Contao Open Source CMS" weiterentwickelt.

===Abgrenzungskriterien zu anderen CMS===

Contao verfolgt konsequent die Verwaltung der Inhalte nach einem Containerprinzip.

Die Hierarchie ist hierbei wie folgt: Seite => Artikel => Inhaltselement.

Somit liegen in den Webseiten in einzelnen Layout-Bereichen, wie z.B. "Hauptspalte", "linke Spalte" oder "rechte Spalte", Artikel. Diese Artikel stellen ihrerseits Container dar, in welchen dann die eigentlichen Inhaltselemente wie beispielsweise Texte und Bilder abgelegt werden.
Diese Art der Inhaltspflege ermöglicht es Einsteigern intuitiv mit dem System zu arbeiten.

==Was kann Contao?==

Contao ist ein Seiten basiertes Content Management System, welches schon in der Basisversion (core) das meiste mitbringt um einen ansprechenden Webauftritt zu erstellen. Mittlerweile gibt es viele Erweiterungen, mit denen das System so ausgebaut werden kann, dass es auch spezielle Anforderungen erfüllt. Kataloge, Online-Shops, Newslettersysteme und Google-Maps unterstützende Applikationen sind nur einen kleiner Bruchteil des vorhandenen Erweiterungskataloges.

Contao kann auch mit Multi-Domains umgehen. Das ist eine Installation für mehrere Domainnamen. Eine ausführlichere Liste gibt es hier: http://www.contao.org/funktionen.html

===Demo===
Eine Demo zum Reinschauen gibt es hier:

http://demo.contao.org/ > Frontend

http://demo.contao.org/contao/ >Backend

==Was braucht man für Contao?==

Die Systemvoraussetzungen findet man auf www.contao.org .
Eine genaue Liste gibt es hier : [http://www.contao.org/den-live-server-konfigurieren.html#requirements Anforderungsliste]

Wer gerne Lokal mit Contao die ersten Gehversuche machen will, kann dies auf eine einfache Weise mit [[Contao2Go]] machen. Bei diesem Lokalen Webserver der auf Server2Go basiert ist schon eine Fix-fertige Installation vorhanden. Genaues vorgehen findet man auf der Webseite von [http://www.Contao2Go.org Contao2Go].

==Was kostet Contao?==
Alle Informationen zu der Lizenz befinden sich auf der [http://www.contao.org/kommerzielle-lizenz.html Webseite des Projekts].

Kurz zusammengefasst:
* Contao ist '''KOSTENLOS''' (sowohl für den privaten als auch kommerziellen Einsatz)
* Contao ist unter der [https://secure.wikimedia.org/wikipedia/de/wiki/GNU_Lesser_General_Public_License Lizenz LGPL] veröffentlicht
* Die Copyright-Hinweise dürften nicht entfernt werden
* Eine kostenpflichtige Lizenz mit erweiterten Konditionen wird angeboten.

==Wer entwickelt Contao?==
Ein Entwickler- und Supportteam um den Erfinder und Hauptentwickler des Contao CMS Leo Freyer entwickelt das System ständig weiter. Alle Infos zum Team finden sich auf der [http://www.contao.org/das-team.html Webseite].

==Welche Voraussetzungen braucht man, um mit Contao arbeiten zu können?==
Für einen Administrator eines Contao-Systems sind Kenntnisse in der Auszeichnungssprache [[w:de:HTML|HTML]] und der Formatierungssprache [[w:de:Cascading_Style_Sheets|CSS]] erforderlich. Kenntnisse in der Scriptsprache [[w:de:PHP|PHP]] sind für die Modifikation und Erweiterung des Systems empfehlenswert.

==Wo bekommt man Hilfe?==
Wenn man Hilfe benötigt, gibt es verschiedene Anlaufstellen:
*Bücher über Contao: [http://www.contao-handbuch.de/contao-buecher.html Hier gibt es eine Übersicht von Contao-Büchern]
*Video-Tutorials: auf [http://www.youtube.com/results?search_query=contao Youtube] als auch als [http://www.contao-handbuch.de/contao-videos.html DVD]
*dieses Wiki ([http://www.contaowiki.org http://www.contaowiki.org]): stellt verschiedene detaillierte Anleitungen zu verschiedensten Bereichen zur Verfügung
*das (deutsche) Contao-Forum ([http://www.contao-community.de http://www.contao-community.de]): hier kann man auf eine sehr breite Basis von Fragen und Problemen zurückgreifen und eigene Probleme und Ideen ansprechen.
*Des weiteren gibt es noch die professionellen [http://www.contao.org/partner.html Contao-Partner], welche auf kommerzieller Ebene ihre Dienste anbieten.
*der [[Chat_HowTo|Contao-Chat]]

Stylesheet für Backend-Theme ergänzen

2012-03-06T23:02:49Z

Babelfisch: etwas umformuliert und Überschriften hinzugefügt

[[Kategorie:Admin_HOWTOS]]
[[Kategorie:CSS_HOWTOS]]
Wenn man die Darstellung des Contao-Backends nur leicht anpassen möchte, kann man das normale Backend-Theme mit einem zusätzlichen Stylesheet ergänzen. Der Vorteil dieser Lösung ist, dass man nichts an Templates ändern muss und es daher updatesicher ist.
{{Hinweis|Diese Lösung funktioniert erst ab Contao 2.10}}
==Das Stylesheet einbinden==

In der Datei ''system/config/dcaconfig.php'' (Datei anlegen, falls sie noch nicht existiert) wird dazu der folgende Code eingefügt:

<source lang="php">
if (TL_MODE == 'BE')
$GLOBALS['TL_CSS'][] = 'tl_files/backend/be.css|screen';
</source>

In der Dateiverwaltung legt man dann den Ordner ''backend'' an und erstellt die Datei ''be.css''.

Nun kann man die ''be.css'' bei Bedarf bearbeiten und dort Anweisungen reinschreiben, um per CSS bestimmte Teile des Backends anders darzustellen.

==Beispiel-Stylesheet==

So könnte man beispielsweise folgendes in das Stylesheet schreiben:

<source lang="css">
/* Grundfarben für Elemente dunkler - besserer Kontrast/Barrierefreiheit */
a, body, div, label, legend, li, ol, p, td, th, ul, fieldset, form, input, optgroup, select, textarea {
color: #333;
}

/* Links in der BE-Navigation auf voller Breite anklickbar */
#tl_navigation li a {
display: block;
}

/* Links in der BE-Navigation mit besserer Fokus/Hover-Markierung */
#tl_navigation a:link, #tl_navigation a:visited {
color: #333;
text-decoration: none;
}
#tl_navigation a:hover, #tl_navigation a:focus, #tl_navigation a:active {
color: #000;
text-decoration: underline;
}

/* Aktiver Punkt in BE-Navigation besser erkennbar */
#tl_navigation .tl_level_2 a.active { font-weight: bold; }

/* Hover/Fokus Markierung für Label, z. B. beim Auswaehlen von Labels bei den Definitionen der Benutzergruppen */
.tl_checkbox_container label:hover, .tl_checkbox_container label:focus {
color: #000 !important;
outline: 1px solid #465E22;
}

/* Verstaerkte Hover/Fokus Markierung für Listinganzeige */
.tl_listing tr:hover, .tl_listing tr:focus {
outline: 1px solid #465E22;
}

/* Verstaerkte Hover/Fokus Markierung für Icons in der Listinganzeige */
.tl_listing .tl_right a img:hover, .tl_listing .tl_right a img:focus {
outline: 1px solid #465E22;
}
</source>

Insert-Tags

2012-03-06T09:18:54Z

Babelfisch: Seit der 2.9 sind Insert-Tags in iflng möglich (siehe #1515).

{{stub}}
{{AppliesTo
|Version=Alle Versionen
}}
[[Category: Core]]
[[Category:Dev HOWTOS]]
= Insert-Tags =
Contao bietet die Möglichkeit, mittels so genannter Insert-Tags Inhalte oder Funktionen zu referenzieren.

Der Aufbau ist in der Regel <nowiki>{{Tagname::Argument}}</nowiki>.
{{Achtung|Eine Verschachtelung – also der Aufruf eines Insert-Tags innerhalb eines anderen – ist nur mit <nowiki>{{iflng::*}}</nowiki> möglich. Andere Insert-Tags können nicht verschachtelt werden.}}

== Liste der Insert-Tags ==
Die Liste stammt im Wesentlichen von [http://www.contao.org/typolight-insert-tags.html Contao.org]. Über die dort dokumentierten Insert-Tags hinaus gibt es weitere Insert-Tags. Bitte vervollständige die Liste.
=== Link-Elemente ===
{| 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 ===

Mit den folgenden Inserttags können Eigenschaften des angemeldeten Benutzers ausgebeben werden.

{| border="0" cellspacing="1" cellpadding="2"
! '''Insert-Tag''' !! '''Beschreibung'''
|-
| <nowiki>{{user::firstname}}</nowiki> ||Dieses Tag wird mit dem Vornamen des angemeldeten Benutzers ersetzt.
|-
| <nowiki>{{user::lastname}}</nowiki> || Dieses Tag wird mit dem Nachnamen des angemeldeten Benutzers ersetzt.
|-
| <nowiki>{{user::company}}</nowiki> || Dieses Tag wird mit dem Firmennamen des angemeldeten Benutzers ersetzt.
|-
| <nowiki>{{user::phone}}</nowiki> || Dieses Tag wird mit der Telefonnummer des angemeldeten Benutzers ersetzt.
|-
| <nowiki>{{user::mobile}}</nowiki> || Dieses Tag wird mit der Handynummer des angemeldeten Benutzers ersetzt.
|-
| <nowiki>{{user::fax}}</nowiki> || Dieses Tag wird mit der Faxnummer des angemeldeten Benutzers ersetzt.
|-
| <nowiki>{{user::email}}</nowiki> || Dieses Tag wird mit der E-Mail-Adresse des angemeldeten Benutzers ersetzt.
|-
| <nowiki>{{user::website}}</nowiki> || Dieses Tag wird mit der Internetadresse des angemeldeten Benutzers ersetzt.
|-
| <nowiki>{{user::street}}</nowiki> || Dieses Tag wird mit dem Staßennamen des angemeldeten Benutzers ersetzt.
|-
| <nowiki>{{user::postal}}</nowiki> || Dieses Tag wird mit der Postleitzahl des angemeldeten Benutzers ersetzt.
|-
| <nowiki>{{user::city}}</nowiki> || Dieses Tag wird mit der Stadt des angemeldeten Benutzers ersetzt.
|-
| <nowiki>{{user::country}}</nowiki> || Dieses Tag wird mit dem Land des angemeldeten Benutzers ersetzt.
|-
| <nowiki>{{user::username}}</nowiki> || Dieses Tag wird mit dem Benutzernamen des angemeldeten Benutzers ersetzt.
| colspan="2" |
|}

=== Umgebungsvariablen ===

Mit den folgenden Inserttags können Umgebungsvariablen wie z.B. der Seitenname oder der Request-String ausgegeben werden.

{| border="0" cellspacing="1" cellpadding="2"
! '''Insert-Tag''' !! '''Beschreibung''' !! '''ab Version''' || '''bis Version'''
|-
| <nowiki>{{env::page_id}}</nowiki> || Dieses Tag wird mit der ID der aktuellen Seite ersetzt. || || 2.10.x
|-
| <nowiki>{{env::page_alias}}</nowiki> || Dieses Tag wird mit dem Alias der aktuellen Seite ersetzt. || || 2.10.x
|-
| <nowiki>{{env::page_name}}</nowiki> || Dieses Tag wird mit dem Namen der aktuellen Seite ersetzt. || || 2.10.x
|-
| <nowiki>{{env::page_title}}</nowiki> || Dieses Tag wird mit dem Titel der aktuellen Seite ersetzt. || || 2.10.x
|-
| <nowiki>{{env::page_language}}</nowiki> || Dieses Tag wird mit der Sprache der aktuellen Seite ersetzt. || || 2.10.x
|-
| <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. || 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" |
|}

=== Seitenbezogene Inserttags===

Mit den folgenden Inserttags können Umgebungsvariablen wie z.B. der Seitenname.

{| border="0" cellspacing="1" cellpadding="2"
! '''Insert-Tag''' !! '''Beschreibung''' !! '''ab Version''' || '''bis Version'''
|-
| <nowiki>{{page::id}}</nowiki> || Dieses Tag wird mit der ID der aktuellen Seite ersetzt. || 2.11.x ||
|-
| <nowiki>{{page::alias}}</nowiki> || Dieses Tag wird mit dem Alias der aktuellen Seite ersetzt. || 2.11.x ||
|-
| <nowiki>{{page::title}}</nowiki> || Dieses Tag wird mit dem Namen der aktuellen Seite ersetzt. || 2.11.x ||
|-
| <nowiki>{{page::pageTitle}}</nowiki> || Dieses Tag wird mit dem Titel der aktuellen Seite ersetzt. || 2.11.x ||
|-
| <nowiki>{{page::language}}</nowiki> || Dieses Tag wird mit der Sprache der aktuellen Seite ersetzt. || 2.11.x ||
|-
| <nowiki>{{page::parentAlias}}</nowiki> || Dieses Tag wird mit dem Alias der übergeordneten Seite ersetzt. || 2.11.x ||
|-
| <nowiki>{{page::parentTitle}}</nowiki> || Dieses Tag wird mit dem Namen der übergeordneten Seite ersetzt. || 2.11.x ||
|-
| <nowiki>{{page::parentPageTitle}}</nowiki> || Dieses Tag wird mit dem Titel der übergeordneten Seite ersetzt. || 2.11.x||
|-
| <nowiki>{{page::mainAlias}}</nowiki> || Dieses Tag wird mit dem Alias der übergeordneten Hauptseite ersetzt. || 2.11.x ||
|-
| <nowiki>{{page::mainTitle}}</nowiki> || Dieses Tag wird mit dem Namen der übergeordneten Hauptseite ersetzt. || 2.11.x ||
|-
| <nowiki>{{page::mainPageTitle}}</nowiki> || Dieses Tag wird mit dem Titel der übergeordneten Hauptseite ersetzt. || 2.11.x ||
|-
| <nowiki>{{page::rootTitle}}</nowiki> || Dieses Tag wird mit dem Titel der Webseite ersetzt. || 2.11.x ||
|-
| colspan="2" |
|}

=== Include-Elemente ===

Mit den folgenden Inserttags können Ressourcen wie z.B. Artikel, Module oder Dateien aus dem templates-Verzeichnis eingebunden werden.

{| border="0" cellspacing="1" cellpadding="2"
! '''Insert-Tag''' !! '''Beschreibung'''
|-
| <nowiki>{{insert_article::*}}</nowiki> || Dieses Tag wird mit dem referenzierten Artikel ersetzt (ersetzen Sie * mit der ID oder dem Alias).
|-
| <nowiki>{{insert_content::*}}</nowiki> || Dieses Tag wird mit dem referenzierten Inhaltselement ersetzt (ersetzen Sie * mit der ID des Elements).
|-
| <nowiki>{{insert_module::*}}</nowiki> || Dieses Tag wird mit dem referenzierten Modul ersetzt (ersetzen Sie * mit der ID des Moduls).
|-
| <nowiki>{{article_teaser::*}}</nowiki> || Dieses Tag wird mit dem Teaser eines Artikels ersetzt (ersetzen Sie * mit der ID des Artikels).
|-
| <nowiki>{{news_teaser::*}}</nowiki> || Dieses Tag wird mit dem Teaser einer Nachricht ersetzt (ersetzen Sie * mit der ID der Nachricht).
|-
| <nowiki>{{event_teaser::*}}</nowiki> || Dieses Tag wird mit dem Teaser eines Events ersetzt (ersetzen Sie * mit der ID des Events).
|-
| <nowiki>{{file::*}}</nowiki> || 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: <nowiki>{{file::file.php?arg1=val&arg2=val}}</nowiki>
|-
| <nowiki>{{insert_form::*}}</nowiki> || Dieses Tag wird mit dem referenzierten Formular ersetzt (ersetzen Sie * mit der ID oder dem Alias).
|-
| colspan="2" |
|}

=== Verschiedenes ===

Mit den folgenden Inserttags können Sie verschiedene Aufgaben erledigen und z.B. das aktuelle Datum oder ein Lightbox-Bild einfügen.

{| border="0" cellspacing="1" cellpadding="2"
! '''Insert-Tag''' !! '''Beschreibung''' !! '''ab Version''' || '''bis Version'''
|-
| <nowiki>{{date}}</nowiki> || Dieses Tag wird mit dem aktuellen Datum gemäß des globalen Datumsformats ersetzt. || ||
|-
| <nowiki>{{date::*}}</nowiki> || Dieses Tag wird mit dem aktuellen Datum gemäß eines individuellen Datumsformats ersetzt. || ||
|-
| <nowiki>{{last_update}}</nowiki> || Dieses Tag wird mit dem Datum der letzten Aktualisierung gemäß des globalen Datumsformats ersetzt. || ||
|-
| <nowiki>{{last_update::*}}</nowiki> || Dieses Tag wird mit Datum der letzten Aktualisierung gemäß eines individuellen Datumsformats ersetzt. || ||
|-
| <nowiki>{{email::*}}</nowiki> || Dieses Tag wird mit einem verschlüsselten Link zu einer E-Mail-Adresse ersetzt. || ||
|-
| <nowiki>{{email_open::*}}</nowiki> || '''???''' || 2.11 ||
|-
| <nowiki>{{email_url::*}}</nowiki> || '''???''' || 2.11 ||
|-
| <nowiki>{{lang::*}}</nowiki> || Mit diesem Tag können fremdsprachige Wörter in einem Text markiert werden: <nowiki>{{lang::fr}}Au revoir{{lang}}</nowiki><br />
Wird ersetzt mit <nowiki><span lang="fr" xml:lang="fr">Au revoir</span></nowiki>. || ||
|-
| <nowiki>{{iflng::*}}</nowiki> || Dieses Tag wird komplett entfernt, wenn die Sprache der Seite nicht mit der Tag-Sprache übereinstimmt. Sie können so sprachspezifische Bezeichnungen erstellen:<br />
<nowiki>{{iflng::en}}Your name{{iflng}}{{iflng::de}}Ihr Name{{iflng}}
</nowiki> || ||
|-
| <nowiki>{{image::*}}</nowiki> || Dieses Tag wird mit der Vorschauansicht eines Bildes ersetzt: <nowiki>{{image::tl_files/image.jpg?width=200&height=150}}</nowiki><br />
Argumente sind:<br />
*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 ||
|-
| <nowiki>{{label::*}}</nowiki> || Dieses Tag wird mit einer Übersetzung ersetzt: <nowiki>{{label::CNT:au}}</nowiki> oder <nowiki>{{label::tl_article:title:0}}</nowiki>.<br />Beachten Sie, dass innerhalb des Pfads zur Bezeichnung nur einfache Doppelpunkte verwendet werden. || ||
|-
| <nowiki>{{abbr::Abkürzungserklärung}}Abkürzung{{abbr}}</nowiki> || - Mit diesem Tag können Abkürzungen in einem Text markiert werden: <nowiki>{{abbr::AGG}}Allgemeines Gleichstellungsgesetz{{abbr}}</nowiki> wird ersetzt mit <nowiki><span abbr="AGG">Allgemeines Gleichstellungsgesetz</span></nowiki>. || 2.9.2 ||
|-
| <nowiki>{{acronym::Akronymerklärung}}Akronym{{acronym}}</nowiki> || - Mit diesem Tag können Akronyme in einem Text markiert werden: <nowiki>{{acronym::PISA}}Programme for International Student Assessment{{abbr}}</nowiki> wird ersetzt mit <nowili><span acronym="PISA">Programme for International Student Assessment</span></nowiki>. || 2.9.2 ||
| colspan="3" |
|}

=== Weitere Inserttags ===
*<nowiki>{{env::ua}}</nowiki> - liefert den Usergent zurück
*<nowiki>{{env::plugins_url}}</nowiki> - liefert TL_PLUGINS_URL;
*<nowiki>{{env::script_url}}</nowiki> - liefert TL_SCRIPT_URL;
*<nowiki>{{env::files_url}}</nowiki> - liefert TL_FILES_URL;
*<nowiki>{{env::ip}}</nowiki> - liefert IP
*<nowiki>{{env::http_host}}</nowiki> - liefert den HTTP-Host
*<nowiki>{{ifnlng::XX}}</nowiki> - if '''not''' language
*<nowiki>{{request_token}}</nowiki> - Request Token
*<nowiki>{{version}}</nowiki> - Version
*<nowiki>{{last_update}}</nowiki> - letztes Update
*<nowiki>{{calendar_feed::xx}}</nowiki> - Kalender-Feed
*<nowiki>{{news_feed::xx}}</nowiki> - News-Feed

== 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.