Plugin WPML CMS Navigation - 5.1.0

WPML CMS Navigation ist ein Add-on für das Übersetzungsplugin WPML, das WordPress-Seiten drei fertige, mehrsprachige Navigationselemente hinzufügt: Breadcrumbs, ein aufklappbares Menü sowie eine Navigation in der Seitenleiste. Alle drei kennen die Sprachstruktur von WPML und zeigen den Pfad in der Sprache des Besuchers, ohne dass für jede Sprache ein eigenes Menü aufgebaut werden muss. Das Add-on wurde für Besitzer mehrsprachiger WPML-Websites und für Entwickler entwickelt, die mit klassischen PHP-Themes arbeiten.

Funktionen und Möglichkeiten von WPML CMS Navigation

WPML CMS Navigation stellt drei Navigationselemente bereit – mehrsprachige Breadcrumbs, ein mehrstufiges aufklappbares Menü sowie eine Navigation in der Seitenleiste, die verwandte Seiten anzeigt. Alle drei nutzen die Übersetzungskarte von WPML, sodass Pfade und Verknüpfungen in der Sprache der gerade angezeigten Seitenversion erscheinen. Ohne dass für jede Sprache ein eigenes Menü gepflegt werden muss.

In der Praxis ist das ein einziger Satz von Elementen für die gesamte Website. Der Besucher wechselt die Sprache und sieht dieselbe Navigationsstruktur – nur dass Beschriftungen und Verknüpfungen auf die passende Sprachversion verweisen.

• Mehrsprachige Breadcrumbs – erzeugen einen Pfad, der die Position des Besuchers in der Hierarchie der Website zeigt, mit Beschriftungen in der aktuellen Sprache und einem konfigurierbaren Trennzeichen.
• Mehrstufiges aufklappbares Menü – ermöglicht schnellen Zugriff auf die Bereiche der Website, meist im Header des Themes eingebunden.
• Navigation in der Seitenleiste – listet Seiten auf, die mit der aktuell angezeigten Seite verwandt sind, etwa Unterseiten und Seiten desselben Bereichs.
• Steuerung pro Seite aus dem Editor – ermöglicht es, eine Seite aus der Seitenleisten-Navigation auszuschließen, ihre Unterseiten anzuzeigen oder auszublenden sowie einen Bereich zuzuweisen.
• Globale Einstellungen – Panel WPML → Navigation, in dem unter anderem das Trennzeichen der Breadcrumb-Spur festgelegt wird.
• Kenntnis der WPML-Übersetzungskarte – ein einziger Satz von Elementen für alle Sprachen, ohne für jede Sprache ein eigenes Menü zu pflegen.
• Anpassung per CSS – die Datei cms-navigation.css wird in das Theme kopiert und passt das Erscheinungsbild der Elemente an.

Sprachbewusste Breadcrumbs und aufklappbares Menü

Die Breadcrumbs bauen eine Spur von der Startseite bis zur aktuellen Unterseite auf, wobei die Beschriftungen auf dieser Spur aus der aktuellen Sprachversion von WPML stammen. Das Trennzeichen zwischen den Ebenen (Separator) wird zentral im Panel WPML → Navigation festgelegt – eine einzige Änderung wirkt sich auf die gesamte Website aus.

Das aufklappbare Menü funktioniert mehrstufig und spiegelt die Struktur der Inhalte in der jeweiligen Sprache wider. Statt eines eigenen Dropdowns für jede Version wird das Menü nur einmal gerendert. WPML sorgt dafür, dass die Einträge in der Sprache des Besuchers angezeigt werden.

Navigation in der Seitenleiste und verwandte Seiten

Die Navigation in der Seitenleiste zeigt Seiten, die mit der aktuell angezeigten Seite verwandt sind – Unterseiten sowie Seiten, die zum selben Bereich der Website gehören. Das erleichtert die Orientierung in einer umfangreichen Hierarchie, in der eine reine Liste von Menüpunkten nicht ausreicht, um zu verstehen, wo sich der Besucher gerade befindet.

