Hilfe · Inhalte & Design · Sprachen & Übersetzung

Sprachen und Übersetzung

Ihr Shop kann in mehreren Sprachen verkaufen. Dieser Leitfaden zeigt, wie Sie eine Sprache einschalten, wo Sie welche Texte übersetzen, wie Sie feste Shoptexte in xoLanguage ändern und was DeepL für Sie übersetzt. Dazu erfahren Sie, in welcher Sprache Bestellungen, Mails und Belege laufen.

Auf einen Blick

  • Sprachen: unter Einstellungen → Sprachen / Währungen → Sprachen. In neuen Shops sind 19 Sprachen angelegt, eingeschaltet ist nur Deutsch. „Status Frontend“ zeigt eine Sprache im Shop, „Status Admin“ gibt Ihnen die Reiter zum Übersetzen.
  • Inhalte: Artikel, Kategorien, CMS-Seiten, Newsartikel und Mailvorlagen pflegen Sie je Sprache in eigenen Reitern.
  • Feste Shoptexte: Texte im Warenkorb und Checkout, Knöpfe, die Namen der Zahlarten und der Summenzeilen ändern Sie unter Tools → xoLanguage als „eigener Wert“.
  • DeepL: Mit einem eigenen DeepL-Schlüssel übersetzt ein Knopf über den Textfeldern den Text der Standardsprache. Die automatische Übersetzung im Hintergrund ist das Zusatzmodul Automatische Übersetzung mit DeepL; der XONIC-Support richtet es für Sie ein.
  • Bestellungen: Mails und Belege gehen in der Sprache, in der der Kunde bestellt hat.

In diesem Leitfaden


Wo welcher Text übersetzt wird

Texte stecken an drei Stellen: in den Datensätzen mit einem Reiter je Sprache, in den Sprachdateien und in den Masken einzelner Module. Die Tabelle zeigt, wo Sie was finden.

TextWo Sie ihn übersetzen
Name, Beschreibungen und Metatags eines Artikelsim Artikel unter Produkte → Kategorien / Produkte: Name im Reiter „Allgemein“, Beschreibungen im Reiter „Beschreibung/Tabs“, Metatags im Reiter „SEO“, jeweils je Sprache
KategorienProdukte → Kategorien / Produkte, Kategorie bearbeiten, je Sprache
Merkmale und ihre WerteProdukte → Produktmerkmale, ein Feld je Sprache
ProduktextrafelderProdukte → Produktextrafelder: Jedes Feld gehört zu einer Sprache, siehe Was beim Einschalten passiert
CMS-Seiten und Bausteine wie der FooterCMS → CMS-Manager, siehe CMS & E-Mails
NewsartikelCMS → Newsartikel, siehe Newsartikel
MailvorlagenCMS → Mails & Marketing / Automatisierungen, siehe CMS & E-Mails
Name und Beschreibung einer VersandartEinstellungen → Checkout → Versandarten, Versandart bearbeiten, Reiter je Sprache
Texte einer Zahlart bei der Auswahl, in der Bestellübersicht und in der Bestellbestätigungin der Maske der Zahlart unter Einstellungen → Checkout → Zahlungsarten, siehe Zahlungsarten
Name einer Zahlart, etwa „Vorkasse“Tools → xoLanguage, Sektion der Zahlart, etwa „payment_moneyorder“
Summenzeilen wie „Verpackungskosten“Tools → xoLanguage, Sektion „order_total“
BestellstatusBestellungen → Bestellstatus, ein Feld je Sprache
Titel und SEO-Namen fester Shopseiten wie Warenkorb, Kasse und KontaktEinstellungen → SEO / SEA → Titel & Meta-Tags, siehe SEO & Weiterleitungen
Knöpfe, Texte in Warenkorb, Checkout und Kundenkonto, FehlermeldungenTools → xoLanguage, siehe xoLanguage

Eine Sprache einschalten

Die Sprachen verwalten Sie unter Einstellungen → Sprachen / Währungen → Sprachen. In neuen Shops sind 19 Sprachen angelegt, darunter Englisch, Französisch, Italienisch, Spanisch und Niederländisch. Eingeschaltet ist nur Deutsch. Für die angelegten Sprachen liegen die festen Shoptexte weitgehend übersetzt bei. Einzelne neuere Texte fehlen in manchen Sprachen; sie erscheinen dann in der Standardsprache.

Jede Sprache hat in der Liste zwei Schalter. Sie wirken unabhängig voneinander:

SchalterWirkung
„Status Frontend“Die Sprache erscheint im Shop: in der Sprachauswahl, mit eigenen Adressen und als Ziel der Weiterleitung nach Browsersprache.
„Status Admin“Die Sprache bekommt in den Masken des Backends einen eigenen Reiter, erscheint in xoLanguage und steht bei der Anmeldung im Backend als Sprache zur Wahl.

So gehen Sie vor

  1. In der Liste bei der gewünschten Sprache „Status Admin“ einschalten. Der Shop legt jetzt für Artikel, Kategorien, Seiten, Mailvorlagen und weitere Bereiche eine Fassung in der neuen Sprache an, zunächst als Kopie der Texte der Standardsprache.
  2. Die Texte übersetzen: in den Reitern der neuen Sprache von Hand, mit dem DeepL-Knopf oder mit der automatischen Übersetzung, siehe DeepL.
  3. „Status Frontend“ einschalten. Erst jetzt sehen Ihre Kunden die Sprache.
  4. Mailvorlagen, Rechtstexte und eine Testbestellung prüfen, siehe Checkliste.
Sprachenliste im Backend mit den Spalten Name, Bezeichnung, Codierung (ISO-639-1), Sortierung, Status Frontend und Status Admin: Deutsch (Standard) und English beide aktiv, Français nur unter Status Admin aktiv, Italiano, Español und Nederlands inaktiv

