WP-CLI-opdrachten
De volgende WP-CLI-opdrachten zijn beschikbaar om aangepaste berichten, taxonomietermen (tags en categorieën), media-items, menu's en gebruikers te vertalen.
WP-CLI-opdrachten worden standaard uitgevoerd zonder een ingelogde gebruiker. Voor de juiste rechten om de vertaalitems aan te maken, moet je opdrachten uitvoeren in een gebruikerscontext via de optie --user:
wp gatotranslate post 123 --user=adminwp gatotranslate post
Vertaal aangepaste berichten (berichten, pagina's, aangepaste berichttypen).
Gebruik
wp gatotranslate post <ids> [options]Parameters
| Parameter | Beschrijving |
|---|---|
<ids> | Lijst met bericht-ID's om te vertalen, gescheiden door komma's of spaties |
Opties
Als ze niet worden opgegeven, worden de opties ingesteld met de waarde in de plugin-instellingen.
| Optie | Beschrijving | Mogelijke waarden |
|---|---|---|
--translate-slugs=<bool> | Of slugs vertaald moeten worden | true, false |
--default-provider=<provider> | Standaard vertaalprovider | chatgpt, claude, deepl, gemini, google_translate, deepseek, mistral, openrouter, self_hosted_llm |
--status-to-update=<status> | De status die berichten moeten hebben om bijgewerkt te worden | draft, pending, publish, private, future, any |
--status-when-translated=<status> | De status die berichten krijgen na vertaling | draft, pending, publish, private, current (d.w.z. de status niet wijzigen), same-as-origin (d.w.z. de status kopiëren van het bronbericht) |
--copy-date=<bool> | Of de datum van het originele bericht gekopieerd moet worden | true, false |
--language-providers=<providers> | JSON-string van taal-provider-koppeling | JSON-string met taalcodes als sleutels, en als waarden de providernaam, of "none" (om voor die taal uit te schakelen), of "default" (om de standaardprovider te gebruiken) |
--tasks=<tasks> | Door komma's gescheiden lijst van uit te voeren taken | translate-content, translate-entity-relationships, replace-internal-links |
--parts=<parts> | Door komma's gescheiden lijst van inhoudsonderdelen om te wijzigen | properties (titel, slug en samenvatting), content (berichtinhoud), meta (aangepaste velden) |
--porcelain | Geeft alleen de essentiële informatie weer, geschikt voor verwerking door scripts | Geen waarde vereist (vlag) |
--fail-if-log-notifications | Mislukt als er logmeldingen worden toegevoegd tijdens de uitvoering | Geen waarde vereist (vlag) |
--process-failed | Verwerkt alleen mislukte vertalingen | Geen waarde vereist (vlag) |
Voorbeelden
# 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
Vertaal taxonomietermen (categorieën, tags, aangepaste taxonomieën).
Gebruik
wp gatotranslate term <ids> [options]Parameters
| Parameter | Beschrijving |
|---|---|
<ids> | Lijst met term-ID's om te vertalen, gescheiden door komma's of spaties |
Opties
| Optie | Beschrijving | Mogelijke waarden |
|---|---|---|
--translate-slugs=<bool> | Of slugs vertaald moeten worden | true, false |
--default-provider=<provider> | Standaard vertaalprovider | chatgpt, claude, deepl, gemini, google_translate, deepseek, mistral, openrouter, self_hosted_llm |
--language-providers=<providers> | JSON-string van taal-provider-koppeling | JSON-string met taalcodes als sleutels, en als waarden de providernaam, of "none" (om voor die taal uit te schakelen), of "default" (om de standaardprovider te gebruiken) |
--tasks=<tasks> | Door komma's gescheiden lijst van uit te voeren taken | translate-content, translate-entity-relationships |
--parts=<parts> | Door komma's gescheiden lijst van inhoudsonderdelen om te wijzigen | properties (naam, slug), content (beschrijving), meta (aangepaste velden) |
--porcelain | Geeft alleen de essentiële informatie weer, geschikt voor verwerking door scripts | Geen waarde vereist (vlag) |
--fail-if-log-notifications | Mislukt als er logmeldingen worden toegevoegd tijdens de uitvoering | Geen waarde vereist (vlag) |
--process-failed | Verwerkt alleen mislukte vertalingen | Geen waarde vereist (vlag) |
Voorbeelden
# 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
Vertaal media-items (bijlagen).
Gebruik
wp gatotranslate media <ids> [options]Parameters
| Parameter | Beschrijving |
|---|---|
<ids> | Lijst met media-ID's om te vertalen, gescheiden door komma's of spaties |
Opties
| Optie | Beschrijving | Mogelijke waarden |
|---|---|---|
--translate-slugs=<bool> | Of slugs vertaald moeten worden | true, false |
--default-provider=<provider> | Standaard vertaalprovider | chatgpt, claude, deepl, gemini, google_translate, deepseek, mistral, openrouter, self_hosted_llm |
--language-providers=<providers> | JSON-string van taal-provider-koppeling | JSON-string met taalcodes als sleutels, en als waarden de providernaam, of "none" (om voor die taal uit te schakelen), of "default" (om de standaardprovider te gebruiken) |
--tasks=<tasks> | Door komma's gescheiden lijst van uit te voeren taken | translate-content, translate-entity-relationships, replace-internal-links |
--parts=<parts> | Door komma's gescheiden lijst van inhoudsonderdelen om te wijzigen | properties (titel, slug), content (alt-tekst, bijschrift en beschrijving), meta (aangepaste velden) |
--porcelain | Geeft alleen de essentiële informatie weer, geschikt voor verwerking door scripts | Geen waarde vereist (vlag) |
--fail-if-log-notifications | Mislukt als er logmeldingen worden toegevoegd tijdens de uitvoering | Geen waarde vereist (vlag) |
--process-failed | Verwerkt alleen mislukte vertalingen | Geen waarde vereist (vlag) |
Voorbeelden
# 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
Vertaal menu's.
Alleen menu's in de broncontaal worden vertaald. Omdat Polylang de taal voor menu's niet opslaat, wordt deze informatie bepaald op basis van de toegewezen menulocaties.
De vertaling wordt voor een menu alleen gestart als:
- Het menu minstens één reeds toegewezen locatie heeft
- Geen van zijn locaties bestemd is voor een vertaaltaal
Gebruik
wp gatotranslate menu <ids> [options]Parameters
| Parameter | Beschrijving |
|---|---|
<ids> | Lijst met menu-ID's om te vertalen, gescheiden door komma's of spaties |
Opties
| Optie | Beschrijving | Mogelijke waarden |
|---|---|---|
--default-provider=<provider> | Standaard vertaalprovider | chatgpt, claude, deepl, gemini, google_translate, deepseek, mistral, openrouter, self_hosted_llm |
--language-providers=<providers> | JSON-string van taal-provider-koppeling | JSON-string met taalcodes als sleutels, en als waarden de providernaam, of "none" (om voor die taal uit te schakelen), of "default" (om de standaardprovider te gebruiken) |
--porcelain | Geeft alleen de essentiële informatie weer, geschikt voor verwerking door scripts | Geen waarde vereist (vlag) |
--fail-if-log-notifications | Mislukt als er logmeldingen worden toegevoegd tijdens de uitvoering | Geen waarde vereist (vlag) |
Voorbeelden
# 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
Vertaal gebruikersbeschrijvingen.
Gebruik
wp gatotranslate user <ids> [options]Parameters
| Parameter | Beschrijving |
|---|---|
<ids> | Lijst met gebruikers-ID's om te vertalen, gescheiden door komma's of spaties |
Opties
| Optie | Beschrijving | Mogelijke waarden |
|---|---|---|
--default-provider=<provider> | Standaard vertaalprovider | chatgpt, claude, deepl, gemini, google_translate, deepseek, mistral, openrouter, self_hosted_llm |
--language-providers=<providers> | JSON-string van taal-provider-koppeling | JSON-string met taalcodes als sleutels, en als waarden de providernaam, of "none" (om voor die taal uit te schakelen), of "default" (om de standaardprovider te gebruiken) |
--porcelain | Geeft alleen de essentiële informatie weer, geschikt voor verwerking door scripts | Geen waarde vereist (vlag) |
--fail-if-log-notifications | Mislukt als er logmeldingen worden toegevoegd tijdens de uitvoering | Geen waarde vereist (vlag) |
Voorbeelden
# 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"}'