ZaawansowanePolecenia WP-CLI
Polecenia WP-CLI
Następujące polecenia WP-CLI są dostępne do tłumaczenia niestandardowych wpisów, terminów taksonomii (tagów i kategorii), elementów multimedialnych, menu i użytkowników.
Polecenia WP-CLI są domyślnie uruchamiane bez zalogowanego użytkownika. Aby mieć odpowiednie uprawnienia do tworzenia wpisów tłumaczeń, należy uruchamiać polecenia w kontekście użytkownika, za pomocą opcji --user:
wp gatotranslate post 123 --user=adminwp gatotranslate post
Tłumaczenie niestandardowych wpisów (posty, strony, niestandardowe typy wpisów).
Użycie
wp gatotranslate post <ids> [options]Parametry
| Parametr | Opis |
|---|---|
<ids> | Lista identyfikatorów wpisów do przetłumaczenia, oddzielonych przecinkami lub spacjami |
Opcje
Jeśli nie zostaną podane, opcje zostaną ustawione według wartości skonfigurowanych w Ustawieniach wtyczki.
| Opcja | Opis | Możliwe wartości |
|---|---|---|
--translate-slugs=<bool> | Czy tłumaczyć sligi | true, false |
--default-provider=<provider> | Domyślny dostawca tłumaczeń | chatgpt, claude, deepl, gemini, google_translate, deepseek, mistral, openrouter, self_hosted_llm |
--status-to-update=<status> | Status, jaki muszą mieć wpisy, aby zostały zaktualizowane | draft, pending, publish, private, future, any |
--status-when-translated=<status> | Status, jaki wpisy będą miały po przetłumaczeniu | draft, pending, publish, private, current (tzn. nie zmieniaj statusu), same-as-origin (tzn. skopiuj status z wpisu źródłowego) |
--copy-date=<bool> | Czy kopiować datę z oryginalnego wpisu | true, false |
--language-providers=<providers> | Ciąg JSON mapowania dostawców według języka | Ciąg JSON z kodami języków jako kluczami i, jako wartościami, nazwą dostawcy, lub "none" (aby wyłączyć dla danego języka), lub "default" (aby użyć domyślnego dostawcy) |
--tasks=<tasks> | Lista zadań do wykonania, oddzielona przecinkami | translate-content, translate-entity-relationships, replace-internal-links |
--parts=<parts> | Lista części treści do zmodyfikowania, oddzielona przecinkami | properties (tytuł, slug i fragment), content (treść wpisu), meta (pola niestandardowe) |
--porcelain | Wyświetla tylko podstawowe informacje, odpowiednie do przetwarzania przez skrypty | Nie wymaga wartości (flaga) |
--fail-if-log-notifications | Kończy błędem, jeśli podczas wykonywania dodane zostaną powiadomienia dziennika | Nie wymaga wartości (flaga) |
--process-failed | Przetwarza tylko nieudane tłumaczenia | Nie wymaga wartości (flaga) |
Przykłady
# 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
Tłumaczenie terminów taksonomii (kategorie, tagi, niestandardowe taksonomie).
Użycie
wp gatotranslate term <ids> [options]Parametry
| Parametr | Opis |
|---|---|
<ids> | Lista identyfikatorów terminów do przetłumaczenia, oddzielonych przecinkami lub spacjami |
Opcje
| Opcja | Opis | Możliwe wartości |
|---|---|---|
--translate-slugs=<bool> | Czy tłumaczyć sligi | true, false |
--default-provider=<provider> | Domyślny dostawca tłumaczeń | chatgpt, claude, deepl, gemini, google_translate, deepseek, mistral, openrouter, self_hosted_llm |
--language-providers=<providers> | Ciąg JSON mapowania dostawców według języka | Ciąg JSON z kodami języków jako kluczami i, jako wartościami, nazwą dostawcy, lub "none" (aby wyłączyć dla danego języka), lub "default" (aby użyć domyślnego dostawcy) |
--tasks=<tasks> | Lista zadań do wykonania, oddzielona przecinkami | translate-content, translate-entity-relationships |
--parts=<parts> | Lista części treści do zmodyfikowania, oddzielona przecinkami | properties (nazwa, slug), content (opis), meta (pola niestandardowe) |
--porcelain | Wyświetla tylko podstawowe informacje, odpowiednie do przetwarzania przez skrypty | Nie wymaga wartości (flaga) |
--fail-if-log-notifications | Kończy błędem, jeśli podczas wykonywania dodane zostaną powiadomienia dziennika | Nie wymaga wartości (flaga) |
--process-failed | Przetwarza tylko nieudane tłumaczenia | Nie wymaga wartości (flaga) |
Przykłady
# 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
Tłumaczenie elementów multimedialnych (załączników).
Użycie
wp gatotranslate media <ids> [options]Parametry
| Parametr | Opis |
|---|---|
<ids> | Lista identyfikatorów elementów multimedialnych do przetłumaczenia, oddzielonych przecinkami lub spacjami |
Opcje
| Opcja | Opis | Możliwe wartości |
|---|---|---|
--translate-slugs=<bool> | Czy tłumaczyć sligi | true, false |
--default-provider=<provider> | Domyślny dostawca tłumaczeń | chatgpt, claude, deepl, gemini, google_translate, deepseek, mistral, openrouter, self_hosted_llm |
--language-providers=<providers> | Ciąg JSON mapowania dostawców według języka | Ciąg JSON z kodami języków jako kluczami i, jako wartościami, nazwą dostawcy, lub "none" (aby wyłączyć dla danego języka), lub "default" (aby użyć domyślnego dostawcy) |
--tasks=<tasks> | Lista zadań do wykonania, oddzielona przecinkami | translate-content, translate-entity-relationships, replace-internal-links |
--parts=<parts> | Lista części treści do zmodyfikowania, oddzielona przecinkami | properties (tytuł, slug), content (tekst alternatywny, podpis i opis), meta (pola niestandardowe) |
--porcelain | Wyświetla tylko podstawowe informacje, odpowiednie do przetwarzania przez skrypty | Nie wymaga wartości (flaga) |
--fail-if-log-notifications | Kończy błędem, jeśli podczas wykonywania dodane zostaną powiadomienia dziennika | Nie wymaga wartości (flaga) |
--process-failed | Przetwarza tylko nieudane tłumaczenia | Nie wymaga wartości (flaga) |
Przykłady
# 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
Tłumaczenie menu.
Tłumaczone są tylko menu w języku źródłowym. Ponieważ Polylang nie przechowuje informacji o języku menu, jest ona określana na podstawie przypisanych lokalizacji menu.
Tłumaczenie jest wyzwalane dla menu tylko wtedy, gdy:
- Menu ma przypisaną co najmniej jedną lokalizację
- Żadna z jego lokalizacji nie jest przeznaczona dla języka tłumaczenia
Użycie
wp gatotranslate menu <ids> [options]Parametry
| Parametr | Opis |
|---|---|
<ids> | Lista identyfikatorów menu do przetłumaczenia, oddzielonych przecinkami lub spacjami |
Opcje
| Opcja | Opis | Możliwe wartości |
|---|---|---|
--default-provider=<provider> | Domyślny dostawca tłumaczeń | chatgpt, claude, deepl, gemini, google_translate, deepseek, mistral, openrouter, self_hosted_llm |
--language-providers=<providers> | Ciąg JSON mapowania dostawców według języka | Ciąg JSON z kodami języków jako kluczami i, jako wartościami, nazwą dostawcy, lub "none" (aby wyłączyć dla danego języka), lub "default" (aby użyć domyślnego dostawcy) |
--porcelain | Wyświetla tylko podstawowe informacje, odpowiednie do przetwarzania przez skrypty | Nie wymaga wartości (flaga) |
--fail-if-log-notifications | Kończy błędem, jeśli podczas wykonywania dodane zostaną powiadomienia dziennika | Nie wymaga wartości (flaga) |
Przykłady
# 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
Tłumaczenie opisów użytkowników.
Użycie
wp gatotranslate user <ids> [options]Parametry
| Parametr | Opis |
|---|---|
<ids> | Lista identyfikatorów użytkowników do przetłumaczenia, oddzielonych przecinkami lub spacjami |
Opcje
| Opcja | Opis | Możliwe wartości |
|---|---|---|
--default-provider=<provider> | Domyślny dostawca tłumaczeń | chatgpt, claude, deepl, gemini, google_translate, deepseek, mistral, openrouter, self_hosted_llm |
--language-providers=<providers> | Ciąg JSON mapowania dostawców według języka | Ciąg JSON z kodami języków jako kluczami i, jako wartościami, nazwą dostawcy, lub "none" (aby wyłączyć dla danego języka), lub "default" (aby użyć domyślnego dostawcy) |
--porcelain | Wyświetla tylko podstawowe informacje, odpowiednie do przetwarzania przez skrypty | Nie wymaga wartości (flaga) |
--fail-if-log-notifications | Kończy błędem, jeśli podczas wykonywania dodane zostaną powiadomienia dziennika | Nie wymaga wartości (flaga) |
Przykłady
# 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"}'