Unter Einstellungen → Sprachen / Währungen → Sprachen schalten Sie „Status Frontend“ und „Status Admin“ je Sprache getrennt; Französisch ist hier erst im Backend eingeschaltet. Zum Vergrößern anklicken.

Schalten Sie „Status Frontend“ erst ein, wenn die Texte übersetzt sind. Sonst sehen Kunden und Suchmaschinen unter den Adressen der neuen Sprache die Texte der Standardsprache.

Standardsprache

Die Standardsprache trägt in der Liste den Zusatz „(Standard)“. Sie lässt sich weder abschalten noch löschen. Aus ihr übersetzt DeepL, und ihre Adressen haben kein Sprachkürzel. Mit „Als Standard definieren“ machen Sie eine andere Sprache zur Standardsprache. Das ändert alle Adressen Ihres Shops. Sprechen Sie einen Wechsel deshalb vorher mit uns ab.

Nur im Frontend

Eine Sprache kann im Shop sichtbar sein, ohne einen Reiter im Backend zu bekommen. Die Liste zeigt dann „Nur Frontend aktiv – Pflege erfolgt automatisch via DeepL, kein Backend-Bearbeitungstab.“ Das passt nur, wenn DeepL alle Texte automatisch übersetzt. Ändern können Sie die Texte dieser Sprache weder in den Masken noch in xoLanguage. Für neu angelegte Artikel und Seiten legt der Shop die Fassung dieser Sprache an, wenn jemand die Seite Sprachen öffnet. Im Regelfall schalten Sie deshalb beide Schalter ein.

Eigene Sprache anlegen

Fehlt eine Sprache, legen Sie sie über den Reiter „Einfügen“ an: „Name“ (so erscheint sie in der Sprachauswahl), „Codierung“ mit zwei Buchstaben nach ISO 639-1, etwa pt, „Sortierreihenfolge“, beide Status und „Sprachwerte aus folgender Sprache dublizieren“. Der Shop kopiert alle Texte und die Sprachdateien der gewählten Sprache. Die festen Shoptexte stehen danach noch in dieser Sprache. Selbst angelegte Sprachen können Sie wieder löschen, mitgelieferte nur abschalten.


Was beim Einschalten passiert

Wird eine Sprache eingeschaltet, im Frontend oder im Backend, ergänzt der Shop alle fehlenden Fassungen dieser Sprache. Er kopiert dafür die Texte der Standardsprache. Was schon übersetzt ist, bleibt.

Kopie der Standardsprache

Artikel, Kategorien, Merkmale, CMS-Seiten, Newsartikel, Mailvorlagen, Versandarten, Bestellstatus und weitere Bereiche erhalten eine Kopie der deutschen Texte. Kundenbewertungen kopiert der Shop nicht: Sie erscheinen nur in der Sprache, in der sie geschrieben wurden.

Produktextrafelder

Ein Extrafeld gehört immer zu einer Sprache. Felder, die Sie für Deutsch angelegt haben, erscheinen in der neuen Sprache nicht und werden nicht kopiert. Legen Sie unter Produkte → Produktextrafelder eigene Felder für die neue Sprache an und füllen Sie sie im Artikel. „Sprache“ = „Alle“ legt ein Feld je Sprache mit „Status Admin“ an.

Adressen

Seiten einer weiteren Sprache tragen vorne /lng/ und das Sprachkürzel, etwa /lng/en/. Dahinter steht zunächst der kopierte deutsche Name. Erst wenn Sie den Namen übersetzen, lautet auch die Adresse in der neuen Sprache, siehe SEO-Namen.

Feste Shopseiten

Fehlt einer festen Shopseite wie der Kasse ein Name in der neuen Sprache, übernimmt der Shop den deutschen Namen mit angehängtem Sprachkürzel, etwa kasse-en. So bleibt jede Adresse eindeutig. Übersetzen Sie die Namen unter Einstellungen → SEO / SEA → Titel & Meta-Tags.


Sprachwechsel im Shop

Sobald mehr als eine Sprache den „Status Frontend“ hat, zeigt der Shop im Kopfbereich eine Sprachauswahl. Der Wechsel führt auf dieselbe Seite in der anderen Sprache.

Oben der Kopfbereich des Shops mit dem Globus-Symbol zwischen Suche und Kundenkonto, darunter dieselbe Kategorieseite mit geöffnetem Fenster „Sprache“ am rechten Rand und den Einträgen DE – Deutsch (ausgewählt) und EN – English

Ein Klick auf das Globus-Symbol im Kopfbereich öffnet die Sprachauswahl am rechten Rand. Zum Vergrößern anklicken.

Sprachauswahl

Ein- und ausblenden mit Einstellungen → Design → Header (Kopfbereich) → Sprachauswahl im Header an/aus, ab Werk an. Die Reihenfolge der Sprachen legt die „Sortierreihenfolge“ der Sprache fest.

Adressen je Sprache

Die Standardsprache hat Adressen ohne Kürzel, weitere Sprachen beginnen mit /lng/en/, /lng/fr/ usw. Alte Links mit ?language=en leitet der Shop dauerhaft auf die neue Form um.

Nach Browsersprache

Mit Einstellungen → Allgemein → Grundeinstellungen → Shopsprache an Browsersprache anpassen (ab Werk aus) leitet der Shop Besucher beim ersten Aufruf auf die Fassung in ihrer Browsersprache, sofern diese Sprache im Shop eingeschaltet ist. Wer danach selbst wechselt, behält seine Wahl. Suchmaschinen leitet der Shop nicht um.ab 4.9.47

Warenkorb

