Contao Community Documentation - Benutzerbeiträge [de]

Ordner und Dateien in Contao 4

2017-10-18T18:08:14Z

Xtra: Fehlende Dateien grob in Stichworten dokumentiert - hoffentlich macht jemand was draus. ;)

{{AppliesTo
|Version=Contao 4 latest managed edition}}

{{stub}}

[[Category:Admin HOWTOS]]

=Einleitung=
Hier sollen die Ordner und Dateien von Contao 4 dokumentiert werden, welche zum Verständnis und zur Anpassung des Systems relevant sind.

In Contao 3 waren dies
<source lang="text">
.htaccess
files/
system/
config/
dcaconfig.php
initconfig.php
langconfig.php
localconfig.php
modules/
templates/
</source>

==<span style="color:#800">.htaccess</span>==
Die Datei ist leer. Hier kann ein Passwortschutz aufgesetzt werden.

==<span style="color:#800">composer.json</span>==

==<span style="color:#800">composer.lock</span>==

==app/==

===app/config/===

====app/config/<span style="color:#800">parameters.yml</span>====

Konfigurationsparameter der Anwendung, dies sind u.a. Datenbank-Zugangsdaten usw.

====app/config/<span style="color:#800">config.yml</span>====

Gemeinsame Konfigurationsdatei der Webseite, hier werden alle "services" konfiguriert.
Die parameter aus "parameters.yml" werden hier oftmals verwendet (z.B. in `secret: "%secret%"` welches den Parameter "secret" aus "parameters.yml" hier eintraegt).

====app/config/<span style="color:#800">config_dev.yml</span>====

Konfigurationsdatei fuer das Entwicklungsenvironment (siehe auch web/app_dev.php)

====app/config/<span style="color:#800">config_prod.yml</span>====

Konfigurationsdatei fuer das Produktivenvironment (siehe auch web/app.php)

===app/Resources/===

Alle Anwendungsressourcen werden hier abgelegt, dies sind u.a. twig Templates.

====app/Resources/contao/====

=====app/Resources/contao/config/=====

Alle Contao-relevanten Konfigurationen landen hier, dies sind lokale Anpassungen.

=====app/Resources/contao/dca/=====

Hier abgelegte Dinge ersetzen die aus Contao 3.5 bekannten dca-Dateien einer "z_custom" extension und system/config/dcaconfig.php

=====app/Resources/contao/languages/=====

Hier abgelegte Dinge ersetzen die aus Contao 3.5 bekannten languages einer "z_custom" extension und system/config/langconfig.php

==contao-manager/==

Konfigurationsverzeichnis des Contao Manager.

===contao-manager/cache/===

Cacheverzeichnis des Contao Manager.

===contao-manager/logs/===

Log-verzeichnis des Contao Manager.

==system/==

DEPRECATED - hier sollte man nichts rein run.
Der Contao-Manager legt hier Legacy-Erweiterungen ab, damit diese im Contao 3.5 Modus in Contao 4 lauffaehig gemacht werden.
Diese Verzeichnisse werden ausserdem nach web/system symlinked, damit die assets derselbigen Module lauffaehig sind.

===system/config/===

====system/config/<span style="color:#800">initconfig.php</span>====

DEPRECATED - wie in Contao 3.5 kommt hier Initialisierungscode rein, welchen Contao beim "Start" ausfuehren soll.
Sollte man nicht mehr verwenden, lieber ein app-bundle bauen und saubere services.

====system/config/<span style="color:#800">localconfig.php</span>====

Konfigurationsdatei fuer Einstellungen, welche noch nicht im Manager bzw. parameters.yml sind.
Entspricht der Konfigurationsmaske im Backend (System/Einstellungen).

AN ENTWICKLER: Bitte nichts mehr in dca/tl_settings.php und localconfig.php mehr hinzufuegen und eigene Dinge mittelfristig hieraus auch wieder entfernen. Verwendet stattdessen bundle-Konfigurationsparameter.

==files/==
Dateien, welche auf der Website veröffentlicht werden. jpg, png, pdf, mp3, mp4, css, js usw.

Unterordner müssen über die Dateiverwaltung explizit freigegeben werden.

==templates/==
Templates für die FE-Ausgabe.

==var/==
Ablageverzeichnis der Anwendung fuer u.a. cache, logs etc.

==vendor/==

Composer Bibliotheksverzeichnis - hier wird der Code von Erweiterungen und bundles abgelegt.

==web/==
Auf diesen Ordner muss die Domain geroutet werden.

===web/bundles/===

Hier werden alle assets von Bundles hineingelinkt um diese via web erreichbar zu machen.

===web/system/===

Siehe "system", hier werden assets von legacy Erweiterungen hin-gelinkt.

===web/<span style="color:#800">.htaccess</span>===

Apache Konfiguration um u.a. auf app.php zu redirecten.

===web/<span style="color:#800">app.php</span>===

Produktiver entrypoint der Anwendung aus dem Web. Entspricht in etwa "index.php" in Contao 3.5.

===web/<span style="color:#800">app_dev.php</span>===

Entwicklungs entrypoint der Anwendung aus dem Web. Entspricht in etwa "index.php" mit aktiviertem Debug Modus in Contao 3.5.

--[[Benutzer:Andreas|Andreas Burg]] ([[Benutzer Diskussion:Andreas|Diskussion]]) 18:19, 18. Okt. 2017 (CEST)
--[[Benutzer:Xtra|Xtra]] ([[Benutzer Diskussion:Xtra|Diskussion]]) 20:08, 18. Okt. 2017 (CEST)

Hilfe:Inhaltsverzeichnis

2014-05-02T21:19:50Z

Xtra: Xtra verschob die Seite Hilfe:Hilfe nach Hilfe:Inhaltsverzeichnis

[[en:Help:Contents]]
=Verfassen von Artikeln=
Vor dem Verfassen eines neuen Artikels sollte kontrolliert werden, ob schon ein Artikel zum gleichen Thema existiert. Dies kann über die Suchfunktion oder über die [[Spezial:Alle_Seiten|Auflistung aller existierender Seiten]] geprüft werden. Vor dem Abspeichern eines Artikels sollte man den Artikel mit der Vorschau-Funktion auf event. Rechtschreibfehler o.ä. prüfen.
==Einen neuen Artikel anlegen==
Sollte die Suche zu keinem Ergebnis führen, legt man die Seite neu an.
Hierzu gibt man beispielsweise den gewünschten Titel links in der Sidebar in das Suchfeld ein und klickt anschließend auf den Button "Seite".
Die Wiki-Software meldet nun, dass die Seite nicht existiert und man möge sie doch bitte verfassen.

Nach einem Klick auf den Link '''die Seite verfassen''' gelangt man in die Eingabemaske.

Ungeduldige können auch direkt die URL: <nowiki>http://de.contaowiki.org/Wunschtitel</nowiki> in ihrem Browser eingeben, wodurch man direkt in die Eingabemaske gelangt.

'''Artikel sollten neutral und allgemein verfasst werden''' (als Beispiel nicht "''Ich betrachte die Seite''" oder "''Du betrachtest die Seite''", sondern "''Man betrachtet die Seite''"), um eine Vereinheitlichung der Artikel zu gewährleisten.

==Wichtig: Angabe der Contao-Version==
Da sich Contao ständig weiter entwickelt, ändert sich auch laufend der Quellcode. '''Daher ist es beim Verfassen von Artikeln wichtig, immer mit anzugeben, auf welche Contao-Version sich der Artikel oder das Codebeispiel bezieht.''' Ein Besucher kann ansonsten in einem Jahr nicht mehr nachvollziehen, auf welche Contao-Version(en) sich ein HowTo für z.B. ein modifiziertes Template bezieht. Durch die Angabe der Version ist er jedoch in der Lage, Änderungen an dem entsprechenden Template nachzuvollziehen und es bei Bedarf dementsprechend anzupassen.
Eine Versionsangabe erfolgt durch ff. Code zu Beginn der Seite:
<pre>{{AppliesTo
|Version=Alle Versionen
|Ext1=SuperExtension
|Ext2=HyperExtension}}</pre>
Hierbei können folgende Parameter verwendet werden:
* Version - Die Contao Version auf die sich der Artikel bezieht.
* Ext1 ... ExtN - Die Extensions die der Artikel betrifft. Die Zahl beginnt jeweils bei 1 und wird für jede weitere Extension um eins hochgezählt.
* TLVersion - Da einige Artikel neben Contao auch noch TYPOlight (pre Contao 2.9) betreffen, kann man so auch noch angeben, dass ein Artikel ggf. noch TYPOlight betrifft. Diese Angaben werden jedoch mit der Zeit verschwinden.

Dieser Code wird dann am Anfang der Seite wie auf folgender [[ModuleCatalogList|Beispielseite]] dargestellt.

==Kategorisierung==
Ein Artikel kann in einer oder mehreren [[Spezial:Kategorien| Kategorien]] abgelegt werden. Für jede Kategorie muss eine neue Zeile zu Beginn der Seite gemacht werden.
<pre>
[[Category:Admin HOWTOS]]
[[Category:Module]]
</pre>
Um einen in Arbeit oder unvollständigen Artikel als solchen zu kennzeichnen, wird der Eintrag
<pre>{{stub}}</pre>
an oberster Stelle, noch vor den Kategorien, eingefügt. Einem unvollständigen Artikel erkennnt man beim Betrachten am Hinweis:

[[Datei:Stub-warning.png|Unvollständiger Artikel]]

Des weiteren ist der Artikel in der Liste der unvollständigen Artikel aufgeführt.

=Hinweise, Anmerkungen und Warnungen=
In einem Artikel kann man Hinweise und Warnungen hinterlegen.
Diese fügt man durch die Verwendung der jeweiligen Vorlage hinzu.
==Hinweise==
<pre>
{{Hinweis|Text des Hinweises}}
</pre>
Was folgendes Ergebnis erzeugt.
{{Hinweis|Text des Hinweises}}

==Anmerkungen==
<pre>
{{Anmerkung|Text der Anmerkung}}
</pre>
Was folgendes Ergebnis erzeugt.
{{Anmerkung|Text der Anmerkung}}

==Warnungen==
<pre>
{{Achtung|Text der Warnung}}
</pre>
Was folgendes Ergebnis erzeugt.
{{Achtung|Text der Warnung}}

== Meldungen mit Bild links oben und farbigem Text ==
Ich habe mir erlaubt, einige eingefärbte Meldungsboxen hinzuzufügen, bei denen die Bilder links oben sitzen (was ich bei längeren Texten ganz angenehm finde). Die Icons sind aus dem frei verfügbaren Oxygen Theme von David Vignoni. --[[Benutzer:Hschottm|Hschottm]] 16:11, 11. Sep. 2010 (CEST)<br/>
Erweitert um eine Box zur Formulierung einer Frage, verwendet ebenfalls ein Oxygen Icon. -- [[Benutzer:Folkfreund|folkfreund]] 23:29, 14. Dez. 2012 (CEST)

{|
!Befehl
!Ausgabe
|- style="vertical-align:top;"
| <pre>{{msgInfo|Text der Meldung}}</pre>
|{{msgInfo|Lorem ipsum dolor sit amet, consectetur adipiscing elit. Cras quis odio ac magna ornare porttitor. Aliquam erat volutpat. Morbi vitae dignissim diam. Vestibulum ultrices vehicula posuere. Fusce nec ante tortor, quis euismod dolor. Proin quis porttitor odio. Nam lacinia, nunc sed venenatis pretium, augue risus lobortis lacus, vitae porttitor leo lorem sit amet lectus. Vivamus eu fermentum felis. Cras dictum consequat fringilla.}}
|- style="vertical-align:top;"
| <pre>{{msgSuccess|Text der Meldung}}</pre>
|{{msgSuccess|Lorem ipsum dolor sit amet, consectetur adipiscing elit. Cras quis odio ac magna ornare porttitor. Aliquam erat volutpat. Morbi vitae dignissim diam. Vestibulum ultrices vehicula posuere. Fusce nec ante tortor, quis euismod dolor. Proin quis porttitor odio. Nam lacinia, nunc sed venenatis pretium, augue risus lobortis lacus, vitae porttitor leo lorem sit amet lectus. Vivamus eu fermentum felis. Cras dictum consequat fringilla.}}
|- style="vertical-align:top;"
| <pre>{{msgError|Text der Meldung}}</pre>
|{{msgError|Lorem ipsum dolor sit amet, consectetur adipiscing elit. Cras quis odio ac magna ornare porttitor. Aliquam erat volutpat. Morbi vitae dignissim diam. Vestibulum ultrices vehicula posuere. Fusce nec ante tortor, quis euismod dolor. Proin quis porttitor odio. Nam lacinia, nunc sed venenatis pretium, augue risus lobortis lacus, vitae porttitor leo lorem sit amet lectus. Vivamus eu fermentum felis. Cras dictum consequat fringilla.}}
|- style="vertical-align:top;"
| <pre>{{msgWarning|Text der Meldung}}</pre>
|{{msgWarning|Lorem ipsum dolor sit amet, consectetur adipiscing elit. Cras quis odio ac magna ornare porttitor. Aliquam erat volutpat. Morbi vitae dignissim diam. Vestibulum ultrices vehicula posuere. Fusce nec ante tortor, quis euismod dolor. Proin quis porttitor odio. Nam lacinia, nunc sed venenatis pretium, augue risus lobortis lacus, vitae porttitor leo lorem sit amet lectus. Vivamus eu fermentum felis. Cras dictum consequat fringilla.}}
|- style="vertical-align:top;"
| <pre>{{msgImportant|Text der Meldung}}</pre>
|{{msgImportant|Lorem ipsum dolor sit amet, consectetur adipiscing elit. Cras quis odio ac magna ornare porttitor. Aliquam erat volutpat. Morbi vitae dignissim diam. Vestibulum ultrices vehicula posuere. Fusce nec ante tortor, quis euismod dolor. Proin quis porttitor odio. Nam lacinia, nunc sed venenatis pretium, augue risus lobortis lacus, vitae porttitor leo lorem sit amet lectus. Vivamus eu fermentum felis. Cras dictum consequat fringilla.}}
|- style="vertical-align:top;"
| <pre>{{msgQuestion|Fragestellung}}</pre>
|{{msgQuestion|Lorem ipsum dolor sit amet, consectetur adipiscing elit. Cras quis odio ac magna ornare porttitor. Aliquam erat volutpat. Morbi vitae dignissim diam. Vestibulum ultrices vehicula posuere. Fusce nec ante tortor, quis euismod dolor. Proin quis porttitor odio. Nam lacinia, nunc sed venenatis pretium, augue risus lobortis lacus, vitae porttitor leo lorem sit amet lectus. Vivamus eu fermentum felis. Cras dictum consequat fringilla.}}
|}

=Formatierung=
==Textformatierung==
Die wichtigsten Textformatierungen lauten:

'''Fettschrift'''
<pre>'''Fettschrift'''</pre>
''Schrägschrift''
<pre>''Schrägschrift''</pre>
'''''Fett- und Schrägschrift'''''
<pre>'''''Fett- und Schrägschrift'''''</pre>
==Auflistung==
Standardauflistung
<pre>
* foo
* bar
</pre>
ergibt
* foo
* bar
Nummerierte Auflistung
<pre>
# foo
# bar
</pre>
ergibt
# foo
# bar
==Gruppierung==
Es ist möglich, einen Artikel in verschiedenen Gruppen und Untergruppen zu gliedern, um bei langen Artikeln die Übersicht zu behalten.
<pre>
=Hauptgruppe 1=
Text
==Untergruppe 1.1==
Text
==Untergruppe 1.2==
Text
=Hauptgruppe 2=
Text
==Untergruppe 2.1==
Text
==Untergruppe 2.2==
usw
</pre>
Bei mehr als 4 Gruppen wird automatisch ein Inhaltsverzeichnis am Anfang des Artikels angelegt.

==Auszeichung von Quellcode==
Um Text als Quellcode darzustellen, verwendet man das '''<nowiki><source></nowiki>'''-Tag (favorisierte Methode seit 27.08.2010).<br />
Weiter Möglichkeiten sind:
# man fügt eine Leerzeile ein und beginnt jede Zeile des zu formatierenden Textes mit einem Leerzeichen (space/blank).
# man umgibt den zu formatierenden Text mit <nowiki><pre>.... text ...</pre></nowiki>

Bei der Formatierung von Quellcode mittels <nowiki><source></nowiki>-Tag kann man optional ein Sprachattribut mit angeben.

Beispiel:
<pre>
<source lang="css">
div .classname {
color: white;
}
</source>
</pre>

Das Ergebnis sieht dann so aus:
<source lang="css">
div .classname {
color: white;
}
</source>

Die folgenden Sprachen sind per '''lang'''-Parameter verfügbar:
{| border="0" cellpadding="0" cellspacing="20"
|- valign="top"
|
* actionscript
* ada
* apache
* applescript
* asm
* asp
* autoit
* bash
* blitzbasic
* bnf
* c
* caddcl
* cadlisp
* cfdg
* cfm
* cpp-qt
* cpp
* csharp
* css-gen.cfg
* css
|
* c_mac
* d
* delphi
* diff
* div
* dos
* eiffel
* fortran
* freebasic
* gml
* groovy
* html4strict
* idl
* ini
* inno
* io
* java
* java5
* javascript
* latex
|
* lisp
* lua
* matlab
* mirc
* mpasm
* mysql
* nsis
* objc
* ocaml-brief
* ocaml
* oobas
* oracle8
* pascal
* perl
* php-brief
* php
* plsql
* python
* qbasic
* reg
|
* robots
* ruby
* sas
* scheme
* sdlbasic
* smalltalk
* smarty
* sql
* tcl
* text
* thinbasic
* tsql
* vb
* vbnet
* vhdl
* visualfoxpro
* winbatch
* xml
* z80
|}

==Umlaute/Sonderzeichen==
Will man Umlaute im Wiki als HTML-Entity (Ersatzdarstellung) darstellen (z.b. ä = &auml;), sieht die Schreibweise beispielsweise so aus:
<pre>
ä = &amp;auml;
</pre>
=Verlinkung=
==Textlinks==
Bei Textlinks unterscheidet man zwischen internen und externen Link.

'''Interne Links''' (innerhalb des Contao Info Portals) werden wie folgt verlinkt:
<pre>[[Seitenname|Beschreibung]]</pre>
''Beispiel:''<pre>[[Einsteiger|Anleitung für Einsteiger]]</pre>
ergibt folgenden Link: [[Einsteiger|Anleitung für Einsteiger]]

'''Interne Links mit Anker''' (innerhalb des Contao Info Portals):
<pre>[[Seitenname#Anker|Beschreibung]]</pre>
''Beispiel:''<pre>[[Einsteiger#Entstehungsgeschichte|Anleitung für Einsteiger]]</pre>
ergibt folgenden Link: [[Einsteiger#Entstehungsgeschichte|Anleitung für Einsteiger]]

Für '''externe Links''' verwendet man:
<pre>[http://www.example.com Beschreibung]</pre>
''Beispiel:''<pre>[http://www.contao.org Contao-Homepage]</pre>
ergibt folgenden Link: [http://www.contao.org Contao-Homepage]

Eine Ausnahme hiervon bilden beispielsweise Links auf die Wikipedia. Solche legt man, um auf die englischsprachige Seite in der Wikipedia zu verlinken, folgendermaßen an:
<pre>[[w:Seitenname|Beschreibung]]</pre>
Eine Seite in anderer Sprache, innerhalb der Wikipedia, erreicht man durch das zusätzliche anhängen des Sprachcodes. Am Beispiel Deutsch sieht dies dann so aus:
<pre>[[w:de:Seitenname|Beschreibung]]</pre>

Diese Notation nennt sich Interwiki links, von denen einige bereits eingerichtet sind. Sollten welche fehlen, bitte einem Administrator Bescheid geben, damit er baldmöglichst eingebaut wird.

==Bilderlinks==
Bevor man auf ein Bild verlinkt, muss man das Bild [[Spezial:Hochladen|hochladen]].
Um das Bild in einen Artikel einzubinden, verwendet man folgende Codes:

Die einfachste Variante ist ein Bild mit Beschreibung.
<pre>[[Datei:foo.jpg|Bechreibung]]</pre>
Des weiteren kann man Bilder auch auf andere Seiten verlinken.

Interne Links:
<pre>[[Datei:foo.jpg|link=Hauptseite|Beschreibung]]</pre>
Externe Links:
<pre>[[Datei:foo.jpg|link=http://www.example.com|Beschreibung]]</pre>

----
Bei Code- und Templatebeispielen TL-Version mit angeben!

=Übersetzungen des Contaowiki=

Das Contaowiki-Projekt umfasst derzeit vier Sprachen. Deutsch (http://de.contaowiki.org), Englisch (http://en.contaowiki.org), Französisch (http://fr.contaowiki.org) und Portugiesisch (http://pt.contaowiki.org) .
In einem Artikel sieht man links unten im Menü unter "Sprachen" in welche anderen Sprachen der Artikel bereits übersetzt wurde. Sollte eine Sprache fehlen und man sich selbst der jeweiligen Sprache ausreichend mächtig fühlen, sollte man nun daran gehen den Artikel in die fehlende Sprache zu übersetzen.
Zur genauen Vorgehensweise hier eine kleine Anleitung:
==Titelfindung==
Vorab sollte überlegt werden, wie der Artikel in der anderen Sprache heißen könnte. Nimmt man als Beispiel hier den fiktiven Artikel "Beispiel" (das Wort "Beispiel" heißt übersetzt in englischen "Example"), so sollte der auf en.contaowiki.org erstellende Artikel somit heißen: <nowiki>http://en.contaowiki.org/Example</nowiki>.
==Text übersetzen==
Nun geht es daran, den Text zu übersetzen. Man sollte daran denken, dass die im Ursprungsartikel verlinkten weiteren Artikel in der neuen Sprache vermutlich einen anderen Namen haben werden. Diese Artikel sollte man dann suchen und, sofern noch nicht existent, unter neuem Namen ebenfalls verlinken. Dies erzeugt einen roten Link und fungiert somit als Platzhalter für den Artikel, welcher dann in der Liste der [[Spezial:Gewünschte_Seiten|gewünschten Seiten]] auftaucht. Wenn man möchte, kann man die jeweiligen Artikel dann logischerweise auch gleich im Anschluss ebenfalls übersetzen.
==Verlinkungen zwischen den Sprachen setzen==
Abschließend muss den Wikis noch mitgeteilt werden, unter welchem Namen die Übersetzung in der anderen Sprache zu erreichen ist.
Hierzu verwendet man die Interwiki-Notation, wie bei Wikipedia und ähnlichen Projekten.

Im deutschen Wiki schreibt man auf der Seite "Beispiel":

<nowiki>[[en:Example]]</nowiki>
und im englischen auf der Seite "Example":

<nowiki>[[de:Beispiel]]</nowiki>

=Ausführliche Hilfe=
Eine ausführliche Zusammenfassung aller Formatierungsmöglichkeiten findet man auf der [http://www.mediawiki.org/wiki/Help:Contents MediaWiki Homepage]

Hilfe:Hilfe

2014-05-02T21:19:50Z

Xtra: Xtra verschob die Seite Hilfe:Hilfe nach Hilfe:Inhaltsverzeichnis

#WEITERLEITUNG [[Hilfe:Inhaltsverzeichnis]]

Hilfe Diskussion:Inhaltsverzeichnis

2014-05-02T21:19:50Z

Xtra: Xtra verschob die Seite Hilfe Diskussion:Hilfe nach Hilfe Diskussion:Inhaltsverzeichnis

Gibt es auch eine Möglichkeit Tabellen zu definieren?

----
Ja, ein Beispiel findest Du hier: [[Webhoster]]<br />
--[[Benutzer:Manitougs|Manitougs]] 17:52, 21. Okt. 2010 (CEST)

----
Danke! Wäre gut das in die Hilfeseite aufzunehmen... Mach ich vielleicht, wenn ich mal ein wenig mehr Zeit habe.
--[[Benutzer:Somoza|Somoza]] 19:12, 22. Okt. 2010 (CEST)

Hilfe Diskussion:Hilfe

2014-05-02T21:19:50Z

Xtra: Xtra verschob die Seite Hilfe Diskussion:Hilfe nach Hilfe Diskussion:Inhaltsverzeichnis

#WEITERLEITUNG [[Hilfe Diskussion:Inhaltsverzeichnis]]

Online-Shops

2013-11-13T10:45:02Z

Xtra: Shops verlinkt

{{stub}}
[[Category:Extensions]]
Auf dieser Seite soll ein Überblick über die bestehenden Shop-Lösungen für Contao entstehen.

== Vergleichstabelle ==

{| border="1" cellspacing="0" cellpadding="5"
! Kategorien !! [http://www.contao-webshop.de/software.html Contao webShop<br />Community Edition] !! [http://www.contao-webshop.de/software.html Contao webShop<br />Business Edition] !! [http://isotopeecommerce.org Isotope<br />eCommerce] !! [http://www.delahaye.de/chshop.html chShop] !! [http://www.contao-acquisto.de/de/ acquistoShop] !! [http://www.merconis.com/ MERCONIS]
|-
| beliebige Haupt- und Unterkategorien || Ja || Ja || Ja || via [[Catalog|Katalog-Extension]] || Ja || Ja
|-
| Kategoriebeschreibung || Ja || Ja || Ja, über Artikel || via [[Catalog|Katalog-Extension]] || Ja || Ja, über Artikel
|-
| Kategoriebild hinzufügen || Ja || Ja || Ja, über Artikel || via [[Catalog|Katalog-Extension]] || Ja || Ja, über Artikel
|-
| geschützte Kategorien für Kundengruppen || Ja || Ja || Ja, über Seitenstruktur || via [[Catalog|Katalog-Extension]] || Ja || Ja, über Seitenstruktur
|-
| colspan="6" |

|-
! Artikelverwaltung !! Contao webShop<br />Community Edition !! Contao webShop<br />Business Edition !! Isotope<br />eCommerce !! chShop !! acquistoShop !! MERCONIS
|-
| Artikel || Ja || Ja || Ja || Ja || Ja || Ja
|-
| Produktgruppen || Ja || Ja || Ja || via [[Catalog|Katalog-Extension]] || Ja || Ja
|-
| Artikel mit Varianten || Nein || Ja || Ja || Ja || Ja || Ja
|-
| Artikel mit beliebigen Produktkonfiguratoren || ? || ? || ? || ? || ? || Ja
|-
| Artikel in mehreren Kategorien || Nein || Ja || Ja || via [[Catalog|Katalog-Extension]] || Ja || Ja
|-
| Downloadartikel || Nein || Ja || Ja || Bezahlte Inhalte || Ja || Nein
|-
| Artikelfilter / Produktfinder || Nein || Ja || Ja (ab v1.3) || Ja || Ja || Ja, über LiveHits
|-
| Artikel TagCloud || Ja || Ja || Nein || Nein || Ja || Nein
|-
| Artikelempfehlungen (zu Artikel x paßt Artikel y) || Ja || Ja || Ja || via [[Catalog|Katalog-Extension]] || Nein || Ja (s. auch Cross Selling)
|-
| Artikel als NEU markieren || Ja || Ja || Ja (Anpassung) || via [[Catalog|Katalog-Extension]] || Ja (Artikelzustand) || Ja
|-
| Artikel als ANGEBOT markieren || Ja || Ja || Ja (Anpassung) || via [[Catalog|Katalog-Extension]] || Ja || Ja
|-
| Artikelnummern || Ja || Ja || Ja || Ja || Ja || Ja
|-
| Artikelnummern je Variante || Nein || Ja || Ja || automatisch generiert || Ja || Ja
|-
| Artikelbild hinzufügen || Ja || Ja || Ja || Ja || Ja || Ja
|-
| Artikelbild je Variante hinzufügen || Nein || Ja || Ja || Ja || Nein || Ja
|-
| Bildergalerie mit Zoomfunktion || Nein || Ja || Ja || via [[Catalog|Katalog-Extension]] || Ja (nur Bildgalerie) || Ja
|-
| Bildergalerie mit Video || ? || ? || via Erweiterung (v1.3) || Nein || ? || Ja
|-
| Bildergalerie je Variante || Nein || Ja || Ja || Nein || Nein || Ja
|-
| Bildergalerie mit Slider || ? || ? || ? || ? || ? || Ja
|-
| Bildergalerie mit Reitern (Tabs) || ? || ? || ? || ? || ? || Ja
|-
| Lagerbestand mit optionalem Abverkauf || Ja || Ja || Nein || Nein || Nein > [http://contao-acquisto.de/de/aktuelle-projekte.html Wir sammeln spenden für die Entwicklung] || ?
|-
| Lagerbestandsverwaltung || ? || ? || ? || ? || ? || Ja
|-
| Benachrichtigung bei Mindestlagerbestand || ? || ? || ? || ? || ? || Ja
|-
| Einzelpreis || Ja || Ja || Ja || Ja || Ja || Ja
|-
| Einzelpreis je Variante || Nein || Ja || Ja || Ja || Ja || Ja
|-
| Sonderpreis || Ja || Ja || via Preisregeln || via [[Catalog|Katalog-Extension]] || Ja || Ja
|-
| Sonderpreis je Variante || Nein || Ja || via Preisregeln || via [[Catalog|Katalog-Extension]] || Ja || Ja
|-
| Sonderpreise für Kundengruppen || Ja || Ja || ab v1.3 || via [[Catalog|Katalog-Extension]] || Nein > [http://contao-acquisto.de/de/aktuelle-projekte.html Wir sammeln spenden für die Entwicklung] || Ja
|-
| Sonderpreise für Kundengruppen je Variante || Nein || Ja || ab v1.3 || via [[Catalog|Katalog-Extension]] || Nein > [http://contao-acquisto.de/de/aktuelle-projekte.html Wir sammeln spenden für die Entwicklung] || Ja
|-
| Staffelpreise || Ja || Ja || ab v1.3 || Nein || Ja || Nein
|-
| Staffelpreise je Variante || ? || ? || ? || ? || Ja || Nein
|-
| Grundpreis (je kg, Liter etc.) || Ja || Ja || Nein || via [[Catalog|Katalog-Extension]] || Ja || Ja
|-
| Gewicht zur Berechnung der Versandkosten || Ja || Ja || Ja || Ja || Ja || Ja
|-
| Steuersatz auswählbar || Ja || Ja || Ja || Ja || Ja || Ja
|-
| "Twittern"-Button || Ja || Ja || via Contao || Nein || Ja || Ja
|-
| "Like it"-Facebook-Button || Ja || Ja || via Contao || Nein || Ja || Ja
|-
| Recently Viewed (Zuletzt angeschaut) || ? || ? || ? || ? || Ja || Ja (s. auch Cross Selling)
|-
| Vordefinierte Attribute || ? || ? || ? || ? || Ja || Ja
|-
| Produkauktionen || ? || ? || ? || ? || Ja (benötigt Addon Acquisto Auktionen > 30,- EUR) || Nein
|-
| colspan="6" |

|-
! Mehrsprachenfähigkeit !! Contao webShop<br />Community Edition !! Contao webShop<br />Business Edition !! Isotope<br />eCommerce !! chShop !! acquistoShop !! MERCONIS
|-
| Mehrsprachenfähig || Ja || Ja || Nein || Ja || Ja || Ja
|-
| colspan="6" |

|-
! Gutscheine !! Contao webShop<br />Community Edition !! Contao webShop<br />Business Edition !! Isotope<br />eCommerce !! chShop !! acquistoShop !! MERCONIS
|-
| Allgemeiner Gutschein || Ja || Ja || Ja || Ja || Ja || Ja
|-
| Gutschein für einen Kunden || Ja || Ja || Ja || Nein || Ja || Ja
|-
| Gutscheincode vorgeben || Ja || Ja || Ja || Ja || Ja || Ja
|-
| Gutscheincode autom. generieren lassen || Ja || Ja || Nein || Nein || Nein || Nein
|-
| Gutscheinwert in Euro oder Prozent || Ja || Ja || Ja || Ja || Nein || Ja
|-
| Nutzung zeitlich limitieren || Ja || Ja || Ja || Nein || Ja || Ja
|-
| Nutzung in der Anzahl limitieren || Ja || Ja || Ja || Ja || Ja || Nein
|-
| colspan="6" |

|-
! Steuern !! Contao webShop<br />Community Edition !! Contao webShop<br />Business Edition !! Isotope<br />eCommerce !! chShop !! acquistoShop !! MERCONIS
|-
| Steuerzonen || Ja || Ja || Nein || Ja || Ja || Ja
|-
| Steuerklassen || Ja || Ja || Ja || Nein || Ja || Ja
|-
| Steuersätze || Ja || Ja || Ja || Ja || Ja || Ja
|-
| colspan="6" |

|-
! Versand !! Contao webShop<br />Community Edition !! Contao webShop<br />Business Edition !! Isotope<br />eCommerce !! chShop !! acquistoShop !! MERCONIS
|-
| Versandzonen || Ja || Ja || Nein || Ja || Ja || Ja
|-
| Versandoptionen || Ja || Ja || Ja || Ja || Ja || Ja
|-
| Berechnung nach Gewicht mit Staffelmöglichkeit || Ja || Ja || Ja || Ja || Ja || Ja
|-
| Berechnung nach Preis mit Staffelmöglichkeit || Ja || Ja || Ja || Ja || Ja || Ja
|-
| Berechnung nach Verpackungseinheiten mit Staffelmöglichkeit || Nein || Nein || Nein || Ja || Nein || Nein
|-
| Versandtrackinginformationen in Nachrichten || ? || ? || ? || ? || ? || Ja
|-
| colspan="6" |

|-
! Zahlungsmodule !! Contao webShop<br />Community Edition !! Contao webShop<br />Business Edition !! Isotope<br />eCommerce !! chShop !! acquistoShop !! MERCONIS
|-
| Rechnung/Vorauskasse/Nachnahme || Ja || Ja || Ja || Ja || Ja || Ja
|-
| PayPal Standard || Ja || Ja || Ja || Ja || Ja || Ja
|-
| PayPal Payflow Pro || Nein || Nein || Ja || Nein || Nein || Nein
|-
| sofortueberweisung.de || Ja || Ja || via Erweiterung || Nein || Ja || Nein
|-
| Authorize.Net || Nein || Nein || Ja || Nein || Nein || Nein
|-
| Postfinance || Nein || Nein || Ja || Nein || Nein || Nein
|-
| Cybersource || Nein || Nein || Ja || Nein || Nein || Nein
|-
| Saferpay || Ja || Ja || via Erweiterung || Nein || Nein || Nein
|-
| PayOne || Nein || Nein || via Erweiterung || ? || Nein || Nein
|-
| ExperCash || Nein || Nein || via Erweiterung || ? || Nein || Nein
|-
| ePay || ? || ? || Ja/via Erweiterung (v1.3) || ? || ? || Nein
|-
| Sparkasse/Postbank || ? || ? || via Erweiterung || ? || ? || Nein
|-
| Datatrans || ? || ? || via Erweiterung || ? || ? || Nein
|-
| Volksbanken Karten/ELV/Giropay || Nein || Nein || Nein || Ja || Nein || Nein
|-
| Rabattmöglichkeit in Euro oder Prozent || Ja || Ja || Ja || Ja || Nein || Ja
|-
| colspan="6" |

|-
! Cross Selling !! Contao webShop<br />Community Edition !! Contao webShop<br />Business Edition !! Isotope<br />eCommerce !! chShop !! acquistoShop !! MERCONIS
|-
| Direkte Produktauswahl || ? || ? || ? || ? || ? || Ja
|-
| Dynamisch nach Kriterien || ? || ? || ? || ? || ? || Ja
|-
| Zubehörteile || ? || ? || ? || ? || ? || Ja
|-
| Zuletzt gesehen || ? || ? || ? || ? || ? || Ja
|-
| Empfohlene Produkte || ? || ? || ? || ? || ? || Ja
|-
| colspan="6" |

|-
! Bestellungen & Kundenverwaltung !! Contao webShop<br />Community Edition !! Contao webShop<br />Business Edition !! Isotope<br />eCommerce !! chShop !! acquistoShop !! MERCONIS
|-
| Gastzugang bzw. -bestellung || Ja || Ja || Ja || Ja || Ja || Ja
|-
| autom. Versand der Bestellbestätigung || Ja || Ja || Ja || Ja || Ja || Ja
|-
| inkl. AGB und Widerrufsbelehrung als PDF || Ja || Ja || Ja || Ja || Ja || Ja
|-
| Bestellhistorie im Frontend und Backend || Ja || Ja || Ja || Ja || im BE - FE in entwicklung || im BE
|-
| Bestellstatus veränderbar || Ja || Ja || Ja || Ja || Nein > [http://contao-acquisto.de/de/aktuelle-projekte.html Wir sammeln spenden für die Entwicklung] || Ja
|-
| erweiterte Kundendaten || Ja || Ja || Ja || Ja || Ja || Ja
|-
| beliebige Lieferadressen || Ja || Ja || Ja || Ja || Ja || Ja
|-
| Kundengruppen || Ja || Ja || Mitgliedergruppen || Mitgliedergruppen || Ja || Mitgliedergruppen
|-
| colspan="6" |

|-
! Nachrichtenmanagement !! Contao webShop<br />Community Edition !! Contao webShop<br />Business Edition !! Isotope<br />eCommerce !! chShop !! acquistoShop !! MERCONIS
|-
| Beliebige Nachrichten erstellbar || ? || ? || ? || ? || ? || Ja
|-
| Bestellbestätigung an Kunde || ? || ? || ? || ? || ? || Ja
|-
| Bestellinfo an Shopbetreiber || ? || ? || ? || ? || ? || Ja
|-
| Versandbestätigung || ? || ? || ? || ? || ? || Ja
|-
| Bestätiung für Zahlungseingang || ? || ? || ? || ? || ? || Ja
|-
| Beliebige dynamisch generierte PDF-Anhänge || ? || ? || ? || ? || ? || Ja
|-
| colspan="6" |

|-
! Einstellungen !! Contao webShop<br />Community Edition !! Contao webShop<br />Business Edition !! Isotope<br />eCommerce !! chShop !! acquistoShop !! MERCONIS
|-
| Länderinformationen || Ja || Ja || Ja || Ja || Ja || Ja
|-
| Währungsangaben || Ja || Ja || Ja || Ja || Ja || Ja
|-
| Preisanzeige (brutto/netto) || Ja || Ja || ? || Ja || Nein || Ja
|-
| Mindestbestellwert || Ja || Ja || Ja (v1.3) || Ja || Ja || Ja
|-
| Rabattsystem || Ja || Ja || Ja || Ja || Ja || Ja
|-
| E-Mail Versandeinstellungen || Ja || Ja || Ja || Ja || Ja || Ja
|-
| colspan="6" |

|-
! Exportschnittstellen/Anbindung !! Contao webShop<br />Community Edition !! Contao webShop<br />Business Edition !! Isotope<br />eCommerce !! chShop !! acquistoShop !! MERCONIS
|-
| Google Shopping || Ja || Ja || via Erweiterung || Nein || Ja || Nein
|-
| billiger.de || ? || ? || ? || ? || Ja || Nein
|-
| Veha24 Warenwirtschaft || Ja || Ja || Nein || Nein || Nein || Nein
|-
| Cash Software (Warenwirtschaft & Kasse) || Ja || Ja || Nein || Nein || Nein || Nein
|-
| colspan="6" |

|-
! Lizenzierung !! Contao webShop<br />Community Edition !! Contao webShop<br />Business Edition !! Isotope<br />eCommerce !! chShop !! acquistoShop !! MERCONIS
|-
| Demo-Shop Template & Layout inkl. || Ja || Ja || Ja || ohne Layout || Ja || Ja
|-
| Support per E-Mail || Nein || Ja || Nein || Nein || Ja || Ja
|-
| Support per Forum || Ja || Ja || Ja || Ja || Ja || Ja
|-
| Support per Ticketsystem || Ja || Ja || Ja || Nein || Nein || Ja
|-
| Lizenz || EULA || EULA || LGPL || LGPL || LGPL || EULA
|-
| '''Preis netto''' || '''0,00 €''' || '''499,00 €''' || '''0,00€''' || '''0,00 €''' || '''0,00 €''' || '''189,00 € / 389,00 €'''
|}

How to be(come) a Contao Developer

2013-07-17T21:11:20Z

Xtra: Videos eingebunden.

Wie wird man ein Contao 2 Entwickler?<br />
Diese Frage wird in einer Screencastreihe beantwortet auf Youtube. Hier eine Übersicht der bisher veröffentlichten Teile.<br />
Danke an Tristan Lins aka tril, bit3 https://bit3.de

Für Contao 3 gibt es eine extra Serie: [[Extensions_entwickeln_für_Contao_3]]

[[Category:Dev HOWTOS]]
[[Category:Development]]
[[Category:Dev Snippets]]
{{AppliesTo|Version=ab 2.10}}

==Serie==
Link zur Playlist: [http://www.youtube.com/playlist?list=PL02DE9846C628F23D&feature=plcp Liste aller Folgen]

==Episodenliste==
===Teil I - Basics - der Contao Aufbau===
In dieser Folge geht es um den Aufbau einer Contao Installation.<br />
Videolink : [http://www.youtube.com/watch?v=wJ-H9C8qB0Q&list=PL02DE9846C628F23D&index=1&feature=plpp_video Basics - der Contao Aufbau]
{{#widget:YouTube|id=wJ-H9C8qB0Q}}

===Teil II - Basics - Contao Module===
In dieser Folge geht es um den groben Aufbau von Contao Modulen.<br />
Videolink : [http://www.youtube.com/watch?v=41ARSujrVSA&list=PL02DE9846C628F23D&index=2&feature=plpp_video Basics - Contao Module]
{{#widget:YouTube|id=41ARSujrVSA}}

===Teil III - Framework - Class System===
In dieser Folge geht es um das Framework, konkret um die [http://www.contao-docs.org/docs/Contao/html/class_system.html Klasse System].<br />
Videolink : [http://www.youtube.com/watch?v=qmLDvyNYnqs&list=PL02DE9846C628F23D&index=3&feature=plpp_video Framework - Class System]
{{#widget:YouTube|id=qmLDvyNYnqs}}

===Teil IV - Framework - Class Input===
In dieser Folge geht es um das Framework, konkret um die [http://www.contao-docs.org/docs/Contao/html/class_input.html Klasse Input].<br />
Videolink : [http://www.youtube.com/watch?v=nuAEW7VDBC8&list=PL02DE9846C628F23D&index=4&feature=plpp_video Framework - Class Input]
{{#widget:YouTube|id=nuAEW7VDBC8}}

===Teil V - Framework - Class Database===
In dieser Folge geht es um das Framework, konkret um die [http://www.contao-docs.org/docs/Contao/html/class_database.html Klasse Database].<br />
Videolink : [http://www.youtube.com/watch?v=93duSGnf1AI&list=PL02DE9846C628F23D&index=5&feature=plpp_video Framework - Class Database]
{{#widget:YouTube|id=93duSGnf1AI}}

===Teil VI - Framework - Class Environment===
In dieser Folge geht es um das Framework, konkret um die [http://www.contao-docs.org/docs/Contao/html/class_environment.html Klasse Environment].<br />
Videolink : [http://www.youtube.com/watch?v=A4twxFrjD4A&list=PL02DE9846C628F23D&index=6&feature=plpp_video Framework - Class Environment]
{{#widget:YouTube|id=A4twxFrjD4A}}

===Teil VII - Framework - Class Config===
In dieser Folge geht es um das Framework, konkret um die [http://www.contao-docs.org/docs/Contao/html/class_config.html Klasse Config].<br />
Videolink : [http://www.youtube.com/watch?v=GxxZHx_426k&list=PL02DE9846C628F23D&index=7&feature=plpp_video Framework - Class Config]
{{#widget:YouTube|id=GxxZHx_426k}}

===Teil VIII - Sprachvariablen===
In dieser Folge geht es um die Sprachvariablen.<br />
Videolink : [http://www.youtube.com/watch?v=Xb0kIfb3z4Q&list=PL02DE9846C628F23D&index=8&feature=plpp_video Sprachvariablen]
{{#widget:YouTube|id=Xb0kIfb3z4Q}}

===Teil IX - der DCA Teil 1===
In dieser Folge geht es um das erstellen von DCAs.<br />
Code: [https://github.com/bit3archive/contao-screencast github.com bit3archive/contao-screencast]<br />
Videolink : [http://www.youtube.com/watch?v=93lkB1s5gxQ&list=PL02DE9846C628F23D&index=9&feature=plpp_video DCA Teil 1]
{{#widget:YouTube|id=93lkB1s5gxQ}}

===Teil X - der DCA Teil 2===
In dieser Folge geht es um das erstellen von DCAs.<br />
Code: [https://github.com/bit3archive/contao-screencast github.com bit3archive/contao-screencast]<br />
Videolink : [http://www.youtube.com/watch?v=nIHshZvCWIw&list=PL02DE9846C628F23D&index=10&feature=plpp_video DCA Teil 2]
{{#widget:YouTube|id=nIHshZvCWIw}}

===Teil XI - Frontend Module===
In dieser Folge geht es um das erstellen von Frontend Modulen.<br />
Code: [https://github.com/bit3archive/contao-screencast github.com bit3archive/contao-screencast]<br />
Videolink : [http://www.youtube.com/watch?v=VT6RJvuCf0I&list=PL02DE9846C628F23D&index=11&feature=plpp_video Frontend Module]
{{#widget:YouTube|id=VT6RJvuCf0I}}

===Teil XII - Inhaltselemente===
In dieser Folge geht es um das erstellen von Inhaltselementen.<br />
Code: [https://github.com/bit3archive/contao-screencast github.com bit3archive/contao-screencast]<br />
Videolink : [http://www.youtube.com/watch?v=Vp8I3XkMRUI&feature=share&list=PL02DE9846C628F23D Inhaltselemente]
{{#widget:YouTube|id=Vp8I3XkMRUI}}

===Teil XIII - der DCA Teil 3 - MetaPalettes ===
In dieser Folge geht es nochmal um den DCA. Die Erweiterung MetaPalettes und deren Funktionen werden vorgestellt.<br />
Code: [https://github.com/bit3archive/contao-screencast github.com bit3archive/contao-screencast]<br />
Videolink : [http://www.youtube.com/watch?v=S6RiX4l3qz8&feature=share&list=PL02DE9846C628F23D MetaPalettes]
{{#widget:YouTube|id=S6RiX4l3qz8}}

{{Anmerkung|Wer Hinweise oder Korrekturen hat, sollte dies hier im jeweiligem Teil tun.}}

----
--[[Benutzer:BugBuster|BugBuster]] 14:49, 21. Aug. 2012 (CEST)

MetaModels Beispiel 2

2013-06-13T17:40:36Z

Xtra: /* Einfachen Filter erstellen, BE durch FE ersetzt. */

[[Category:Admin HOWTOS]]
[[Category:MetaModels]]
=Aufgabenstellung: Frontend einrichten=
Wir haben im Backend bereits ein paar Daten (Musikstücke) erfasst und möchten diese nun im Frontend anzeigen lassen. Hierfür benötigen wir eine Übersichtseite (Liste) und eine Detailsansicht. Plus noch eine minimale Navigation, um zwischen Liste und Detailansicht hin- und herklicken zu können.
Hierbei werden wir auch die Filtertechnik von MetaModels einsetzen.

===Vorgehensschritte===
# [[MetaModels|Start: Installation]] - Download und Installation von MetaModels
# [[MetaModels_Beispiel_1|Beispiel 1: Backend einrichten]] - MetaModel erstellen, Daten erfassen
# [[MetaModels_Beispiel_2|Beispiel 2: Frontend einrichten]] - Die Inhalte im Frontend anzeigen (Liste und Detail)
# [[MetaModels_Beispiel_3|Beispiel 3: Weitere Filter einrichten]] – Inhalte auf Published setzen, einfache Select-Filter
# [[MetaModels_Beispiel_4|Beispiel 4: Weiteres MetaModels einrichten]] - komplexe Select-Filter einsetzen
# [[MetaModels_Beispiel:_Übersetzter_select|Weiteres Beispiel: Übersetzter select]] - Mehrsprachiges Select-Attribut einrichten

=Seiterstruktur anpassen=
== In der Seitenstruktur zwei leere Seiten einrichten==

[[File:mm_backend_seitenstruktur_einrichten.png|thumb|400px]]

Zuerst richten wir in der Seitenstruktur zwei neue (leere) Seiten ein.

* '''Musicbox''' (diese Seite wird die Listenansicht aufnehmen)
* '''Music''' (diese Seite wird für die Darstellung der Detailansicht verantwortlich sein)

Sowohl MetaModels als auch die später benötigten Frontend-Module werden auf diese Seiten zugreifen müssen, deswegen richten wir diese vorab ein, auch wenn noch kein Inhalt definiert ist.

==Einfachen Filter erstellen==

[[File:icons_filter.png|left|32px]]

Wir steigen nun wieder bei MetaModels bei '''Musicbox''' ein und gehen zur [[MetaModels_Backend:_Filter|MM-Backend Funktion: Filter]]

[[File:mm_backend_filter_einrichten.png|thumb|400px]]

Hier müssen wir thematisch etwas vorausgreifen, und ein Instrument bereitstellen, das bei der Einrichtung der Frontend-Ansichten in MetaModels benötigt wird: '''Wir brauchen einen Filter'''.
Bei MetaModels haben Filter eine breitere Bedeutung als dies umgangssprachlich der Fall ist. Filter steuern jede Art von Ansichtsdarstellung, sowohl im Backend als auch im Frontend. Aus der Sicht von MetaModels gibt es nicht eine Listen- und eine separate Archivansicht, wie man das z.B. von News oder Catalog her kennt. Für MetaModels ist jede Ansicht eine Listenansicht. Es ist der Filter, der bestimmt ob n Datensätze (aka Liste) oder nur 1 Datensatz (aka Detailansicht) angezeigt wird. Mit anderen Worten: Der Filter und nicht das Frontend-Modul macht den Unterschied.

* Die Filterübersicht ist noch leer (Keine Einträge gefunden).
* Klick auf '''neu'''.
* Gib einen Namen ein, z.B. "FE Link Detail" (FE steht für Frontend) und speichere.
* Die Filterübersicht zeigt nun diesen Eintrag. Wähle das rechte Icon ''Filterattribute für Filtereinstellung definieren''.
* Klick auf '''neu''' und wähle das Icon (mit Pfeil) für '''einsetzen'''.
* Nun kannst du den Typ auswählen. Wir wählen '''Einfache Abfrage'''.
* Als Attribut wählen wir "Alias" und geben noch die URL-Parameter "auto_item" mit.
* Alle weiteren Optionen bleiben leer oder nicht angeklickt. Als Template nehmen wir was vorgegeben wird: "mm_filteritem_default".
* "Speichern und Schliessen".

Der Filter "FE Link Detail" besteht nun aus einer einzigen Definition. Wir werden in einem späteren Beispiel sehen, dass ein Filter auch aus mehreren Definitionen bestehen kann. Das ist eine weitere Neuerung in MetaModels, nämlich, dass man sich im Wesentlichen seine eigenen Filter zusammenbauen kann.

'''Wichtig:''' wenn als URL-Parameter ''auto_item'' verwendet werden soll, dann muss in den System-Einstellungen im BE im Abschnitt ''Frontend-Einstellungen'' die Option '''Den auto_item-Parameter verwenden''' angehakt sein, sonst erfolgt keine Ausgabe des Details ( =>There are no items matching your search.)

=== Detail-Link anpassen===
Standardmässig wird am Ende des Items ein Link namens "Details" generiert. Dieser lässt sich umbenennen. Hierzu kann man bei '/system/config/'''langconfig.php'''' folgende Anpassungen machen. 3 Beipiele...
<source lang="php">
$GLOBALS['TL_LANG']['MSC']['details'] = '...mehr Details';
$GLOBALS['TL_LANG']['MSC']['mm_meineTabelle']['details'] = 'weiter...';
$GLOBALS['TL_LANG']['MSC']['mm_meineTabelle'][id]['details'] = 'Zurück zur Liste';
</source>
'''1. Fal'''l: Jeder Link in MetaModels wird zu '... mehr Details' umbenannt<br>
'''2. Fall''': Nur die Links in der MetaModel-Tabelle 'mm_meineTabelle' wird zu 'weiter...' umbeannt<br>
'''3. Fall''': Interessant, wenn man von der FE Detailansicht zurück zur FE Listenansicht gelangen will. In diesem Fall kann man nicht nur die MM Tabelle angeben, sondern auch die '''id''' der [[MetaModels_Backend:_Ausgabevorgaben#Einstieg|Rendereinstellung]] angeben. Beispiel:<br>
<source lang="php">
<?php
/* Put your custom configuration here */
$GLOBALS['TL_LANG']['MSC']['mm_musicbox']['details'] = 'Details';
$GLOBALS['TL_LANG']['MSC']['mm_musicbox'][4]['details'] = 'Zurück zur Liste';
?>
</source>

<div style="clear: both"></div>

==Listenansicht erstellen==

[[File:icons_ausgabevorgaben.png|left|32px]]
Wähle die MM-Backend-Funktion [[MetaModels_Backend:_Ausgabevorgaben|"Ausgabevorgaben"]]

[[File:mm_backend_FE_Listenansicht_einrichten.png|thumb|400px]]
* Die Übersichtsseite zeigt dir bereits einen Eintrag "BE Listenansicht" an. Wir klicken auf "neu"
* Gib den Namen "FE Listenansicht" an
* Als ''Template'' wählen wir "metamodel_prerendered (global scope)"
* Als ''Zielseite'' geben wir die vorhin definierte Seite "Music" an. Klicke hierzu auf das Icon "Globus" und wähle die Seite aus dem Pulldown-Menu aus.{ {link_url::xx} } wird dann automatisch eingesetzt.
* Unter ''Filter settings'' wählen wir den vorhin definierten Filter "FE Link Detail".<br>(''sollte der Filter zunächst nicht angezeigt werden, dann hilft =>speichern weiter'')
* "Speichern und schliessen"
* Nun erscheinen zwei Einträge in der Liste der Ausgabevorgaben

Mit diesen Einstellungen legen wir grob fest, welches Aussehen (Template) die Seite haben, wohin die Reise gehen wird (Zielseite) und was bei dieser Zielseite angezeigt werden soll (was durch den Filter bestimmt wird).<br>
Hinweis: Wenn wir hier keinen Filter angeben, wird später im Frontend kein "Detail"-Link erscheinen.

<div style="clear: both"></div>

==Attribute zur Listenansicht hinzufügen==

[[File:mm_backend_FE_Listenansicht_einrichten2.png|thumb|400px]]

* Klick auf das Icon rechts '''Attribute hinzufügen'''
* Wähle "Add all" (geht schneller und einfacher als alle über "neu" hinzufügen)
* Bestätige die folgenden Screens
* Lege fest, welche Attribute in der Listenansicht angezeigt werden sollen (Icon "Auge")

Man kann auch die Einstellung der Attribute anschauen, wie im letzten Screen angezeigt. Standardmäßig wird jedem Attribut zusätzlich ein Template mitgegeben. In unserem Beispiel analog dem Typ das Template "mm_attr_text (global scope)".
Man erkennt hier schon im Ansatz, dass in MetaModels praktisch jedes Detail über ein Template gesteuert wird. Was für eine mögliche Individualisierung letztlich heißt, dass man in der freien Gestaltung potentiell unendliche viele Möglichkeiten zur Verfügung gestellt bekommt.

<div style="clear: both"></div>

==Detailansicht erstellen==
[[File:icons_ausgabevorgaben.png|left|32px]]
Wähle die MM-Backend-Funktion [[MetaModels_Backend:_Ausgabevorgaben|"Ausgabevorgaben"]] (aka Rendereinstellungen).

[[File:mm_backend_FE_Detailansicht_einrichten.png|thumb|400px]]
* Die Übersichtsseite zeigt dir die Einträge "BE Listenansicht" und "FE Listenansicht" an.
* Wir klicken auf "neu"
* Gib den Namen "FE Detailansicht" an
* Als Template wähen wir "metamodel_prerendered (global scope) an.
* In diesem Fall brauchen wir weder eine Zielseite noch ein Filtersettting anzugeben, denn bis hierher und nicht weiter wollen wir gelangen
* Optional kann auch eine Weiterleitungsseite definiert und eine Filter angegeben werden, wenn man einen Link "Zurück" generieren will
* Speichern und schliessen
<div style="clear: both"></div>

[[File:mm_backend_FE_Detailansicht_einrichten_liste.png|thumb|400px]]
Es erscheinen nun drei Einträge in der Liste der Ausgabevorgaben.
* BE Listenansicht
* FE Detailansicht
* FE Listenansicht

<div style="clear: both"></div>

==Attribute zur Detailansicht hinzufügen==

[[File:mm_backend_FE_Detailansicht_einrichten2.png|thumb|400px]]

Das Vorgehen ist analog zum Punkt 4 zu verstehen. Einzig, dass wir hier am Ende alle Attribute anzeigen lassen (inkl. Bild und Beschreibung).
<div style="clear: both"></div>

==Frontend-Module erstellen==
{{Hinweis|Einige Einstellmöglichkeiten in den nachstehend beschriebenen Modulen sind erst nach einer Zwischenspeicherung des Moduls erreichbar.}}
[[File:mm_backend_FE-Module_Liste.png|thumb|400px]]

Frontend-Modul für Listenansicht einrichten:

* Wähle den ''Modultyp'' "MetaModels-Liste" aus
* Wähle das entsprechend ''MetaModel'' aus, in unserem Fall "Musicbox"
* Bei ''Sortieren nach'' und ''Sortierreihenfolge'' das gewünschte Attribut festlegen bzw. ob auf- oder absteigend sortiert werden soll
* ''Anzuwendende Filtereinstellungen'' bleibt vorläuftig leer. Das heißt soviel wie, dass wir in unserer Liste alle Datensätze (Musikstücke), die wir in unserer Musicbox erfasst haben, in der Liste anzeigen möchten
* Bei ''Eigenes Template für Datensatzliste auswählen'' den vorgegebenen Default "mod_metamodel_list" nehmen
* Bei ''Anzuwendende Rendereinstellung'' nehmen wir nun die zuvor definierte Ausgabevoreinstellung "FE Listenansicht". Damit werden nur die Daten der Felder ausgegeben, die wir unter Punkt 9 als sichtbar gekennzeichnet haben, und zwar in der dort definierten Reihenfolge

<div style="clear: both"></div>

[[File:mm_backend_FE-Module_Detail.png|thumb|400px]]

Dieses FE-Modul richten wir analog dem FE-Modul der Listenansicht ein, allerdings mit zwei wichtigen Unterschieden:

* Bei ''Anzuwendende Filtereinstellungen'' muss nun der Filter "FE Link Detail" angewählt werden. Dieser bewirkt, dass man hier, in der Detailansicht, auch nur den Datenansatz angezeigt bekommt, den man in der Listenansicht angeklickt hatte.
* Bei ''Anzuwendende Rendereinstellungen'' wählen wir die in den Ansichtsdarstellungen definierte Einstellung "FE Detailansicht". Hier werden alle Daten angezeigt, die wir unter Punkt ... als sichtbar angegeben haben. In diesem Falle alle.

<div style="clear: both"></div>

==Frontend-Module einbinden und Seitenvorschau==

[[File:mm_backend_FE-Module_einsetzen.png|thumb|400px]]

Zum Schluss bindet man die beiden Frontend-Module in den gewünschten Artikel ein.
Done.

<div style="clear: both"></div>

=Mögliches Endresultat=

==Frontend Ansicht==
Und so könnte es aussehen
* links: Die Daten werden standardmässig in kompakter Form ausgegeben
* rechts: mit etwas CSS lassen sich die Daten sowohl in der Listen- wie Detailsicht gut formatieren
* die Labels lassen sich auch ausschalten. Siehe [[MetaModels_Backend:_Eingabemaske#Backend_Liste_gestalten|hier]]
[[File:mm_frontend_beispiel.png|link=|900px]]

==HTML-Konstrukt==
Die Daten werden über das Template "metamodel_prerendered.html5" ausgegeben. Jeder Datensatz wird als '''item''' ausgegeben, dieser besteht aus den Attributen, die wir in den Rendereinstellungen definiert haben. Bei jedem Attribut wird standardmässig '''label''' und '''value''' ausgegeben.

<source lang="html4strict">

<div class="item">
<div class="field attribut1">
<span class="label">Titel des attributs1</span>
<span class="value">Wert des attribut1</span>
</div>
<div class="field attribut2">
<span class="label">Titel des attribut2</span>
<span class="value">Wert des attribut2</span>
</div>
<div class="field attribut3">
...
</div>
</div>
<div class="item>
...
</div>
<div class="item>
...
</div>

</source>

[[MetaModels_Beispiel_1|Zurück zur Beispiel 1]] | [[MetaModels_Beispiel_3|Weiter zum Beispiel 3: Weitere Filter hinzufügen]]

MetaModels Beispielprojekt

2013-05-15T07:43:03Z

Xtra: Generierungszeiten angepasst.

[[Category:Admin HOWTOS]]
[[Category:Extensions]]
[[Category:MetaModels]]
=MetaModels (aka Catalog 3) lernen an Beispielprojekten=
==Voraussetzungen==
* MetaModels ist der Nachfolger von Catalog. Der Code wurde komplett neu entwickelt. Eine Kompatibilität zu Catalog besteht nicht
* Die Bedienung und Administration von Contao sollte bekannt sein
* <span style="color:red">MetaModels setzt Contao 2.11.x voraus</span>. MetaModels läuft (noch) nicht unter Contao 3.x (Stand April 2013)
* <span style="color:red">MetaModels benötigt mindestens PHP 5.3</span>
* Bezüglich MetaModels werden keinerlei Vorkenntnisse vorausgesetzt

==Download & Installation==
* MetaModels kann (noch) nicht über die Erweiterungsverwaltung geladen werden
* Unter der URL [http://now.metamodel.me now.metamodel.me] findet sich die Möglichkeit, Installationsarchive in den Formaten '''tgz''', '''tbz''' und '''zip''' mit so genannten '''Nightly Builds''' zu laden.
* Die '''Nightly Builds''' werden stündlich mit dem aktuellsten Stand von MetaModels zum Download bereitgestellt
* Detaillierte Infos zum Download und zur Installation findet man unter [[MetaModels|MetaModels]].

==Umsetzungsbeispiele==
Wir werden eine Verwaltung unserer Musiksammlung erstellen und uns in mehreren Beispielen schrittweise von einer einfachen zu komplexeren Anwendungen vorarbeiten.
# [[MetaModels_Beispiel_1|Backend einrichten]] - Eingeben der Sammlung
# [[MetaModels_Beispiel_2|Frontend einrichten]] - Die Inhalte im Frontend anzeigen (Liste und Detail)
# [[MetaModels_Beispiel_3|Weitere Filter einrichten]] – Inhalte auf Published setzen, einfache Select-Filter
# [[MetaModels_Beispiel_4|Weiteres MetaModels einrichten]] - komplexe Select-Filter einsetzen

MetaModels Beispielprojekt

2013-02-19T13:34:25Z

Xtra: Fixed nightly download links

{{stub}}
[[Category:Admin HOWTOS]]
[[Category:Extensions]]
[[Category:MetaModels]]
=Beispielprojekt mit MetaModels (aka Catalog 3)=
{{msgInfo|Hier entsteht anhand eines Beispielprojektes die Beschreibung der wichtigsten Möglichkeiten der neuen [[MetaModels|MetaModels]] in einem Contao 2.11.6ff.<br/>
Die Bedienung und Administration von Contao sollte bekannt sein.<br/>
Bezüglich der MetaModels werden keinerlei Vorkenntnisse vorausgesetzt.

Dieser Beitrag entsteht 'learning by doing'. Er enthält also immer den aktuellen Wissensstand des/der Autoren. Auftretende Fragen werden hier vermerkt und ebenso [https://community.contao.org/de/showthread.php?36679-MetaModels-erste-Versuche-im-Wiki im Community-Forum] gestellt. Sobald eine Lösung gefunden wurde, wird die Frage hier im Wiki durch eine passende Beschreibung ersetzt.}}

==Die Aufgabenstellung==
Wir möchten eine Sammlung traditioneller Folkmusik aufbauen, die im BE durch Redakteure gepflegt werden kann, (die sich nicht mit MetaModels auseinandersetzen müssen). Im FE soll man die Sammlung nach unterschiedlichen Kriterien filtern und durchsuchen können.
In der Detail-Ansicht werden alle verfügbaren Informationen zu einem Stück angezeigt.

==Vorbereitungen==
Wir gehen davon aus, dass Contao 2.11.6 (oder eine neuere 2.11) installiert ist.

Aktuell gibt es MetaModels noch nicht im Extension Repository. Man muss sich darum den Code von GitHub laden.
{{Hinweis|Es geht jetzt auch einfacher als im Folgenden beschrieben, da die Entwickler nun den jeweils aktuellen Entwicklungsstand zum Download anbieten:
als [http://now.metamodel.me/tl_files/metamodels-nightly.zip ZIP],
als [http://now.metamodel.me/tl_files/metamodels-nightly.tar.gz TAR GZ]
oder als [http://now.metamodel.me/tl_files/metamodels-nightly.tar.bz2 TAR BZ2]

siehe dieser [https://community.contao.org/de/showthread.php?36716-Wo-kann-man-MetaModels-herunterladen&p%61241122&viewfull%611#post241122 Beitrag im Forum]

Das Archiv wird in den Installationsordner von Contao entpackt.}}

'''Die folgende Beschreibung ist veraltet --------------------------'''<br/>
... führt allerdings zur noch aktuelleren Version

Dies geht am einfachsten auf einem Linux-Rechner mit lokalem Webserver für die Tests oder auf einem Linux-Server mit Shell-Zugang.<br/>
Unter Windows kann dasselbe mit cygwin erreicht werden, oder man verwendet einen Git-Client für Windows und kopiert die erhaltenen Quelldateien in die Contao-Installation.

Zunächst legt man sich einen Ordner an, in den die Quellen herunter geladen werden sollen und wechselt dahin.
<source lang="bash">
cd ~
mkdir MetaModels
cd MetaModels
</source>
Dann wird MetaModels einschließlich aller Unterprojekte heruntergeladen:
<source lang="bash">
for i in `wget -qO- https://api.github.com/orgs/MetaModels/repos | \
grep clone_url | \
cut -d \" -f4`; do \
git clone $i; \
done;
</source>
Die erzeugten Ordnerstrukturen enthalten jeweils (bis auf '''DC_General''') einen Ordner '''src'''. Darin befindet sich der Teil der Quellen, die in die Contao-Installation übernommen werden müssen. In '''DC_General''' befindet sich direkt der Ordner '''system'''.

Die '''system'''-Ordner müssen jeweils in die Contao-Installation kopiert werden. Dazu kann man folgendes Script in eine Datei '''copy2contao.sh''' im MetaModels-Ordner kopieren ('''das_contao_verzeichnis''' ersetzen durch Pfad zum Contao-Installationsordner):
<source lang="bash">
#!/bin/bash
CONTAO=das_contao_verzeichnis/
for i in `ls -d *`;
do
if [ $i = "copy2contao.sh" ]; then
continue;
fi;
if [ $i = "DC_General" ]; then
echo copying $i/system to $CONTAO
cp -r $i/system $CONTAO;
else
echo copying $i/src/ to $CONTAO
cp -r $i/src/* $CONTAO;
fi;
done;
</source>
Schließlich diese Datei ausführbar machen und starten:
<source lang="bash">
chmod +x ./copy2contao.sh
./copy2contao.sh
</source>

'''------------------------- Ende der veralteten Beschreibung'''

Jetzt muss noch im Contao-Backend die Datenbank aktualisiert werden: '''Erweiterungsverwaltung | Datenbank aktualisieren'''

==Unser Datenmodell==
Jetzt geht es wirklich los!

Im Backend unter [''System''] befindet sich ein neuer Eintrag [''MetaModels''], über den ein neues MetaModel angelegt wird.<br/>
Für unsere Aufgabenstellung wählen wir<br/>
* Name: '''TuneBook'''<br/>
* TabellenName: '''mm_tunebook'''

Da noch nicht klar ist, ob die Seite vielleicht einmal mehrsprachig wird, bereiten wir das MetaModel direkt auf diesen Fall vor:<br/>
* Übersetzung '''anhaken'''<br/>
* Eine Sprache '''Deutsch''' legen wir dann auch an und machen sie zum Fallback.<br/>
[[Datei:MetaModels_Screen_TuneBook.png]]
{{msgQuestion | Unter den [''Experteneinstellungen''] befindet sich noch eine Option [''Varianten aktivieren''],<br/>
deren Bedeutung sich auch mit der angezeigten Erklärung einem Neuling nicht erschließt.<br/>
Wir aktivieren sie zunächst nicht.}}
Jetzt werden die Attribute definiert, die eines der Musikstücke in unserer Sammlung ausmachen.<br/>
Klick auf das rot markierte Icon:<br/>
[[Datei:MetaModels_Screen_Attribute_definieren.png]]

Gib nun wie unten aufgelistet die neuen Attribute ein:<br/>
[[Datei:MetaModels_Screen_Attribute_hizufuegen.png]]<br/>
[[Datei:MetaModels_Screen_Attribute_bearbeiten.png]]

{|
|'''Titel'''
|
* Attribute Type = Text
* Column name = title
* Name (deutsch) = Titel
* Description (deutsch) = Name des Stücks
|-
|'''Typ'''
|
* Attribute Type = Text
* Column name = type
* Name (deutsch) = Typ
* Description (deutsch) = Rhythmus / Tanzart
|-
|'''Herkunftsland'''
|
* Attribute Type = Text
* Column name = country
* Name (deutsch) = Herkunftsland
* Description (deutsch) =
|-
|'''Region'''
|
* Attribute Type = Text
* Column name = region
* Name (deutsch) = Region
* Description (deutsch) = für eine feinere geographische Zuordnung als das Herkunftsland
|-
|'''Quelle'''
|
* Attribute Type = Text
* Column name = source
* Name (deutsch) = Quelle
* Description (deutsch) = Notenbuch / Sammlung / Kurs
|-
|'''Komponist/Urheber'''
|
* Attribute Type = Text
* Column name = composer
* Name (deutsch) = Komponist/Urheber
* Description (deutsch) =
|-
|'''ABC-Notation'''
|
* Attribute Type = Longtext
* Column name = abc
* Name (deutsch) = ABC-Notation
* Description (deutsch) = Hier kann das Stück in ABC-Notation eingegeben werden, die auf der Seite z.B. auch in Notenschrift gewandelt werden kann.
|-
|'''Zusatz-Informationen'''
|
* Attribute Type = Übersetzter Longtext
* Column name = info
* Name (deutsch) = Zusatz-Informationen
* Description (deutsch) = Beliebige zusätzliche Infos zu dem Stück, wie Anekdoten, Links zu Fundstellen von Hörbeispielen im Netz usw.
|-
|colspan="2"|Man soll die Veröffentlichung von Einträgen steuern können. Also wird ein weiteres Attribut angelegt:<br/>
|-
|'''Veröffentlicht'''
|
* Attribute Type = Checkbox
* Column name = published
* Name (deutsch) = Veröffentlicht
* Description (deutsch) =
* check publish = aktiviert<br/>(vermutlich erzeugt diese Option die gewünschte Funktionalität)
|-
|colspan="2"|Bis jetzt wurde bei keinem der Attribute die Option '''Unique values''' aktiviert.<br/>Um die Einträge eindeutig identifizieren zu können, wird zusätzlich ein Alias-Attribut erzeugt:
|-
|'''Alias'''
|
* Attribute Type = Alias
* Column name = alias
* Name (deutsch) = Alias
* Description (deutsch) =
* Unique values = aktiviert
* Alias fields = Titel
* Force alias regenerating = aktiviert<br/>(dann muss kein Alias eingegeben werden, wird neu berechnet bei Änderung des Titels)
|}

Deine Attributs-Liste sollte nun wie folgt aussehen:<br/>
[[Datei:MetaModels_Screen_Attribute_Liste.png]]

{{msgQuestion | Trotz der möglichen Mehrsprachigkeit wurden die meisten Attribute vom Typ '''Text''' und nicht '''Übersetzter Text''' angelegt.<br/>Nur für die '''Zusatz-Informationen''' wurde ein übersetztes Attribut gewählt, da die Beschreibung eines Stücks ggf. in eine andere Sprache übersetzt wird.

Ist diese Überlegung richtig?}}

==Backend für Redakteure einrichten==
Die Einstellungen im Backend unter [''MetaModels''] dienen der Definition unseres Datenmodells und verschiedener Ansichten der Daten. Für einen Redakteur sollte das Backend eher so aussehen, als wenn es genau für seine Aufgabe maßgeschneidert ist: in diesem Fall die Verwaltung von Musikstücken in der Sammlung.

Und genau das können die MetaModels leisten!<br/>
Zunächst definieren wir, welche Attribute in der Backend-Liste angezeigt werden sollen. Dazu wird zunächst eine ''Ausgabevorgabe'' angelegt:<br/>[[Datei:MetaModels_Ausgabevorgabe.png]]<br/>
{{msgQuestion|''Ausgabevorgaben'' werden an anderen Stellen innerhalb MetaModels auch als ''Renderereinstellungen''(Modul MetaModels-Liste) oder als ''Ansicht''(Paletten- und Ansichtseinstellungen) bezeichnet.

Vielleicht sollte die Nomenklatur vereinheitlicht werden.}}

Auf der neu erscheinenden Backend-Seite <span style="color:blue;">(die leider durch nichts als ''Ausgabevorgabe''-Seite zu erkennen ist)</span> wird per [''Neu''] eine neue ''Ausgabevorgabe'' erzeugt.<br/>
[[Datei:MetaModels_Screen_Template_neu.png]]

Wir geben ihr den Namen '''Liste Backend''', alle anderen Einstellungen ändern wir nicht.<br/>Mit [''speichern und schließen''] gelangt man zurück zur Liste der Ausgabevorgaben.<br/>
[[Datei:MetaModels_Screen_Template_bearbeiten.png]]

Über das rechte Icon gelangt man in den Dialog zur Bearbeitung.<br/>
[[Datei:MetaModels_Screen_Template_Liste.png]]

Am Einfachsten wählt man [''Add all''] um alle vorhandenen Attribute der Vorgabe hinzuzufügen. Die Attribute könnten auch gezielt oder in einer speziellen Reihenfolge einzeln hinzugefügt werden.<br/>
[[Datei:MetaModels_Screen_Template_Liste_AddAll.png]]
[[Datei:MetaModels_Screen_Template_Liste_AddAll_Weiter.png]]

Über das übliche 'Auge' werden nur die Attribute sichtbar gemacht, die in der Backend-Liste angezeigt werden sollen: '''Titel''', '''Typ''' und '''Herkunftsland'''.[[Datei:MetaModels_Screen_Template_Liste_AddAll_Ende.png]]

Per [''zurück''] kommen wir wieder zur Liste der Ausgabevorgaben. <span style="color:blue;">Ein weiteres [''zurück''] führt uns leider nicht auf die Grundseite der MetaModels.</span> Also müssen wir über das Hauptmenü dorthin navigieren.

Jetzt soll der Menüpunkt für die Redakteure erstellt werden:<br/>
Man gelangt per [[Datei:MetaModels_Paletteneinstellungen.png]] in eine Liste, in der über [''Neue Palette''] der Menü-Eintrag definiert wird.[[Datei:MetaModels_Screen_Palette_neu.png]]

{|
|colspan="2"|Wir wählen die folgenden Einstellungen:
|-
|'''Name'''||Trad.-Liste
|-
|'''als Standard benutzen'''||aktivieren <span style="color:blue;">sonst wird der Menüpunkt nicht angezeigt.<br/>vielleicht sollte die Bezeichnung dieser Option geändert werden.</span>
|-
|'''Panel-Layout'''||filter;search,limit<br/>Hier werden die im BE angezeigten Elemente und deren Reihenfolge und Position festgelegt.
|-
|'''Integration'''||Als Einzeltabelle (wir haben ja nur eine...), die weiteren Optionen erscheinen erst nach der Auswahl.
|-
|'''Sortiermodus'''||Datensätze nach wählbarem Feld sortiert darstellen
|-
|'''Sortierung'''||Nach erstem Buchstaben absteigend sortieren
|-
|'''Backend-Bereich'''||Inhalte
|-
|'''Backend-Icon'''||hier könnten wir das Icon für das Menü festlegen - erstmal wählen wir nichts und lassen es bei dem automatisch vergebenen Icon.
|-
|'''Backend-Beschreibung'''||
* '''Sprache''' Deutsch
* '''Menütext''' Trad.-Sammlung
* '''Beschreibung''' Sammlung traditioneller Folkmusik
|-
|colspan="2"|[''speichern und schließen'']
|}.<br/>
[[Datei:MetaModels_Screen_Palette_bearbeiten.png]]

{{msgQuestion|Der Hilfsdialog, der über das kleine Symbol rechts neben dem Eingabefeld [''Panel-Layout''] aufgerufen werden kann, fügt kein Komma oder Semikolon ein, was aber im Hilfetext angegeben wird.<br/>
Außerdem erscheint und verschwindet das Eingabefeld [''Sortierung''] unter nicht ganz nachvollziehbaren Randbedingungen. Man würde erwarten, dass es nur angezeigt wird, wenn bei [''Sortiermodus''] ein sortierender Modus gewählt wurde.}}

Über das rechte Icon wird das Backend definiert.<br/>
[[Datei:MetaModels_Screen_Palette_Liste.png]]

Man gelangt in eine neue Liste und wählt am Einfachsten [''alle hinzufügen''] um alle vorhandenen Attribute der BE-Bearbeitung hinzuzufügen.<br/>
[[Datei:MetaModels_Screen_Palette_Liste_AddAll.png]] [[Datei:MetaModels_Screen_Palette_Liste_Weiter.png]]

Für jedes der Attribute kann nun eingestellt werden, ob es sich um ein Pflichtfeld handelt, ob nach diesem Attribut filterbar, sortierbar oder durchsuchbar sein soll.<br/>
[[Datei:MetaModels_Screen_Palette_Liste_Ende.png]]

Für unsere Musiksammlung wählen wir die folgenden Einstellungen:<br/>
{|
!Attribut
!Pflichtfeld
!Filterbar
!Sortierbar
!Durchsuchbar
|-
|'''Titel'''||x|| ||x||x
|-
|'''Alias'''|| || || ||
|-
|'''Typ'''|| ||x|| ||
|-
|'''Herkunftsland'''|| ||x|| ||
|-
|'''Region'''|| ||x|| ||
|-
|'''Quelle'''|| || || ||x
|-
|'''Komponist/Urheber'''|| || || ||x
|-
|'''ABC-Notation'''|| || || ||
|-
|'''Zusatz-Informationen'''|| || || ||x
|-
|'''Veröffentlicht'''|| ||x|| ||
|}

Schließlich wird der Editor für Paletten- und Ansichts-Optionen geöffnet. [[Datei:MetaModels_Paletten_Ansicht.png]]<br/>
Hier wird zunächst folgendes eingestellt:
{|
|-
|'''FE-Gruppe'''||-
|-
|'''BE-Gruppe'''||Administrator
|-
|'''Palette wählen'''||Trad.-Liste
|-
|'''Ansicht wählen'''||Liste Backend<br/>Dies ist die vorhin angelegte Ausgabevorgabe
|}
[[Datei:MetaModels_Screen_Ansicht_bearbeiten.png]]

Jetzt gibt es im Menü [''Backend-Module''] einen neuen Eintrag im Bereich [''Inhalte''] mit der von uns gewählten Bezeichnung [''Trad.-Sammlung''].<br/>
Dieser Punkt soll von den Redakteuren verwendet werden.<br/>
(Dazu wird dann später als BE-Gruppe die Gruppe der Redakteure eingetragen.)<br/>
[[Datei:MetaModels_Screen_Backend_Module.png]]

Es erscheint eine Contao-typische Liste, die mit Einträgen in unsere Sammlung gefüllt werden kann.<br/>
[[Datei:MetaModels_Screen_Backend_Module_Liste.png]]<br/>
Oberhalb der Liste erscheinen die Filter- und Sortier-Elemente, die unter [''Panel-Layout''] oben definiert wurden. Es wurde dort auch die Reihenfolge und Position festgelegt.

Testweise tragen wir im Backend verschiedene Musikstücke ein und achten darauf, dass unterschiedliche Inhalte bei '''Herkunftsland''' und '''Typ''' eingetragen sind.

==Anzeige der Daten im Frontend (Liste)==
Um die eingetragenen Stücke im Frontend anzuzeigen brauchen wir zunächst eine Ausgabevorgabe, die wir unter [''MetaModels''] anlegen [[Datei:MetaModels_Ausgabevorgabe.png]]<br/>
Die neue Vorgabe nennen wir '''Trad-Liste FE'''.<br/>
Am Einfachsten fügen wir per [''Add all''] alle Attribute ein.
Für die Liste im Frontend reicht es in unserem Beispiel aus, nur den '''Titel''', den '''Typ''' und das '''Herkunftsland''' auszugeben. Also wählen wir diese Attribute mit dem 'Auge' aus.

Damit nur die veröffentlichten Einträge im FE angezeigt werden, richten wir einen Filter ein
[[Datei:MetaModels_Filter.png]]<br/>
Der Filter wird per [''Neu''] angelegt und soll '''Published Filter''' heißen. Zur Bearbeitung gelangt man über das rechte Icon. Hier fügen wir eine [''Einfache Abfrage''] hinzu mit folgenden Einstellungen:
{|
|-
|'''Typ'''||Einfache Abfrage
|-
|'''Aktivieren'''||Haken gesetzt
|-
|'''Attribut'''||veröffentlicht [checkbox]
|-
|'''URL-Parameter'''||(kann leer bleiben)
|-
|'''Allow empty value'''||kein Haken
|-
|'''Static Parameter'''||Haken gesetzt
|} [[Datei:MetaModels_Screen_Filter_bearbeiten.png]]
[Speichern und schließen]

Dann benötigen wir noch ein Modul vom Typ ''MetaModels-Liste'' namens '''Tunebook'''. Die vorgeschlagenen Einstellungen werden weitgehend übernommen. Wichtig sind zunächst nur
{|
|-
|'''MetaModel'''||TuneBook
|-
|'''Sortieren nach'''||Titel
|-
|'''Anzuwendende Filtereinstellungen'''||Published Filter
|-
|'''Filter value for attribute "veröffentlicht"'''||1<br/>dies ist der Wert, der im Filter erfüllt sein muss. Dadurch werden also nur veröffentlichte Einträge ausgegeben.
|-
|'''Anzuwendende Rendereinstellung'''||Trad-Liste FE<br/>die ''Ausgabevorgabe''
|}
[[Datei:MetaModels_Screen_Modul_Liste.png]]
[Speichern und schließen]

Schließlich wird eine neue Seite angelegt und im Artikel das gerade angelegte Modul eingefügt.

Die Seite im Frontend zeigt die eingetragenen und veröffentlichten Stücke an, allerdings noch nicht besonders schön formatiert.

==Detailseite==
Jetzt hätten wir natürlich gerne einen Link bei jedem Eintrag in der angezeigten Liste, über den eine Detail-Seite aufrufbar ist.<br/>
Es wird als erstes eina Ausgabevorgabe für die Detailseite angelegt [[Datei:MetaModels_Ausgabevorgabe.png]]<br/>
Die neue Vorgabe nennen wir '''Trad-Liste Detail'''.<br/>
Es werden wieder alle Attribute eingefügt ([''Add all'']) und diesmal wählen wir mit dem 'Auge' alle Attribute bis auf '''Alias''' und '''veröffentlicht''', da ja die vollständige Information ausgegeben werden soll.

Weiterhin legen wir einen neuen Filter namens '''Tune-Alias Filter''' an. [[Datei:MetaModels_Filter.png]]<br/>
Dort wird eine '''Einfache Abfrage''' eingefügt, die natürlich aktiviert wird, wir wählen als Filter-Attribut '''Alias'''. Der URL-Parameter kann leer bleiben, auch die weiteren Optionen werden nicht ausgewählt.

Dann benötigen wir ein weiteres Modul vom Typ ''MetaModels-Liste''. Wir nennen es '''Tune-Detail''' und verwenden folgende Einstellungen:
{|
|-
|'''MetaModel'''||TuneBook
|-
|'''Elemente pro Seite'''||1
|-
|'''Sortieren nach'''||-
|-
|'''Anzuwendende Filtereinstellungen'''||Tune-Alias Filter (der eben angelegte Filter)
|-
|'''Anzuwendende Rendereinstellung'''||Trad-Liste Detail
|}

[Speichern und schließen]

Dann wird auch hier eine neue Seite angelegt und im Artikel das gerade angelegte Modul eingefügt.

Schließlich kehren wir zurück zur Ausgabevorgabe '''Trad-Liste FE''' und ändern deren Einstellungen (über das Stift-Symbol):
Bei '''Jump to page''' selektieren wir über den kleinen Globus die eben angelegte Detail-Seite, zu der ein Link in der Liste erzeugt werden soll, und stellen bei '''Filter settings''' wieder den '''Tune-Alias Filter''' ein.

[Speichern und schließen]

Wenn alles geklappt hat, dann wird jetzt im Frontend in der Liste bei jedem Eintrag ein Link '''Details''' angezeigt. Dieser Link leitet zur Detailseite weiter, deren URL das Wort '''alias''' und den Alias des angeklickten Stücks enthält.<br/>
Auf der Detailseite werde alle eingegebenen Informationen des jeweiligen Stücks ausgegeben.<br/>
Hurra!

==Filtern und Sortieren im Frontend==

MetaModels

2012-12-07T16:40:12Z

Xtra: Alles auf einen Rutsch via git und Kommandozeile

{{stub}}
[[Category:Extensions]]
[[Category:MetaModels]]
{{ExtInfo
| Dev=Metamodels Team
| DevSite=
| Version=ab 2.11.X
| ERLink=
| VCSLink=https://github.com/MetaModels/core
| TrackerLink=https://github.com/MetaModels/core/issues
| Depending=[[DC_General]] [[Justtextwidgets]] [[MultiColumnWizard]] [[MetaPalettes]]
}}

=Start der Wiki-Dokumentation der Erweiterung MetaModels (Nachfolger des Catalog)=

{{Hinweis|Installation von MetaModels aus GitHub}}

Zu finden ist die Erweiterung MetaModels auf GitHub:
[https://github.com/MetaModels]

Aktuell wird diese und dazu abhängige weitere Erweiterungen manuell installiert.

Benötigt werden folgende Erweiterungen:

* [https://github.com/MetaModels/core Das Core-Modul]
* [https://github.com/MetaModels DC_General]
* [https://contao.org/de/extension-list/view/MetaPalettes.html MetaPalettes]
* [http://www.contao.org/erweiterungsliste/view/MultiColumnWizard.html MultiColumnWizard],
* [https://github.com/Discordier/justtextwidgets justtextwidgets]

==Verfügbare Attribute==

Sobald diese Erweiterungen installiert sind, werde die weiteren Attributsextensions des MetaModels benötigt.
Dazu gehören:

* [https://github.com/MetaModels/attribute_text Attribut: Text]
* [https://github.com/MetaModels/attribute_checkbox Attribut: Checkbox]
* [https://github.com/MetaModels/attribute_decimal Attribut: Dezimal]
* [https://github.com/MetaModels/attribute_file Attribut: Dateien]
* [https://github.com/MetaModels/attribute_select Attribut: Select]
* [https://github.com/MetaModels/attribute_alias Attribut: Alias]
* [https://github.com/MetaModels/attribute_longtext Attribut: Langtext]
* [https://github.com/MetaModels/attribute_numeric Attribut: Numerisch]
* [https://github.com/MetaModels/attribute_langcode Attribut: Sprachencode]
* [https://github.com/MetaModels/attribute_tags Attribut: Tags]
* [https://github.com/MetaModels/attribute_geoprotection Attribut: Länderzuordnung]

* [https://github.com/MetaModels/attribute_translatedalias Attribut: Translated Alias]
* [https://github.com/MetaModels/attribute_translatedfile Attribut: Translated File]
* [https://github.com/MetaModels/attribute_translatedlongtext Attribut: Translated Longtext]
* [https://github.com/MetaModels/attribute_translatedselect Attribut: Translated Select]
* [https://github.com/MetaModels/attribute_translatedtags Attribut: Translated Tags]
* [https://github.com/MetaModels/attribute_translatedtext Attribut: Translated Text]

=Alles auf einen Rutsch via git und Kommandozeile=
In einer bash (Linux Kommandozeile bzw. cygwin Kommandozeile) kann man sich auch alle Unterprojekte der MetaModels via git clonen. Man sollte jedoch vorher in den Ordner wechseln, wohin die Projekte heruntergeladen werden sollen.
<source lang="bash">
for i in `wget -qO- https://api.github.com/orgs/MetaModels/repos | \
grep clone_url | \
cut -d \" -f4`; do \
git clone $i; \
done;
</source>

----
started by: [[Benutzer:Planepix|Planepix]] 00:49, 28. Nov. 2012 (CET)

MetaModels

2012-11-28T00:28:52Z

Xtra: Extension info template

Die erste Webseite - Header und Footer

2012-04-18T11:44:34Z

Xtra:

[[Category:Erste Schritte]]
{{AppliesTo
|Version=Alle Versionen}}
== Einleitung ==
Nachdem man [[Die erste Webseite|die erste Webseite]] erstellt hat, taucht meistens die Frage auf: "Wie erzeugt man einen Header|Footer, der auf allen Seiten erscheint?" In diesem Tutorial wird solch ein Header und Footer erstellt, welcher im Nachhinein ohne HTML-Kenntnisse verändert werden kann.

== Neue Seite RESOURCES ==
Als erstes erstellt man eine neue Seite "RESOURCES", welche '''nicht''' veröffentlicht wird.
[[Datei:Die_erste_Webseite_-_Header_und_Footer_-_Seite_RESOURCES.png|Neue Seite RESOURCES, nicht veröffentlicht, nicht durchsuchen - Contao 2.9.3|frame|center]][[Datei:Die_erste_Webseite_-_Header_und_Footer_-_Seitenstruktur.png|Neue Seitenstruktur - Contao 2.9.3|frame|center]]

== Artikel "Header" ==
Unter Inhalte --> Artikel sieht man, dass automatisch ein Artikel "RESOURCES" erstellt wurde.
[[Datei:Die_erste_Webseite_-_Header_und_Footer_-_Artikel.png|Artikel - Contao 2.9.3|frame|center]]
Das Veröffentlichungs-Symbol ist grau, weil die Seite nicht veröffentlicht wurde. Mit einem Klick auf das Symbol veröffentlicht man nun diesen Artikel. Das Symbol ist jetzt grün.

Mit einem Klick auf den Bleistift öffnet man den Artikel. Der Text "Keine Einträge gefunden." signalisiert, dass der Artikel noch keine Inhalte hat. Dieser Artikel RESOURCES wird als Artikel für den Header genutzt. Mit einem weiteren Klick auf den Bleistift gelangt man in die Eigenschaften des Artikels. Er wird umbenannt von "RESOURCES" nach "Header".
[[Datei:Die_erste_Webseite_-_Header_und_Footer_-_Artikel_Header.png|Artikel umbenennen - Contao 2.9.3|frame|center]]
Den Artikelalias "resources" entfernt man, damit beim Speichern automatisch der Artikelalias "header" erzeugt wird.

=== Header Inhalt ===
Im Artikel "Header" erstellt man ein CE (Inhaltselement) vom Typ "Text". Dort wird der gewünschte Inhalt eingetragen. Man kann auch direkt ein Bild als Logo auswählen und es als Bildlink auf die Homepage setzen.
[[Datei:Die_erste_Webseite_-_Header_und_Footer_-_CE_Header.png|CE Typ Text für den Header - Contao 2.9.3|frame|center]]

== Artikel "Footer" ==
In der Artikelübersicht erstellt man jetzt unterhalb des Artikels "Header" einen zweiten Artikel "Footer".
[[Datei:Die_erste_Webseite_-_Header_und_Footer_-_Artikel_Header_und_Footer.png|2 Artikel "Header" und "Footer" auf der Seite RESOURCES - Contao 2.9.3|frame|center]]
[[Datei:Die_erste_Webseite_-_Header_und_Footer_-_Artikel_Footer.png|Artikel "Footer" benennen und veröffentlichen - Contao 2.9.3|frame|center]]

=== Footer Inhalt ===
Wieder wird in dem Artikel ein CE vom Typ ''Text'' erstellt. Diesmal mit dem Inhalt für den Footer.
[[Datei:Die_erste_Webseite_-_Header_und_Footer_-_CE_Footer.png|CE Typ Text für den Footer - Contao 2.9.3|frame|center]]

== Module erstellen ==
Bis hierhin hat man jetzt eine versteckte Seite in der Seitenstruktur erstellt, welche 2 veröffentlichte Artikel enthält: einen für den Footer und einen für den Header. Wie bekommt man diese Artikel nun so auf die Website, dass sie auf allen Seiten erscheinen? Für die seitenweite Einbindung von Inhalten sind die Module zuständig, denn ein Modul kann man im Seitenlayout in einen Layoutbereich einbinden.

Über Layout --> Themes --> Modul-Icon gelangt man zu den Modulen. Man erstellt jeweils ein Modul vom Typ "Eigener HTML-Code" für den Header und für den Footer.
[[Datei:Die_erste_Webseite_-_Header_und_Footer_-_Module.png|2 neue Module vom Typ "Eigener HTML-Code" - Contao 2.9.3|frame|center]]
In dem Feld "HTML-Code" benutzt man [[Insert-Tags]] um die entsprechenden Artikel auszugeben. Einmal insert_article::header und einmal insert_article::footer.
[[Datei:Die_erste_Webseite_-_Header_und_Footer_-_Modul_Header.png|Hier wird ein Artikel über einen Inserttag ausgegeben - Contao 2.9.3|frame|center]]

== Module ausgeben ==
Damit diese Module im FE (Frontend) ausgegeben werden geht man über Layout --> Themes --> Layout-Icon-Bleistift ins Standard-Layout und bindet die 2 Module entsprechend ein.
Gleichzeitig ändert man noch die Höhe von Header und Footer, da diese in der Beispielseite ein wenig zu niedrig ausgefallen sind.
[[Datei:Die_erste_Webseite_-_Header_und_Footer_-_Layout.png|Das Standard-Layout wird verändert - Contao 2.9.3|frame|center]]

== Resultat ==
Im FE sieht man nun, dass auf allen Seiten der Header und Footer erscheint. Beide Elemente sind im BE (Backend) auch ohne HTML-Kenntnisse leicht zu verwalten.
[[Datei:Die_erste_Webseite_-_Header_und_Footer_-_Resultat.png|Ergebnis im FE - Contao 2.9.3|frame|center]]

Facebook

2012-04-18T11:44:02Z

Xtra:

[[Category:Admin HOWTOS]]
=Einleitung=
Diese Anleitung soll dazu dienen, Facebook Plugins (Kommentare, Share, Like, ...) in eine Contao Seite einzubauen. Die Beispiele basieren auf dem Nachrichtensystem von Contao (kann jedoch auch einfach auf ein anderes Modul geändert werden - e.g Events).

=Facebook Plugins via eigener Facebook App=
Zuerst muss auf Facebook eine sog. Facebook App erstellt werden - diese kann man, sofern man sich als "Entwickler" bestätigt hat (kann via SMS vorgenommen werden), mit seinem Facebook Benutzerprofil erstellen.
==Facebook==
===Facebook App===
Auf der [http://www.facebook.com/developers/createapp.php Facebook Entwicklerseite] folgt man den Anweisungen von Facebook (siehe Bilder).

[[Datei:Fb-app-erstellen-001.jpg|Facebook Anwendung erstellen - Generelle Info|frame|center]]

[[Datei:Fb-app-erstellen-002.jpg|Facebook Anwendung erstellen - Info|frame|center]]

[[Datei:Fb-app-erstellen-003.jpg|Facebook Anwendung erstellen - Webseite|frame|center]]

===Abschluss (seitens Facebook)===
Nun hat man seine Facebook App erstellt und einige Informationen bekommen, welche man in Contao "verbauen" muss - hier eine Übersicht mit allen benötigten Informationen.

<source lang="html4strict">
<meta property="fb:app_id" content="......"/> (Facebook App ID - siehe Bild 3, rote Zahl)
<meta property="fb:admins" content=""/> (deiner Benutzer ID vo Facebook - siehe Bild 2, zweite rote Beschriftung)
</source>

Das wäre es vorerst von der Facebook Seite. Nun muss man das Ganze in Contao einbauen.

==Contao CMS==
Damit die Facebook Plugins richtig eingebunden werden können, müssen Templates angepasst und das Seitenlayout erweitert werden.

===fe_page.tpl===
Beim Template sollte der Doctype angepasst werden (u.a wegen Internet Explorer). Dazu [[Templates_bearbeiten|erstellt]] man im Backend ein neues "fe_page.tpl" Template. Der Name ist frei wählbar, muss jedoch mit ''fe_'' beginnen - in diesem Beispiel wird das Template "fe_page_facebook.tpl" benannt.
<source lang="php">
<?php echo $this->doctype; ?>
<html xmlns="http://www.w3.org/1999/xhtml" xml:lang="<?php echo $this->language; ?>" lang="<?php echo $this->language; ?>">
</source>
muss geändert werden zu
<source lang="php">
<?php echo $this->doctype; ?>
<html xmlns="http://www.w3.org/1999/xhtml" xml:lang="<?php echo $this->language; ?>" lang="<?php echo $this->language; ?> xmlns:fb="http://www.facebook.com/2008/fbml" xmlns:og="http://opengraphprotocol.org/schema/" xmlns:fb="http://developers.facebook.com/schema/">
</source>

Zusätzlich wurden noch folgende [http://developers.facebook.com/docs/opengraph/ Open Graph Tags] von Facebook in das Template eingetragen, welche dann mit den vorhanden Informationen ausgestattet werden (vor </head> Abschluss)

<source lang="html4strict">
<meta property="og:title" content="<?php echo $this->pageTitle; ?> - <?php echo $this->mainTitle; ?>"/>
<meta property="og:type" content="blog"/> (Art der Seite - blog, news, ...)
<meta property="og:site_name" content="..."/> (Seitenname)
<meta property="og:description" content="<?php echo $this->description; ?>"/>
</source>

===Seitenlayout===
Bevor man die anderen [[Templates_bearbeiten|Templates]] bearbeitet, sollte das Seitenlayout mit den Facebook Informationen ([[Facebook#Abschluss_.28seitens_Facebook.29|2.1.2 Abschluss (seitens Facebook]]) befüllt werden.

'''Zusätzliche <head>-Tags'''
<source lang="html4strict">
<meta property="fb:app_id" content="......"/>
<meta property="fb:admins" content=""/>
</source>

'''Eigener JavaScript-Code'''
<source lang="html4strict">

<div id="fb-root"></div>
<script src="http://connect.facebook.net/en_US/all.js"></script>
<script type="text/javascript">
<![CDATA[//><!]]>
</script>

</source>

===absolute Pfade für die Bilder via Modul===
Wenn eine Seite auf Facebook "geteilt" wird, besteht die Möglichkeit ein Thumbnail auszuwählen. Facebook benötigt dazu (damit man ein Bild auswählen kann) absolute Pfade.
Dazu benötigt man das Modul "wna_facebook" ([http://contao.silvanogiacomello.ch/module/wna_facebook/wna_facebook.zip Download hier]) (ist <s>noch</s> nicht im ER!).
Sobald das Modul hochgeladen wurde, ist es aktiv und man kann, wenn man einen Link bei Facebook teilt, das Thumbnail auswählen.

====(alternatives) Modul respektvie Contao 2.10====
Sofern man die Seite auf Google PageSpeed anpasst, verwendet man bestimmt das Modul [http://www.contao.org/erweiterungsliste/view/GooPageSpeed.10000009.de.html GooPageSpeed]. Dort erhält der Ordner "tl_files" eine eigene Subdomain und somit automatisch einen absoluten Pfad.

In Contao 2.10 wird gar kein Modul mehr benötigt für absolute Pfade, da die Anpassung an Google PageSpeed (betreffend den 3 Subdomains) in den Core übernommen wurde ([http://www.contao-konferenz.de/tl_files/folien/keynote.pdf Keynote an der Contao Konferenz 2011 von Leo Feyer])

====Installation====
Sobald man die folgenden Anpassungen ([[Facebook#Anpassungen_in_der_Datei_MyFacebookHack.php|2.2.3.2 Anpassungen in der Datei MyFacebookHack.php]]) getätigt hat, lädt man den komletten Ordner "wna_facebook" in seine Contao Installation unter ''system/modules'' hoch.

====Anpassungen in der Datei MyFacebookHack.php====
Folgende Anpassungen müssen gemacht werden, damit das Modul funktioniert:

'''Falls man nicht das fe_page Template benutzt:'''
<source lang="html4strict">if ($strTemplate != 'fe_page')
</source>

'''Falls man den Ordner (tl_files) unbenannt hat:'''
<source lang="html4strict">$arrSearch = array ( '="tl_files/', );
</source>

'''den Pfad zum tl_files Ordner'''
<source lang="html4strict">$arrReplace = array
(
'="http://www.domain.tld/tl_files/',
);
</source>

====Überprüfung der Funktion====
Am einfachsten kann man die Thumbnail Funktion (resp. das Modul) überprüfen in dem man den [http://developers.facebook.com/tools/lint/ URL Linter] von Facebook verwendet. Eine URL eintragen und bei der Überprüfung sollte bei "Image" ein Bild angezeigt werden.

===Facebook Plugin via HTML Modul einbinden===
Die Facebook Plugins müssen nicht zwingend in die Templates eingebaut werden. Es können auch Module angelegt werden - so zum Beispiel ein HTML Modul. Wichtig dafür ist, das der jeweilige Tag von Facebook (<fb:comments> ; <fb:like> ; <fb:send> ; ...) im BE bei den "Einstellungen" unter "Erlaubte HTML-Tags" ("System" > "Einstellungen" > "Erlaubte HTML-Tags" ; Kategorie "Sicherheitseinstellungen") eingetragen wird, da sonst beim Speichern das HTML Modul leer bleibt, weil Contao es als nicht erlaubter HTML Tag betrachtet.

==Facebook Kommentar Plugin==
===Code===
<source lang="html4strict">
(...)
<?php endif; ?>

<fb:comments href="http://domain-zur-contao-installation.tld/<?php echo $this->link; ?>" num_posts="10" width="600"></fb:comments>

</div>
</source>

Sieht man sich das Kommentar Plugin etwas genauer an:

{| border="1" cellspacing="0" cellpadding="5"
! Code !! Beschreibung
|-
| <source lang="html4strict"><fb:comments href="http://domain-zur-contao-installation.tld/<?php echo $this->link; ?>" (...)</source> || Pfad respektive Internetadresse der Seite, welche als Link erscheint (auf dem eigenen Facebook Profil - Pinwand), wenn ein Kommentar geschrieben wurde (und die Option "Post to Facebook" aktivier ist beim Kommentarfeld).
|-
| <source lang="html4strict">
(...) num_posts="10" (...)
</source> || Wie viele Beiträge sollen als Standard angezeigt werden. Es wird am Ende eine "Box" angezeigt, um alle vorhandenen Kommentare anzuzeigen.
|-
| <source lang="html4strict">
(...) width="600"></fb:comments>
</source> || Die Breite des kompletten Plugins.
|}

===komplettes Nachrichrichtenleser Template mit Kommentar Plugin===
<source lang="html4strict">
<div class="layout_full block<?php echo $this->class; ?>">

<a href="http://domain-zur-contao-installation.tld/<?php echo $this->link; ?>" title=""><h1><?php echo $this->newsHeadline; ?></h1></a>
<?php if ($this->hasMetaFields): ?>

<p class="info"><?php echo $this->date; ?> <?php echo $this->author; ?> <?php echo $this->commentCount; ?></p>
<?php endif; ?>
<?php if ($this->hasSubHeadline): ?>

<h2><?php echo $this->subHeadline; ?></h2>
<?php endif; ?>

<div class="ce_text">
<?php if (!$this->addBefore): ?>

<?php echo $this->text; ?>
<?php endif; ?>
<?php if ($this->addImage): ?>

<div class="image_container<?php echo $this->floatClass; ?>"<?php if ($this->margin || $this->float): ?> style="<?php echo trim($this->margin . $this->float); ?>"<?php endif; ?>>
<?php if ($this->href): ?>
<a href="<?php echo $this->href; ?>"<?php echo $this->attributes; ?> title="<?php echo $this->alt; ?>">
<?php endif; ?>
<img src="<?php echo $this->src; ?>"<?php echo $this->imgSize; ?> alt="<?php echo $this->alt; ?>" />
<?php if ($this->href): ?>
</a>
<?php endif; ?>
<?php if ($this->caption): ?>
<div class="caption"><?php echo $this->caption; ?></div>
<?php endif; ?>
</div>
<?php endif; ?>
<?php if ($this->addBefore): ?>

<?php echo $this->text; ?>
<?php endif; ?>

</div>
<?php if ($this->enclosure): ?>

<div class="enclosure">
<?php foreach ($this->enclosure as $enclosure): ?>
<p><img src="<?php echo $enclosure['icon']; ?>" width="18" height="18" alt="<?php echo $enclosure['title']; ?>" class="mime_icon" /> <a href="<?php echo $enclosure['href']; ?>" title="<?php echo $enclosure['title']; ?>"><?php echo $enclosure['link']; ?> <span class="size">(<?php echo $enclosure['filesize']; ?>)</span></a></p>
<?php endforeach; ?>
</div>
<?php endif; ?>

<fb:comments href="http://domain-zur-contao-installation.tld/<?php echo $this->link; ?>" num_posts="10" width="600"></fb:comments>

</div>
</source>

====Anpassungen im Template für die Seite ====
Folgende Stellen muss man im Code auf seine Seite anpassen:

<source lang="html4strict">
<a href="http://domain-zur-contao-installation.tld/<?php echo $this->link; ?>" title=""><h1><?php echo $this->newsHeadline; ?></h1></a></source>

<source lang="html4strict">
<fb:comments href="http://domain-zur-contao-installation.tld/<?php echo $this->link; ?>" num_posts="10" width="600"></fb:comments>
</source>
(siehe [[Facebook#Code_2|2.4.1 Code]] für Erklärung der Optionen)

==Like resp. Send Plugin==
===Code===
<source lang="html4strict">
(...)
<h1><?php echo $this->newsHeadline; ?></h1>
<?php if ($this->hasMetaFields): ?>

<p class="info"><?php echo $this->date; ?> <?php echo $this->author; ?> <?php echo $this->commentCount; ?></p>
<?php endif; ?>
<?php if ($this->hasSubHeadline): ?>

<h2><?php echo $this->subHeadline; ?></h2>
<?php endif; ?>

<fb:like href="http://domain-zur-contao-installation.tld<?php echo $this->link; ?>" send="true" width="450" show_faces="false" font=""></fb:like>

<div class="ce_text">
<?php if (!$this->addBefore): ?>
(...)
</source>

Sieht man sich die Like resp. Send Funktion etwas genauer an:

{| border="1" cellspacing="0" cellpadding="5"
! Code !! Beschreibung
|-
| <source lang="html4strict"><fb:like href="http://domain-zur-contao-installation.tld/<?php echo $this->link; ?>" (...)</source> || Pfad respektive Internetadresse der Seite, welche "geliked" und/oder "gesendet" werden soll - direkte Adresse zum Beitrag
|-
| <source lang="html4strict">
(...) send="true" (...)
</source> || Soll neben "Like" auch die "Send" Funkton aktiviert sein
|-
| <source lang="html4strict">
(...) width="450"> (...)
</source> || Breite des ganzen Facebook Plugin in Pixel
|-
| <source lang="html4strict">
(...) show_faces="false" (...)
</source> || Ob bei einem "like" das Profilbild des jeweiligen "likers" angezeigt werden soll
|-
| <source lang="html4strict">
(...) font=""></fb:like>
</source> || Schriftart des Facebook Plugins. Folgende Schriftarten werden seitens Facebook unterstützt: arial, lucida grande, segoe ui, tahoma, trebuchet ms, verdana
|}

===komplettes Nachrichrichtenleser Template mit Like Plugin===
<source lang="html4strict">
<div class="layout_full block<?php echo $this->class; ?>">

<a href="http://domain-zur-contao-installation.tld/<?php echo $this->link; ?>" title=""><h1><?php echo $this->newsHeadline; ?></h1></a>
<?php if ($this->hasMetaFields): ?>

<p class="info"><?php echo $this->date; ?> <?php echo $this->author; ?> <?php echo $this->commentCount; ?></p>
<?php endif; ?>
<?php if ($this->hasSubHeadline): ?>

<h2><?php echo $this->subHeadline; ?></h2>
<?php endif; ?>

<fb:like href="http://domain-zur-contao-installation.tld/<?php echo $this->link; ?>" send="true" width="450" show_faces="false" font=""></fb:like>

<div class="ce_text">
<?php if (!$this->addBefore): ?>

<?php echo $this->text; ?>
<?php endif; ?>
<?php if ($this->addImage): ?>

<div class="image_container<?php echo $this->floatClass; ?>"<?php if ($this->margin || $this->float): ?> style="<?php echo trim($this->margin . $this->float); ?>"<?php endif; ?>>
<?php if ($this->href): ?>
<a href="<?php echo $this->href; ?>"<?php echo $this->attributes; ?> title="<?php echo $this->alt; ?>">
<?php endif; ?>
<img src="<?php echo $this->src; ?>"<?php echo $this->imgSize; ?> alt="<?php echo $this->alt; ?>" />
<?php if ($this->href): ?>
</a>
<?php endif; ?>
<?php if ($this->caption): ?>
<div class="caption"><?php echo $this->caption; ?></div>
<?php endif; ?>
</div>
<?php endif; ?>
<?php if ($this->addBefore): ?>

<?php echo $this->text; ?>
<?php endif; ?>

</div>
<?php if ($this->enclosure): ?>

<div class="enclosure">
<?php foreach ($this->enclosure as $enclosure): ?>
<p><img src="<?php echo $enclosure['icon']; ?>" width="18" height="18" alt="<?php echo $enclosure['title']; ?>" class="mime_icon" /> <a href="<?php echo $enclosure['href']; ?>" title="<?php echo $enclosure['title']; ?>"><?php echo $enclosure['link']; ?> <span class="size">(<?php echo $enclosure['filesize']; ?>)</span></a></p>
<?php endforeach; ?>
</div>
<?php endif; ?>

</div>
</source>

====Anpassungen im Template für seine Seite ====
Folgende Stellen muss man im Code auf seine Seite anpassen:

<source lang="html4strict">
<a href="http://domain-zur-contao-installation.tld/<?php echo $this->link; ?>" title=""><h1><?php echo $this->newsHeadline; ?></h1></a></source>

<source lang="html4strict">
<fb:like href="http://domain-zur-contao-installation.tld/<?php echo $this->link; ?>" send="true" width="450" show_faces="false" font=""></fb:like>
</source>
(siehe [[Facebook#Code|2.3.1 Code]] für Erklärung der Optionen)

==andere Facebook Plugins==
Auf das Einbinden der Plugins wird nicht weiter eingegangen - die obigen beiden Beispiele sollten reichen - daher wird ab hier (Punkte X.X) nur noch der Facebook Code gezeigt.
===Facebook Send Plugin===
====Code====
<source lang="html4strict">
<fb:send href="http://domain-zur-contao-installation.tld/<?php echo $this->link; ?>" font=""></fb:send>
</source>

Sieht man sich das Send Plugin etwas genauer an:

{| border="1" cellspacing="0" cellpadding="5"
! Code !! Beschreibung
|-
| <source lang="html4strict"><fb:send href="http://domain-zur-contao-installation.tld/<?php echo $this->link; ?>" (...)</source> || Pfad respektive Internetadresse der Seite, welche als Link erscheint (in der Nachricht)
|-
| <source lang="html4strict">
(...) font=""></fb:send>
</source> || Schriftart des Facebook Plugins. Folgende Schriftarten werden seitens Facebook unterstützt: arial, lucida grande, segoe ui, tahoma, trebuchet ms, verdana
|}
===weitere Plugins===
Das Einbinden sowie der Code der Facebook Plugins sind untereinander sehr identisch - daher wird darauf verzichtet, alle Facebook Plugins hier zu erwähnen. Es gibt noch weitere [https://developers.facebook.com/docs/plugins/ Facebook Plugins].

[https://developers.facebook.com/docs/reference/plugins/like/ Like Button], [https://developers.facebook.com/docs/reference/plugins/send/ Send Button], [https://developers.facebook.com/docs/reference/plugins/comments/ Comments], [https://developers.facebook.com/docs/reference/plugins/activity/ Activity Feed], [https://developers.facebook.com/docs/reference/plugins/recommendations/ Recommendations], [https://developers.facebook.com/docs/reference/plugins/like-box/ Like Box], [https://developers.facebook.com/docs/reference/plugins/facepile/ Faccepile], [https://developers.facebook.com/docs/reference/plugins/live-stream/ Live Stream]

Die Plugins [https://developers.facebook.com/docs/plugins/registration/ Registration] und [https://developers.facebook.com/docs/reference/plugins/login/ Login Button] werden in diesem Wiki Eintrag nicht erwähnt, da diese nicht "einfach so" eingebunden werden können.

=andere Facebook Plugins (ohne eigene Facebook App)=
==Facebook Like Button==
Wie man generell einen Likebutton integriert, findet man in den [http://developers.facebook.com/docs/reference/plugins/like/ Facebook Developer Docs]. Aber um diesen Button '''korrekt''' einzubinden benötigt man ein wenig mehr, sogenannte [http://developers.facebook.com/docs/opengraph/ Open Graph Tags], die im Headbereich eingebunden werden. Diese Angaben liefern Facebook die gewünschten Informationen. So kann man die Darstellung auf Facebook gut kontrollieren.

'''Folgende Werte sind quasi Pflichtangaben.'''
<source lang="html4strict">
<meta property="og:title" content=""/>
<meta property="og:type" content=""/>
<meta property="og:url" content=""/>
<meta property="og:site_name" content=""/>
<meta property="og:image" content=""/>
<meta property="fb:admins" content=""/> (Benutzer IDs von Admins der Fanpage) oder <meta property="fb:app_id" content=""/>
</source>

Es empfiehlt sich grundsätzlich immer auch noch description mitzugeben.
<source lang="html4strict">
<meta property="og:description" content=""/>
</source>

Alle Felder bis auf og:image können im Seitentemplate leicht via [[Insert-Tags]] befüllt werden. Aber gerade beim Imagetag ist es wichtig korrekt zu befüllen, da Facebook sonst irgendein Bild der Seite, meistens das Falsche, oder auch gar keins nimmt. Beide Fälle sind nicht sonderlich schön. Man muss also aus den globalen Variablen das Vorschaubild z.B. für News auslesen.

Folgender Code muss ganz oben in das Readertemplate (per Default news_full.tpl).

<source lang="php">
<?php $GLOBALS['TL_HEAD'][] = '<meta property="og:image" content="{{env::url}}/'.$this->singleSRC.'" />'; ?>
</source>

Damit wird das Bild, welches bei der News im Backend gewählt wurde, als Thumbnail für Facebook ausgegeben.

Das Ganze funktioniert übrigens auch bei allen anderen Readertemplates z.B. Catalog. In diesem Fall kann der Pfad zur Bildvariable anders sein. Dies kann man aber in der Ausgabe von $globals nachsehen.

Am Ende man mit dem [http://developers.facebook.com/tools/lint/ Linter] testen wie Facebook die Seite parsen würde.

Einen Diskussionsbeitrag im Forum findet man [http://www.contao-community.de/showthread.php?18218-Ausgaben-im-Headbereich-Meta-Tags-f%FCr-Facebook&p=130301 hier].

=bekannte Probleme=
==Fallback Sprache ==
Wenn man einen Link teilen möchte und es erscheint oft nur der Text und kein Bild dazu, kann es sein, das man beim Startpunkt seiner Seite im BE den Hacken "Sprachen-Fallback" (Kategorie "DNS-Einstellungen") nicht aktiviert hat.

Dynamische Seitenbilder mit Insert-Tags

2012-04-18T11:42:16Z

Xtra:

[[Category:Admin HOWTOS]]

=Möglichkeiten=

Es gibt verschieden Möglichkeiten in Contao dynamisch Bilder auf einer Seite darzustellen. Hier werden verschiedene Möglichkeiten gezeigt, wie man auf jeder Seite ein anderes Bild haben kann, ohne eine extra Erweiterung nutzen zu müssen. Zusätzlich sieht man hier sehr gut, wie kreativ man mit Contao und Lösungen für sich finden kann.

Natürlich gibt es auch schon eine passende Erweiterung für solche Bedürfnisse: pageimage - Seitenbild

=Grundlagen=

* deutsche Beschreibung der [[Insert-Tags]]
* Man sollte sich mit den Grundbegriffen von Contao auskennen ;-)
* Natürlich HTML und CSS

=Ein Bild über das Seitenlayout und Artikel einbinden=

Man kann ein Bild auch mit einem Artikel auf einer Seite einbinden. Dazu muss man nur unter Seitenlayout das Layout bearbeiten und noch einen Artikel an der Stelle einbinden, wo man das Bild dann später einmal haben möchte.

[[Datei:dynamicpics-01.png|Seitenlayout]]

Dann hat man die Möglichkeit bei einem neuen Artikel in den Einstellungen auszuwählen, an welcher Stelle (Hauptspalte, Kopfzeile,...; je nachdem, wo man das Modul im Seitenlayout positioniert hat) der Artikel angezeigt werden soll.

[[Datei:dynamicpics-02.png|Artikelposition]]

Anschließend erstellt man in dem Artikel ein ContentElement "Bild". Das muss dann für jede Seite gemacht werden. Ansonsten wird kein Bild angezeigt.

[[Datei:dynamicpics-03.png|CE Pic]]

Für diejenigen, die ein Bild mehrfach verwenden wollen, kann es sich lohnen, dieses über eine eigenes Modul (eigener HTML-Code) verfügbar zu machen. Dann braucht man als ContentElement nur noch das Modul auszuwählen und hat dann schon alle Parameter so wie man diese haben möchte.

=Bild per CSS im Background oder Bild per Inserttag im img-Tag ?=

Das kommt immer ganz darauf an, welches Resultat man erreichen möchte. Es werden anschließend beide Wege beschrieben.

== Ein Bild über CSS einblenden ==
Um auf einer Seite ein dynamisches Bild anzeigen zu lassen, kann man der Seite eine spezielle CSS-Klasse geben. Dazu wechselt man in die Seitenstruktur, bearbeitet die entsprechende Seite und fügt unter den Experten-Einstellungen die entsprechende Klasse hinzu (in diesem Fall die Klasse .headerpic-grün). (Diese Möglichkeit wurde erst ab TYPOlight-Version 2.6? eingeführt.)

[[Datei:dynamicpics-04.png|Seitenklasse]]

Anschließend fügt man im entsprechenden CSS die Anweisung für diese Klasse hinzu.

<source lang ="css">
.headerpic-green #header {
background: #fff url(tl_files/header/bildfuerdieseseite.png) no-repeat top left;
}
</source>

Diese Schritte wiederholt man für jede Seite, wobei auch die selbe Klasse mehrfach vergeben werden kann.

==Ein Bild über einen Inserttag einbinden==

Hier kann man auch direkt im eigenen Template arbeiten wenn man dies möchte bzw. sollte man schon eines angelegt haben. Ansonsten empfiehlt sich der Weg über ein eigenes HTML-Code Modul.

===Für jede Seite ein Bild===

Man erstellt ein Module des Types "Eigener HTML-Code" und fügt folgenden Code ein:

<source lang="html4strict">
<img src="/tl_files/header/{{env::page_alias}}.png" alt="{{env::page_title}}" />
</source>

Im Seitenlayout weist man dann dieses Module dem Header zu.

[[Datei:dynamicpics-05.png|Eigenes Modul im Seitenlayout]]

''env::page_alias'' gibt den Alias der aktuellen Seite aus. ''env::page_title'' gibt den Titel der aktuellen Seite aus. Jetzt braucht man nur für jede Seite ein Bild in dem Ordner /tl_files/header anlegen und es so benennen wie der alias der Seite ist, auf dem das Bild zu sehen sein soll. Im Grunde kann es auch immer das selbe Bild mit einem anderen Namen sein. ;-)

Beispiel: Die Seite A heisst "red", die Seite B heisst "green" und die Seite C heisst "blue". Man hat im Ordner /tl_files/header/ 3 Bilder; das erste heisst red.png, das zweite green.png und das dritte blue.png. Mit dieser hier beschriebenen Methode wird nun beim Aufruf der Seite A automatisch das Bild red.png gezeigt, beim Aufruf der Seite B das Bild green.png und beim Aufruf der Seite C das Bild blue.png.

===Für jede Hauptseite ein Bild===

Die Vorgehensweise ist ident wie oben: man erstellt ein Modul "Eigener HTML-Code" und bindet dieses dann im Seitelayout ein und weist es dem Header zu. Das einzige, was sich ändert, ist der Code im Module "Eigener HTML-Code":

<source lang="html4strict">
<img src="/tl_files/header/{{env::main_alias}}.png" alt="{{env::main_title}}" />
</source>

''env::main_alias'' gibt den Alias der übergeordneten Hauptseite aus. ''env::main_title'' gibt den Titel der übergeordneten Hauptseite aus. Jetzt braucht man nur für jede Hauptseite ein Bild in dem Ordner header anlegen und es so benennen wie der alias der Seite ist auf dem das Bild zu sehen sein braucht. Im Grunde kann es auch immer das selbe Bild mit einem anderen Namen sein ;-)

===Spezialfall: für jede Hauptseite 2 (oder mehr) verschiedene Bilder===

Hier wird der Ordner einfach durch den Inserttag ersetzt:

<source lang="html4strict">
<img src="/tl_files/header/{{env::main_alias}}/rechtes_bild.png" alt="{{env::main_title}} - {{env::page_alias}}" />
<img src="/tl_files/header/{{env::main_alias}}/linkes_bild.png" alt="{{env::main_title}} - {{env::page_alias}}" />
</source>

Jetzt muss man natürlich für jeden Hauptpunkt einen extra Ordner anlegen und da drinn die Bilder mit den passenden Namen anlegen. Zu beachten ist hier, das der alt-Inhalt vom main_title und page_alias genommen wird, damit man ein wenig Abwechslung hat ;-)

Aber das kann jeder natürlich so machen, wie er möchte.

===Spezialfall: mehr Ordnung durch verschiedene Dynamische Ordner===

Richtig schön wirds dann mit verschiedenen Bildern in verschiedenen Ordnern, um richtig Ordnung zu halten bei größeren Seiten:

<source lang="html4strict">
<img src="/tl_files/header/{{env::main_alias}}/{{env::page_alias}}.png" alt="{{env::main_title}} - {{env::page_alias}}" />
</source>

===Bei eigenem Seitentemplate kann man auch einen Insertag im Body verwenden===

Klasse:

<source lang="php">
<body id="top"
class="{{env::page_alias}}
<?php if ($this->class): ?>
<?php echo ' '.$this->class; ?>
<?php endif: ?>
"
<?php if ($this->onload): ?>
onload="<?php echo $this->onload; ?>"
<?php endif; ?>>
</source>

ID:

<source lang="php">
<body id="top_{{env::page_alias}}"
<?php if ($this->class): ?>
class="<?php echo $this->class; ?>"
<?php endif;
if ($this->onload): ?>
onload="<?php echo $this->onload; ?>"
<?php endif; ?>>
</source>
Natürlich geht das auch wieder mit ''env::main_alias''

===Sprachabhängig?===

Das Beste ist: Das Ganze ist durch den page_alias auch schon sprachabhängig, da jede andere Sprache auch einen anderen Alias haben wird (Cave: zum Teil unterscheiden sich die Seiten nur durch Zahlen, die Contao automatisch generiert). Wenn man zum Beispiel auf dem Bild auch noch Text hat, kann das sehr praktisch sein.

--- Tutorial erstellt von --[[Benutzer:MacKP|MacKP]] 23:04, 10. Mär. 2010 (UTC)

Insert-Tags

2012-04-18T11:26:00Z

Xtra: cat Anwender und Red added.

{{stub}}
{{AppliesTo
|Version=Alle Versionen
}}
[[Category: Core]]
[[Category:Dev HOWTOS]]
[[Category:Anwender und Redakteure]]

= 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. || || 2.10.x
|-
| <nowiki>{{env::parent_name}}</nowiki> || Dieses Tag wird mit dem Namen der übergeordneten Seite ersetzt. || || 2.10.x
|-
| <nowiki>{{env::parent_title}}</nowiki> || Dieses Tag wird mit dem Titel der übergeordneten Seite ersetzt. || || 2.10.x
|-
| <nowiki>{{env::main_alias}}</nowiki> || Dieses Tag wird mit dem Alias der übergeordneten Hauptseite ersetzt. || || 2.10.x
|-
| <nowiki>{{env::main_name}}</nowiki> || Dieses Tag wird mit dem Namen der übergeordneten Hauptseite ersetzt. || || 2.10.x
|-
| <nowiki>{{env::main_title}}</nowiki> || Dieses Tag wird mit dem Titel der übergeordneten Hauptseite ersetzt. || || 2.10.x
|-
| <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.

Stylesheet für Backend-Theme ergänzen

2012-03-06T14:01:42Z

Xtra: Formatierung

{{stub}}
[[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 es updatesicher ist und man nichts an Templates geändert hat.

{{Hinweis|Diese Lösung funktioniert erst ab Contao 2.10}}

'''Das Stylesheet einbinden'''

Unter system/config/ die dcaconfig.php (Datei anlegen, falls sie noch nicht existiert) bearbeiten und folgende Zeile einfügen:
<source lang="php">
if(TL_MODE == 'BE')
$GLOBALS['TL_CSS'][] = 'tl_files/backend/be.css|screen';
</source>

In der Dateiverwaltung einen Ordner namens "backend" anlegen und eine Datei namens "be.css" reinpacken.

Das war es auch schon. Nun kann man die be.css bei Bedarf bearbeiten und dort Anweisungen reinschreiben um per CSS bestimmte Teile des Backends anders darzustellen.

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

<source lang="css">
/* Verstaerkte Hover/Fokus-Markierung für Listinganzeige in modernen Browsern */
.tl_listing tr:hover, .tl_listing tr:focus {
outline: 1px solid #000;
}
</source>

Vorlage:ExtInfo

2012-03-06T11:32:39Z

Xtra: Added support for https in all urls.

<includeonly>
<div class="extinfo">
{| border="2" cellspacing="0" cellpadding="4" rules="all" style="margin:1em 1em 1em 0; border:solid 1px #AAAAAA; border-collapse:collapse; background-color:#eeeeee; font-size:95%; empty-cells:show;"
|- style="background:#303060; color:white"
! colspan="2" | '''Erweiterungs-Übersicht'''
|-
{{ #if: {{{Dev|}}} | {{tableitem|heading=Name des Entwicklers|value={{{Dev|}}}}} | {{tableempty}} }}
{{ #if: {{{DevSite|}}} | {{tableitem|heading=Entwickler Webseite|value={{{DevSite|}}}}} | {{tableempty}} }}
{{ #if: {{{ExtVersion|}}} | {{tableitem|heading=Version der Erweiterung|value={{{ExtVersion|}}}}} | {{tableempty}} }}
{{ #if: {{{Version|}}} | {{tableitem|heading=Kompatibilität mit Contao Version|value={{{Version|}}}}} | {{tableempty}} }}
{{ #if: {{{TLVersion|}}} | {{tableitem|heading=Kompatibilität mit TYPOlight Version|value={{{TLVersion|}}}}} | {{tableempty}} }}
{{ #if: {{{ERLink|}}} | {{tableitem|heading=Link zum Extension Repository|value={{#ifeq: 0 | {{#pos:{{{ERLink|}}}|http}} | [{{{ERLink|}}} Extension im ER anzeigen] | {{{ERLink|}}} }}}} | {{tableempty}} }}
{{ #if: {{{DonateLink|}}} | {{tableitem|heading=Den Entwickler unterstützen|value={{#ifeq: 0 | {{#pos:{{{DonateLink|}}}|http}} | [{{{DonateLink|}}} Zur "Spenden"-Seite gehen] | {{{DonateLink|}}} }}}} | {{tableempty}} }}
{{ #if: {{{TrackerLink|}}} | {{tableitem|heading=Link zum Tracker|value={{#ifeq: 0 | {{#pos:{{{TrackerLink|}}}|http}} | [{{{TrackerLink|}}} Zum Tracker gehen] | {{{TrackerLink|}}} }}}} | {{tableempty}} }}
{{ #if: {{{VCSLink|}}} | {{tableitem|heading=Link zum VCS|value={{#ifeq: 0 | {{#pos:{{{VCSLink|}}}|http}} | [{{{VCSLink|}}} Zum VCS gehen] | {{{VCSLink|}}} }}}} | {{tableempty}} }}
{{ #if: {{{Depending|}}} | {{tableitem|heading=Abhängig von ff. Erweiterungen|value={{{Depending|}}}}} | {{tableempty}} }}
{{ #if: {{{Comment|}}} | {{tableitem|heading=Anmerkung|value={{{Comment|}}}}} | {{tableempty}} }}
|}
</div>
</includeonly><noinclude>
Diese Vorlage ermöglicht es, eine Kurzübersicht über die beschriebene Erweiterung zu definieren, welche einen Artikel betreffen.
<pre>
{{ExtInfo
| Dev=Name des Entwicklers
| DevSite=Webseite des Entwicklers
| ExtVersion=Version der in der Seite beschriebenen Version
| Version=Kompatibilität mit Contao-Version
| TLVersion=Kompatibilität mit TYPOlight-Version
| ERLink=Link zu der Erweiterung im Extension Repository
| DonateLink=Link zu der Spendenseite, um den Entwickler zu unterstützen
| TrackerLink=Link zum issue tracker der Erweiterung
| VCSLink=Link zum VCS (Version Control System, svn, git, ...)
| Depending=Abhängigkeit von anderen Erweiterungen
| Comment=spezielle Anmerkung
}}
</nowiki></pre>

Bsp:

<pre><nowiki>
{{ExtInfo
| Dev=Christian Schiffler
| DevSite=http://www.cyberspectrum.de
| ExtVersion=1.0.0
| Version=ab 2.9
| TLVersion=2.7.0 - 2.8.3
| ERLink=http://www.contao.org/erweiterungsliste/view/catalog.html
| DonateLink=http://www.cyberspectrum.de/spendmegoodies.html
| TrackerLink=http://contao-forge.de/projects/catalog/issues
| VCSLink=http://code.google.com/p/typolight-catalog/source/checkout
| Depending=[[Taxonomy]] [[backend_filterwiz]]
| Comment=Demo: [http://catalogdemo.dasprojekt.org/ Catalog Demo]
}}
</nowiki></pre>

[[Category: Vorlagen]]
</noinclude>

Vorlage:ExtInfo

2012-03-06T11:30:15Z

Xtra: test to support https urls

<includeonly>
<div class="extinfo">
{| border="2" cellspacing="0" cellpadding="4" rules="all" style="margin:1em 1em 1em 0; border:solid 1px #AAAAAA; border-collapse:collapse; background-color:#eeeeee; font-size:95%; empty-cells:show;"
|- style="background:#303060; color:white"
! colspan="2" | '''Erweiterungs-Übersicht'''
|-
{{ #if: {{{Dev|}}} | {{tableitem|heading=Name des Entwicklers|value={{{Dev|}}}}} | {{tableempty}} }}
{{ #if: {{{DevSite|}}} | {{tableitem|heading=Entwickler Webseite|value={{{DevSite|}}}}} | {{tableempty}} }}
{{ #if: {{{ExtVersion|}}} | {{tableitem|heading=Version der Erweiterung|value={{{ExtVersion|}}}}} | {{tableempty}} }}
{{ #if: {{{Version|}}} | {{tableitem|heading=Kompatibilität mit Contao Version|value={{{Version|}}}}} | {{tableempty}} }}
{{ #if: {{{TLVersion|}}} | {{tableitem|heading=Kompatibilität mit TYPOlight Version|value={{{TLVersion|}}}}} | {{tableempty}} }}
{{ #if: {{{ERLink|}}} | {{tableitem|heading=Link zum Extension Repository|value={{#ifeq: {{{ERLink|}}} | http:{{#replace:{{{ERLink|}}}|http:}} | [{{{ERLink|}}} Extension im ER anzeigen] | {{{ERLink|}}} }}}} | {{tableempty}} }}
{{ #if: {{{DonateLink|}}} | {{tableitem|heading=Den Entwickler unterstützen|value={{#ifeq: {{{DonateLink|}}} | http:{{#replace:{{{DonateLink|}}}|http:}} | [{{{DonateLink|}}} Zur "Spenden"-Seite gehen] | {{{DonateLink|}}} }}}} | {{tableempty}} }}
{{ #if: {{{TrackerLink|}}} | {{tableitem|heading=Link zum Tracker|value={{#ifeq: {{{TrackerLink|}}} | http:{{#replace:{{{TrackerLink|}}}|http:}} | [{{{TrackerLink|}}} Zum Tracker gehen] | {{{TrackerLink|}}} }}}} | {{tableempty}} }}
{{ #if: {{{VCSLink|}}} | {{tableitem|heading=Link zum VCS|value={{#ifeq: 0 | {{#pos:{{{VCSLink|}}}|http}} | [{{{VCSLink|}}} Zum VCS gehen] | {{{VCSLink|}}} }}}} | {{tableempty}} }}
{{ #if: {{{Depending|}}} | {{tableitem|heading=Abhängig von ff. Erweiterungen|value={{{Depending|}}}}} | {{tableempty}} }}
{{ #if: {{{Comment|}}} | {{tableitem|heading=Anmerkung|value={{{Comment|}}}}} | {{tableempty}} }}
|}
</div>
</includeonly><noinclude>
Diese Vorlage ermöglicht es, eine Kurzübersicht über die beschriebene Erweiterung zu definieren, welche einen Artikel betreffen.
<pre>
{{ExtInfo
| Dev=Name des Entwicklers
| DevSite=Webseite des Entwicklers
| ExtVersion=Version der in der Seite beschriebenen Version
| Version=Kompatibilität mit Contao-Version
| TLVersion=Kompatibilität mit TYPOlight-Version
| ERLink=Link zu der Erweiterung im Extension Repository
| DonateLink=Link zu der Spendenseite, um den Entwickler zu unterstützen
| TrackerLink=Link zum issue tracker der Erweiterung
| VCSLink=Link zum VCS (Version Control System, svn, git, ...)
| Depending=Abhängigkeit von anderen Erweiterungen
| Comment=spezielle Anmerkung
}}
</nowiki></pre>

Bsp:

<pre><nowiki>
{{ExtInfo
| Dev=Christian Schiffler
| DevSite=http://www.cyberspectrum.de
| ExtVersion=1.0.0
| Version=ab 2.9
| TLVersion=2.7.0 - 2.8.3
| ERLink=http://www.contao.org/erweiterungsliste/view/catalog.html
| DonateLink=http://www.cyberspectrum.de/spendmegoodies.html
| TrackerLink=http://contao-forge.de/projects/catalog/issues
| VCSLink=http://code.google.com/p/typolight-catalog/source/checkout
| Depending=[[Taxonomy]] [[backend_filterwiz]]
| Comment=Demo: [http://catalogdemo.dasprojekt.org/ Catalog Demo]
}}
</nowiki></pre>

[[Category: Vorlagen]]
</noinclude>

Vorlage:ExtInfo

2012-03-06T11:24:33Z

Xtra: test to support https urls

<includeonly>
<div class="extinfo">
{| border="2" cellspacing="0" cellpadding="4" rules="all" style="margin:1em 1em 1em 0; border:solid 1px #AAAAAA; border-collapse:collapse; background-color:#eeeeee; font-size:95%; empty-cells:show;"
|- style="background:#303060; color:white"
! colspan="2" | '''Erweiterungs-Übersicht'''
|-
{{ #if: {{{Dev|}}} | {{tableitem|heading=Name des Entwicklers|value={{{Dev|}}}}} | {{tableempty}} }}
{{ #if: {{{DevSite|}}} | {{tableitem|heading=Entwickler Webseite|value={{{DevSite|}}}}} | {{tableempty}} }}
{{ #if: {{{ExtVersion|}}} | {{tableitem|heading=Version der Erweiterung|value={{{ExtVersion|}}}}} | {{tableempty}} }}
{{ #if: {{{Version|}}} | {{tableitem|heading=Kompatibilität mit Contao Version|value={{{Version|}}}}} | {{tableempty}} }}
{{ #if: {{{TLVersion|}}} | {{tableitem|heading=Kompatibilität mit TYPOlight Version|value={{{TLVersion|}}}}} | {{tableempty}} }}
{{ #if: {{{ERLink|}}} | {{tableitem|heading=Link zum Extension Repository|value={{#ifeq: {{{ERLink|}}} | http:{{#replace:{{{ERLink|}}}|http:}} | [{{{ERLink|}}} Extension im ER anzeigen] | {{{ERLink|}}} }}}} | {{tableempty}} }}
{{ #if: {{{DonateLink|}}} | {{tableitem|heading=Den Entwickler unterstützen|value={{#ifeq: {{{DonateLink|}}} | http:{{#replace:{{{DonateLink|}}}|http:}} | [{{{DonateLink|}}} Zur "Spenden"-Seite gehen] | {{{DonateLink|}}} }}}} | {{tableempty}} }}
{{ #if: {{{TrackerLink|}}} | {{tableitem|heading=Link zum Tracker|value={{#ifeq: {{{TrackerLink|}}} | http:{{#replace:{{{TrackerLink|}}}|http:}} | [{{{TrackerLink|}}} Zum Tracker gehen] | {{{TrackerLink|}}} }}}} | {{tableempty}} }}
{{ #if: {{{VCSLink|}}} | {{tableitem|heading=Link zum VCS|value={{#ifeq: {{{VCSLink|}}} | http{{#replace:{{{VCSLink|}}}|http}} | [{{{VCSLink|}}} Zum VCS gehen] | {{{VCSLink|}}} }}}} | {{tableempty}} }}
{{ #if: {{{Depending|}}} | {{tableitem|heading=Abhängig von ff. Erweiterungen|value={{{Depending|}}}}} | {{tableempty}} }}
{{ #if: {{{Comment|}}} | {{tableitem|heading=Anmerkung|value={{{Comment|}}}}} | {{tableempty}} }}
|}
</div>
</includeonly><noinclude>
Diese Vorlage ermöglicht es, eine Kurzübersicht über die beschriebene Erweiterung zu definieren, welche einen Artikel betreffen.
<pre>
{{ExtInfo
| Dev=Name des Entwicklers
| DevSite=Webseite des Entwicklers
| ExtVersion=Version der in der Seite beschriebenen Version
| Version=Kompatibilität mit Contao-Version
| TLVersion=Kompatibilität mit TYPOlight-Version
| ERLink=Link zu der Erweiterung im Extension Repository
| DonateLink=Link zu der Spendenseite, um den Entwickler zu unterstützen
| TrackerLink=Link zum issue tracker der Erweiterung
| VCSLink=Link zum VCS (Version Control System, svn, git, ...)
| Depending=Abhängigkeit von anderen Erweiterungen
| Comment=spezielle Anmerkung
}}
</nowiki></pre>

Bsp:

<pre><nowiki>
{{ExtInfo
| Dev=Christian Schiffler
| DevSite=http://www.cyberspectrum.de
| ExtVersion=1.0.0
| Version=ab 2.9
| TLVersion=2.7.0 - 2.8.3
| ERLink=http://www.contao.org/erweiterungsliste/view/catalog.html
| DonateLink=http://www.cyberspectrum.de/spendmegoodies.html
| TrackerLink=http://contao-forge.de/projects/catalog/issues
| VCSLink=http://code.google.com/p/typolight-catalog/source/checkout
| Depending=[[Taxonomy]] [[backend_filterwiz]]
| Comment=Demo: [http://catalogdemo.dasprojekt.org/ Catalog Demo]
}}
</nowiki></pre>

[[Category: Vorlagen]]
</noinclude>

Vorlage:ExtInfo

2012-03-06T11:13:31Z

Xtra: added VCSLink

<includeonly>
<div class="extinfo">
{| border="2" cellspacing="0" cellpadding="4" rules="all" style="margin:1em 1em 1em 0; border:solid 1px #AAAAAA; border-collapse:collapse; background-color:#eeeeee; font-size:95%; empty-cells:show;"
|- style="background:#303060; color:white"
! colspan="2" | '''Erweiterungs-Übersicht'''
|-
{{ #if: {{{Dev|}}} | {{tableitem|heading=Name des Entwicklers|value={{{Dev|}}}}} | {{tableempty}} }}
{{ #if: {{{DevSite|}}} | {{tableitem|heading=Entwickler Webseite|value={{{DevSite|}}}}} | {{tableempty}} }}
{{ #if: {{{ExtVersion|}}} | {{tableitem|heading=Version der Erweiterung|value={{{ExtVersion|}}}}} | {{tableempty}} }}
{{ #if: {{{Version|}}} | {{tableitem|heading=Kompatibilität mit Contao Version|value={{{Version|}}}}} | {{tableempty}} }}
{{ #if: {{{TLVersion|}}} | {{tableitem|heading=Kompatibilität mit TYPOlight Version|value={{{TLVersion|}}}}} | {{tableempty}} }}
{{ #if: {{{ERLink|}}} | {{tableitem|heading=Link zum Extension Repository|value={{#ifeq: {{{ERLink|}}} | http:{{#replace:{{{ERLink|}}}|http:}} | [{{{ERLink|}}} Extension im ER anzeigen] | {{{ERLink|}}} }}}} | {{tableempty}} }}
{{ #if: {{{DonateLink|}}} | {{tableitem|heading=Den Entwickler unterstützen|value={{#ifeq: {{{DonateLink|}}} | http:{{#replace:{{{DonateLink|}}}|http:}} | [{{{DonateLink|}}} Zur "Spenden"-Seite gehen] | {{{DonateLink|}}} }}}} | {{tableempty}} }}
{{ #if: {{{TrackerLink|}}} | {{tableitem|heading=Link zum Tracker|value={{#ifeq: {{{TrackerLink|}}} | http:{{#replace:{{{TrackerLink|}}}|http:}} | [{{{TrackerLink|}}} Zum Tracker gehen] | {{{TrackerLink|}}} }}}} | {{tableempty}} }}
{{ #if: {{{VCSLink|}}} | {{tableitem|heading=Link zum VCS|value={{#ifeq: {{{VCSLink|}}} | http:{{#replace:{{{VCSLink|}}}|http:}} | [{{{VCSLink|}}} Zum VCS gehen] | {{{VCSLink|}}} }}}} | {{tableempty}} }}
{{ #if: {{{Depending|}}} | {{tableitem|heading=Abhängig von ff. Erweiterungen|value={{{Depending|}}}}} | {{tableempty}} }}
{{ #if: {{{Comment|}}} | {{tableitem|heading=Anmerkung|value={{{Comment|}}}}} | {{tableempty}} }}
|}
</div>
</includeonly><noinclude>
Diese Vorlage ermöglicht es, eine Kurzübersicht über die beschriebene Erweiterung zu definieren, welche einen Artikel betreffen.
<pre>
{{ExtInfo
| Dev=Name des Entwicklers
| DevSite=Webseite des Entwicklers
| ExtVersion=Version der in der Seite beschriebenen Version
| Version=Kompatibilität mit Contao-Version
| TLVersion=Kompatibilität mit TYPOlight-Version
| ERLink=Link zu der Erweiterung im Extension Repository
| DonateLink=Link zu der Spendenseite, um den Entwickler zu unterstützen
| TrackerLink=Link zum issue tracker der Erweiterung
| VCSLink=Link zum VCS (Version Control System, svn, git, ...)
| Depending=Abhängigkeit von anderen Erweiterungen
| Comment=spezielle Anmerkung
}}
</nowiki></pre>

Bsp:

<pre><nowiki>
{{ExtInfo
| Dev=Christian Schiffler
| DevSite=http://www.cyberspectrum.de
| ExtVersion=1.0.0
| Version=ab 2.9
| TLVersion=2.7.0 - 2.8.3
| ERLink=http://www.contao.org/erweiterungsliste/view/catalog.html
| DonateLink=http://www.cyberspectrum.de/spendmegoodies.html
| TrackerLink=http://contao-forge.de/projects/catalog/issues
| VCSLink=http://code.google.com/p/typolight-catalog/source/checkout
| Depending=[[Taxonomy]] [[backend_filterwiz]]
| Comment=Demo: [http://catalogdemo.dasprojekt.org/ Catalog Demo]
}}
</nowiki></pre>

[[Category: Vorlagen]]
</noinclude>

Diskussion:Einsteiger

2012-02-29T12:06:19Z

Xtra:

Begann die Geschichte nicht 2004?
--[[Benutzer:Toflar|Toflar]] 07:54, 28. Mai 2010 (UTC)

----

Nein.

"Nachdem ich alle vorhandenen Systeme und Ideen in einem Topf geworfen und ein paar Mal kräftig umgerührt hatte, erblickte TYPOlight am 28. Februar 2006 das Licht der Welt."

(Quelle: TYPOlight Buch, erste Ausgabe, Seite 18, 2. Absatz)

[[Benutzer:Manitougs|Manitougs]] 20:18, 28. Mai 2010 (UTC)

----
Sollte man nicht noch einen Abschnitt mit Links zum Durchstarten (Insatllation und erste Schtitte) aufnehmen , das wäre die Punkte, die ich als Einsteiger unter Einsteiger eher erwarten würde als einen geschichtlichen Abriss... ;)
--[[Benutzer:Rost|Rost]] 09:36, 29. Feb. 2012 (CET)

Dann mach doch einfach :)
Sehe ich persoenlich auch als sinnvoll an, hat halt nur keiner bislang gemacht.
--[[Benutzer:Xtra|Xtra]] 13:06, 29. Feb. 2012 (CET)

Helpdesk

2012-02-17T10:10:32Z

Xtra: language link

{{stub}}
[[en:Helpdesk]]
= Forum and Helpdesk =

Wer lieber gerade auf deutsch loslegen will ... hier bitte!

{{Hinweis|http://web.archive.org/web/20101121033235/http://contifex.com/wiki/extensions:helpdesk}}
{{Anmerkung|fühlt euch frei den oben erwähnten link hier ins wiki zu bringen ... bitte aber nur auf dutsch englisch ist schon in bearbeitung en.contaowiki.org/Helpdesk !}}
*Die Erlaubnis wurde erteilt :[https://www.contao-community.de/showthread.php?25362-Weiterentwicklung/page2&p=182954&viewfull=1#post182954 (deutsches forum)]

(bild)

== Merkmale ==
*erstes merkmal
*zweits merkmal

== Zusammenfassung ==

(bild)

==Kategorien ==
*'''Offentliches Forum:'''
*'''Eingeschränktes Forum:'''
*'''Öffentlicher Support:'''

Diskussion:Galerie mit meta.txt

2012-01-27T17:21:13Z

Xtra:

--[[Benutzer:Rost|Rost]] 16:46, 27. Jan. 2012 (CET):Wäre es nicht unter Umständen sinnvoller, den Titel und den Fokus etwas allgemeiner zu halten?
Die meta.txt kann ja auch für Downloads verwedet werden. Das funktioniert ganz prima.

Bsp.: datei.pdf = Text der angezeigt werden soll

Allerdings weiß ich nicht, was die anderen Parameter bewirken (können). Man muss -zumindest bei den Downloads- nicht den ganzen Ordner auswählen, sondern die Sortierung wird auch bei der Einzelauswahl der Dateien anch der meta.txt gerichtet. (Für das Erstellen ist es natürlich effizienter, nur den Ordner auszuwählen)

--[[Benutzer:Xtra|Xtra]] 18:21, 27. Jan. 2012 (CET): Das sollte man meiner Meinung nach in einen allgemeinen Artikel [[meta.txt]] auslagern. Diese Seite beschreibt primaer, ein Tutorial wie man eine Gallerie mit der meta.txt baut. Die meta.txt allgemein zu dokumentieren waere hingegen durchaus sinnvoll. Ein Querverweis auf dieses Tutorial und auch zurueck sollte dann eingefuegt werden.

Hauptseite

2011-10-24T13:40:40Z

Xtra: Portoguese language link added

[[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>Das ganze Projekt lebt vor allem von der Mithilfe seiner User.<br />
Solltest du Lust haben selbst mit zu machen, melde dich einfach an und dokumentiere mit.</p>
<p>Ziel des „Contao Community Documentation“ Projektes ist es, Anwendern, Verwaltern und Entwicklern Informationen zum Content Management System Contao zur Verfügung zu stellen. '''Das ganze Projekt lebt vor allem von der Mithilfe seiner User. Solltest du Lust haben, selbst mitzumachen, melde dich an und dokumentiere mit.'''</p>
<p>Das "ccd" ist keine offizielle Seite des Contao Projekts, sondern ein 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>

Mootools Deviant Menu

2011-08-22T23:45:56Z

Xtra: interne Verlinkung

{{AppliesTo|TLVersion=2.8.x|Version=ab 2.9}}
[[Category: Admin_HOWTOS]]

=Mootools Deviant Menu in Contao benutzen=

Da mein erstes eingebautes Contao Menü durch das Tutorial von MacKP ermöglicht wurde, hab ich mir gedacht ich spendier auch eins. Da dies aber mein erstes Tutorial ist, bitte ich um Verständins;)
...Ich habs auch vom Aufbau ziemlich an das von MacKP angelehnt... *grins*

==Voraussetzung:==
Mootools 1.2 (also TL ab 2.8/ alle Contao Versionen); Mit Mootools 1.3 ist mir noch kein Fehler aufgefallen.
Grundlegende Erfahrung mit Contao und Seitenstruktur
gute CSS-Kentnisse um es genau anpassen zu können (Wenn nicht, kann es im Original behalten werden)
keine JavaScript-Kentnisse

==Dazu ist eigenltich nicht viel nötig.==
Von der Seite ( [http://developer.ps/moo/deviantmenu/ http://developer.ps/moo/deviantmenu/] ) über den Link "⇓ Download script" das Skript herunterladen.
Darüber befindet sich eine DEMO des Menüs.

Wer sich jedoch von der sich darauf öffnenden github.com Seite erschlagen fühlt kann auch folgenden Direktlink zur Version 1.1 benutzen ( [https://github.com/dirar/deviantmenu/zipball/1.1 https://github.com/dirar/deviantmenu/zipball/1.1] ).
Es wird auch ein Beispiel, allerdings ohne mootools-core in der zip-Datei mitgeliefert.

==Vorgehen:==
'''1.''' Die Datei "deviantMenu.css" importieren.

'''2.''' Die JS-Datei umbenennen in z.B. moo_deviantMenu.xhtml (Contao 2.1x) oder moo_deviantMenu.tpl(TLVersion=2.8.x|Version=ab 2.9) und in den/einen Template Ordner hochladen. Anschließend geht man in den Template Editor in Contao und bearbeitet das Script folgendermaßen:

Beginnen muss das Script mit:

<source lang="html4strict">
<script type="text/javascript">
<![CDATA[//><!]]>
</script>
</source>

Um das Menü automatisch an den Unterpunkt springen zu lassen indem man sich gerade befindet, muss die CSS Klasse '.selected' durch '.active' ersetzt werden (Zeilen: 55,56,64)

'''3.''' Es kann das Standard Navigationstemplate (nav_default.xhtml/tpl) verwendet werden. Wenn jedoch wie es bei mir der Fall ist ein Navigationspunkt, der Unterpunkte hat nicht verlinkt werden soll, so sollte man sich ein Navigationstemplate bauen z.B.: nav_partiallinked.tpl/xhtml wie es unter "[[Navigationspunkte nicht verlinken]]" beschrieben ist (Und natürlich entsprechend die CSS Klassen der nicht verklinkten Seiten anpassen).

'''3.''' Ein neues [[ModulNavigation|Navigationsmodul]] erstellen:
* Startlevel 0
* Stoplevel 0
* Referenzseite (keine bzw. Startpunkt oder was man möchte)
* Navigationstemplate: (das Standard, oder von uns gerade erstellte) nav_default.xhtml/tpl / nav_partiallinked.tpl/xhtml
* Experten-Einstellungen: deviantMenu-main-conatiner als CSS id!!! einfügen.

'''4.''' Im Seitenlayout:
* CSS-Datei auswählen: deviantMenu.css (nach eigenen Vorstellungen anpassen; vor allem die Bilddateien, die auch noch hochgeladen werden müssen, falls verwendet ;) !)
* Navigationsmodul von gerade, dorthin packen wo man es haben möchte
* MooTools-Templates: das eben erstellte moo_deviantMenu auswählen
* Eigener JavaScript-Code:

<source lang="html4strict">

<script type="text/javascript" >
window.addEvent('domready', function(){
var devmenu = new deviantMenu('deviantMenu-main-conatiner');
});
</script>
</source>

(Damit initialisiert man das Menü)
{{msgWarning|Wenn das Menü in einer HTML5 Seite (ab Contao 2.10) sein soll müssen natürlich die Endungen hmtl5 sein!}}
{{msgImportant|Leider gibt es keinen Fallback, wenn Javascript nicht vorhanden ist. Also mit bedacht verwenden. Und was noch eine Unschönheit ist: Wenn die aktiven Links in den Ebenen weit verschachtelt sind ist das Menü nicht so hoch wie es sein müsste sondern so hoch wie die Eben vorher es war... Liegt aber am Script selber... bzw. hab ich noch keinen Workaround!}}

für fotgschrittene User können auch im moo_deviantMenu Script ein paar Einstellungen vorgenommen werden siehe: [http://mootools.net/forge/p/deviantmenu http://mootools.net/forge/p/deviantmenu]

So das wars nun mal derweil mit der ersten Version von meinem Tutorial. Ich hoffe ihr kriegt ein schönes Menü hin;)

Link zum Forum: [http://www.contao-community.de/showthread.php?22402-Mootools-deviantmenu-in-TYPOlight-benutzen http://www.contao-community.de/showthread.php?22402-Mootools-deviantmenu-in-TYPOlight-benutzen]

VCard

2011-08-09T16:06:27Z

Xtra: ER link fixed

[[Kategorie:Extensions]]

vCard Download für Mitgliedsdaten

{{ExtInfo
| Dev=Helmut Schottmüller ([[User:hschottm|hschottm]])
| DevSite=http://www.aurealis.de
| ExtVersion=1.1.0
| Version=2.9.0 - 2.9.5
| TLVersion=2.7.0 - 2.8.4
| ERLink=http://www.contao.org/erweiterungsliste/view/vcard.de.html
| DonateLink=http://aurealis.de/spenden.html
}}

== Modul vcard (Elektronische Visitenkarte) ==
vcard ist ein Inhaltselement für Contao-Artikel. Man kann damit einen Download-Link für eine vCard eines Contao-Mitglieds oder eine individuelle vCard im Contao Frontend anlegen. Eine vCard ist eine elektronische Visitenkarte, die in vielen Büroanwendungen wie Lotus Notes, Microsoft Outlook, Apple Adressbuch oder Mozilla Thunderbird verwendet wird. Sie dient zum Austausch von Adress- und Kontaktdaten.

Wenn man in einem Contao-Artikel ein neues Element anlegt, steht in der Kategorie '''Datei Elemente''' neben den Download-Elementen auch das vCard-Element zur Verfügung. Neben Standardeinstellungen wie Überschrift, Nur Gästen anzeigen, Element schützen, Ausrichtung des Inhaltselements, Abstand davor und dahinter und Stylesheet-ID und -Klasse kann man für das vCard-Element festlegen, für welche Daten auf der Visitenkarte angezeigt werden sollen. Dabei stehen unter '''Anzeigen für''' drei Möglichkeiten zur Verfügung:

=== Anzeigen für: Mitglieder ===

Wenn man diese Einstellung auswählt, erhält man eine Liste aller aktiven Mitglieder aus der man ein Mitglied auswählen kann, für das der Downloadlink generiert wird.
[[Datei:vcard_backend_member.png|center|frame|Mitgliederauswahl für einen vCard-Download]]

=== Anzeigen für: HTTP Parameter ===

Wenn man diese Einstellung auswählt, kann man einen HTTP Parameter angeben, aus dem Contao die ID eines Mitgliedes extrahiert, für das der Downloadlink generiert wird. Falls die Seite, auf der ein Downloadlink generiert werden soll, z.B. mit dem Parameter member=XX aufgerufen wird, reicht die Angabe von member, um die Mitglieds-ID aus diesem Parameter zu extrahieren. Contao untersucht dabei sowohl HTTP GET Parameter als auch HTTP POST Parameter.
[[Datei:vcard_backend_http.png|center|frame|HTTP Parameter Auswahl für einen vCard-Download]]

=== Anzeigen für: Individuelle Angabe ===

Wenn man diese Einstellung auswählt, erhält man diverse Eingabefelder, um eine individuelle Visitenkarte zu erstellen, die sich nicht auf ein bestehendes Mitglied beziehen muss.

[[Datei:vcard_custom_01.png|center|frame|Personendaten]]

[[Datei:vcard_custom_02.png|center|frame|Kontaktdaten]]

[[Datei:vcard_custom_03.png|center|frame|Adressdaten (Arbeit)]]

[[Datei:vcard_custom_04.png|center|frame|Adressdaten (Privat)]]

=== Hyperlink-Einstellungen ===

Wenn im Eingabefeld '''Titel des Links''' ein Text eingegeben wird, so erscheint dieser Text als Hyperlink-Text für den Download der vCard. Wird kein Titel eingegeben, gibt Contao als Hyperlink-Text den Namen des Mitglieds aus.

Es ist zu beachten, dass die Felder, die für eine vCard verwendet werden, von den Mitgliedern als öffentlich definiert sein müssen, damit sie in die vCard übernommen werden.

Für eine formatierte Ausgabe steht die CSS-Datei ''TL_FILES/vcard/vcard.css'' zur Verfügung.

[[Datei:vcard_output.png|center|frame|Ausgabe eines Visitenkarten Downloads im Frontend]]

[[Datei:vcard_anzeige.png|center|frame|Beispiel einer aus Contao heraus erstellten Visitenkarte unter Mac OS X]]

Core aus Subversion

2011-08-03T19:38:10Z

Xtra: Github Alternative eingetragen.

[[Category:Installation_und_Updates]]
[[Category:Dev HOWTOS]]
[[en:Core from Subversion]]

==Allgemeine Informationen==

Das Contao subversion Repository ist unter der Adresse http://svn.contao.org/trunk erreichbar.

Sollte man alles erhalten wollen, also alle bereits veröffentlichten Versionen, so lässt man den Suffix "trunk" weg.
{{Achtung|Der komplette Checkout ist riesig und sollte daher nicht grundlos ausgecheckt werden. Das spart Zeit und traffic.}}

Offizielle Informationen findet man auch unter: http://www.contao.org/typolight-entwicklungsprozess.html (ganz unten).

{{Anmerkung|Es gibt inzwischen, dank dem User borrible13th, einen [https://github.com/borrible13th/svn.contao.org inoffiziellen Clone des Repositories] bei Github unter der Adresse:
Dieser kann per git und subversion angesprochen werden.
* GIT: https://github.com/borrible13th/svn.contao.org.git
* Subversion: http://svn.github.com/borrible13th/svn.contao.org
Es bietet sich an, dieses als Alternative zu verwenden, da github einiges mehr an Ressourcen und Traffic bereitstellen kann als Leo Feyer.
}}

==Checkout unter verschiedenen Clients==
===Tortoise SVN unter Windows===
Beziehe den Client von http://tortoisesvn.net/downloads.
Nach der Installation hat man im Kontextmenü des Windows Explorer einen neuen Eintrag "Tortoise SVN auschecken".
Nach Auswahl des selbigen, gelangt man zu einer Eingabemaske. Hier geben wir obige URL http://svn.contao.org/trunk ein, um den aktuellen Entwicklungszweig zu erhalten.

Nach Bestätigung der Pfade werden alle Sourcen im gewählten Verzeichnis abgelegt.

Um später auf den jeweils aktuellen Stand zu kommen, reicht es anstatt "TortoiseSVN Checkout" den Punkt "TortoiseSVN aktualisieren" bzw. Englisch "TortoiseSVN Update" zu wählen. Hierdurch werden nur die Änderungen seit dem letzten Checkout übertragen.

===Konsolenclient svn unter Linux/cygwin===
Öffne eine Konsole um in die bash zu gelangen.
Erstelle am Besten ein neues Verzeichnis, wo die Sourcen abgelegt werden sollen.
<source lang="text">
mkdir contao
cd contao
</source>

Der Befehl um nun mit subversion einen Checkout vorzunehmen ist:
<source lang="text">
svn co http://svn.contao.org/trunk
</source>

Um in Zukunft Updates zu erhalten, muss man keinen kompletten "checkout" (co) mehr vornehmen. Da reicht dann ein simples "update" (up).
Hierzu wechselt man in der Konsole wieder in das entsprechende Verzeichnis, welches die Sourcen beinhaltet und führt das Update Kommando aus.
<source lang="text">
cd contao
svn up
</source>

Weiterführende Dokumentation zum Subversion Client in der Konsole erhält man in der man page
<source lang="text">
man svn
</source>

Einsteiger

2011-03-11T16:41:52Z

Xtra: Contao2Go als Artikel verlinkt und nicht nur auf Projektseite

{{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 kan, 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

Eine Demo zum rein schauen 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=
(Lizenz)

=Wer entwickelt Contao=

=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.
*Zum Ersten gibt es dieses Wiki, welches verschiedene detaillierte Anleitungen zu verschiedensten Bereichen zur Verfügung stellt.
*Zum Zweiten gibt es das deutsche [http://www.contao-community.de Contao-Forum].
*Des weiteren gibt es noch die professionellen [http://www.contao.org/partner.html Contao-Partner], welche (unterteilt in verschiedenen Kategorien) auf kommerzieller Ebene ihre Dienste anbieten.
*Der [[Chat_HowTo|Contao-Chat]]

Vorlage:C2g

2011-03-01T14:45:06Z

Xtra: <includeonly> tag hinzugefygt

<includeonly>
<div class="c2g" align="center">
{| cellpadding="2" cellspacing="0" style="text-align: left; width:100%; border: 1px solid #5B3002; color:#5B3002; background-color: #FFE9C3"
| | [[Bild:C2g_logo.png]] || <span class="title">'''Contao2Go:'''</span> Für diese Anleitung stehen ein oder mehrere [[Contao2Go|Contao2Go-Pakete]] zum Download bereit:

{{ #if: {{{tut1|}}} | <ul>{{ #foreach: tut$n$ | <li>{{{tut$n$}}}</li> }}</ul> | Keine Pakete hinterlegt. }}
|}
</div>
</includeonly>
<noinclude>
Verwenden Sie dieses Template, um auf verfügbare Contao2Go-Pakete im Contao2Go-Repository hinzuweisen.

'''Verwendung:'''
<pre><nowiki>
{{c2g
|tut1=Link1
|tut2=Link2
}}
</nowiki></pre>

'''Beispiel:'''
<pre><nowiki>
{{c2g
|tut1=http://contao2go.org/pakete-uebersicht/items/die-erste-webseite.html
|tut2=http://contao2go.org/pakete-uebersicht/items/die-erste-webseite-nachrichten.html
}}
</nowiki></pre>
[[Category: Vorlagen]]
</noinclude>

Catalog

2011-02-23T15:48:51Z

Xtra: /* Meta Keywords */

Das Catalog-Modul ermöglicht eine vielfältige Kategorisierung beliebiger Daten in hierarchischen und flachen Strukturen. Beispiele umfassen [http://www.tuerkischdeutsche-literatur.de Literaturverzeichnisse] oder [http://www.tunesien-immobilien.de Immobilienlisten].

Da dieses Modul sehr komplex ist, findet man einzelne Dokumantationen in der Kategorie [[:Category:Catalog|Catalog]].

{{AppliesTo
|TLVersion=ab 2.8
|Version=ab 2.9
|Ext1=Catalog ab 2.0beta1
}}
[[Category:Extensions]]
[[Category:Catalog]]

=Forum=
Fragen rund um den Catalog werden im Forum hier behandelt: [http://www.contao-community.de/forumdisplay.php?18-catalog Forum - Catalog Bereich]

=Installation=
Catalog kann ganz normal über die Erweiterungsverwaltung des Contao-Backend installiert werden. Eine manuelle Installation ist auch möglich, dazu muss man sich die benötigen Dateien des [http://www.contao.org/erweiterungsliste/view/catalog.html catalog aus dem Extension Repository herunterladen] (abhängige Erweiterungen nicht vergessen!).

Den jeweils neusten Build kann man sich aus dem [http://code.google.com/p/typolight-catalog/source/checkout SVN-Repository] herunterladen. Einzig das Modul backend_filterwiz muss dabei separat installiert werden, alle weiteren Module sind im Repository vorhanden. Man sollte darauf achten, welche Ordner wohin in der Installation kommen!

==Migration von Version 1 auf Version 2==
In Version 2 wurde Einiges geändert. So ist es u. a. nicht mehr nötig catalog und catalog_ext zu installieren, da diese Erweiterungen zusammengelegt wurden. Damit es zu keinem Datenverlust kommt, muss bei einem manuellen Update wie folgt vorgegangen werden:
* Zuerst die alten Modulordner entfernen,
* danach die neuen Modulordner hochladen.
* Erst zum Schluss das Datenbankupdate ausführen!

Beim Update über das Contao-ExtensionRepository sollte man die Reihenfolge beachten:
* Catalog 2 installieren und Datenbank-Update ausführen.
* Catalog_ext deinstallieren und erneut Datenbank-Update ausführen.
* Zur Sicherheit alle catalog-Module etc. noch mal öffnen und speichern, damit auch alles glatt läuft.
* Neue Einstellungen vornehmen.

Katalogfelder vom Typ "Taxonomie" müssen umgestellt werden auf "Auswahl" mit der Datentabelle "tl_taxonomy", Option Spaltenwert = name. Für eine schönere Darstellung aktiviert man "Die Optionsauswahl individualisieren", dann kann man auch Teilbereiche aus der Taxonomie vorgeben und die Anzeige auf "Baum nur mit auswählbaren Kindeinträgen" stellen.

=Allgemeines=
Testumgebung und Vortrag vom Usertreffen 2010:
* Vortrag / Testumgebung -> http://catalogdemo.dasprojekt.org/
* Benutzer: tlut2010
* Passwort: catalogisttoll

==Backend==
Mit dem Catalog bekommt man im Backend unter dem Menüpunkt 'Inhalte' 2 neue Menüeinträge:
* Katalog
* Mit '''Taxonomie''' können Stichworte hierarchisch angelegt und verwaltet werden. Diese sind Grundlage für Filter, Navigation und Verschlagwortung (sog. ''Tagging'') in den Katalogen.

[[Datei:cat-cat2-be.png|Cat Backend]]

==Frontend-Module==
Für eine Basisanwendung der Katalog-Erweiterung können folgende Module eingesetzt werden:
* Mit '''Catalog List''' kann eine Liste von Einträgen angezeigt werden.
* Eine Detailansicht eines Eintrags kann mit Hilfe des '''Catalog Reader''' angezeigt werden. Eine ''Catalog List'' verweist dabei auf den ''Catalog Reader''. Der ''Catalog Reader'' muss natürlich nur dann verwendet werden, wenn von einer Auflistung aus eine Detailseite eines Eintrags angezeigt werden soll.

Für eine weiterführende Benutzung der Katalog-Erweiterung stehen optional diese Module zur Verfügung:
* Catalog Filter (Mit Hilfe von einem Filter können Besucher die Liste eines Catalogs filtern und die Anzeige eingrenzen)
* Catalog Navigation (Mit dieser Navigation kann man eine Navigation erstellen. Die Navigation besteht zum Beispiel aus Kategorien)
* Catalog Notify (Hiermit wird ein Formular erstellt, welches zur schnellen Kontaktaufnahme bei einem einzelnen Item dargestellt wird)
* Catalog Featured (Hiermit kann man eine besondere Liste erstellen, die besondere Items darstellt. Die Liste wird per Zufall zusammengestellt.)
* Catalog Related (Hiermit erstellt man eine Liste von ähnlichen Items - Einzusezten auf einer Seite wo auch der Catalog Reader enthalten ist. Zufallsausgabe)
* Catalog Reference (Hiermit erstellt man eine Liste von Items mit einer gleichen Eigenschaft.)
* Catalog Edit (Um ein Item im Frontend editieren zu können, wird anstelle von Catalog Reader dieses Modul verwendet)

=Erstellen eines Katalogs (Backend)=
Um einen neuen catalog zu erstellen, klickt man links im Backend unter 'Inhalte' auf 'Katalog'. Anschliessend im Hauptbereich auf den Button 'Neuer Katalog'.

[[Datei:cat-cat2-newcat.png|Neuen Cat erstellen]]

* Name des Katalogs angeben
* Einen Tabellennamen angeben (Der catalog legt diese Tabelle selbstständig an. Es hat sich bewährt eine Tabelle anzulegen ohne tl_ als präfix, da Contao diese Tabellen sonst zum Entfernen vorschlägt. Ich empfehle den präfix cat_ damit man die Tabellen schnell wiederfindet.)
* Alias field (kann erst später ausgefüllt werden) -> anstelle der ID wird der Alias genutzt bei den Links
* publishField (kann erst später ausgefüllt werden) -> Hier kann ein Checkboxfeld ausgewählt werden, was die Funktion eines 'Auges' = on-/offline hat (z.B. Ein Feld mit dem Namen online)
* Jump to page -> Hier muss die Detail Seite mit dem Modul Catalog Reader angegeben werden. {{Achtung|Die richtige Zuweisung der Readerseite erfolgt in den Kataloglisten Modulen, diese Zuweisung hier ist jedoch nötig damit der Katalog die Items in die xml-Sitemap eintragen kann. Wird diese Zuweisung hier nicht vorgenommen, so "weiss" der Katalog nicht, auf welchem Reader die Items dargestellt werden sollen und trägt sie daher nicht in der sitemap.xml ein. Auch für die Contao Suche muss diese Angabe gemacht werden.}}
* Ein Bild hinzufügen -> Hier kann ein Bild für den Katalog hinzugefügt werden, um im Backend den Katalog schnell von anderen unterscheiden zu können
* Zeichenkette des Titels formatieren (wird erst später gebraucht) -> Um im Backend die Übersicht von vielen Items besser gewährleisten zu können, kann man hier die Anzeigen der einzelnen Items konfigurieren
* Allow comments -> Kommentare bei den einzelnen Items erlauben und konfigurieren (Funktion ist wie bei News o.ä. daher wird hier nicht genauer darauf eingegangen)
* Searchable -> Wenn man die Items auch in der Contao Suche indexieren lassen möchte. Nach Aktivierung ist es möglich, Conditions (Ausnahmen) einzugeben und das Title Feld anzugeben von einem Item (weiteres zu Conditions und Title finden Sie weiter unten) Wichtig: Weiterleitungsseite muss angegeben werden!
** Condition -> Um Felder direkt aus der Suche herauszunehmen (damit unveröffentlichte Items nicht in die Suche aufgenommen werden o.ä.)
** Page title field -> Den Namen des Items auswählen, damit dieser für die Ergebnisanzeige der Suche genutzt wird ('''und auch für den Title''')
* Enable CSV import -> Damit ist es möglich CSV-Dateien zu importieren. Natürlich sollte man das nicht einfach so machen und nur von Leuten die wissen was sie tun. Daher kann hier festgelegt werden, das nur Administratoren das machen dürften und ob Items überschrieben werden oder nicht
* Generate feed -> Hier kann festgelegt werden, dass ein RSS-Feed generiert wird aus den Items (Funktion ist wie bei News o.ä., daher wird hier nicht genauer darauf eingegangen)

==Nachträgliches Bearbeiten eines Katalogs==
Um die Grundeinstellungen eines Katalogs nachträglich noch einmal bearbeiten zu können, klickt man in der Katalogübersicht auf den Felder-Button...

[[Datei:cat-cat2-editfields.png|Cat Felder editieren]]

...und anschließend im Übersichtsfeld des Katalogs auf 'Bearbeiten'.

[[Datei:cat-cat2-editcat.png|Cat Catalog editieren]]

=Erstellen von Attributen/Feldern von Items in einem Katalog=
Nun ist die Grundkonfiguration von einem Katalog erst einmal abgeschlossen. Aber es ist noch nicht festgelegt aus welchen Feldern ein Item denn nun besteht, also welche Attribute ein Item besitzen kann.
Dazu kommen wir jetzt. Um neue Felder für den Katalog zu erstellen, klickt man in der Katalogübersicht auf 'Felder für Katalog erstellen'....

[[Datei:cat-cat2-editfields.png|Cat Felder editieren]]

...und danach auf 'Neues Feld'.

[[Datei:cat-cat2-newfield.png|Cat Neues Feld anlegen]]

==Die Standardwerte von Feldern==
Die speziellen Felder werden erst sichtbar, wenn man einen Feldtyp ausgewählt hat. Diese Werte werden weiter unten erläutert.
* Field configuration
** Bezeichnung (Eine eindeutige Bezeichnung für das Feld. Diese sollte möglichst selbsterklärend sein.)
** Beschreibung (Um im Backend und beim Frontend-Editing eine Beschreibung anzuzeigen für die Ersteller eines Items)
** Spaltenname (der Spaltenname in der Tabelle. Dieser muss eindeutig sein und so vergeben werden, das er logisch ist, da man beim Template erstellen diese Namen benutzt um an die Inhalte zu kommen)
** '''Typ''' (weiter unten)
* Display Settings (Diese Einstellungen sind für die Ansicht im Backend zuständig)
** Kontroll-Checkbox (Wenn eine Kontroll-Checkbox angegeben wird, wird dieses Feld erst angezeigt, wenn das Kontroll-Checkbox Feld angekreuzt ist)
** Vorher Umbruch einfügen (Um dieses Eingabefeld in einer neuen Zeile zu beginnen)
*** Legend Titel (hier kann dann ein Name für den Legend Titel angegeben werden -> die Grün geschriebenen Titel im Backend)
** Enable half width (um 2 Felder nebeneinander anzuzeigen - seit TYPOlight 2.7 möglich)
* Backend filter settings (hier kann festgelegt werden, ob das Feld im Backend zur Filterung angezeigt wird)
** Sortieren ('''Muss zum Filtern etc. angegeben werden.''' Sonst weiß Contao nicht wie der Filter erstellt werden soll. Für '''Datum''' ist zwangsweise die Angabe nötig ob nach Jahr, Monat oder Tag sortiert werden soll!)
** Filter
** Suche
* Advanced settings
** Pflichtfeld -> Dieses Feld muss ausgefüllt werden
* Frontend editing
** Frontend editing groups -> Welche Gruppen dürfen dieses Feld im Frontend bearbeiten (Mehrfachangabe ist möglich). Wenn hier nichts angegeben wird, dürfen alle Gruppen dieses Feld im Frontend editieren

==Typ - Feldtypen von Feldern==
Hier werden die Angaben für die jeweiligen Typen aufgelistet und erläutert.
===Text===
* Format settings
** Prefix und Suffix Strings
** Format
*** Formattyp
**** Zeichenkette
**** Nummer
**** Datum
*** Zeichenfolge für Formatierung

===Alias===
'''Es ist immer nur ein Alias Feld erlaubt in einem Katalog.'''
Die Funktion ist die selbe wie bei einem Alias für eine Seite.
* Alias-Titel-Feld (Aus diesem Feld wird automatisch ein Alias generiert, wenn keine Angabe beim Alias gemacht wurde. Dieses Feld muss '''nicht''' Eindeutig sein. Der Alias wird aber eindeutig generiert und ist damit genau so benutzbar wie eine eindeutige ID)

===Langtext===
* Advanced settings
** Allow html (wenn erlaubt werden in dem Feld HTML-Tags erlaubt - Liste der erlaubten HTML-Tags ist in den Eigenschaften von Contao editierbar)
** Rich Text (wenn angekreuzt wird der TinyMCE angezeigt)

===Nummer===
* Advanced settings
** Minimum (legt den Minimalwert fest, den ein Benutzer eingeben kann)
** Maximum (legt den Maximalwert fest, den ein Benutzer eingeben kann)
* Format settings
** Prefix und Suffix Strings
** Format
*** Formattyp
**** Zeichenkette
**** Nummer
**** Datum
*** Zeichenfolge für Formatierung

===Dezimal===
* Advanced settings
** Minimum (legt den Minimalwert fest, den ein Benutzer eingeben kann)
** Maximum (legt den Maximalwert fest, den ein Benutzer eingeben kann)
* Format settings
** Prefix und Suffix Strings
** Format
*** Formattyp
**** Zeichenkette
**** Nummer
**** Datum
*** Zeichenfolge für Formatierung

===Datum===
* Advanced settings
** Zeiteingabe (Falls ausgewählt, darf der Benutzer Datum '''und''' Zeit eingeben
** Format
*** Formattyp
**** Zeichenkette
**** Nummer
**** Datum
*** Zeichenfolge für Formatierung

===Checkbox===
Zum Erstellen einer einfachen Checkbox. Hier kann nicht viel eingestellt werden, da ja nur 1 oder 0 als Zustand gilt.

===Auswahl===
Hiermit kann man ein Auswahl-Feld (Select) erstellen, das als Grundlage eine andere Tabelle nutzt. Das kann Taxonomie sein oder auch ein anderer Katalog.

* Advanced settings
** Include blank option (Um bei der Drop-Down Liste auch die Möglichkeit zu haben, eine leere Auswahl anzubieten)
* Options settings
** Tabelle für Optionen (Hier muss die Tabelle ausgewählt werden, in der die Optionen stehen - Taxonomie wäre -> tl_taxonomie)
** Spalte für Tabellenwerte (Eine Spalte für die Speicherung einer Option auswählen. Hier sind nur die Spalten vorgegeben, die sich auch in der Tabelle befinden)
** Anzeige der Sortierspalte (Um die Sortierung der Optionen vorzunehmen kann hier eine andere Spalte ausgewählt werden.)
** Filter items (Hier kann man wieder eigene Filter definieren, um die Auswahl einzugrenzen)
** Auswahl der Einträge
*** Optionen (Hier kann man noch mal genau auswählen, welche Optionen man anbieten möchte)
*** Modus für Unterauswahl
**** Show selected items collapsed (Nur die ausgewählten Items anzeigen)
**** Show children of selected items collapsed (Nur die Kinder der selektierten Items anzeigen)
**** Tree with all items selectable (Baumansicht mit allen Items als Option auswählbar)
**** Tree with only children selectable (Baumansicht nur mit den Kind-Items auswählbar)
*** Parent Filter (Hier kann man das Eltern Element angeben, welches die Optionen enthält. Praktisch wenn man 2 Bäume bei der Taxonomie hat und nur einen zur Auswahl geben will)

===Tags===
Auch Tags sind ähnlich der Auswahl dazu da, eine andere Tabelle als Wert anzugeben.

Der Unterschied besteht darin, das Tags eine Checkboxliste ergeben, mit der auch eine Mehrfachauswahl möglich ist.

* Advanced settings
** Include blank option (Um bei der Drop-Down Liste auch die Möglichkeit zu haben, eine leere Auswahl anzubieten)
* Options settings
** Tabelle für Optionen (Hier muss die Tabelle ausgewählt werden, in der die Optionen stehen - Taxonomie wäre -> tl_taxonomie)
** Spalte für Tabellenwerte (Eine Spalte für die Speicherung einer Option auswählen. Hier sind nur die Spalten vorgegeben, die sich auch in der Tabelle befinden)
** Anzeige der Sortierspalte (Um die Sortierung der Optionen vorzunehmen kann hier eine andere Spalte ausgewählt werden.)
** Filter items (Hier kann man wieder eigene Filter definieren, um die Auswahl einzugrenzen)
** Auswahl der Einträge
*** Optionen (Hier kann man noch mal genau auswählen, welche Optionen man anbieten möchte)
*** Modus für Unterauswahl
**** Show selected items collapsed (Nur die ausgewählten Items anzeigen)
**** Show children of selected items collapsed (Nur die Kinder der selectierten Items anzeigen)
**** Tree with all items selectable (Baumansicht mit allen Items als Option auswählbar)
**** Tree with only children selectable (Baumansicht nur mit den Kind-Items auswählbar)
*** Parent Filter (Hier kann man das Eltern Element angeben, welches die Optionen enthält. Praktisch wenn man 2 Bäume bei der Taxonomie hat und nur einen zur Auswahl geben will)

===URL===
Der Feldtyp URL hat keine besonderen Parameter. Er dient lediglich der Ein- und Ausgabe einer URL.

===Datei===
Dieser Feldtyp ist für die Ein- und Ausgabe von Dateien vorhanden. Man kann damit Downloads oder Galerien erstellen. Falls die ausgewählte Datei nicht unter den Contao-Einstellungen eingetragen ist, so bleibt das Feld "value" (mehr dazu siehe "Welche Variablen hat man in einem Template zur Verfügung?") leer. Aus diesem Grund sollte man im Vorhinein die entsprechenden Dateitypen freischalten.
* Advanced Settings
** Mehrere Dateien (Wenn ausgewählt können mehrere Dateien ausgewählt werden)
** Ändern des Dateibaumes
*** Setzen des Ordners für das Wurzelverzeichnis (Hier kann ein spezieller Dateibaum gewählt werden, um unnötige Wege zu verkürzen)
*** Gültige Dateitypen (In einer Komma-separierten Liste kann man hier die Dateitypen auf eine gültige Liste einschränken)
*** Nur Dateien erlauben (Ordner sind dann nicht anwählbar)
*Format settings
** Bild anzeigen (Um ein Bild / eine Bildergalerie anzeigen zu lassen)
*** Bildbreite und -höhe sind auswählbar
** Link erzeugen
*** Um einen Link zum Herunterladen der Datei zu erzeugen oder bei einem Bild eine Vollansicht (Lightbox) anzubieten

===Calculate===
Um Berechnungen auf SQL Ebene vorzunehmen
* Calculation formula (Eingabe von einer SQL calculation für das Feld, wie '(price*1.15)*qty'
* Format settings
** Prefix und Suffix Strings
** Format
*** Formattyp
**** Zeichenkette
**** Nummer
**** Datum
*** Zeichenfolge für Formatierung

===Bewertungen===
Die Besucher der Internetseite können bei Angabe eines solchen Feldtypes eine Bewertung vornehmen
* ajaxratingfield (Angabe von maximalen Punkten die ein Besucher vergeben kann)

===Zugriffszähler===
Ohne Optionen. Hiermint wird einfach gezählt und ausgegeben wie oft auf dieses Item zugegriffen wurde. Es ist auf ein Klick per IP pro Tag festgelegt.

===Frontend Benutzer===
Ohne Optionen.
Um die Items nur dem jeweiligen Frontendbenutzer der sie angelegt hat zuzuweisen muss ein Feldtyp dieser Art angelegt sein.

===Meta Keywords===
Ohne Optionen.
Um eine Liste von Keywords für diese Item eingeben zu können.
{{Anmerkung|der Feldtyp "Meta Keywords" ist veraltet, da in der Katalog Konfiguration direkt nun ein Textfeld als Quelle der META Keywords gewählt werden kann.}}

===Mehrspaltiger Text===

Nur verfügbar wenn zusätzlich installiert: [http://www.contao.org/erweiterungsliste/view/catalogmultitextwizardfield.html direkt zum ER]

Hiermit kann ein Feld ähnlich des Tabellenelements in Contao angelegt werden.
Man definiert einmal die Spaltenanzahl und Überschriften.
Beim Anlegen des Items hat man dann die Möglichkeit beliebig viele Zeilen anzugeben.
* Spaltenüberschriften (Angabe der Anzahl, der Reihenfolge und der Titel der Spaltenüberschriften)

Für das Frontend Editing (wenn man dieses Feld dort editieren möchte) braucht man die Erweiterung [http://www.contao.org/erweiterungsliste/view/x_FrontendMultiTextWizard.de.html xFrontend MultiTextWizard]. Ansonsten ist dieses Feld nicht editierbar.

===Produktvariante (Besonderheit vom chshop -> wird dort erläutert)===

=== Merkliste und Varianten ===
Mit diesem Feldtyp ist es möglich Items für eine Merkliste vorzubereiten.
* Notelistvariants sind die Varianten, die ein Item besitzen können. Die Liste der Varianten besteht aus Select- und Tagfields des Katalogs. Dadurch ist es möglich Varianten von der Taxonomie oder von anderen Katalogen zu erstellen, indem man in diesem Katalog Auswahlen dafür anlegt.

==Sobald man Felder definiert hat==
ist in der Übersicht bei den Feldern zu sehen ob ein Feld:
* zur Suche markiert ist
* Sortierbar ist
* Gruppiert wurde (um die Reihenfolge festzulegen)
* ein Pflichtfeld ist
* ob es eine Kontrol Checkbox ist (nur wenn angewählt wird es sichtbar)
* Ob es ein Dateityp ist
* Ob es sich um ein Bild handelt
* in der halben Breite im Backend angezeigt wird
* Ob darüber ein Filter angewendet wird

[[Datei:cat-cat2-fieldpreview.png|Felderübersicht]]

=Frontend Module und ihre Attribute=

Bei den verschiedenen Modulen muss zunächst eine Auswahl getroffen werden, für welchen Katalog das Modul gemacht wird. Dabei kann immer nur ein Katalog gewählt werden.

'''Allgemeine Einstellungen (die alle Module haben):'''
* Titel
* Überschrift
* Modultyp (mit den unten stehenden Modultypen)
* Zugriffsschutz (Nur bestimmten Gruppen das Modul anzeigen)
* Experten Einstellungen
** Nur Gästen anzeigen
** CSS-ID/Klasse
** Abstand davor und dahinter

[[Datei:cat-cat2-view-list.jpg|Cat Modul Liste]]

[[Datei:cat-cat2-view-reader.jpg|Cat Modul Reader]]

==Catalog List==
Zur Ausgabe einer Liste von Items wird das Modul [[ModuleCatalogList]] verwendet.

==Catalog Reader==
Um die Details von einem einzelnen Item anzuzeigen
* Als Wichtigstes muss eine Weiterleitungsseite eingestellt werden. Auf dieser Seite muss der Catalog Reader vorhanden sein.
* catalog layout (Auswahl des Templates für den Reader)
** catalog_full (Standardtemplate um Alles auszugeben)
** catalog_full_rev (Template um alle Felder auszugeben - Entwickler Version)
* Visible Fields - Sichbare Felder. Diese Felder sind dann im Template verfügbar. Man kann auch die Reihenfolge der Ausgabe bestimmen.

==Catalog Filter==
Mit Hilfe von einem Filter können Besucher die Liste eines Catalogs filtern und die Anzeige eingrenzen. Die Filter können hier genau eingestellt werden. Sogar ein eigenes Suchfeld nur für den einen Katalog kann hier erstellt werden.
* Catalog -> für welchen Katalog soll dieser Filter benutzt werden (es kann nur ein Katalog angegeben werden)
* Weiterleitungsseite (auf welche Seite soll bei Klick weitergeleitet werden. Üblicherweise ist das eine Seite mit dem Modul 'cataloglist', da hier dann nur noch die Items angezeigt werden, die zu der gefilterten Ausgabe passen)
* Filter layout (default -> filter_default | zum Entwickeln ist das filter_widget Template gedacht)
* Enables Filter By section (Einen Filter erstellen)
** Filter Headline (Überschrift für diese(n) Filter)
** Filter Fields (Hier kann man das Feld und die Art des Filters auswählen)
*** Die Reihenfolge bestimmt man mit den grünen Pfeilen neben der Feldbezeichnung
*** Tree View (Ankreuzen wenn es eine baumartige Struktur sein soll, bzw. bei diesem Feld eine baumartige Struktur eingegeben wurde. Die Kindelemente reagieren dabei auf die Auswahl der Elternelemente)
*** None (default Wert -> es wird von diesem Feld kein Filter erstellt)
*** Links List (eine einfache Link Liste wird von dem Feld erstellt)
*** Radio Button (Eine Auswahl mittels Radio Button wird erstellt, so ist die Auswahl nur von einem Wert möglich)
*** Select drop-down (Eine Auswahl mittels einer Select-Box wird erstellt. Nur ein Wert kann ausgewählt werden.)
** Reveal tree view sequentially (Die Filter werden erst nach und nach eingeblendet. Die Reihenfolge bestimmt dabei die Einblendung. So wird der 2. Filter erst eingeblendet, wenn im ersten etwas ausgewählt wurde. Eine Möglichkeit wäre hier die Auswahl von Städten, die erst erscheint, wenn ein Bundesland ausgewählt wurde)
** Tags multiple select allowed (Wenn dieses Feld ausgewählt wurde, wird aus dem Radio Button eine Checkbox und aus der Select drop-down Liste eine Liste mit der Möglichkeit meherere auszuwählen.)
* Enables Range section (Hier können Felder ausgewählt werden, wo ein Minimum und Maximum eingegeben werden kann um darüber zu Filtern)
** Range Headline (Überschrift angeben)
** Range Fields (Auswahl der Felder für die ein Bereichsauswahl erstellt werden soll. Die Liste ist auch wieder sortierbar)
* Enables Date section (Hier können Felder ausgewählt werden, welche nach Datum zusammengefasst werden können)
** Dates Headline (Überschrift angeben)
** Date Fields (Hier sind nur Datumsfelder zur Auswahl angeboten. Man kann bestimmen, welches benutzt werden soll)
** Date Ranges (Hier kann angegeben werden, welche Auswahl der Besucher hat, um die Daten zu filtern):
*** Last year
*** Last 6 months
*** Last month
*** Last week
*** Yesterday
*** Today
*** Tomorrow
*** Next week
*** Next month
*** Next 6 months
*** Next year
* Enables Sort section (Hier wird eingestellt, welche Felder vom Besucher überhaupt sortierbar sind und wie das geschehen soll)
** Sort Headline (Überschrift angeben)
** Sort Fields (Hier muss angegeben werden, welche Felder sortierbar sein sollen. Die Reihenfolge kann wieder über die grünen Pfeile bestimmt werden)
** Sort form control type Hier wird festgelegt, wie die Besucher bestimmen können wie sortiert wird:
*** select (Über eine Select Auswahl)
*** list (Mit hilfe einer Linkliste)
*** radio (Über einen Radio Button)
* Enables Search Box (Eine Suchbox einschalten. Nur Text, langtext Felder werden unterstützt)
** Search Headline (Überschrift eingeben)
** Search Fields (Hier können die Felder ausgewählt werden, in denen gesucht werden soll)
* Use filter condition from lister on same page (Wenn auf derselben Seite auch eine List-Modul von dem Katalog eingesetzt wird und diese Liste mit conditions eingeschränkt ist, werden bei Auswahl dieses Feldes die Filter mit Berücksichtigung der conditions erstellt.)

==Catalog Navigation==
Mit diesem Modul kann man eine Navigation durch einen Katalogs erstellen. Die Navigation besteht zum Beispiel aus Kategorien.
* Catalog -> für welchen Katalog soll diese Navigation genommen werden (es kann nur ein Katalog ausgewählt werden)
* Weiterleitungsseite (auf welche Seite soll bei Klick weitergeleitet werden. Üblicherweise ist das eine Seite mit dem Modul [[ModuleCatalogList|Katalog liste]], da hier dann nur noch die Items angezeigt werden, die zu der Kategorie passen)
* Navigations field -> Hier muss das Feld angegeben werden, aus dem die Navigation zusammengesetzt wird. Also ein Selectfield aus dem gewählten Katalog. (Andere Felder wie Tagfield gehen nicht und stehen deswegen nicht zur Auswahl!)
* Alle anderen Einstellungen der Navigation funktionieren genau so wie beim normalen [[ModulNavigation|Navigationsmodul]]

==Catalog Notify==
Hiermit wird ein Formular erstellt, welches zur schnellen Kontaktaufnahme bei einem einzelnen Item dargestellt wird. Z.B.: Möchten Sie nähere Informationen zu diesem Produkt? Dann schicken Sie uns bitte Ihre Kontaktdaten, damit wir uns bei Ihnen melden können.
* Catalog (Hier muss wieder der Katalog angegeben werden, in dem das Item dargestellt werden soll)
* Form Fields (Hier können Sie Felder angeben, die der Benutzer ausfüllen soll, damit Sie Kontakt zu ihm aufnehmen können)
{{Anmerkung|Der folgende Punkt ist in catalog 2.0.0 beta1 Build 51 nicht, oder nicht mehr vorhanden!}}
* Sicherheitsfrage deaktivieren (nicht empfohlen! Nur sinnvoll, wenn die Benutzer schon in einem Bereich sind, in dem man sich anmelden muss)
* Subject (Betreff der Email, hier können spezielle Inserttags benutzt werden in der Art -> <nowiki>{{catalog::Spaltenbezeichnung}}</nowiki>. Z.B. <nowiki>{{catalog::title}}</nowiki>
* Recipients List (Liste von Emailadressen, die eine Email mit dem Inhalt erhalten sollen)
* Body text (Text der Email. Auch hier sind die speziellen Inserttags <nowiki>{{catalog::Spaltenbezeichnung}}</nowiki> möglich. Zusätzlich sind noch die Variablen ##catalog## und ##link## verfügbar. Wobei catalog durch den Katalog und link durch den direkten Link zu dem Item ersetzt werden.
* Catalog Template (Hier kann das passende Template angegeben werden um das Formular darzustellen. Default ist mod_catalognotify)

==Catalog Featured==
Hiermit kann man eine Liste erstellen, die besondere Items darstellt. Die Liste wird per Zufall zusammengestellt.
* Grundeinstellungen sind wie bei der Catalog-List
* Besonderheiten:
** Number of items (Hier kann die Anzahl der Items dargestellt werden. 0 zeigt alle)
** Custom ordering (Die Reihenfolge kann hier festgelegt werden)
* Um spezielle Einträge anzulegen braucht nur ein extra Feld (checkbox) erstellt werden (z.B. hervorgehoben) und in der Condition können dann Items festgelegt werden, deren Wert 1 ist -> spalte_hervorgehoben=1

==Catalog Related==
Hiermit erstellt man eine Liste von ähnlichen Items - einzusetzen auf einer Seite, auf der auch der Catalog Reader enthalten ist. Zufallsausgabe.
* Grundeinstellungen sind wie bei der Catalog-List
* Besonderheiten:
** Related fields to match (Angabe der Felder, die bei den darzustellenden Items gleich sein sollen)
** Amount of tags that must be in common (Einstellen der Anzahl der Übereinstimmungen -> Minimumangabe. d.h. wenn 3 Felder angegeben wurden, die übereinstimmen sollen, kann bei einer Angabe von 1 auch ein Item angezeigt werden, welches nur eine Übereinstimmung hat und nicht alle 3)
** Number of items (Hier kann die Anzahl der Items dargestellt werden. 0 zeigt alle)
** Custom ordering (Die Reihenfolge kann hier festgelegt werden)

==Catalog Reference==
Hiermit erstellt man eine Liste von Items mit einer gleichen Eigenschaft. Diese muss zusammen mit dem Catalog Reader eingesetzt werden und ist für die Anzeige von Items aus einem '''anderen''' Katalog.
* Grundeinstellungen sind wie bei der Catalog-List
* Besonderheiten:
** Select the match field (Das Feld auswählen, welches die Verbindung zum anderen Katalog herstellt)
** Select reference catalog (Den zweiten Katalog auswählen, wo die anzuzeigenden Items enthalten sind)
** Select the reference field (Das Feld angeben, welches im 2. Katalog für die Identifizierung genutzt wird. Es soll dasselbe Feld angegeben werden, welchen auch schon für die Verknüpfung genommen wurde)
** Number of items (Hier kann die Anzahl der Items dargestellt werden. 0 zeigt alle)
** Custom ordering (Die Reihenfolge kann hier festgelegt werden)

==Catalog Edit==
Um ein Item im Frontend editieren und erstellen zu können. Dieses Modul wird anstelle von Catalog Reader verwendet.
*Catalog (den Katalog auswählen, dessen Items im Frontend editierbar sein soll)
* Editable Fields (Angabe der Felder, die editierbar sein sollen. Mit den Pfeilen kann man diese in der Reihenfolge anordnen)
* Weiterleitungsseite (Seite die angezeigt werden soll, wenn das Formular abgesendet wurde. Meistens wird wieder zurück zu der Liste weitergeleitet)
* Sicherheitsabfrage deaktivieren (Nicht empfohlen! Es sei denn, nur angemeldete Benutzer haben Zugriff auf diese Seite)
* Restricted fields (Mit dieser Einstellung können Vorbelegungen, die _nicht_ geändert werden können, vorgenommen werden. Diese Felder sollten nicht als Editable Fields konfiguriert sein)
** Wählen Sie hier die Felder aus, welche vorbelegt sein sollen
** Restricted fields default values (Sind erst '''nach dem Speichern einstellbare Vorgaben''' für die Felder, die vorher ausgewählt wurden -> Jeder Feldtyp ist individuell einstellbar.)
** Beispiel für ein Restricted field: Ein Feld mit einer Checkbox, ob das Item online sein soll. 'online' bekommt als default Wert 'Nein'. Nun ist jedes Item, was über diesen Catalog Editor erstellt oder bearbeitet wird offline! So kann man im Frontend mit einer extra Gruppe, die dieses Feld bearbeiten kann und eben keine default Vorgabe hat die Items freischalten. Die 'normalen' Benutzer haben dieses Recht dann nicht.

=Weitere Einstellungsmöglichkeiten=

== Merkliste - Formulargenerator ==
Die Merkliste wird nicht als extra Modul erstellt, sondern in einem Formular mit dem Formulargenerator von Contao.

Dazu gibt es ein neuen Feldtyp 'Merkliste' der zum Beispiel am Anfang positioniert werden kann.
Der Besucher kann später das Formular ausfüllen und so die Liste an den Emailempfänger versenden, um sich so zum Beispiel ein Angebot für die Items einzuholen.

Einstellungen:
* Feldname (der Feldname für diesen Feldtyp)
* Feldbezeichnung (diese wird normalerweise für Felder als Label angezeigt und sollte daher hier '''leer''' gelassen werden)
* Text (Hier kann ein Text angegeben werden, der über der Liste der Items angezeigt wird)
* Katalog (Den Katalog angeben, der die Items enthält)
* Sichtbare Felder (Die anzuzeigenden Felder von den Items, die Liste ist auch hier wieder über die Pfeile sortierbar)

=== Templates für die Merkliste ===
* form_catalognotelist.tpl (Template für die Liste im Formular)
* form_catalognotelist_mail.tpl (Template für die Email, welche die Items vom Merkzettel enthält. Hier kann genau festgelegt werden, welche Felder in der Email von einem Item angezeigt werden.)

=Tipps und Tricks zur Umsetzung=

==Welche Variablen hat man in einem Template zur Verfügung?==
<source lang="php">
<?php print_r($this->entries); ?>
</source>
oder
<source lang="php">
<?php $this->showTemplateVars(); ?>
</source>
Damit bekommt man das komplette Array ausgegeben.

==Zeichenkette des Titels formatieren==
Warum wird bei mir nichts angezeigt, obwohl ich da etwas angegeben habe?
* Wichtig: man muss bei den Feldern die man später hier benutzen möchte folgendes Ankreuzen -> Anzeige-Einstellungen > Sichtbar in der Backend-Listen-Ansicht

==Wie kann man in der Detail Ansicht den meta-title so beeinflussen, das dieser den Namen von dem Item nimmt?==
* Einfach das Feld für den Namen mit title benennen (das ist die Fallback Methode, wenn die andere -> Page title field nicht benutzt wird). Der catalog wird dann automatisch dieses Feld benutzen um den meta-title zu generieren.
* Page title field beim Katalog sezten. Zu finden unter 'Search' in den Einstellungen vom Katalog.

==Titel so beeinflussen, das die aktuelle Kategorie einer Liste dort steht==
Im Catalog Template folgendes nutzen:
<source lang="php">
<?php if(strlen($this->Input->get('kategorie')))
{
global $objPage;
$objPage->pageTitle = "".$entry['data']['kategorie']['value']." - XYZ";
}
?>
</source>
In dem Beispiel wird jetzt (nur wenn eine Kategorie gewählt ist) der Wert von '''$entry['data']['kategorie']['value']''' eingesetzt.

==Wie bekommt man ein Auge bei den Items? / on- offline Schalten von Items==
Zuerst muss man sich in Feld vom Typ 'Checkbox' anlegen. Zum Beispiel mit dem Namen 'online'.
Jetzt kann man den Katalog konfigurieren und bei '''Feld veröffentlichen''' (publish Field) das Checkbox-Feld auswählen.
Ab jetzt ist im Backend bei den Items eines Katalogs ein graues oder grünes Auge (je nach Zustand) sichtbar.

==Detail Seiten in die sitemap.xml und ins Modul Sitemap bringen==
* sitemap.xml -> Den Katalog einfach für die Indexierung der Suche freigeben -> [http://tip.dasprojekt.org/Catalog_2#Erstellen_von_einem_Katalog_.28Backend.29 Searchable] (Achtung: eine Weiterleitungsseite muss auf jeden Fall angegeben sein beim Katalog selber. Diese Seite wird dann in der Sitemap benutzt um die Items darzustellen.)
* Modul Sitemap -> Hier werden die Detailseiten nicht integriert, da es bei einem normalen Katalog schon zu viele Einträge wären, um diese dort sinnvoll darzustellen.

==Alias bei Links benutzen (anstelle der ID)==
Dazu brauchst man nur ein Pflichtfeld (Namen von dem Item) und erstellt dann noch ein Feld vom Typ Alias. Das Alias-Titel-Feld ist dann der Name des Items.
Bei dem Katalog selber muss noch ausgewählt werden, welches das Alias Feld ist.
Das Alias Feld ist genau so wie das Alias Feld von Seiten etc., man kann selbst etwas eintragen oder den Inhalt automatisch generieren lassen, wenn man das leer lässt.
Nachdem die Suche und die Seiten neu generiert wurden (Systemwartung) sollte der Alias bei der Suche und auch bei der Detailansicht (URL) genutzt werden.
'''Im Moment muss in der Liste das Alias Feld als 'Sichtbar' ausgewählt werden. Sonst funktioniert die Verlinkung nicht! (Sollte in der Endversion behoben sein)'''

==Folder-URL und der catalog wollen nicht so recht==

Unter Einstellungen kann unter Sicherheitseinstellungen eine Liste von Variablennamen angeben werden, welche von der Erweiterung Folder-URL als Parameter erkannt werden sollen. Hier muss "orderby,sort" angegeben werden. Dadurch 'ignoriert' Folderurl diese Parameter und der catalog ist wie immer nutzbar.

Es sollten alle Schlüsselwörter der Filtermöglichkeiten hinzugefügt werden. Wenn man die Einträge des Kataloges nach z.B. "Ort" sortieren will, gibt es einen Fehler, wenn das Feld der Datenbanktabelle nicht bei den "URL Schlüsselworte" in den Einstellungen auftaucht.

==Eine Liste im Frontend so sortieren wie im Backend==

Um eine Liste genau so zu sortieren wie im Backend braucht man einfach nur bei der Sortierung nach dem Feld 'sorting' zu sortieren (z.B. sorting ASC). Im Backend können Einträge nur dann manuell sortiert (verschoben) werden, wenn bei keinem Feld die Einstellung 'Sortier DropDown aktivieren' aktiv ist.

{{Achtung|Bitte klären, da die Filterung dann nicht mehr funktioniert. Siehe Thread im Forum: [http://www.contao-community.de/showthread.php?13299-BE-Eintr%E4ge-verwalten-kein-Button-Anwenden-f%FCr-Filterung-vorhanden BE, Einträge verwalten, kein Button 'Anwenden' für Filterung vorhanden ]
[[http://code.google.com/p/typolight-catalog/issues/detail?id=199 Bug-Report]] [[http://code.google.com/p/typolight-catalog/source/detail?r=198 fixed in r198]]}}

{{Hinweis|Mit der Erweiterung [[catalog_manualsort]] ist es möglich die Reihenfolge der Einträge im Backend trotzdem zu ändern, auch wenn die Sortieroption für bestimmte Felder aktiv ist.}}

==Items im Backend verschieben==
Damit man Items im Backend verschieben kann darf die '''Sortierungs Option''' (Feld-Eigenschaften->Backend Filter Einstellungen->'Sortierungs Dropdown aktivieren') '''bei keinem Feld aktiviert''' sein.
{{Achtung|Bitte klären, da die Filterung dann nicht mehr funktioniert. Siehe Thread im Forum: [http://www.contao-community.de/showthread.php?13299-BE-Eintr%E4ge-verwalten-kein-Button-Anwenden-f%FCr-Filterung-vorhanden BE, Einträge verwalten, kein Button 'Anwenden' für Filterung vorhanden ]}}

==Bedingung bei Strings==

Um eine Bedingung anzugeben, die innerhalb eines Strings vorhanden ist, reicht es ja nicht einfach nur einen Vergleich per SQL vorzunehmen.
Beispiel: Über den Feldtyp Tag sind Taxonomieen einem Produkt zugeordnet. Da das mehrere sein können muss man die Bedingung in der Liste wie folgt abfragen ->
<source lang="php">
FIND_IN_SET(7, kategorie)
</source>
D.h.: es soll innerhalb von kategorie nach der ID 7 gesucht werden.

==Formatieren der Felder vom Typ Text, Nummer und Dezimal==
Options-Checkbox: '''Zusätzliche Format-Funktionen aktivieren.'''

Das Auswahlmenü '''Format-Funktion''' erlaubt es, die Feldtypen '''Text''', '''Nummer''' und '''Dezimal''' zu formatieren. So gehts:

=== Zeichenkette ===
Hier gibt man einen sprintf Formatierungs-String ein (siehe [http://de3.php.net/sprintf PHP: sprintf - Manual])

''Beispiel Zeichenkette:''
* '''Feldinhalt:''' Broccoli
* '''Formatierungs-String:''' Auf zum %s!
* '''Ausgabe:''' Auf zum Broccoli!

=== Nummer ===
Hier gibt man nur die Anzahl der gewünschten Nachkommastellen an. In der Ausgabe erscheinen nun die in Contao festgelegten Tausender- und Dezimal-Trennzeichen.

''Beispiel Nummer:''
* '''Feldinhalt:''' 1000
* '''Nachkommastellen:''' 2
* '''Ausgabe:''' 1.000,00

=== Datum ===
Hier gibt man ein Formatierungsmuster ein (siehe [http://de.php.net/manual/de/function.date.php PHP: date - Manual])

''Beispiel Datum:''
* '''Feldinhalt (Unix Timestamp):''' 1293217200
* '''Formatierungsmuster:''' Y-m-d H:i
* '''Ausgabe:''' 2010-12-24 18:00

==Filtern nach Datum==

Aufgabenstellung:
Das Datumsfeld ist in dem Format 'dd.mm.yyyy' vorhanden.
Es soll nun für das aktuelle Jahr eine Ausgabe erfolgen und für die vergangenen Jahre ein Archiv erstellt werden.

Das Problem:
Die Datum Angaben werden als timestamp gespeichert und sind in einem char Feld.

Lösungsansatz:
<source lang="php">
meinedatumsvariable BETWEEN UNIX_TIMESTAMP('{{date::Y}}-01-01') AND UNIX_TIMESTAMP('{{date::Y}}-12-31')
</source>
So kommt man an die Daten des aktuellen Jahres, um die Daten von 2009 auszugeben:
<source lang="php">
meinedatumsvariable BETWEEN UNIX_TIMESTAMP('2009-01-01') AND UNIX_TIMESTAMP('2009-12-31')
</source>

===Probleme die bei Unix Timestamp auftreten können===
Es kann passieren, das der Unix Timestamp beim Verarbeiten von PHP falsch interpretiert wird (nicht als Zahl).
Daher kann es nötig sein, diesen erst durch einen kleinen Trick auf jeden Fall in einen Zahlenwert umzuwandeln:
<source lang="php">
ROUND(datum)
</source>
Damit wird auf einen Zahlenwert gerundet (da es sich schon um Integer Werte handelt geht dabei nichts verloren).

Beispiel (von do_while) aus dem Forum:
<source lang="php">
ROUND(datum) BETWEEN UNIX_TIMESTAMP('{{date::Y}}-01-01') AND UNIX_TIMESTAMP('{{date::Y}}-12-31')
</source>
Hier wird nach dem Datum sortiert.

==Mit DCA Felder besser einschränken==
Inzwischen ist es möglich Felder über DCA zu steuern. Der Vorteil: dadurch kann man wesendlich besser Fehleingaben abfangen.
Hier unter 'Felder' kann mna die Möglichkeiten der Konfiguration sehen -> [http://www.contao.org/referenz.html http://www.contao.org/referenz.html]

Um ein Feld zum Beispiel nur für den Lesenden Zugriff freizugeben kann man diese Syntax nutzen:
<source lang="php">
$GLOBALS['TL_DCA']['tabellenname']['fields']['spaltenname']['eval']['readonly'] = true;
</source>

Oder die Eingabe von einer E-Mail überprüfen:
<source lang="php">
$GLOBALS['TL_DCA']['tabellenname']['fields']['spaltenname']['eval']['rgxp'] = 'email';
</source>

==CSV import==
Um die Daten richtig importieren zu können muss darauf geachtet werden, das diese UTF-8 kodiert sein müssen. Das wird von Exel nicht direkt so gemacht.

==Mehrsprachige Filter mit dem Taxonomie Modul==
Möchte man einen Mehrsprachigen Katalog erstellen und diesen nach Taxonomien Filtern, so gibt es u.a. zwei Möglichkeiten dies zu tun:
* Für jede Sprache einen Taxonomiebaum erstellen. Problem: Doppelte Zuweisung im Katalog-Item + mehrere Taxonomiebäume
* Bessere Lösung: Man arbeitet mit den sprachabhängigen Inserttags. So kann man je nach Spracheinstellungen der Seite eine passende Frontend-Ausgabe erreichen.

Beispiel:
Möchte man jedem Item ein Land zuordnen, so erstellt man einen Taxonomie-Eintrag "Länder" und in fügt in diesen die auswählbaren Länder ein. Für "Deutschland" könnte das dann z.B. so aussehen:
<nowiki>{{iflng::de}}</nowiki>Deutschland<nowiki>{{iflng}}{{iflng::en}}</nowiki>Germany<nowiki>{{iflng}}</nowiki>
Nun sollte der Filter auf der deutschen Seite "Deutschland", und auf der englischen "Germany" ausgeben.
Dabei gibt es allerdings ein Problem mit dem Feldtyp in der Datenbank. Dieser ist auf wenige Zeichen beschränkt, wird somit bei entsprechender Länge gekürzt. Um dies '''nicht updatesicher''' zu korrigieren, muss man ins phpMyAdmin gehen und unter tl_taxonomy die Länge des entsprechenden Feldes (ich glaube es ist: "name") ändern. (wird später genauer beschrieben)

==Frontendausgabe Sortieren bei einem Feld was von einem anderen Catalog oder der Taxonomie kommt==
Beispiel:
Katalog A hat ein Select wo man Items aus Katalog B auswählen kann.

<source lang="sql">(SELECT sorting FROM catalog_tabellenname AS cs WHERE cs.id=catalog_feld) ASC</source>

catalog_tabellenname = Tabelle die das Feld beinhaltet (Katalog B)
catalog_feld = Name von dem Feld welches im Select genutz wird. (Feld in Katalog B)

=Video Tutorials aus dem Internet=
Ein paar Videos zu dem Catalog:

{{#widget:YouTube|id=Dg55QT7uGEI}} {{#widget:YouTube|id=wwhuSCQ4Jb4}}

=Tutorials=
* [[Catalog Merkzettel erstellen]]
* [[Catalog mit Frontend-Editing und Workflow erstellen]]
* [[Catalog Templates anpassen]]
----

--[[Benutzer:Toflar|Toflar]] 15:12, 15. Mai 2010 (UTC+1)

--[[Benutzer:MacKP|MacKP]] 13:02, 5. Apr. 2010 (UTC)

--[[Benutzer:Nils.riel|Nils.riel]] 12:04, 24. Nov. 2010 (CET)

Die erste Webseite

2011-02-19T00:48:08Z

Xtra: Sprache Englisch hinzugefygt

[[en:First page]]
[[Category: Erste_Schritte]]
{{AppliesTo|Version=ab 2.9}}
=Einleitung=
Dieses Tutorial soll es Einsteigern erleichtern und zeigen, wie man eine Website in Contao aufbaut. Es geht nicht auf die Details zu jedem Einstellpunkt ein. Es soll nur die Frage beantworten: Ich habe Contao installiert, wo beginne ich jetzt mit meiner Website?

Das Ergebnis dieser Anleitung wird eine Website mit zwei Spalten, einem Header und einem Footer sein, welche ein paar Seiten und Artikel enthält. Die Anforderungen der Website sind:
*Breite: 960px
*Ausrichtung: zentriert
*Höhe der Kopfzeile/Header: 50px
*Breite der linken Spalte: 220px
*Höhe der Fußzeile/Footer: 25px

=Voraussetzung=
*Contao wurde hoch geladen und erfolgreich installiert
*Mit dem [[Systemdiagnosetool]] wurde die [[Installation]] geprüft und, falls vorhanden, alle Fehler beseitigt
*Die Beispielwebseite "Music Academy" wurde bei der Installation NICHT importiert
*HTML und CSS Kenntnisse

=Vorbereitungsarbeit=
==Dateien==
Sämtliche Dateien (Bilder, Dokumente, Filme,..), die man für die Webseite benötigt, werden bei Contao im Ordner /tl_files/ gespeichert. Um die Übersicht zu behalten, kann man verschiedene Unterordner erstellen. Contao hat eine integrierte [[Dateiverwaltung]]; zu finden im Backend unter System --> Dateiverwaltung. Bei dieser Beispielwebseite werden alle zugehörigen Dateien im Ordner /tl_files/firstsite/ gespeichert. Da die Dateien, die für die Darstellung der Webseite verwendet werden, getrennt von den Dateien, die z.B. Redakteure in Artikeln oder News verwenden, abgelegt werden sollen, erzeugt man einen weiteren Unterordner mit dem Namen "theme". Der Pfad lautet daher /tl_files/firstsite/theme/.

[[Datei:firstsite-filemanager.png|Filemanager|frame|center]]

==Templates==
Templates (siehe auch [[Templates bearbeiten]]) werden im Ordner /templates/ verwaltet. Im Backend findet man die Templates über Layout --> Templates. Ähnlich wie bei den Files verhält es sich auch bei den Templates. Hier reicht jedoch ein Unterordner, in dem (sofern notwendig) alle modifizierten Templates der Webseite "firstsite" gespeichert werden.

[[Datei:firstsite-templates.png|Templates|frame|center]]

{{Hinweis|Dateien, die sowohl im Ordner "tl_files" als auch im Ordner "templates" liegen werden bei Updates des Contao-Cores NICHT verändert! Es empfiehlt sich aber dennoch gerade diese Dateien/Ordner als auch die Datenbank mehrfach zu sichern, da eben hier die Früchte Ihrer Arbeit und die Ihrer Redakteure liegen.}}

=Theme=
Im [[Theme-Manager]] erstellt man ein neues Theme namens "firstsite". In diesem werden all die Komponenten verwaltet, die für die Darstellung der Webseite notwendig sind. Das sind die benötigten Dateien, Templates, Stylesheets, Frontend-Module und das Seitenlayout.

Beim Erstellen des Themes werden neben dem Namen des Themes und des Autors auch die Ordner angegeben, in denen sich die Files und die Templates für die Darstellung der Website befinden.

[[Datei:firstsite-createtheme.png|Theme erstellen|frame|center]]

Speichert man nun das neu erstellte Theme so erscheint es auch in der Theme-Manager-Übersicht. Hier erlangt man den Zugriff auf die Theme-eigenen CSS, Module und Seitenlayouts sowie grundlegende Einstellungen des Themes selbst.

[[Datei:firstsite-theme.png|Theme Übersicht|frame|center]]

==Stylesheets==
Zuerst erstellt man die Stylesheets, die für dieses Theme gelten. Hierfür klickt man im Theme-Manager beim Theme "firstsite" rechts auf den Button für die Stylesheets und anschliessend auf "Neues Stylesheet". In Verbindung mit der Beispielwebsite werden 2 Stylesheets erstellt: eine basic.css und eine layout.css.

Weitere Informationen über [[CSS|Contao und CSS]]

[[Datei:firstsite-createcss.png|Stylesheet erstellen|frame|center]]

Der CSS-Manager sollte nun so aussehen:

[[Datei:firstsite-cssmanager.png|Stylesheet Manager|frame|center]]

==Seitenlayout==
Der nächste Schritt ist die Erstellung eines [[Seitenlayout|Seitenlayouts]]. Dazu wechselt man wieder zurück zum Theme-Manager und klickt im Theme "firstsite" auf den Button für den Seitenlayout-Manager, und anschließend wiederum auf "Neues Layout". Gemäß der Vorgabe (siehe [[#Einleitung|Einleitung]]) nimmt man folgende Einstellungen vor:

[[Datei:firstsite-createlayout-1.png|Layout erstellen #1|center]]
[[Datei:firstsite-createlayout-2.png|Layout erstellen #2|frame|center]]

Der Layout-Manager sollte nun so aussehen:

[[Datei:firstsite-layoutmanager.png|Layout Manager|frame|center]]

==Module Teil 1==
Eigentlich fehlen dem Theme jetzt nur mehr die Module. Die Beispielwebseite kommt mit einem Modul aus, dem Navigationsmodul. Dieses kann man aber zu diesem Zeitpunkt noch nicht erstellen, da noch keine Seitenstruktur angelegt ist (siehe [[#Module_Teil_2|Module Teil 2]]). Eine Ausnahme bildet das Module "Artikel". Dieses muss nicht angelegt werden, sondern ist per Standardeinstellung vorhanden. Man muss dem Modul Artikel nur sagen, wo es angezeigt werden soll. Das macht man im eben erstellten Seitenlayout unter dem Punkt "Frontend-Module". Bei dieser Beispielwebseite sollen die Artikel im Hauptbereich angezeigt werden.

[[Datei:firstsite-module-1.png|Layout Artikel zuweisen|frame|center]]

=Seitenstruktur=
Die [[Seitenstruktur]] findet man im Backend unter Layout --> Seitenstruktur. Die Seitenstruktur legt die Hierarchie der Artikel der Webseite fest. Da Contao multidomainfähig ist, legt man zuerst den Startpunkt für die Webseite fest. Um einen Startpunkt festzulegen, klickt man auf "Neue Seite", gibt einen Namen für die Seite ein und wählt als Seitentyp "Startpunkt einer Webseite". Die restlichen Einstellungen für den Startpunkt werden wie auf den folgenden Screenshots gesetzt:

[[Datei:firstsite-startpoint-1.png|Startpunkt einer Webseite #1|center]]
[[Datei:firstsite-startpoint-2.png|Startpunkt einer Webseite #2|frame|center]]
{{Hinweis|Ein Seitenlayout muss nicht zugeordnet werden, es wird dann automatisch das Standardlayout benutzt. So kann man während des Entwickelns schnell das gesammte Layout wechseln, indem man ein zweites Layout als Standardlayout definiert. Diese Einstellung wird auf die Unterseiten vererbt.}}

Im Anschluss erstellt man mehrere Webseiten vom Seitentyp "Reguläre Seite" ''innerhalb'' des Startpunktes der Webseite.

[[Datei:firstsite-regularpage.png|Reguläre Seite|frame|center]]
{{Hinweis|Der Seitenname wird im FE als Bezeichnung der Menüpunkte benutzt.

Der Seitenalias wird automatisch aus dem Seitennamen erzeugt, kann also leer gelassen werden und findet sich nachher im FE als Seitenname in der Adresszeile wieder z.B. "http:// example.org/index.html". Bei der Startseite wird empfohlen beim Seitenalias manuell 'index' einzutragen.

Der Seitentitel muss auch nicht ausgefüllt werden, es wird dann automatisch der Seitenname benutzt. Aus dem Seitentitel wird nachher im FE das TITLE-Attribut erzeugt und ist ganz oben in der Fensterleiste des Browsers sichtbar.}}

Die Beispielwebseite erhält 4 Hauptnavigationspunkte:
*Startseite
*Über Mich
*Meine Eltern
*Impressum / Kontakt
Der Hauptnavigationspunkt "Meine Eltern" erhält als Unternavigationspunkte die Seiten:
*Mein Vater
*Meine Mutter

Die Seitenstruktur sollte nun wie folgt aussehen:

[[Datei:firstsite-sitestructure.png|Seitenstruktur|frame|center]]

=Zwischenstand=
Bisher hat man ein Theme inkl. Seitenlayout und Stylesheets erstellt, gefolgt von der Seitenstruktur. War bis jetzt im Frontend nur die Meldung "Page not found" zu sehen, sieht man jetzt eine (vermeintlich) leere Seite. Schaut man sich jedoch den Quelltext an, sieht man, dass das Grundgerüst schon angezeigt wird. Um das auch optisch sichtbar zu machen, gibt man den Containern mittels CSS ein wenig Farbe. Dazu geht man zum Stylesheet layout.css (Theme --> Theme "firstsite" --> CSS --> layout.css --> bearbeiten) und fügt dort folgende Formatdefinitionen ein:

[[Datei:firstsite-layoutcolor.png|Dem Layout Farbe geben|frame|center]]

Das Frontend sollte nun so aussehen:

[[Datei:firstsite-frontendlayout.png|Frontend Layout|frame|center]]

Folgende Vorgaben der Website sind jetzt schon sichtbar:
*Die (feste) Breite der Seite
*Die Höhe des Headers
*Die Breite der linken Seite (die Breite des Hauptbereiches ergibt sich automatisch aus der Gesamtbreite minus der Breite der linken Seite)
*Die Höhe des Footers

=Module Teil 2=
Nun wird das Navigationsmodul erstellt. Dazu wechselt man in den Module-Manager (Themes --> Theme "firstsite" --> Frontend-Module und klickt auf neues Modul. Die [[ModulNavigation|Einstellungen]] sind wie folgt zu setzten:

[[Datei:firstsite-navi.png|Navigationsmodul|frame|center]]

Das war jedoch nur der erste Teil. Im zweiten Teil muss das erstellte Modul noch dem Seitenlayout zugewiesen werden. Man wechselt im Theme-Manager wieder zum Layout-Manager und bearbeitet das im Abschnitt [[#Seitenlayout|Seitenlayout]] erstellte "default"-Layout. Unter dem Abschnitt "Frontend-Module" fügt man das Navigationsmodul hinzu und weist es der Spalte "Linke Spalte" hinzu.

[[Datei:firstsite-module-2.png|Layout Navimodule einbinden|frame|center]]

Die Navigation ist jetzt im Frontend in der linken Spalte sichtbar.

=Artikel=
Zu guter Letzt erstellt man noch die Artikel für die angelegten Seiten. Sobald man in der Seitenstruktur eine neue Seite erstellt, wird automatisch für diese Seite ein (leerer) Artikel angelegt. Die Artikelverwaltung findet man im Backend unter Inhalte --> Artikel. Da für die Beispielwebseite 6 Seiten existieren, gibt es auch schon 6 Artikel; für jede Seite eine. Um einen Artikel mit Inhalt zu füllen, bearbeitet man den jeweiligen Artikel mit dem "Bleistift"-Button.

[[Datei:firstsite-articlemanager.png|Artikel Manager|frame|center]]

Anschließend erstellt man ein neues [[Inhaltselemente|Inhaltselement]] vom Typ ''Text'' und speichert dieses ab.

[[Datei:firstsite-article.png|Artikel|frame|center]]

Diese Schritte wiederholt man in den anderen 5 Artikeln.

=Die Webseite=
Die Beispielwebseite ist somit in ihren Grundzügen fertig gestellt. Das Frontend sollte nun so aussehen:

[[Datei:firstsite-frontend.png|Die fertige Webseite|frame|center]]

Alle Anforderungen an die Webseite sind erfüllt. Natürlich kann eine Webseite so nicht veröffentlicht werden, aber das ist auch nicht die Aufgabe dieser Anleitung. Es fehlen noch Bilder, der Header, der Footer, die Formatierungen usw usw. Der jetzige Stand der Webseite ist nur der erste Schritt, und diese sollten nun ein bisschen klarer sein.

MediaWiki:Sidebar

2011-02-07T14:49:57Z

Xtra: Suche testweise nach oben verschoben

ccdde:Aktuelle Ereignisse

2011-02-04T20:04:29Z

Xtra: Theme umstellung dokumentiert

Standard Wiki Theme ist nun das brandneue von [[Benutzer:Manitougs|Manitougs]] erstellte Contaowiki Theme.
Wir hoffen es gefällt.<br />
--[[Benutzer:Xtra|Xtra]] 21:04, 4. Feb. 2011 (CET)
----
Contao 2.9.3 veröffentlicht: [http://www.contao.org/neuigkeiten/items/contao_2-9-3.html Ankündigung auf der Projektseite]<br />
Da dieses Update eine Sicherheitslücke behebt, ist ein Update dringend empfohlen!<br />
--[[Benutzer:Manitougs|Manitougs]] 22:19, 17. Jan. 2011 (CET)
----
Hier im Wiki ist nun ein Syntax Highlighter ([[w:de:GeSHi|GeSHi]]) installiert. Bitte die Änderungen in der [[Hilfe:Hilfe|Hilfe]] beachten.<br />
--[[Benutzer:Xtra|Xtra]] 01:15, 27. Aug. 2010 (CEST)
----
Contao 2.9 veröffentlicht: [http://www.contao.org/neuigkeiten/items/contao_2-9-0.html Ankündigung auf der Projektseite]<br />
--[[Benutzer:Manitougs|Manitougs]] 13:02, 2. Jul. 2010 (CEST)
----
Typolight 2.8.4 veröffentlicht.<br />
--[[Benutzer:Manitougs|Manitougs]] 20:22, 1. Jul. 2010 (CEST)
----
Contao 2.9 RC1 verfügbar: [http://www.contao.org/neuigkeiten/items/contao_2-9-RC1.html Contao News - Contao 2.9 RC1]<br />
--[[Benutzer:Manitougs|Manitougs]] 09:53, 25. Jun. 2010 (UTC)
----
Aus TYPOlight wird Contao: [http://www.contao.org/neuigkeiten/items/typolight-wird-zu-contao.html Contao News - TYPOlight wird zu Contao]<br />
--[[Benutzer:Manitougs|Manitougs]] 09:53, 25. Jun. 2010 (UTC)
----
Aktuell schreiben wir die bestehenden TYPOlight Artikel auf Contao um.

Weiterhin wird die Optik dieses Wiki Stück für Stück an die CI des Contao Projekts angepasst.

Linke und Rechte Spalte füllen

2011-02-04T19:14:30Z

Xtra:

{{stub}}

[[Category:Admin HOWTOS]]

'''Am Beispiel Bildergalerien:'''

Einfache Variante für versch. Bilder auf jeder Seite oder nur für eine Seite:

Beim Seitenlayout muss der Spalte rechts und links auch das Modul 'Artikel' zugewiesen werden. Dann kannst du einfach Artikel anlegen und diese rechts oder links Positionieren und dort jeweils eine Bildergalerie anlegen.

Variante für die selben Bilder auf allen Seiten:

Da gibt es auch mehrere Wege... ich beschreibe hier mal einen etwas komplizierteren, der die Wartung aber vereinfacht:

# Eine Seite anlegen und diese im Menü verstecken
# in dieser Seite 2 Artikel anlegen. Einen für links und einen für rechts. In der Übersicht die passende ID rausfinden und aufschreiben
# 2 Module anlegen mit 'Eigenem HTML Code'
# in diese 2 Module jeweils einen Artikel mittels [http://www.contao.org/inserttags.htm Inserttag] einbinden -> <nowiki>{{insert_article::*}}</nowiki>
# Im Seitenlayout dann diese Module jeweils der passenden Seite zuordnen

(Das geht auch mit Elementen in einem Artikel -> <nowiki>{{insert_content::*}}</nowiki> Ich finde es aber so übersichtlicher)

----
--[[Benutzer:MacKP|MacKP]] 20:47, 12. Apr. 2010 (UTC)

Diskussion:Catalog

2010-11-02T23:25:03Z

Xtra: Erwiderung auf "FIND_IN_SET" von Toflar

Hinweis: FIND_IN_SET() ist ein MySQL spezifischer Befehl...das sollte man vielleicht hinschreiben, nicht? (Toflar)

Der Catalog Core benutzt bei den Tag und Select Feldtypen intern bereits FIND_IN_SET() und ist somit aktuell lediglich auf MySQL lauffaehig. Von daher ist es fraglich ob dieser Spezialfall getrennt behandelt werden muss oder ob man nicht vielmehr allgemein beim Catalog schreiben muss, dass er nur unter MySQL laeuft.
--[[Benutzer:Xtra|Xtra]] 00:25, 3. Nov. 2010 (CET)

Online-Shops

2010-10-08T02:59:39Z

Xtra: Link auf Katalog Artikel bei chShop eingebaut

{{stub}}
[[Category:Extensions]]
Auf dieser Seite soll ein Überblick über die bestehenden Shop-Lösungen für Contao entstehen.

== Vergleichstabelle ==

{| border="1" cellspacing="0" cellpadding="5"
! Kategorien !! Contao webShop<br />Community Edition !! Contao webShop<br />Business Edition !! Isotope<br />eCommerce !! chShop
|-
| beliebige Haupt- und Unterkategorien || Ja || Ja || Ja || via [[Catalog|Katalog-Extension]]
|-
| colspan="5" |

|-
! Artikelverwaltung !! Contao webShop<br />Community Edition !! Contao webShop<br />Business Edition !! Isotope<br />eCommerce !! chShop
|-
| Artikel || Ja || Ja || Ja || Ja
|-
| Produktgruppen || Ja || Ja || Ja || via [[Catalog|Katalog-Extension]]
|-
| Artikel mit Varianten || Nein || Ja || Ja || Ja
|-
| Artikel in mehreren Kategorien || Nein || Ja || Ja || via [[Catalog|Katalog-Extension]]
|-
| Downloadartikel || Nein || Ja || Ja || Bezahlte Inhalte
|-
| Artikelempfehlungen (zu Artikel x paßt Artikel y) || Ja || Ja || Nein || via [[Catalog|Katalog-Extension]]
|-
| Artikel als NEU markieren || Ja || Ja || ? || via [[Catalog|Katalog-Extension]]
|-
| Artikel als ANGEBOT markieren || Ja || Ja || ? || via [[Catalog|Katalog-Extension]]
|-
| Artikelnummern || Ja || Ja || Ja || Ja
|-
| Artikelnummern je Variante || Nein || Ja || Ja || automatisch generiert
|-
| colspan="5" |

|-
! Lizenzierung !! Contao webShop<br />Community Edition !! Contao webShop<br />Business Edition !! Isotope<br />eCommerce !! chShop
|-
| Demo-Shop Template & Layout inkl. || Nein || Ja || Ja || ohne Layout
|-
| Support per E-Mail || Nein || Ja || Nein || Nein
|-
| Support per Forum || Ja || Ja || Ja || Ja
|-
| Support per Ticketsystem || Ja || Ja || Ja || Nein
|-
| Lizenz || EULA || EULA || LGPL || LGPL
|-
| '''Preis netto''' || '''0,00 €''' || '''499,00 €''' || '''0,00€''' || '''0,00 €'''
|}

Catalog

2010-10-08T02:58:04Z

Xtra: Hinweis auf Kategorie Catalog eingebaut.

Das Catalog-Modul ermöglicht eine vielfältige Kategorisierung beliebiger Daten in hierarchischen und flachen Strukturen. Beispiele umfassen [http://www.tuerkischdeutsche-literatur.de Literaturverzeichnisse] oder [http://www.tunesien-immobilien.de Immobilienlisten].

Da dieses Modul sehr komplex ist, findet man einzelne Dokumantationen in der Kategorie [[:Category:Catalog|Catalog]].

{{AppliesTo
|TLVersion=ab 2.8
|Version=ab 2.9
|Ext1=Catalog ab 2.0beta1
}}
[[Category:Extensions]]
[[Category:Catalog]]

=Forum=
Fragen rund um den Catalog werden im Forum hier behandelt: [http://www.contao-community.de/forumdisplay.php?18-catalog Forum - Catalog Bereich]

=Installation=
Catalog kann ganz normal über die Erweiterungsverwaltung des Contao-Backend installiert werden. Eine manuelle Installation ist auch möglich, dazu muss man sich die benötigen Dateien des [http://www.contao.org/erweiterungsliste/view/catalog.html catalog aus dem Extension Repository herunterladen] (abhängige Erweiterungen nicht vergessen!).

Den jeweils neusten Build kann man sich aus dem [http://code.google.com/p/typolight-catalog/source/checkout SVN-Repository] herunterladen. Einzig das Modul backend_filterwiz muss dabei separat installiert werden, alle weiteren Module sind im Repository vorhanden. Man sollte darauf achten, welche Ordner wohin in der Installation kommen!

==Migration von Version 1 auf Version 2==
In Version 2 wurde Einiges geändert. So ist es u. a. nicht mehr nötig catalog und catalog_ext zu installieren, da diese Erweiterungen zusammengelegt wurden. Damit es zu keinem Datenverlust kommt, muss bei einem manuellen Update wie folgt vorgegangen werden:
* Zuerst die alten Modulordner entfernen,
* danach die neuen Modulordner hochladen.
* Erst zum Schluss das Datenbankupdate ausführen!

Beim Update über das Contao-ExtensionRepository sollte man die Reihenfolge beachten:
* Catalog 2 installieren und Datenbank-Update ausführen.
* Catalog_ext deinstallieren und erneut Datenbank-Update ausführen.
* Zur Sicherheit alle catalog-Module etc. noch mal öffnen und speichern, damit auch alles glatt läuft.
* Neue Einstellungen vornehmen.

=Allgemeines=
Testumgebung und Vortrag vom Usertreffen 2010:
* Vortrag / Testumgebung -> http://catalogdemo.dasprojekt.org/
* Benutzer: tlut2010
* Passwort: catalogisttoll

==Backend==
Mit dem Catalog bekommt man im Backend unter dem Menüpunkt 'Inhalte' 2 neue Menüeinträge:
* Katalog
* Mit '''Taxonomie''' können Stichworte hierarchisch angelegt und verwaltet werden. Diese sind Grundlage für Filter, Navigation und Verschlagwortung (sog. ''Tagging'') in den Katalogen.

[[Datei:cat-cat2-be.png|Cat Backend]]

==Frontend-Module==
Für eine Basisanwendung der Katalog-Erweiterung können folgende Module eingesetzt werden:
* Mit '''Catalog List''' kann eine Liste von Einträgen angezeigt werden.
* Eine Detailansicht eines Eintrags kann mit Hilfe des '''Catalog Reader''' angezeigt werden. Eine ''Catalog List'' verweist dabei auf den ''Catalog Reader''. Der ''Catalog Reader'' muss natürlich nur dann verwendet werden, wenn von einer Auflistung aus eine Detailseite eines Eintrags angezeigt werden soll.

Für eine weiterführende Benutzung der Katalog-Erweiterung stehen optional diese Module zur Verfügung:
* Catalog Filter (Mit Hilfe von einem Filter können Besucher die Liste eines Catalogs filtern und die Anzeige eingrenzen)
* Catalog Navigation (Mit dieser Navigation kann man eine Navigation erstellen. Die Navigation besteht zum Beispiel aus Kategorien)
* Catalog Notify (Hiermit wird ein Formular erstellt, welches zur schnellen Kontaktaufnahme bei einem einzelnen Item dargestellt wird)
* Catalog Featured (Hiermit kann man eine besondere Liste erstellen, die besondere Items darstellt. Die Liste wird per Zufall zusammengestellt.)
* Catalog Related (Hiermit erstellt man eine Liste von ähnlichen Items - Einzusezten auf einer Seite wo auch der Catalog Reader enthalten ist. Zufallsausgabe)
* Catalog Reference (Hiermit erstellt man eine Liste von Items mit einer gleichen Eigenschaft.)
* Catalog Edit (Um ein Item im Frontend editieren zu können, wird anstelle von Catalog Reader dieses Modul verwendet)

=Erstellen eines Katalogs (Backend)=
Um einen neuen catalog zu erstellen, klickt man links im Backend unter 'Inhalte' auf 'Katalog'. Anschliessend im Hauptbereich auf den Button 'Neuer Katalog'.

[[Datei:cat-cat2-newcat.png|Neuen Cat erstellen]]

* Name des Katalogs angeben
* Einen Tabellennamen angeben (Der catalog legt diese Tabelle selbstständig an. Es hat sich bewährt eine Tabelle anzulegen ohne tl_ als präfix, da Contao diese Tabellen sonst zum Entfernen vorschlägt. Ich empfehle den präfix cat_ damit man die Tabellen schnell wiederfindet.)
* Alias field (kann erst später ausgefüllt werden) -> anstelle der ID wird der Alias genutzt bei den Links
* publishField (kann erst später ausgefüllt werden) -> Hier kann ein Checkboxfeld ausgewählt werden, was die Funktion eines 'Auges' = on-/offline hat (z.B. Ein Feld mit dem Namen online)
* Jump to page -> Hier muss die Detail Seite mit dem Modul Catalog Reader angegeben werden. {{Achtung|Die richtige Zuweisung der Readerseite erfolgt in den Kataloglisten Modulen, diese Zuweisung hier ist jedoch nötig damit der Katalog die Items in die xml-Sitemap eintragen kann. Wird diese Zuweisung hier nicht vorgenommen, so "weiss" der Katalog nicht, auf welchem Reader die Items dargestellt werden sollen und trägt sie daher nicht in der sitemap.xml ein. Auch für die Contao Suche muss diese Angabe gemacht werden.}}
* Ein Bild hinzufügen -> Hier kann ein Bild für den Katalog hinzugefügt werden, um im Backend den Katalog schnell von anderen unterscheiden zu können
* Zeichenkette des Titels formatieren (wird erst später gebraucht) -> Um im Backend die Übersicht von vielen Items besser gewährleisten zu können, kann man hier die Anzeigen der einzelnen Items konfigurieren
* Allow comments -> Kommentare bei den einzelnen Items erlauben und konfigurieren (Funktion ist wie bei News o.ä. daher wird hier nicht genauer darauf eingegangen)
* Searchable -> Wenn man die Items auch in der Contao Suche indexieren lassen möchte. Nach Aktivierung ist es möglich, Conditions (Ausnahmen) einzugeben und das Title Feld anzugeben von einem Item (weiteres zu Conditions und Title finden Sie weiter unten) Wichtig: Weiterleitungsseite muss angegeben werden!
** Condition -> Um Felder direkt aus der Suche herauszunehmen (damit unveröffentlichte Items nicht in die Suche aufgenommen werden o.ä.)
** Page title field -> Den Namen des Items auswählen, damit dieser für die Ergebnisanzeige der Suche genutzt wird ('''und auch für den Title''')
* Enable CSV import -> Damit ist es möglich CSV-Dateien zu importieren. Natürlich sollte man das nicht einfach so machen und nur von Leuten die wissen was sie tun. Daher kann hier festgelegt werden, das nur Administratoren das machen dürften und ob Items überschrieben werden oder nicht
* Generate feed -> Hier kann festgelegt werden, dass ein RSS-Feed generiert wird aus den Items (Funktion ist wie bei News o.ä., daher wird hier nicht genauer darauf eingegangen)

==Nachträgliches Bearbeiten eines Katalogs==
Um die Grundeinstellungen eines Katalogs nachträglich noch einmal bearbeiten zu können, klickt man in der Katalogübersicht auf den Felder-Button...

[[Datei:cat-cat2-editfields.png|Cat Felder editieren]]

...und anschließend im Übersichtsfeld des Katalogs auf 'Bearbeiten'.

[[Datei:cat-cat2-editcat.png|Cat Catalog editieren]]

=Erstellen von Attributen/Feldern von Items in einem Katalog=
Nun ist die Grundkonfiguration von einem Katalog erst einmal abgeschlossen. Aber es ist noch nicht festgelegt aus welchen Feldern ein Item denn nun besteht, also welche Attribute ein Item besitzen kann.
Dazu kommen wir jetzt. Um neue Felder für den Katalog zu erstellen, klickt man in der Katalogübersicht auf 'Felder für Katalog erstellen'....

[[Datei:cat-cat2-editfields.png|Cat Felder editieren]]

...und danach auf 'Neues Feld'.

[[Datei:cat-cat2-newfield.png|Cat Neues Feld anlegen]]

==Die Standardwerte von Feldern==
Die speziellen Felder werden erst sichtbar, wenn man einen Feldtyp ausgewählt hat. Diese Werte werden weiter unten erläutert.
* Field configuration
** Bezeichnung (Eine eindeutige Bezeichnung für das Feld. Diese sollte möglichst selbsterklärend sein.)
** Beschreibung (Um im Backend und beim Frontend-Editing eine Beschreibung anzuzeigen für die Ersteller eines Items)
** Spaltenname (der Spaltenname in der Tabelle. Dieser muss eindeutig sein und so vergeben werden, das er logisch ist, da man beim Template erstellen diese Namen benutzt um an die Inhalte zu kommen)
** '''Typ''' (weiter unten)
* Display Settings (Diese Einstellungen sind für die Ansicht im Backend zuständig)
** Kontroll-Checkbox (Wenn eine Kontroll-Checkbox angegeben wird, wird dieses Feld erst angezeigt, wenn das Kontroll-Checkbox Feld angekreuzt ist)
** Vorher Umbruch einfügen (Um dieses Eingabefeld in einer neuen Zeile zu beginnen)
*** Legend Titel (hier kann dann ein Name für den Legend Titel angegeben werden -> die Grün geschriebenen Titel im Backend)
** Enable half width (um 2 Felder nebeneinander anzuzeigen - seit TYPOlight 2.7 möglich)
* Backend filter settings (hier kann festgelegt werden, ob das Feld im Backend zur Filterung angezeigt wird)
** Sortieren ('''Muss zum Filtern etc. angegeben werden.''' Sonst weiß Contao nicht wie der Filter erstellt werden soll. Für '''Datum''' ist zwangsweise die Angabe nötig ob nach Jahr, Monat oder Tag sortiert werden soll!)
** Filter
** Suche
* Advanced settings
** Pflichtfeld -> Dieses Feld muss ausgefüllt werden
* Frontend editing
** Frontend editing groups -> Welche Gruppen dürfen dieses Feld im Frontend bearbeiten (Mehrfachangabe ist möglich). Wenn hier nichts angegeben wird, dürfen alle Gruppen dieses Feld im Frontend editieren

==Typ - Feldtypen von Feldern==
Hier werden die Angaben für die jeweiligen Typen aufgelistet und erläutert.
===Text===
* Format settings
** Prefix und Suffix Strings
** Format
*** Formattyp
**** Zeichenkette
**** Nummer
**** Datum
*** Zeichenfolge für Formatierung

===Alias===
'''Es ist immer nur ein Alias Feld erlaubt in einem Katalog.'''
Die Funktion ist die selbe wie bei einem Alias für eine Seite.
* Alias-Titel-Feld (Aus diesem Feld wird automatisch ein Alias generiert, wenn keine Angabe beim Alias gemacht wurde. Dieses Feld muss '''nicht''' Eindeutig sein. Der Alias wird aber eindeutig generiert und ist damit genau so benutzbar wie eine eindeutige ID)

===Langtext===
* Advanced settings
** Allow html (wenn erlaubt werden in dem Feld HTML-Tags erlaubt - Liste der erlaubten HTML-Tags ist in den Eigenschaften von Contao editierbar)
** Rich Text (wenn angekreuzt wird der TinyMCE angezeigt)

===Nummer===
* Advanced settings
** Minimum (legt den Minimalwert fest, den ein Benutzer eingeben kann)
** Maximum (legt den Maximalwert fest, den ein Benutzer eingeben kann)
* Format settings
** Prefix und Suffix Strings
** Format
*** Formattyp
**** Zeichenkette
**** Nummer
**** Datum
*** Zeichenfolge für Formatierung

===Dezimal===
* Advanced settings
** Minimum (legt den Minimalwert fest, den ein Benutzer eingeben kann)
** Maximum (legt den Maximalwert fest, den ein Benutzer eingeben kann)
* Format settings
** Prefix und Suffix Strings
** Format
*** Formattyp
**** Zeichenkette
**** Nummer
**** Datum
*** Zeichenfolge für Formatierung

===Datum===
* Advanced settings
** Zeiteingabe (Falls ausgewählt, darf der Benutzer Datum '''und''' Zeit eingeben
** Format
*** Formattyp
**** Zeichenkette
**** Nummer
**** Datum
*** Zeichenfolge für Formatierung

===Checkbox===
Zum Erstellen einer einfachen Checkbox. Hier kann nicht viel eingestellt werden, da ja nur 1 oder 0 als Zustand gilt.

===Auswahl===
Hiermit kann man ein Auswahl-Feld (Select) erstellen, das als Grundlage eine andere Tabelle nutzt. Das kann Taxonomie sein oder auch ein anderer Katalog.

* Advanced settings
** Include blank option (Um bei der Drop-Down Liste auch die Möglichkeit zu haben, eine leere Auswahl anzubieten)
* Options settings
** Tabelle für Optionen (Hier muss die Tabelle ausgewählt werden, in der die Optionen stehen - Taxonomie wäre -> tl_taxonomie)
** Spalte für Tabellenwerte (Eine Spalte für die Speicherung einer Option auswählen. Hier sind nur die Spalten vorgegeben, die sich auch in der Tabelle befinden)
** Anzeige der Sortierspalte (Um die Sortierung der Optionen vorzunehmen kann hier eine andere Spalte ausgewählt werden.)
** Filter items (Hier kann man wieder eigene Filter definieren, um die Auswahl einzugrenzen)
** Auswahl der Einträge
*** Optionen (Hier kann man noch mal genau auswählen, welche Optionen man anbieten möchte)
*** Modus für Unterauswahl
**** Show selected items collapsed (Nur die ausgewählten Items anzeigen)
**** Show children of selected items collapsed (Nur die Kinder der selektierten Items anzeigen)
**** Tree with all items selectable (Baumansicht mit allen Items als Option auswählbar)
**** Tree with only children selectable (Baumansicht nur mit den Kind-Items auswählbar)
*** Parent Filter (Hier kann man das Eltern Element angeben, welches die Optionen enthält. Praktisch wenn man 2 Bäume bei der Taxonomie hat und nur einen zur Auswahl geben will)

===Tags===
Auch Tags sind ähnlich der Auswahl dazu da, eine andere Tabelle als Wert anzugeben.

Der Unterschied besteht darin, das Tags eine Checkboxliste ergeben, mit der auch eine Mehrfachauswahl möglich ist.

* Advanced settings
** Include blank option (Um bei der Drop-Down Liste auch die Möglichkeit zu haben, eine leere Auswahl anzubieten)
* Options settings
** Tabelle für Optionen (Hier muss die Tabelle ausgewählt werden, in der die Optionen stehen - Taxonomie wäre -> tl_taxonomie)
** Spalte für Tabellenwerte (Eine Spalte für die Speicherung einer Option auswählen. Hier sind nur die Spalten vorgegeben, die sich auch in der Tabelle befinden)
** Anzeige der Sortierspalte (Um die Sortierung der Optionen vorzunehmen kann hier eine andere Spalte ausgewählt werden.)
** Filter items (Hier kann man wieder eigene Filter definieren, um die Auswahl einzugrenzen)
** Auswahl der Einträge
*** Optionen (Hier kann man noch mal genau auswählen, welche Optionen man anbieten möchte)
*** Modus für Unterauswahl
**** Show selected items collapsed (Nur die ausgewählten Items anzeigen)
**** Show children of selected items collapsed (Nur die Kinder der selectierten Items anzeigen)
**** Tree with all items selectable (Baumansicht mit allen Items als Option auswählbar)
**** Tree with only children selectable (Baumansicht nur mit den Kind-Items auswählbar)
*** Parent Filter (Hier kann man das Eltern Element angeben, welches die Optionen enthält. Praktisch wenn man 2 Bäume bei der Taxonomie hat und nur einen zur Auswahl geben will)

===URL===
Der Feldtyp URL hat keine besonderen Parameter. Er dient lediglich der Ein- und Ausgabe einer URL.

===Datei===
Dieser Feldtyp ist für die Ein- und Ausgabe von Dateien vorhanden. Man kann damit Downloads oder Galerien erstellen. Falls die ausgewählte Datei nicht unter den Contao-Einstellungen eingetragen ist, so bleibt das Feld "value" (mehr dazu siehe "Welche Variablen hat man in einem Template zur Verfügung?") leer. Aus diesem Grund sollte man im Vorhinein die entsprechenden Dateitypen freischalten.
* Advanced Settings
** Mehrere Dateien (Wenn ausgewählt können mehrere Dateien ausgewählt werden)
** Ändern des Dateibaumes
*** Setzen des Ordners für das Wurzelverzeichnis (Hier kann ein spezieller Dateibaum gewählt werden, um unnötige Wege zu verkürzen)
*** Gültige Dateitypen (In einer Komma-separierten Liste kann man hier die Dateitypen auf eine gültige Liste einschränken)
*** Nur Dateien erlauben (Ordner sind dann nicht anwählbar)
*Format settings
** Bild anzeigen (Um ein Bild / eine Bildergalerie anzeigen zu lassen)
*** Bildbreite und -höhe sind auswählbar
** Link erzeugen
*** Um einen Link zum Herunterladen der Datei zu erzeugen oder bei einem Bild eine Vollansicht (Lightbox) anzubieten

===Calculate===
Um Berechnungen auf SQL Ebene vorzunehmen
* Calculation formula (Eingabe von einer SQL calculation für das Feld, wie '(price*1.15)*qty'
* Format settings
** Prefix und Suffix Strings
** Format
*** Formattyp
**** Zeichenkette
**** Nummer
**** Datum
*** Zeichenfolge für Formatierung

===Bewertungen===
Die Besucher der Internetseite können bei Angabe eines solchen Feldtypes eine Bewertung vornehmen
* ajaxratingfield (Angabe von maximalen Punkten die ein Besucher vergeben kann)

===Zugriffszähler===
Ohne Optionen. Hiermint wird einfach gezählt und ausgegeben wie oft auf dieses Item zugegriffen wurde. Es ist auf ein Klick per IP pro Tag festgelegt.

===Frontend Benutzer===
Ohne Optionen.
Um die Items nur dem jeweiligen Frontendbenutzer der sie angelegt hat zuzuweisen muss ein Feldtyp dieser Art angelegt sein.

===Meta Keywords===
Ohne Optionen.
Um eine Liste von Keywords für diese Item eingeben zu können.

===Mehrspaltiger Text===

Nur verfügbar wenn zusätzlich installiert: [http://www.contao.org/erweiterungsliste/view/catalogmultitextwizardfield.html direkt zum ER]

Hiermit kann ein Feld ähnlich des Tabellenelements in Contao angelegt werden.
Man definiert einmal die Spaltenanzahl und Überschriften.
Beim Anlegen des Items hat man dann die Möglichkeit beliebig viele Zeilen anzugeben.
* Spaltenüberschriften (Angabe der Anzahl, der Reihenfolge und der Titel der Spaltenüberschriften)

Für das Frontend Editing (wenn man dieses Feld dort editieren möchte) braucht man die Erweiterung [http://www.contao.org/erweiterungsliste/view/x_FrontendMultiTextWizard.de.html xFrontend MultiTextWizard]. Ansonsten ist dieses Feld nicht editierbar.

===Produktvariante (Besonderheit vom chshop -> wird dort erläutert)===

=== Merkliste und Varianten ===
Mit diesem Feldtyp ist es möglich Items für eine Merkliste vorzubereiten.
* Notelistvariants sind die Varianten, die ein Item besitzen können. Die Liste der Varianten besteht aus Select- und Tagfields des Katalogs. Dadurch ist es möglich Varianten von der Taxonomie oder von anderen Katalogen zu erstellen, indem man in diesem Katalog Auswahlen dafür anlegt.

==Sobald man Felder definiert hat==
ist in der Übersicht bei den Feldern zu sehen ob ein Feld:
* zur Suche markiert ist
* Sortierbar ist
* Gruppiert wurde (um die Reihenfolge festzulegen)
* ein Pflichtfeld ist
* ob es eine Kontrol Checkbox ist (nur wenn angewählt wird es sichtbar)
* Ob es ein Dateityp ist
* Ob es sich um ein Bild handelt
* in der halben Breite im Backend angezeigt wird
* Ob darüber ein Filter angewendet wird

[[Datei:cat-cat2-fieldpreview.png|Felderübersicht]]

=Frontend Module und ihre Attribute=

Bei den verschiedenen Modulen muss zunächst eine Auswahl getroffen werden, für welchen Katalog das Modul gemacht wird. Dabei kann immer nur ein Katalog gewählt werden.

'''Allgemeine Einstellungen (die alle Module haben):'''
* Titel
* Überschrift
* Modultyp (mit den unten stehenden Modultypen)
* Zugriffsschutz (Nur bestimmten Gruppen das Modul anzeigen)
* Experten Einstellungen
** Nur Gästen anzeigen
** CSS-ID/Klasse
** Abstand davor und dahinter

[[Datei:cat-cat2-view-list.jpg|Cat Modul Liste]]

[[Datei:cat-cat2-view-reader.jpg|Cat Modul Reader]]

==Catalog List==
Zur Ausgabe einer Liste von Items wird das Modul [[ModuleCatalogList]] verwendet.

==Catalog Reader==
Um die Details von einem einzelnen Item anzuzeigen
* Als Wichtigstes muss eine Weiterleitungsseite eingestellt werden. Auf dieser Seite muss der Catalog Reader vorhanden sein.
* catalog layout (Auswahl des Templates für den Reader)
** catalog_full (Standardtemplate um Alles auszugeben)
** catalog_full_rev (Template um alle Felder auszugeben - Entwickler Version)
* Visible Fields - Sichbare Felder. Diese Felder sind dann im Template verfügbar. Man kann auch die Reihenfolge der Ausgabe bestimmen.

==Catalog Filter==
Mit Hilfe von einem Filter können Besucher die Liste eines Catalogs filtern und die Anzeige eingrenzen. Die Filter können hier genau eingestellt werden. Sogar ein eigenes Suchfeld nur für den einen Katalog kann hier erstellt werden.
* Catalog -> für welchen Katalog soll dieser Filter benutzt werden (es kann nur ein Katalog angegeben werden)
* Weiterleitungsseite (auf welche Seite soll bei Klick weitergeleitet werden. Üblicherweise ist das eine Seite mit dem Modul 'cataloglist', da hier dann nur noch die Items angezeigt werden, die zu der gefilterten Ausgabe passen)
* Filter layout (default -> filter_default | zum Entwickeln ist das filter_widget Template gedacht)
* Enables Filter By section (Einen Filter erstellen)
** Filter Headline (Überschrift für diese(n) Filter)
** Filter Fields (Hier kann man das Feld und die Art des Filters auswählen)
*** Die Reihenfolge bestimmt man mit den grünen Pfeilen neben der Feldbezeichnung
*** Tree View (Ankreuzen wenn es eine baumartige Struktur sein soll, bzw. bei diesem Feld eine baumartige Struktur eingegeben wurde. Die Kindelemente reagieren dabei auf die Auswahl der Elternelemente)
*** None (default Wert -> es wird von diesem Feld kein Filter erstellt)
*** Links List (eine einfache Link Liste wird von dem Feld erstellt)
*** Radio Button (Eine Auswahl mittels Radio Button wird erstellt, so ist die Auswahl nur von einem Wert möglich)
*** Select drop-down (Eine Auswahl mittels einer Select-Box wird erstellt. Nur ein Wert kann ausgewählt werden.)
** Reveal tree view sequentially (Die Filter werden erst nach und nach eingeblendet. Die Reihenfolge bestimmt dabei die Einblendung. So wird der 2. Filter erst eingeblendet, wenn im ersten etwas ausgewählt wurde. Eine Möglichkeit wäre hier die Auswahl von Städten, die erst erscheint, wenn ein Bundesland ausgewählt wurde)
** Tags multiple select allowed (Wenn dieses Feld ausgewählt wurde, wird aus dem Radio Button eine Checkbox und aus der Select drop-down Liste eine Liste mit der Möglichkeit meherere auszuwählen.)
* Enables Range section (Hier können Felder ausgewählt werden, wo ein Minimum und Maximum eingegeben werden kann um darüber zu Filtern)
** Range Headline (Überschrift angeben)
** Range Fields (Auswahl der Felder für die ein Bereichsauswahl erstellt werden soll. Die Liste ist auch wieder sortierbar)
* Enables Date section (Hier können Felder ausgewählt werden, welche nach Datum zusammengefasst werden können)
** Dates Headline (Überschrift angeben)
** Date Filds (Hier sind nur Datumsfelder zur Auswahl angeboten. Man kann bestimmen, welches benutzt werden soll)
** Date Ranges (Hier kann angegeben werden, welche Auswahl der Besucher hat, um die Daten zu filtern):
*** Last year
*** Last 6 months
*** Last month
*** Last week
*** Yesterday
*** Today
*** Tomorrow
*** Next week
*** Next month
*** Next 6 months
*** Next year
* Enables Sort section (Hier wird eingestellt, welche Felder vom Besucher überhaupt sortierbar sind und wie das geschehen soll)
** Sort Headline (Überschrift angeben)
** Sort Fields (Hier muss angegeben werden, welche Felder sortierbar sein sollen. Die Reihenfolge kann wieder über die grünen Pfeile bestimmt werden)
** Sort form control type Hier wird festgelegt, wie die Besucher bestimmen können wie sortiert wird:
*** select (Über eine Select Auswahl)
*** list (Mit hilfe einer Linkliste)
*** radio (Über einen Radio Button)
* Enables Search Box (Eine Suchbox einschalten. Nur Text, langtext Felder werden unterstützt)
** Search Headline (Überschrift eingeben)
** Search Fields (Hier können die Felder ausgewählt werden, in denen gesucht werden soll)
* Use filter condition from lister on same page (Wenn auf derselben Seite auch eine List-Modul von dem Katalog eingesetzt wird und diese Liste mit conditions eingeschränkt ist, werden bei Auswahl dieses Feldes die Filter mit Berücksichtigung der conditions erstellt.)

==Catalog Navigation==
Mit diesem Modul kann man eine Navigation durch einen Katalogs erstellen. Die Navigation besteht zum Beispiel aus Kategorien.
* Catalog -> für welchen Katalog soll diese Navigation genommen werden (es kann nur ein Katalog ausgewählt werden)
* Weiterleitungsseite (auf welche Seite soll bei Klick weitergeleitet werden. Üblicherweise ist das eine Seite mit dem Modul [[ModuleCatalogList|Katalog liste]], da hier dann nur noch die Items angezeigt werden, die zu der Kategorie passen)
* Navigations field -> Hier muss das Feld angegeben werden, aus dem die Navigation zusammengesetzt wird. Also ein Select- oder Tagfield aus dem gewählten Katalog.
* Alle anderen Einstellungen der Navigation funktionieren genau so wie beim normalen [[ModulNavigation|Navigationsmodul]]

==Catalog Notify==
Hiermit wird ein Formular erstellt, welches zur schnellen Kontaktaufnahme bei einem einzelnen Item dargestellt wird. Z.B.: Möchten Sie nähere Informationen zu diesem Produkt? Dann schicken Sie uns bitte Ihre Kontaktdaten, damit wir uns bei Ihnen melden können.
* Catalog (Hier muss wieder der Katalog angegeben werden, in dem das Item dargestellt werden soll)
* Form Fields (Hier können Sie Felder angeben, die der Benutzer ausfüllen soll, damit Sie Kontakt zu ihm aufnehmen können)
* Sicherheitsfrage deaktivieren (nicht empfohlen! Nur sinnvoll, wenn die Benutzer schon in einem Bereich sind, in dem man sich anmelden muss)
* Subject (Betreff der Email, hier können spezielle Inserttags benutzt werden in der Art -> <nowiki>{{catalog::Spaltenbezeichnung}}</nowiki>. Z.B. <nowiki>{{catalog::title}}</nowiki>
* Recipients List (Liste von Emailadressen, die eine Email mit dem Inhalt erhalten sollen)
* Body text (Text der Email. Auch hier sind die speziellen Inserttags <nowiki>{{catalog::Spaltenbezeichnung}}</nowiki> möglich. Zusätzlich sind noch die Variablen ##catalog## und ##link## verfügbar. Wobei catalog durch den Katalog und link durch den direkten Link zu dem Item ersetzt werden.
* Catalog Template (Hier kann das passende Template angegeben werden um das Formular darzustellen. Default ist mod_catalognotify)

==Catalog Featured==
Hiermit kann man eine Liste erstellen, die besondere Items darstellt. Die Liste wird per Zufall zusammengestellt.
* Grundeinstellungen sind wie bei der Catalog-List
* Besonderheiten:
** Number of items (Hier kann die Anzahl der Items dargestellt werden. 0 zeigt alle)
** Custom ordering (Die Reihenfolge kann hier festgelegt werden)
* Um spezielle Einträge anzulegen braucht nur ein extra Feld (checkbox) erstellt werden (z.B. hervorgehoben) und in der Condition können dann Items festgelegt werden, deren Wert 1 ist -> spalte_hervorgehoben=1

==Catalog Related==
Hiermit erstellt man eine Liste von ähnlichen Items - einzusetzen auf einer Seite, auf der auch der Catalog Reader enthalten ist. Zufallsausgabe.
* Grundeinstellungen sind wie bei der Catalog-List
* Besonderheiten:
** Related fields to match (Angabe der Felder, die bei den darzustellenden Items gleich sein sollen)
** Amount of tags that must be in common (Einstellen der Anzahl der Übereinstimmungen -> Minimumangabe. d.h. wenn 3 Felder angegeben wurden, die übereinstimmen sollen, kann bei einer Angabe von 1 auch ein Item angezeigt werden, welches nur eine Übereinstimmung hat und nicht alle 3)
** Number of items (Hier kann die Anzahl der Items dargestellt werden. 0 zeigt alle)
** Custom ordering (Die Reihenfolge kann hier festgelegt werden)

==Catalog Reference==
Hiermit erstellt man eine Liste von Items mit einer gleichen Eigenschaft. Diese muss zusammen mit dem Catalog Reader eingesetzt werden und ist für die Anzeige von Items aus einem '''anderen''' Katalog.
* Grundeinstellungen sind wie bei der Catalog-List
* Besonderheiten:
** Select the match field (Das Feld auswählen, welches die Verbindung zum anderen Katalog herstellt)
** Select reference catalog (Den zweiten Katalog auswählen, wo die anzuzeigenden Items enthalten sind)
** Select the reference field (Das Feld angeben, welches im 2. Katalog für die Identifizierung genutzt wird. Es soll dasselbe Feld angegeben werden, welchen auch schon für die Verknüpfung genommen wurde)
** Number of items (Hier kann die Anzahl der Items dargestellt werden. 0 zeigt alle)
** Custom ordering (Die Reihenfolge kann hier festgelegt werden)

==Catalog Edit==
Um ein Item im Frontend editieren und erstellen zu können. Dieses Modul wird anstelle von Catalog Reader verwendet.
*Catalog (den Katalog auswählen, dessen Items im Frontend editierbar sein soll)
* Editable Fields (Angabe der Felder, die editierbar sein sollen. Mit den Pfeilen kann man diese in der Reihenfolge anordnen)
* Weiterleitungsseite (Seite die angezeigt werden soll, wenn das Formular abgesendet wurde. Meistens wird wieder zurück zu der Liste weitergeleitet)
* Sicherheitsabfrage deaktivieren (Nicht empfohlen! Es sei denn, nur angemeldete Benutzer haben Zugriff auf diese Seite)
* Restricted fields (Mit dieser Einstellung können Vorbelegungen, die _nicht_ geändert werden können, vorgenommen werden. Diese Felder sollten nicht als Editable Fields konfiguriert sein)
** Wählen Sie hier die Felder aus, welche vorbelegt sein sollen
** Restricted fields default values (Sind erst '''nach dem Speichern einstellbare Vorgaben''' für die Felder, die vorher ausgewählt wurden -> Jeder Feldtyp ist individuell einstellbar.)
** Beispiel für ein Restricted field: Ein Feld mit einer Checkbox, ob das Item online sein soll. 'online' bekommt als default Wert 'Nein'. Nun ist jedes Item, was über diesen Catalog Editor erstellt oder bearbeitet wird offline! So kann man im Frontend mit einer extra Gruppe, die dieses Feld bearbeiten kann und eben keine default Vorgabe hat die Items freischalten. Die 'normalen' Benutzer haben dieses Recht dann nicht.

=Weitere Einstellungsmöglichkeiten=

== Merkliste - Formulargenerator ==
Die Merkliste wird nicht als extra Modul erstellt, sondern in einem Formular mit dem Formulargenerator von Contao.

Dazu gibt es ein neuen Feldtyp 'Merkliste' der zum Beispiel am Anfang positioniert werden kann.
Der Besucher kann später das Formular ausfüllen und so die Liste an den Emailempfänger versenden, um sich so zum Beispiel ein Angebot für die Items einzuholen.

Einstellungen:
* Feldname (der Feldname für diesen Feldtyp)
* Feldbezeichnung (diese wird normalerweise für Felder als Label angezeigt und sollte daher hier '''leer''' gelassen werden)
* Text (Hier kann ein Text angegeben werden, der über der Liste der Items angezeigt wird)
* Katalog (Den Katalog angeben, der die Items enthält)
* Sichtbare Felder (Die anzuzeigenden Felder von den Items, die Liste ist auch hier wieder über die Pfeile sortierbar)

=== Templates für die Merkliste ===
* form_catalognotelist.tpl (Template für die Liste im Formular)
* form_catalognotelist_mail.tpl (Template für die Email, welche die Items vom Merkzettel enthält. Hier kann genau festgelegt werden, welche Felder in der Email von einem Item angezeigt werden.)

=Tipps und Tricks zur Umsetzung=

==Welche Variablen hat man in einem Template zur Verfügung?==
<source lang="php">
<?php print_r($this->entries); ?>
</source>
Damit bekommt man das komplette Array ausgegeben.

==Zeichenkette des Titels formatieren==
Warum wird bei mir nichts angezeigt, obwohl ich da etwas angegeben habe?
* Wichtig: man muss bei den Feldern die man später hier benutzen möchte folgendes Ankreuzen -> Anzeige-Einstellungen > Sichtbar in der Backend-Listen-Ansicht

==Wie kann man in der Detail Ansicht den meta-title so beeinflussen, das dieser den Namen von dem Item nimmt?==
* Einfach das Feld für den Namen mit title benennen (das ist die Fallback Methode, wenn die andere -> Page title field nicht benutzt wird). Der catalog wird dann automatisch dieses Feld benutzen um den meta-title zu generieren.
* Page title field beim Katalog sezten. Zu finden unter 'Search' in den Einstellungen vom Katalog.

==Titel so beeinflussen, das die aktuelle Kategorie einer Liste dort steht==
Im Catalog Template folgendes nutzen:
<source lang="php">
<?php if(strlen($this->Input->get('kategorie')))
{
global $objPage;
$objPage->pageTitle = "".$entry['data']['kategorie']['value']." - XYZ";
}
?>
</source>
In dem Beispiel wird jetzt (nur wenn eine Kategorie gewählt ist) der Wert von '''$entry['data']['kategorie']['value']''' eingesetzt.

==Wie bekommt man ein Auge bei den Items? / on- offline Schalten von Items==
Zuerst muss man sich in Feld vom Typ 'Checkbox' anlegen. Zum Beispiel mit dem Namen 'online'.
Jetzt kann man den Katalog konfigurieren und bei '''Feld veröffentlichen''' (publish Field) das Checkbox-Feld auswählen.
Ab jetzt ist im Backend bei den Items eines Katalogs ein graues oder grünes Auge (je nach Zustand) sichtbar.

==Detail Seiten in die sitemap.xml und ins Modul Sitemap bringen==
* sitemap.xml -> Den Katalog einfach für die Indexierung der Suche freigeben -> [http://tip.dasprojekt.org/Catalog_2#Erstellen_von_einem_Katalog_.28Backend.29 Searchable] (Achtung: eine Weiterleitungsseite muss auf jeden Fall angegeben sein beim Katalog selber. Diese Seite wird dann in der Sitemap benutzt um die Items darzustellen.)
* Modul Sitemap -> Hier werden die Detailseiten nicht integriert, da es bei einem normalen Katalog schon zu viele Einträge wären, um diese dort sinnvoll darzustellen.

==Alias bei Links benutzen (anstelle der ID)==
Dazu brauchst man nur ein Pflichtfeld (Namen von dem Item) und erstellt dann noch ein Feld vom Typ Alias. Das Alias-Titel-Feld ist dann der Name des Items.
Bei dem Katalog selber muss noch ausgewählt werden, welches das Alias Feld ist.
Das Alias Feld ist genau so wie das Alias Feld von Seiten etc., man kann selbst etwas eintragen oder den Inhalt automatisch generieren lassen, wenn man das leer lässt.
Nachdem die Suche und die Seiten neu generiert wurden (Systemwartung) sollte der Alias bei der Suche und auch bei der Detailansicht (URL) genutzt werden.
'''Im Moment muss in der Liste das Alias Feld als 'Sichtbar' ausgewählt werden. Sonst funktioniert die Verlinkung nicht! (Sollte in der Endversion behoben sein)'''

==Folder-URL und der catalog wollen nicht so recht==

Unter Einstellungen kann unter Sicherheitseinstellungen eine Liste von Variablennamen angeben werden, welche von der Erweiterung Folder-URL als Parameter erkannt werden sollen. Hier muss "orderby,sort" angegeben werden. Dadurch 'ignoriert' Folderurl diese Parameter und der catalog ist wie immer nutzbar.

Es sollten alle Schlüsselwörter der Filtermöglichkeiten hinzugefügt werden. Wenn man die Einträge des Kataloges nach z.B. "Ort" sortieren will, gibt es einen Fehler, wenn das Feld der Datenbanktabelle nicht bei den "URL Schlüsselworte" in den Einstellungen auftaucht.

==Eine Liste im Frontend so sortieren wie im Backend==
Um eine Liste genau so zu sortieren wie im Backend braucht man einfach nur bei der Sortierung nach dem Feld 'sorting' zu sortieren (z.B. sorting ASC)

==Items im Backend verschieben==
Damit man Items im Backend verschieben kann darf man '''nicht''' die Sortierungs Option bei einem Feld eingeschaltet haben (Backend Filter Einstellungen > Sortiereung-Dropdown aktivieren)

==Bedingung bei Strings==

Um eine Bedingung anzugeben, die innerhalb eines Strings vorhanden ist, reicht es ja nicht einfach nur einen Vergleich per SQL vorzunehmen.
Beispiel: Über den Feldtyp Tag sind Taxonomieen einem Produkt zugeordnet. Da das mehrere sein können muss man die Bedingung in der Liste wie folgt abfragen ->
<source lang="php">
FIND_IN_SET(7, kategorie)
</source>
D.h.: es soll innerhalb von kategorie nach der ID 7 gesucht werden.

==Formatierung von Zahlen in den Backend Einstellungen==

Um Zahleneingaben zu formatieren, wird mit php gearbeitet.

Hier finden sich Anleitungen dazu -> [http://php.net/manual/en/function.money-format.php]

Beispiel:
* Zahleneingabe -> 1023934
* Formatierung -> 2, ',', ' '
* Ausgabe -> 10.239,34

==Filtern nach Datum==

Aufgabenstellung:
Das Datumsfeld ist in dem Format 'dd.mm.yyyy' vorhanden.
Es soll nun für das aktuelle Jahr eine Ausgabe erfolgen und für die vergangenen Jahre ein Archiv erstellt werden.

Das Problem:
Die Datum Angaben werden als timestamp gespeichert und sind in einem char Feld.

Lösungsansatz:
<source lang="php">
meinedatumsvariable BETWEEN UNIX_TIMESTAMP('{{date::Y}}-01-01') AND UNIX_TIMESTAMP('{{date::Y}}-12-31')
</source>
So kommt man an die Daten des aktuellen Jahres, um die Daten von 2009 auszugeben:
<source lang="php">
meinedatumsvariable BETWEEN UNIX_TIMESTAMP('2009-01-01') AND UNIX_TIMESTAMP('2009-12-31')
</source>

===Probleme die bei Unix Timestamp auftreten können===
Es kann passieren, das der Unix Timestamp beim Verarbeiten von PHP falsch interpretiert wird (nicht als Zahl).
Daher kann es nötig sein, diesen erst durch einen kleinen Trick auf jeden Fall in einen Zahlenwert umzuwandeln:
<source lang="php">
ROUND(datum)
</source>
Damit wird auf einen Zahlenwert gerundet (da es sich schon um Integer Werte handelt geht dabei nichts verloren).

Beispiel (von do_while) aus dem Forum:
<source lang="php">
ROUND(datum) BETWEEN UNIX_TIMESTAMP('{{date::Y}}-01-01') AND UNIX_TIMESTAMP('{{date::Y}}-12-31')
</source>
Hier wird nach dem Datum sortiert.

==Mit DCA Felder besser einschränken==
Inzwischen ist es möglich Felder über DCA zu steuern. Der Vorteil: dadurch kann man wesendlich besser Fehleingaben abfangen.
Hier unter 'Felder' kann mna die Möglichkeiten der Konfiguration sehen -> [http://www.contao.org/referenz.html http://www.contao.org/referenz.html]

Um ein Feld zum Beispiel nur für den Lesenden Zugriff freizugeben kann man diese Syntax nutzen:
<source lang="php">
$GLOBALS['TL_DCA']['tabellenname']['fields']['spaltenname']['eval']['readonly'] = true;
</source>

Oder die Eingabe von einer E-Mail überprüfen:
<source lang="php">
$GLOBALS['TL_DCA']['tabellenname']['fields']['spaltenname']['eval']['rgxp'] = 'email';
</source>

==CSV import==
Um die Daten richtig importieren zu können muss darauf geachtet werden, das diese UTF-8 kodiert sein müssen. Das wird von Exel nicht direkt so gemacht.

=Video Tutorials aus dem Internet=
Ein paar Videos zu dem Catalog:

{{#widget:YouTube|id=Dg55QT7uGEI}} {{#widget:YouTube|id=wwhuSCQ4Jb4}}

=Tutorials=
* [[Catalog Merkzettel erstellen]]
* [[Catalog mit Frontend-Editing und Workflow erstellen]]
* [[Catalog Templates anpassen]]
----

--[[Benutzer:Toflar|Toflar]] 15:12, 15. Mai 2010 (UTC+1)

--[[Benutzer:MacKP|MacKP]] 13:02, 5. Apr. 2010 (UTC)

Installation

2010-10-05T01:52:39Z

Xtra: /* Liste inkompatibler Webhoster */

{{stub}}
[[Category:Installation und Updates]]

=Installation von Contao=
==Kurzanleitung für die Installation bei einem Contao-fähigen Webhoster==

# Download des Contao-Cores auf www.contao.org
# Entpacken auf dem Heimrechner
# Hochladen der Dateien mittles FTP auf Ihren Server
# Hochladen des [[Systemdiagnosetool]]s ins Verzeichnis der Contao-Installation (gewöhnlicherweise das Root-Verzeichnis Ihrer Webadresse)
# Aufrufen der Diagnosedatei in der Adresszeile Ihres Browsers und eventuelle Fehlermeldungen beseitigen
# Aufrufen der Installationsdatei: www.IhreDomain.com/contao/install.php (ersetzen Sie "www.IhreDomain.com" mit Ihrer tatsächlichen Webadresse; in diesem Fall ist Contao im Rootverzeichnis Ihres Webservers installiert; der Zugang zum BackEnd (BE) liegt im Unterverzeichnis "contao/")
# Das Installationsskript führt Sie durch die abschließenden Schritte (die erforderlichen Daten zur Datenbank erhalten Sie von Ihrem Webhoster)
# Nach erfolgreicher Installation können Sie sich im BackEnd einloggen ("www.IhreDomain.com/contao/")

==Detaillierte Anleitung für die Installation bei einem kompatiblen Webhoster==

===Download von Contao und entpacken auf dem Heimrechner===

Auf www.contao.org begibt man sich auf den Bereich [http://www.contao.org/herunterladen.html Herunterladen] und wählt die aktuellste Version von Contao zum Download und speichert diese Datei auf dem eigenen Rechner.
{{Anmerkung| Contao wird in zwei unterschiedlichen Archivformaten angeboten. pkzip (Zip-Archiv) und tar.gz (gzipped Tarball). Sollten man einen Windows PC verwenden, sollte die pkzip Version verwendet werden. }}

Nachdem die Datei heruntergeladen wurde, entpackt man sie mit dem Packprogramm seiner Wahl wie z.B. [http://www.7-zip.org/ 7-zip], welches nahezu alle gängigen Archivformate beherrscht.

===FTP-Programm einrichten===
Um Contao auf die richtige Stelle ihres Webspace zu kopieren, müssen die FTP-Zugangsdaten in ein FTP-Programm eintragen werden.
Bei Eingabe der richtigen Daten wird sich das FTP-Programm direkt in das Verzeichnis, in welchem Contao installiert werden soll, öffnen. Jedes FTP-Programm sieht anders aus, deshalb hier nur ein Beispiel. In allen Programmen sind aber immer die gleichen Angaben zu machen.
{{Achtung|Bei einigen FTP-Programmen ist standardmäßig die Übertragung von versteckten Dateien (wie .htaccess) abgeschaltet. Bei Contao ist es '''sehr wichtig''', diese Dateien mit zu übertragen. Sie gewährleisten die Sicherheit gegen ungewolltes Auslesen von Daten.
Häufig ist es möglich Parameter für den LIST-Befehl anzugeben, dann bitte '''-la''' angeben. Hierzu sollte die Doku des verwendeten FTP-Programms weiter helfen.}}

{|
|rowspan="6" | [[Datei:1u1_ftp2.jpg|FTP-Zugangsdaten eintragen]]
|valign="top" | Protokoll:
|valign="top" | Es soll eine FTP-Verbindung aufgebaut werden.
|-
|valign="top" | Server:
|valign="top" | Hier wird einfach die Hauptdomain eingetragen,<br />welche automatisch auf die richtige IP aufgelöst wird.
|-
|valign="top" | Port:
|valign="top" | Hier trägt man meist den Standard-Port einer<br />FTP-Verbindung, den Port 21 ein.
|-
|valign="top" | Benutzername:
|valign="top" | Der Benutzername wurde vom Provider mitgeteilt.
|-
|valign="top" | Passwort:
|valign="top" | Das FTP-Passwort wurde vom Provider mitgeteilt.
|-
|valign="top" | Anfangsverzeichnis:
|valign="top" | Hier muss das Basisverzeichnis für die Installation<br />angegeben werden.
|}

Wenn das FTP-Programm mit diesen Parametern gestartet wird, sollte sich auf dem Server ein leeres Verzeichnis auftun.

===Upload Contao===
In dem zuvor heruntergeladenen und entpackten Archiv ist als einziger Eintrag ein Verzeichnis mit der Versionskennung enthalten. Dieses ist das Basisverzeichnis, aus dem der Inhalt auf den Webserver geladen werden soll.

[[Datei:1u1_zip1.jpg|Contao ZIP-Archiv]]

'''Das ganze Paket (ab Basisverzeichnis) ladet man jetzt per FTP auf den Webspace hoch.'''
Wie genau dies geht, entnehme man der Bedienungsanleitung des verwendeten FTP Programmes.

===Aufruf des Installtools===

Den Installer ruft man einfach mit '''<nowiki>http://contao.meinedomain.de/contao/install.php</nowiki>''' auf (bei älteren Paketen, sprich vor Version 2.9, natürlich mit dem Pfad typolight anstatt contao).

Das Installtool verlangt als allererstes das Contao Installationspasswort. Dies ist standardmässig das kleingeschriebe Wort "contao" (bei Versionen kleiner 2.9 "typolight").

Nach Eingabe desselbigen wird man aufgefordert das Installationspasswort zu ändern.
{{Anmerkung|Das Installationspasswort muss mindestens acht Zeichen lang sein und sollte eine Kombination von gross und klein geschriebenen Buchstaben, Zahlen und Sonderzeichen sein. Dieses Passwort sollte man an einem sicheren Ort verwahren, da es jedesmal benötigt wird, wenn ein Update von Contao auf der Webseite vorgenommen wird.}}

Nachdem das Installationspasswort geändert wurde, erfolgt nun die Eingabe eines Verschlüsselungskeys.
Dieser wird von Contao dazu verwendet, Datensätze bei Bedarf verschlüsselt in der Datenbank abzulegen. Bislang wird diese Funktionalität jedoch nur von wenigen Erweiterungen verwendet.
{{Anmerkung|Diese Eingabe ist nur notwendig, wenn ein [[Webseitentemplate]] importiert werden soll. Sollte dies nicht gewünscht sein, so lässt man das Feld leer und Contao erzeugt selbständig einen Key.}}
{{Achtung|Den hierbei erzeugten Key sollte man sich auf jeden Fall, zusätzlich zum Installpasswort, notieren und sicher verwahren. Sollte er einmal verloren gehen, gibt es keine Möglichkeit mehr die verschlüsselten Daten zu entschlüsseln.}}

Nach Eingabe des Verschlüsselungskeys ist die Konfiguration der Datenbank vorzunehmen. Die zu verwendende Datenbank sollte auf jeden Fall eine MySQL Datenbank in der Version 5 sein.
{|
|[[Datei:1u1_install1.jpg|Datenbankconnection]]
|valign="top" | <br />Hier werden alle Daten eingetragen, die man von seinem Provider erhalten hat. Wenn die eingegebenen Daten korrekt sind, wird nach dem Speichern die Meldung "Datenbankverbindung ok." ausgegeben
|}

Nachdem die Zugangsdaten der Datenbankverbindung gespeichert wurden, erkennt das Installtool, dass die Datenbank nicht aktuell ist. Hier genügt es am Ende der Seite den Aktualisierungs-Button zu drücken und die Datenbank wird auf den aktuellen Stand gebracht.

Nun kann man, wenn man will, ein Webseitentemplate importieren. Von Haus aus liefert Contao das von der [http://demo.contao.org Demonstrationswebseite] bekannte Webseitentemplate "Music Academy" mit. Diese sollten Anfänger importieren, da es alle Funktionen des Cores demonstriert. Sollte kein Import gewünscht sein, so lässt man das Auswahlmenü leer.

Abschliessend muss ein Administrator angelegt werden. Hier gebe man den gewünschten Benutzernamen und das Passwort ein. Das Passwort sollte wie das Installpasswort eine Kombination unterschiedlichster Zeichen sein und muss ebenfalls mindestens acht Zeichen lang sein. (Beim Import des Webseitentemplates "Music Academy" wird automatisch ein Administrator mit angelegt.)

Nachdem der Administrator angelegt wurde, erscheint unten rechts ein Link "zum Backend", welcher ins Backend von Contao weiterleitet.<br />
'''Gratulation, die Installation ist abgeschlossen.'''

=Webhoster=
==Liste kompatibler Webhoster==

Hetzner.de (ab dem entsprechenden "Tarif inkl. MySQL-Datenbank" voll kompatibel)

{| border="0" cellpadding="5" cellspacing="1" style="margin:0;vertical-align:top;"
|+ <big>'''Diese Informationen basieren ausschließlich auf Erfahrungen von Nutzern. Diese Erfahrungen stimmen teilweise nicht für alle Webpakete eines Anbieters! Manchmal ändern Anbieter auch die technischen Einstellungen, so dass sich neue Umstände ergeben. Verlasst euch niemals nur darauf, sondern führt wenn möglich mindestens eine Diagnose, am besten aber eine Testinstallation auf einem Test-Webspace (beim Anbieter nachfragen) durch.'''</big>
|-
!Webhoster
!Tarif
!SMH notwendig
!.htaccess notwendig
!php.ini notwendig
!CHMOD notwendig
!ER möglich
!LU möglich
!Sonstige Anmerkungen
!Information von
|-
|1&1 Internet || ab 1&1 Homepage Perfect || nein || {{td_red |PHP 5}} || nein || nein || ja || {{td_yellow|unbekannt}} || [[1 und 1 Internet|detaillierte Installationsanleitung]] || do_while
|-
| 1Blu || Homepage Unlimited, Homepage Professional || nein || nein || nein || nein || ja || ja || PHP muss mittels einer im Verzeichnis abzulegenden Konfigurationsdatei auf Version 5 umgestellt werden. Problemlos und in den 1Blu-FAQ gut erklärt || LousyWeather
|-style="vertical-align:top;"|
| Alfahosting.de || Multipaket, Profipaket, Businesspaket || nein || nein || nein || nein || ja || ja || one-click-Installation von Contao. || marc und psren
|-
| Arcor || 700 MB Webspace || {{td_yellow |unbekannt}} || nein || nein || nein || {{td_red | SOAP}} || ja || Läuft sehr langsam, Premium-Pakete mit weniger Kunden pro Server gibt es nicht. Safe_Mode ist aktiviert, die Seite funktioniert trotzdem, nur eben sehr langsam. || Stranger
|-
| bytecamp.net || bytecamp arbeitet mit einem einzigen Tarifmodell || nein || {{td_red |PHP 5}} || nein || nein || ja || {{td_yellow|unbekannt}} || PHP 5 Aktivierung in .htaccess: <pre>AddType application/x-httpd-php5 .php</pre> || Franziska
|-
|BPlaced.net (Freehoster, in den Userseiten werbefrei) || Free || nein || nein || nein || nein || {{td_red |nein}} | {{td_red |nein}} ||
Laut User [http://www.contao-community.de/showthread.php?7436-PHP-Version-5.3.2&highlight=bplaced tommy] gibt es inzwischen Ärger mit diesem Freehoster.
|| thomask
|-
|CanHost || CAN-NUKE und andere || nein || nein || {{td_red |ja}} || nein || ja || ja || (hängt stark vom gebuchten Paket ab, einige Änderungen sind im IP-Conf möglich, sonstige sind häufig per Mail an Support machbar)
Kein Backup von Webspace und Datenbanken im Preis enthalten (hinzubuchbar).
Teilweise nur kurzes PHP-Zeitlimit (Support um Aufstockung bitten), Sehr verschiedene Konfigurationen der Server (auch bei gleichen Hosting-Paketen), In der Vergangenheit auch zeitweise Ausfälle, Domain teilweise nicht erreichbar.
Einige ausgewählte php.ini-Parameter lassen sich im IP-Conf (Konfigurationstool) selbst einstellen.
Über den Support kann man fast immer die benötigten Einstellungen bekommen (Beispiele: allow_url_fopen=On, max_execution_time=30, upload_max_filesize=8M, mcrypt aktiviert, SOAP installiert), nicht in allen Paketen läßt sich der Safe-Mode einstellen (safe_mode = Off).
|| do_while
|-
|Celeros Online || Private || nein || nein || nein || nein || ja || {{td_yellow|unbekannt}} || || cypa
|-
|Cyon.ch || KIWI || nein || laut Nutzer "zed" inzwischen nicht mehr nötig, PHP5 nun Standard || nein || nein || ja || ja || keine || Trikerdaniel
|-
|DomainFactory || ManagedHosting L, ManagedHosting M, My Home Vorkonfiguration 1, My Home Dynamic || nein || nein || nein || nein || ja || ja || keine || hschottm und Kahru
|-
|dynamic-net.ch || Alle Pakete inkl. Reseller || nein || nein || nein || nein || ja || ja || falls ER nicht ersichtlich, SOAP freischalten lassen - kurzes Supportticket, kein Problem. || [[User:Toflar|Toflar]]
|-
|fc-hosting || Profi-2 || nein || nein || nein || nein || ja || ja || {{td_yellow |Newsletterversand möglich, aber nur blockweise (100Stk.)}} || mandrael
|-
|Flyhost.de || Flyhost 100, Flyhost 50 || nein || nein || nein || nein || ja || {{td_yellow |unbekannt}} || keine || ways2web
|-
|genotec.ch || Shared Pro UNIX || nein || nein || nein || nein || {{td_red | SOAP}} | {{td_yellow |unbekannt}} || keine || mamboo
|-
|Goneo.de || Homepage Easy, Profi und Premium || nein || nein || nein || nein || ja || ja || nur .de Domains gelten als Inklusivdomains, andere kostenpflichtig müssen zugebucht werden || felixpfeifer
|-
|greatnet.de || Classic || nein || {{td_red |PHP 5 }} || nein || nein || ja || ja || PHP 5 Aktivierung in .htaccess: <pre>FCGIWrapper /home/www/*DEINWEB*/fcgid/php5-fcgid .php</pre> || tblumrich
|-
|Hetzner || ab dem Paket "Level 4" voll kompatibel || nein || nein || nein || nein || ja || ja || keine || firex112
|-
|Host4Free.de || individueller Tarif || nein || nein || nein || nein || ja || ja || Für größere Websites wird ein Paket ab 4maxi empfohlen, da hier mehr Arbeitsspeicher pro Prozess zur Verfügung steht. || Psi
|-
|Hosting-Agency || Agency 250 || nein || nein || nein || nein || {{td_red | SOAP}} || ja || keine || lucina
|-
|Hostmonster.com || - || nein || nein || nein || nein || {{td_yellow |unbekannt}} | {{td_yellow |unbekannt}} || keine || crazycisco
|-
|Hostpoint.ch || SH Server Standard || nein || nein || nein || nein || ja || ja || Anscheinend läuft bei Hostpoint [http://www.contao-community.de/showpost.php?p=30104&postcount=32 TCPDF nicht wie gewünscht]
|| Trikerdaniel
|-
|Hoststar.ch || StarEntry || nein || {{td_red |PHP 5}} | {{td_red |mod_rewrite aktivieren lassen}} || nein || {{td_yellow | SOAP}} || ja || Über my.hoststar.ch ein Ticket erstellen für SOAP Aktivierung. Dann kommt meistens eine Antwort wie "das sei unsicher". Durch Beharrlichkeit und klar machen dass SOAP kein Sicherheitsrisiko darstellt kann Aktivierung erreicht werden. || dusi
|-
|HostTech.biz || Easy 10000 || {{td_red |Ja}} || nein || nein || nein || ja || {{td_yellow |unbekannt}} || keine || m.koell
|-
|intersaar.de || ab Web-Präsenz "Eco" aufwärts ("Eco", "Business", "Professional", "Premium") gut geeignet. || nein || nein || nein || nein || {{td_yellow | SOAP}} | {{td_yellow |unbekannt}} || Bei Vertragsschluß am Besten gleich angeben, daß SOAP-Extensions aktiviert werden sollen. || rhagen
|-
|Mittwald || - || nein || nein || nein || nein || ja || ja || keine || Mittwald
|-
|one.com || 3000MB || {{td_yellow |unbekannt}} || nein || nein || nein || ja || {{td_yellow |unbekannt}} || keine || cypa
|-
|Strato || Strato PowerPlus, Strato Speedplus || nein || {{td_red |PHP 5 }} || nein || nein || {{td_red | SOAP}} | {{td_yellow |unbekannt}} || <pre>AddHandler application/x-httpd-php5 .php</pre>''Anmerkung von planepix:'' Alternativ kann man sich im Kundencenter von Strato einloggen und links im Menü unter "Homepagestaltung" die Option "Website-Konfigurator" wählen. Dort gibt es den Punkt "PHP-Konfiguration" mit dem man die PHP-Version fürs Verzeichnis auf PHP5 einstellen kann.
''In den neuen Paketen (z.B. BasicWeb XL) muss man in der localconfig.php ggf. diese Zeile nach(!) "### INSTALL SCRIPT STOP ###" hinzufügen:''
<pre>unset($_SERVER['HTTP_X_FORWARDED_HOST']);</pre>
teilweise sehr langsam im Datenbankzugriff
|| thomask
|-
|Suleitec || ab Tarif Expert || nein || nein || nein || nein || {{td_yellow |unbekannt}} | {{td_yellow |unbekannt}} || keine || Soulfood
|-
|TNG || VLAMP-Server || nein || nein || nein || nein || ja || ja || Aktivierung von mod_rewrite via Support || lucina
|-
|Top-Hoster.de || Tarife "S"-"XXL", "Sommerpaket 2009" ohne Probleme, || nein || {{td_red |PHP 5 }} || nein || nein || {{td_yellow |SOAP}} | {{td_yellow |unbekannt}} || SOAP von Support aktivieren lassen.<br/>'''Tarif "XS" funktioniert nicht, hat keine MySQL-Datenbanken''' || StephanE
|-
|United-Domains || Standard || nein || nein || nein || nein || ja || ja || keine || Nina
|-
|web.de || colspan="8" | Siehe [[1 und 1 Internet]] da web.de eine Tochtergesellschaft ist. || kos
|-
|webhoster.de || Webhosting Starter Tarif || nein || nein || nein || nein || ja || ja || keine || x-ray
|-
|WebHostOne || ab Basic-300 (Carino: empfohlen Basic 750), Pro-1500 || nein || nein || nein || nein || ja || ja ||
[http://www.contao.org/neuigkeiten/items/typolight-als-1click-installation.html 1 Klick Installation von TL]<br/>Man kann bei speziellen Wünschen httpd.conf und php.ini selbst anpassen. Wenn man sich nicht so gut damit auskennt, kann man sogar im kostenlosen SupportChat fragen wie man welchen Befehl schreiben muss.
|| Carino und Stranger
|-
|World4You || Domainserver Start || nein || nein || nein || nein || ja || ja || Live Update URL ev. vom Support freischalten lassen.<br/>Contao als Easy.Install im Kundencenter verfügbar. || HAST
|-
|}

==Workarounds für bestimmte Webhoster==
Bei manchen Webhostern ist es leider notwendig von obigem Standard Installationsschema abzuweichen.

Diese Besonderheiten sind hier aufgeführt um zu ermöglichen, dass Contao bei diesen Webhostern läuft.

Oftmals betrifft dies den so genannten [[Safemode Hack]], welcher bei etlichen Webhostern notwendig ist.
Weiterhin ist oftmals die SOAP Erweiterung nicht in PHP enthalten, was den Erweiterungskatalog nicht verwendbar macht (Mögliche Abhilfe hierbei ist jedoch [[TensideRepository]]).

{{Hinweis|In Zukunft wird hier eine Liste von Artikeln veröffentlicht, welche Anpassungen bei welchen Webhoster notwendig ist um Contao zum Laufen zu bekommen.}}

==Liste inkompatibler Webhoster==
In dieser Liste werden Webhoster gelistet, bei denen Contao nicht eingesetzt werden kann oder sollte, da sie die Nutzung wichtiger Systemfunktionen deaktivieren.
Bitte beim Hinzufügen von Webhostern darauf achten, detailliert zu beschreiben woran es scheitert, wie z.B. "stellt nur PHP4 zur Verfügung", alternativ kann auch der Inhalt des betzreffenden Forum-threads rezitiert werden und selbiger Thread als Sonstige Anmerkung verlinkt werden.

{| border="0" cellpadding="5" cellspacing="1" style="margin:0;vertical-align:top;"
|+ <big>'''Diese Informationen basieren ausschließlich auf Erfahrungen von Nutzern. Diese Erfahrungen stimmen teilweise nicht für alle Webpakete eines Anbieters! Manchmal ändern Anbieter auch die technischen Einstellungen, so dass sich neue Umstände ergeben. Verlasst euch niemals nur darauf, sondern führt wenn möglich mindestens eine Diagnose, am besten aber eine Testinstallation auf einem Test-Webspace (beim Anbieter nachfragen) durch.'''</big>
|-
!Webhoster
!Grund der Inkompatibilität
!Sonstige Anmerkungen
!Information von
|-
|1a websolutions.ch || Verwendet mod_security welches das Datenbank update lahm legt. || [http://www.contao-community.de/showthread.php?5895-Fehlermeldung-bei-der-Installatio Forum-Thread] || bluerate
|-
|T-Online ||Unterstützt keinen .htaccess Dateien daher keine URL Umschreibung und keine Absicherung von Verzeichnissen. || [http://www.contao-community.de/showthread.php?5621-t-online Forum-Thread] || MPstudent
|}

Installation

2010-10-05T01:38:27Z

Xtra: Liste kompatibler Webhoster befuellt. Muss noch gestyled werden - sieht "spartanisch" aus.

{{stub}}
[[Category:Installation und Updates]]

=Installation von Contao=
==Kurzanleitung für die Installation bei einem Contao-fähigen Webhoster==

# Download des Contao-Cores auf www.contao.org
# Entpacken auf dem Heimrechner
# Hochladen der Dateien mittles FTP auf Ihren Server
# Hochladen des [[Systemdiagnosetool]]s ins Verzeichnis der Contao-Installation (gewöhnlicherweise das Root-Verzeichnis Ihrer Webadresse)
# Aufrufen der Diagnosedatei in der Adresszeile Ihres Browsers und eventuelle Fehlermeldungen beseitigen
# Aufrufen der Installationsdatei: www.IhreDomain.com/contao/install.php (ersetzen Sie "www.IhreDomain.com" mit Ihrer tatsächlichen Webadresse; in diesem Fall ist Contao im Rootverzeichnis Ihres Webservers installiert; der Zugang zum BackEnd (BE) liegt im Unterverzeichnis "contao/")
# Das Installationsskript führt Sie durch die abschließenden Schritte (die erforderlichen Daten zur Datenbank erhalten Sie von Ihrem Webhoster)
# Nach erfolgreicher Installation können Sie sich im BackEnd einloggen ("www.IhreDomain.com/contao/")

==Detaillierte Anleitung für die Installation bei einem kompatiblen Webhoster==

===Download von Contao und entpacken auf dem Heimrechner===

Auf www.contao.org begibt man sich auf den Bereich [http://www.contao.org/herunterladen.html Herunterladen] und wählt die aktuellste Version von Contao zum Download und speichert diese Datei auf dem eigenen Rechner.
{{Anmerkung| Contao wird in zwei unterschiedlichen Archivformaten angeboten. pkzip (Zip-Archiv) und tar.gz (gzipped Tarball). Sollten man einen Windows PC verwenden, sollte die pkzip Version verwendet werden. }}

Nachdem die Datei heruntergeladen wurde, entpackt man sie mit dem Packprogramm seiner Wahl wie z.B. [http://www.7-zip.org/ 7-zip], welches nahezu alle gängigen Archivformate beherrscht.

===FTP-Programm einrichten===
Um Contao auf die richtige Stelle ihres Webspace zu kopieren, müssen die FTP-Zugangsdaten in ein FTP-Programm eintragen werden.
Bei Eingabe der richtigen Daten wird sich das FTP-Programm direkt in das Verzeichnis, in welchem Contao installiert werden soll, öffnen. Jedes FTP-Programm sieht anders aus, deshalb hier nur ein Beispiel. In allen Programmen sind aber immer die gleichen Angaben zu machen.
{{Achtung|Bei einigen FTP-Programmen ist standardmäßig die Übertragung von versteckten Dateien (wie .htaccess) abgeschaltet. Bei Contao ist es '''sehr wichtig''', diese Dateien mit zu übertragen. Sie gewährleisten die Sicherheit gegen ungewolltes Auslesen von Daten.
Häufig ist es möglich Parameter für den LIST-Befehl anzugeben, dann bitte '''-la''' angeben. Hierzu sollte die Doku des verwendeten FTP-Programms weiter helfen.}}

{|
|rowspan="6" | [[Datei:1u1_ftp2.jpg|FTP-Zugangsdaten eintragen]]
|valign="top" | Protokoll:
|valign="top" | Es soll eine FTP-Verbindung aufgebaut werden.
|-
|valign="top" | Server:
|valign="top" | Hier wird einfach die Hauptdomain eingetragen,<br />welche automatisch auf die richtige IP aufgelöst wird.
|-
|valign="top" | Port:
|valign="top" | Hier trägt man meist den Standard-Port einer<br />FTP-Verbindung, den Port 21 ein.
|-
|valign="top" | Benutzername:
|valign="top" | Der Benutzername wurde vom Provider mitgeteilt.
|-
|valign="top" | Passwort:
|valign="top" | Das FTP-Passwort wurde vom Provider mitgeteilt.
|-
|valign="top" | Anfangsverzeichnis:
|valign="top" | Hier muss das Basisverzeichnis für die Installation<br />angegeben werden.
|}

Wenn das FTP-Programm mit diesen Parametern gestartet wird, sollte sich auf dem Server ein leeres Verzeichnis auftun.

===Upload Contao===
In dem zuvor heruntergeladenen und entpackten Archiv ist als einziger Eintrag ein Verzeichnis mit der Versionskennung enthalten. Dieses ist das Basisverzeichnis, aus dem der Inhalt auf den Webserver geladen werden soll.

[[Datei:1u1_zip1.jpg|Contao ZIP-Archiv]]

'''Das ganze Paket (ab Basisverzeichnis) ladet man jetzt per FTP auf den Webspace hoch.'''
Wie genau dies geht, entnehme man der Bedienungsanleitung des verwendeten FTP Programmes.

===Aufruf des Installtools===

Den Installer ruft man einfach mit '''<nowiki>http://contao.meinedomain.de/contao/install.php</nowiki>''' auf (bei älteren Paketen, sprich vor Version 2.9, natürlich mit dem Pfad typolight anstatt contao).

Das Installtool verlangt als allererstes das Contao Installationspasswort. Dies ist standardmässig das kleingeschriebe Wort "contao" (bei Versionen kleiner 2.9 "typolight").

Nach Eingabe desselbigen wird man aufgefordert das Installationspasswort zu ändern.
{{Anmerkung|Das Installationspasswort muss mindestens acht Zeichen lang sein und sollte eine Kombination von gross und klein geschriebenen Buchstaben, Zahlen und Sonderzeichen sein. Dieses Passwort sollte man an einem sicheren Ort verwahren, da es jedesmal benötigt wird, wenn ein Update von Contao auf der Webseite vorgenommen wird.}}

Nachdem das Installationspasswort geändert wurde, erfolgt nun die Eingabe eines Verschlüsselungskeys.
Dieser wird von Contao dazu verwendet, Datensätze bei Bedarf verschlüsselt in der Datenbank abzulegen. Bislang wird diese Funktionalität jedoch nur von wenigen Erweiterungen verwendet.
{{Anmerkung|Diese Eingabe ist nur notwendig, wenn ein [[Webseitentemplate]] importiert werden soll. Sollte dies nicht gewünscht sein, so lässt man das Feld leer und Contao erzeugt selbständig einen Key.}}
{{Achtung|Den hierbei erzeugten Key sollte man sich auf jeden Fall, zusätzlich zum Installpasswort, notieren und sicher verwahren. Sollte er einmal verloren gehen, gibt es keine Möglichkeit mehr die verschlüsselten Daten zu entschlüsseln.}}

Nach Eingabe des Verschlüsselungskeys ist die Konfiguration der Datenbank vorzunehmen. Die zu verwendende Datenbank sollte auf jeden Fall eine MySQL Datenbank in der Version 5 sein.
{|
|[[Datei:1u1_install1.jpg|Datenbankconnection]]
|valign="top" | <br />Hier werden alle Daten eingetragen, die man von seinem Provider erhalten hat. Wenn die eingegebenen Daten korrekt sind, wird nach dem Speichern die Meldung "Datenbankverbindung ok." ausgegeben
|}

Nachdem die Zugangsdaten der Datenbankverbindung gespeichert wurden, erkennt das Installtool, dass die Datenbank nicht aktuell ist. Hier genügt es am Ende der Seite den Aktualisierungs-Button zu drücken und die Datenbank wird auf den aktuellen Stand gebracht.

Nun kann man, wenn man will, ein Webseitentemplate importieren. Von Haus aus liefert Contao das von der [http://demo.contao.org Demonstrationswebseite] bekannte Webseitentemplate "Music Academy" mit. Diese sollten Anfänger importieren, da es alle Funktionen des Cores demonstriert. Sollte kein Import gewünscht sein, so lässt man das Auswahlmenü leer.

Abschliessend muss ein Administrator angelegt werden. Hier gebe man den gewünschten Benutzernamen und das Passwort ein. Das Passwort sollte wie das Installpasswort eine Kombination unterschiedlichster Zeichen sein und muss ebenfalls mindestens acht Zeichen lang sein. (Beim Import des Webseitentemplates "Music Academy" wird automatisch ein Administrator mit angelegt.)

Nachdem der Administrator angelegt wurde, erscheint unten rechts ein Link "zum Backend", welcher ins Backend von Contao weiterleitet.<br />
'''Gratulation, die Installation ist abgeschlossen.'''

=Webhoster=
==Liste kompatibler Webhoster==

Hetzner.de (ab dem entsprechenden "Tarif inkl. MySQL-Datenbank" voll kompatibel)

{| border="0" cellpadding="5" cellspacing="1" style="margin:0;vertical-align:top;"
|+ <big>'''Diese Informationen basieren ausschließlich auf Erfahrungen von Nutzern. Diese Erfahrungen stimmen teilweise nicht für alle Webpakete eines Anbieters! Manchmal ändern Anbieter auch die technischen Einstellungen, so dass sich neue Umstände ergeben. Verlasst euch niemals nur darauf, sondern führt wenn möglich mindestens eine Diagnose, am besten aber eine Testinstallation auf einem Test-Webspace (beim Anbieter nachfragen) durch.'''</big>
|-
!Webhoster
!Tarif
!SMH notwendig
!.htaccess notwendig
!php.ini notwendig
!CHMOD notwendig
!ER möglich
!LU möglich
!Sonstige Anmerkungen
!Information von
|-
|1&1 Internet || ab 1&1 Homepage Perfect || nein || {{td_red |PHP 5}} || nein || nein || ja || {{td_yellow|unbekannt}} || [[1 und 1 Internet|detaillierte Installationsanleitung]] || do_while
|-
| 1Blu || Homepage Unlimited, Homepage Professional || nein || nein || nein || nein || ja || ja || PHP muss mittels einer im Verzeichnis abzulegenden Konfigurationsdatei auf Version 5 umgestellt werden. Problemlos und in den 1Blu-FAQ gut erklärt || LousyWeather
|-style="vertical-align:top;"|
| Alfahosting.de || Multipaket, Profipaket, Businesspaket || nein || nein || nein || nein || ja || ja || one-click-Installation von Contao. || marc und psren
|-
| Arcor || 700 MB Webspace || {{td_yellow |unbekannt}} || nein || nein || nein || {{td_red | SOAP}} || ja || Läuft sehr langsam, Premium-Pakete mit weniger Kunden pro Server gibt es nicht. Safe_Mode ist aktiviert, die Seite funktioniert trotzdem, nur eben sehr langsam. || Stranger
|-
| bytecamp.net || bytecamp arbeitet mit einem einzigen Tarifmodell || nein || {{td_red |PHP 5}} || nein || nein || ja || {{td_yellow|unbekannt}} || PHP 5 Aktivierung in .htaccess: <pre>AddType application/x-httpd-php5 .php</pre> || Franziska
|-
|BPlaced.net (Freehoster, in den Userseiten werbefrei) || Free || nein || nein || nein || nein || {{td_red |nein}} | {{td_red |nein}} ||
Laut User [http://www.contao-community.de/showthread.php?7436-PHP-Version-5.3.2&highlight=bplaced tommy] gibt es inzwischen Ärger mit diesem Freehoster.
|| thomask
|-
|CanHost || CAN-NUKE und andere || nein || nein || {{td_red |ja}} || nein || ja || ja || (hängt stark vom gebuchten Paket ab, einige Änderungen sind im IP-Conf möglich, sonstige sind häufig per Mail an Support machbar)
Kein Backup von Webspace und Datenbanken im Preis enthalten (hinzubuchbar).
Teilweise nur kurzes PHP-Zeitlimit (Support um Aufstockung bitten), Sehr verschiedene Konfigurationen der Server (auch bei gleichen Hosting-Paketen), In der Vergangenheit auch zeitweise Ausfälle, Domain teilweise nicht erreichbar.
Einige ausgewählte php.ini-Parameter lassen sich im IP-Conf (Konfigurationstool) selbst einstellen.
Über den Support kann man fast immer die benötigten Einstellungen bekommen (Beispiele: allow_url_fopen=On, max_execution_time=30, upload_max_filesize=8M, mcrypt aktiviert, SOAP installiert), nicht in allen Paketen läßt sich der Safe-Mode einstellen (safe_mode = Off).
|| do_while
|-
|Celeros Online || Private || nein || nein || nein || nein || ja || {{td_yellow|unbekannt}} || || cypa
|-
|Cyon.ch || KIWI || nein || laut Nutzer "zed" inzwischen nicht mehr nötig, PHP5 nun Standard || nein || nein || ja || ja || keine || Trikerdaniel
|-
|DomainFactory || ManagedHosting L, ManagedHosting M, My Home Vorkonfiguration 1, My Home Dynamic || nein || nein || nein || nein || ja || ja || keine || hschottm und Kahru
|-
|dynamic-net.ch || Alle Pakete inkl. Reseller || nein || nein || nein || nein || ja || ja || falls ER nicht ersichtlich, SOAP freischalten lassen - kurzes Supportticket, kein Problem. || [[User:Toflar|Toflar]]
|-
|fc-hosting || Profi-2 || nein || nein || nein || nein || ja || ja || {{td_yellow |Newsletterversand möglich, aber nur blockweise (100Stk.)}} || mandrael
|-
|Flyhost.de || Flyhost 100, Flyhost 50 || nein || nein || nein || nein || ja || {{td_yellow |unbekannt}} || keine || ways2web
|-
|genotec.ch || Shared Pro UNIX || nein || nein || nein || nein || {{td_red | SOAP}} | {{td_yellow |unbekannt}} || keine || mamboo
|-
|Goneo.de || Homepage Easy, Profi und Premium || nein || nein || nein || nein || ja || ja || nur .de Domains gelten als Inklusivdomains, andere kostenpflichtig müssen zugebucht werden || felixpfeifer
|-
|greatnet.de || Classic || nein || {{td_red |PHP 5 }} || nein || nein || ja || ja || PHP 5 Aktivierung in .htaccess: <pre>FCGIWrapper /home/www/*DEINWEB*/fcgid/php5-fcgid .php</pre> || tblumrich
|-
|Hetzner || ab dem Paket "Level 4" voll kompatibel || nein || nein || nein || nein || ja || ja || keine || firex112
|-
|Host4Free.de || individueller Tarif || nein || nein || nein || nein || ja || ja || Für größere Websites wird ein Paket ab 4maxi empfohlen, da hier mehr Arbeitsspeicher pro Prozess zur Verfügung steht. || Psi
|-
|Hosting-Agency || Agency 250 || nein || nein || nein || nein || {{td_red | SOAP}} || ja || keine || lucina
|-
|Hostmonster.com || - || nein || nein || nein || nein || {{td_yellow |unbekannt}} | {{td_yellow |unbekannt}} || keine || crazycisco
|-
|Hostpoint.ch || SH Server Standard || nein || nein || nein || nein || ja || ja || Anscheinend läuft bei Hostpoint [http://www.contao-community.de/showpost.php?p=30104&postcount=32 TCPDF nicht wie gewünscht]
|| Trikerdaniel
|-
|Hoststar.ch || StarEntry || nein || {{td_red |PHP 5}} | {{td_red |mod_rewrite aktivieren lassen}} || nein || {{td_yellow | SOAP}} || ja || Über my.hoststar.ch ein Ticket erstellen für SOAP Aktivierung. Dann kommt meistens eine Antwort wie "das sei unsicher". Durch Beharrlichkeit und klar machen dass SOAP kein Sicherheitsrisiko darstellt kann Aktivierung erreicht werden. || dusi
|-
|HostTech.biz || Easy 10000 || {{td_red |Ja}} || nein || nein || nein || ja || {{td_yellow |unbekannt}} || keine || m.koell
|-
|intersaar.de || ab Web-Präsenz "Eco" aufwärts ("Eco", "Business", "Professional", "Premium") gut geeignet. || nein || nein || nein || nein || {{td_yellow | SOAP}} | {{td_yellow |unbekannt}} || Bei Vertragsschluß am Besten gleich angeben, daß SOAP-Extensions aktiviert werden sollen. || rhagen
|-
|Mittwald || - || nein || nein || nein || nein || ja || ja || keine || Mittwald
|-
|one.com || 3000MB || {{td_yellow |unbekannt}} || nein || nein || nein || ja || {{td_yellow |unbekannt}} || keine || cypa
|-
|Strato || Strato PowerPlus, Strato Speedplus || nein || {{td_red |PHP 5 }} || nein || nein || {{td_red | SOAP}} | {{td_yellow |unbekannt}} || <pre>AddHandler application/x-httpd-php5 .php</pre>''Anmerkung von planepix:'' Alternativ kann man sich im Kundencenter von Strato einloggen und links im Menü unter "Homepagestaltung" die Option "Website-Konfigurator" wählen. Dort gibt es den Punkt "PHP-Konfiguration" mit dem man die PHP-Version fürs Verzeichnis auf PHP5 einstellen kann.
''In den neuen Paketen (z.B. BasicWeb XL) muss man in der localconfig.php ggf. diese Zeile nach(!) "### INSTALL SCRIPT STOP ###" hinzufügen:''
<pre>unset($_SERVER['HTTP_X_FORWARDED_HOST']);</pre>
teilweise sehr langsam im Datenbankzugriff
|| thomask
|-
|Suleitec || ab Tarif Expert || nein || nein || nein || nein || {{td_yellow |unbekannt}} | {{td_yellow |unbekannt}} || keine || Soulfood
|-
|TNG || VLAMP-Server || nein || nein || nein || nein || ja || ja || Aktivierung von mod_rewrite via Support || lucina
|-
|Top-Hoster.de || Tarife "S"-"XXL", "Sommerpaket 2009" ohne Probleme, || nein || {{td_red |PHP 5 }} || nein || nein || {{td_yellow |SOAP}} | {{td_yellow |unbekannt}} || SOAP von Support aktivieren lassen.<br/>'''Tarif "XS" funktioniert nicht, hat keine MySQL-Datenbanken''' || StephanE
|-
|United-Domains || Standard || nein || nein || nein || nein || ja || ja || keine || Nina
|-
|web.de || colspan="8" | Siehe [[1 und 1 Internet]] da web.de eine Tochtergesellschaft ist. || kos
|-
|webhoster.de || Webhosting Starter Tarif || nein || nein || nein || nein || ja || ja || keine || x-ray
|-
|WebHostOne || ab Basic-300 (Carino: empfohlen Basic 750), Pro-1500 || nein || nein || nein || nein || ja || ja ||
[http://www.contao.org/neuigkeiten/items/typolight-als-1click-installation.html 1 Klick Installation von TL]<br/>Man kann bei speziellen Wünschen httpd.conf und php.ini selbst anpassen. Wenn man sich nicht so gut damit auskennt, kann man sogar im kostenlosen SupportChat fragen wie man welchen Befehl schreiben muss.
|| Carino und Stranger
|-
|World4You || Domainserver Start || nein || nein || nein || nein || ja || ja || Live Update URL ev. vom Support freischalten lassen.<br/>Contao als Easy.Install im Kundencenter verfügbar. || HAST
|-
|}

==Workarounds für bestimmte Webhoster==
Bei manchen Webhostern ist es leider notwendig von obigem Standard Installationsschema abzuweichen.

Diese Besonderheiten sind hier aufgeführt um zu ermöglichen, dass Contao bei diesen Webhostern läuft.

Oftmals betrifft dies den so genannten [[Safemode Hack]], welcher bei etlichen Webhostern notwendig ist.
Weiterhin ist oftmals die SOAP Erweiterung nicht in PHP enthalten, was den Erweiterungskatalog nicht verwendbar macht (Mögliche Abhilfe hierbei ist jedoch [[TensideRepository]]).

{{Hinweis|In Zukunft wird hier eine Liste von Artikeln veröffentlicht, welche Anpassungen bei welchen Webhoster notwendig ist um Contao zum Laufen zu bekommen.}}

==Liste inkompatibler Webhoster==
In dieser Liste werden Webhoster gelistet, bei denen Contao nicht eingesetzt werden kann.
Bitte beim Hinzufügen von Webhostern darauf achten, dass man detailliert beschreibt woran es scheitert, wie z.B. "stellt nur PHP4 zur Verfügung".

Vorlage:Td yellow

2010-10-05T00:03:12Z

Xtra: Erste Version

style="background-color: yellow" | {{{1}}}
<noinclude>
''Formatierung fuer eine gelb hinterlegte Zelle in einer Tabellendefinition.''
[[Category:Vorlagen]]
</noinclude>

Vorlage:Td red

2010-10-05T00:00:23Z

Xtra:

style="background-color: red" | {{{1}}}
<noinclude>
''Formatierung fuer eine rot hinterlegte Zelle in einer Tabellendefinition.''
[[Category:Vorlagen]]
</noinclude>

Vorlage:Td red

2010-10-04T23:56:21Z

Xtra: Erste Version

<includeonly>
style="background-color: red" | {{{1}}}
</includeonly>
<noinclude>
''Formatierung fuer eine rot hinterlegte Zelle in einer Tabellendefinition.''
[[Category:Vorlagen]]
</noinclude>

Catalog Templates anpassen

2010-09-02T05:00:31Z

Xtra: /* Wie man in eigenen Templates beim Katalog Thumbnails generieren kann */

ccdde:Aktuelle Ereignisse

2010-08-26T23:15:12Z

Xtra: Geshi Ankündigung

Hier im Wiki ist nun ein Syntax Highlighter ([[w:de:GeSHi|GeSHi]]) installiert. Bitte die Änderungen in der [[Hilfe:Hilfe|Hilfe]] beachten.<br />
--[[Benutzer:Xtra|Xtra]] 01:15, 27. Aug. 2010 (CEST)
----
Contao 2.9 veröffentlicht: [http://www.contao.org/neuigkeiten/items/contao_2-9-0.html Ankündigung auf der Projektseite]<br />
--[[Benutzer:Manitougs|Manitougs]] 13:02, 2. Jul. 2010 (CEST)
----
Typolight 2.8.4 veröffentlicht.<br />
--[[Benutzer:Manitougs|Manitougs]] 20:22, 1. Jul. 2010 (CEST)
----
Contao 2.9 RC1 verfügbar: [http://www.contao.org/neuigkeiten/items/contao_2-9-RC1.html Contao News - Contao 2.9 RC1]<br />
--[[Benutzer:Manitougs|Manitougs]] 09:53, 25. Jun. 2010 (UTC)
----
Aus TYPOlight wird Contao: [http://www.contao.org/neuigkeiten/items/typolight-wird-zu-contao.html Contao News - TYPOlight wird zu Contao]<br />
--[[Benutzer:Manitougs|Manitougs]] 09:53, 25. Jun. 2010 (UTC)
----
Aktuell schreiben wir die bestehenden TYPOlight Artikel auf Contao um.

Weiterhin wird die Optik dieses Wiki Stück für Stück an die CI des Contao Projekts angepasst.

Hilfe:Inhaltsverzeichnis

2010-08-26T23:09:35Z

Xtra: Auszeichung von Quellcode angepasst da Syntax Highlighter installiert.

Eigene insert tags erstellen

2010-08-26T22:51:52Z

Xtra: Umstellung auf Syntax Highlighting.

{{stub}}
[[Category:Dev HOWTOS]]
[[Category:Dev Snippets]]
{{AppliesTo
|TLVersion=ab 2.6
|Version=ab 2.9
}}
Unter Insert-Tags versteht man in Contao spezielle Platzhalter, die beim Laden der Webseite durch bestimmte Inhalte ersetzt werden. Dies können zum Beispiel der aktuelle Benutzername, ein Datum oder ein Link sein. Der Contao-Core bietet eine ganze Reihe verschiedener Insert-Tags, welche auf der Projekthomepage dokumentiert sind (siehe [http://www.contao.org/inserttags.html Contao Insert-Tags]).

== Aufbau eines Insert-Tags ==
Insert-Tags werden generell in zwei geschwungenen Klammern verpackt. <nowiki>{{var::value}}</nowiki> Des weiteren sind Insert-Tags meistens zweigeteilt. Die Wertepaare sind durch zwei Doppelpunkte getrennt. Der erste Teil ist entweder die Kategoriezugehörigkeit des Insert-Tags oder der Name des Tags. Der zweite Teil ist meistens ein Parameter, um die gewünschte Rückgabe noch zu verfeinern. Ein Beispiel verdeutlicht dies: <nowiki>{{link::*}}</nowiki> Dieser Insert Tag würde einen Link zur Seite * (muss durch die ID der Seite ersetzt werden) im richtigen URL Format generieren.

== Eigene Insert-Tags erstellen ==
Seit TYPOlight Version 2.6 kann man Contao durch eigene Insert-Tags erweitern. Dazu wurde der Hook replaceInsertTags zur Verfügung gestellt. Der Ablauf ist nun folgender.
# Contao parsed einen Seitenaufruf und stößt dabei auf ein Insert-Tag
# Contao probiert dieses Insert-Tag mit den Core-Möglichkeiten zu ersetzen
# Wenn Contao das Insert-Tag nicht kennt, wird es an den Hook replaceInsertTags weitergereicht. Dieser Hook erhält das unbekannte Insert-Tag als Parameter. Nun kann der Entwickler prüfen ob er das unbekannte Insert-Tag ersetzen möchte und wenn ja, gibt er einen beliebigen Content zurück.
# Wenn der Entwickler nichts mit dem unbekannten Insert-Tag anfangen kann, so muss false zurück gegeben werden.

== Codebeispiel ==
In diesem Code-Beispiel soll der Insert-Tag <nowiki>{{foo::bar}}</nowiki> ersetzt werden.
Als erstes muss der Hook registriert werden.
<source>
// config.php
// Registrieren des Hooks replaceInsertTags
$GLOBALS['TL_HOOKS']['replaceInsertTags'][] = array('MyClass', 'myReplaceInsertTags');
</source>

Nach der Registrierung des Hooks muss eine Klasse erstellt werden, welche eine Methode zur Ersetzung beinhaltet.
<source>
//MyClass.php
class MyClass extends Frontend
{
public function myReplaceInsertTags($strTag)
{
$arrSplit = explode('::', $strTag);

if ($arrSplit[0] == 'foo')
{
// replace your Insert Tag
return 'mein content';
}

return false;
}
}
</source>
In der Methode myReplaceInsertTags muss man zuerst prüfen, ob man für den unbekannten Insert-Tag zuständig ist. Wenn man einen zweigeteilten Insert-Tag verwendet, splittet man den Tag anhand des :: (explode). Die geschweiften Klammern werden bereits von Contao entfernt und müssen daher nicht mehr entfernt werden.

// der Schluss ist irgend wie noch nicht richtig Formuliert, ich kann leider nicht mehr, bin total übermüdet....

Nachrichten

2010-08-26T22:24:07Z

Xtra: stub+Kategorie

{{stub}}
[[Category:Admin HOWTOS]]

== '''Tutorial: Nachrichten und Nachrichtenarchive in Contao 2.9.1 anlegen''' ==

'''Schritt 1: // SEITENSTRUKTUR ANLEGEN //'''

Layout -> Seitenstruktur -> Neue Seite
(Ich gehe mal dvon aus, das schon eine Seite, sagen wir "News" angelegt ist.)

Unter der Seite "News" werden zwei weitere Seiten angelegt.

-Start
--News
---News Reader (im Menü verstecken)
---News Archiv (im Menü verstecken)

'''Schritt 2: // NACHRICHTENARCHIV ANLEGEN //'''

Inhalte -> Nachrichten -> Neues Archiv (Name "Nachrichten")
Nachrichten bearbeiten und die Weiterleitungsseite "News Reader" auswählen

'''Schritt 3: // NACHRICHTEN MODULE ANLEGEN //'''

Layout -> Themes -> Frontend-Module bearbeiten

Folgende Module anlegen:

- Nachrichtenarchiv (Nachrichtentemplate -> short) (Modul mit Nachrichtenarchiv verknüpfen) |
- Nachrichtenarchiv-Menü (Nachrichtentemplate -> short) (Modul mit Nachrichtenarchiv verknüpfen) |
- Nachrichtenleser (Nachrichtentemplate -> short) (Modul mit Nachrichtenarchiv verknüpfen) |
- Nachrichtenliste (Nachrichtentemplate -> short) (Modul mit Nachrichtenarchiv verknüpfen) |

'''Schritt 4: // ERSTE NACHRICHT ANLEGEN //'''

(Inhalt: Lorim ipsum, Teaser etc.)

'''Schritt 4: // ARCHIVIERUNG //'''

In der Seitenstruktur der Artikel, die Module "Nachrichtenarchiv-Menü" & "Nachrichtenarchiv"
in die Seite "News Archiv" einbinden.
Das Module "Nachrichtenarchiv-Menü" auf die "News Archiv" Seite weiterleiten.

'''Schritt 5: // TESTEN //'''

Wenn alles geht, css anpassen.

Installation

2010-08-25T07:07:16Z

Xtra: Erster Textentwurf in Bereich: /* Detaillierte Anleitung für die Installation bei einem kompatiblen Webhoster */

Diskussion:PHP Debugging

2010-08-24T16:32:14Z

Xtra:

Welches von beiden ist das aktuellere?
Das von: http://websvn.cyberspectrum.de/wsvn/tl_debug/
oder von: http://dev.typolight-forge.org/projects/show/debug
----
Es sind beides dieselben, jedoch unter unterschiedlicher URL erreichbar. Ich hab zusaetzlich zu meinem svn auf tl_forge angelegt um den dortigen bugtracker mitzubenutzen etc. Zumal die Extensions IMO unter einer Anlaufstelle gesammelt werden sollten, daher der forge.
--[[Benutzer:Xtra|Xtra]] 18:32, 24. Aug. 2010 (CEST)

Zusätzliche Layoutdateien

2010-08-22T22:10:58Z

Xtra: hat „Zusätzliche Layoutdateien“ nach „Layout additional sources“ verschoben: Angleichen des Namens an den Namen im Extension Repository.

#WEITERLEITUNG [[Layout additional sources]]