Benötigt:

• Serverumgebung mit der Möglichkeit für Rewrite-Regeln (z.B. mittels .htaccess)

Anleitung:

1. Lege folgende Seitenstrukur an oder ergänze die vorhandene Seitenstruktur entsprechend:
   
   Bei mir lauten die URLs dazu:
   /login.html
   /login/passwort-vergessen.html
   /login/passwort-vergessen/bestaetigung.html 
   /login/passwort-zuruecksetzen.html
   /login/passwort-zuruecksetzen/bestaetigung.html  
2. Lege ein Modul vom Typ "Passwort vergessen" an. Als Weiterleitungsseite verwendest du die erste Bestätigungsseite in der Liste, als Bestätigungsseite wählst du die zweite aus.
3. Auf der Seite "Passwort vergessen" beschreibst du, dass man seine E-Mail-Adresse eingeben muss und dann ein neues Passwort erhält. Dort fügst du das Modul aus dem 2. Schritt ein. Auf der zugehörigen Bestätigungsseite beschreibst du, dass man nun eine E-Mail erhält und den darin befindlichen Link anklicken soll.
4. Auf der Seite "Passwort zurücksetzen" beschreibst du, was ein sicheres Passwort ausmachst und fügst darunter das identische Modul ein. Auf der Bestätigungsseite reicht eine "alles ok" Meldung und ein Link zum Login.
5. Nun wird beim erzeugen der E-Mail mit dem Bestätigungslink immer noch auf /login/passwort-vergessen.html?token=xxx verlinkt. Hier bietet Contao keine Konfiguration an, daher erledigen wir das über eine Weiterleitung de Aufrufe mit dem Token in der .htaccess:
   # Rewrite for password reset
   RewriteCond %{QUERY_STRING} token=(.*) [NC]
   RewriteRule .*login\/passwort-vergessen.html$ /login/passwort-zuruecksetzen.html?token=%1 [L,R=301]
   Diese Zeilen musst du vor der allgemeinen Weiterleitungsregel von Contao einfügen und natürlich auf deine Seitennamen anpassen.

• passwort
• mitglied

Benötigt:

• Erweiterung inserttags

Anleitung:

1. Installiere die Erweiterung inserttags.
2. Im neuen Menüpunkt Platzhalter legst du nun zwei neue Einträge an, die jeweils folgende Einstellungen haben:
   - Platzhalter: "liebeanrede"
   - Beschreibung "Anrede als Liebe" bzw. "Anrede als Lieber"
   - Ersatz: "Liebe" bzw. "Lieber"
   - TinyMCE deaktivieren (anschließend die p-Tags aus dem Ersatz entfernen!)
   - Bedingung aktivieren
   - Abfragetyp: Text
   - Formel: gleich
   - Abfrage: { {user::gender} } (beim Kopieren die Leerzeichen entfernen!)
   - Wert: "Weiblich" bzw. "Männlich"
3. Wenn das Geschlecht bei den Mitgliedern auch leer sein kann, muss noch ein Fallback geschaffen werden. Dazu als dritten Insert-Tag anlegen:
   - Platzhalter: "liebeanrede"
   - Beschreibung "Anrede als Hallo"
   - Ersatz: "Hallo"
   - TinyMCE deaktivieren (anschließend die p-Tags aus dem Ersatz entfernen!)
   - Keine Bedingung aktivieren
4. Verwendet die Webseite mehrere Sprachen müssen die Einträge sprachspezifisch pro Sprache angelegt werden.
5. Nun kannst du das Insert-Tag { {custom::liebeanrede} } verwenden um die Anrede "Liebe" bei weiblichen Mitgliedern bzw. "Lieber" bei männlichen Mitgliedern zu erhalten. Nutze also beispielsweise { {custom::liebeanrede} } { {user::firstname} } (Auch hier die Leerzeichen entfernen, wenn ihr die Insert-Tags kopiert!)

• mitglied
• inserttag

Benötigt:

• Erweiterung ce-tracking
• Erweiterung zCheckCookie

Anleitung:

1. Installiere die Erweiterungen ce-tracking und zCheckCookie.
2. Erstelle eine Seitenstruktur mit drei Seiten: Der zu prüfenden Seite (hier: Gewinnspielformular), die Seite nach dem Durchführen der Aktion (hier: Teilnahmebestätigung) und eine Seite mit der entsprechenden Fehlermeldung. Alle Seiten müssen auf einer Hierarchieebene liegen, weil wir sonst einen Endlos-Loop von Weiterleitungen erzeugen. Hier ein Beispiel:
   
3. Füge nun zunächst in den Artikel der Bestätigungsseite ein neues Content-Element vom Typ "Tracking Cookie" ein. Verwende dabei einen eindeutigen einen eindeutigen Cookienamen, den Wert "1" und eine Laufzeit, die derjenigen der Aktion entspricht. Die Angabe ist in Sekunden, bei 7 Tagen also 60480 Sekunden (7*24*60*60). Da wir einen zweiten Aufruf dieser Seite ja gerade verhindern wollen, spielt die Option zum Überschreiben bestehender Cookies keine Rolle.
4. Editiere als nächstes die Seiteneinstellungen der Seite, die nur einmal durchgeführt werden darf. Unter "Zugriffsschutz" finden sich dort nun einige zusätzlichen Felder. Aktiviere "Weiterleiten wenn Cookie fehlt (bzw. vorhanden ist)" und "Weiterleiten wenn Cookie existiert". Trage nun den oben gesetzten Cookie-Name und den Wert "1" ein und wähle als "Weiterleitungsseite" die oben angelegte Fehlerseite.

