ErweitertWP-CLI-Befehle
WP-CLI-Befehle
Die folgenden WP-CLI-Befehle stehen zur Verfügung, um Custom Posts, Taxonomie-Terme (Tags und Kategorien), Medienelemente, Menüs und Benutzer zu übersetzen.
WP-CLI-Befehle werden standardmäßig ohne eingeloggten Benutzer ausgeführt. Damit die nötigen Berechtigungen zum Erstellen der Übersetzungseinträge vorhanden sind, musst du die Befehle mit einem Benutzerkontext ausführen, über die Option --user:
wp gatotranslate post 123 --user=adminwp gatotranslate post
Custom Posts übersetzen (Beiträge, Seiten, benutzerdefinierte Beitragstypen).
Verwendung
wp gatotranslate post <ids> [options]Parameter
| Parameter | Beschreibung |
|---|---|
<ids> | Liste der zu übersetzenden Beitrags-IDs, durch Kommas oder Leerzeichen getrennt |
Optionen
Wenn keine Optionen angegeben werden, werden die in den Plugin-Einstellungen hinterlegten Werte verwendet.
| Option | Beschreibung | Mögliche Werte |
|---|---|---|
--translate-slugs=<bool> | Ob Slugs übersetzt werden sollen | true, false |
--default-provider=<provider> | Standard-Übersetzungsanbieter | chatgpt, claude, deepl, gemini, google_translate, deepseek, mistral, openrouter, self_hosted_llm |
--status-to-update=<status> | Der Status, den Beiträge haben müssen, um aktualisiert zu werden | draft, pending, publish, private, future, any |
--status-when-translated=<status> | Der Status, den Beiträge nach der Übersetzung erhalten | draft, pending, publish, private, current (d.h. Status nicht ändern), same-as-origin (d.h. Status vom Ursprungsbeitrag kopieren) |
--copy-date=<bool> | Ob das Datum vom Originalbeitrag übernommen werden soll | true, false |
--language-providers=<providers> | JSON-String der Anbieter-Zuordnung pro Sprache | JSON-String mit Sprachcodes als Schlüssel und als Werte: der Anbietername, oder "none" (um diese Sprache zu deaktivieren), oder "default" (um den Standardanbieter zu verwenden) |
--tasks=<tasks> | Kommagetrennte Liste der auszuführenden Aufgaben | translate-content, translate-entity-relationships, replace-internal-links |
--parts=<parts> | Kommagetrennte Liste der zu ändernden Inhaltsteile | properties (Titel, Slug und Auszug), content (Beitragsinhalt), meta (benutzerdefinierte Felder) |
--porcelain | Gibt nur die wesentlichen Informationen aus, geeignet für die Verarbeitung durch Skripte | Kein Wert erforderlich (Flag) |
--fail-if-log-notifications | Schlägt fehl, wenn während der Ausführung Log-Benachrichtigungen hinzugefügt werden | Kein Wert erforderlich (Flag) |
--process-failed | Nur fehlgeschlagene Übersetzungen verarbeiten | Kein Wert erforderlich (Flag) |
Beispiele
# Translate post with ID 123
wp gatotranslate post 123 --user=admin
# Translate posts with IDs 123, 456, and 789
wp gatotranslate post 123,456,789 --user=admin
# Translate posts with IDs 123 and 456
wp gatotranslate post "123 456" --user=admin
# Translate post replicating the status and date of the original post
wp gatotranslate post 123 --user=admin --status-when-translated=same-as-origin --copy-date=true
# Translate post using ChatGPT as default provider
wp gatotranslate post 123 --user=admin --default-provider=chatgpt
# Translate post with a specific provider for each language
wp gatotranslate post 123 --user=admin --language-providers='{"es":"chatgpt","fr":"deepl"}'
# Translate post disabling a specific language
wp gatotranslate post 123 --user=admin --language-providers='{"de":"none"}'
# Translate only post properties (title, slug, and excerpt)
wp gatotranslate post 123 --user=admin --parts=properties
# Translate only post content and meta
wp gatotranslate post 123 --user=admin --parts=content,meta
# Only update the entity relationships for the target language
wp gatotranslate post 123 --user=admin --tasks=translate-entity-relationships
# Re-run translations for previously failed posts/languages only
wp gatotranslate post "123 456" --user=admin --process-failedwp gatotranslate term
Taxonomie-Terme übersetzen (Kategorien, Tags, benutzerdefinierte Taxonomien).
Verwendung
wp gatotranslate term <ids> [options]Parameter
| Parameter | Beschreibung |
|---|---|
<ids> | Liste der zu übersetzenden Term-IDs, durch Kommas oder Leerzeichen getrennt |
Optionen
| Option | Beschreibung | Mögliche Werte |
|---|---|---|
--translate-slugs=<bool> | Ob Slugs übersetzt werden sollen | true, false |
--default-provider=<provider> | Standard-Übersetzungsanbieter | chatgpt, claude, deepl, gemini, google_translate, deepseek, mistral, openrouter, self_hosted_llm |
--language-providers=<providers> | JSON-String der Anbieter-Zuordnung pro Sprache | JSON-String mit Sprachcodes als Schlüssel und als Werte: der Anbietername, oder "none" (um diese Sprache zu deaktivieren), oder "default" (um den Standardanbieter zu verwenden) |
--tasks=<tasks> | Kommagetrennte Liste der auszuführenden Aufgaben | translate-content, translate-entity-relationships |
--parts=<parts> | Kommagetrennte Liste der zu ändernden Inhaltsteile | properties (Name, Slug), content (Beschreibung), meta (benutzerdefinierte Felder) |
--porcelain | Gibt nur die wesentlichen Informationen aus, geeignet für die Verarbeitung durch Skripte | Kein Wert erforderlich (Flag) |
--fail-if-log-notifications | Schlägt fehl, wenn während der Ausführung Log-Benachrichtigungen hinzugefügt werden | Kein Wert erforderlich (Flag) |
--process-failed | Nur fehlgeschlagene Übersetzungen verarbeiten | Kein Wert erforderlich (Flag) |
Beispiele
# Translate term with ID 1
wp gatotranslate term 1 --user=admin
# Translate terms with IDs 1, 2, and 3
wp gatotranslate term 1,2,3 --user=admin
# Translate term 1 disabling slug translation, and using OpenRouter as default provider
wp gatotranslate term 1 --user=admin --translate-slugs=false --default-provider=openrouterr
# Translate term 1 with a specific provider for each language
wp gatotranslate term 1 --user=admin --language-providers='{"es":"chatgpt","fr":"deepl"}'
# Translate disabling a specific language
wp gatotranslate term 1 --user=admin --language-providers='{"de":"none"}'
# Translate only term name and slug
wp gatotranslate term 1 --user=admin --parts=properties
# Translate only term description and meta
wp gatotranslate term 1 --user=admin --parts=content,meta
# Only update the entity relationships for the target language
wp gatotranslate term 1 --user=admin --tasks=translate-entity-relationships
# Re-run translations for previously failed terms/languages only
wp gatotranslate term 1,2,3 --user=admin --process-failedwp gatotranslate media
Medienelemente übersetzen (Anhänge).
Verwendung
wp gatotranslate media <ids> [options]Parameter
| Parameter | Beschreibung |
|---|---|
<ids> | Liste der zu übersetzenden Medien-IDs, durch Kommas oder Leerzeichen getrennt |
Optionen
| Option | Beschreibung | Mögliche Werte |
|---|---|---|
--translate-slugs=<bool> | Ob Slugs übersetzt werden sollen | true, false |
--default-provider=<provider> | Standard-Übersetzungsanbieter | chatgpt, claude, deepl, gemini, google_translate, deepseek, mistral, openrouter, self_hosted_llm |
--language-providers=<providers> | JSON-String der Anbieter-Zuordnung pro Sprache | JSON-String mit Sprachcodes als Schlüssel und als Werte: der Anbietername, oder "none" (um diese Sprache zu deaktivieren), oder "default" (um den Standardanbieter zu verwenden) |
--tasks=<tasks> | Kommagetrennte Liste der auszuführenden Aufgaben | translate-content, translate-entity-relationships, replace-internal-links |
--parts=<parts> | Kommagetrennte Liste der zu ändernden Inhaltsteile | properties (Titel, Slug), content (Alternativtext, Bildunterschrift und Beschreibung), meta (benutzerdefinierte Felder) |
--porcelain | Gibt nur die wesentlichen Informationen aus, geeignet für die Verarbeitung durch Skripte | Kein Wert erforderlich (Flag) |
--fail-if-log-notifications | Schlägt fehl, wenn während der Ausführung Log-Benachrichtigungen hinzugefügt werden | Kein Wert erforderlich (Flag) |
--process-failed | Nur fehlgeschlagene Übersetzungen verarbeiten | Kein Wert erforderlich (Flag) |
Beispiele
# Translate media item with ID 10
wp gatotranslate media 10 --user=admin
# Translate media items with IDs 10, 11, 12
wp gatotranslate media 10,11,12 --user=admin
# Translate media item with a specific provider for each language
wp gatotranslate media 10 --user=admin --language-providers='{"es":"chatgpt","fr":"deepl"}'
# Translate disabling specific languages
wp gatotranslate media 10 --user=admin --language-providers='{"de":"none","zh":"none"}'
# Translate only media title and slug
wp gatotranslate media 10 --user=admin --parts=properties
# Translate only media content (alt text, caption, and description) and meta
wp gatotranslate media 10 --user=admin --parts=content,meta
# Only update the entity relationships for the target language
wp gatotranslate media 10 --user=admin --tasks=translate-entity-relationships
# Re-run translations for previously failed media items/languages only
wp gatotranslate media 10,11,12 --user=admin --process-failedwp gatotranslate menu
Menüs übersetzen.
Es werden nur Menüs in der Ursprungssprache übersetzt. Da Polylang die Sprache für Menüs nicht speichert, wird diese Information anhand der zugewiesenen Menüpositionen ermittelt.
Die Übersetzung wird für ein Menü nur ausgelöst, wenn:
- Das Menü mindestens eine bereits zugewiesene Position hat
- Keine seiner Positionen für eine Übersetzungssprache vorgesehen ist
Verwendung
wp gatotranslate menu <ids> [options]Parameter
| Parameter | Beschreibung |
|---|---|
<ids> | Liste der zu übersetzenden Menü-IDs, durch Kommas oder Leerzeichen getrennt |
Optionen
| Option | Beschreibung | Mögliche Werte |
|---|---|---|
--default-provider=<provider> | Standard-Übersetzungsanbieter | chatgpt, claude, deepl, gemini, google_translate, deepseek, mistral, openrouter, self_hosted_llm |
--language-providers=<providers> | JSON-String der Anbieter-Zuordnung pro Sprache | JSON-String mit Sprachcodes als Schlüssel und als Werte: der Anbietername, oder "none" (um diese Sprache zu deaktivieren), oder "default" (um den Standardanbieter zu verwenden) |
--porcelain | Gibt nur die wesentlichen Informationen aus, geeignet für die Verarbeitung durch Skripte | Kein Wert erforderlich (Flag) |
--fail-if-log-notifications | Schlägt fehl, wenn während der Ausführung Log-Benachrichtigungen hinzugefügt werden | Kein Wert erforderlich (Flag) |
Beispiele
# Translate menu with ID 5
wp gatotranslate menu 5 --user=admin
# Translate menus with IDs 5, 6, and 7
wp gatotranslate menu 5,6,7 --user=admin
# Translate menu with a specific provider for each language
wp gatotranslate menu 5 --user=admin --language-providers='{"es":"chatgpt","fr":"deepl"}'
# Translate disabling specific languages
wp gatotranslate menu 5 --user=admin --language-providers='{"de":"none","zh":"none"}'wp gatotranslate user
Benutzerbeschreibungen übersetzen.
Verwendung
wp gatotranslate user <ids> [options]Parameter
| Parameter | Beschreibung |
|---|---|
<ids> | Liste der zu übersetzenden Benutzer-IDs, durch Kommas oder Leerzeichen getrennt |
Optionen
| Option | Beschreibung | Mögliche Werte |
|---|---|---|
--default-provider=<provider> | Standard-Übersetzungsanbieter | chatgpt, claude, deepl, gemini, google_translate, deepseek, mistral, openrouter, self_hosted_llm |
--language-providers=<providers> | JSON-String der Anbieter-Zuordnung pro Sprache | JSON-String mit Sprachcodes als Schlüssel und als Werte: der Anbietername, oder "none" (um diese Sprache zu deaktivieren), oder "default" (um den Standardanbieter zu verwenden) |
--porcelain | Gibt nur die wesentlichen Informationen aus, geeignet für die Verarbeitung durch Skripte | Kein Wert erforderlich (Flag) |
--fail-if-log-notifications | Schlägt fehl, wenn während der Ausführung Log-Benachrichtigungen hinzugefügt werden | Kein Wert erforderlich (Flag) |
Beispiele
# Translate user with ID 1
wp gatotranslate user 1 --user=admin
# Translate users with IDs 1, 2, and 3
wp gatotranslate user 1,2,3 --user=admin
# Translate users with IDs 1 and 2
wp gatotranslate user "1 2" --user=admin
# Translate user using ChatGPT as default provider
wp gatotranslate user 1 --user=admin --default-provider=chatgpt
# Translate user with a specific provider for each language
wp gatotranslate user 1 --user=admin --language-providers='{"es":"chatgpt","fr":"deepl"}'
# Translate user disabling a specific language
wp gatotranslate user 1 --user=admin --language-providers='{"de":"none"}'