Kundenspezifischer Sprachumschalter

WPML hat einen eigenen Sprachumschalter, der als Dropdown-Liste der Sprache eingeführt wurde. Er ist recht flexibel, aber reicht nicht immer aus.

Sie können Ihre eigenen, kundenspezifischen Sprachumschalter erstellen und sie ins Theme einfügen. Ich werde Ihnen zeigen, wie Sie eine Liste verfügbarer Sprachen zu Posts und eine Sprachenliste zur Fußzeile hinzufügen können.

Die Liste (anderer) Sprachen einholen

Verwenden Sie icl_get_languages() um eine Liste der Übersetzungen für jede Seite zu erhalten. Anwendung:

icl_get_languages('skip_missing=N')

* N=0/1

Der Parameter skip_missing (fehlende überspringen) sagt der Funktion, wie mit Sprachen ohne Übersetzungen umgegangen werden soll. Damit befassen wir uns gleich.

Die Funktion gibt eine Aufstellung mit Einträgen pro Sprache aus. Bei einer WordPress-Seite, die auf Englisch, Französisch und Italienisch läuft, wird sie zum Beispiel das hier ausgeben:

Array
(
 [0] => Array
  (
   [active] => 1
   [native_name] => English
   [translated_name] => English
   [language_code] => en
   [country_flag_url] => http://yourdomain/wpmlpath/res/flags/en.png
   [url] => http://yourdomain/about
  )

 [1] => Array
  (
   [active] => 0
   [native_name] => Français
   [translated_name] => French
   [language_code] => fr
   [country_flag_url] => http://yourdomain/wpmlpath/res/flags/fr.png
   [url] => http://yourdomain/fr/a-propos
  )

 [2] => Array
  (
   [active] => 0
   [native_name] => Italiano
   [translated_name] => Italian
   [language_code] => it
   [country_flag_url] => http://yourdomain/wpmlpath/res/flags/it.png
   [url] => http://yourdomain/it/circa
  )
)

Jede Sprache hat ihre eigene Aufstellung von Parametern, die Ihre Theme-Funktion zur Erstellung einer beliebigen Sprachauswahl verwenden kann.

• active (aktiv): Dies ist die derzeit aktive Sprache (genau eine Sprache ist aktiv)
• native_name (Name in der Muttersprache): Der Name der Sprache in der Muttersprache (nie übersetzt)
• translated_name (übersetzter Name): Der Name der Sprache in die derzeit aktive Sprache übersetzt
• country_flag_url (URL zur Länderflagge): Die URL zu einem PNG-Bild mit der Länderflagge
• url: Der Link zur Übersetzung in der jeweiligen Sprache.

Umgang mit fehlenden Übersetzungen

Einige Seiten sind vielleicht nicht in alle Sprachen übersetzt. Sie können icl_get_languages sagen, was es bei Sprachen ohne Übersetzungen anzeigen soll.

Bei ‘skip_missing=1′, werden diese Sprachen in der Ausgabe nicht erscheinen. Bei ‘skip_missing=0′, werden alle Sprachen angezeigt und Sprachen mit fehlenden Übersetzungen werden zurück auf die Startseite der jeweiligen Sprache verlinken.

Verwendung in Ihren Theme-Funktionen

Sie können ganz nach Ihren Wünschen eigene Sprachumschalter erstellen. Hier zeigen wir Ihnen zwei beliebte Anwendungsweisen.

Die Beispiel-PHP-Funktionen, die wir hier zeigen, sollten in Ihre functions.php-Datei (im Theme-Ordner) aufgenommen – und nicht zum Plugin hinzugefügt werden.

Dieser Post ist auch verfügbar auf…

Angenommen, Sie möchten am Ende (oder Anfang) jedes Posts eine Zeile einfügen, die anzeigt, in welchen anderen Sprachen er verfügbar ist. Diese Funktion sollte nur bereits übersetzte Posts anzeigen und wenn keine Übersetzung verfügbar ist, sollte sie nichts ausgeben.

function icl_post_languages(){
  $languages = icl_get_languages('skip_missing=1');
  if(1 < count($languages)){
    echo __('This post is also available in: ');
    foreach($languages as $l){
      if(!$l['active']) $langs[] = '<a href="'.$l['url'].'">'.$l['translated_name'].'</a>';
    }
    echo join(', ', $langs);
  }
}

Dies tut diese Funktion:

1. Sie holt die Liste der Sprachen von WPML – $languages = icl_get_languages(‘skip_missing=1′);
2. Sie überprüft, dass es mehr als eine Sprache für diesen Post gibt – if(1 < count($languages))
3. Sie erstellt die Ausgabe, wobei die derzeit angezeigte Sprache übersprungen wird – if(!$l['active'])

