{"id":485,"date":"2023-02-28T20:58:09","date_gmt":"2023-02-28T20:58:09","guid":{"rendered":"http:\/\/msls.co\/?page_id=485"},"modified":"2026-08-23T11:26:09","modified_gmt":"2026-08-23T11:26:09","slug":"snippets-beispiele","status":"publish","type":"page","link":"https:\/\/msls.co\/de\/developer-docs\/snippets-beispiele\/","title":{"rendered":"Snippets & Beispiele"},"content":{"rendered":"\n

Eine Sammlung kurzer Rezepte, die zeigen, wie sich der Multisite Language Switcher in ein Theme oder ein anderes Plugin einf\u00fcgt. Jedes Snippet ist absichtlich minimal gehalten. Behandeln Sie es als Startpunkt: kopieren Sie es in Ihre functions.php<\/code> oder in ein kleines mu-Plugin und passen Sie es an Ihre Men\u00fc-Positionen, Post Types und Locales an.<\/p>\n\n\n\n

Die verwendeten Funktionen sind auf der Seite API-Funktionen<\/a> beschrieben, die Filter in der Hook-Referenz<\/a>.<\/p>\n\n\n\n

Die aktuelle Sprache ermitteln<\/h2>\n\n\n\n

In den meisten F\u00e4llen sollten Sie die WordPress-Funktion get_locale()<\/code> verwenden, wenn Sie die Sprache des aktuellen Blogs brauchen. Das Plugin bietet \u00fcber seine Blog-Collection eine nahezu gleichwertige Alternative, die zus\u00e4tzlich auf en_US<\/code> zur\u00fcckf\u00e4llt, wenn der Wert leer ist, und liefert den zweibuchstabigen Code separat.<\/p>\n\n\n\n

$blog     = msls_blog_collection()->get_current_blog();\n$language = $blog->get_language(); \/\/ en_US\n$alpha2   = $blog->get_alpha2();   \/\/ en\n<\/code><\/pre>\n\n\n\n
Den Umschalter im Template ausgeben<\/h2>\n\n\n\n
Der Einzeiler f\u00fcr Theme-Dateien. Der function_exists()<\/code>-Test sorgt daf\u00fcr, dass das Template auch bei deaktiviertem Plugin durchl\u00e4uft.<\/p>\n\n\n\n
if ( function_exists( 'msls_the_switcher' ) ) {\n\tmsls_the_switcher();\n}\n<\/code><\/pre>\n\n\n\n
Wenn Sie das Markup als String brauchen, etwa um es in eine eigene Komponente einzubetten, nehmen Sie msls_get_switcher()<\/code> und \u00fcbergeben optional die Tags:<\/p>\n\n\n\n
$markup = msls_get_switcher(\n\tarray(\n\t\t'before_output' => '<ul class=\"lang\">',\n\t\t'after_output'  => '<\/ul>',\n\t\t'before_item'   => '<li>',\n\t\t'after_item'    => '<\/li>',\n\t)\n);\n<\/code><\/pre>\n\n\n\n
Das Navigationsmen\u00fc erweitern<\/h2>\n\n\n\n
Die Klasse Frontend\\Output<\/code> ist der richtige Einstieg, wenn Sie den Sprachumschalter in ein Navigationsmen\u00fc einh\u00e4ngen wollen. Das folgende Beispiel gibt die Links als reine Flaggen aus und h\u00e4ngt sie nur an das prim\u00e4re Men\u00fc an.<\/p>\n\n\n\n
Auch hier gilt: Fragen Sie lieber die Funktion msls_output()<\/code> ab, als die Klasse direkt zu referenzieren. So bleibt das Theme bei deaktiviertem Plugin funktionsf\u00e4hig.<\/p>\n\n\n\n
function my_custom_menu_item( $items, $args ) {\n\tif ( function_exists( 'msls_output' ) && 'primary' === $args->theme_location ) {\n\t\t$arr = msls_output()->get( 2 );\n\t\tif ( ! empty( $arr ) ) {\n\t\t\t$items .= '<li>' . implode( '<\/li><li>', $arr ) . '<\/li>';\n\t\t}\n\t}\n\n\treturn $items;\n}\nadd_filter( 'wp_nav_menu_items', 'my_custom_menu_item', 10, 2 );\n<\/code><\/pre>\n\n\n\n
Die Zahl, die an get()<\/code> \u00fcbergeben wird, w\u00e4hlt die Darstellungsvariante des Links:<\/p>\n\n\n\n
\/* Link: Flaggenbild und Text *\/\n$arr = msls_output()->get( 0 );\n\n\/* TextOnly: nur der Sprachtext *\/\n$arr = msls_output()->get( 1 );\n\n\/* ImageOnly: nur das Flaggenbild *\/\n$arr = msls_output()->get( 2 );\n\n\/* TextImage: Text und Flaggenbild *\/\n$arr = msls_output()->get( 3 );\n<\/code><\/pre>\n\n\n\n
Wenn Sie das nicht selbst schreiben wollen: Genau das macht das Add-on MslsMenu<\/a>, inklusive Einstellungsseite.<\/p>\n\n\n\n
\u00dcber die Blogs iterieren<\/h2>\n\n\n\n
Wenn Sie f\u00fcr jeden Blog, den das Plugin verwaltet, etwas tun wollen (alternative Links ausgeben, ein eigenes Men\u00fc bauen, eine Sitemap f\u00fcllen), iterieren Sie direkt \u00fcber die Collection:<\/p>\n\n\n\n
function my_print_something() {\n\tforeach ( msls_blog_collection()->get() as $blog ) {\n\t\tprintf(\n\t\t\t'<link rel=\"alternate\" hreflang=\"%1$s\" href=\"http:\/\/%1$s.example.com\/\" \/>',\n\t\t\tesc_attr( $blog->get_language() )\n\t\t);\n\t}\n}\nadd_action( 'wp_head', 'my_print_something' );\n<\/code><\/pre>\n\n\n\n
Beachten Sie: msls_blog_collection()->get()<\/code> liefert alle Blogs au\u00dfer<\/strong> dem aktuellen. Wenn Sie die vollst\u00e4ndige Liste brauchen, verwenden Sie get_objects()<\/code>.<\/p>\n\n\n\n
Auf eine einzelne \u00dcbersetzung verlinken<\/h2>\n\n\n\n
msls_get_permalink()<\/code> ist die richtige Wahl, wenn Sie einen direkten Link auf genau eine Sprache setzen oder Ihr eigenes Umschalter-Markup bauen. Das optionale zweite Argument wird zur\u00fcckgegeben, wenn keine \u00dcbersetzung existiert. Der Aufruf ist damit auch inline sicher:<\/p>\n\n\n\n
$de_url = msls_get_permalink( 'de_DE', home_url( '\/' ) );\necho '<a href=\"' . esc_url( $de_url ) . '\">Deutsche Version<\/a>';\n<\/code><\/pre>\n\n\n\n
Den hreflang-Wert anpassen<\/h2>\n\n\n\n
Der Filter msls_head_hreflang<\/code> bestimmt den Wert des hreflang<\/code>-Attributs, das im <head><\/code> ausgegeben wird. Nutzen Sie ihn, wenn Sie aus SEO-Gr\u00fcnden eine regionale Schreibweise erzwingen wollen, etwa en-US<\/code> statt eines blo\u00dfen en<\/code>:<\/p>\n\n\n\n
add_filter( 'msls_head_hreflang', function ( string $language ): string {\n\treturn 'en_US' === $language ? 'en-US' : $language;\n} );\n<\/code><\/pre>\n\n\n\n
Post Types ein- und ausschlie\u00dfen<\/h2>\n\n\n\n
Standardm\u00e4\u00dfig behandelt das Plugin post<\/code>, page<\/code> und alle \u00f6ffentlichen eigenen Post Types als \u00fcbersetzbar. Mit msls_supported_post_types<\/code> nehmen Sie einzelne davon heraus, zum Beispiel einen feedback<\/code>-CPT, der einsprachig bleiben soll:<\/p>\n\n\n\n
add_filter( 'msls_supported_post_types', function ( array $types ): array {\n\treturn array_values( array_diff( $types, array( 'feedback' ) ) );\n} );\n<\/code><\/pre>\n\n\n\n
Der Filter msls_supported_taxonomies<\/code> tut dasselbe f\u00fcr Taxonomien.<\/p>\n\n\n\n
Das Markup der Sprachlinks \u00fcberschreiben<\/h2>\n\n\n\n
msls_output_get<\/code> l\u00e4uft f\u00fcr jedes gerenderte Sprachelement, kurz bevor es in das Ausgabe-Array wandert. Der Filter bekommt die Ziel-URL (nicht das fertige Anker-Element), das LinkInterface<\/code>-Objekt und die Information, ob das Element auf den aktuellen Blog zeigt. Der R\u00fcckgabewert muss das vollst\u00e4ndige HTML dieses Elements sein.<\/p>\n\n\n\n
Das Link-Objekt tr\u00e4gt seine Werte in drei magischen Eigenschaften: txt<\/code> ist die Beschreibung des Blogs, src<\/code> die URL des Flaggen-Icons und alt<\/code> das Locale. Die Umwandlung in ein <img><\/code> beziehungsweise in Text \u00fcbernimmt __toString()<\/code>, abh\u00e4ngig von der gew\u00e4hlten Variante.<\/p>\n\n\n\n
Das Beispiel setzt hreflang<\/code> und aria-current<\/code> und l\u00e4sst das Markup ansonsten schlicht:<\/p>\n\n\n\n
add_filter( 'msls_output_get', function ( string $url, $link, bool $is_current_blog ): string {\n\t$current_attr = $is_current_blog ? ' aria-current=\"page\"' : '';\n\n\treturn sprintf(\n\t\t'<a href=\"%s\" hreflang=\"%s\"%s>%s<\/a>',\n\t\tesc_url( $url ),\n\t\tesc_attr( str_replace( '_', '-', (string) $link->alt ) ),\n\t\t$current_attr,\n\t\t(string) $link\n\t);\n}, 10, 3 );\n<\/code><\/pre>\n\n\n\n
Solange kein Callback an diesem Filter h\u00e4ngt, erzeugt das Plugin sein eigenes Standard-Anker-Element, inklusive class=\"current_language\"<\/code> und aria-current=\"page\"<\/code> auf der aktiven Sprache.<\/p>\n\n\n\n
Hinweis auf \u00dcbersetzungen im Beitragstext<\/h2>\n\n\n\n
Das Plugin kann \u00fcber oder unter dem Beitrag einen Hinweis einblenden, dass der Text auch in anderen Sprachen vorliegt. Mit msls_filter_string<\/code> ersetzen Sie die Formatvorlage daf\u00fcr. Der Filter bekommt zus\u00e4tzlich das Array der Sprachlinks, sodass Ihre eigene Fassung sie weiterverwenden kann:<\/p>\n\n\n\n
add_filter( 'msls_filter_string', function ( string $format, array $links ): string {\n\treturn '<p class=\"msls-hint\">Diesen Artikel gibt es auch auf: %s<\/p>';\n}, 10, 2 );\n<\/code><\/pre>\n\n\n\n
Wenn keine \u00dcbersetzung existiert<\/h2>\n\n\n\n
Findet das Plugin nichts auszugeben, liefert Output::__toString()<\/code> einen leeren String. \u00dcber msls_output_no_translation_found<\/code> machen Sie daraus einen Hinweis:<\/p>\n\n\n\n
add_filter( 'msls_output_no_translation_found', function ( string $empty ): string {\n\treturn '<p class=\"msls-none\">Dieser Beitrag liegt noch nicht in Ihrer Sprache vor.<\/p>';\n} );\n<\/code><\/pre>\n\n\n\n
F\u00fcr das Widget gibt es daf\u00fcr den eigenen Filter msls_widget_alternative_content<\/code>.<\/p>\n\n\n\n
Flaggen aus eigener Quelle laden<\/h2>\n\n\n\n
Wenn die Flaggen aus Ihrem Theme oder von einem CDN kommen sollen, biegen Sie das Verzeichnis um. Einzelne Dateinamen regelt der zweite Filter:<\/p>\n\n\n\n
add_filter( 'msls_options_get_flag_url', function ( string $url ): string {\n\treturn get_stylesheet_directory_uri() . '\/img\/flags';\n} );\n\nadd_filter( 'msls_options_get_flag_icon', function ( string $icon, string $language ): string {\n\treturn 'de_AT' === $language ? 'at.svg' : $icon;\n}, 10, 2 );\n<\/code><\/pre>\n\n\n\n
Den Status der per Quick Create angelegten \u00dcbersetzungen setzen<\/h2>\n\n\n\n
Der REST-Endpunkt hinter Quick Create legt neue \u00dcbersetzungen als Entwurf an. \u00dcber msls_quick_create_post_data<\/code> \u00fcbernehmen Sie stattdessen den Status des Ausgangsbeitrags:<\/p>\n\n\n\n
add_filter( 'msls_quick_create_post_data', function ( array $post_data, \\WP_Post $source ): array {\n\t$post_data['post_status'] = $source->post_status;\n\n\treturn $post_data;\n}, 10, 2 );\n<\/code><\/pre>\n\n\n\n
An demselben Hook h\u00e4ngt standardm\u00e4\u00dfig lloc\\Msls\\RestApi\\RestApi::prefix_source_language()<\/code> und stellt dem Titel des neuen Beitrags das Locale der Quelle voran. Wenn das in Ihrem Workflow st\u00f6rend ist, h\u00e4ngen Sie den Callback ab:<\/p>\n\n\n\n
remove_filter(\n\t'msls_quick_create_post_data',\n\tarray( \\lloc\\Msls\\RestApi\\RestApi::class, 'prefix_source_language' ),\n\t10\n);\n<\/code><\/pre>\n\n\n\n
Nach dem Anlegen einer \u00dcbersetzung eigene Daten kopieren<\/h2>\n\n\n\n
Die Action msls_quick_create_after_insert<\/code> feuert, nachdem der neue Beitrag im Ziel-Blog angelegt wurde, und zwar noch innerhalb des switch_to_blog()<\/code>-Kontexts. Der richtige Ort, um eigene Meta-Felder mitzunehmen oder eine Benachrichtigung anzusto\u00dfen:<\/p>\n\n\n\n
add_action(\n\t'msls_quick_create_after_insert',\n\tfunction ( int $new_post_id, \\WP_Post $source, int $source_blog_id, int $target_blog_id ): void {\n\t\tupdate_post_meta( $new_post_id, '_my_source_post', $source->ID );\n\t\tupdate_post_meta( $new_post_id, '_my_source_blog', $source_blog_id );\n\t},\n\t10,\n\t4\n);\n<\/code><\/pre>\n\n\n\n
An dieser Action h\u00e4ngt das Plugin selbst RestApi::remember_source_blog()<\/code>, das sich den zuletzt verwendeten Quell-Blog pro Benutzer merkt, damit die Auswahl beim n\u00e4chsten Mal vorbelegt ist.<\/p>\n\n\n\n
Die Berechtigung f\u00fcr Quick Create anpassen<\/h2>\n\n\n\n
msls_quick_create_capability<\/code> filtert das Ergebnis der Berechtigungspr\u00fcfung. Sie bekommen die Standardentscheidung, die Beitrags-ID der Quelle (0<\/code> bei Listen-Abfragen), die IDs von Quell- und Ziel-Blog sowie einen Kontext: read<\/code> beim Zugriff auf die Quelle, create<\/code> beim Anlegen im Ziel. So darf ein \u00dcbersetzer ohne Konto im Quell-Blog trotzdem Beitr\u00e4ge in seinen Blog spiegeln:<\/p>\n\n\n\n
add_filter(\n\t'msls_quick_create_capability',\n\tfunction ( bool $allowed, int $source_post_id, int $source_blog_id, int $target_blog_id, string $context ): bool {\n\t\tif ( 'read' === $context && current_user_can( 'edit_posts' ) ) {\n\t\t\treturn true;\n\t\t}\n\n\t\treturn $allowed;\n\t},\n\t10,\n\t5\n);\n<\/code><\/pre>\n\n\n\n
Weiterlesen<\/h2>\n\n\n\n