Feldname an Callback übergeben

2012-02-27T15:54:57Z

Althoffc:

[[category:Dev_Snippets]]
Wenn man viele Felder in einem Backend-Formular per load_callback oder save_callback manipulieren will, müsste man eigentlich für jedes Feld eine eigene Callback-Funktion schreiben. Wenn man aber in jedem Fall prinzipiell die selbe Manipulation vornimmt (z.B. die Daten statt aus der Datenbank woanders einzulesen), ist es sinnvoller, immer die selbe Funktion zu nutzen. Leider übergibt Contao diesem callback, aber nicht den Feldnamen.

Dank der PHP Methode "__call" kann man aber der Klasse diese Möglichkeit nachrüsten:

<source lang="php">
/**
* Automatic callback functions for every field
* loads or saves the values
*/
public function __call($name,$args) {
list($type,$field) = explode('_',$name,2);
switch($type) {
case 'load':
return $this->load_field($field,$args[0]);
break;
case 'save':
return $this->save_field($field,$args[0]);
}
}
</source>

Die Methoden "load_field" und "save_field" bekommen nun als ersten Parameter den Feldnamen übergeben. Man muss nur dafür sorgen, dass das callback der Felder der Form load_''feldname'' bzw. save_''feldname'' folgt.

Wenn man z.B. allen Feldern der Tabelle tl_page ein callback mitgeben will, kann man es so machen:

<source lang="php">
foreach ($GLOBALS['TL_DCA']['tl_page']['fields'] as $strFieldName => $arrField)
{
$GLOBALS['TL_DCA']['tl_page']['fields'][$strFieldName]['load_callback'][] = array('DMAPublishCallback','load_'.$strFieldName);
$GLOBALS['TL_DCA']['tl_page']['fields'][$strFieldName]['save_callback'][] = array('DMAPublishCallback','save_'.$strFieldName);
}
</source>

Die erste Webseite - Mehrsprachig

2012-02-27T15:45:22Z

Althoffc: /* Ergebnis */

[[Category: Erste_Schritte]]
{{AppliesTo|Version=ab 2.9}}
=Einleitung=
Diese Anleitung zeigt, wie man mit Contao eine mehrsprachige Webseite erstellt. Es wird hierfür ausschliesslich die Corefunktionalität verwendet.

Das Ziel dieser Anleitung ist:
*Das Erstellen einer Webseite in Deutsch und in Englisch. Webseiten-Besucher mit einem deutschen Browser sollen auf die deutsche Webseite geleitet werden; Besucher mit einem englischen Browser oder IRGENDEINEN anderessprachigen Browser sollen auf die englische Webseite geleitet werden.

In dieser Anleitung werden:
*2 Seitenbäume erstellt: Eine für die deutsche Webseite, eine für die englische.

{{c2g
|tut1=http://www.contao2go.org/pakete-uebersicht/items/die-erste-webseite-mehrsprachig.html
}}

=Voraussetzung=
Diese Anleitung baut auf der Anleitung [[Die_erste_Webseite|Die erste Webseite]] auf.

=Vorbereitung=
Bevor man mit der eigentlichen Arbeit beginnt, ist eine kleine "kosmetische Anpassung" erforderlich, welche die Übersichtlichkeit erhöht:<br />
Aktuell sieht die Seitenstruktur so aus:

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

Nun bearbeitet man den ''Startpunkt der Webseite'' (bei dem erster Eintrag "My First Site" auf den Bleistift-Button klicken) und benennt ihn mit deutschen Bezeichnungen.

[[Datei:firstsite_multilang-startpointfix.png|Umbenennung in deutsche Bezeichnungen|frame|center]]

Anschliessend speichert und schliesst man. Nun sollte die Seitenstruktur so aussehen:

[[Datei:firstsite_multilang-sitestructurefix.png|Seitenstruktur nach der Anpassung|frame|center]]

=Funktionsbeschreibung=
Aktuell existiert eine Webseite in Deutsch. Im ''Startpunkt der Webseite'' wurde im Abschnitt ''DNS-Einstellungen'' unter Sprache ''de'' für Deutsch und ein Haken bei ''Sprachen-Fallback'' gesetzt. Durch diese Einstellungen werden ALLE Besucher auf diese Seite geleitet, egal welche Sprache sie eingestellt haben.

[[Datei:firstsite_multilang-dns.png|DNS-Einstellung|frame|center]]

'''Nun, was bedeuten diese Einstellungen?'''<br />
Die im Feld ''Sprache'' gesetzte Sprache definiert, in welcher Sprache die Webseite verfasst ist. Wird die Webseite nun durch einen Besucher aufgerufen, liest Contao die Sprache des Browsers aus und vergleicht sie mit der im Feld ''Sprache'' gesetzten Sprache. Stimmen die Sprachen überein, wird diese Webseite ausgegeben. Stimmt sie nicht überein, erhält der Besucher einen Fehlermeldung ''404 - Seite nicht gefunden''.

