⚙️ Erste Schritte #
📌Bist du dir unsicher, wie PlentyOne funktioniert? Schau dir das Plenty-Handbuch an, um mehr zu erfahren! #
Was ist DeepL – Professional Translation API? #
DeepL ist ein leistungsstarker Übersetzungsdienst, der sich durch besonders natürlich klingende Übersetzungen auszeichnet.
Weitere Vorteile auf einen Blick:
- Das Plugin steht dir kostenlos zum Download zur Verfügung
- Täglich kannst du bis zu drei Übersetzungen als Vorschau testen und die Qualität vorab prüfen
- Solange du das Plugin nicht aktiv nutzt, entstehen dir keinerlei Kosten
- Du bezahlst ausschließlich für die Übersetzungen, deren Preis dir vorab transparent angezeigt wird
- Es gibt keine monatliche Grundgebühr – anders als bei vielen anderen Anbietern
- Alles lässt sich bequem direkt im plentymarkets-Backend erledigen
- HTML-fähig
Preise #
Die Abrechnung erfolgt auf Basis von Artikeln und Zeichenanzahl:
- € 0,06 pro 1.000 Zeichen und Sprache
- € 0,10 pro Artikel und Sprache
Beispielrechnung:
300 Artikel, 470.000 Zeichen, 3 Sprachen
Preis = ( 300 × € 0,10 + 470.000 × € 0,06 / 1.000) × 3 = ( € 30,00 + € 28,20) × 3 = € 58,20
Bevor du eine Übersetzung beauftragst, werden dir die anfallenden Kosten übersichtlich angezeigt – so behältst du jederzeit die volle Kontrolle.
Voraussetzungen #
Nach dem kostenlosen Erwerb in PlentyOne sowie erfolgreicher Installation und Bereitstellung im Hauptmandanten erscheint unter „System > Artikel” ein neuer Menüpunkt namens „Translation” (Übersetzung).
Für die kostenlose Vorschaufunktion müssen deine Zahlungsdaten bereits auf unserem Lizenzserver hinterlegt sein.
Unter „System > Artikel > Translation” findest du den Reiter „Lizenz”. Dort klickst du auf „Zahlungsmethode hinzufügen”. Du wirst einmalig auf unseren Server weitergeleitet, wo du deine gewünschte Zahlungsmethode für spätere Übersetzungen hinterlegen kannst. Es entstehen dabei keine Kosten – du erteilst lediglich Stripe die Berechtigung, im Bedarfsfall auf diese Daten zuzugreifen.
Artikelsuche #
Im ersten Bereich steht dir ein Suchformular mit folgenden Filterkriterien zur Verfügung:
Name (sucht nach dem Titel des Artikels)
Artikel-ID (direkte Eingabe einer bestimmten Artikel-ID)
Varianten-ID (direkte Eingabe einer bestimmten Varianten-ID)
Tag-ID (direkte Eingabe einer bestimmten Tag-ID)
Die Suchparameter werden direkt in den entsprechenden Feldern eingegeben.
Sprachen, Felder und Markierungen #
Im zweiten Bereich legst du fest, welche Sprachen und Felder übersetzt werden sollen:
Quellsprache (die Ausgangssprache deiner Inhalte)
Zielsprache(n) (eine oder mehrere Sprachen, in die übersetzt werden soll)
Felder, die übersetzt werden sollen: Name 1, 2 und 3, Kurzbeschreibung, vollständige Beschreibung, technische Daten sowie Metadaten und Keywords
Darüber hinaus kannst du festlegen, welche Tags bei der Übersetzung hinzugefügt oder entfernt werden sollen:
Tag entfernen (Dropdown)
Tag hinzufügen (Dropdown)
Übersetzungen prüfen und Artikel auswählen #
Übersetzungs-Check #
Um die Qualität einer Übersetzung vorab zu prüfen, wählst du zunächst Quell- und Zielsprache(n) wie im vorherigen Abschnitt beschrieben aus und klickst anschließend auf „Demo-Übersetzung”. Es öffnet sich ein Popup-Fenster, das sowohl den Originaltext als auch die Übersetzung(en) in den gewählten Zielsprachen anzeigt.
Bitte beachte: Diese Vorschaufunktion steht dir nur dreimal täglich zur Verfügung und ist auf 3.000 Zeichen begrenzt. Dadurch kann es in seltenen Fällen vorkommen, dass HTML-Code an einer ungünstigen Stelle abgeschnitten wird. Bei der tatsächlichen Übersetzung wird selbstverständlich nichts gekürzt.
Artikelauswahl #
Du hast die Möglichkeit, alle gefundenen Artikel auf einmal oder gezielt einzelne Artikel auszuwählen. Über „Alle Artikel hinzufügen” nimmst du alle Ergebnisse in einem Schritt auf. Für eine Einzelauswahl setzt du die entsprechenden Checkboxen und klickst auf „Ausgewählte Artikel hinzufügen”.
Übersetzung von Variationseigenschaften #
Auf der Seite „Eigenschaftssuche” kannst du Variationseigenschaften vom Typ „Text” oder „Langtext (HTML)” übersetzen lassen.
Suchparameter #
Die Suche ist nach Variablenname, Artikel-ID, Variablen-ID und Tag-ID möglich. Gibst du eine Artikel-ID ein, werden alle zugehörigen Variationen angezeigt.
Sprache und Eigenschaften auswählen #
Hier wählst du die Quellsprache, die Zielsprache(n) sowie die zu übersetzenden Eigenschaften der Variation aus. Achte darauf, dass die gewählte Eigenschaft der Variation tatsächlich zugewiesen ist – andernfalls wird sie nicht übersetzt.
Die Tabelle im unteren Bereich der Seite zeigt die gefundenen Varianten an. Sobald eine Eigenschaft ausgewählt wird, aktualisiert sich die Tabelle und zeigt an, ob der jeweiligen Eigenschaft bereits ein Text zugewiesen wurde.
Auch hier kannst du alle Variationen auf einmal oder einzeln auswählen – entweder über „Alle Artikel hinzufügen” oder per Checkbox und „Ausgewählte Artikel hinzufügen”.
Kategorien übersetzen #
Auf der Seite „Kategoriensuche” kannst du gezielt nach Kategorien suchen, die übersetzt werden sollen. Die Suche ist nach Kategoriename, Kategorie-ID und Tag-ID möglich. Zusätzlich muss der zugehörige Shop-Client der Kategorie ausgewählt werden.
Sprachen und Felder auswählen #
Hier legst du Quellsprache, Zielsprache(n) und die zu übersetzenden Kategoriefelder fest. Zur Auswahl stehen: Name, Beschreibung, Beschreibung 2, Kurzbeschreibung, Meta-Titel, Meta-Beschreibung und Meta-Keywords.
Die Ergebnistabelle zeigt die gefundenen Kategorien sowie die verfügbaren Texte für die gewählten Übersetzungsfelder an. Die Auswahl funktioniert wie gewohnt – entweder alle auf einmal über „Alle Artikel hinzufügen” oder einzeln per Checkbox und „Ausgewählte Artikel hinzufügen”.
Tags übersetzen #
Auf der Seite „Tag-Suche” kannst du nach Tags suchen, die übersetzt werden sollen – entweder nach Tag-Name oder Tag-ID.
Sprachen und Felder auswählen #
Da Tags lediglich ein einziges Feld besitzen, kann ausschließlich der Name übersetzt werden. Wähle hier Quell- und Zielsprache(n) aus.
Die Ergebnistabelle funktioniert identisch wie bei den anderen Bereichen: alle auf einmal oder gezielt einzelne Einträge auswählen und hinzufügen.
Systemeigenschaften übersetzen #
Auf der Seite „Systemeigenschaften suchen” kannst du nach Eigenschaften suchen, die übersetzt werden sollen – entweder nach Eigenschaftsname oder Eigenschafts-ID.
Sprachen und Felder auswählen #
Hier wählst du Quellsprache, Zielsprache(n) und die zu übersetzenden Felder aus. Verfügbar sind Name und Beschreibung.
Die Ergebnistabelle zeigt die gefundenen Eigenschaften samt verfügbarer Texte an. Du kannst alle auf einmal über „Alle Elemente hinzufügen” oder einzeln per Checkbox und „Ausgewählte Elemente hinzufügen” zur Übersetzung hinzufügen.
Hinweis: Eigenschaften mit angehängter Auswahl werden vom Plugin automatisch in separate Übersetzungselemente aufgeteilt.
Systemeigenschaftsgruppen übersetzen #
Auf der Seite „Systemeigenschaftsgruppen suchen” kannst du nach Eigenschaftsgruppen suchen – entweder nach Gruppenname oder Gruppen-ID.
Sprachen und Felder auswählen #
Hier wählst du Quellsprache, Zielsprache(n) und die zu übersetzenden Felder aus. Verfügbar sind Name und Beschreibung.
Die Ergebnistabelle zeigt die gefundenen Eigenschaftsgruppen samt verfügbarer Texte an.
hier kannst du alle auf einmal oder einzeln auswählen und zur Übersetzung hinzufügen.
Warenkorb und Bestellung #
Im Warenkorb siehst du eine Übersicht aller zuvor ausgewählten Artikel mit folgenden Informationen: Artikel-ID, Typ, Name, Quell- und Zielsprache(n), Zeichenanzahl, Preis pro Sprache sowie Gesamtpreis.
Wenn alles stimmt, klicke auf „Übersetzungen kaufen”, um die Bestellung auszulösen.
Wichtig: Mit einem Klick auf „Übersetzungen kaufen” werden sämtliche Einträge im Warenkorb bestellt – auch nicht markierte. Möchtest du einzelne Artikel vorher entfernen, markiere sie und nutze die Schaltfläche „Ausgewählte entfernen”.
Nur wenn du auf Übersetzungen kaufen geklickt hast, wird dieser Kauf getätigt.
Übersetzungsstatus #
Den aktuellen Stand deiner Übersetzungen kannst du jederzeit im Bereich „Übersetzungsstatus” einsehen. Sobald der Status „Übersetzt” angezeigt wird, ist der jeweilige Artikel fertig übersetzt und in der gewählten Zielsprache verfügbar.
Wichtige Hinweise #
Rechtevergabe für Nicht-Admins #
Sollen Benutzerkonten ohne Administratorrechte das Plugin ebenfalls nutzen können, müssen ihnen folgende Rechte zugewiesen werden: REST-API > Items (Artikel)
HTML-Kompatibilität #
Unser Plugin ist zu 99,9 % HTML-fähig. Da DeepL HTML noch nicht vollständig unterstützt, haben wir das Plugin so entwickelt, dass der HTML-Code vor der Übersetzung aus der Beschreibung entfernt und danach wieder korrekt eingefügt wird. Wir haben dies mit mehreren hundert Beschreibungen und verschiedensten HTML-Varianten erfolgreich getestet. Da es jedoch unzählige HTML-Varianten gibt, können wir keine hundertprozentige Garantie geben. Solltest du nach einer Übersetzung Fehler im HTML-Code feststellen, melde dich bitte bei uns und schick uns sowohl die Original- als auch die übersetzte Version des HTML-Codes, damit wir das Skript entsprechend anpassen können
FAQ💡 #
Was kann ich tun, wenn meine Übersetzungen nicht ausgelöst werden?
Überprüfe, ob Ceres und IO an den richtigen Positionen im Plugin-Set stehen. IO sollte die höchste Position haben (z. B. 999), Ceres die dritthöchste (z. B. 997).
Stelle sicher, dass das Plugin aktiv ist.
Prüfe, ob du die aktuellste Plugin-Version verwendest.
Stelle das Plugin im Hauptmandanten bereit.
Kontrolliere, ob deine Lizenz aktiviert ist. Falls nicht, gehe zu „System > Artikel > Translation > Übersetzungslizenz”.
Warum schlägt die Übersetzung einer Kategorie fehl, obwohl ich HTML-Code in der Beschreibung hinterlegt habe?
Wenn du eine neue Kategorie erstellst und ausschließlich Inhalt im Feld „Beschreibung 1″ hinterlegst, kann die Übersetzung fehlschlagen. Der Grund dafür liegt in einer Einschränkung von plentymarkets: Beim Aktualisieren von Kategorietexten muss zwingend auch ein Name angegeben sein. Stelle daher sicher, dass das Feld „Name” der Kategorie ebenfalls ausgefüllt ist, bevor du die Übersetzung startest.
Welche Felder werden übersetzt?
Für Artikel: Name 1, Name 2, Name 3, Kurzbeschreibung, Beschreibung, Technische Angaben, Metadaten, Keywords
Für Eigenschaften: Variationseigenschaften vom Typ Text oder Langtext (HTML)
Für Kategorien: Name, Beschreibung, Beschreibung 2, Kurzbeschreibung, Meta-Titel, Meta-Beschreibung, Meta-Keywords
Für Tags: Name
Können Eigenschaften (Properties) und Merkmale (Characteristics) übersetzt werden?
Nein, das ist aktuell nicht möglich.
Wie werden Eigennamen behandelt?
Es steht eine Blacklist zur Verfügung, in der du Begriffe eintragen kannst, die vom Plugin nicht übersetzt werden sollen.
Was kostet eine Übersetzung?
€ 0,06 pro 1.000 Zeichen und Sprache
€ 0,10 pro Artikel und Sprache
Welche Sprachen werden unterstützt?
Englisch, Deutsch, Spanisch, Polnisch, Französisch, Italienisch, Niederländisch, Portugiesisch, Russisch, Chinesisch, Bulgarisch, Tschechisch, Dänisch, Rumänisch, Slowakisch, Schwedisch
Gibt es ein Kundenportal?
Ja, im Kundenportal kannst du dein Abo managen und Rechnungen downloaden.
📩 Support #
Wenn sich das Plugin nicht wie erwartet verhält und du einen Fehler vermutest, wende dich bitte an support@ninepoint.solutions und teile uns folgende Informationen mit:
Allgemeine Informationen:
deine PlentyOne Shop-ID,
deine DeepL Plugin-Version
sowie deine Ceres- und IO-Version.
Richte in deinem Plenty-System einen Agenturzugrif für uns (HastagEs GmbH oder Ninepoint Software Solutions) ein und teile uns in deiner Support-Anfrage mit, dass du uns den Zugriff erteilt hast
Zum Fehler selbst:
Wie sollte sich das Plugin verhalten?
Wie verhält es sich tatsächlich?
Seit wann tritt das Problem auf?
Wie lässt es sich reproduzieren (2–3 Schritte)?
Bitte füge außerdem einen Screenshot deiner Konfiguration bei und – falls das Problem bereits bei der Einrichtung auftritt – eine Angabe, an welcher Stelle der Dokumentation der Fehler aufgetreten ist.
Für Fragen und Probleme steht dir auch der kostenlose Community-Support im PlentyOne Forum zur Verfügung, wo sich Nutzer gegenseitig helfen:
https://forum.plentymarkets.com/t/issues-fehler-deepl-translation-plugin/508789
📌 Kleiner Tipp: Damit wir dir so schnell wie möglich helfen können, kontaktiere uns bitte immer über support@ninepoint.solutions. Bei privatem E-Mail-Austausch mit den Entwicklern geht der Überblick verloren, was oft zu längeren Wartezeiten führt.