Nach einem Sprachwechsel zeigt der Warenkorb die gewählten Merkmale in der neuen Sprache, und so stehen sie auch in der Bestellung. Fehlt der Name eines Merkmals in dieser Sprache, nimmt der Shop den Namen der Standardsprache.ab 4.9.33

Ein Sprachwechsel ändert die Währung nicht, siehe Währung je Land.


Inhalte je Sprache übersetzen

Artikel, Kategorien, CMS-Seiten, Newsartikel, Mailvorlagen und viele weitere Datensätze haben für jede Sprache mit „Status Admin“ einen eigenen Reiter oder ein eigenes Feld mit dem Sprachkürzel.

Leeres Feld wird Kopie

Lassen Sie ein Feld einer weiteren Sprache leer, kopiert der Shop beim Speichern den Text der Standardsprache hinein. Ändern Sie später den deutschen Text, bleibt die Kopie, wie sie ist. Pflegen Sie dann beide Sprachen oder lassen Sie die automatische Übersetzung arbeiten.

Übersetzen per DeepL

Ist ein DeepL-Schlüssel hinterlegt, steht in den Reitern der weiteren Sprachen rechts über jedem Textfeld der Knopf „Übersetzen per DeepL“ oder kurz „DeepL“. Er übersetzt den Text aus dem Feld der Standardsprache, so wie er gerade in der Maske steht. Speichern Sie danach wie gewohnt.

Links im Text

Verlinken Sie Seiten Ihres Shops über den Link-Dialog des Editors, für CMS-Seiten über die Auswahlliste „CMS Links“, oder mit einer Adresse ohne Domain, etwa store-cms.php?cID=<ID>. Daraus baut der Shop die Adresse in der Sprache des Besuchers. Eine vollständige Adresse mit https:// übernimmt er unverändert; sie führt immer auf dieselbe Sprachfassung.

Artikelmaske, Reiter Beschreibung/Tabs, Sprachreiter EN mit englischer Produktbeschreibung (kurz) und Produktbeschreibung; über jedem Feld rechts der Knopf „Übersetzen per DeepL“

Im Reiter EN übersetzt „Übersetzen per DeepL“ den Text aus dem deutschen Feld in das Feld darunter; danach speichern Sie wie gewohnt. Zum Vergrößern anklicken.

Gut zu wissen

  • ContentEditor: Bauen Sie die Seite in der Standardsprache fertig, bevor Sie übersetzen, siehe ContentEditor.
  • Hersteller: Die Herstellertexte übersetzt die automatische Übersetzung nicht. Nutzen Sie dort den DeepL-Knopf in der Maske unter Produkte → Hersteller.
  • Kundenbewertungen bleiben in der Sprache des Verfassers. Eine Übersetzung gibt es nicht.

Feste Shoptexte ändern: xoLanguage

Texte, die zu keinem Artikel und keiner Seite gehören, stehen in den Sprachdateien: Knöpfe, die Texte im Warenkorb, im Checkout und im Kundenkonto, Fehlermeldungen sowie die Namen der Zahlarten und der Summenzeilen. Sie ändern sie unter Tools → xoLanguage.

  1. Unter „Framework“ „Frontend“ lassen. Dort stehen die Texte des Shops; „Backend“ enthält die Texte des Backends.
  2. Unter „Sektion“ die Seite wählen, auf der der Text steht (Tabelle unten). Mit den Pfeilen neben der Auswahl oder den Pfeiltasten Ihrer Tastatur blättern Sie zur vorigen oder nächsten Sektion. Rot hinterlegte Sektionen enthalten Texte, die in einer Sprache noch fehlen.
  3. Den Text mit der Suche Ihres Browsers finden (Strg+F, am Mac cmd+F). Eine Suche über alle Sektionen gibt es nicht.
  4. In der Zeile auf „eigener Wert“ klicken und den neuen Text je Sprache in die zusätzliche Zeile eintragen.
  5. „Aktualisieren“ klicken und die Shopseite neu laden.
xoLanguage mit Framework Frontend und Sektion order_total, darunter (übrige Schlüssel der Sektion ausgelassen) die Zeile MODULE_ORDER_TOTAL_PACKAGING_COSTS_TITLE mit „Verpackungskosten“ und „Packaging costs“ und die gelb hinterlegte Zeile des eigenen Werts mit „Verpackungspauschale“ und „Packaging fee“

Ihren eigenen Wert tragen Sie je Sprache in die gelbe Zeile unter dem mitgelieferten Text ein, hier „Verpackungspauschale“ statt „Verpackungskosten“ (Ausschnitt). Zum Vergrößern anklicken.

Tragen Sie Ihre Änderung immer als „eigener Wert“ ein. Ihre eigenen Werte speichert der Shop in einer eigenen Datei, die kein Update überschreibt. Die obere Zeile mit dem mitgelieferten Text ersetzt dagegen jedes Update; für normale Administratoren ist sie ohnehin gesperrt. Ist schon ein eigener Wert gespeichert, steht er gelb direkt unter dem Schlüssel.

Welche Sektion zu welcher Seite gehört

Wo der Text stehtSektion
auf allen Seiten: Kopf, Fuß, Knöpfe, Texte in Mails, Anrededefault
Warenkorbstore-checkout-cart
Anmeldung und Registrierung, auch auf dem Weg zur Kassecustomer-login
Checkout: Versand, Zahlung, Bestellung prüfen, Bestellabschlusscheckout-step2, checkout-step3, checkout-step4, checkout-step6
Kundenkonto, etwa Adressbuch und persönliche Datencustomer, customer-address, customer-edit und weitere mit customer-
Produktseitestore-products
Summenzeilen wie Verpackungskostenorder_total
Zusätze zu Versandarten wie „Versand nach“shipping
Name und Beschreibung einer Zahlartpayment_ und der Modulname, etwa payment_moneyorder für Vorkasse
Fehlermeldungen in Formularenform-errors

