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
- Plugin installieren
bin/console plugin:refresh
bin/console plugin:install --activate TopdataMachineTranslationsSW6
- 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 [...]
- 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-XXoderxx
--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
_idoder_config created_at/updated_atZeitstempel
- Felder mit Endung
- Batch-Größe: Einzelne Zeilenverarbeitung
- Fehlerbehandlung: Überspringt fehlgeschlagene Übersetzungen, setzt mit nächster Spalte fort