Die Sidebar ermittelt die Verknüpfungen anhand der Seitenstruktur und der Übersetzungskarte, sodass sie nach einem Sprachwechsel die entsprechenden Seiten in der neuen Version auflistet. Das Element wird entweder in eine Theme-Datei eingebunden oder als fertiges Widget hinzugefügt.

Steuerung der Navigation pro Seite aus dem Editor

Im Seiten-Editor erscheint der Bereich „CMS Navigation“, der die Kontrolle über das Navigationsverhalten für die jeweilige Seite ermöglicht. Über dieses Panel schließt der Redakteur die aktuelle Seite von der Seitenleisten-Navigation aus, entscheidet über das Anzeigen oder Ausblenden ihrer Unterseiten und weist den Bereich zu, unter dem die Seite erscheinen soll.

So verwalten Redakteure den Inhalt der Sidebar, ohne in den Code eingreifen zu müssen. Der Entwickler bindet das Element einmal ein, weitere Entscheidungen über die Sichtbarkeit von Seiten fallen dann im Panel des Editors.

Einbindung der WPML CMS Navigation-Elemente in das Theme

Die Elemente von WPML CMS Navigation werden mit einzeiligen PHP-Funktionen in das Theme eingebunden – die Breadcrumbs über icl_navigation_breadcrumb, das aufklappbare Menü über icl_navigation_menu und die Seitenleiste über icl_navigation_sidebar. Die Seitenleisten-Navigation lässt sich auch als fertiges WordPress-Widget hinzufügen, ohne den Code anzufassen. Das Erscheinungsbild der Elemente passt man an, indem man die Datei cms-navigation.css in das Theme kopiert.

PHP-Hooks in den Theme-Dateien

Drei Action-Hooks mit dem Präfix icl_navigation_ sind der Ansatzpunkt für die Einbindung in ein klassisches PHP-Theme. Die Breadcrumbs werden mit icl_navigation_breadcrumb in der Datei header.php oder in Templates wie single.php, page.php oder archive.php eingefügt. Das aufklappbare Menü wird über icl_navigation_menu aufgerufen, meist in header.php.

Jeder Hook ist ein einzelner Funktionsaufruf an der passenden Stelle im Template. Dieses Integrationsmodell ist für Entwickler gut vorhersehbar – sie haben Zugriff auf die Theme-Dateien und entscheiden selbst, an welcher Stelle das Element genau gerendert werden soll.

Seitenleisten-Widget ohne Code

Die Navigation in der Seitenleiste gibt es auch als fertiges WordPress-Widget, verfügbar im Bereich Design → Widgets. Das ist das einzige der drei Elemente, das ohne Code-Bearbeitung eingerichtet wird – es genügt, das Widget in den Seitenleisten-Bereich des Themes zu ziehen.

Für die Breadcrumbs und das aufklappbare Menü gibt es kein entsprechendes Widget. Ihre Einbindung erfordert das Einfügen einer PHP-Funktion in das Template.

Anpassung des Erscheinungsbilds per CSS

Das Add-on liefert zwei CSS-Dateien im Plugin-Verzeichnis. Die Datei cms-navigation-base.css ist für die Funktion des aufklappbaren Menüs zuständig und sollte nicht verändert werden, da sie die Mechanik des Dropdowns steuert. Die Datei cms-navigation.css wird in das Theme kopiert und an das eigene Erscheinungsbild angepasst.

Die Trennung der funktionalen von der gestalterischen Ebene ermöglicht es, das Erscheinungsbild der Elemente zu ändern, ohne deren Funktion zu gefährden. Die Anpassung an das Theme ist Frontend-Arbeit an der Datei cms-navigation.css.

Typische Einsatzszenarien von WPML CMS Navigation