Beispiele

Verpackungskosten umbenennen

Sektion „order_total“, Schlüssel MODULE_ORDER_TOTAL_PACKAGING_COSTS_TITLE (ab Werk „Verpackungskosten“). Tragen Sie den eigenen Wert je Sprache ein, etwa „Verpackungspauschale“ und „Packaging fee“.

Zahlart umbenennen

Für die Vorkasse: Sektion „payment_moneyorder“, Schlüssel MODULE_PAYMENT_MONEYORDER_TEXT_TITLE. Die übrigen Zahlarten haben je eine eigene Sektion mit payment_ vorne.

Anmelden und Registrieren

Sektion „customer-login“, etwa TEXT_AUTH_LOGIN_HEADING („Willkommen zurück“), TEXT_AUTH_REGISTER_HEADING („Konto erstellen“) und TEXT_AUTH_GUEST_NOW („Als Gast bestellen“).

Hinweis im Warenkorb

Sektion „store-checkout-cart“, etwa TEXT_INFO_SHIPPING_ESTIMATOR („Eventuelle Rabatte oder Gutschriften werden erst berechnet, wenn Sie zur Kasse gehen!“) oder der Hinweis zu nicht vorrätigen Artikeln OUT_OF_STOCK_CAN_CHECKOUT. Derselbe Schlüssel steht oft auch in der Sektion eines Checkout-Schritts; ändern Sie ihn dort ebenfalls.

„Adressbuch“

Die Überschrift „Mein Adressbuch“ steht in der Sektion „customer-address“. Das Wort kommt auch in „customer-address-change“, „checkout-step2“ und „checkout-step3“ vor. Ein Text steht oft in mehreren Sektionen; prüfen Sie nach der Änderung jede Seite.

Gut zu wissen

  • Welche Sprachen: xoLanguage zeigt eine Spalte je Sprache mit „Status Admin“.
  • Fehlender Text: Fehlt ein Text in einer Sprache, zeigt der Shop den Text der Standardsprache.
  • DeepL in xoLanguage: Ist ein DeepL-Schlüssel hinterlegt, steht unter leeren Feldern ein Knopf „DeepL“. „Custom DeepL“ übersetzt Ihre eigenen Werte der Sektion aus dem deutschen eigenen Wert in die leeren Felder der anderen Sprachen. Danach „Aktualisieren“ klicken. Die automatische Übersetzung erfasst die Sprachdateien nicht.
  • Rote Meldung zu max_input_vars: xoLanguage braucht die PHP-Einstellung max_input_vars mit mindestens 100000. Fehlt sie, zeigt die Seite statt der Texte diese Meldung; Ihr Hoster muss den Wert erhöhen.

Versandarten, Zahlarten, Status und Mails

Einige Texte pflegen Sie direkt in der Maske des Moduls, je Sprache in einem eigenen Reiter oder Feld.

Versandarten

Unter Einstellungen → Checkout → Versandarten die Versandart bearbeiten. In den Reitern je Sprache stehen „Name“ und „Beschreibung“. Ein leerer Name übernimmt beim Speichern den Namen der Standardsprache. Wie Sie Versandarten anlegen, zeigt Versand & Lieferung.

Zahlarten

Die Texte bei der Auswahl, in der Bestellübersicht und in der Bestellbestätigung stehen in der Maske der Zahlart unter den Feldern, je Sprache ein Reiter. Den Namen selbst, etwa „Vorkasse“, ändern Sie in xoLanguage. Details unter Zahlungsarten.

Bestellstatus

Unter Bestellungen → Bestellstatus hat jeder Status ein Feld je Sprache. Im Kundenkonto sieht der Kunde den Status in der Sprache, in der er den Shop gerade nutzt, in der Statusmail in der Sprache der Bestellung.

Mailvorlagen

Unter CMS → Mails & Marketing / Automatisierungen hat jede Vorlage einen Reiter je Sprache, mit DeepL-Knöpfen für Betreff und Text. Prüfen Sie jede Vorlage in der neuen Sprache, siehe CMS & E-Mails.

Versandart „Versandkosten 1“ bearbeiten unter Einstellungen → Checkout → Versandarten, Sprachreiter EN mit Name „Standard shipping“ und Beschreibung „Delivery in 2–3 working days“

Name und Beschreibung der Versandart pflegen Sie in deren Maske, je Sprache in einem eigenen Reiter. Zum Vergrößern anklicken.


Den Shop auf Du umstellen

Eine fertige Du-Fassung der deutschen Texte gibt es nicht. Die mitgelieferten Texte siezen. Für die Du-Form ändern Sie die Texte an diesen Stellen.

  1. Feste Shoptexte in xoLanguage je Sektion als eigener Wert. Beginnen Sie mit „default“, „store-checkout-cart“, „customer-login“ und den Checkout-Sektionen „checkout-step2“ bis „checkout-step6“, danach die Sektionen des Kundenkontos.
  2. Anrede in Mails: In den Mailvorlagen den Platzhalter {SALUTATION} („Sehr geehrte Frau Musterfrau“) durch {SALUTATION_INFORMAL} („Hallo Erika“) ersetzen. Die Anredeformeln stehen in xoLanguage, Sektion „default“, Schlüssel SALUTATION_FORMAL … und SALUTATION_INFORMAL ….
  3. Mailvorlagen und CMS-Seiten im jeweiligen Reiter umformulieren, ebenso die Texte der Zahlarten und Versandarten.
  4. Den Shop einmal durchklicken: Warenkorb, Anmeldung, Checkout, Kundenkonto und eine Testbestellung mit allen Mails.

DeepL einrichten

