Desarrolladores
Referencia de habilidades de Tranzly
Tranzly registra sus acciones con la Abilities API de WordPress. Las mismas habilidades son herramientas MCP en el propio servidor del sitio y rutas REST bajo /wp-json/wp-abilities/v1. Esta página se genera a partir del propio registro del plugin.
Endpoints
| Habilidad | REST |
|---|---|
| MCP a través de HTTP (streamable) | /wp-json/tranzly/v1/mcp |
| MCP a través de WP-CLI (entrada y salida estándar) | wp mcp-adapter serve --server=tranzly --user=<login> |
| REST: listar las habilidades | /wp-json/wp-abilities/v1/abilities?category=tranzly |
| REST: ejecutar una habilidad | /wp-json/wp-abilities/v1/abilities/<name>/run (GET con ?input= para habilidades de solo lectura, POST {"input": {...}} en caso contrario) |
Autenticación y permisos
Las solicitudes HTTP se autentican con una contraseña de aplicación de WordPress (HTTP Basic). Conectarse al servidor MCP requiere la capacidad que se muestra a continuación; luego, cada habilidad comprueba su propio permiso por objeto. Las habilidades de solo lectura se ejecutan con GET y su entrada en la cadena de consulta; las demás, con POST y un cuerpo JSON ‘{«input»: {…}}’.
una contraseña de aplicación de WordPress (HTTP) o --user (WP-CLI); el usuario necesita la capacidad que indica cada habilidad · Ajustes: Permitir agentes de IA (MCP), activado por defecto
Todas las habilidades
| Habilidad | Edición | REST | Permiso | Parámetros |
|---|---|---|---|---|
tranzly/bulk-translateInicia tareas de traducción en segundo plano para cada original de los tipos de contenido indicados (todos los tipos traducidos si no se especifica ninguno): las traducciones que faltan, las obsoletas o todas. Devuelve las tareas iniciadas, una por idioma. | Pro | POST /wp-json/wp-abilities/v1/abilities/tranzly/bulk-translate/run | edit_posts; publish_posts para publicar | languages array (obligatorio)post_types arrayscope string: missing, stale, allengine stringpublish boolean |
tranzly/cancel-jobDetiene una tarea; las traducciones ya realizadas se conservan. | Free | POST /wp-json/wp-abilities/v1/abilities/tranzly/cancel-job/run | manage_options (comprobación propia de la ruta REST) | id string (obligatorio) |
tranzly/check-qualityHace que la IA compare una traducción con su original y la puntúe, guardando el informe en la traducción. Utiliza el modelo de IA de control de calidad configurado en los ajustes de flujo de trabajo de Tranzly. | Pro | POST /wp-json/wp-abilities/v1/abilities/tranzly/check-quality/run | edit_post en esa traducción | id integer (obligatorio) |
tranzly/connect-supportConecta este sitio con el soporte de Zinn Digital® (nombre, correo electrónico, consentimiento). | Free | POST /wp-json/wp-abilities/v1/abilities/tranzly/connect-support/run | manage_options (comprobación propia de la ruta REST) | email string (obligatorio)name stringconsent boolean (obligatorio) |
tranzly/correct-segmentsGuarda los segmentos corregidos de una traducción (segmentos: clave a texto); el texto corregido queda protegido contra nuevas traducciones. | Free | POST /wp-json/wp-abilities/v1/abilities/tranzly/correct-segments/run | edit_post (comprobación propia de la ruta REST) | id string (obligatorio)segments objecttexts object |
tranzly/create-jobInicia una tarea en segundo plano que traduce las entradas indicadas (posts) o un tipo de contenido completo a varios idiomas (langs). | Free | POST /wp-json/wp-abilities/v1/abilities/tranzly/create-job/run | edit_posts (comprobación propia de la ruta REST) | posts arraypost_type stringlangs array (obligatorio)engine stringstatus string: publish, draftforce boolean |
tranzly/create-post-translationCrea un borrador de traducción de una entrada en un idioma (lang) para escribirlo a mano, sin motor de traducción. | Free | POST /wp-json/wp-abilities/v1/abilities/tranzly/create-post-translation/run | comprobación propia de permisos por elemento de la ruta REST | id string (obligatorio)lang string (obligatorio)name stringslug stringdescription string |
tranzly/create-term-translationCrea la traducción de un término en un idioma con el nombre, slug y descripción que indiques. | Free | POST /wp-json/wp-abilities/v1/abilities/tranzly/create-term-translation/run | comprobación propia de permisos por elemento de la ruta REST | id string (obligatorio)lang string (obligatorio)name stringslug stringdescription string |
tranzly/disconnect-supportDesconecta este sitio del soporte. | Free | POST /wp-json/wp-abilities/v1/abilities/tranzly/disconnect-support/run | manage_options (comprobación propia de la ruta REST) | ninguno |
tranzly/estimateEstima los caracteres y el coste de traducir entradas (posts o post_type) a varios idiomas (langs) con un motor, antes de realizar ningún gasto. | Free | POST /wp-json/wp-abilities/v1/abilities/tranzly/estimate/run | edit_posts (comprobación propia de la ruta REST) | posts arraypost_type stringlangs array (obligatorio)engine string |
tranzly/estimate-bulkEstima la traducción de todo el sitio a un idioma (post_types, scope, engine) antes de iniciarla. | Pro | POST /wp-json/wp-abilities/v1/abilities/tranzly/estimate-bulk/run | edit_posts (comprobación propia de la ruta REST) | post_types arrayscope string: missing, stale, allengine stringlang string (obligatorio)after integer |
tranzly/export-translation-fileDevuelve un archivo XLIFF o CSV (como texto) con los originales y sus traducciones en un idioma, para un traductor o una agencia de traducción: las entradas indicadas o una página de hasta 100 originales de un tipo de contenido en un estado determinado (missing, stale, translated o all; repite usando after). El mismo archivo se puede volver a importar una vez traducido. | Pro | GET /wp-json/wp-abilities/v1/abilities/tranzly/export-translation-file/run | edit_posts; cada entrada se incluye solo si el usuario puede editarla | lang string (obligatorio)format string: xliff, csvposts arraypost_type stringstate string: all, missing, stale, translatedafter integer |
tranzly/fix-statusPone en cola la traducción de cada elemento que falte (o esté desactualizado) en un idioma y tipo de contenido. | Gratis | POST /wp-json/wp-abilities/v1/abilities/tranzly/fix-status/run | edit_posts (comprobación propia de la ruta REST) | post_type stringlang string (obligatorio)state string (obligatorio): missing, stale, quality |
tranzly/get-comments-settingDevuelve si los comentarios se comparten entre idiomas o si se mantienen por idioma. | Pro | GET /wp-json/wp-abilities/v1/abilities/tranzly/get-comments-setting/run | moderate_comments (comprobación propia de la ruta REST) | ninguno |
tranzly/get-deepl-usageDevuelve los caracteres usados y el límite de la clave de DeepL guardada para este mes. | Gratis | GET /wp-json/wp-abilities/v1/abilities/tranzly/get-deepl-usage/run | manage_options (comprobación propia de la ruta REST) | ninguno |
tranzly/get-diagnosticsDevuelve los diagnósticos que incluiría un tícket de soporte: versiones, plugins activos, límites y errores recientes. | Gratis | GET /wp-json/wp-abilities/v1/abilities/tranzly/get-diagnostics/run | manage_options (comprobación propia de la ruta REST) | ninguno |
tranzly/get-displayDevuelve las opciones de visualización del conmutador de idioma y de los créditos. | Gratis | GET /wp-json/wp-abilities/v1/abilities/tranzly/get-display/run | manage_options (comprobación propia de la ruta REST) | ninguno |
tranzly/get-engine-settingsDevuelve el motor por defecto y el de respaldo, los motores y modelos de IA por idioma, el estado de cada motor, los proveedores de IA conectados con sus modelos y el gasto de este mes. | Gratis | GET /wp-json/wp-abilities/v1/abilities/tranzly/get-engine-settings/run | manage_options (comprobación propia de la ruta REST) | ninguno |
tranzly/get-glossaryDevuelve las palabras que nunca se traducen, las traducciones de términos fijos y el tono por idioma. | Pro | GET /wp-json/wp-abilities/v1/abilities/tranzly/get-glossary/run | manage_options | ninguno |
tranzly/get-integrationsLista los plugins de SEO, WooCommerce, maquetadores visuales y formularios compatibles con Tranzly y cuáles están activos aquí. | Gratis | GET /wp-json/wp-abilities/v1/abilities/tranzly/get-integrations/run | manage_options (comprobación propia de la ruta REST) | ninguno |
tranzly/get-jobDevuelve el progreso y los recuentos de una tarea. | Gratis | GET /wp-json/wp-abilities/v1/abilities/tranzly/get-job/run | manage_options (comprobación propia de la ruta REST) | id string (obligatorio) |
tranzly/get-job-failuresLista los elementos fallidos de una tarea con el motivo de cada uno. | Gratis | GET /wp-json/wp-abilities/v1/abilities/tranzly/get-job-failures/run | manage_options (comprobación propia de la ruta REST) | id string (obligatorio) |
tranzly/get-legacy-importDevuelve el estado y el informe de importación de traducciones desde Tranzly 2.x. | Gratis | GET /wp-json/wp-abilities/v1/abilities/tranzly/get-legacy-import/run | manage_options (comprobación propia de la ruta REST) | ninguno |
tranzly/get-licenceDevuelve el plan de Tranzly de este sitio, el estado de la licencia, la fecha de renovación y lo que incluye el plan. | Gratis | GET /wp-json/wp-abilities/v1/abilities/tranzly/get-licence/run | manage_options (comprobación propia de la ruta REST) | ninguno |
tranzly/get-menusDevuelve qué menú muestra cada idioma en cada ubicación de menú. | Gratis | GET /wp-json/wp-abilities/v1/abilities/tranzly/get-menus/run | edit_theme_options (comprobación propia de la ruta REST) | ninguno |
tranzly/get-post-groupLista el grupo de traducción de una entrada: el elemento de cada idioma con su título, estado y enlace de edición. | Gratis | GET /wp-json/wp-abilities/v1/abilities/tranzly/get-post-group/run | edit_post and edit_term (comprobación propia de la ruta REST) | id string (obligatorio) |
tranzly/get-quality-reportDevuelve el informe de calidad por IA de una traducción: puntuación y segmentos marcados. | Pro | GET /wp-json/wp-abilities/v1/abilities/tranzly/get-quality-report/run | edit_post (comprobación propia de la ruta REST) | id string (obligatorio) |
tranzly/get-segmentsDevuelve los segmentos de una traducción junto a los del original, para su revisión y corrección. | Gratis | GET /wp-json/wp-abilities/v1/abilities/tranzly/get-segments/run | edit_post (comprobación propia de la ruta REST) | id string (obligatorio) |
tranzly/get-shared-stringsDevuelve los textos de temas y plugins (ámbito) en un idioma con sus traducciones. | Gratis | GET /wp-json/wp-abilities/v1/abilities/tranzly/get-shared-strings/run | edit_theme_options (comprobación propia de la ruta REST) | lang string (obligatorio)scope string: menus, site, templates, gettext.plugin-<slug>, gettext.theme-<slug> |
tranzly/get-site-stringsDevuelve el título del sitio, la descripción corta y los textos de los widgets en un idioma. | Gratis | GET /wp-json/wp-abilities/v1/abilities/tranzly/get-site-strings/run | manage_options (comprobación propia de la ruta REST) | lang string (obligatorio) |
tranzly/get-support-connectionIndica si este sitio está conectado con el soporte de Zinn Digital® y como quién. | Free | GET /wp-json/wp-abilities/v1/abilities/tranzly/get-support-connection/run | manage_options (comprobación propia de la ruta REST) | refresh boolean |
tranzly/get-term-groupLista el grupo de traducción de una categoría o etiqueta. | Free | GET /wp-json/wp-abilities/v1/abilities/tranzly/get-term-group/run | edit_post y edit_term (comprobación propia de la ruta REST) | id string (obligatorio) |
tranzly/get-urlsDevuelve cómo aparecen los idiomas en las direcciones (carpeta, subdominio o dominio), los slugs y bases traducidos, y el noindex para las páginas sin traducir. | Free | GET /wp-json/wp-abilities/v1/abilities/tranzly/get-urls/run | manage_options (comprobación propia de la ruta REST) | ninguno |
tranzly/get-workflow-settingsDevuelve la traducción automática al publicar y al actualizar, la revisión antes de publicar, y el umbral, proveedor y modelo del control de calidad por IA. | Pro | GET /wp-json/wp-abilities/v1/abilities/tranzly/get-workflow-settings/run | manage_options (comprobación propia de la ruta REST) | ninguno |
tranzly/import-from-sourceImporta la siguiente página de traducciones desde otro plugin multilingüe (modo: simulación o ejecución; cursor). | Pro | POST /wp-json/wp-abilities/v1/abilities/tranzly/import-from-source/run | manage_options (comprobación propia de la ruta REST) | source string (obligatorio)mode string: dry-run, run, undocursor string |
tranzly/import-translation-fileEscribe la siguiente página de entradas desde un archivo de traducción subido (repite con after hasta terminar). | Pro | POST /wp-json/wp-abilities/v1/abilities/tranzly/import-translation-file/run | edit_posts (comprobación propia de la ruta REST) | token string (obligatorio)after integer |
tranzly/link-postConvierte una entrada existente (objetivo) en la traducción de esta entrada a un idioma. | Free | POST /wp-json/wp-abilities/v1/abilities/tranzly/link-post/run | edit_post y edit_term (comprobación propia de la ruta REST) | id string (obligatorio)lang string (obligatorio)target integer (obligatorio) |
tranzly/link-termConvierte un término existente (objetivo) en la traducción de este término a un idioma. | Free | POST /wp-json/wp-abilities/v1/abilities/tranzly/link-term/run | edit_post y edit_term (comprobación propia de la ruta REST) | id string (obligatorio)lang string (obligatorio)target integer (obligatorio) |
tranzly/list-enginesLista los motores de traducción, si cada uno está configurado y cuál se usa si no se indica ninguno. | Free | GET /wp-json/wp-abilities/v1/abilities/tranzly/list-engines/run | edit_posts | ninguno |
tranzly/list-import-sourcesLista los datos de WPML, Polylang y TranslatePress encontrados en este sitio que se pueden importar. | Pro | GET /wp-json/wp-abilities/v1/abilities/tranzly/list-import-sources/run | manage_options (comprobación propia de la ruta REST) | ninguno |
tranzly/list-jobsLista las tareas de traducción en segundo plano, las más recientes primero, con su progreso. | Free | GET /wp-json/wp-abilities/v1/abilities/tranzly/list-jobs/run | edit_posts (comprobación propia de la ruta REST) | ninguno |
tranzly/list-languagesLista los idiomas del sitio. El primero es el idioma en el que está escrito el contenido original. | Free | GET /wp-json/wp-abilities/v1/abilities/tranzly/list-languages/run | edit_posts | ninguno |
tranzly/list-status-itemsLista los originales con su estado de traducción en un idioma (estado: pendiente, desactualizada, actual), página por página. | Free | GET /wp-json/wp-abilities/v1/abilities/tranzly/list-status-items/run | edit_posts (comprobación propia de la ruta REST) | post_type stringlang string (obligatorio)state string: all, missing, stale, translated, human, machine, review, qualityafter integer |
tranzly/list-theme-stringsLista los temas y plugins cuyos textos se pueden escanear para traducir, y cuántas cadenas tiene cada uno. | Pro | GET /wp-json/wp-abilities/v1/abilities/tranzly/list-theme-strings/run | manage_options (comprobación propia de la ruta REST) | ninguno |
tranzly/open-support-ticketEnvía un ticket de soporte (asunto, mensaje, tipo, correo electrónico), con el diagnóstico de este sitio si el administrador lo aceptó. Nunca crea ni envía credenciales de acceso. | Free | POST /wp-json/wp-abilities/v1/abilities/tranzly/open-support-ticket/run | manage_options (comprobación propia de la ruta REST) | subject string (obligatorio)message string (obligatorio)kind string: help, bug, feedback, feature_requestemail stringname stringdiagnostics boolean |
tranzly/record-support-consentRegistra el consentimiento del administrador para enviar diagnósticos con los tickets de soporte. | Free | POST /wp-json/wp-abilities/v1/abilities/tranzly/record-support-consent/run | manage_options (comprobación propia de la ruta REST) | consent boolean (obligatorio) |
tranzly/retry-job-itemVuelve a intentar un elemento fallido (acción: retry, opcionalmente con otro motor) o lo marca para traducir manualmente (acción: by-hand). | Free | POST /wp-json/wp-abilities/v1/abilities/tranzly/retry-job-item/run | edit_post y manage_options (la propia comprobación de la ruta REST) | item cadena (obligatorio)action cadena (obligatorio)engine cadena |
tranzly/review-translationAprueba una traducción (y la publica cuando se publica el original) o la devuelve (decision, note). | Pro | POST /wp-json/wp-abilities/v1/abilities/tranzly/review-translation/run | edit_post (la propia comprobación de la ruta REST) | id cadena (obligatorio)decision cadena (obligatorio): approve, changes, pendingnote cadena |
tranzly/run-legacy-importEjecuta la importación 2.x: simulacro (solo informe), ejecutar o deshacer. | Free | POST /wp-json/wp-abilities/v1/abilities/tranzly/run-legacy-import/run | manage_options (la propia comprobación de la ruta REST) | action cadena (obligatorio) |
tranzly/scan-theme-stringsEscanea la siguiente página de archivos PHP de un componente en busca de textos traducibles (repite con after hasta terminar). | Pro | POST /wp-json/wp-abilities/v1/abilities/tranzly/scan-theme-strings/run | manage_options (la propia comprobación de la ruta REST) | component cadena (obligatorio)after entero |
tranzly/schedule-quality-checkPrograma la comprobación de calidad por IA de la siguiente página de traducciones de un idioma (o de las entradas indicadas). | Pro | POST /wp-json/wp-abilities/v1/abilities/tranzly/schedule-quality-check/run | edit_posts (la propia comprobación de la ruta REST) | lang cadena (obligatorio)post_type cadenaposts arrayafter entero |
tranzly/seo-auditComprueba si faltan títulos SEO, descripciones, slugs y hreflang en las traducciones de un idioma, página por página. | Pro | GET /wp-json/wp-abilities/v1/abilities/tranzly/seo-audit/run | manage_options (la propia comprobación de la ruta REST) | lang cadena (obligatorio)after entero |
tranzly/set-comments-settingComparte los comentarios entre las traducciones de una entrada o los mantiene por idioma (mode). | Pro | POST /wp-json/wp-abilities/v1/abilities/tranzly/set-comments-setting/run | manage_options y moderate_comments (la propia comprobación de la ruta REST) | mode cadena (obligatorio): off, show, translate |
tranzly/set-engine-keyGuarda la clave de API (y la región para Microsoft) de DeepL, Google o Microsoft; si está vacía, la elimina. Las claves se guardan cifradas y nunca se devuelven. | Free | POST /wp-json/wp-abilities/v1/abilities/tranzly/set-engine-key/run | manage_options (la propia comprobación de la ruta REST) | engine cadena (obligatorio)key cadena (obligatorio)region cadena |
tranzly/set-menusAsigna un menú por idioma y por ubicación (map). | Free | POST /wp-json/wp-abilities/v1/abilities/tranzly/set-menus/run | edit_theme_options (la propia comprobación de la ruta REST) | map objeto (obligatorio) |
tranzly/set-protectionProtege una traducción para que el motor no la sobrescriba (protected: true) o la desbloquea. | Free | POST /wp-json/wp-abilities/v1/abilities/tranzly/set-protection/run | edit_post (la propia comprobación de la ruta REST) | id cadena (obligatorio)protected booleano (obligatorio) |
tranzly/set-shared-stringsGuarda traducciones corregidas de textos de temas y plugins (strings); pasan a estar protegidas. | Free | POST /wp-json/wp-abilities/v1/abilities/tranzly/set-shared-strings/run | edit_theme_options (la propia comprobación de la ruta REST) | lang cadena (obligatorio)scope cadena: menus, site, templates, gettext.plugin-<slug>, gettext.theme-<slug>strings objeto (obligatorio) |
tranzly/set-site-stringGuarda un texto del sitio (key) en un idioma, p. ej. el título del sitio o la descripción corta. | Free | POST /wp-json/wp-abilities/v1/abilities/tranzly/set-site-string/run | edit_theme_options y manage_options (la propia comprobación de la ruta REST) | lang cadena (obligatorio)key cadena (obligatorio)translation cadena (obligatorio) |
tranzly/set-urlsEstablece el modo de dirección (mode), los dominios por idioma, las bases y segmentos traducidos, noindex_untranslated y las sugerencias de slugs. | Free | POST /wp-json/wp-abilities/v1/abilities/tranzly/set-urls/run | manage_options (la propia comprobación de la ruta REST) | mode cadenasegments objetodomains objetobases objetosuggest booleanonoindex_untranslated booleano |
tranzly/start-trialInicia la prueba de 14 días de Tranzly Pro para este sitio (no requiere pago). | Free | POST /wp-json/wp-abilities/v1/abilities/tranzly/start-trial/run | manage_options (la propia comprobación de la ruta REST) | ninguno |
tranzly/translate-media-fieldGuarda el texto alternativo, título o leyenda de una imagen (field) en un idioma (lang). | Gratis | POST /wp-json/wp-abilities/v1/abilities/tranzly/translate-media-field/run | edit_post (comprobación propia de la ruta REST) | id string (obligatorio)lang string (obligatorio)field string (obligatorio): alt, caption, titletranslation string (obligatorio) |
tranzly/translate-postTraduce una entrada o página a uno o más de los idiomas del sitio con un motor de traducción, creando o actualizando cada traducción. Las nuevas traducciones son borradores salvo que publish sea true. Si una persona ha editado una traducción, se omite a menos que force sea true. | Gratis | POST /wp-json/wp-abilities/v1/abilities/tranzly/translate-post/run | puede traducir esa entrada (edit_post en ella); edit_post en una traducción existente; la capacidad de publicación del tipo de contenido para publicar | id integer (obligatorio)languages array (obligatorio)engine stringpublish booleanforce boolean |
tranzly/translate-shared-stringsTraduce la siguiente página de cadenas no traducidas de temas y plugins a un idioma con el motor por defecto (repite con after hasta terminar). | Gratis | POST /wp-json/wp-abilities/v1/abilities/tranzly/translate-shared-strings/run | edit_theme_options (comprobación propia de la ruta REST) | lang string (obligatorio)scope string: menus, site, templates, gettext.plugin-<slug>, gettext.theme-<slug>after integer |
tranzly/translate-siteUn flujo de trabajo guiado: el agente comprueba los idiomas y el motor, calcula el coste y traduce lo que falta, pidiendo confirmación antes de gastar o publicar. | Gratis | POST /wp-json/wp-abilities/v1/abilities/tranzly/translate-site/run | edit_posts | languages string (obligatorio) |
tranzly/translate-termTraduce un término (categoría, etiqueta o atributo de producto) a un idioma (lang) con un motor, creando o actualizando su traducción. | Gratis | POST /wp-json/wp-abilities/v1/abilities/tranzly/translate-term/run | comprobación propia de permisos por elemento de la ruta REST | id string (obligatorio)lang string (obligatorio)engine stringforce booleanstatus string: publish, draft |
tranzly/translation-statusCon un ID de entrada: la traducción de esa entrada en cada idioma, si está desactualizada y quién la escribió. Sin él: cuánto del sitio está traducido, por idioma. | Gratis | GET /wp-json/wp-abilities/v1/abilities/tranzly/translation-status/run | edit_post en esa entrada; edit_posts para el resumen del sitio | id integerpost_type string |
tranzly/unlink-postSaca una entrada de su grupo de traducción; conserva su idioma. | Gratis | POST /wp-json/wp-abilities/v1/abilities/tranzly/unlink-post/run | edit_post y edit_term (comprobación propia de la ruta REST) | id string (obligatorio) |
tranzly/unlink-termSaca un término de su grupo de traducción. | Gratis | POST /wp-json/wp-abilities/v1/abilities/tranzly/unlink-term/run | edit_post y edit_term (comprobación propia de la ruta REST) | id string (obligatorio) |
tranzly/update-displayCambia el conmutador (estilo, banderas, nombres, ubicación) y la línea de créditos. | Gratis | POST /wp-json/wp-abilities/v1/abilities/tranzly/update-display/run | manage_options (comprobación propia de la ruta REST) | switcher objectcredit boolean |
tranzly/update-engine-settingsEstablece el motor por defecto, un motor de reserva, motores por idioma y modelos de IA por idioma (default, fallback, per_lang, models, caps). Todo excepto el motor por defecto requiere Pro. | Gratis | POST /wp-json/wp-abilities/v1/abilities/tranzly/update-engine-settings/run | manage_options (comprobación propia de la ruta REST) | default stringper_lang objectfallback arraycaps objectmodels object |
tranzly/update-glossarySustituye las partes del glosario que envíes (palabras que nunca se traducen, traducciones de términos, tono); las partes que omitas se conservan. Lo utiliza cada motor a partir de la siguiente traducción. | Pro | POST /wp-json/wp-abilities/v1/abilities/tranzly/update-glossary/run | manage_options | dnt arrayterms objecttone object |
tranzly/update-settingsConfigura los idiomas del sitio (languages: lista de código y nombre; el primero es el idioma original), el prefijo de clase para el front-end y si se permiten agentes de IA (MCP). | Gratis | POST /wp-json/wp-abilities/v1/abilities/tranzly/update-settings/run | manage_options (comprobación propia de la ruta REST) | prefix stringmcp booleanlanguages array |
tranzly/update-workflow-settingsEstablece on_update (off, stale, translate), on_publish, review, quality_threshold, quality_provider y quality_model. | Pro | POST /wp-json/wp-abilities/v1/abilities/tranzly/update-workflow-settings/run | manage_options (comprobación propia de la ruta REST) | on_update cadena: off, stale, translateon_publish booleanoreview booleanoquality_threshold enteroquality_provider cadenaquality_model cadena |
tranzly/upload-translation-fileSube un archivo Tranzly XLIFF o CSV (contenido, nombre de archivo) traducido en otro lugar; devuelve un token que identifica la subida para la importación. | Pro | POST /wp-json/wp-abilities/v1/abilities/tranzly/upload-translation-file/run | edit_posts (comprobación propia de la ruta REST) | content cadena (obligatorio)filename cadena (obligatorio) |
Generado a partir del abilities.json del plugin, que a su vez se genera a partir de un sitio en ejecución; una prueba falla cuando los dos no coinciden.
Comandos de WP-CLI
Ejecuta estos en el servidor con WP-CLI. Cada comando comprueba los mismos permisos que las pantallas del plugin; los ejemplos están tomados del propio texto de ayuda del plugin.
| Comando | Qué hace | Edición |
|---|---|---|
wp tranzly create <id> [--term]wp tranzly create 42 --lang=de_DE --user=admin | Crea un borrador de traducción de una entrada (o término), enlazado a ella. | Gratis |
wp tranzly engines | Muestra los motores de traducción. | Gratis |
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 | Tareas de traducción en segundo plano. | Gratis |
wp tranzly legacy <action> [--format=<format>]wp tranzly legacy dry-runwp tranzly legacy runwp tranzly legacy undo | Muestra, realiza un simulacro, ejecuta o deshace la importación de las traducciones de un sitio con versión anterior de Tranzly (2.x). | Gratis |
wp tranzly link <source> <target> [--term] | Enlaza una entrada existente (o término) como la traducción de otra. | Gratis |
wp tranzly network <action> [--languages=<codes>]wp tranzly network setupwp tranzly network languages --languages=en_US,de_DE,fr_FR | Multisitio (Agency): configura cada sitio de la red o define los idiomas con los que comienzan los sitios nuevos. | Gratis |
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 | Traduce entradas con un motor. | Gratis |
wp tranzly translations <id> [--term] [--format=<format>] | Muestra las traducciones de una entrada (o término). | Gratis |
Funciones PHP
Funciones que los temas y otros plugins pueden llamar. Comprueba function_exists() primero, para que tu código siga funcionando mientras el plugin esté inactivo.
| Función | Qué hace | Edición |
|---|---|---|
icl_object_id( $id, $type = 'post', $return_original_if_missing = false, $lang = null ) | WPML: traducción de un objeto. | Pro |
pll__( $text ) | Polylang: una cadena registrada, traducida. Tranzly traduce las cadenas del tema a través del propio gettext de WordPress, por lo que la cadena se devuelve tal como se proporciona. | Pro |
pll_current_language( $field = 'slug' ) | Polylang: el idioma actual. | Pro |
pll_default_language( $field = 'slug' ) | Polylang: el idioma por defecto. | Pro |
pll_e( $text ) | Polylang: muestra (echo) una cadena registrada, escapada. | Pro |
pll_get_post( $post_id, $lang = null ) | Polylang: traducción de una entrada. | Pro |
pll_get_post_language( $post_id, $field = 'slug' ) | Polylang: el idioma de una entrada. | Pro |
pll_get_post_translations( $post_id ) | Polylang: todas las traducciones de una entrada, slug => ID. | Pro |
pll_get_term( $term_id, $lang = null ) | Polylang: traducción de un término. | Pro |
pll_get_term_language( $term_id, $field = 'slug' ) | Polylang: el idioma de un término. | Pro |
pll_get_term_translations( $term_id ) | Polylang: todas las traducciones de un término, slug => ID. | Pro |
pll_home_url( $lang = '' ) | Polylang: la URL de inicio en un idioma. | Pro |
pll_is_translated_post_type( $post_type ) | Polylang: ¿está traducido este tipo de contenido? | Pro |
pll_is_translated_taxonomy( $taxonomy ) | Polylang: ¿está traducida esta taxonomía? | Pro |
pll_languages_list( $args = array( ) | Polylang: los idiomas. | Pro |
pll_register_string() | Polylang: registra una cadena (aceptada e ignorada — consulta pll__()). | Pro |
pll_the_languages( $args = array( ) | Polylang: el conmutador de idiomas. `raw` devuelve el array de Polylang (slug => detalles); de lo contrario, una lista `<li>` con el marcado de Polylang, mostrada mediante echo salvo que `echo` sea 0. Respeta `hide_current`, `hide_if_no_translation` y `display_names_as` (`name` o `slug`). Un valor `dropdown` se muestra como la lista: el propio bloque/widget de conmutador de Tranzly es el lugar adecuado para un desplegable. | Pro |
pll_translate_string( $text ) | Polylang: una cadena registrada en un idioma. Al igual que pll__(), la cadena se devuelve tal como se proporciona. | Pro |
tranzly_compat_field( string $code, string $field ) | Un campo de un idioma, en el vocabulario de Polylang. | Pro |
tranzly_current_language(): string | El idioma de la petición actual (un código de idioma de WordPress como `fr_FR`). | Free |
tranzly_default_language(): string | El idioma por defecto: el primero de la lista. | Free |
tranzly_get_engines(): array | Los motores disponibles: id => name. | Free |
tranzly_get_post_language( int $post_id ): string | El idioma en el que está escrita una entrada. | Free |
tranzly_get_term_language( int $term_id ): string | El idioma en el que está escrito un término. | Free |
tranzly_get_term_translation( int $term_id, string $lang ): ?int | La traducción de un término a un idioma, o null. | Free |
tranzly_get_term_translations( int $term_id ): array | Todas las versiones de un término: código de idioma => ID de término. | Free |
tranzly_get_translation( int $post_id, string $lang ): ?int | El ID de la traducción de una entrada a un idioma, o null cuando no existe. Devuelve el propio ID de la entrada cuando ya está escrita en ese idioma. | Free |
tranzly_get_translations( int $post_id ): array | Todas las versiones de una entrada, incluida la propia entrada: código de idioma => ID de entrada. Una entrada sin traducciones solo se devuelve a sí misma en su idioma. | Free |
tranzly_language_switcher( array $args = array( ) | El HTML de un conmutador de idiomas, para cualquier tema, maquetador o plugin (T5). El elemento de Page Builder Sandwich lo llama; el tuyo también puede hacerlo. Vacío cuando hay menos de dos idiomas. | Free |
tranzly_language_url( string $lang, ?string $url = null ): string | Una URL que muestra el idioma indicado. | Free |
tranzly_languages(): array | Los idiomas del sitio, el predeterminado primero. | Free |
tranzly_register_engine( Engine $engine ) | Añade un motor de traducción. Llámalo en `tranzly_register_engines`, o en cualquier momento antes de la primera traducción de la petición. | Free |
tranzly_restore_language(): bool | Deshace el último tranzly_switch_language(). | Free |
tranzly_switch_language( string $lang ): bool | Hace que el código se ejecute en otro idioma hasta tranzly_restore_language(): cambian tanto el idioma actual como las propias traducciones de WordPress. Se anida como switch_to_blog(): | Free |
tranzly_translatable_attributes( string $block_name ): array | Los nombres de atributos que Tranzly traduce para un tipo de bloque: `role: content` en su block.json, adaptados por el filtro `tranzly_translatable_attributes`. | Free |
tranzly_translate_post( int $post_id, string $lang, string $engine = '', array $args = array( ) | Traduce una entrada a un idioma con un motor, como el usuario actual (se aplican sus permisos). | Gratis |
Acciones y filtros
Cada hook que ofrece el plugin, con la descripción de su código fuente. Los filtros cambian un valor; las acciones te permiten ejecutar código en un momento determinado; los puntos de entrada son acciones que disparas para pedirle al plugin que haga algo.
| Gancho | Tipo | Qué hace | Parámetros | Edición |
|---|---|---|---|---|
tranzly_admin_bar | Acción | Se ejecuta después de crear el menú de Translations en la barra de administración (el editor visual de la versión Pro añade aquí su elemento «Traducir en esta página»). | \WP_Admin_Bar $barint $id | Free |
tranzly_admin_data | Filtro | Filtra los datos con los que arranca la aplicación de administración. La capa de pago lo usa para indicar su edición; no incluyas nada confidencial aquí, ya que se muestra en la página. | ninguno | Free |
tranzly_ai_model | Filtro | Filtra el proveedor de IA y el modelo que traducen a un idioma. Free: el proveedor y el modelo elegidos para la tarea `translate`, para todos los idiomas. Tranzly Pro: la elección específica del idioma o, si no la hay, la de «todos los demás idiomas». | string $target | Free |
tranzly_ai_providers_in_use | Filtro | Filtra los proveedores de IA elegidos para idiomas concretos. Ninguno en el plugin gratuito: cada idioma usa el proveedor y modelo elegidos para la tarea `translate`. Tranzly Pro lista los proveedores de sus modelos por idioma. | ninguno | Free |
tranzly_content_before_rebuild | Filtro | Filtra el contenido original justo antes de insertar los fragmentos traducidos, por idioma (lo utiliza el reemplazo de imágenes por idioma de la versión Pro). | string $contentstring $lang | Free |
tranzly_copy_meta_keys | Filtro | Filtra las claves de metadatos que se copian de una entrada a su nueva traducción. No se copia nada más. | int $source_id | Free |
tranzly_deepl_host | Filtro | Filtra el host de la API de DeepL (un proxy o un doble de prueba). | string $hoststring $key | Free |
tranzly_deepl_price_per_million | Filtro | Filtra el precio de DeepL por millón de caracteres en dólares estadounidenses. | float $price | Free |
tranzly_default_engine | Filtro | Filtra el id del motor utilizado cuando no se especifica ninguno. | string $id | Free |
tranzly_engine_cap | Filtro | Filtra el límite mensual de un motor en dólares estadounidenses: ninguno en el plugin gratuito. | float|null $capstring $engine | Free |
tranzly_engine_chain | Filtro | Filtra los motores a probar para un idioma, en orden. Free: el motor por defecto. La capa de pago añade el motor propio del idioma y la lista de reserva. | string $langstring $first | Free |
tranzly_engine_options | Filtro | Filtra las opciones enviadas al motor (lista de no traducir, glosario, formalidad, instrucciones). | string $targetEngine $engine | Free |
tranzly_engine_settings_save | Filtro | Guarda los motores y modelos de IA por idioma, la lista de reserva y los límites mensuales. Solo responde la capa de pago (directriz 5 de WordPress.org: sin comportamiento Pro en el plugin gratuito). | ninguno | Free |
tranzly_frontend_prefix | Filtro | Filtra el prefijo neutro de clase de la parte pública. | string $prefix | Free |
tranzly_fs_loaded | Acción | Se ejecuta en cuanto se carga el SDK de licencias (en el archivo principal, antes de cualquier código de Tranzly). Engánchate aquí para interactuar con `tranzly_fs()`. | ninguno | Free |
tranzly_glossary_options | Filtro | Filtra las opciones del motor para un idioma de destino: la lista de no traducir, más el glosario y el tono cuando los añade la capa de pago. | string $lang | Free |
tranzly_glossary_save | Filtro | Guarda las traducciones preferidas y el tono por idioma. Solo responde la capa de pago (directriz 5 de WordPress.org: sin comportamiento Pro en el plugin gratuito). | ninguno | Free |
tranzly_google_price_per_million | Filtro | Filtra el precio de Google Cloud Translation por millón de caracteres, en dólares estadounidenses. | float $price | Pro |
tranzly_install_language_packs | Filtro | Indica si Tranzly instala los paquetes de idioma de WordPress, temas y plugins de un idioma añadido al sitio (para que los textos propios de WordPress y WooCommerce aparezcan traducidos). Activado por defecto. | bool $install | Free |
tranzly_integration_available | Filtro | Filtra si se ejecuta una integración cuando no se detecta su plugin (útil para contenido dejado por un maquetador tras desactivarlo o para un plugin cargado de forma inusual). | bool $onstring $id | Free |
tranzly_integrations | Filtro | Filtra las integraciones que ejecuta Tranzly. Añade una subclase de `Integration` para dar soporte a otro plugin. | ninguno | Free |
tranzly_is_pro | Filtro | Filtra si la capa de pago está en ejecución. Solo responde la capa de pago. | bool $pro | Free |
tranzly_job_created | Acción | Se ejecuta tras crear una tarea de traducción. | int $jobint $items | Free |
tranzly_job_finished | Acción | Se ejecuta cuando una tarea de traducción no tiene trabajo pendiente. | int $job_id | Gratis |
tranzly_kit_api_base | Filtro | Filtra la URL base de la API de Zinn Digital® a la que llaman las pantallas de soporte. | string $base | Gratis |
tranzly_kit_diagnostics | Filtro | Filtra los diagnósticos antes de que los vea el propietario del sitio. Un plugin añade sus propios datos en `extra`. ⛔ Esto se ejecuta ANTES de la vista previa, nunca entre la vista previa y el envío. | ninguno | Gratis |
tranzly_kit_footprint_free | Filtro | Filtra si este sitio está libre de huellas, para que nunca se promocione Zinn® Ads en él. | bool $footprint_free | Gratis |
tranzly_kit_promotions | Filtro | Filtra el registro de promociones antes de resolverse. Añade una fila para promocionar otro producto: `id`, `kind` (hosting|marketplace|platform|plugin|bundle|ads), `slot` (promo|cross-sell), y `url` o (para un plugin) `name`, `site`, `main_files`. | ninguno | Gratis |
tranzly_kit_tier | Filtro | Filtra el nivel de plan que el kit reporta para este plugin (pruebas y desarrollo; la licencia lo decide en producción). | string $tier | Gratis |
tranzly_localize_links | Filtro | Filtra si Tranzly apunta los enlaces internos de esta página a sus traducciones. | bool $localizestring $lang | Gratis |
tranzly_memory_enabled | Filtro | Filtra si se utiliza la memoria de traducción. | bool $on | Pro |
tranzly_microsoft_price_per_million | Filtro | Filtra el precio por millón de caracteres de Microsoft Translator, en dólares estadounidenses. | float $price | Pro |
tranzly_network_enabled | Filtro | Filtra si la capa de red multisitio está activada. | bool $agency | Gratis |
tranzly_pbs_internal_post_types | Filtro | Filtra los tipos de contenido de Page Builder Sandwich que Tranzly no toca. | ninguno | Gratis |
tranzly_post_segments | Filtro | Filtra los fragmentos de una entrada enviados al motor. Clave => `text` + `format` (`text` o `html`). El analizador compatible con bloques y las integraciones añaden, dividen o reemplazan fragmentos aquí, y los vuelven a escribir en `tranzly_translated_post_fields`. | \WP_Post $post | Gratis |
tranzly_post_translated | Acción | Se ejecuta después de que un motor traduzca una entrada (o un archivo manual o una importación escriba una). | int $targetint $source_idstring $codestring $engine | Gratis |
tranzly_post_translation_created | Acción | Se ejecuta después de que Tranzly cree la traducción de una entrada. | int $new_idint $source_idstring $code | Gratis |
tranzly_post_types | Filtro | Filtra los tipos de contenido que traduce Tranzly. | ninguno | Gratis |
tranzly_pre_current_language | Filtro | Fuerza el idioma actual: devuelve un código de idioma para utilizarlo. Así es como funciona tranzly_switch_language(); devuelve null para que Tranzly decida. | string|null $lang | Gratis |
tranzly_query_var | Filtro | Filtra la variable de consulta que selecciona el idioma. | string $var | Gratis |
tranzly_queue_lease_seconds | Filtro | Filtra el tiempo de asignación de un elemento reservado: tras este periodo, un proceso que falló a mitad devuelve el elemento a los demás. Más largo que la traducción individual más lenta. | int $seconds | Gratis |
tranzly_queue_worker_seconds | Filtro | Filtra cuánto tiempo se ejecuta un proceso antes de ceder el turno, en segundos. | int $seconds | Gratis |
tranzly_queue_workers | Filtro | Filtra cuántos procesos ejecuta una tarea a la vez. Un límite para los PROCESOS, para no sobrecargar el servicio de traducción; nunca un límite de cuántos elementos se completan. | int $workersint $job_id | Gratis |
tranzly_rate_source_ | Filtro | Tipos de cambio de otra fuente (consulta `tranzly_rate_sources`). | ninguno | Pro |
tranzly_rate_sources | Filtro | Filtra las fuentes de tipos de cambio. Añade una con un filtro `tranzly_rate_source_<id>` que devuelva `[ code => tasa respecto a su referencia ]`, o un WP_Error. | ninguno | Pro |
tranzly_register_engines | Acción | Registra motores de traducción. Llama a `$registry->add( new Your_Engine() )`. | Registry $registry | Gratis |
tranzly_relations_changed | Acción | Se ejecuta tras cambiar los enlaces de traducción de los objetos: vinculados, desvinculados, movidos a otro idioma o eliminados. Se ejecuta una vez por cada grupo afectado, por lo que un solo enlace puede ejecutarlo dos veces. | string $typearray<int> $ids | Gratis |
tranzly_robots_meta_keys | Filtro | Filtra las claves de metadatos de las entradas que contienen ajustes de robots; cada una sigue a la original en sus traducciones. | ninguno | Gratis |
tranzly_shared_string_scopes | Filtro | Filtra los ámbitos de textos compartidos (carril L06, T6: las integraciones añaden `woocommerce`, `forms` y `theme`; sus textos llegan en `tranzly_shared_strings`). | ninguno | Gratis |
tranzly_shared_strings | Filtro | Filtra los textos compartidos que Tranzly traduce como cadenas, por ámbito. La capa Pro añade plantillas de bloques, partes de plantilla y patrones a `templates`. | string $scope | Gratis |
tranzly_shared_strings_covered | Filtro | Filtra los textos de un ámbito de texto compartido que un paquete de idioma traduce para un idioma. La capa Pro informa sobre los patrones registrados del tema y del núcleo para `templates`. | string $scopestring $lang | Gratis |
tranzly_source_changed | Acción | Se activa cuando cambia el contenido traducible de un original, por lo que sus traducciones quedan desactualizadas. | int $post_idstring $nowstring $before | Gratis |
tranzly_source_meta_keys | Filtro | Filtra las claves de metadatos cuyo cambio hace que las traducciones de una página queden desactualizadas. Las integraciones añaden las claves que traducen (datos de maquetadores, campos de SEO, campos personalizados). | int $post_id | Gratis |
tranzly_source_published | Acción | Se activa una vez cuando un original se publica por primera vez (después de guardar sus metadatos). | int $post_id | Gratis |
tranzly_style_rules_enabled | Filtro | Determina si Tranzly aplica las reglas de estilo del equipo de traducción de WordPress.org de ese idioma (comillas, espaciado alrededor de signos de puntuación, apóstrofos, puntos suspensivos, espaciado en japonés, pronombres de tratamiento) a cada nueva traducción. Activado por defecto. | bool $enabledstring $locale | Gratis |
tranzly_taxonomies | Filtro | Filtra las taxonomías que traduce Tranzly. | ninguno | Gratis |
tranzly_term_segments | Filtro | Filtra los segmentos de un término enviados al motor (`name`, `description`, más lo que añadan las integraciones: títulos SEO, campos personalizados). Escribe los añadidos en `tranzly_term_translated`. | \WP_Term $term | Gratis |
tranzly_term_translated | Acción | Se activa después de que un motor haya traducido un término, con cada segmento traducido (las integraciones escriben los segmentos que añadieron en `tranzly_term_segments`). | int $targetint $term_idstring $code | Gratis |
tranzly_term_translation_created | Acción | Se activa después de que Tranzly cree la traducción de un término. | int $new_idint $term_idstring $code | Gratis |
tranzly_translatable_attributes | Filtro | Filtra los atributos que Tranzly traduce para un tipo de bloque. | string $block_name | Gratis |
tranzly_translate_string | Filtro | Filtra una cadena traducible a un idioma. | string $valuestring $codearray $context | Gratis |
tranzly_translated_post_fields | Filtro | Filtra los campos de la entrada escritos en una traducción, después de que se haya ejecutado el motor. Las integraciones que añadieron sus propios segmentos (campos personalizados, datos de maquetadores) los escriben aquí. | \WP_Post $poststring $code | Gratis |
tranzly_translation_memory | Filtro | Filtra la memoria de traducción en uso: ninguna en el plugin gratuito; la capa premium ofrece una (docs/843, directriz 5 de WordPress.org). | Translation_Memory|null $memory | Gratis |