Beim ersten Aufrufen der Seite ist nun alles in Ordnung: Der Cookie ist noch nicht gesetzt, es wird nicht weitergeleitet. Nach der Durchführung der Aktion wird auf der Bestätigungsseite der Cookie gesetzt. Bei einem zweiten Zugriff wird bei der Prüfung auf das Vorhandensein des Cookies dieses entdeckt und direkt auf die Fehlerseite weitergeleitet.

• gewinnspiel
• formular
• cookie

Hinweis: Die Umsetzung ist auch durch manuelle Anpassungen an dem Template moo_analytics und Einstellen und weiteres Pflegen des Datenschutzhinweises möglich. Ich denke aber, dass es auf diesem Weg doch einfacher geht. ;-)

Benötigt:

• Erweiterung googleanalytics ab Version 1.3.1 (in vorherigen Versionen steht der Insert-Tag nicht zur Verfügung!)

Anleitung:

1. Installiere die Erweiterung googleanalytics.
2. Lösche alle alten Daten deines Kontos, weil diese unrechtmäßig gesammelt worden sind. (Dazu musst du das alte löschen und ein neues anlegen.)
3. Wenn du bislang das Template moo_analytics zum Tracking verwendet hast, entferne dieses aus allen Seitenlayouts.
4. Öffne jeden Startpunkt einer Webseite in der Seitenstruktur und trage dort deine neue Analytics-ID ein. Aktiviere unbedingt die Option IP anonymisieren. Das aktiviert die in Deutschland nötige IP-Maskierungs-Funktion von Google Analytics.
5. Lege - wenn noch nicht vorhanden - eine Seite zu den Datenschutzhinweisen an (ähnlich dieser Seite). Verwendet dort das Insert-Tag { {ga::privacytext} }. Es enthält den jeweils aktuellen Text aus den Google Analytics Nutzungsbedinungen für Deutschland inklusive dem notwendigen Link auf die OptOut-Möglichkeit.
6. Fülle folgenden Vertrag aus und sende ihn an Google

ACHTUNG: Diese Anleitung basiert auf den aktuellen rechtlichen Einschätzungen anhand öffentlich zugänglicher Artikel. Er stellt keine Rechtsberatung dar. Der absolut rechtssichere Einsatz von Google Analytics kann auch bei der Einhaltung aller hier von mir beschriebener Schritte nicht garantiert werden! Der Autor dieses Artikels schließt daher grundsätzlich jegliche Haftung in Zusammenhang mit dieser Anleitung aus!

• googleanalytics
• google
• datenschutz

Benötigt:

• PHP-Kenntnisse

Anleitung:

Über das Contao-Framework

Innerhalb des Contao-Frameworks beschreibt Glen in seiner Anleitung eine einfach und elegante Möglichkeit:

if (in_array('XYZ', $this->Config->getActiveModules()))
{
  // Code wenn Erweiterung vorhanden und aktiviert ist
}
else
{
  // Code wenn Erweiterung nicht vorhanden bzw. deaktiviert ist
}

Der Nachteil dieser Methode besteht lediglich darin, dass sie nur funktioniert, wenn $this bereits entsprechend vorhanden ist. Möchte man die Abfrage beispielsweise bereits in der DCA vornehmen, ist dies nicht möglich.

Über einen Dateizugriff

An solchen Stellen verwende ich die Prüfung, ob eine Datei existiert und über die Konfiguration, ob die Erweiterung deaktiviert ist - hier am Beispiel der Erweiterung "xtmembers":

if ((!file_exists(TL_ROOT . '/system/modules/xtmembers/dca/tl_member.php')) || (in_array("xtmembers", deserialize($GLOBALS['TL_CONFIG']['inactiveModules']))))
{
  // Code wenn Erweiterung installiert ist
} 
else
{
  // Code wenn Erweiterung nicht installiert ist
}

Auch diese Methode hat einen Nachteil: Der Dateizugriff dauert natürlich länger, so dass die erste Variante aus Performance-Gründe zu bevorzugen ist.

• php
• erweiterung

Benötigt:

• Einige der folgenden Punkte stehen erst ab Contao 2.10 zur Verfügung und sind entsprechend markiert
• Erweiterung holygrail

Anleitung:

CSS-Dateien zusammenfassen (nur bis Contao 2.9.5)

Für alle Layouts unter "Stylesheets" die Option "Stylesheets zusammenfassen" aktivieren. Dadurch werden alle CSS-Dateien in einer einzigen Datei zusammengefasst und als solche dem Webbrowser zur Verfügung gestellt. (Aber Version 2.10 wird dies automatisch durchgeführt.)

CSS-Dateien komprimieren (ab Contao 2.10)

In den Einstellungen gibt es unter "Globale Einstellungen" ab Contao 2.10 die Option "Skripte komprimieren". Dabei werden alle unnötigen Zeichen (z.B. Kommentare, Leerzeichen und Zeilenumbrüche) aus CSS- und Javascript-Dateien entfernt. Dadruch werden die Dateien teilweise deutlich kleiner.

