Anwenderdokumentation

So funktioniert der Übersetzungs-Agent für euren Shopware-6-Shop

In dieser Dokumentation erfährst du, wie du Reqser nutzt, um euren Shop automatisch in mehrere Sprachen zu übersetzen. Von der automatischen Inhaltserkennung über den Übersetzungseditor bis hin zum Wörterbuch – hier findest du alles, was du für den Einstieg brauchst.

Das solltet ihr nach dem Abschluss beachten

Fremdsprachige Inhalte nicht direkt in Shopware bearbeiten – nutze stattdessen unseren Übersetzungseditor, damit deine Änderungen nicht beim nächsten Crawling überschrieben werden.

Testbestellung in jeder Fremdsprache durchführen – so stellst du sicher, dass der gesamte Bestell- und Checkout-Prozess in allen Sprachen korrekt funktioniert.

Fremdsprachige Inhalte prüfen und Fehler melden – schau dir euren Shop in den einzelnen Sprachen an und melde Auffälligkeiten direkt an uns oder an eure Agentur.

1. Überblick

Herzlichen Glückwunsch – euer Shop ist nun vollständig automatisiert! Reqser übernimmt ab sofort die Übersetzung eurer Shopinhalte in alle konfigurierten Sprachen. In dieser Dokumentation erfährst du, wie die wichtigsten Funktionen im Detail arbeiten und wie du bei Bedarf eingreifen kannst.

1

Immer aktuell

Reqser hält eure fremdsprachigen Inhalte jederzeit auf dem neuesten Stand. Neue Produkte, geänderte Texte und aktualisierte Kategorien werden automatisch erkannt und übersetzt.

2

Volle Kontrolle

Über den Übersetzungseditor und das Wörterbuch hast du jederzeit Eingriff auf die Übersetzungen – von einzelnen Anpassungen bis hin zu globalen Wörterbuchregeln.

3

Sprachbasierter Redirect

Fremdsprachige Besucher werden automatisch basierend auf ihrer Browsersprache auf die richtige Sprachversion eures Shops weitergeleitet.

2. Automatische Inhaltserkennung

Die automatische Inhaltserkennung ist das Herzstück von Reqser. Der Agent durchsucht regelmäßig euren Shop über die API und erkennt dabei alle übersetzbaren Inhalte – von Produktnamen und Beschreibungen über Kategorien bis hin zu CMS-Seiten und Herstellerinformationen.

Sobald der Agent neue oder geänderte Inhalte findet, werden diese automatisch zur Übersetzung vorgemerkt und im nächsten Schritt verarbeitet.

Einstellung des Crawling-Intervalls in den Website-Einstellungen

Crawling-Intervall

Du kannst festlegen, wie häufig der Agent euren Shop nach neuen Inhalten durchsuchen soll. Unsere Empfehlung: Täglich. Nur so ist sichergestellt, dass eure Übersetzungen in allen Sprachen immer auf dem aktuellen Stand sind – insbesondere wenn ihr regelmäßig Produkte aktualisiert, neue Artikel anlegt oder Texte ändert.

Bei niedrigeren Frequenzen (wöchentlich, monatlich etc.) kann es passieren, dass neue oder geänderte Inhalte erst mit Verzögerung in den Fremdsprachen erscheinen. Für die meisten Shops ist „Täglich" daher die beste Wahl.

  • Täglich (empfohlen) – Stellt sicher, dass alle Sprachversionen immer aktuell sind
  • Wöchentlich / Monatlich / Jährlich – Möglich, aber neue und geänderte Inhalte erscheinen erst verzögert in den Fremdsprachen
  • Nie – Das automatische Crawling wird deaktiviert. Neue Inhalte werden nicht automatisch erkannt

Crawling jetzt starten

Du kannst jederzeit ein Crawling außerhalb des regulären Intervalls anstoßen – zum Beispiel, wenn ihr gerade viele neue Produkte importiert habt und nicht auf den nächsten automatischen Durchlauf warten möchtet.

In den Verbindungseinstellungen findest du dafür den Button „Crawling jetzt starten". Ist gerade bereits ein Crawling aktiv, ist der Button vorübergehend deaktiviert.

Crawling jetzt starten

Ausschlüsse

Falls bestimmte Inhalte nicht übersetzt werden sollen, kannst du diese gezielt von der Erkennung ausschließen. Das ist z. B. sinnvoll für technische Tabellen oder Inhalte, die in der Originalsprache bleiben sollen.