DeepL übersetzt im Backend Texte aus der Standardsprache in Ihre weiteren Sprachen. Sie brauchen dafür ein eigenes Konto bei DeepL mit Zugang zur Programmierschnittstelle (API), kostenlos oder kostenpflichtig.

  1. In Ihrem DeepL-Konto den API-Schlüssel kopieren.
  2. Unter Einstellungen → Schnittstellen → Übersetzungs-Tools → DeepL den Schlüssel in „DeepL Authkey“ eintragen.
  3. „DeepL API-Modus“ passend zum Konto wählen: free für das kostenlose Konto, paid für das bezahlte. Danach richtet der Shop seine Anfragen an die passende Adresse bei DeepL.
  4. Speichern. Ab jetzt stehen in den Masken die DeepL-Knöpfe.
Einstellungen → Schnittstellen → Übersetzungs-Tools → DeepL mit den Feldern DeepL Authkey (Platzhalter-Schlüssel aus Nullen), DeepL API-Modus paid und leerer DeepL Tag-Handling-Version

Schlüssel und API-Modus müssen zum DeepL-Konto passen: paid für das bezahlte, free für das kostenlose Konto. Zum Vergrößern anklicken.

Auf Pro umstellen

Tragen Sie den Schlüssel des bezahlten Kontos ein und stellen Sie „DeepL API-Modus“ auf paid. Schlüssel und Modus müssen zusammenpassen, sonst schlagen die Übersetzungen fehl. Läuft bei Ihnen die automatische Übersetzung, sagen Sie uns vorher Bescheid: Ihre Aufgabe im Hintergrund hängt am Schlüssel und muss mit ihm angepasst werden.

Anmeldung bei DeepL

Der Shop schickt den Schlüssel im Kopf jeder Anfrage an DeepL, nicht in der Adresse. So arbeitet XONIC 4 von Anfang an. Wegen geänderter Anmeldeverfahren bei DeepL müssen Sie nichts anpassen.

Kontingent

DeepL rechnet nach Zeichen ab. Ist das Kontingent aufgebraucht, meldet der Knopf „DeepL-Kontingent aufgebraucht …“ und lässt das Feld unverändert. Die automatische Übersetzung hält an und macht beim nächsten Lauf weiter. Bei einem falschen Schlüssel erscheint „DeepL: Authentifizierung fehlgeschlagen …“.

Tag-Handling-Version

Lassen Sie „DeepL Tag-Handling-Version“ leer. Dann gilt die Einstellung Ihres DeepL-Kontos. Eine Version setzen Sie nur, wenn Ihr Konto sie sicher unterstützt.


Automatische Übersetzung mit DeepL

Statt Feld für Feld kann der Shop Ihre Inhalte regelmäßig im Hintergrund übersetzen. Diese automatische Übersetzung ist das Zusatzmodul XONIC Premium: Automatische Übersetzung mit DeepL. Nach der Buchung richtet der XONIC-Support sie für Sie ein. Dabei legen wir mit Ihnen fest, in welche Sprachen und welche Bereiche übersetzt werden. Den DeepL-Knopf über den Textfeldern nutzen Sie auch ohne Zusatzmodul.

Was übersetzt wird

Kategorien, Artikel (Name, Beschreibungen, Checkout-Beschreibung, Metatags, Bildtitel), Produkt-Tabs, Merkmale und Werte, CMS-Seiten und Boxen, Mailvorlagen, Newsartikel und Newskategorien, FAQ, Slider, Versandarten und Versandprofile, Abholorte, Kupons, Bestellstatus, Produkt-Badges, Textbausteine sowie Titel und Beschreibung der Startseite. Übersetzt wird in alle eingeschalteten Sprachen, wenn wir nichts anderes festlegen.

Was nicht übersetzt wird

Die Sprachdateien, also auch Ihre eigenen Werte aus xoLanguage, außerdem Herstellertexte, Produktextrafelder und Kundenbewertungen. Diese Texte übersetzen Sie selbst, in xoLanguage und in den Masken auch mit dem DeepL-Knopf.

Wann übersetzt wird

Jeder Lauf übersetzt, was DeepL noch nie übersetzt hat, und alles, dessen Text in der Standardsprache sich seitdem geändert hat. Ob ein Feld in der Zielsprache leer ist, spielt keine Rolle: Auch ein gefülltes Feld, etwa die Kopie des deutschen Textes oder Ihre eigene Übersetzung, überschreibt der Lauf, solange DeepL den Datensatz noch nicht übersetzt hat.

Reihenfolge und Dauer

Je Lauf und Bereich übersetzt der Shop bis zu 100 Datensätze. Kleine Bereiche wie Kategorien, CMS-Seiten und Mailvorlagen kommen zuerst, der Artikelkatalog zuletzt. Ein großer Katalog braucht deshalb mehrere Läufe.

Vor dem ersten Lauf: Der erste Lauf übersetzt alles, was DeepL noch nie übersetzt hat, und überschreibt dabei vorhandene Übersetzungen in den Zielsprachen. Er verbraucht entsprechend viele Zeichen Ihres Kontingents. Sagen Sie dem Support vorher, welche Bereiche Sie selbst übersetzt haben; diese lassen sich ausnehmen.

Wenn Sie den deutschen Text ändern

  • Speichern Sie einen Datensatz mit geändertem Text in der Standardsprache, übersetzt der nächste Lauf ihn in allen Zielsprachen neu, und zwar alle Felder des Datensatzes. Eigene Korrekturen in einer Zielsprache überschreibt er dabei. Korrigieren Sie deshalb erst nach dem Lauf.
  • Speichern Sie ohne Textänderung, etwa nach einer Preis- oder Bestandsänderung, übersetzt der Shop nichts neu.
  • Übersetzt DeepL einen Namen neu, kann sich die Adresse in der Zielsprache ändern. Die alte Adresse leitet der Shop weiter, siehe SEO-Namen.
  • Ohne automatische Übersetzung klicken Sie in den Reitern der anderen Sprachen erneut auf „Übersetzen per DeepL“ und speichern.