Allerdings kann dies zu Fehlern bei Javascript-Code führen, daher sollte nach dem Aktivieren der Option geprüft werden, ob genutzte Javascript-Funktionen noch alle funktionieren.

Zusätzlichen Aufruf von contao.css und Inline-CSS entfernen

1. Installiere die Erweiterung holygrail.
2. Kopiere die CSS-Datei /system/modules/holygrail/html/holygrail.css nach tl_files.
3. Öffne den Seitenquelltext und kopiere dort das von Contao erzeugte Inline-CSS heraus. (Deaktiviere dazu die Markup-Komprimieurng in den Einstellungen oder nutze Tools wie Firebug. Das macht das Kopieren leichter.) Speichere dieses als tl_files/inline.css. Wiederhole diesen Vorgang mit anderen Dateinamen für jede alternative Einstellung von Spaltenbreiten und/oder Kopf- bzw. Fußzeilenhöhe.
4. Importiere die holygrail.css und inline.css (und ggf. weitere CSS-Dateien) in die CSS-Einstellungen jedes Themes.
5. Lösche die Dateien unter tl_files wieder.
6. Füge in allen Seitenlayouts die neue CSS-Datei holygrail überall als erste Datei hinzu. Als zweite Datei fügst du überall die passende inline-Variante hinzu. Zusätzlich aktivierst du unter "Experten Einstellungen" im Seitenlayout die Optionen "CSS nicht einbinden" und "Inline-CSS nicht einbinden".

Bei Updates ist nun ggf. die holygrail.css neu zu importieren, wenn sich diese geändert hat. Beim Ändern von Spalte-Breiten bzw. der Höhe von Kopf- oder Fußzeilen muss die Ersetzung des Inline-CSS entsprechend angepasst werden.

• optimierung
• geschwindigkeit
• css

Benötigt:

• Erweiterung browsercss (bis Contao 2.9, ab Version 2.10 im Core vorhanden)

Anleitung:

1. Installiere die Erweiterung browsercss wenn du eine Contao bis Version 2.9 einsetzt. (Ab 2.10 stehen die zusätzlichen Body-Klassen im Core zur Verfügung.)
2. Lege eine neue CSS-Anweisung an, die nur für das Hintergrundbild genutzt wird. Nutze für diese den Selektor "body:not(.mobile)", also beispielsweise folgenden Code:
   body:not(.mobile)
   {
     background-color:#f0f0f0;
     background-image:url("tl_files/foo/bar.jpg");
     background-repeat:no-repeat;
   }
3. Da es sich um einen CSS3-Selektor handelt, versteht der Internet Explorer die Anweisung leider in älteren Versionen nicht. Daher muss dieser CSS-Block nochmals kopiere werden und den Selektor "body.ie" erhalten.
4. Führe diese Schritte für jedes Layout aus, wenn du mehrere Layouts nutzt.

• mobile
• css

Benötigt:

• Erweiterung googleplus1

Anleitung:

1. Installiere die Erweiterung googleplus1.
2. Öffne die Einstellungen und trag dort unter "Google+1 Einstellungen" die gewünschte Sprache ein. Aktiviere zudem die Checkbox "Initialisierung immer hinzufügen".
3. Lege ein neues Modul vom Typ "Google+1 Knopf" an. Wähle dir Größe "klein" damit der Button zu den anderen passt und nach Wunsch die Zählereinstellung. Merke dir die ID des angelegten Moduls. (Diese wird bei Editieren des Moduls ganz oben angezeigt als "Datensatz ID xx bearbeiten".)
4. Falls noch nicht vorhanden, lege eine Kopie des Templates mod_article an.
5. Editiere das Template mod_article und füge folgende neue rot markierte Zeile an der gezeigten Stellen ein. Ersetze dabei XX mit der oben gemerkten Id des Moduls und entferne die Leerzeichen von der insert_module-Anweisung.
   <?php if ($this->twitterButton): ?>
     <a href="http://www.contao-anleitungen.de/share.php?p=twitter^[...]></a>
   <?php endif; ?>
   { { insert_module::XX } }
   </div>
6. Jetzt wird der Google+1 Button bereits angezeigt, befindet sich aber noch in einer Zeile unterhalb der anderen Buttons. Je nach CSS für den Rest der Seite sollte in derRegel folgende CSS-Einstellung den Button in die selbe Zeile "heben":
   Selektor: ".mod_googleplus1button"
   Eigenschaft: "display:inline;"
7. Führe die Schritte 3 bis 6 für jedes Theme aus, wenn du mehrere Themes verwendest.

• google+
• google

Benötigt:

• Erweiterung ce-tracking
• Erweiterung redirect

Anleitung:

Diese Anleitung kann nicht nur für den Internet Explorer 6 sondern auch für zahlreiche andere Browser vorgenommen werden.