WPML CMS Navigation bewährt sich auf mehrsprachigen Websites mit einer tiefen, hierarchischen Struktur – auf Unternehmenswebsites, Wissensdatenbanken und Dokumentationen mit vielen verschachtelten Bereichen. Die Breadcrumbs zeigen die Position des Besuchers in der aktuellen Sprache, die Sidebar listet verwandte Seiten auf, und das Panel im Editor ermöglicht es Redakteuren, die Seitenleisten-Navigation ohne Eingriff in den Code zu steuern.

Websites mit tiefer Struktur und Wissensdatenbanken

Auf einer zweisprachigen Unternehmenswebsite mit dem Aufbau „Produkte → Kategorie → Unterseite“ verliert der Besucher leicht die Orientierung, und ein eigenes Menü für jede Sprache bedeutet doppelte Arbeit. Die im Header eingebundenen Breadcrumbs zeigen den Pfad stets in der aktuellen Sprache, und die Seitenleiste listet die Unterseiten des aktuellen Bereichs auf – die Navigation bleibt nach einem Sprachwechsel konsistent.

In einer mehrsprachigen Wissensdatenbank oder Dokumentation mit Dutzenden verschachtelten Artikeln zeigt das Seitenleisten-Widget automatisch die verwandten Seiten des jeweiligen Bereichs in der Sprache des Besuchers. Das aufklappbare Menü bewährt sich dort, wo eine Website viele Abteilungen hat, die eine mehrstufige Navigation im Header erfordern.

Von Redakteuren verwaltete Seitenleisten-Navigation

Auf einer Informationswebsite bindet der Entwickler die Seitenleiste einmalig ein, weitere Entscheidungen über deren Inhalt übernehmen dann die Redakteure. Über das Panel „CMS Navigation“ im Editor entscheiden sie pro Seite, ob diese in der Navigation erscheinen, ob ihre Unterseiten aufgelistet werden sollen und unter welchem Bereich sie eingeordnet wird.

Diese Arbeitsteilung entlastet das technische Team. Der Theme-Code bleibt unangetastet, und die Redaktion steuert die Sichtbarkeit von Inhalten in der Seitenleisten-Navigation. In einer Wissensdatenbank ermöglicht das Panel beispielsweise, Hilfsseiten aus der Liste der Verknüpfungen auszuschließen.

Für welche Websites sich WPML CMS Navigation am besten eignet

WPML CMS Navigation ist die naheliegende Wahl für Besitzer mehrsprachiger Websites, die bereits WPML nutzen, sowie für Entwickler, die auf klassischen PHP-Themes aufbauen, wo die Elemente über Action-Hooks eingebunden werden. Nicht geeignet ist es dagegen für reine Block-Themes (Full Site Editing) oder für Seiten, denen es vor allem um Breadcrumbs mit strukturierten Daten für SEO geht.

WPML-Websites und klassische PHP-Themes

Das Add-on stammt aus dem Paket WPML Multilingual CMS. Für jemanden, der eine Website mit WPML betreibt, ist es damit eine Möglichkeit, eine konsistente, sprachbewusste Navigation hinzuzufügen, ohne auf ein Plugin eines anderen Anbieters zurückzugreifen.

Für wen sich WPML CMS Navigation am besten eignet:

• Besitzer mehrsprachiger WordPress-Websites, die bereits WPML nutzen.
• Seiten mit umfangreicher, hierarchischer Inhaltsstruktur – Portale, Wissensdatenbanken, Kataloge mit vielen verschachtelten Bereichen.
• Entwickler und Agenturen, die auf klassischen PHP-Themes mit den Dateien header.php und sidebar.php arbeiten.
• Projekte, bei denen die Seitenleisten-Navigation pro Seite von Redakteuren im Editor gesteuert werden soll.

Für wen WPML CMS Navigation nicht die beste Wahl ist

Das Einbindungsmodell, das auf PHP-Funktionen in Theme-Dateien und klassischen Widgets basiert, setzt dem Einsatzbereich Grenzen. In einer reinen Block-Umgebung sowie dort, wo es vor allem auf Breadcrumbs für Google-Ergebnisse ankommt, sind andere Werkzeuge besser geeignet.

