ProcessWire - Multilanguage Website

Mehrsprachige Websites mit ProcessWire / Andere Default Sprache

Links

• https://processwire.com/talk/topic/5518-multi-language-site/
• http://processwire.com/api/multi-language-support/multi-language-urls/
• https://processwire.com/talk/topic/9322-change-default-language-for-homepage/ (Modul Solution, mehr zur Anschauung)

Einleitung

Es gibt mehrere Bereiche an die man denken muss:

• Wie übersetze ich Text in meinen Templates ? Siehe unten i18n
• Wie übersetze ich Inhalte im Backend ? Dafür ist das Modul Language Support Fields zuständig
• Wie sollen meine URLs aussehen ? Prinzipiell kann man jedem User unterschiedliche Sprachen auch ohne andere Domain liefern (über seine Session) aber i.d.R wollen wir die URL anzupassen.
  • domain.de/en/meineSeite oder domain.de/myPage
  • Um Seitennamen zu übersetzen oder ein Domainkürzel in der URL voranzustellen benötige ich das Modul Language Support Page Names

Deutsch als Default Sprache

Wenn nur die Standardsprache verändert wird aber die Seite einsprachig bleibt brauchen wir nur das Modul Language Support

• Enable languages support -> Core Module "Language Support" aktivieren. -> Languages stehen im Backend Setup zur Verfügung
• Titel der Default Sprache anpassen (z.B. Deutsch (default) )
• Language Pack in der default Sprache installieren -> Dies ist ab jetzt die Default Sprache. Nicht vergessen auch den lang Tag im Header zu setzen, damit der Browser die Sprache richtig erkennt.

Weitere Sprachen

Für mehrsprachige Seiten benötigen wir i.d.R. die Module: Language Support Fields für die Backend Übersetzungen und Language Support Page Names für die URLs.

• Für weitere Sprachen entsprechend hinzufügen.

drop in the none english language pack (for admin backend) into the default language, (e.g. german langpack)

add a new language to it and drop in a language pack for any none english language or simply don't drop in a language pack to get the english version (but not as the default one!) As a nice sideeffect every new user in your system gets the native language per default without have it to select from the list.

So, yes, this is no solution if you once have set it up and need to switch the default language afterwards, but just want to note it.

Beispiel Default Sprache Deutsch

Todo Testen

• Modul Language Support
• Translation File unter Setup Sprachen hochladen
• Übersetzungen von Hand hinzufügen

Templates für Multilanguage vorbereiten (i18n)

https://processwire.com/docs/multi-language-support/code-i18n/

$out = $this->_("Live long and prosper");  // syntax within a class
$out = __("Live long and prosper!"); // syntax outside of a class

Dann im Backend unter der Sprache "Find files to translate" und die Template Datei auswählen.

Variablen in i18n

$out = sprintf(__("Created %d pages."), $count); 
$out = sprintf(__('Your city is %1$s, and your zip code is %2$s.'), $city, $zipcode);

Plural in Multilanguage Files

Hierzu gibt es die _n() Funktion

$out = sprintf(_n("Created %d page.", "Created %d pages.", $count), $count);

Unterschiedliche Übersetzungen bei gleichem Wortlaut

Manchmal muss der Begriff in anderen Sprachen unterschiedlich übersetzt werden, obwohl er in der Default Sprache gleich lautet:

$label = _x('Comment', 'noun'); // or $this->_x('Comment', 'noun') in a class
...
// some other place in the code
echo _x('Comment', 'column name');

Kommentare für den Übersetzer und User

$date = __('g:i:s a'); // Date string in PHP date() format
echo __("Welcome Guest"); // Headline for guest user // Keep it short (2-3 words)

Regeln

• Eine Zeile ein Paar Anführungszeichen
• Nur eine Übersetzungsfunktion pro Zeile

Language Switcher

// remember what language is set to
$savedLanguage = $user->language;

foreach($languages as $language) {

  // if user is already viewing the page in this language, skip it
  if($language->id == $savedLanguage->id) continue;

  // if this page isn't viewable (active) for the language, skip it
  if(!$page->viewable($language)) continue;

  // set the user's language, so that the $page->url and any other
  // fields we access from it will be reflective of the $language
  $user->language = $language;

  // output a link to this page in the other language
  echo "<li><a href='$page->url'>$language->title: $page->title</a></li>";
}
// restore the original language setting
$user->language = $savedLanguage;