1. Installieren Sie die Erweiterungen ce-tracking und redirect.
2. Erstellen Sie ein spezielles Seitenlayout, welches nur für die Hinweisseite verwendet wird. Zumindest dieses sollte der IE6 ordentlich anzeigen können.
3. Legen Sie eine Hinweisseite für Nutzer des Internetexplorer (z.B. mit dem Alias „ie6“) und eine zweite Seite an die nach dem Hinweis aufgerufen wird (z.B. mit dem Alias “ie6bestaetigung”). Stellen Sie bei beiden Seiten das soeben angelegte Seitenlayout ein. Die Seite sollte nicht über Suchmaschinen zu finden sein, weshalb Sie auch noch die folgenden Einstellungen vergeben sollten: Robots-Tag: „noindex,follow“, „Nicht durchsuchen“, „Im Menü verstecken“ und „In der Sitemap anzeigen“ auf „nie anzeigen“. (Weitere Werte je nach installierten Erweiterungen.)
   
4. Legen Sie auf der Hinweisseite einen entsprechenden Hinweistext an, warum Sie den Internet Explorer 6 nicht mehr unterstützen. Fügen Sie am Ende einen Bestätigungslink ein, den Sie mit der Bestätigungsseite verknüpfen. (Beispiel für eine solche Seite.)
5. Fügen Sie der Bestätigungsseite ein neues Content-Element vom Typ „Tracking Cookie“ hinzu. Dieses definiert einen Cookiename, dessen Wert und seine Laufzeit. Verwenden Sie eine sehr lange Laufzeit (die Angabe ist in Sekunden), einen Namen wie “ie6accept” und einen Wert wie “true”. Leiten Sie zudem auf Ihre Startseite weiter.
   
6. Damit steht die Hinweis- und Bestätigungsseite. Nun müssen noch alle Zugriffe mit dem Internet Explorer 6 dorthin weitergeleitet werden.
   Dazu legen wir ein neues Modul an. Dieses benennen Sie enstprechend (z.B. „Browser: Redirect IEX 6“) und wählen den Typ „Weiterleitung bestimmter Browser“ aus. Tragen Sie dann in der Modulkonfiguration den weiterzuleitenden Browser sowie dessen Version ein und schließen Sie Borowser mit dem soeben definierten Cookie aus. Schließlich wählen Sie noch als Weiterleitungsziel in Schritt 2 angelegte Hinweisseite.
   
7. Weisen Sie dieses neue Modul allen Seitenlayouts bis auf das oben angelegte Seitenlayout für die Hinweisseite zu.
8. Ab sofort werden alle Zugriffe des Internet Epxlorer 6 auf die Hinweisseite geleitet. Wird auf dieser einmal der Hinweis angeklickt, wird ein Cookie gesetzt und die Seite diesem Besucher auf diesem Browser nicht mehr angezeigt.

Testen:

Zum Test der Weiterleitung wird der weiterzuleitende Browser benötigt. Alternativ kann mit dem Firefox-Plugin User Agent Switcher ein alternativer Browser simuliert werden.

• redirect
• internet explorer

Benötigt:

• Erweiterung inputvar

Anleitung:

WICHTIG: Bitte bei den Insert-Tags die Leerzeichen zwischen den beiden geschweiften Klammern entfernen.

1. Installieren Sie die Erweiterung inputvar.
2. Öffnen Sie in dem zuvor angelegten Kontaktformular die Felder die vorbelegt werden können sollen. Tragen Sie dort unter Experten-Einstellungen/Standard-Wert ein: { {get::feldname} } (Wenn dieses Feld nicht vorhanden ist, siehe Beschreibung des Sonderfalls unten.) Dabei ist "feldname" eine eindeutige Bezeichnung des Feldes, die keine Sonderzeichen enthalten darf.
   In dem folgenden Beispiel gehen wir davon aus, dass es zwei solche Felder gibt: "ansprechpartner" und "thema".
3. Öffnen Sie nun in dem Artikel, aus dem Sie auf ein vorbelegtes Kontaktformular verlinken möchten, das entsprechende Content-Element. Erstellen Sie im Text-Editor einen ganz normalen Link auf die Kontaktformular-Seite.
4. Wechseln Sie in die HTML-Ansicht des Editors und suchen Sie dort den Link. Er sieht etwa so aus: <a href="http://www.contao-anleitungen.de/{ {link_url::XXX} }"> (Dabei ist XXX die Contao-Id der Seite.)
5. Diesen Link können Sie nun um soegenannte GET-Parameter ergänzen. Diese werden jeweils als "feldname=wert" angefügt. Der Wert darf dabei keine Sonderzeichen enthalten, auch keine Leerzeichen.
   Sollten Sie Sonderzeichen benötigen, muss der Text beispielsweise hier mittels urlencode "kodiert" werden. Aus "Manfred Müller" wird dabei beispielsweise "Manfred+M%FCller".
   Die erste Angabe wird am Ende der URL angehängt und durch ein ? angetrennt, die weiteren Angaben durch ein &.
   Beispiel mit einem Parameter:
   <a href="http://www.contao-anleitungen.de/{ {link_url::XXX} }?ansprechpartner=Manfred+M%FCller">
   Beispiel mit zwei Parametern:
   <a href="http://www.contao-anleitungen.de/{ {link_url::XXX} }?ansprechpartner=Zentrale&thema=Test">
6. Wechseln Sie zurück in die normale Ansicht und speichern Sie ihre Anpassungen.

Externe Aufrufe

