AvançadoComandos WP-CLI
Comandos WP-CLI
Os seguintes comandos WP-CLI estão disponíveis para traduzir custom posts, termos de taxonomia (tags e categorias), itens de mídia, menus e usuários.
Os comandos WP-CLI são executados sem um usuário autenticado por padrão. Para ter as permissões adequadas para criar as entradas de tradução, você deve executar os comandos com um contexto de usuário, por meio da opção --user:
wp gatotranslate post 123 --user=adminwp gatotranslate post
Traduzir custom posts (posts, páginas, tipos de post personalizados).
Uso
wp gatotranslate post <ids> [options]Parâmetros
| Parâmetro | Descrição |
|---|---|
<ids> | Lista de IDs de posts a serem traduzidos, separados por vírgulas ou espaços |
Opções
Se não fornecidas, as opções serão definidas com o valor configurado nas Configurações do plugin.
| Opção | Descrição | Valores possíveis |
|---|---|---|
--translate-slugs=<bool> | Se os slugs devem ser traduzidos | true, false |
--default-provider=<provider> | Provedor de tradução padrão | chatgpt, claude, deepl, gemini, google_translate, deepseek, mistral, openrouter, self_hosted_llm |
--status-to-update=<status> | O status que os posts devem ter para serem atualizados | draft, pending, publish, private, future, any |
--status-when-translated=<status> | O status que os posts terão após a tradução | draft, pending, publish, private, current (ou seja, não modificar o status), same-as-origin (ou seja, copiar o status do post de origem) |
--copy-date=<bool> | Se a data deve ser copiada do post original | true, false |
--language-providers=<providers> | String JSON do mapeamento de provedores por idioma | String JSON com códigos de idioma como chaves e, como valores, o nome do provedor, ou "none" (para desabilitar aquele idioma), ou "default" (para usar o provedor padrão) |
--tasks=<tasks> | Lista de tarefas a executar, separadas por vírgulas | translate-content, translate-entity-relationships, replace-internal-links |
--parts=<parts> | Lista das partes do conteúdo a modificar, separadas por vírgulas | properties (título, slug e resumo), content (conteúdo do post), meta (campos personalizados) |
--porcelain | Exibe apenas as informações essenciais, adequadas para processamento por scripts | Nenhum valor necessário (flag) |
--fail-if-log-notifications | Falha se notificações de log forem adicionadas durante a execução | Nenhum valor necessário (flag) |
--process-failed | Processa apenas as traduções que falharam | Nenhum valor necessário (flag) |
Exemplos
# 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
Traduzir termos de taxonomia (categorias, tags, taxonomias personalizadas).
Uso
wp gatotranslate term <ids> [options]Parâmetros
| Parâmetro | Descrição |
|---|---|
<ids> | Lista de IDs de termos a serem traduzidos, separados por vírgulas ou espaços |
Opções
| Opção | Descrição | Valores possíveis |
|---|---|---|
--translate-slugs=<bool> | Se os slugs devem ser traduzidos | true, false |
--default-provider=<provider> | Provedor de tradução padrão | chatgpt, claude, deepl, gemini, google_translate, deepseek, mistral, openrouter, self_hosted_llm |
--language-providers=<providers> | String JSON do mapeamento de provedores por idioma | String JSON com códigos de idioma como chaves e, como valores, o nome do provedor, ou "none" (para desabilitar aquele idioma), ou "default" (para usar o provedor padrão) |
--tasks=<tasks> | Lista de tarefas a executar, separadas por vírgulas | translate-content, translate-entity-relationships |
--parts=<parts> | Lista das partes do conteúdo a modificar, separadas por vírgulas | properties (nome, slug), content (descrição), meta (campos personalizados) |
--porcelain | Exibe apenas as informações essenciais, adequadas para processamento por scripts | Nenhum valor necessário (flag) |
--fail-if-log-notifications | Falha se notificações de log forem adicionadas durante a execução | Nenhum valor necessário (flag) |
--process-failed | Processa apenas as traduções que falharam | Nenhum valor necessário (flag) |
Exemplos
# 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
Traduzir itens de mídia (anexos).
Uso
wp gatotranslate media <ids> [options]Parâmetros
| Parâmetro | Descrição |
|---|---|
<ids> | Lista de IDs de itens de mídia a serem traduzidos, separados por vírgulas ou espaços |
Opções
| Opção | Descrição | Valores possíveis |
|---|---|---|
--translate-slugs=<bool> | Se os slugs devem ser traduzidos | true, false |
--default-provider=<provider> | Provedor de tradução padrão | chatgpt, claude, deepl, gemini, google_translate, deepseek, mistral, openrouter, self_hosted_llm |
--language-providers=<providers> | String JSON do mapeamento de provedores por idioma | String JSON com códigos de idioma como chaves e, como valores, o nome do provedor, ou "none" (para desabilitar aquele idioma), ou "default" (para usar o provedor padrão) |
--tasks=<tasks> | Lista de tarefas a executar, separadas por vírgulas | translate-content, translate-entity-relationships, replace-internal-links |
--parts=<parts> | Lista das partes do conteúdo a modificar, separadas por vírgulas | properties (título, slug), content (texto alternativo, legenda e descrição), meta (campos personalizados) |
--porcelain | Exibe apenas as informações essenciais, adequadas para processamento por scripts | Nenhum valor necessário (flag) |
--fail-if-log-notifications | Falha se notificações de log forem adicionadas durante a execução | Nenhum valor necessário (flag) |
--process-failed | Processa apenas as traduções que falharam | Nenhum valor necessário (flag) |
Exemplos
# 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
Traduzir menus.
Apenas os menus no idioma de origem são traduzidos. Como o Polylang não armazena o idioma para menus, essa informação é determinada a partir dos locais de menu atribuídos.
A tradução é acionada para um menu somente se:
- O menu tiver pelo menos um local já atribuído
- Nenhum de seus locais for para um idioma de tradução
Uso
wp gatotranslate menu <ids> [options]Parâmetros
| Parâmetro | Descrição |
|---|---|
<ids> | Lista de IDs de menus a serem traduzidos, separados por vírgulas ou espaços |
Opções
| Opção | Descrição | Valores possíveis |
|---|---|---|
--default-provider=<provider> | Provedor de tradução padrão | chatgpt, claude, deepl, gemini, google_translate, deepseek, mistral, openrouter, self_hosted_llm |
--language-providers=<providers> | String JSON do mapeamento de provedores por idioma | String JSON com códigos de idioma como chaves e, como valores, o nome do provedor, ou "none" (para desabilitar aquele idioma), ou "default" (para usar o provedor padrão) |
--porcelain | Exibe apenas as informações essenciais, adequadas para processamento por scripts | Nenhum valor necessário (flag) |
--fail-if-log-notifications | Falha se notificações de log forem adicionadas durante a execução | Nenhum valor necessário (flag) |
Exemplos
# 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
Traduzir descrições de usuários.
Uso
wp gatotranslate user <ids> [options]Parâmetros
| Parâmetro | Descrição |
|---|---|
<ids> | Lista de IDs de usuários a serem traduzidos, separados por vírgulas ou espaços |
Opções
| Opção | Descrição | Valores possíveis |
|---|---|---|
--default-provider=<provider> | Provedor de tradução padrão | chatgpt, claude, deepl, gemini, google_translate, deepseek, mistral, openrouter, self_hosted_llm |
--language-providers=<providers> | String JSON do mapeamento de provedores por idioma | String JSON com códigos de idioma como chaves e, como valores, o nome do provedor, ou "none" (para desabilitar aquele idioma), ou "default" (para usar o provedor padrão) |
--porcelain | Exibe apenas as informações essenciais, adequadas para processamento por scripts | Nenhum valor necessário (flag) |
--fail-if-log-notifications | Falha se notificações de log forem adicionadas durante a execução | Nenhum valor necessário (flag) |
Exemplos
# 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"}'