Unter Tools → Serverinfo & Health-Check meldet der Shop, wenn DeepL eingerichtet ist, Texte auf Übersetzung warten und seit zwei Tagen nichts übersetzt wurde. Dann läuft die Aufgabe im Hintergrund nicht mehr; sprechen Sie uns an.ab 4.9.139


Kosten sparen, Bereiche schützen, Glossar

Was nicht an DeepL geht, zählt auch nicht für Ihr Kontingent. Und was einmal übersetzt ist, übersetzt der Shop nur neu, wenn sich der Ausgangstext ändert.

Bereiche schützen

Was im Quelltext zwischen <!-- xo:notranslate --> und <!-- /xo:notranslate --> steht, schickt der Shop nicht an DeepL. Er ersetzt es vor dem Senden durch einen kurzen Platzhalter und setzt es danach unverändert wieder ein. Setzen Sie die beiden Marken in der Quelltext-Ansicht des Editors um Code, Maßtabellen oder eingebettete Inhalte.

Schon geschützt

Skripte und Stilangaben, eingebettete Videos, Audio und iFrames, Elemente mit translate="no", Platzhalter wie {STORE_NAME} oder %s und die Bausteine Code, Video, Formular, Countdown und Produktliste des ContentEditors gehen nicht als Text an DeepL.

Keine doppelten Übersetzungen

Der Shop merkt sich je Datensatz und Sprache den Stand, den DeepL übersetzt hat. Speichern ohne Textänderung, Importe mit unverändertem Text und Abgleiche aus der Warenwirtschaft lösen keine neue Übersetzung aus. Ein vollständiges Zurücksetzen dieses Stands kann nur der Support auslösen; danach übersetzt der Lauf alles neu.

Sprachen und Bereiche begrenzen

Wir können die Zielsprachen festlegen und einzelne Bereiche oder Felder ausnehmen. Bei Artikeln geht das getrennt für Einzelartikel, Hauptartikel und Varianten, etwa nur den Namen der Varianten übersetzen.

Glossar für feste Begriffe

Begriffe, die DeepL immer gleich übersetzen soll, etwa Produktnamen oder Fachwörter, hinterlegen wir in einem Glossar je Sprachpaar. Für Deutsch nach Englisch heißt es DE_EN. Je Begriff gibt es genau eine Übersetzung.

  • Das Glossar wirkt bei der automatischen Übersetzung ab dem nächsten Lauf. Der Knopf „Übersetzen per DeepL“ in den Masken nutzt es nicht.
  • Ein Glossar legt nur die Übersetzung der eingetragenen Begriffe fest. Umschreibungen fängt es nicht ab. Prüfen Sie wichtige Seiten nach dem Lauf.
  • Begriffe mit mehreren Bedeutungen gehören nicht ins Glossar, sonst übersetzt DeepL sie überall gleich.

Bestellsprache und Kundensprache

Jede Bestellung und jedes Kundenkonto hat eine Sprache. Danach richten sich Mails und Belege.

Bestellung im Shop

Die Bestellsprache ist die Sprache, in der der Kunde bestellt hat. In ihr gehen Bestellbestätigung und Statusmails, und in ihr erstellt der Shop Rechnung und andere Belege. Ändern lässt sie sich im Bestelleditor im Feld „Kundensprache“; zur Wahl stehen die Sprachen mit „Status Admin“, siehe Bestellungen.

Kundenkonto

Bei der Registrierung bekommt das Konto die Sprache, in der der Kunde gerade einkauft. Er ändert sie unter „Mein Konto“, „Meine persönlichen Daten“ im Feld „Sprache“. Sie ändern sie im Kunden im Reiter „Kundendaten“, Feld „Kundensprache“. Mails zum Konto, etwa zum Passwort, gehen in dieser Sprache.

Bestellungen von Marktplätzen und Schnittstellen

Entsteht eine Bestellung ohne den Checkout des Shops, etwa von einem Marktplatz, aus Billbee oder über die xoPort-Schnittstelle, bekommt sie diese Sprache:

  1. die Sprache, die der Anbieter zur Bestellung mitliefert, etwa Billbee, Galaxus und die Mirakl-Marktplätze, bei xoPort die übergebene Sprache,
  2. sonst die Sprache des Kundenkontos,
  3. sonst die Standardsprache des Shops.

Es zählen nur Sprachen, die im Shop eingeschaltet sind. Amazon, eBay, Kaufland und OTTO liefern keine Sprache mit; Bestellungen von dort laufen in der Sprache des Kundenkontos oder in der Standardsprache, auch vom ausländischen Marktplatz.ab 4.9.135


Suchmaschinen: Adressen, hreflang, Sitemap

Jede Sprache hat eigene Adressen. Damit Suchmaschinen die Sprachfassungen richtig zuordnen, erledigt der Shop das meiste selbst.

  • hreflang: Jede Seite nennt ihre Fassungen in den anderen eingeschalteten Sprachen und die Standardsprache als x-default. Einstellungen für einen Multishop mit einer Domain je Markt finden Sie unter SEO & Weiterleitungen: hreflang.
  • SEO-Namen: Übersetzen Sie die Namen, damit die Adressen in der jeweiligen Sprache lauten, siehe SEO-Namen.
  • Sitemap: Nehmen Sie die neue Sprache unter Einstellungen → SEO / SEA → SEO Einstellungen → SEO Sitemaps Sprachen auf, siehe Sitemaps.
  • Sprache wieder abschalten: Schalten Sie eine Sprache im Frontend ab, leitet der Shop deren bisherige Adressen von Artikeln, Kategorien, CMS-Seiten und Newsartikeln dauerhaft auf die Fassung in der Standardsprache um.