Auch bei externen Aufrufen kann das Formular über GET-Parameter vorbelegt werden. Diese müssen wie oben beschrieben an die ganz normale URL angehängt werden. Beispiel:
http://www.firmenbezeichnung.de/kontakt.html?ansprechpartner=Zentrale&thema=Test

Sonderfall: Felder ohne Default-Wert

Einige Feldtypen haben in Contao keine Einstellung für den Default-Wert. In diesem Fall die Anleitung von oben bis auf Schritt 2 durchführen und statt dessen:

1. Ein neues Modul vom Typ "Eigener HTML-Code" anlegen.
2. Dort folgen JavaScript-Code eintragen:
   <script type="text/javascript"><!--
   document.getElementById("ctrl_XX").value = { {get::feldname} };
   --></script>
   Dabei muss "ctrl_XX" durch die HTML-Id des Feldes und "feldname" durch den Feldname für den Get-Parameter (wie oben beschreiben) ersetzt werden.
   Sollen mehrere derartige Felder vorbelegt werden, die mittlere Zeile für jedes Feld eintragen.
3. Dieses neue Modul nach dem Formular einfügen.

• vorbelegen
• url
• get
• formular

Also müssen Sie in einem Template je nach Sprache des Betrachters unterschiedliche Inhalte ausgeben können. Das kann Contao, es gibt sogar drei Möglichkeiten dafür.

In den folgenden Beispielen gehen wir von einer Tabelle aus, die sprachabhängige Spaltenüberschriften erhalten soll.

Für alle drei Methoden gilt: Die Sprache richtet sich nicht unbedingt nach der Browsersprache des Benutzers, sondern stets und bei allen drei Methoden nach der Einstellung der Seite in der Seitenstruktur.

Wenn Ihr Benutzer je nach Browsersprache unterschiedliche Inhalte sehen soll, müssen Sie für verschiedene Sprachen verschiedene Startpunkte anlegen, und komplett eingene Seitenbäume betreiben.

Inserttag

Contao stellt das Inserttag {­{iflng}} zur Verfügung. Über die Ergänzung durch ein Sprachkürzel funktioniert das beispielsweise so: {­{iflng::de}}Hallo Welt!{­{iflng}}{­{iflng::en}}Hello World!{­{iflng}}. Wenn die Sprache nun Englisch ist, wird nur „Hello World!“ ausgeben, bei Deutsch ensprechend „Hallo Welt!“.

Auf die Tabelle bezogen sieht das etwa so aus:

<table>
<thead>
<tr>
<th>{­{iflng::en}}Heading 1{­{iflng}}{­{iflng::de}}Überschrift 1{­{iflng}}</th>
<th>{­{iflng::en}}Heading 2{­{iflng}}{­{iflng::de}}Überschrift 2{­{iflng}}</th>
</tr>
…

Logik im Template

Für umfangreichere sprachabhängige Bereiche kann das Inserttag ungünstig sein, reines PHP wäre vielleicht geschickter. Wer also mit if und else, oder break und case arbeiten möchte, kann im Template auch so auf die Sprache zugreifen: <?php echo $GLOBALS['TL_LANGUAGE']; ?>.

Auf die Tabelle bezogen könnte das so aussehen:

<table>
<thead>
<tr>
<?php if($GLOBALS['TL_LANGUAGE'] == 'en'): ?>
<th>Heading 1</th>
<th>Heading 2</th>
<?php elseif($GLOBALS['TL_LANGUAGE'] == 'de'): ?>
<th>Überschrift 1</th>
<th>Überschrift 2</th>
<?php endif; ?>
</tr>
…

Globale Labels

Manchmal bietet es sich an, die sprachabhängigen Inhalte auch auszulagern, damit sie global verfügbar sind, oder damit das Template nicht zu voll wird. Außerdem hilft es, Logik im Template zu reduzieren.

Dafür gibt es in Contao die Datei system/config/langconfig. Ähnlich wie ihre Schwestern localconfig.php und dcaconfig.php wird sie bei Updates nicht überschrieben, und kann somit sicher angepasst werden. In dieser Datei kann für jede Sprache eine „Beschriftung“ definiert werden, die im Template ausgelesen wird.

Eine solchermaßen angepasste Datei könnte so aussehen:

if ($GLOBALS['TL_LANGUAGE'] == 'de')
{
	$GLOBALS['TL_LANG']['meinetabelle']['spalte1'] = 'Deutsches Label';
}
elseif ($GLOBALS['TL_LANGUAGE'] == 'en')
{
	$GLOBALS['TL_LANG']['meinetabelle']['spalte1'] = 'Englisches Label';
}
else
{
	$GLOBALS['TL_LANG']['meinetabelle']['spalte1'] = 'Fallback-Label';
}

In jedem beliebigen Template kann nun auf das Label zugegrifften werden, was tatsächlich ausgegeben wird, entscheidet sich in der langconfig.php.

<table>
<thead>
<tr>
<th><?php echo $GLOBALS['TL_LANG']['meinetabelle']['spalte1']; ?></th>
… 

Dabei kann die Bezeichnung dieses Labels frei vergeben werden („meinetaballe“ und „spalte1“). Verwenden Sie dabei statt „meinetabelle“ möglichst eine projektbezogene Bezeichnung. Dadurch schließen Sie Namenskonflikte mit installierten Modulen oder ähnlichem aus.

