Desenvolvedores
Referência de habilidades do Tranzly
O Tranzly registra suas ações na WordPress Abilities API. As mesmas habilidades são ferramentas MCP no próprio servidor do site e rotas REST sob /wp-json/wp-abilities/v1. Esta página é gerada a partir do próprio registro do plugin.
Endpoints
| Habilidade | REST |
|---|---|
| MCP via HTTP (streamable) | /wp-json/tranzly/v1/mcp |
| MCP via WP-CLI (entrada e saída padrão) | wp mcp-adapter serve --server=tranzly --user=<login> |
| REST: listar as habilidades | /wp-json/wp-abilities/v1/abilities?category=tranzly |
| REST: executar uma habilidade | /wp-json/wp-abilities/v1/abilities/<name>/run (GET com ?input= para habilidades somente leitura, caso contrário, POST {"input": {...}}) |
Autenticação e permissões
As requisições HTTP são autenticadas com uma senha de aplicativo do WordPress (HTTP Basic). A conexão ao servidor MCP requer a capacidade exibida abaixo; cada habilidade verifica sua própria permissão, por objeto. Habilidades somente leitura são executadas com GET e sua entrada na query string; as demais com POST e um corpo JSON ‘{“input”: {…}}’.
uma senha de aplicativo do WordPress (HTTP) ou --user (WP-CLI); o usuário precisa da capacidade especificada por cada habilidade · Configurações: Permitir agentes de IA (MCP), ativado por padrão
Todas as habilidades
| Habilidade | Edição | REST | Permissão | Parâmetros |
|---|---|---|---|---|
tranzly/bulk-translateInicia tarefas de tradução em segundo plano para cada original dos tipos de conteúdo informados (todos os tipos traduzidos quando nenhum for fornecido): as traduções ausentes, as desatualizadas ou todas elas. Retorna as tarefas iniciadas, uma por idioma. | Pro | POST /wp-json/wp-abilities/v1/abilities/tranzly/bulk-translate/run | edit_posts; publish_posts para publicar | languages (obrigatório)post_typesscope: missing, stale, allenginepublish |
tranzly/cancel-jobInterrompe uma tarefa; as traduções já feitas são mantidas. | Free | POST /wp-json/wp-abilities/v1/abilities/tranzly/cancel-job/run | manage_options (verificação própria da rota REST) | id (obrigatório) |
tranzly/check-qualityFaz a IA comparar uma tradução com seu original e avaliá-la, armazenando o relatório na tradução. Usa o modelo de IA de verificação de qualidade definido nas configurações de fluxo de trabalho do Tranzly. | Pro | POST /wp-json/wp-abilities/v1/abilities/tranzly/check-quality/run | edit_post nessa tradução | id (obrigatório) |
tranzly/connect-supportConecta este site ao suporte da Zinn Digital® (nome, e-mail, consentimento). | Free | POST /wp-json/wp-abilities/v1/abilities/tranzly/connect-support/run | manage_options (verificação própria da rota REST) | email (obrigatório)nameconsent (obrigatório) |
tranzly/correct-segmentsSalva segmentos corrigidos de uma tradução (segmentos: chave para texto); o texto corrigido fica protegido contra retradução. | Free | POST /wp-json/wp-abilities/v1/abilities/tranzly/correct-segments/run | edit_post (verificação própria da rota REST) | id (obrigatório)segmentstexts |
tranzly/create-jobInicia uma tarefa em segundo plano que traduz os posts listados (posts) ou um tipo de post inteiro para os idiomas (langs). | Free | POST /wp-json/wp-abilities/v1/abilities/tranzly/create-job/run | edit_posts (verificação própria da rota REST) | postspost_typelangs (obrigatório)enginestatus: publish, draftforce |
tranzly/create-post-translationCria um rascunho de tradução de um post em um idioma (lang) para escrever manualmente, sem um mecanismo. | Free | POST /wp-json/wp-abilities/v1/abilities/tranzly/create-post-translation/run | verificação própria de permissão por item da rota REST | id (obrigatório)lang (obrigatório)nameslugdescription |
tranzly/create-term-translationCria a tradução de um termo em um idioma com o nome, o slug e a descrição que você fornecer. | Free | POST /wp-json/wp-abilities/v1/abilities/tranzly/create-term-translation/run | verificação própria de permissão por item da rota REST | id (obrigatório)lang (obrigatório)nameslugdescription |
tranzly/disconnect-supportDesconecta este site do suporte. | Free | POST /wp-json/wp-abilities/v1/abilities/tranzly/disconnect-support/run | manage_options (verificação própria da rota REST) | nenhum |
tranzly/estimateEstima caracteres e custo para traduzir posts (posts ou post_type) para idiomas (langs) com um mecanismo, antes de gastar qualquer valor. | Free | POST /wp-json/wp-abilities/v1/abilities/tranzly/estimate/run | edit_posts (verificação própria da rota REST) | postspost_typelangs (obrigatório)engine |
tranzly/estimate-bulkEstima a tradução de todo o site em um idioma (post_types, scope, engine) antes de iniciá-la. | Pro | POST /wp-json/wp-abilities/v1/abilities/tranzly/estimate-bulk/run | edit_posts (verificação própria da rota REST) | post_typesscope: missing, stale, allenginelang (obrigatório)after |
tranzly/export-translation-fileRetorna um arquivo XLIFF ou CSV (como texto) com os originais e suas traduções em um idioma, para uma pessoa tradutora ou uma agência de tradução: os posts informados, ou uma página de até 100 originais de um tipo de conteúdo em um estado (missing, stale, translated ou all; repita com after). O mesmo arquivo pode ser importado de volta assim que traduzido. | Pro | GET /wp-json/wp-abilities/v1/abilities/tranzly/export-translation-file/run | edit_posts; cada post é incluído somente se o usuário tiver permissão para editá-lo | lang (obrigatório)format: xliff, csvpostspost_typestate: all, missing, stale, translatedafter |
tranzly/fix-statusColoca na fila a tradução de todos os itens ausentes (ou desatualizados) em um idioma e tipo de post. | Gratuito | POST /wp-json/wp-abilities/v1/abilities/tranzly/fix-status/run | edit_posts (verificação própria da rota REST) | post_type stringlang string (obrigatório)state string (obrigatório): missing, stale, quality |
tranzly/get-comments-settingRetorna se os comentários são compartilhados entre idiomas ou mantidos por idioma. | Pro | GET /wp-json/wp-abilities/v1/abilities/tranzly/get-comments-setting/run | moderate_comments (verificação própria da rota REST) | nenhum |
tranzly/get-deepl-usageRetorna os caracteres usados e o limite da chave DeepL salva neste mês. | Gratuito | GET /wp-json/wp-abilities/v1/abilities/tranzly/get-deepl-usage/run | manage_options (verificação própria da rota REST) | nenhum |
tranzly/get-diagnosticsRetorna os diagnósticos que um ticket de suporte conteria: versões, plugins ativos, limites e erros recentes. | Gratuito | GET /wp-json/wp-abilities/v1/abilities/tranzly/get-diagnostics/run | manage_options (verificação própria da rota REST) | nenhum |
tranzly/get-displayRetorna as opções de exibição do seletor de idiomas e dos créditos. | Gratuito | GET /wp-json/wp-abilities/v1/abilities/tranzly/get-display/run | manage_options (verificação própria da rota REST) | nenhum |
tranzly/get-engine-settingsRetorna o mecanismo padrão e alternativo, mecanismos e modelos de IA por idioma, o estado de cada mecanismo, os provedores de IA conectados com seus modelos e os gastos deste mês. | Gratuito | GET /wp-json/wp-abilities/v1/abilities/tranzly/get-engine-settings/run | manage_options (verificação própria da rota REST) | nenhum |
tranzly/get-glossaryRetorna os termos nunca traduzidos, as traduções de termos fixos e o tom por idioma. | Pro | GET /wp-json/wp-abilities/v1/abilities/tranzly/get-glossary/run | manage_options | nenhum |
tranzly/get-integrationsLista os plugins de SEO, WooCommerce, construtores de páginas e formulários compatíveis com o Tranzly e quais estão ativos aqui. | Gratuito | GET /wp-json/wp-abilities/v1/abilities/tranzly/get-integrations/run | manage_options (verificação própria da rota REST) | nenhum |
tranzly/get-jobRetorna o progresso e as contagens de uma tarefa. | Gratuito | GET /wp-json/wp-abilities/v1/abilities/tranzly/get-job/run | manage_options (verificação própria da rota REST) | id string (obrigatório) |
tranzly/get-job-failuresLista os itens com falha de uma tarefa com o motivo de cada um. | Gratuito | GET /wp-json/wp-abilities/v1/abilities/tranzly/get-job-failures/run | manage_options (verificação própria da rota REST) | id string (obrigatório) |
tranzly/get-legacy-importRetorna o estado e o relatório de importação de traduções do Tranzly 2.x. | Gratuito | GET /wp-json/wp-abilities/v1/abilities/tranzly/get-legacy-import/run | manage_options (verificação própria da rota REST) | nenhum |
tranzly/get-licenceRetorna o plano do Tranzly deste site, o estado da licença, a data de renovação e o que o plano inclui. | Gratuito | GET /wp-json/wp-abilities/v1/abilities/tranzly/get-licence/run | manage_options (verificação própria da rota REST) | nenhum |
tranzly/get-menusRetorna qual menu cada idioma exibe em cada posição de menu. | Gratuito | GET /wp-json/wp-abilities/v1/abilities/tranzly/get-menus/run | edit_theme_options (verificação própria da rota REST) | nenhum |
tranzly/get-post-groupLista o grupo de tradução de um post: o item de cada idioma com seu título, status e link de edição. | Gratuito | GET /wp-json/wp-abilities/v1/abilities/tranzly/get-post-group/run | edit_post e edit_term (verificação própria da rota REST) | id string (obrigatório) |
tranzly/get-quality-reportRetorna o relatório de qualidade por IA de uma tradução: pontuação e os segmentos sinalizados. | Pro | GET /wp-json/wp-abilities/v1/abilities/tranzly/get-quality-report/run | edit_post (verificação própria da rota REST) | id string (obrigatório) |
tranzly/get-segmentsRetorna os segmentos de uma tradução ao lado do original, para revisão e correção. | Gratuito | GET /wp-json/wp-abilities/v1/abilities/tranzly/get-segments/run | edit_post (verificação própria da rota REST) | id string (obrigatório) |
tranzly/get-shared-stringsRetorna os textos de temas e plugins (escopo) em um idioma com suas traduções. | Gratuito | GET /wp-json/wp-abilities/v1/abilities/tranzly/get-shared-strings/run | edit_theme_options (verificação própria da rota REST) | lang string (obrigatório)scope string: menus, site, templates, gettext.plugin-<slug>, gettext.theme-<slug> |
tranzly/get-site-stringsRetorna o título do site, a descrição e os textos dos widgets em um idioma. | Gratuito | GET /wp-json/wp-abilities/v1/abilities/tranzly/get-site-strings/run | manage_options (verificação própria da rota REST) | lang string (obrigatório) |
tranzly/get-support-connectionInforma se este site está conectado ao suporte da Zinn Digital® e como quem. | Gratuito | GET /wp-json/wp-abilities/v1/abilities/tranzly/get-support-connection/run | manage_options (verificação própria da rota REST) | refresh booleano |
tranzly/get-term-groupLista o grupo de tradução de uma categoria ou tag. | Gratuito | GET /wp-json/wp-abilities/v1/abilities/tranzly/get-term-group/run | edit_post e edit_term (verificação própria da rota REST) | id string (obrigatório) |
tranzly/get-urlsRetorna como os idiomas aparecem nos endereços (pasta, subdomínio ou domínio), slugs e bases traduzidos e noindex para páginas não traduzidas. | Gratuito | GET /wp-json/wp-abilities/v1/abilities/tranzly/get-urls/run | manage_options (verificação própria da rota REST) | nenhum |
tranzly/get-workflow-settingsRetorna a tradução automática ao publicar e atualizar, revisão antes de publicar e o limite, provedor e modelo de verificação de qualidade por IA. | Pro | GET /wp-json/wp-abilities/v1/abilities/tranzly/get-workflow-settings/run | manage_options (verificação própria da rota REST) | nenhum |
tranzly/import-from-sourceImporta a próxima página de traduções de outro plugin multilíngue (modo: dry-run ou run; cursor). | Pro | POST /wp-json/wp-abilities/v1/abilities/tranzly/import-from-source/run | manage_options (verificação própria da rota REST) | source string (obrigatório)mode string: dry-run, run, undocursor string |
tranzly/import-translation-fileGrava a próxima página de posts a partir de um arquivo de tradução enviado (repita com after até concluir). | Pro | POST /wp-json/wp-abilities/v1/abilities/tranzly/import-translation-file/run | edit_posts (verificação própria da rota REST) | token string (obrigatório)after número inteiro |
tranzly/link-postTorna um post existente (target) a tradução deste post em um idioma. | Gratuito | POST /wp-json/wp-abilities/v1/abilities/tranzly/link-post/run | edit_post e edit_term (verificação própria da rota REST) | id string (obrigatório)lang string (obrigatório)target número inteiro (obrigatório) |
tranzly/link-termTorna um termo existente (target) a tradução deste termo em um idioma. | Gratuito | POST /wp-json/wp-abilities/v1/abilities/tranzly/link-term/run | edit_post e edit_term (verificação própria da rota REST) | id string (obrigatório)lang string (obrigatório)target número inteiro (obrigatório) |
tranzly/list-enginesLista os motores de tradução, se cada um está configurado e qual é usado quando nenhum é especificado. | Gratuito | GET /wp-json/wp-abilities/v1/abilities/tranzly/list-engines/run | edit_posts | nenhum |
tranzly/list-import-sourcesLista dados do WPML, Polylang e TranslatePress encontrados neste site que podem ser importados. | Pro | GET /wp-json/wp-abilities/v1/abilities/tranzly/list-import-sources/run | manage_options (verificação própria da rota REST) | nenhum |
tranzly/list-jobsLista tarefas de tradução em segundo plano, as mais recentes primeiro, com o progresso. | Gratuito | GET /wp-json/wp-abilities/v1/abilities/tranzly/list-jobs/run | edit_posts (verificação própria da rota REST) | nenhum |
tranzly/list-languagesLista os idiomas do site. O primeiro é o idioma em que o conteúdo original foi escrito. | Gratuito | GET /wp-json/wp-abilities/v1/abilities/tranzly/list-languages/run | edit_posts | nenhum |
tranzly/list-status-itemsLista originais com seu status de tradução em um idioma (status: missing, stale, current), página por página. | Gratuito | GET /wp-json/wp-abilities/v1/abilities/tranzly/list-status-items/run | edit_posts (verificação própria da rota REST) | post_type stringlang string (obrigatório)state string: all, missing, stale, translated, human, machine, review, qualityafter número inteiro |
tranzly/list-theme-stringsLista os temas e plugins cujos textos podem ser verificados para tradução e quantas strings cada um possui. | Pro | GET /wp-json/wp-abilities/v1/abilities/tranzly/list-theme-strings/run | manage_options (verificação própria da rota REST) | nenhum |
tranzly/open-support-ticketAbre um chamado de suporte (subject, message, kind, email), com o diagnóstico deste site quando a administração autorizar. Nunca cria um login nem envia um. | Gratuito | POST /wp-json/wp-abilities/v1/abilities/tranzly/open-support-ticket/run | manage_options (verificação própria da rota REST) | subject string (obrigatório)message string (obrigatório)kind string: help, bug, feedback, feature_requestemail stringname stringdiagnostics booleano |
tranzly/record-support-consentRegistra a autorização da administração para enviar diagnósticos com chamados de suporte. | Gratuito | POST /wp-json/wp-abilities/v1/abilities/tranzly/record-support-consent/run | manage_options (verificação própria da rota REST) | consent booleano (obrigatório) |
tranzly/retry-job-itemTenta novamente um item que falhou (ação: retry, opcionalmente com outro mecanismo) ou marca-o para tradução manual (ação: by-hand). | Grátis | POST /wp-json/wp-abilities/v1/abilities/tranzly/retry-job-item/run | edit_post e manage_options (verificação própria da rota REST) | item texto (obrigatório)action texto (obrigatório)engine texto |
tranzly/review-translationAprova uma tradução (e a publica quando o original for publicado) ou a devolve (decision, note). | Pro | POST /wp-json/wp-abilities/v1/abilities/tranzly/review-translation/run | edit_post (verificação própria da rota REST) | id texto (obrigatório)decision texto (obrigatório): approve, changes, pendingnote texto |
tranzly/run-legacy-importExecuta a importação da 2.x: dry-run (apenas relatório), run ou undo. | Grátis | POST /wp-json/wp-abilities/v1/abilities/tranzly/run-legacy-import/run | manage_options (verificação própria da rota REST) | action texto (obrigatório) |
tranzly/scan-theme-stringsAnalisa a próxima página de arquivos PHP de um componente em busca de textos traduzíveis (repita com after até concluir). | Pro | POST /wp-json/wp-abilities/v1/abilities/tranzly/scan-theme-strings/run | manage_options (verificação própria da rota REST) | component texto (obrigatório)after número inteiro |
tranzly/schedule-quality-checkAgenda a verificação de qualidade por IA da próxima página de traduções de um idioma (ou dos posts informados). | Pro | POST /wp-json/wp-abilities/v1/abilities/tranzly/schedule-quality-check/run | edit_posts (verificação própria da rota REST) | lang texto (obrigatório)post_type textoposts matrizafter número inteiro |
tranzly/seo-auditVerifica traduções em busca de títulos de SEO, descrições, slugs e hreflang ausentes em um idioma, página por página. | Pro | GET /wp-json/wp-abilities/v1/abilities/tranzly/seo-audit/run | manage_options (verificação própria da rota REST) | lang texto (obrigatório)after número inteiro |
tranzly/set-comments-settingCompartilha comentários entre as traduções de um post ou os mantém por idioma (mode). | Pro | POST /wp-json/wp-abilities/v1/abilities/tranzly/set-comments-setting/run | manage_options e moderate_comments (verificação própria da rota REST) | mode texto (obrigatório): off, show, translate |
tranzly/set-engine-keySalva a chave de API (e a região para a Microsoft) do DeepL, Google ou Microsoft; em branco remove a chave. As chaves são armazenadas criptografadas e nunca retornadas. | Grátis | POST /wp-json/wp-abilities/v1/abilities/tranzly/set-engine-key/run | manage_options (verificação própria da rota REST) | engine texto (obrigatório)key texto (obrigatório)region texto |
tranzly/set-menusAtribui um menu por idioma para cada local (map). | Grátis | POST /wp-json/wp-abilities/v1/abilities/tranzly/set-menus/run | edit_theme_options (verificação própria da rota REST) | map objeto (obrigatório) |
tranzly/set-protectionProtege uma tradução contra sobreposição pelo mecanismo (protected: true) ou a desbloqueia. | Grátis | POST /wp-json/wp-abilities/v1/abilities/tranzly/set-protection/run | edit_post (verificação própria da rota REST) | id texto (obrigatório)protected booleano (obrigatório) |
tranzly/set-shared-stringsSalva traduções corrigidas de textos de temas e plugins (strings); elas se tornam protegidas. | Grátis | POST /wp-json/wp-abilities/v1/abilities/tranzly/set-shared-strings/run | edit_theme_options (verificação própria da rota REST) | lang texto (obrigatório)scope texto: menus, site, templates, gettext.plugin-<slug>, gettext.theme-<slug>strings objeto (obrigatório) |
tranzly/set-site-stringSalva um texto do site (key) em um idioma, por exemplo, o título ou a descrição do site. | Grátis | POST /wp-json/wp-abilities/v1/abilities/tranzly/set-site-string/run | edit_theme_options e manage_options (verificação própria da rota REST) | lang texto (obrigatório)key texto (obrigatório)translation texto (obrigatório) |
tranzly/set-urlsDefine o modo de endereço (mode), domínios por idioma, bases e segmentos traduzidos, noindex_untranslated e sugestões de slug. | Grátis | POST /wp-json/wp-abilities/v1/abilities/tranzly/set-urls/run | manage_options (verificação própria da rota REST) | mode textosegments objetodomains objetobases objetosuggest booleanonoindex_untranslated booleano |
tranzly/start-trialInicia o teste de 14 dias do Tranzly Pro para este site (nenhum pagamento necessário). | Grátis | POST /wp-json/wp-abilities/v1/abilities/tranzly/start-trial/run | manage_options (verificação própria da rota REST) | nenhum |
tranzly/translate-media-fieldSalva o texto alternativo, título ou legenda (field) de uma imagem em um idioma (lang). | Grátis | POST /wp-json/wp-abilities/v1/abilities/tranzly/translate-media-field/run | edit_post (verificação própria da rota REST) | id string (obrigatório)lang string (obrigatório)field string (obrigatório): alt, caption, titletranslation string (obrigatório) |
tranzly/translate-postTraduz um post ou página para um ou mais idiomas do site usando um mecanismo de tradução, criando ou atualizando cada tradução. Novas traduções são salvas como rascunhos, a menos que publish seja true. Traduções editadas manualmente são ignoradas, a menos que force seja true. | Grátis | POST /wp-json/wp-abilities/v1/abilities/tranzly/translate-post/run | permissão para traduzir o post (edit_post nele); edit_post em uma tradução existente; capacidade de publicação do tipo de post para publicar | id integer (obrigatório)languages array (obrigatório)engine stringpublish booleanforce boolean |
tranzly/translate-shared-stringsTraduz a próxima página de textos não traduzidos de temas e plugins para um idioma usando o mecanismo padrão (repita com after até concluir). | Grátis | POST /wp-json/wp-abilities/v1/abilities/tranzly/translate-shared-strings/run | edit_theme_options (verificação própria da rota REST) | lang string (obrigatório)scope string: menus, site, templates, gettext.plugin-<slug>, gettext.theme-<slug>after integer |
tranzly/translate-siteUm fluxo orientado: o agente verifica os idiomas e o mecanismo, estima o custo e traduz o que falta, pedindo confirmação antes de gastar créditos ou publicar. | Grátis | POST /wp-json/wp-abilities/v1/abilities/tranzly/translate-site/run | edit_posts | languages string (obrigatório) |
tranzly/translate-termTraduz um termo (categoria, tag ou atributo de produto) para um idioma (lang) com um mecanismo de tradução, criando ou atualizando sua tradução. | Grátis | POST /wp-json/wp-abilities/v1/abilities/tranzly/translate-term/run | verificação própria de permissão por item da rota REST | id string (obrigatório)lang string (obrigatório)engine stringforce booleanstatus string: publish, draft |
tranzly/translation-statusCom o ID do post: a tradução do post em cada idioma, se está desatualizada e quem a escreveu. Sem o ID: quanto do site está traduzido, por idioma. | Grátis | GET /wp-json/wp-abilities/v1/abilities/tranzly/translation-status/run | edit_post no post informado; edit_posts para o resumo do site | id integerpost_type string |
tranzly/unlink-postRemove um post do seu grupo de tradução; o idioma original é mantido. | Grátis | POST /wp-json/wp-abilities/v1/abilities/tranzly/unlink-post/run | edit_post e edit_term (verificação própria da rota REST) | id string (obrigatório) |
tranzly/unlink-termRemove um termo do seu grupo de tradução. | Grátis | POST /wp-json/wp-abilities/v1/abilities/tranzly/unlink-term/run | edit_post e edit_term (verificação própria da rota REST) | id string (obrigatório) |
tranzly/update-displayAltera o seletor (estilo, bandeiras, nomes, posição) e a linha de créditos. | Grátis | POST /wp-json/wp-abilities/v1/abilities/tranzly/update-display/run | manage_options (verificação própria da rota REST) | switcher objectcredit boolean |
tranzly/update-engine-settingsDefine o mecanismo padrão, o mecanismo reserva, mecanismos por idioma e modelos de IA por idioma (default, fallback, per_lang, models, caps). Tudo exceto o mecanismo padrão faz parte da versão Pro. | Grátis | POST /wp-json/wp-abilities/v1/abilities/tranzly/update-engine-settings/run | manage_options (verificação própria da rota REST) | default stringper_lang objectfallback arraycaps objectmodels object |
tranzly/update-glossarySubstitui as partes do glossário enviadas por você (termos que nunca devem ser traduzidos, traduções de termos, tom de voz); partes não enviadas são mantidas. Usado por todos os mecanismos a partir da próxima tradução. | Pro | POST /wp-json/wp-abilities/v1/abilities/tranzly/update-glossary/run | manage_options | dnt arrayterms objecttone object |
tranzly/update-settingsDefine os idiomas do site (languages: lista de códigos e nomes; o primeiro é o idioma original), o prefixo de classes no front-end e se agentes de IA (MCP) são permitidos. | Grátis | POST /wp-json/wp-abilities/v1/abilities/tranzly/update-settings/run | manage_options (verificação própria da rota REST) | prefix stringmcp booleanlanguages array |
tranzly/update-workflow-settingsDefine on_update (off, stale, translate), on_publish, review, quality_threshold, quality_provider e quality_model. | Pro | POST /wp-json/wp-abilities/v1/abilities/tranzly/update-workflow-settings/run | manage_options (verificação própria da rota REST) | on_update texto: off, stale, translateon_publish booleanoreview booleanoquality_threshold número inteiroquality_provider textoquality_model texto |
tranzly/upload-translation-fileEnvia um arquivo Tranzly XLIFF ou CSV (content, filename) traduzido em outro lugar; retorna um token que identifica o upload para a importação. | Pro | POST /wp-json/wp-abilities/v1/abilities/tranzly/upload-translation-file/run | edit_posts (verificação própria da rota REST) | content texto (obrigatório)filename texto (obrigatório) |
Gerado a partir do abilities.json do plugin, que por sua vez é gerado a partir de um site em execução; um teste falha quando os dois divergem.
Comandos do WP-CLI
Execute-os no servidor com o WP-CLI. Cada comando verifica as mesmas permissões que as telas do plugin; os exemplos são extraídos do próprio texto de ajuda do plugin.
| Comando | O que faz | Edição |
|---|---|---|
wp tranzly create <id> [--term]wp tranzly create 42 --lang=de_DE --user=admin | Cria um rascunho de tradução de um post (ou termo), vinculado a ele. | Gratuito |
wp tranzly engines | Lista os motores de tradução. | Gratuito |
wp tranzly jobs <action> [<id>...] [--lang=<codes>] [--post-type=<type>] [--engine=<id>] [--publish] [--force] [--format=<format>]wp tranzly jobs create --lang=de,fr --post-type=page --user=adminwp tranzly jobs status 12wp tranzly jobs failures 12wp tranzly jobs retry 345 --engine=deeplwp tranzly jobs retry-failed 12wp tranzly jobs run 12 # work the job here instead of waiting for the queue runner | Tarefas de tradução em segundo plano. | Gratuito |
wp tranzly legacy <action> [--format=<format>]wp tranzly legacy dry-runwp tranzly legacy runwp tranzly legacy undo | Exibe, simula (dry-run), executa ou desfaz a importação de traduções de um site Tranzly legado (2.x). | Gratuito |
wp tranzly link <source> <target> [--term] | Vincula um post (ou termo) existente como a tradução de outro. | Gratuito |
wp tranzly network <action> [--languages=<codes>]wp tranzly network setupwp tranzly network languages --languages=en_US,de_DE,fr_FR | Multisite (Agency): configure cada site da rede ou defina os idiomas iniciais dos novos sites. | Gratuito |
wp tranzly translate [<id>...] [--post-type=<type>] [--engine=<id>] [--force] [--publish] [--dry-run]wp tranzly translate --lang=de --post-type=page --user=adminwp tranzly translate 42 43 --lang=de_DE,fr_FR --engine=deepl --user=admin | Traduz posts com um motor. | Gratuito |
wp tranzly translations <id> [--term] [--format=<format>] | Lista as traduções de um post (ou termo). | Gratuito |
Funções PHP
Funções que temas e outros plugins podem chamar. Verifique function_exists() primeiro, para que seu código continue funcionando enquanto o plugin estiver inativo.
| Função | O que faz | Edição |
|---|---|---|
icl_object_id( $id, $type = 'post', $return_original_if_missing = false, $lang = null ) | WPML: a tradução de um objeto. | Pro |
pll__( $text ) | Polylang: uma sequência de caracteres registrada, traduzida. O Tranzly traduz as sequências de caracteres de temas usando o gettext do próprio WordPress, logo a sequência de caracteres retorna exatamente como fornecida. | Pro |
pll_current_language( $field = 'slug' ) | Polylang: o idioma atual. | Pro |
pll_default_language( $field = 'slug' ) | Polylang: o idioma padrão. | Pro |
pll_e( $text ) | Polylang: exibe uma sequência de caracteres registrada com escape. | Pro |
pll_get_post( $post_id, $lang = null ) | Polylang: a tradução de um post. | Pro |
pll_get_post_language( $post_id, $field = 'slug' ) | Polylang: o idioma de um post. | Pro |
pll_get_post_translations( $post_id ) | Polylang: todas as traduções de um post, slug => ID. | Pro |
pll_get_term( $term_id, $lang = null ) | Polylang: a tradução de um termo. | Pro |
pll_get_term_language( $term_id, $field = 'slug' ) | Polylang: o idioma de um termo. | Pro |
pll_get_term_translations( $term_id ) | Polylang: todas as traduções de um termo, slug => ID. | Pro |
pll_home_url( $lang = '' ) | Polylang: o URL inicial em um idioma. | Pro |
pll_is_translated_post_type( $post_type ) | Polylang: este tipo de post está traduzido? | Pro |
pll_is_translated_taxonomy( $taxonomy ) | Polylang: esta taxonomia está traduzida? | Pro |
pll_languages_list( $args = array( ) | Polylang: os idiomas. | Pro |
pll_register_string() | Polylang: registrar uma sequência de caracteres (aceita e ignorada — veja pll__()). | Pro |
pll_the_languages( $args = array( ) | Polylang: o seletor de idiomas. `raw` retorna a matriz do Polylang (slug => detalhes); caso contrário, retorna uma lista `<li>` na marcação do Polylang, exibida com echo a menos que `echo` seja 0. Respeita `hide_current`, `hide_if_no_translation` e `display_names_as` (`name` ou `slug`). Um `dropdown` é renderizado como a lista: o bloco/widget seletor do próprio Tranzly é o local ideal para um menu suspenso. | Pro |
pll_translate_string( $text ) | Polylang: uma sequência de caracteres registrada em um idioma. Como em pll__(), a sequência de caracteres retorna exatamente como fornecida. | Pro |
tranzly_compat_field( string $code, string $field ) | Um campo de um idioma, no vocabulário do Polylang. | Pro |
tranzly_current_language(): string | O idioma da requisição atual (um código de localidade do WordPress como `fr_FR`). | Free |
tranzly_default_language(): string | O idioma padrão: o primeiro listado. | Free |
tranzly_get_engines(): array | Os mecanismos disponíveis: id => nome. | Free |
tranzly_get_post_language( int $post_id ): string | O idioma em que um post está escrito. | Free |
tranzly_get_term_language( int $term_id ): string | O idioma em que um termo está escrito. | Free |
tranzly_get_term_translation( int $term_id, string $lang ): ?int | A tradução de um termo em um idioma, ou null. | Free |
tranzly_get_term_translations( int $term_id ): array | Todas as versões de um termo: código do idioma => ID do termo. | Free |
tranzly_get_translation( int $post_id, string $lang ): ?int | O ID da tradução de um post em um idioma, ou null se não houver. Retorna o ID do próprio post caso ele já esteja escrito nesse idioma. | Free |
tranzly_get_translations( int $post_id ): array | Todas as versões de um post, incluindo o próprio post: código do idioma => ID do post. Um post sem traduções retorna apenas a si mesmo em seu idioma. | Free |
tranzly_language_switcher( array $args = array( ) | O HTML de um seletor de idiomas, para qualquer tema, construtor ou plugin (T5). O elemento do Page Builder Sandwich chama essa função; o seu também pode chamar. Fica vazio quando existem menos de dois idiomas. | Free |
tranzly_language_url( string $lang, ?string $url = null ): string | Um URL que mostra o idioma especificado. | Free |
tranzly_languages(): array | Os idiomas do site, o padrão primeiro. | Free |
tranzly_register_engine( Engine $engine ) | Adicionar um mecanismo de tradução. Chame em `tranzly_register_engines`, ou em qualquer momento antes da primeira tradução da requisição. | Free |
tranzly_restore_language(): bool | Desfazer a última tranzly_switch_language(). | Free |
tranzly_switch_language( string $lang ): bool | Faz o código ser executado em outro idioma até tranzly_restore_language(): o idioma atual e as traduções do próprio WordPress são alternados. Aninha como switch_to_blog(): | Free |
tranzly_translatable_attributes( string $block_name ): array | Os nomes dos atributos que o Tranzly traduz para um tipo de bloco: `role: content` em seu block.json, ajustado pelo filtro `tranzly_translatable_attributes`. | Free |
tranzly_translate_post( int $post_id, string $lang, string $engine = '', array $args = array( ) | Traduz um post para um idioma com um mecanismo, como o usuário atual (as permissões dele se aplicam). | Grátis |
Ações e filtros
Todos os hooks que o plugin oferece, com a descrição do seu código-fonte. Filtros alteram um valor; ações permitem executar código em determinado momento; pontos de entrada são ações disparadas para solicitar que o plugin faça algo.
| Gancho | Tipo | O que faz | Parâmetros | Edição |
|---|---|---|---|---|
tranzly_admin_bar | Ação | Disparado após a criação do menu de traduções na barra de administração (o editor visual do Pro adiciona o item “Traduzir nesta página” aqui). | \WP_Admin_Bar $barint $id | Gratuita |
tranzly_admin_data | Filtro | Filtra os dados com os quais o aplicativo do painel é iniciado. A camada premium usa esse filtro para informar sua edição; nada confidencial deve ser colocado aqui, pois é exibido na página. | nenhum | Gratuita |
tranzly_ai_model | Filtro | Filtra o provedor e o modelo de IA que traduzem para um idioma. Gratuita: o provedor e o modelo escolhidos para a tarefa `translate`, para todos os idiomas. Tranzly Pro: a escolha própria do idioma; caso contrário, a escolha para “todos os outros idiomas”. | string $target | Gratuita |
tranzly_ai_providers_in_use | Filtro | Filtra os provedores de IA escolhidos para idiomas específicos. Nenhum no plugin gratuito: cada idioma usa o provedor e o modelo escolhidos para a tarefa `translate`. O Tranzly Pro lista os provedores de seus modelos por idioma. | nenhum | Gratuita |
tranzly_content_before_rebuild | Filtro | Filtra o conteúdo de origem imediatamente antes dos segmentos traduzidos serem gravados nele, por idioma (a substituição de imagens por idioma do Pro usa esse filtro). | string $contentstring $lang | Gratuita |
tranzly_copy_meta_keys | Filtro | Filtra os metadados copiados de um post para sua nova tradução. Nada mais é copiado. | int $source_id | Gratuita |
tranzly_deepl_host | Filtro | Filtra o host da API do DeepL (um proxy ou um ambiente de teste). | string $hoststring $key | Gratuita |
tranzly_deepl_price_per_million | Filtro | Filtra o preço do DeepL por milhão de caracteres em dólares americanos. | float $price | Gratuita |
tranzly_default_engine | Filtro | Filtra o ID do mecanismo usado quando nenhum é especificado. | string $id | Gratuita |
tranzly_engine_cap | Filtro | Filtra o limite mensal de um mecanismo em dólares americanos: nenhum no plugin gratuito. | float|null $capstring $engine | Gratuita |
tranzly_engine_chain | Filtro | Filtra os mecanismos a serem tentados para um idioma, em ordem. Gratuita: o mecanismo padrão. A camada premium adiciona o mecanismo próprio do idioma e a lista de contingência. | string $langstring $first | Gratuita |
tranzly_engine_options | Filtro | Filtra as opções enviadas para o mecanismo (lista de termos não traduzíveis, glossário, formalidade, instruções). | string $targetEngine $engine | Gratuita |
tranzly_engine_settings_save | Filtro | Salva os mecanismos e modelos de IA por idioma, a lista de contingência e os limites mensais. Apenas a camada premium responde (diretriz 5 do WordPress.org: nenhum comportamento Pro no plugin gratuito). | nenhum | Gratuita |
tranzly_frontend_prefix | Filtro | Filtra o prefixo de classe neutro do front-end. | string $prefix | Gratuita |
tranzly_fs_loaded | Ação | Disparado assim que o SDK de licenciamento for carregado (no arquivo principal, antes de qualquer código do Tranzly). Conecte aqui para se comunicar com o `tranzly_fs()`. | nenhum | Gratuita |
tranzly_glossary_options | Filtro | Filtra as opções de mecanismo para um idioma de destino: a lista de termos não traduzíveis, além do glossário e do tom quando a camada premium os adiciona. | string $lang | Gratuita |
tranzly_glossary_save | Filtro | Salva as traduções preferidas e o tom por idioma. Apenas a camada premium responde (diretriz 5 do WordPress.org: nenhum comportamento Pro no plugin gratuito). | nenhum | Gratuita |
tranzly_google_price_per_million | Filtro | Filtra o preço do Google Cloud Translation por milhão de caracteres, em dólares americanos. | float $price | Pro |
tranzly_install_language_packs | Filtro | Define se o Tranzly instala os pacotes de idiomas do WordPress, de temas e de plugins de um idioma adicionado ao site (para que os termos nativos do WordPress e do WooCommerce apareçam traduzidos). Ativado por padrão. | bool $install | Gratuita |
tranzly_integration_available | Filtro | Filtra se uma integração é executada quando o plugin correspondente não é detectado — útil para conteúdos deixados por um construtor de páginas após ser desativado, ou para plugins carregados de forma incomum. | bool $onstring $id | Gratuita |
tranzly_integrations | Filtro | Filtra as integrações executadas pelo Tranzly. Adicione uma subclasse de `Integration` para oferecer suporte a outro plugin. | nenhum | Gratuita |
tranzly_is_pro | Filtro | Filtra se a camada premium está ativa. Apenas a camada premium responde a ele. | bool $pro | Gratuita |
tranzly_job_created | Ação | Disparado após a criação de uma tarefa de tradução. | int $jobint $items | Gratuita |
tranzly_job_finished | Ação | É executada quando uma tarefa de tradução não tem mais trabalho pendente. | int $job_id | Gratuito |
tranzly_kit_api_base | Filtro | Filtra a base da API da Zinn Digital® chamada pelas telas de suporte. | string $base | Gratuito |
tranzly_kit_diagnostics | Filtro | Filtra os diagnósticos antes que o responsável pelo site os veja. Um plugin adiciona seus próprios dados em `extra`. ⛔ Isso é executado ANTES da pré-visualização, nunca entre a pré-visualização e o envio. | nenhum | Gratuito |
tranzly_kit_footprint_free | Filtro | Filtra se este site é livre de rastros, para que o Zinn® Ads nunca seja promovido nele. | bool $footprint_free | Gratuito |
tranzly_kit_promotions | Filtro | Filtra o registro de promoções antes de ser resolvido. Adicione uma linha para promover outro produto: `id`, `kind` (hosting|marketplace|platform|plugin|bundle|ads), `slot` (promo|cross-sell) e `url` ou (para um plugin) `name`, `site`, `main_files`. | nenhum | Gratuito |
tranzly_kit_tier | Filtro | Filtra o nível de plano que o kit informa para este plugin (testes e preparação; a licença define na produção). | string $tier | Gratuito |
tranzly_localize_links | Filtro | Filtra se o Tranzly direciona os links internos desta página para suas respectivas traduções. | bool $localizestring $lang | Gratuito |
tranzly_memory_enabled | Filtro | Filtra se a memória de tradução é usada. | bool $on | Pro |
tranzly_microsoft_price_per_million | Filtro | Filtra o preço do Microsoft Translator por milhão de caracteres, em dólares americanos. | float $price | Pro |
tranzly_network_enabled | Filtro | Filtra se a camada de rede multisite está ativada. | bool $agency | Gratuito |
tranzly_pbs_internal_post_types | Filtro | Filtra os tipos de post do Page Builder Sandwich que o Tranzly não altera. | nenhum | Gratuito |
tranzly_post_segments | Filtro | Filtra os segmentos de um post enviados para o mecanismo. Chave => `text` + `format` (`text` ou `html`). O analisador com suporte a blocos e integrações adicionam, dividem ou substituem segmentos aqui, e os gravam de volta em `tranzly_translated_post_fields`. | \WP_Post $post | Gratuito |
tranzly_post_translated | Ação | É executada após um mecanismo traduzir um post (ou o arquivo de uma pessoa ou uma importação gravá-lo). | int $targetint $source_idstring $codestring $engine | Gratuito |
tranzly_post_translation_created | Ação | É executada após o Tranzly criar a tradução de um post. | int $new_idint $source_idstring $code | Gratuito |
tranzly_post_types | Filtro | Filtra os tipos de post que o Tranzly traduz. | nenhum | Gratuito |
tranzly_pre_current_language | Filtro | Ignora o idioma atual: retorne um código de idioma para usá-lo. É assim que tranzly_switch_language() funciona; retorne null para deixar o Tranzly decidir. | string|null $lang | Gratuito |
tranzly_query_var | Filtro | Filtra a variável de consulta que seleciona o idioma. | string $var | Gratuito |
tranzly_queue_lease_seconds | Filtro | Filtra o tempo de concessão de um item reivindicado: após esse período, um worker que falhou no meio do item o devolve para os outros. Maior do que a tradução individual mais lenta. | int $seconds | Gratuito |
tranzly_queue_worker_seconds | Filtro | Filtra quanto tempo um worker é executado antes de passar a tarefa adiante, em segundos. | int $seconds | Gratuito |
tranzly_queue_workers | Filtro | Filtra quantos workers uma tarefa executa simultaneamente. Um limite de WORKERS, para não sobrecarregar o serviço de tradução; nunca um limite para quantos itens são concluídos. | int $workersint $job_id | Gratuito |
tranzly_rate_source_ | Filtro | Taxas de outra fonte (consulte `tranzly_rate_sources`). | nenhum | Pro |
tranzly_rate_sources | Filtro | Filtra as fontes de taxas de câmbio. Adicione uma com o filtro `tranzly_rate_source_<id>` que retorna `[ code => taxa em relação à sua referência ]`, ou um WP_Error. | nenhum | Pro |
tranzly_register_engines | Ação | Registrar mecanismos de tradução. Chame `$registry->add( new Seu_Mecanismo() )`. | Registry $registry | Gratuito |
tranzly_relations_changed | Ação | É executada após as ligações de tradução dos objetos mudarem: vinculadas, desvinculadas, movidas para outro idioma ou removidas. É executada uma vez por grupo afetado, portanto, uma única ligação pode executá-la duas vezes. | string $typearray<int> $ids | Gratuito |
tranzly_robots_meta_keys | Filtro | Filtra as chaves de metadados do post que armazenam as configurações de robots; cada uma acompanha o original para suas traduções. | nenhum | Gratuito |
tranzly_shared_string_scopes | Filtro | Filtra os escopos de texto compartilhado (lane L06, T6: integrações adicionam `woocommerce`, `forms` e `theme`; seus textos chegam em `tranzly_shared_strings`). | nenhum | Grátis |
tranzly_shared_strings | Filtro | Filtra os textos compartilhados que o Tranzly traduz como strings, por escopo. A camada Pro adiciona modelos de bloco, partes de modelo e padrões a `templates`. | string $scope | Grátis |
tranzly_shared_strings_covered | Filtro | Filtra os textos de um escopo de texto compartilhado que um pacote de idioma traduz para uma língua. A camada Pro relata os padrões registrados do tema e do núcleo para `templates`. | string $scopestring $lang | Grátis |
tranzly_source_changed | Ação | Disparada quando o conteúdo traduzível de um original foi alterado, tornando suas traduções desatualizadas. | int $post_idstring $nowstring $before | Grátis |
tranzly_source_meta_keys | Filtro | Filtra as chaves de metadados cuja alteração desatualiza as traduções de uma página. Integrações adicionam as chaves que traduzem (dados de construtores, campos de SEO, campos personalizados). | int $post_id | Grátis |
tranzly_source_published | Ação | Disparada uma vez quando um original é publicado pela primeira vez (depois que seus metadados são salvos). | int $post_id | Grátis |
tranzly_style_rules_enabled | Filtro | Define se o Tranzly aplica as regras de estilo da equipe de tradução do WordPress.org do idioma (aspas, espaçamento de pontuação, apóstrofos, reticências, espaçamento em japonês, pronomes de tratamento) a cada nova tradução. Ativado por padrão. | bool $enabledstring $locale | Grátis |
tranzly_taxonomies | Filtro | Filtra as taxonomias que o Tranzly traduz. | nenhum | Grátis |
tranzly_term_segments | Filtro | Filtra os segmentos de um termo enviados ao mecanismo (`name`, `description`, além do que as integrações adicionarem: títulos de SEO, campos personalizados). Escreva os itens adicionados em `tranzly_term_translated`. | \WP_Term $term | Grátis |
tranzly_term_translated | Ação | Disparada depois que um mecanismo traduz um termo, com cada segmento traduzido (integrações escrevem os segmentos adicionados em `tranzly_term_segments`). | int $targetint $term_idstring $code | Grátis |
tranzly_term_translation_created | Ação | Disparada depois que o Tranzly cria a tradução de um termo. | int $new_idint $term_idstring $code | Grátis |
tranzly_translatable_attributes | Filtro | Filtra os atributos que o Tranzly traduz para um tipo de bloco. | string $block_name | Grátis |
tranzly_translate_string | Filtro | Filtra uma string traduzível para um idioma. | string $valuestring $codearray $context | Grátis |
tranzly_translated_post_fields | Filtro | Filtra os campos de post gravados em uma tradução, depois da execução do mecanismo. Integrações que adicionaram segmentos próprios (campos personalizados, dados de construtores) escrevem aqui. | \WP_Post $poststring $code | Grátis |
tranzly_translation_memory | Filtro | Filtra a memória de tradução em uso: nenhuma no plugin gratuito; a camada premium oferece uma (docs/843, diretriz 5 do WordPress.org). | Translation_Memory|null $memory | Grátis |