Währung je Land

Sprache und Währung sind getrennt. Ein Sprachwechsel ändert die Währung nicht.

Mit Einstellungen → Checkout → Allgemein → Automatischer Währungswechsel: Zielland (ab Werk an) wechselt die Währung mit dem Lieferland, etwa zu CHF für die Schweiz und zu EUR für EU-Länder, sofern Sie die Währung unter Einstellungen → Sprachen / Währungen → Währungen angelegt haben. Kurse und den Wechsel nach IP-Adresse beschreibt der Leitfaden Preise & Kundengruppen.


Checkliste: neue Sprache live schalten

Gehen Sie diese Punkte der Reihe nach durch, bevor Ihre Kunden die neue Sprache sehen.

  1. „Status Admin“ einschalten, „Status Frontend“ noch aus lassen.
  2. Inhalte übersetzen: von Hand, mit dem DeepL-Knopf oder mit dem Zusatzmodul für die automatische Übersetzung.
  3. In xoLanguage Ihre eigenen Werte für die neue Sprache übersetzen und die rot hinterlegten Sektionen prüfen: Dort fehlen Texte in einer Sprache.
  4. Produktextrafelder für die neue Sprache anlegen und füllen.
  5. Mailvorlagen, Rechtstexte und die Texte der Zahlarten in der neuen Sprache prüfen, siehe Rechtstexte.
  6. Namen und SEO-Namen prüfen, die Sprache in die Sitemap aufnehmen.
  7. „Status Frontend“ einschalten und die Sprachauswahl im Shop prüfen.
  8. Eine Testbestellung in der neuen Sprache aufgeben und Bestellbestätigung, Statusmail und Rechnung prüfen.


Häufige Fragen

Wie schalte ich eine zusätzliche Sprache im Frontend ein?

Unter Einstellungen → Sprachen / Währungen → Sprachen bei der Sprache „Status Admin“ einschalten, die Texte übersetzen und danach „Status Frontend“ einschalten. Die Sprachauswahl erscheint im Kopf des Shops, sobald zwei Sprachen den „Status Frontend“ haben und „Sprachauswahl im Header an/aus“ eingeschaltet ist. Alle Schritte unter Sprache einschalten.

Was passiert mit Produktfeldern und SEO-Adressen, wenn ich eine neue Sprache einschalte?

Der Shop kopiert die Texte der Standardsprache in die neue Sprache, auch die SEO-Namen. Die Adressen lauten deshalb zunächst /lng/en/ plus der deutsche Name, bis Sie die Namen übersetzen. Produktextrafelder kopiert er nicht, denn jedes Extrafeld gehört zu einer Sprache. Legen Sie sie für die neue Sprache an. Details unter Was beim Einschalten passiert.

Wo übersetze ich Bezeichnungen wie die Verpackungspauschale?

Unter Tools → xoLanguage, Framework „Frontend“, Sektion „order_total“, Schlüssel MODULE_ORDER_TOTAL_PACKAGING_COSTS_TITLE. Klicken Sie auf „eigener Wert“, tragen Sie den Text je Sprache ein und klicken Sie auf „Aktualisieren“. Die anderen Summenzeilen stehen in derselben Sektion.

Wie übersetze ich die Namen von Versandarten und Zahlarten?

Versandarten: unter Einstellungen → Checkout → Versandarten die Versandart bearbeiten und im Reiter der Sprache „Name“ und „Beschreibung“ eintragen. Zahlarten: den Namen in xoLanguage in der Sektion der Zahlart, etwa „payment_moneyorder“ für Vorkasse; die Texte zur Zahlart in deren Maske je Sprache.

Wie finde ich einen Text in xoLanguage, zum Beispiel „Adressbuch“?

Wählen Sie die Sektion der Seite, auf der der Text steht. Die Sektion heißt wie die Seite, für das Adressbuch „customer-address“. Auf der Seite suchen Sie mit Strg+F. Texte, die auf allen Seiten vorkommen, stehen in „default“. Die Tabelle der Sektionen finden Sie unter xoLanguage.

Wo ändere ich den Hinweistext im Warenkorb?

In xoLanguage, Sektion „store-checkout-cart“. Dort stehen alle Texte der Warenkorbseite, etwa TEXT_INFO_SHIPPING_ESTIMATOR („Eventuelle Rabatte oder Gutschriften werden erst berechnet, wenn Sie zur Kasse gehen!“) und der Hinweis zu nicht vorrätigen Artikeln (OUT_OF_STOCK_CAN_CHECKOUT). Tragen Sie Ihren Text als „eigener Wert“ ein.

Wie benenne ich die Texte für Anmelden und Registrieren im Checkout um?

In xoLanguage, Sektion „customer-login“. Die Seite für Anmeldung und Registrierung ist dieselbe, ob der Kunde von der Kasse kommt oder nicht. Beispiele: TEXT_AUTH_LOGIN_HEADING, TEXT_AUTH_REGISTER_HEADING, TEXT_AUTH_GUEST_NOW.

Gibt es die deutschen Shoptexte in der Du-Form?

Nein. Die mitgelieferten Texte siezen. Sie stellen auf Du um, indem Sie die Texte in xoLanguage als eigene Werte ändern, in den Mailvorlagen {SALUTATION_INFORMAL} statt {SALUTATION} verwenden und CMS-Seiten sowie Zahlart- und Versandtexte umformulieren. Die Reihenfolge steht unter Du statt Sie.

Warum öffnet ein Link in einer CMS-Seite in einer anderen Sprache die falsche Sprachfassung?