Hier kommt jetzt die Einstellung ''Sprachen-Fallback'' ins Spiel: Wird bei dieser Einstellung ein Haken gesetzt, wird diese Seite ausgegeben, sollte keine der verfügbaren Webseiten in der Sprache des Benutzers vorhanden sein. Somit wird verhindert, dass der Besucher die Fehlermeldung ''404 - Seite nicht vorhanden'' bekommt. Es sollte mindestens eine Sprache einer Webseite einen Fallback bekommen.

Legt man diese Erkenntnis nun auf die in der [[#Einleitung|Einleitung]] aufgeführten Vorgabe um, bedeutet dies:
*Man benötigt eine Webseite in Deutsch (ohne Fallback)
*Man benötigt eine Webseite in Englisch (mit Fallback)

=Anpassen der existierenden Seite=
Da die deutsche Seite ja schon existiert, besteht die einzige Aufgabe bei dieser nur darin, die richtigen Spracheinstellungen zu setzen. Dazu bearbeitet man wieder den ''Startpunkt der Webseite'' und setzt beim Abschnitt ''DNS-Einstellungen'' die Sprache auf ''de'' (sollte schon gesetzt sein) und entfernt den Haken bei ''Sprachen-Fallback''. Anschliessend speichert und schliesst man.

[[Datei:firstsite_multilang-dednssettings.png|Spracheinstellung der deutschen Webseite|frame|center]]

=Erstellen der neuen Seite=
Die englische Seite muss komplett neu erstellt werden. Im Prinzip funktioniert dies genau gleich wie bei der deutschen Seite. Es muss nur auf die richtige "Verschachtelung" geachtet werden. Der Startpunkt der englischen Seite muss UNTERHALB der existierenden Seite eingefügt werden, NICHT INNERHALB. Die einzelnen Seiten der englischen Seite müssen INNERHALB des englischen Startpunktes sein.<br />
Da hier immer wieder Fehler gemacht werden, nochmal die grafische Darstellung:<br />
Seitenstruktur beider Seiten aufgeklappt:

[[Datei:firstsite_multilang-sitestructureall.png|Seitenstruktur beider Seiten aufgeklappt|frame|center]]

Seitenstruktur beider Seiten (Startpunkte zugeklappt):

[[Datei:firstsite_multilang-sitestructureminimized.png|Seitenstruktur bei zugeklappen Startpunkten|frame|center]]

Und noch einmal mit Textdarstellung:

<source lang="text">
- Startpunkt deutsche Webseite
---- Startseite
---- Über Mich
---- Meine Eltern
-------- Mein Vater
-------- Meine Mutter
---- Impressum / Kontakt
- Startpunkt englische Webseite
---- Home
---- About Me
---- My Parents
-------- My Father
-------- My Mother
---- Imprint / Contact
</source>

Im Startpunkt der englischen Webseite muss im Abschnitt ''DNS-Einstellungen'' bei Sprache ''en'' und ein Haken bei ''Sprachen-Fallback'' gesetzt werden. Anschliessend speichert und schliesst man.

[[Datei:firstsite_multilang-endnssettings.png|Spracheinstellungen bei im englischen Startpunkt|frame|center]]

=Artikel=
Abschliessend müssen wie in der deutschen Seite auch die Artikel in der englischen Seite [[Die_erste_Webseite#Artikel|erstellt]] werden.

=Ergebnis=
Alle Aufgaben wurden erfüllt. Ruft man nun die Startseite mit einem deutschen Browser auf, kommt die deutsche Webseite.

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

Ruft man die Startseite mit einem englischen Browser oder einen Browser in irgendeiner anderen Sprache auf, wird die englische Webseite ausgegeben.

[[Datei:firstsite_multilang-englishsite.png|Die englische Webseite|frame|center]]

=Hinweis zum Testen=
Einige Internet-Browser (z.B. Firefox) verwalten eine "Vorzugsliste" der vorrangig anzuzeigenden Sprachen.
Beim Testen gerade des Sprachen-Fallbacks darauf achten, dass in dieser "Vorzugsliste" des Browsers keine der in der Homepage umgesetzten Sprachen enthalten ist.
Sobald eine der Sprachen aus der "Vorzugsliste" in der Homepage enthalten ist, kommt der Sprachen-Fallback nicht zum Tragen.

Contao Community Documentation - Benutzerbeiträge [de]

Feldname an Callback übergeben

Die erste Webseite - Mehrsprachig