Hinweise:

1. Diese Nachricht durchläuft gettext. Das ist sehr wichtig, damit diese Nachricht, die Sie an Posts in verschiedenen Sprachen anhängen, in der richtigen Sprache erscheint:  __(‘Dieser Post ist auch verfügbar auf: ‘);
2. Die Namen der verwendeten Sprachen sind die übersetzten Sprachennamen. Dies würde garantieren, dass der gesamte Satz in der richtigen Sprache geschrieben wird: $l['translated_name']

Das Ergebnis ist dieses:

Nachricht über in anderen Sprachen verfügbare Posts

Um diese Nachricht in Posts zu integrieren, fügen Sie einen Anruf in icl_post_languages() aus single.php hinzu.

Liste der Sprachennamen und Flaggen für die Fußzeile

Selbst wenn Sie oben auf jeder Seite eine Sprachauswahl haben, ist es eine gute Idee, eine Liste der Sprachennamen und Flaggen zur Fußzeile hinzuzufügen. Viele Leute scrollen sofort bis zum Ende der Seite hinunter, um sich ein besseres Bild davon zu machen, was noch kommt, deshalb wird es Ihren fremdsprachigen Besuchern wahrscheinlich helfen, wenn es dort einen gut sichtbaren Sprachumschalter gibt.

function languages_list_footer(){
    $languages = icl_get_languages();
    if(!empty($languages)){
        echo '<div id="footer_language_list"><ul>';
        foreach($languages as $l){
            echo '<li>';
            if($l['country_flag_url']){
                if(!$l['active']) echo '<a href="'.$l['url'].'">';
                echo '<img src="'.$l['country_flag_url'].'" height="12" alt="'.$l['language_code'].'" width="18" />';
                if(!$l['active']) echo '</a>';
            }
            if(!$l['active']) echo '<a href="'.$l['url'].'">';
            echo icl_disp_language($l['native_name'], $l['translated_name']);
            if(!$l['active']) echo '</a>';
            echo '</li>';
        }
        echo '</ul></div>';
    }
}

Diese Funktion macht Folgendes:

1. Wenn es irgendeine Übersetzungssprache gibt, erstellt sie eine DIV und startet eine unsortierte Liste: if(!empty($languages)){ echo ‘<div id="footer_language_list"><ul>’;
2. Geht jede der Sprachen durch und fügt sie als Listenpunkt hinzu.
3. Wenn es nicht die aktive Sprache ist, verlinkt sie auch auf die Seite in der Sprache: if(!$l['active']) echo ‘<a href="’.$l['url'].’">’;
4. Fügt die Länderflagge hinzu: <img src="’.$l['country_flag_url'].’" alt="’.$l['language_code'].’" width="18" height="12" />
5. Fügt sowohl die Namen der Muttersprache als auch der Sprache, in die übersetzt wurde, hinzu, wenn diese unterschiedlich sind: echo icl_disp_language($l['native_name'], $l['translated_name']);

Die Funktion icl_disp_language() wird von WPML erstellt. Sie überprüft, ob die zwei Argumente (native_language_name, translated_language_name) unterschiedlich sind. Wenn ja, gibt sie beide aus, ansonsten gibt sie sie nur einmal aus.

Wir sollten auch bisschen CSS hinzufügen, um die Sprachenliste zu stylen. Diese CSS wird die Sprachenliste in Ihre Fußzeile einfügen und sie ein bisschen formatieren:

#footer_language_list{
  margin-bottom: 25px;
  text-align: center;
}

#footer_language_list ul{
  list-style: none;
  margin:0;
  padding:0;
}

#footer_language_list ul li img{
  margin-right:5px;
}

#footer_language_list ul li{
  display:inline;
  margin:0 5px 0 5px;
  padding:0;
}

#footer_language_list ul li a, #footer_language_list ul li a:visited{
  color: #fff;
  text-decoration:underline;
}

#footer_language_list ul li a:hover, #footer_language_list ul li a:active{
  color: #fff;
}

Hier ist der Sprachumschalter:

Sprach-Fußzeile

Um sie Ihrem Theme hinzuzufügen, fügen Sie den Aufruf languages_list_footer zur footer.php-Datei hinzu.

* Hinweis: Sie können diesen horizontalen Sprachumschalter ganz leicht in einen vertikalen Sprachumschalter verwandeln. Entfernen Sie einfach nur die Angabe display: inline aus der CSS.