Meist steht im Text eine vollständige Adresse mit https://. Die übernimmt der Shop unverändert, sie führt also immer auf dieselbe Sprache. Setzen Sie den Link über den Link-Dialog des Editors („CMS Links“) oder als Adresse ohne Domain wie store-cms.php?cID=<ID>. Dann baut der Shop die Adresse in der Sprache des Besuchers.

Warum erscheint ein Merkmal nach dem Sprachwechsel im Warenkorb in der falschen Sprache?

Der Warenkorb stellt die Merkmale beim Sprachwechsel auf die neue Sprache um. Erscheint ein Merkmal trotzdem in der Standardsprache, fehlt sein Name in der gewählten Sprache. Tragen Sie ihn unter Produkte → Produktmerkmale ein.ab 4.9.33

Wie aktiviere ich die automatische Übersetzung per DeepL?

Buchen Sie das Zusatzmodul XONIC Premium: Automatische Übersetzung mit DeepL und tragen Sie Ihren DeepL-Schlüssel unter Einstellungen → Schnittstellen → Übersetzungs-Tools → DeepL ein. Die Übersetzung im Hintergrund richtet der XONIC-Support ein und legt mit Ihnen Sprachen und Bereiche fest. Lesen Sie vorher Automatische Übersetzung.

Kostet die automatische Übersetzung extra?

Ja. Die automatische Übersetzung im Hintergrund ist das Zusatzmodul XONIC Premium: Automatische Übersetzung mit DeepL. Den DeepL-Knopf über den Textfeldern nutzen Sie ohne Zusatzmodul. In beiden Fällen rechnet DeepL die übersetzten Zeichen direkt mit Ihnen ab.

Wie hinterlege ich DeepL-Zugangsdaten und stelle auf den Pro-Tarif um?

Unter Einstellungen → Schnittstellen → Übersetzungs-Tools → DeepL den Schlüssel in „DeepL Authkey“ eintragen und „DeepL API-Modus“ wählen: free für das kostenlose Konto, paid für DeepL Pro. Beim Wechsel auf Pro tragen Sie den neuen Schlüssel ein und stellen den Modus auf paid.

Muss ich wegen der geänderten Anmeldung bei der DeepL-API etwas anpassen?

Nein. Der Shop schickt den Schlüssel seit jeher im Kopf der Anfrage an DeepL. Prüfen Sie nur, ob Schlüssel und „DeepL API-Modus“ zu Ihrem DeepL-Konto passen.

Wie aktualisiere ich Übersetzungen, wenn ich den deutschen Text ändere?

Mit automatischer Übersetzung: Speichern Sie den geänderten deutschen Text. Der nächste Lauf übersetzt den Datensatz in allen Zielsprachen neu und überschreibt dabei eigene Korrekturen. Ohne automatische Übersetzung: in den Reitern der anderen Sprachen erneut „Übersetzen per DeepL“ klicken und speichern. Kopien aus leeren Feldern ziehen nicht von selbst nach.

Wie vermeide ich, dass DeepL bereits übersetzte Artikel mehrfach übersetzt?

Das erledigt der Shop selbst: Er übersetzt einen Artikel nur neu, wenn sich der Text in der Standardsprache geändert hat. Speichern ohne Textänderung, Bestandsabgleiche und Importe mit gleichem Text kosten nichts. Neu übersetzt wird außerdem alles, wenn der gemerkte Stand zurückgesetzt wird; das löst nur der Support aus.

Wie vermeide ich, dass HTML-Code die DeepL-Kosten erhöht?

Schließen Sie Code, Tabellen mit Maßen oder eingebettete Inhalte im Quelltext zwischen <!-- xo:notranslate --> und <!-- /xo:notranslate --> ein. Diese Bereiche schickt der Shop nicht an DeepL. Skripte, eingebettete Videos und die Code-, Video-, Formular-, Countdown- und Produktlisten-Bausteine des ContentEditors schützt er ohnehin.

Warum hat DeepL meine eigene Übersetzung überschrieben?

Der Lauf übersetzt jeden Datensatz, den DeepL noch nie übersetzt hat, auch wenn die Zielsprache schon gefüllt ist. Und er übersetzt neu, sobald sich der deutsche Text ändert. Korrigieren Sie deshalb erst nach dem Lauf, und sagen Sie uns, welche Bereiche wir ausnehmen sollen.

Warum bleiben meine eigenen Texte aus xoLanguage in der neuen Sprache deutsch?

Die automatische Übersetzung erfasst die Sprachdateien nicht. Tragen Sie den eigenen Wert für jede Sprache ein. Mit DeepL-Schlüssel übersetzt „Custom DeepL“ in xoLanguage die eigenen Werte einer Sektion aus dem deutschen Wert in die leeren Felder der anderen Sprachen.

In welcher Sprache bekommt ein Kunde Bestellbestätigung und Rechnung?

In der Sprache der Bestellung, also der Sprache, in der er bestellt hat. Ändern können Sie sie im Bestelleditor im Feld „Kundensprache“. Mails zum Kundenkonto gehen in der Sprache des Kontos.

Warum laufen Bestellungen vom französischen Marktplatz auf Deutsch?

Amazon, eBay, Kaufland und OTTO liefern zur Bestellung keine Sprache mit. Die Bestellung bekommt dann die Sprache des Kundenkontos, sonst die Standardsprache des Shops. Hat Französisch den „Status Admin“, können Sie die Sprache im Bestelleditor ändern.

Weiterführende Leitfäden

Wir richten Ihre Sprachen mit Ihnen ein

Wir helfen beim Einrichten der automatischen Übersetzung, bei der Auswahl der Bereiche und beim Glossar, und wenn ein Text nicht dort steht, wo Sie ihn suchen.

Jetzt Support kontaktieren