meinetabelle

• template
• sprache
• inhalt
• content
• abhängigkeit

Der erste Punkt ist, dass im Quellcode der Seite weiterhin der eigene XML-Feed verlinkt wird. Ein RSS-Reader wird also weiterhin diesen verwenden statt den von Feedburner. Auch bestehende Abonnenten werden weiterhin Ihren Feed verwenden und nicht in den Statistiken von Feedburner auftauchen. Zum anderen empfiehlt sich, nicht offiziell den Feedburner-Feed zu veröffentlichen sondern immer den eigenen Feed und diesen auf Feedburner umzuleiten. Das hat den Vorteil, dass man später von Feedburner zu einem anderen Dienst wechseln kann, ohne das sich die Feed-URL ändet.

Diese Anleitung beschreibt, wie man Feedburner nutzt und dennoch mit der eigenen Feed-URL arbeitet.

Benötigt:

• Zugriff auf die .htaccess-Datei im Root-Verzeichnis von Contao
• Ein Google-Konto

Anleitung:

1. Aktivieren Sie den Feed für Ihr Nachrichtenarchiv in Contao – Es können auch mehrere sein.
2. Melden Sie sich mit Ihrem Google-Account bei Feedburner an.
3. Richten Sie für jeden Ihrer Feeds einen neuen Feed bei Feedburner ein, und geben Sie dort die URL Ihres von Contao generierten Feeds an.
4. Leiten Sie in Ihrer .htaccess-Datei alle Aufrufe des alten Feeds auf Feedburner um. Wichtig dabei ist, dass Feedburner selbst den originalen Feed abrufen kann. Also muss Feedburner von der Umleitung ausgenommen werden. Das geht mit folgendem Code in der .htaccess, der nach der Zeile mit der RewriteBase-Anweisung eingefügt werden muss. Pro Feed kopieren Sie die letzte Zeile und ändern "ihrfeed" und "feedname" entsprechen den URLs des Feeds ab.
   

   # FeedBurner XML Rewrite
   RewriteCond %{HTTP_USER_AGENT} !FeedBurner
   RewriteRule ihrfeed.xml$ http://feeds.feedburner.com/feedname [R=302,L]

5. Nutzen Sie die Statistiken von Feedburner.

• statistik
• rss
• google
• feedburner
• feed

Profihinweis: Die Seite ist bis TYPOlight 2.8.x auch über http://www.firmenbezeichnung.de/index.php erreichbar, das hat sich jedoch mit Contao 2.9.0 geändert.

Benötigt:

• Erweiterung googlesitemap
• Zugriff auf die Seitenstruktur

Anleitung:

1. Installieren Sie die Erweiterung googlesitemap.
2. Bearbeiten Sie die Startseite Ihrer Website in der Seitenstruktur.
3. Setzen Sie den Haken beim Feld "Erste Seite".
4. Nun werden alle Links innerhalb Ihrer Website, die auf die Startseite verlinken, mit dem Linkziel http://www.firmenbezeichnung.de/ ohne angehängten Seitenalias und Suffix generiert

Achtung! Diese Maßnahme ändert nichts an der Erreichbarkeit der Startseite unter mehreren Adressen, aber wenn Sie dieser Anleitung von Beginn an folgen, ist eine Aufnahme der alternativen Schreibweisen in den Google-Index sehr unwahrwscheinlich, da diese nirgends auftauchen.

• startseite
• start
• seo
• inhalt
• google
• erweiterung
• duplicate content
• dopplung
• doppelt
• content

Benötigt:

• Erweiterung backend_password (optional)
• Datenbankzugriff über phpMyAdmin (oder ähnliches Tool)

Anleitung:

1. Vergessene Administratorpasswörter lassen sich auf zwei Weisen zurücksetzen: Durch die klugerweise im Vorraus installierte Erweiterung backend_password, oder durch das Ändern des Passwortes in der Datenbank.
2. Ist die Erweiterung installiert, erscheint in der Login-Maske des Backends ein Link, über den sich jeder Benutzer ein neues Passwort per Mail zuschicken lassen kann. Das Passwort kann dann nach dem Anmeldevorgang mit dem Interims-Passwort über das Benutzerprofil wieder geändert werden.
3. Ist die Erweiterung nicht installiert, lässt sich das Passwort dennoch direkt über die Datenbank zurücksetzen. Öffnen Sie dazu phpMyAdmin.
4. Navigieren Sie zur Tabelle "tl_user" und bearbeiten Sie den Datensatz des Adminstrators.
5. Neben dem Feld "password" sollte über ein Select-Menü eine Verschlüsselung auswählbar sein. Ist dies nicht der Fall, überspringen Sie bitte diesen Punkt und fahren Sie mit Punkt 6 fort.
   Wählen Sie aus dem Select-Menü die Verschlüsselungsart "SHA1" aus, und geben Sie in das Feld rechts daneben ihr gewünschtes neues Passwort ein.
