Topdata Topdata Docs

TopdataMachineTranslationsSW6 v1.1.0

Dies ist eine ältere Version des Handbuchs. Neueste Version anzeigen

Systemanforderungen

  • Shopware 6.4+
  • PHP 8.0+
  • MySQL/MariaDB 10.3+
  • 500 MB freier Festplattenspeicher für Backups
  • Netzwerkzugriff auf api-free.deepl.com

Installationsschritte

  1. Plugin installieren
bin/console plugin:refresh
bin/console plugin:install --activate TopdataMachineTranslationsSW6
  1. DeepL API-Key konfigurieren

Dauerhafte Konfiguration (empfohlen):

# Zur Umgebungskonfiguration hinzufügen (z.B. .env)
DEEPL_FREE_API_KEY=Ihr-API-Key-hier

Temporäre Verwendung:

DEEPL_FREE_API_KEY=Ihr-Key-hier bin/console topdata:translate [...]
  1. Installation überprüfen
bin/console topdata:translate --list-languages

Nach der Installation

  • Backup-Verzeichnis: /tmp/database-backups (über Plugin-Einstellungen konfigurierbar)
  • Empfehlung für Erstinstallation: --table-Option zum Testen einzelner Tabellen verwenden

Umgebungsvariablen

DEEPL_FREE_API_KEY

  • Erforderlich: Ja
  • Beschreibung: DeepL API-Authentifizierungsschlüssel
  • Format: Zeichenkette
  • Beispiel: export DEEPL_FREE_API_KEY=Ihr-Key-hier

Befehlsoptionen

--table

  • Typ: Mehrfachangaben möglich
  • Beschreibung: Spezifische zu übersetzende Tabellen
  • Beispiel: --table=product_translation --table=category_translation

--from

  • Standard: de-DE
  • Beschreibung: Quellsprache (4-stelliger Code)
  • Unterstützte Formate: xx-XX oder xx

--to

  • Standard: cs-CZ
  • Beschreibung: Zielsprache (4-stelliger Code)
  • Hinweis: Wird automatisch in 2-stelliges Format für DeepL API konvertiert

--no-backup

  • Typ: Flag
  • Beschreibung: Deaktiviert automatische Backups
  • Risiko: In Produktivumgebungen nicht empfohlen

Backup-Einstellungen

  • Speicherort: /tmp/database-backups
  • Aufbewahrung: Manuelle Bereinigung erforderlich
  • Format: SQL-Dump pro Tabelle mit Zeitstempel

Übersetzungseinstellungen

  • Ausgenommene Spalten:
    • Felder mit Endung _id oder _config
    • created_at/updated_at Zeitstempel
  • Batch-Größe: Einzelne Zeilenverarbeitung
  • Fehlerbehandlung: Überspringt fehlgeschlagene Übersetzungen, setzt mit nächster Spalte fort