Über die Ausschlüsse kannst du einzelne Tabellen oder Einträge von der Erfassung ausnehmen.

3. Der Übersetzungseditor

Im Übersetzungseditor siehst du alle Übersetzungen eures Shops auf einen Blick. Hier kannst du Übersetzungen durchsuchen, filtern, manuell bearbeiten und bestätigen.

Den Editor erreichst du über die Einstellungen eurer Website – für jede Fremdsprache gibt es einen eigenen Editor-Zugang.

Suchen und Filtern

Nutze die Suchfunktion, um bestimmte Übersetzungen schnell zu finden. Du kannst nach Tabelle, Feld, Herkunft und Übersetzungsstatus filtern – zum Beispiel nur bestätigte Einträge oder Texte, für die noch keine Übersetzung vorhanden ist. Mit „Zuletzt aktualisiert" sortierst du nach den zuletzt geänderten Übersetzungen.

Übersicht des Übersetzungseditors mit Suchfunktion und Filtern

HTML-Ansicht umschalten

Manche Übersetzungen enthalten HTML-Formatierungen (z. B. Fettdruck oder Links). Du kannst zwischen der reinen Textansicht und der gerenderten HTML-Ansicht wechseln, um den Inhalt so zu sehen, wie er im Shop erscheint.

Übersetzungen bearbeiten

Klicke auf „Bearbeiten", um eine Übersetzung im Bearbeitungsmodal zu öffnen. Alternativ kannst du direkt in der Übersicht auf „Neu übersetzen" klicken, um eine automatische Neuübersetzung auszulösen.

Im Bearbeitungsmodal stehen dir zwei Möglichkeiten zur Verfügung:

• Smart Edit – Wähle einzelne Begriffe aus dem Ausgangstext aus und definiere, wie sie übersetzt werden sollen. Die Regeln werden automatisch ins Wörterbuch übernommen. Du kannst wählen, ob nur dieser Eintrag oder alle Einträge mit diesen Begriffen neu übersetzt werden sollen.
• Manuelle Bearbeitung – Passe den übersetzten Text direkt im Textfeld an. Die Änderung betrifft nur diesen einen Eintrag.

Nach dem Speichern wird die Änderung automatisch in euren Shop übernommen.

Bearbeitungsmodal zum manuellen Anpassen einer Übersetzung

Übersetzungen bestätigen

Wenn ihr z. B. einen Korrekturleser einsetzt, könnt ihr geprüfte Übersetzungen als „bestätigt" markieren. So behält ihr den Überblick, welche Übersetzungen bereits kontrolliert wurden. Wichtig: Ändert sich der Ausgangstext in der Grundsprache, wird die Übersetzung trotzdem automatisch neu erstellt.

Automatische Neuübersetzung bei Änderungen

Wenn sich ein Text in der Grundsprache ändert, erkennt der Agent das automatisch und übersetzt alle zugehörigen Fremdsprach-Einträge neu. Du musst dich also nicht selbst darum kümmern – geänderte Inhalte sind nach dem nächsten Prüfzyklus automatisch in allen Sprachen aktuell.

Herkunft verstehen

Jede Übersetzung zeigt an, woher sie stammt. Die wichtigsten Herkünfte sind: „Aus eurem Shop übernommen" (bereits im Shop vorhanden), „Manuell bearbeitet" (im Editor angepasst), „Von Reqser übersetzt" (automatisch übersetzt) und „Wörterbuch Anwendung" (durch eine Wörterbuchregel angepasst). Über das Info-Symbol neben der Herkunft findest du eine Kurzerklärung aller Werte.

Bestehende Fremdsprachen-Texte übernehmen

Habt ihr bereits qualitativ hochwertige Übersetzungen in eurem Shop, könnt ihr in den Einstellungen die Option „Bestehende Fremdsprachen-Texte übernehmen" aktivieren. Reqser übernimmt dann eure vorhandenen Fremdsprachen-Texte, statt sie neu zu übersetzen – das spart Zeichenkosten.

Wichtig zu verstehen, wann diese Option greift:

• Nur bei der Erst-Erfassung: Übernommen wird ein vorhandener Shop-Text nur dann, wenn in Reqser für diesen Eintrag noch keine Fremdsprachen-Übersetzung existiert. Die Option ist also vor allem für die initiale Befüllung gedacht.
• Bei Änderung des Grundtexts: Ändert sich später der Text in der Grundsprache, wird die Fremdsprache bewusst neu übersetzt – unabhängig davon, ob diese Option aktiv ist. So bleiben eure Übersetzungen inhaltlich korrekt und driften nicht von der Grundsprache ab.
• Diese Übernahme erkennst du im Editor an der Herkunft „Aus eurem Shop übernommen".