6. Sollte Ihnen das Select-Menü nicht zu Verfügung stehen, tragen Sie "8e0107bf1c7fbeef6538dff7173aa458e7dd585e:8c37627a0e2c606189e7765" in das Feld ein. Dadurch wird Ihr Passwort auf "reset123" zurückgesetzt.
7. Sollten Sie durch zu viele Login-Versuche auch Ihr Backend-Konto gesperrt haben, können Sie die Wartezeit von fünf Minuten reduzieren. Suchen Sie dazu das Feld "loginCount" und setzen Sie den Inhalt auf "3". Das Feld "locked" darunter leeren Sie bitte.
8. Klicken Sie unten auf "OK". Ihr Passwort sollte nun zurückgesetzt sein, ihr Konto entsperrt.

Anwendungsbeispiele:

• Zu häufig eingegebenes falsches Backend-Passwort
• Vergessenes Administrator-Passwort

• vergessen
• phpmyadmin
• passwort
• erweiterung
• datenbank
• benutzer
• administrator

Einige Hinweise für alle, die den Vortrag nicht live erlebt haben:

• Es sind zahlreiche Erweiterungen im Vortrag enthalten, die sich am Besucher orientieren. Denn die Erstellung von Seiten für Seitenbesucher statt Suchmaschinen ist oft die beste Suchmaschinenoptimierung.
• Selbst wenn du alle vorgestellten Contao-Erweiterungen installierst, ist das noch kein SEO sondern nur eine Sammlung von Modulen. Sie müssen sinnvoll eingesetzt werden.
• Nicht jede Erweiterung ist für jede Webseite geeignet. Stimmt euch mit jemandem ab, der sich mit Suchmaschinenoptimieurng beschäftigt.
• Die Module sind Stand 15.5.2010 zusammengestellt und teilweise noch im Alpha- oder Beta-Stadium.
• Danke auch an Guido Pelzer für den vorangehenden Vortrag zu SEO allgemein.

• seo
• erweiterung

Benötigt:

• Erweiterung Favicon (optional)

Anleitung:

1. Bei Contao-Installationen, die ursprünglich mit einer Version vor TYPOlight 2.8.3 installiert worden sind, sind in der Standardkonfiguration keine ICO-Dateien zum Upload in der Dateiverwaltung zugelassen. In diesem Fall muss in den Einstellungen die Endung "ico" in die Liste der erlaubten Upload-Dateitypen aufgenommen werden.
2. Eine geeignete Icon-Datei erstellen. Dabei handelt es sich um eine Pixelgrafik im Format 16x16 Pixel anlegen und als Icon-Datei speichern. Wenn keine Anwendung hierzu vorhanden ist, kann beispielsweise diese Onlinekonvertierung genutzt werden. Die Datei favicon.ico benennen.
3. Die fertige favicon.ico über die Dateiverwaltung hochladen.
4. Einbindung ohne Favicon-Erweiterung: Entweder die Erweiterung über die Erweiterungsverwaltung installieren und mit folgendem Punkt fortfahren. Alternativ in allen betroffenen Seitenlayouts unter "Zusätzliche <head>-Tags" folgende Zeilen eintragen und dabei den Pfad zur Datei anpassen:
5. <link rel="icon" href="http://www.contao-anleitungen.de/tl_files/pfad/favicon.ico" type="image/vnd.microsoft.icon" />
6. <link rel="shortcut icon" href="http://www.contao-anleitungen.de/tl_files/pfad/favicon.ico" type="image/vnd.microsoft.icon" />
7. Einbinden mit Favicon-Erweiterung: In der Seitenstruktur im "Startpunkt einer neuen Webseite" unter Favicon die entsprechende Datei auswählen. Diese wird nun in alle Seiten der Webseite integriert.
8. Den Browser-Cache leeren und die Seite neu laden.

Anwendungsbeispiele:

• Ein Favicon in bestehende oder neue Contao-Webseiten einfügen

• icon
• favicon
• erweiterung

Benötigt:

• Erweiterung folderurl
• Webserver mit Rewrite-Unterstützung in der .htaccess

Anleitung:

Der einfachste Weg zum Betrieb von Contao (vormals TYPOlight) neben einem andern System ist es natürlich, dieses in einen Unterorder zu installieren. In diesem Fall kann eine ganz normale Installation vorgenommen werden und alle von Contao (vormals TYPOlight) bedienten URLs haben anschließend den Namen des Unterorders vorne anstehen. Das kann aber unerwünscht sein, insbesondere bei einer sanften Migration wobei bestehende URLs weitergeführt werden sollen. Außerdem liegt die Installation für einen vollständigen Wechsel bereits an der richtigen Stelle.

Hier ist eine Anleitung zur vollständigen Integration auch was die URLs angeht.

