Mant Multilingual
Dokumentation
Was macht Mant Multilingual?
Es liefert deine Website in mehreren Sprachen aus, ohne irgendetwas zu kopieren. Die Sprache, in der die Website geschrieben ist, bleibt an der Wurzel; jede Sprache, in die du übersetzt, bekommt ihr eigenes Präfix, zum Beispiel /de/. Beiträge, Seiten, Produkte und Menüs werden nie dupliziert.
Was passiert nach der Aktivierung?
Zunächst nichts. Erst wenn du festlegst, in welchen Sprachen die Website läuft, ändert sich etwas. Bis dahin liefert jede Adresse genau das aus, was sie vorher ausgeliefert hat.
Verändert es meine vorhandenen Inhalte?
Nein. Übersetzungen liegen in den eigenen Tabellen des Plugins und werden über das Original gelegt, sobald eine übersetzte Adresse aufgerufen wird. Der ursprüngliche Beitrag wird nie bearbeitet, kopiert oder neu veröffentlicht.
Wie installiere ich das Plugin?
Gehe zu WordPress → Plugins → Installieren, lade das Plugin hoch und aktiviere es.
Wo lege ich die Sprachen fest?
Öffne Mant Multilingual → Sprachen einrichten. Das erste Feld ist die Sprache, in der deine vorhandenen Inhalte geschrieben sind. Darunter trägst du die Sprachen ein, in die du übersetzt, jede mit ihrem eigenen URL-Präfix.
Kann ich die Ausgangssprache später ändern?
Nur solange es keine Übersetzungen gibt. Sobald etwas übersetzt ist, steht die Ausgangssprache fest, denn jede gespeicherte Übersetzung gehört zu dem Original, gegen das sie geschrieben wurde.
Was passiert, wenn ich ein Präfix ändere?
Übersetzungen und Bestellsprachen bleiben erhalten, die öffentlichen Adressen ändern sich aber. Es wird nichts automatisch weitergeleitet: passe deine Links an oder richte selbst Weiterleitungen ein.
Brauche ich sprechende Permalinks?
Ja. Sprachpräfixe lassen sich mit einfachen Permalinks nicht routen. Wähle unter Einstellungen → Permalinks alles außer „Einfach“.
Wo übersetze ich?
Öffne die Seite im Block-Editor und klicke oben auf Übersetzungen. Im klassischen Editor und bei Produkten erscheinen dieselben Felder in einer Box unterhalb des Inhalts.
Warum ist der Inhalt in viele kleine Felder aufgeteilt?
Weil eine Seite kein einziger Textblock ist. Jede Überschrift, jeder Absatz, jede Schaltfläche und jede Liste ist ein eigenes Feld neben dem Original, zu dem es gehört. So übersetzt du Wörter und nie Markup. Blöcke, die der Feld-Editor nicht lesen kann, werden benannt, damit du sie vor dem Veröffentlichen prüfen kannst.
Geht meine Übersetzung kaputt, wenn ich die Seite umgestalte?
Nein. Gespeichert werden die Wörter, nicht das Layout. Wenn du im Original Farben, Abstände oder die Reihenfolge der Blöcke änderst, wird die Übersetzung in der aktuellen Struktur der Seite ausgeliefert, ohne dass du sie erneut speichern musst.
Was bedeuten Entwurf und Veröffentlicht?
Ein Status gilt für die gesamte Übersetzung. Entwurf gehört dir zum Arbeiten, und Besucher sehen weiterhin das Original. Veröffentlicht ist das, was Besucher unter dem Sprachpräfix bekommen.
Was bedeutet der Hinweis „veraltet“?
Dass sich der Originaltext geändert hat, nachdem diese Übersetzung gespeichert wurde. Die veröffentlichte Übersetzung wird weiterhin ausgeliefert, es geht also nichts kaputt. Der Hinweis sagt dir nur, dass sich ein zweiter Blick lohnt.
Wie entferne ich eine Übersetzung?
Übersetzung entfernen am Ende des Panels löscht Text und Adressen dieser einen Sprache für diesen einen Beitrag. Das Original und die anderen Sprachen bleiben unberührt.
Werden Titel, Auszug und Adresse auch übersetzt?
Ja. Titel, Inhalt und Auszug haben jeweils ein eigenes Feld, und ein übersetzter Beitrag wird unter der übersetzten Adresse ausgeliefert, sobald du ihm eine gibst.
Wie übersetze ich ein Menü?
Öffne Mant Multilingual → Navigationsmenüs. Dort steht jedes Menü, das die Website zeigen kann, mit einem Link in seine eigene Übersetzungs-Box.
Warum steht bei manchen Menüs, dass sie keine eigenen Wörter haben?
Weil jeder Eintrag darin eine Seite benennt. Diese Einträge folgen der Seite: Übersetze den Titel der Seite, und das Menü sagt es in jeder Sprache mit, ganz ohne Arbeit im Menü selbst.
Und Einträge, deren Text von Hand eingetippt wurde?
Die stehen in der Übersetzungs-Box des Menüs, jeweils in einem eigenen Feld, und werden dort übersetzt.
Wie wechseln Besucher die Sprache?
Füge den Block Sprachumschalter dort ein, wo du ihn haben willst — üblicherweise in einem Header-Template-Teil. Er verlinkt die aktuelle Seite in jeder Sprache.
Kann er Kürzel statt Sprachnamen zeigen?
Ja. Wähle den Block aus und stelle Anzeige auf Kürzel, dann zeigt er DE und EN statt Deutsch und English.
Gibt es einen Shortcode?
Ja, für klassische Themes und Widget-Bereiche:
Werden Produkte dupliziert?
Nein. Es gibt ein Produkt, mit einem Preis, einem Lagerbestand, einer SKU und einem Satz Downloads. Übersetzt werden nur die Texte: Name, Beschreibung, Kurzbeschreibung.
In welcher Sprache kommen die Bestell-E-Mails?
In der, in der bestellt wurde. Die Bestellung merkt sich ihre Sprache, und E-Mails an Kundinnen und Kunden, Notizen und Rechnungen werden in ihr erzeugt. Post an den Shop selbst bleibt in der Sprache des Admin-Bereichs.
Funktioniert es mit HPOS und dem Block-Checkout?
Ja. Bestellungen werden ausschließlich über die eigene CRUD von WooCommerce gelesen und geschrieben. Die Bestellsprache folgt der Bestellung also in jede Tabelle, die sie hält, und sowohl der klassische als auch der Block-Checkout sind abgedeckt.
Brauche ich WooCommerce?
Nein. Das Plugin läuft auch auf einer Website ohne Shop und ergänzt nichts, solange WooCommerce nicht da ist.
Wie sehen die URLs aus?
Die Ausgangssprache behält die Adressen, die sie immer hatte. Jede andere Sprache wird unter ihrem Präfix ausgeliefert: /de/about/ neben /about/.
Was gibt das Plugin für Suchmaschinen aus?
Das passende html lang für die ausgelieferte Sprache, ein Canonical auf die eigene Adresse dieser Sprache und hreflang-Links zwischen den Sprachen, mit x-default auf der Ausgangssprache.
Stehen Übersetzungen in der Sitemap?
Ja. Die Sitemaps von WordPress bekommen pro Sprache einen eigenen Abschnitt, in dem nur veröffentlichte Übersetzungen stehen.
Was ist mit Yoast oder Rank Math?
Deren Ausgabe bleibt bei ihnen. Das Plugin liefert nur den Sprachkontext, damit ihre Tags die Seite beschreiben, die gerade ausgeliefert wird.
Eigene Felder anderer Plugins
Felder, die andere Plugins an einen Beitrag hängen, sind nicht im Übersetzungs-Editor. Der Editor sagt das auf jedem Bildschirm, statt dich glauben zu lassen, sie wären abgedeckt.
Inhalte von Page-Buildern
Inhalte, die ein Page-Builder statt Blöcken speichert, liegen außerhalb des Feld-Editors.
Die Wörter von WordPress, Themes und Plugins
Schaltflächen wie „In den Warenkorb“ gehören zu WordPress, deinem Theme und deinen Plugins. Installiere deren offizielle Sprachpakete unter Einstellungen → Allgemein, dann übersetzen sie sich selbst.
Die Übersetzung erscheint nicht
Prüfe ihren Status. Eine als Entwurf gespeicherte Übersetzung wird absichtlich nicht ausgeliefert; Besucher bekommen das Original, bis sie veröffentlicht ist.
Eine übersetzte Adresse liefert einen 404
Rufe Einstellungen → Permalinks auf und speichere einmal. Das baut die Rewrite-Regeln neu auf, auf denen die Sprachpräfixe routen.
Das Menü ist noch in der Ausgangssprache
Einträge, die eine Seite benennen, folgen dieser Seite: übersetze den Titel der Seite. Einträge mit eigenem Text werden in der Übersetzungs-Box des Menüs übersetzt.
Etwas wirkt halb übersetzt
Öffne das Übersetzungs-Panel der Seite und sieh nach, welche Felder noch als nicht übersetzt markiert sind. Alles ohne Übersetzung fällt absichtlich auf das Original zurück: eine Seite ist deshalb nie leer und nie halb kaputt.
Was passiert, wenn ich das Plugin deaktiviere?
Die Website liefert die Ausgangssprache genau wie vorher aus, und jede gespeicherte Übersetzung bleibt erhalten und wartet darauf, dass das Plugin wieder eingeschaltet wird.
Was passiert, wenn ich es lösche?
Nichts von dir wird gelöscht, außer du hast darum gebeten. Die eigenen Tabellen des Plugins werden beim Deinstallieren nur dann entfernt, wenn in den Einstellungen „Alle Daten beim Deinstallieren löschen“ eingeschaltet ist. Originale bleiben in jedem Fall unberührt.
Schickt es irgendetwas irgendwohin?
Nein. Es gibt überhaupt keine externen Aufrufe: keinen Übersetzungsdienst, keinen Lizenzserver, keine Nutzungsstatistik. Alles, was das Plugin speichert, bleibt in deiner eigenen Datenbank.
Wo bekomme ich Hilfe?
Nutze die Kontaktseite und schreibe dazu: die Adresse deiner Website, was du erwartet hast, was passiert ist, und einen Screenshot des Übersetzungs-Panels der betreffenden Seite.