Für wen WPML CMS Navigation nicht die beste Wahl ist:

• Websites mit Block-Themes und Full Site Editing ohne PHP-Theme-Dateien – das native Einbindungsmodell (Hooks in Templates) passt hier nicht; besser geeignet ist die Block-Navigation von WordPress.
• Seiten, denen es vor allem um Breadcrumbs mit strukturierten Daten für SEO (Rich Snippets) geht – eine vollständigere Lösung bieten hier Yoast SEO, Rank Math, Breadcrumb NavXT oder SEOPress, die schema.org-BreadcrumbList-Markup erzeugen.
• Nutzer, die WPML nicht verwenden und auch nicht einsetzen wollen – das Add-on funktioniert nicht eigenständig und ist ohne den WPML-Kern nutzlos.
• Personen, die jede Bearbeitung des Themes vermeiden möchten – abgesehen vom Seitenleisten-Widget erfordern Breadcrumbs und das aufklappbare Menü das Einfügen von PHP-Code in die Templates.

Technische Anforderungen und Kompatibilität

WPML CMS Navigation benötigt einen funktionierenden WPML-Multilingual-CMS-Kern und ist ausschließlich in diesem Paket enthalten – nicht im günstigeren Multilingual Blog und nicht separat. Es übernimmt die Umgebungsanforderungen von WPML: WordPress 4.7 oder neuer sowie empfohlen PHP 7.4 oder neuer, mit vollständiger Unterstützung von PHP 8.3 ab der Version WPML 4.6.12. Unter PHP 8.4 treten funktionslose Deprecation-Warnungen auf.

Erforderliches Paket WPML Multilingual CMS

Hinweis: WPML CMS Navigation ist kein eigenständiges Plugin. Es funktioniert ausschließlich mit installiertem WPML-Multilingual-CMS-Kern und wird als Add-on in diesem Paket mitgeliefert – der günstigere Tarif Multilingual Blog umfasst es nicht.

Das Add-on selbst veröffentlicht keine eigene Tabelle mit Anforderungen – es übernimmt die Umgebungsanforderungen des WPML-Kerns, mit dem es zusammenarbeitet. Die folgenden Angaben beziehen sich daher auf die Umgebung des gesamten WPML-Pakets.

WordPress- und PHP-Umgebung

Das Add-on läuft auf WordPress 4.7 und neuer, der Hersteller gibt einen Kompatibilitätsbereich bis Version 7.0 an; empfohlen wird die aktuelle WordPress-Version. Auf der PHP-Seite wird 7.4 oder neuer empfohlen, und seit der Version WPML 4.6.12 vom Juli 2024 bietet das Paket vollständige Unterstützung für PHP 8.3. Die Unterstützung für PHP 7.0 und 7.1 wurde eingestellt.

Block-Themes, strukturierte Daten und PHP 8.4

WPML CMS Navigation basiert auf PHP-Funktionen in Theme-Dateien und auf klassischen Widgets, sodass sein natives Einbindungsmodell in reinen Block-Themes und der Full-Site-Editing-Umgebung nicht anwendbar ist. Die Dokumentation des Herstellers beschreibt keinen Weg für FSE, und für solche Websites ist die Block-Navigation von WordPress die passendere Wahl.

Die Dokumentation bestätigt auch nicht die Erzeugung strukturierter Daten nach schema.org BreadcrumbList – bis zu einer Bestätigung ist von fehlender nativer Unterstützung für Rich Snippets auszugehen. Websites, denen es auf Breadcrumbs für Google-Ergebnisse ankommt, sind mit SEO-Plugins in dieser Hinsicht besser bedient.

Unter PHP 8.4 erscheinen Warnungen über die Erstellung dynamischer Properties in der Datei cache.class.php. Laut dem WPML-Support handelt es sich um funktionslose Meldungen, die den Betrieb nicht beeinträchtigen; ihre Behebung ist für kommende Versionen geplant.