1. Erstelle ein Backup der bestehenden Webseite!
2. Entpacke die aktuelle Version von Contao (vormals TYPOlight).
3. Prüfe ob sich Unterordner (etwas "system") mit der bestehenden Installation überschneiden. Wenn ja prüfe ob sich darin gleichnamige Unterverzeichnisse oder Dateien befinden. In diesem Fall wäre die Installation in ein Unterverzeichnis (siehe oben) der einfacherer Weg.
4. Prüfe, ob es bereits eine index.php gibt. Wenn ja, benennen die von Contao (vormals TYPOlight) nach index_tl.php um.
5. Prüfe, ob es bereits eine cron.php gibt. Wenn ja, benenne diese nach cron_tl.php um und passe später das fe_page.tpl-Template entsprechend an oder lösche die Datei und nutze statt dessen echte Cronjobs.
6. Lade deine Installation ohne die .htaccess Datei auf deinen Webspace.
7. Durchlaufe die Contao-Installation wie gewohnt.
8. Lege deine neuen Seiten an. Wichtig: Gliedere diese so, dass sie an der URL eindeutig erkannt werden können. Am besten legst du sie in einigen Unterordnern ab. Dazu bietet sich das Modul folderurl an.
9. Aktiviere die Option "URLs umschreiben" in den Einstellungen.
10. Füge in deine .htaccess für jede URL, die umgeschrieben werden soll, folgende Zeile möglichst direkt nach der Anweisung "RewriteEngine on" ein. Fehlt diese, muss diese ergänzt werden.
    RewriteRule ^/(aktionen.*)$ /index.php/$1 [L]
    RewriteRule ^/(newsletter.*)$ /index.php/$1 [L]
    Hast du vorhin deine index.php in index_tl.php umbenannt, musst du hier natürlich die index_tl.php angeben.
11. Bei einer sanften Migration später nach und nach entsprechende Zeilen hinzufügen.

Anwendungsbeispiele:

• Paralleler Betrieb von Webseitenteilen zu einem anderen System in Contao (vormals TYPOlight).
• Sanfte Migration einer bestehenden Webseite nach Contao (vormals TYPOlight).

• installation
• htaccess

Benötigt:

Keine Voraussetzungen

Anleitung:

Je nachdem ob du per FTP arbeitest oder direkten Zugriff auf die Dateien hast, unterscheidet sich das Vorgehen minimal.

1. Lade per FTP die Datei "system/config/localconfig.php" aus deiner TYPOlight-Installation herunter. (Nur FTP.)
2. Lösche aus der localconfig.php nur die Zeile, die wie folgt beginnt:
   $GLOBALS['TL_CONFIG']['installPassword'] = ...
3. Lade die Datei wieder per FTP an die gleiche Stelle auf dem Server. (Nur per FTP.)
4. Rufe den TYPOlight-Installer unter <deine URL>/contao/install.php" auf.
5. Nun ist das Standardpasswort "contao" (früher "typolight") wie bei der Erstinstallation von Contao (vormals TYPOlight)gesetzt.
6. Setze ein neues Passwort und dokumentiere dies an einem sicheren Ort.

Anwendungsbeispiele:

• Installationspasswort vergessen
• Übernahme einer schlecht dokumentierten Contao-Installation

• zurücksetzen
• vergessen
• passwort
• installation

Oftmals ist es in Formularen sinnvoll, Bilder statt Text zur Beschreibung von Radiobuttons zu verwenden. Diese Anleitung beschreibt, wie mittels der Erweiterung efg in Contao (vormals TYPOlight) eine solche Bildauswahl als Formularfeld erzeugt werden kann.

Benötigt:

Anleitung:

Ein Formularfeld Bild­aus­wahl-Menü lässt sich mit der Er­weiterung Extended Form Generator (kurz: efg) ganz einfach er­stellen. Nach In­stallation der Er­weiterung steht im Formular­generator ein neuer Feldtyp „Bild-Auswahl-Menü“ zur Aus­wahl (sieht Bild).

1. Installiere das Modul efg falls dies noch nicht der Fall ist.
2. Lade die Bilder für die Bildauswahl über die Dateiverwaltung hoch. Dabei empfiehlt es sich ein eigenes Verzeichniss pro Bildauswahl anzulegen, um die Dateien später leichter zuordnen zu können.
3. Lege ein Formular an falls dieses noch nicht vorhanden ist.
4. Füge ein neues Feld vom Typ "Bild-Auswahl-Menü" ein.
5. Wähle die hochgeladenen Daten oder das Verzeichniss in dem sich die Dateien befinden in der Dateiauswahl aus.
6. Zusätzlich können weitere Bildeinstellungen wie sie zum Beispiel aus der Gallerie bekannt sind vorgenommen werden.

Anwendungsbeispiele:

• Auswahl von Designs
• Auswahl von Druckmotiven
• Auswahl von Produkten als Bilder

• formular
• efg
• bild

Als offizieller Contao-Partner treten bei uns im Betrieb immer wieder Aufgabenstellungen auf, die unserer Ansicht nach für viele Anwender interessant sind. Diese wollen wir versuchen als Anleitungen zum Open-Source-CMS Contao (vormals TYPOlight) zu veröffentlichen. Dabei werden wir keine Themenbereiche vollständig abdecken sondern immer nur gezielt einzelne Aufgabenstellungen herausgreifen und diese in einer Anleitung beschreiben.

Diese Seite soll eine Ergänzung zur offiziellen Contao-Webseite und der Contao-Community darstellen. Wir hoffen mit den hier vorgestellten Anleitungen die Verbreitung und Nutzung von Contao (vormals TYPOlight) nachhaltig zu fördern.

Contao-Anleitungen.de ist ein freies Angebot des ETES Systemhaus aus Stuttgart. Wir arbeiten seit Ende 2008 mit Contao (vormals TYPOlight) und sind offizieller Contao-Partner in den Bereichen Design, Entwicklung und Hosting.

• start