Warum du fremdsprachige Texte nicht direkt in Shopware bearbeiten solltest

Reqser ist für alle erfassten Inhalte die führende Quelle. Bearbeitest du einen Fremdsprachen-Text direkt in Shopware, kann diese Änderung beim nächsten Crawling wieder überschrieben werden – insbesondere, wenn sich der Grundtext ändert oder eine Neuübersetzung ausgelöst wird.

Nimm Anpassungen deshalb immer im Übersetzungseditor vor (manuelle Bearbeitung oder Smart Edit). Von dort werden sie sauber in euren Shop übernommen und bleiben erhalten.

4. Das Wörterbuch (Glossar)

Das Wörterbuch ist eines der mächtigsten Werkzeuge in Reqser. Hier legst du Regeln fest, wie bestimmte Begriffe übersetzt werden sollen – oder ob sie gar nicht übersetzt werden dürfen.

Wörterbuchregeln stellen sicher, dass eure Marke, Produktnamen und Fachbegriffe in allen Sprachen einheitlich und korrekt wiedergegeben werden.

Übersicht der Wörterbuchregeln mit Sprach- und Suchfiltern

Immer übersetzen als...

Legt fest, dass ein bestimmter Begriff immer auf eine bestimmte Weise übersetzt werden soll. Das ist ideal für Markennamen, Fachbegriffe oder branchenspezifische Ausdrücke.

Beispiel: „Weidezaun" soll in Englisch immer als „electric fence" übersetzt werden.

Nie übersetzen

Bestimmt, dass ein Begriff in der Originalsprache beibehalten wird und nicht übersetzt werden soll. Sinnvoll für Eigennamen, Marken oder technische Bezeichnungen.

Beispiel: „Patura" ist ein Markenname und soll in keiner Sprache übersetzt werden.

Regeln hinzufügen

Beim Anlegen einer neuen Regel gibst du folgende Informationen an:

• Ausgangswort – Der Begriff in eurer Grundsprache
• Zielwort – Die gewünschte Übersetzung (nur bei „Immer übersetzen als...")
• Sprachen – Für welche Fremdsprachen die Regel gelten soll

Beim Speichern kannst du außerdem festlegen, ob bereits bestehende Übersetzungen direkt mit der neuen Regel neu übersetzt werden sollen.

Formular zum Hinzufügen einer neuen Wörterbuchregel

Neuübersetzung bei Regeländerungen

Wenn du eine Wörterbuchregel änderst oder löschst, hast du die Möglichkeit, alle betroffenen Übersetzungen automatisch neu übersetzen zu lassen. Reqser zeigt dir dabei eine Schätzung der betroffenen Einträge und der damit verbundenen Zeichenkosten an.

So bleibt sichergestellt, dass eure Übersetzungen immer mit den aktuellen Wörterbuchregeln übereinstimmen.

6. Sprachbasierte Weiterleitungen (Redirects)

Reqser richtet für euren Webshop standardmäßig sprachbasierte Weiterleitungen ein. Besucher, deren Browsersprache zu einer eurer Fremdsprachen passt, landen auf der passenden Sprachdomain – ohne manuell die Sprache wechseln zu müssen. Das verbessert das Nutzererlebnis und kann die Conversion in euren Fremdsprachen deutlich steigern.

Die Erkennung basiert auf der Browsersprache (Accept-Language), nicht auf dem Standort des Besuchers. Reqser leitet also nicht nach Geo-IP um – ein deutschsprachiger Besucher in den USA soll genauso die deutsche Version sehen wie jemand in der Schweiz.

  • Auf der Startseite eurer Grundsprachen-Domain prüft das Reqser-Plugin die Browsersprache des Besuchers
  • Passt die Sprache zu einer aktiven Fremdsprache, leitet Reqser auf die entsprechende Sprachdomain eures Verkaufskanals weiter
  • Passt die Sprache nicht zu einer Fremdsprache, bleibt der Besucher auf der Grundsprache
  • Ruft jemand direkt eine Unterseite auf (z. B. eine Produkt-URL aus Google), findet keine automatische Weiterleitung statt – der Link führt direkt zur aufgerufenen Seite
  • Welche Besucher später erneut umgeleitet werden, hängt vom gewählten Weiterleitungsmodus ab (siehe unten)

Voraussetzungen

Damit die Weiterleitung im Live-Betrieb greift, müssen folgende Punkte erfüllt sein:

  • Das Reqser-Plugin ist in Shopware installiert und aktiv (mindestens Version 1.1.0)
  • Die automatische Weiterleitung ist in Reqser unter Redirect aktiviert (Standard: an)
  • Euer Abonnement ist aktiv – im Demo-Modus ist die Weiterleitung deaktiviert
  • Pro Fremdsprache existiert eine passende Sales-Channel-Domain, die Reqser verwaltet

Weiterleitungsmodi

Unter Redirect in den Website-Einstellungen könnt ihr festlegen, wie häufig und wie strikt Reqser Besucher zur passenden Sprache leitet. Der Standardmodus ist oft (empfohlen). Erweiterte Optionen (Toleranzzeiten, Limits, alternative Sprache) stehen ab Plugin-Version ≥ 1.5.3 zur Verfügung.

oft (empfohlen)

Leitet auf der Startseite um, wenn die Browsersprache nicht zur aktuellen Domain passt. Nach einem manuellen Sprachwechsel im Shop wird die Wahl des Besuchers respektiert – für eine Stunde wird nicht erneut automatisch umgeleitet. Danach kann auf der Startseite wieder zur passenden Sprache geleitet werden. Empfohlen für die meisten Shops.

manchmal

Weiterleitung mit Session-Limits: Anzahl und Timing der Umleitungen pro Besuchersession sind begrenzt. Nach manuellem Sprachwechsel bleibt die gewählte Sprache länger (bis zu 24 Stunden) geschützt. Sinnvoll, wenn ihr weniger aggressive Umleitungen wünscht.

selten

Maximal eine Weiterleitung pro Session. Für Shops, die Besuchern möglichst viel Kontrolle über die Sprachwahl lassen wollen.

immer (Warnung)

Leitet sehr strikt um – ein manueller Sprachwechsel kann sofort wieder überschrieben werden. Je nach Shop-Konfiguration kann das zu Endlosschleifen führen. Nur zu Testzwecken empfohlen, nicht für den Live-Betrieb.

Manueller Sprachwechsel

Wechselt ein Besucher im Shop selbst die Sprache (Language Switcher), merkt sich Reqser diese Wahl – abhängig vom Modus für eine begrenzte Zeit oder für die gesamte Session. Im Modus oft gilt die manuelle Wahl typischerweise eine Stunde; danach kann auf der Startseite wieder anhand der Browsersprache umgeleitet werden.

Im Modus oft kann Reqser Besucher auch dauerhaft auf die zuletzt gewählte Sprache leiten, solange die Session aktiv ist – unabhängig von der Browsersprache.

SEO und Deep Links

Weiterleitungen greifen nur auf der Startseite. Suchmaschinen und geteilte Links sollten deshalb immer direkt auf die richtige Sprach-URL zeigen – nicht über die Grundsprachen-Startseite mit anschließender Umleitung.

  • Kein Geo-IP-Redirect: Sprache folgt der Browsersprache, nicht dem Land des Besuchers
  • Deep Links bleiben stabil: Wer eine Produkt- oder Kategorie-URL aus den Suchergebnissen öffnet, landet auf genau dieser URL ohne Umweg über die Startseite
  • Hreflang bleibt wichtig: Weiterleitungen ersetzen keine korrekten hreflang-Tags und Sprachversionen – beides ergänzt sich

Einstellungen anpassen

Du findest alle Optionen unter Website-Einstellungen → Redirect in Reqser. Dort kannst du die Weiterleitung ein- und ausschalten, den Modus wählen und – ab Plugin ≥ 1.5.3 – erweiterte Parameter feinjustieren. Unterhalb der Einstellungen siehst du den Redirect-Test mit Ergebnissen pro Sprache.

Redirect-Einstellungen in Reqser

Die Weiterleitung ist standardmäßig aktiv. Deaktivierst du sie, bleiben Besucher auf der Domain, die sie aufrufen – ohne automatische Sprachzuordnung.

8. Häufig gestellte Fragen

Antworten auf die häufigsten Fragen rund um Reqser, die Anbindung, Übersetzungen und Bildbeschreibungen findet ihr auf unserer FAQ-Seite.

Zur FAQ-Seite

Du hast weitere Fragen oder benötigst Unterstützung? Wende dich jederzeit an uns oder an eure Agentur – wir helfen dir gerne weiter.