Sviluppatori

Riferimento delle abilità di Tranzly

Tranzly registra le sue azioni con l’Abilities API di WordPress. Le stesse abilità sono strumenti MCP sul server del sito stesso e percorsi REST sotto /wp-json/wp-abilities/v1. Questa pagina è generata dal registro del plugin stesso.

Guida per l’utente: connettere un’app di IA

Endpoint

Abilità	REST
MCP su HTTP (streamable)	`/wp-json/tranzly/v1/mcp`
MCP su WP-CLI (standard input e output)	`wp mcp-adapter serve --server=tranzly --user=<login>`
REST: elenca le abilità	`/wp-json/wp-abilities/v1/abilities?category=tranzly`
REST: esegui un’abilità	`/wp-json/wp-abilities/v1/abilities/<name>/run (GET con ?input= per abilità di sola lettura, POST {"input": {...}} altrimenti)`

Autenticazione e permessi

Le richieste HTTP si autenticano con una password applicativa di WordPress (HTTP Basic). La connessione al server MCP richiede la funzionalità (capability) indicata di seguito; ogni abilità verifica poi la propria autorizzazione, per ciascun oggetto. Le abilità di sola lettura vengono eseguite con GET e il loro input nella query string; le altre con POST e un corpo JSON ‘{“input”: {…}}’.

una password applicativa di WordPress (HTTP) o --user (WP-CLI); l'utente necessita della funzionalità (capability) specificata da ciascuna abilità · Impostazioni: Consenti agenti IA (MCP), attiva per impostazione predefinita

Tutte le abilità

Abilità	Edizione	REST	Permesso	Parametri
`tranzly/bulk-translate` Avvia processi di traduzione in background per ogni originale dei tipi di contenuto indicati (tutti i tipi tradotti se non ne specifichi nessuno): le traduzioni mancanti, quelle non aggiornate o tutte. Restituisce i processi avviati, uno per lingua.	Pro	POST `/wp-json/wp-abilities/v1/abilities/tranzly/bulk-translate/run`	edit_posts; publish_posts per pubblicare	`languages` (obbligatorio) `post_types` `scope`: missing, stale, all `engine` `publish`
`tranzly/cancel-job` Interrompe un processo; le traduzioni già effettuate vengono mantenute.	Free	POST `/wp-json/wp-abilities/v1/abilities/tranzly/cancel-job/run`	manage_options (controllo interno della route REST)	`id` (obbligatorio)
`tranzly/check-quality` Usa l’IA per confrontare una traduzione con il suo originale e valutarla, quindi memorizza il report sulla traduzione. Utilizza il modello IA di controllo qualità impostato nelle impostazioni del flusso di lavoro di Tranzly.	Pro	POST `/wp-json/wp-abilities/v1/abilities/tranzly/check-quality/run`	edit_post su quella traduzione	`id` (obbligatorio)
`tranzly/connect-support` Connette questo sito all’assistenza di Zinn Digital® (nome, email, consenso).	Free	POST `/wp-json/wp-abilities/v1/abilities/tranzly/connect-support/run`	manage_options (controllo interno della route REST)	`email` (obbligatorio) `name` `consent` (obbligatorio)
`tranzly/correct-segments` Salva i segmenti corretti di una traduzione (segmenti: da chiave a testo); il testo corretto è protetto da nuove traduzioni.	Free	POST `/wp-json/wp-abilities/v1/abilities/tranzly/correct-segments/run`	edit_post (controllo interno della route REST)	`id` (obbligatorio) `segments` `texts`
`tranzly/create-job` Avvia un processo in background che traduce gli articoli elencati (posts) o un intero tipo di articolo nelle lingue indicate (langs).	Free	POST `/wp-json/wp-abilities/v1/abilities/tranzly/create-job/run`	edit_posts (controllo interno della route REST)	`posts` `post_type` `langs` (obbligatorio) `engine` `status`: publish, draft `force`
`tranzly/create-post-translation` Crea una bozza di traduzione di un articolo in una lingua (lang) da scrivere a mano, senza un motore di traduzione.	Free	POST `/wp-json/wp-abilities/v1/abilities/tranzly/create-post-translation/run`	controllo dei permessi per elemento interno della route REST	`id` (obbligatorio) `lang` (obbligatorio) `name` `slug` `description`
`tranzly/create-term-translation` Crea la traduzione di un termine in una lingua con il nome, lo slug e la descrizione che fornisci.	Free	POST `/wp-json/wp-abilities/v1/abilities/tranzly/create-term-translation/run`	controllo dei permessi per elemento interno della route REST	`id` (obbligatorio) `lang` (obbligatorio) `name` `slug` `description`
`tranzly/disconnect-support` Disconnette questo sito dall’assistenza.	Free	POST `/wp-json/wp-abilities/v1/abilities/tranzly/disconnect-support/run`	manage_options (controllo interno della route REST)	nessuno
`tranzly/estimate` Stima i caratteri e il costo per tradurre gli articoli (posts o post_type) nelle lingue indicate (langs) con un motore, prima di spendere qualcosa.	Free	POST `/wp-json/wp-abilities/v1/abilities/tranzly/estimate/run`	edit_posts (controllo interno della route REST)	`posts` `post_type` `langs` (obbligatorio) `engine`
`tranzly/estimate-bulk` Stima la traduzione dell’intero sito in una lingua (post_types, scope, engine) prima di avviarla.	Pro	POST `/wp-json/wp-abilities/v1/abilities/tranzly/estimate-bulk/run`	edit_posts (controllo interno della route REST)	`post_types` `scope`: missing, stale, all `engine` `lang` (obbligatorio) `after`
`tranzly/export-translation-file` Restituisce un file XLIFF o CSV (sotto forma di testo) con gli originali e le rispettive traduzioni in una lingua, per un traduttore o un’agenzia di traduzione: gli articoli specificati o una pagina fino a 100 originali di un tipo di contenuto in un determinato stato (missing, stale, translated o all; ripeti con after). Puoi reimportare lo stesso file una volta tradotto.	Pro	GET `/wp-json/wp-abilities/v1/abilities/tranzly/export-translation-file/run`	edit_posts; ogni articolo viene incluso solo se l’utente ha il permesso di modificarlo	`lang` (obbligatorio) `format`: xliff, csv `posts` `post_type` `state`: all, missing, stale, translated `after`
`tranzly/fix-status` Mette in coda la traduzione di ogni elemento mancante (o non aggiornato) per una lingua e un tipo di contenuto.	Free	POST `/wp-json/wp-abilities/v1/abilities/tranzly/fix-status/run`	edit_posts (controllo interno della route REST)	`post_type` string `lang` string (obbligatorio) `state` string (obbligatorio): missing, stale, quality
`tranzly/get-comments-setting` Restituisce se i commenti sono condivisi tra le lingue o separati per lingua.	Pro	GET `/wp-json/wp-abilities/v1/abilities/tranzly/get-comments-setting/run`	moderate_comments (controllo interno della route REST)	nessuno
`tranzly/get-deepl-usage` Restituisce i caratteri utilizzati e il limite della chiave DeepL salvata per questo mese.	Free	GET `/wp-json/wp-abilities/v1/abilities/tranzly/get-deepl-usage/run`	manage_options (controllo interno della route REST)	nessuno
`tranzly/get-diagnostics` Restituisce i dati di diagnostica inclusi in un ticket di supporto: versioni, plugin attivi, limiti ed errori recenti.	Free	GET `/wp-json/wp-abilities/v1/abilities/tranzly/get-diagnostics/run`	manage_options (controllo interno della route REST)	nessuno
`tranzly/get-display` Restituisce le opzioni di visualizzazione del selettore di lingua e dei crediti.	Free	GET `/wp-json/wp-abilities/v1/abilities/tranzly/get-display/run`	manage_options (controllo interno della route REST)	nessuno
`tranzly/get-engine-settings` Restituisce il motore predefinito e di fallback, i motori e i modelli AI per lingua, lo stato di ciascun motore, i provider AI connessi con i relativi modelli e la spesa di questo mese.	Free	GET `/wp-json/wp-abilities/v1/abilities/tranzly/get-engine-settings/run`	manage_options (controllo interno della route REST)	nessuno
`tranzly/get-glossary` Restituisce i termini non traducibili, le traduzioni fisse dei termini e il tono per ogni lingua.	Pro	GET `/wp-json/wp-abilities/v1/abilities/tranzly/get-glossary/run`	manage_options	nessuno
`tranzly/get-integrations` Elenca i plugin SEO, WooCommerce, page builder e di moduli supportati da Tranzly e attivi su questo sito.	Free	GET `/wp-json/wp-abilities/v1/abilities/tranzly/get-integrations/run`	manage_options (controllo interno della route REST)	nessuno
`tranzly/get-job` Restituisce l’avanzamento e i conteggi di un’attività.	Free	GET `/wp-json/wp-abilities/v1/abilities/tranzly/get-job/run`	manage_options (controllo interno della route REST)	`id` string (obbligatorio)
`tranzly/get-job-failures` Elenca gli elementi non riusciti di un’attività con il relativo motivo.	Free	GET `/wp-json/wp-abilities/v1/abilities/tranzly/get-job-failures/run`	manage_options (controllo interno della route REST)	`id` string (obbligatorio)
`tranzly/get-legacy-import` Restituisce lo stato e il resoconto dell’importazione delle traduzioni da Tranzly 2.x.	Free	GET `/wp-json/wp-abilities/v1/abilities/tranzly/get-legacy-import/run`	manage_options (controllo interno della route REST)	nessuno
`tranzly/get-licence` Restituisce il piano Tranzly di questo sito, lo stato della licenza, la data di rinnovo e le funzionalità incluse nel piano.	Free	GET `/wp-json/wp-abilities/v1/abilities/tranzly/get-licence/run`	manage_options (controllo interno della route REST)	nessuno
`tranzly/get-menus` Restituisce il menu mostrato da ciascuna lingua in ogni posizione di menu.	Free	GET `/wp-json/wp-abilities/v1/abilities/tranzly/get-menus/run`	edit_theme_options (controllo interno della route REST)	nessuno
`tranzly/get-post-group` Elenca il gruppo di traduzione di un articolo: ogni elemento per lingua con titolo, stato e link di modifica.	Free	GET `/wp-json/wp-abilities/v1/abilities/tranzly/get-post-group/run`	edit_post e edit_term (controllo interno della route REST)	`id` string (obbligatorio)
`tranzly/get-quality-report` Restituisce il report di qualità AI di una traduzione: punteggio e segmenti segnalati.	Pro	GET `/wp-json/wp-abilities/v1/abilities/tranzly/get-quality-report/run`	edit_post (controllo interno della route REST)	`id` string (obbligatorio)
`tranzly/get-segments` Restituisce i segmenti di una traduzione affiancati a quelli dell’originale, per la revisione e la correzione.	Free	GET `/wp-json/wp-abilities/v1/abilities/tranzly/get-segments/run`	edit_post (controllo interno della route REST)	`id` string (obbligatorio)
`tranzly/get-shared-strings` Restituisce i testi di temi e plugin (ambito) in una lingua con le relative traduzioni.	Free	GET `/wp-json/wp-abilities/v1/abilities/tranzly/get-shared-strings/run`	edit_theme_options (controllo interno della route REST)	`lang` string (obbligatorio) `scope` string: menus, site, templates, gettext.plugin-<slug>, gettext.theme-<slug>
`tranzly/get-site-strings` Restituisce il titolo del sito, il motto e i testi dei widget in una lingua.	Free	GET `/wp-json/wp-abilities/v1/abilities/tranzly/get-site-strings/run`	manage_options (controllo interno della route REST)	`lang` string (obbligatorio)
`tranzly/get-support-connection` Indica se questo sito è collegato al supporto di Zinn Digital® e con quale identità.	Gratis	GET `/wp-json/wp-abilities/v1/abilities/tranzly/get-support-connection/run`	manage_options (controllo interno della route REST)	`refresh` booleano
`tranzly/get-term-group` Elenca il gruppo di traduzione di una categoria o di un tag.	Gratis	GET `/wp-json/wp-abilities/v1/abilities/tranzly/get-term-group/run`	edit_post ed edit_term (controllo interno della route REST)	`id` stringa (obbligatorio)
`tranzly/get-urls` Restituisce come appaiono le lingue negli indirizzi (cartella, sottodominio o dominio), gli slug e le basi tradotti, e il noindex per le pagine non tradotte.	Gratis	GET `/wp-json/wp-abilities/v1/abilities/tranzly/get-urls/run`	manage_options (controllo interno della route REST)	nessuno
`tranzly/get-workflow-settings` Restituisce la traduzione automatica alla pubblicazione e all’aggiornamento, la revisione prima della pubblicazione e la soglia, il fornitore e il modello del controllo qualità dell’IA.	Pro	GET `/wp-json/wp-abilities/v1/abilities/tranzly/get-workflow-settings/run`	manage_options (controllo interno della route REST)	nessuno
`tranzly/import-from-source` Importa la pagina successiva di traduzioni da un altro plugin multilingue (modalità: dry-run o run; cursore).	Pro	POST `/wp-json/wp-abilities/v1/abilities/tranzly/import-from-source/run`	manage_options (controllo interno della route REST)	`source` stringa (obbligatorio) `mode` stringa: dry-run, run, undo `cursor` stringa
`tranzly/import-translation-file` Scrive la pagina successiva di articoli da un file di traduzione caricato (ripeti con after fino al termine).	Pro	POST `/wp-json/wp-abilities/v1/abilities/tranzly/import-translation-file/run`	edit_posts (controllo interno della route REST)	`token` stringa (obbligatorio) `after` intero
`tranzly/link-post` Imposta un articolo esistente (target) come traduzione di questo articolo in una lingua.	Gratis	POST `/wp-json/wp-abilities/v1/abilities/tranzly/link-post/run`	edit_post ed edit_term (controllo interno della route REST)	`id` stringa (obbligatorio) `lang` stringa (obbligatorio) `target` intero (obbligatorio)
`tranzly/link-term` Imposta un termine esistente (target) come traduzione di questo termine in una lingua.	Gratis	POST `/wp-json/wp-abilities/v1/abilities/tranzly/link-term/run`	edit_post ed edit_term (controllo interno della route REST)	`id` stringa (obbligatorio) `lang` stringa (obbligatorio) `target` intero (obbligatorio)
`tranzly/list-engines` Elenca i motori di traduzione, lo stato di configurazione di ciascuno e quale viene usato se non ne viene indicato nessuno.	Gratis	GET `/wp-json/wp-abilities/v1/abilities/tranzly/list-engines/run`	edit_posts	nessuno
`tranzly/list-import-sources` Elenca i dati di WPML, Polylang e TranslatePress trovati su questo sito che è possibile importare.	Pro	GET `/wp-json/wp-abilities/v1/abilities/tranzly/list-import-sources/run`	manage_options (controllo interno della route REST)	nessuno
`tranzly/list-jobs` Elenca le attività di traduzione in background, a partire dalla più recente, con il relativo avanzamento.	Gratis	GET `/wp-json/wp-abilities/v1/abilities/tranzly/list-jobs/run`	edit_posts (controllo interno della route REST)	nessuno
`tranzly/list-languages` Elenca le lingue del sito. La prima corrisponde alla lingua in cui è scritto il contenuto originale.	Gratis	GET `/wp-json/wp-abilities/v1/abilities/tranzly/list-languages/run`	edit_posts	nessuno
`tranzly/list-status-items` Elenca i contenuti originali con il relativo stato di traduzione in una lingua (stato: missing, stale, current), pagina per pagina.	Gratis	GET `/wp-json/wp-abilities/v1/abilities/tranzly/list-status-items/run`	edit_posts (controllo interno della route REST)	`post_type` stringa `lang` stringa (obbligatorio) `state` stringa: all, missing, stale, translated, human, machine, review, quality `after` intero
`tranzly/list-theme-strings` Elenca i temi e i plugin i cui testi possono essere analizzati per la traduzione e il numero di stringhe di ciascuno.	Pro	GET `/wp-json/wp-abilities/v1/abilities/tranzly/list-theme-strings/run`	manage_options (controllo interno della route REST)	nessuno
`tranzly/open-support-ticket` Invia un ticket di supporto (oggetto, messaggio, tipo, email), con la diagnostica di questo sito se l’amministratore ha acconsentito. Non crea né invia mai dati di accesso.	Gratis	POST `/wp-json/wp-abilities/v1/abilities/tranzly/open-support-ticket/run`	manage_options (controllo interno della route REST)	`subject` stringa (obbligatorio) `message` stringa (obbligatorio) `kind` stringa: help, bug, feedback, feature_request `email` stringa `name` stringa `diagnostics` booleano
`tranzly/record-support-consent` Registra il consenso dell’amministratore all’invio dei dati di diagnostica con i ticket di supporto.	Gratis	POST `/wp-json/wp-abilities/v1/abilities/tranzly/record-support-consent/run`	manage_options (controllo interno della route REST)	`consent` booleano (obbligatorio)
`tranzly/retry-job-item` Riprova un elemento non riuscito (action: retry, facoltativamente con un altro motore) o lo contrassegna per la traduzione manuale (action: by-hand).	Gratis	POST `/wp-json/wp-abilities/v1/abilities/tranzly/retry-job-item/run`	edit_post e manage_options (controllo interno della route REST)	`item` stringa (obbligatorio) `action` stringa (obbligatorio) `engine` stringa
`tranzly/review-translation` Approva una traduzione (e la pubblica quando l’originale è pubblicato) oppure la rimanda indietro (decision, note).	Pro	POST `/wp-json/wp-abilities/v1/abilities/tranzly/review-translation/run`	edit_post (controllo interno della route REST)	`id` stringa (obbligatorio) `decision` stringa (obbligatorio): approve, changes, pending `note` stringa
`tranzly/run-legacy-import` Esegue l’importazione 2.x: dry-run (solo report), run o undo.	Gratis	POST `/wp-json/wp-abilities/v1/abilities/tranzly/run-legacy-import/run`	manage_options (controllo interno della route REST)	`action` stringa (obbligatorio)
`tranzly/scan-theme-strings` Scansiona la pagina successiva dei file PHP di un componente per trovare testi traducibili (ripeti con after fino al termine).	Pro	POST `/wp-json/wp-abilities/v1/abilities/tranzly/scan-theme-strings/run`	manage_options (controllo interno della route REST)	`component` stringa (obbligatorio) `after` intero
`tranzly/schedule-quality-check` Pianifica il controllo di qualità con IA per la pagina successiva delle traduzioni di una lingua (o per gli articoli indicati).	Pro	POST `/wp-json/wp-abilities/v1/abilities/tranzly/schedule-quality-check/run`	edit_posts (controllo interno della route REST)	`lang` stringa (obbligatorio) `post_type` stringa `posts` array `after` intero
`tranzly/seo-audit` Controlla nelle traduzioni l’eventuale assenza di titoli SEO, descrizioni, slug e hreflang in una lingua, pagina per pagina.	Pro	GET `/wp-json/wp-abilities/v1/abilities/tranzly/seo-audit/run`	manage_options (controllo interno della route REST)	`lang` stringa (obbligatorio) `after` intero
`tranzly/set-comments-setting` Condivide i commenti tra le traduzioni di un articolo o li mantiene separati per lingua (mode).	Pro	POST `/wp-json/wp-abilities/v1/abilities/tranzly/set-comments-setting/run`	manage_options e moderate_comments (controllo interno della route REST)	`mode` stringa (obbligatorio): off, show, translate
`tranzly/set-engine-key` Salva la chiave API (e l’area geografica per Microsoft) di DeepL, Google o Microsoft; se vuota, la rimuove. Le chiavi vengono salvate cifrate e mai restituite.	Gratis	POST `/wp-json/wp-abilities/v1/abilities/tranzly/set-engine-key/run`	manage_options (controllo interno della route REST)	`engine` stringa (obbligatorio) `key` stringa (obbligatorio) `region` stringa
`tranzly/set-menus` Assegna un menu per lingua per ogni posizione (map).	Gratis	POST `/wp-json/wp-abilities/v1/abilities/tranzly/set-menus/run`	edit_theme_options (controllo interno della route REST)	`map` oggetto (obbligatorio)
`tranzly/set-protection` Protegge una traduzione dalla sovrascrittura da parte del motore (protected: true) o la sblocca.	Gratis	POST `/wp-json/wp-abilities/v1/abilities/tranzly/set-protection/run`	edit_post (controllo interno della route REST)	`id` stringa (obbligatorio) `protected` booleano (obbligatorio)
`tranzly/set-shared-strings` Salva le traduzioni corrette dei testi di temi e plugin (strings); queste diventano protette.	Gratis	POST `/wp-json/wp-abilities/v1/abilities/tranzly/set-shared-strings/run`	edit_theme_options (controllo interno della route REST)	`lang` stringa (obbligatorio) `scope` stringa: menus, site, templates, gettext.plugin-<slug>, gettext.theme-<slug> `strings` oggetto (obbligatorio)
`tranzly/set-site-string` Salva un singolo testo del sito (key) in una lingua, ad esempio il titolo del sito o il motto.	Gratis	POST `/wp-json/wp-abilities/v1/abilities/tranzly/set-site-string/run`	edit_theme_options e manage_options (controllo interno della route REST)	`lang` stringa (obbligatorio) `key` stringa (obbligatorio) `translation` stringa (obbligatorio)
`tranzly/set-urls` Imposta la modalità degli indirizzi (mode), i domini per lingua, le basi e i segmenti tradotti, noindex_untranslated e i suggerimenti per gli slug.	Gratis	POST `/wp-json/wp-abilities/v1/abilities/tranzly/set-urls/run`	manage_options (controllo interno della route REST)	`mode` stringa `segments` oggetto `domains` oggetto `bases` oggetto `suggest` booleano `noindex_untranslated` booleano
`tranzly/start-trial` Avvia la prova di 14 giorni di Tranzly Pro per questo sito (nessun pagamento richiesto).	Gratis	POST `/wp-json/wp-abilities/v1/abilities/tranzly/start-trial/run`	manage_options (controllo interno della route REST)	nessuno
`tranzly/translate-media-field` Salva il testo alternativo, il titolo o la didascalia di un’immagine (field) in una lingua (lang).	Gratis	POST `/wp-json/wp-abilities/v1/abilities/tranzly/translate-media-field/run`	edit_post (controllo interno della route REST)	`id` string (obbligatorio) `lang` string (obbligatorio) `field` string (obbligatorio): alt, caption, title `translation` string (obbligatorio)
`tranzly/translate-post` Traduce un articolo o una pagina in una o più lingue del sito con un motore di traduzione, creando ciascuna traduzione o aggiornandola. Le nuove traduzioni sono bozze a meno che publish non sia true. Una traduzione modificata manualmente viene saltata a meno che force non sia true.	Gratis	POST `/wp-json/wp-abilities/v1/abilities/tranzly/translate-post/run`	può tradurre quell’articolo (edit_post su di esso); edit_post su una traduzione esistente; la funzionalità publish del tipo di contenuto per pubblicare	`id` integer (obbligatorio) `languages` array (obbligatorio) `engine` string `publish` boolean `force` boolean
`tranzly/translate-shared-strings` Traduce la pagina successiva di testi non tradotti di temi e plugin in una lingua con il motore predefinito (ripeti con after fino al termine).	Gratis	POST `/wp-json/wp-abilities/v1/abilities/tranzly/translate-shared-strings/run`	edit_theme_options (controllo interno della route REST)	`lang` string (obbligatorio) `scope` string: menus, site, templates, gettext.plugin-<slug>, gettext.theme-<slug> `after` integer
`tranzly/translate-site` Un flusso di lavoro guidato: l’agente controlla le lingue e il motore, stima i costi e traduce ciò che manca, chiedendo conferma prima di spendere o pubblicare.	Gratis	POST `/wp-json/wp-abilities/v1/abilities/tranzly/translate-site/run`	edit_posts	`languages` string (obbligatorio)
`tranzly/translate-term` Traduce un termine (categoria, tag o attributo prodotto) in una lingua (lang) con un motore, creando o aggiornando la relativa traduzione.	Gratis	POST `/wp-json/wp-abilities/v1/abilities/tranzly/translate-term/run`	controllo dei permessi per elemento proprio della route REST	`id` string (obbligatorio) `lang` string (obbligatorio) `engine` string `force` boolean `status` string: publish, draft
`tranzly/translation-status` Con l’ID di un articolo: la traduzione in ciascuna lingua di quell’articolo, se non è aggiornata e chi l’ha scritta. Senza ID: la percentuale di traduzione del sito, per lingua.	Gratis	GET `/wp-json/wp-abilities/v1/abilities/tranzly/translation-status/run`	edit_post su quell’articolo; edit_posts per il riepilogo del sito	`id` integer `post_type` string
`tranzly/unlink-post` Rimuove un articolo dal suo gruppo di traduzione; mantiene la sua lingua.	Gratis	POST `/wp-json/wp-abilities/v1/abilities/tranzly/unlink-post/run`	edit_post ed edit_term (controllo interno della route REST)	`id` string (obbligatorio)
`tranzly/unlink-term` Rimuove un termine dal suo gruppo di traduzione.	Gratis	POST `/wp-json/wp-abilities/v1/abilities/tranzly/unlink-term/run`	edit_post ed edit_term (controllo interno della route REST)	`id` string (obbligatorio)
`tranzly/update-display` Modifica il selettore (stile, bandiere, nomi, posizionamento) e la riga dei crediti.	Gratis	POST `/wp-json/wp-abilities/v1/abilities/tranzly/update-display/run`	manage_options (controllo interno della route REST)	`switcher` object `credit` boolean
`tranzly/update-engine-settings` Imposta il motore predefinito, un motore di riserva, i motori per lingua e i modelli IA per lingua (default, fallback, per_lang, models, caps). Tutto ciò che non è il motore predefinito fa parte di Pro.	Gratis	POST `/wp-json/wp-abilities/v1/abilities/tranzly/update-engine-settings/run`	manage_options (controllo interno della route REST)	`default` string `per_lang` object `fallback` array `caps` object `models` object
`tranzly/update-glossary` Sostituisce le parti del glossario che invii (parole da non tradurre mai, traduzioni dei termini, tono); le parti omesse vengono mantenute. Utilizzato da ogni motore a partire dalla traduzione successiva.	Pro	POST `/wp-json/wp-abilities/v1/abilities/tranzly/update-glossary/run`	manage_options	`dnt` array `terms` object `tone` object
`tranzly/update-settings` Imposta le lingue del sito (languages: elenco di codici e nomi; la prima è la lingua originale), il prefisso delle classi front-end e l’autorizzazione per gli agenti IA (MCP).	Gratis	POST `/wp-json/wp-abilities/v1/abilities/tranzly/update-settings/run`	manage_options (controllo interno della route REST)	`prefix` string `mcp` boolean `languages` array
`tranzly/update-workflow-settings` Imposta 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 (controllo interno della route REST)	`on_update` string: off, stale, translate `on_publish` boolean `review` boolean `quality_threshold` integer `quality_provider` string `quality_model` string
`tranzly/upload-translation-file` Carica un file Tranzly XLIFF o CSV (content, filename) tradotto altrove; restituisce un token che identifica l’upload per l’importazione.	Pro	POST `/wp-json/wp-abilities/v1/abilities/tranzly/upload-translation-file/run`	edit_posts (controllo interno della route REST)	`content` string (obbligatorio) `filename` string (obbligatorio)

Generato dal file abilities.json del plugin, che a sua volta è generato da un sito attivo; un test fallisce quando i due elementi non concordano.

Comandi WP-CLI

Eseguili sul server con WP-CLI. Ogni comando controlla le stesse autorizzazioni delle schermate del plugin; gli esempi sono tratti dal testo di aiuto del plugin stesso.

Comando	Descrizione	Edizione
`wp tranzly create <id> [--term]` `wp tranzly create 42 --lang=de_DE --user=admin`	Crea una bozza di traduzione per un articolo/pagina (o termine), collegata ad esso.	Gratuita
`wp tranzly engines`	Elenca i motori di traduzione.	Gratuita
`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=admin` `wp tranzly jobs status 12` `wp tranzly jobs failures 12` `wp tranzly jobs retry 345 --engine=deepl` `wp tranzly jobs retry-failed 12` `wp tranzly jobs run 12 # esegue l'attività qui invece di attendere l'elaboratore della coda`	Attività di traduzione in background.	Gratuita
`wp tranzly legacy <action> [--format=<format>]` `wp tranzly legacy dry-run` `wp tranzly legacy run` `wp tranzly legacy undo`	Mostra, esegue una simulazione (dry-run), avvia o annulla l’importazione delle traduzioni di un sito con versione legacy di Tranzly (2.x).	Gratuita
`wp tranzly link <source> <target> [--term]`	Collega un articolo/pagina (o termine) esistente come traduzione di un altro.	Gratuita
`wp tranzly network <action> [--languages=<codes>]` `wp tranzly network setup` `wp tranzly network languages --languages=en_US,de_DE,fr_FR`	Multisito (Agency): configura ogni sito della rete o imposta le lingue con cui iniziano i nuovi siti.	Gratuita
`wp tranzly translate [<id>...] [--post-type=<type>] [--engine=<id>] [--force] [--publish] [--dry-run]` `wp tranzly translate --lang=de --post-type=page --user=admin` `wp tranzly translate 42 43 --lang=de_DE,fr_FR --engine=deepl --user=admin`	Traduce articoli/pagine con un motore di traduzione.	Gratuita
`wp tranzly translations <id> [--term] [--format=<format>]`	Elenca le traduzioni di un articolo/pagina (o termine).	Gratuita

Funzioni PHP

Funzioni che i temi e altri plugin possono richiamare. Controlla prima con function_exists(), in modo che il tuo codice continui a funzionare mentre il plugin è inattivo.

Funzione	Cosa fa	Edizione
`icl_object_id( $id, $type = 'post', $return_original_if_missing = false, $lang = null )`	WPML: la traduzione di un oggetto.	Pro
`pll__( $text )`	Polylang: una stringa registrata, tradotta. Tranzly traduce le stringhe dei temi tramite il gettext nativo di WordPress, quindi la stringa viene restituita così com’è.	Pro
`pll_current_language( $field = 'slug' )`	Polylang: la lingua corrente.	Pro
`pll_default_language( $field = 'slug' )`	Polylang: la lingua predefinita.	Pro
`pll_e( $text )`	Polylang: stampa a video una stringa registrata, con escaping.	Pro
`pll_get_post( $post_id, $lang = null )`	Polylang: la traduzione di un articolo.	Pro
`pll_get_post_language( $post_id, $field = 'slug' )`	Polylang: la lingua di un articolo.	Pro
`pll_get_post_translations( $post_id )`	Polylang: ogni traduzione di un articolo, slug => ID.	Pro
`pll_get_term( $term_id, $lang = null )`	Polylang: la traduzione di un termine.	Pro
`pll_get_term_language( $term_id, $field = 'slug' )`	Polylang: la lingua di un termine.	Pro
`pll_get_term_translations( $term_id )`	Polylang: ogni traduzione di un termine, slug => ID.	Pro
`pll_home_url( $lang = '' )`	Polylang: l’URL della home page in una lingua.	Pro
`pll_is_translated_post_type( $post_type )`	Polylang: questo tipo di articolo è tradotto?	Pro
`pll_is_translated_taxonomy( $taxonomy )`	Polylang: questa tassonomia è tradotta?	Pro
`pll_languages_list( $args = array( )`	Polylang: le lingue.	Pro
`pll_register_string()`	Polylang: registra una stringa (accettata e ignorata — vedi pll__()).	Pro
`pll_the_languages( $args = array( )`	Polylang: il selettore di lingua. `raw` restituisce l’array di Polylang (slug => dettagli); altrimenti un elenco `<li>` nel markup di Polylang, stampato a meno che `echo` non sia 0. Rispetta `hide_current`, `hide_if_no_translation` e `display_names_as` (`name` o `slug`). L’opzione `dropdown` viene visualizzata come elenco: il blocco/widget di selezione di Tranzly è la sede adatta per un menu a discesa.	Pro
`pll_translate_string( $text )`	Polylang: una stringa registrata in una lingua. Come per pll__(), la stringa viene restituita così com’è.	Pro
`tranzly_compat_field( string $code, string $field )`	Un campo di una lingua, nel vocabolario di Polylang.	Pro
`tranzly_current_language(): string`	La lingua della richiesta corrente (un codice di locale di WordPress come `fr_FR`).	Free
`tranzly_default_language(): string`	La lingua predefinita: la prima dell’elenco.	Free
`tranzly_get_engines(): array`	I motori disponibili: id => nome.	Free
`tranzly_get_post_language( int $post_id ): string`	La lingua in cui è scritto un articolo.	Free
`tranzly_get_term_language( int $term_id ): string`	La lingua in cui è scritto un termine.	Free
`tranzly_get_term_translation( int $term_id, string $lang ): ?int`	La traduzione di un termine in una lingua, oppure null.	Free
`tranzly_get_term_translations( int $term_id ): array`	Ogni versione di un termine: codice lingua => ID termine.	Free
`tranzly_get_translation( int $post_id, string $lang ): ?int`	L’ID della traduzione di un articolo in una lingua, oppure null quando non esiste. Restituisce l’ID stesso dell’articolo quando è già scritto in quella lingua.	Free
`tranzly_get_translations( int $post_id ): array`	Ogni versione di un articolo, incluso l’articolo stesso: codice lingua => ID articolo. Un articolo senza traduzioni restituisce solo se stesso nella propria lingua.	Free
`tranzly_language_switcher( array $args = array( )`	L’HTML del selettore di lingua, per qualsiasi tema, builder o plugin (T5). L’elemento di Page Builder Sandwich lo richiama; puoi farlo anche tu. Vuoto se sono presenti meno di due lingue.	Free
`tranzly_language_url( string $lang, ?string $url = null ): string`	Un URL che mostra la lingua specificata.	Free
`tranzly_languages(): array`	Le lingue del sito, con la predefinita al primo posto.	Free
`tranzly_register_engine( Engine $engine )`	Aggiunge un motore di traduzione. Richiamalo su `tranzly_register_engines`, o in qualsiasi momento prima della prima traduzione della richiesta.	Free
`tranzly_restore_language(): bool`	Annulla l’ultimo tranzly_switch_language().	Free
`tranzly_switch_language( string $lang ): bool`	Esegue il codice in un’altra lingua fino a tranzly_restore_language(): la lingua corrente e le traduzioni native di WordPress cambiano entrambe. Si annida come switch_to_blog():	Free
`tranzly_translatable_attributes( string $block_name ): array`	I nomi degli attributi che Tranzly traduce per un tipo di blocco: `role: content` nel rispettivo block.json, modificato dal filtro `tranzly_translatable_attributes`.	Free
`tranzly_translate_post( int $post_id, string $lang, string $engine = '', array $args = array( )`	Traduci un articolo in una lingua con un motore, come utente corrente (si applicano i suoi permessi).	Gratuito

Azioni e filtri

Ogni hook offerto dal plugin, con la descrizione tratta dal suo codice sorgente. I filtri modificano un valore; le azioni consentono di eseguire codice in un determinato momento; gli entry point sono azioni che attivi per richiedere al plugin di fare qualcosa.

Hook	Tipo	Descrizione	Parametri	Edizione
`tranzly_admin_bar`	Azione	Viene eseguito dopo la creazione del menu Traduzioni nella barra di amministrazione (l’editor visivo Pro aggiunge qui la voce “Traduci in questa pagina”).	`\WP_Admin_Bar $bar` `int $id`	Free
`tranzly_admin_data`	Filtro	Filtra i dati di avvio dell’app di amministrazione. Il livello premium lo usa per indicare la propria edizione; non inserire dati sensibili qui, poiché vengono stampati nella pagina.	nessuno	Free
`tranzly_ai_model`	Filtro	Filtra il fornitore e il modello di IA che traducono in una lingua. Free: il fornitore e il modello scelti per l’attività `translate`, per ogni lingua. Tranzly Pro: la scelta specifica della lingua, altrimenti la scelta per “tutte le altre lingue”.	`string $target`	Free
`tranzly_ai_providers_in_use`	Filtro	Filtra i fornitori di IA scelti per determinate lingue. Nessuno nel plugin gratuito: ogni lingua usa il fornitore e il modello scelti per l’attività `translate`. Tranzly Pro elenca i fornitori dei suoi modelli specifici per lingua.	nessuno	Free
`tranzly_content_before_rebuild`	Filtro	Filtra il contenuto sorgente appena prima che vi vengano scritti i segmenti tradotti, per lingua (lo usa lo scambio di immagini per lingua di Pro).	`string $content` `string $lang`	Free
`tranzly_copy_meta_keys`	Filtro	Filtra i meta key copiati da un articolo alla sua nuova traduzione. Non viene copiato nient’altro.	`int $source_id`	Free
`tranzly_deepl_host`	Filtro	Filtra l’host dell’API di DeepL (un proxy o un test double).	`string $host` `string $key`	Free
`tranzly_deepl_price_per_million`	Filtro	Filtra il prezzo di DeepL per milione di caratteri in dollari statunitensi.	`float $price`	Free
`tranzly_default_engine`	Filtro	Filtra l’id del motore usato quando non ne viene indicato alcuno.	`string $id`	Free
`tranzly_engine_cap`	Filtro	Filtra il limite mensile di un motore in dollari statunitensi: nessuno nel plugin gratuito.	`float\|null $cap` `string $engine`	Free
`tranzly_engine_chain`	Filtro	Filtra i motori da provare per una lingua, in ordine. Free: il motore predefinito. Il livello premium aggiunge il motore specifico della lingua e l’elenco di fallback.	`string $lang` `string $first`	Free
`tranzly_engine_options`	Filtro	Filtra le opzioni passate al motore (elenco delle parole da non tradurre, glossario, formalità, istruzioni).	`string $target` `Engine $engine`	Free
`tranzly_engine_settings_save`	Filtro	Salva i motori e i modelli di IA specifici per lingua, l’elenco di fallback e i limiti mensili. Risponde solo il livello premium (linea guida 5 di WordPress.org: nessun comportamento Pro nel plugin gratuito).	nessuno	Free
`tranzly_frontend_prefix`	Filtro	Filtra il prefisso neutro delle classi per il front-end.	`string $prefix`	Free
`tranzly_fs_loaded`	Azione	Viene eseguito dopo il caricamento dell’SDK di gestione delle licenze (nel file principale, prima di qualsiasi codice di Tranzly). Aggancia qui le funzioni per interagire con `tranzly_fs()`.	nessuno	Free
`tranzly_glossary_options`	Filtro	Filtra le opzioni del motore per una lingua di destinazione: l’elenco delle parole da non tradurre, oltre al glossario e al tono quando vengono aggiunti dal livello premium.	`string $lang`	Free
`tranzly_glossary_save`	Filtro	Salva le traduzioni preferite e il tono per ogni lingua. Risponde solo il livello premium (linea guida 5 di WordPress.org: nessun comportamento Pro nel plugin gratuito).	nessuno	Free
`tranzly_google_price_per_million`	Filtro	Filtra il prezzo di Google Cloud Translation per milione di caratteri, in dollari statunitensi.	`float $price`	Pro
`tranzly_install_language_packs`	Filtro	Determina se Tranzly installa i pacchetti lingua di WordPress, del tema e dei plugin per una lingua aggiunta al sito (in modo che i testi di WordPress e WooCommerce risultino tradotti). Attivo per impostazione predefinita.	`bool $install`	Free
`tranzly_integration_available`	Filtro	Filtra se un’integrazione deve essere eseguita quando il relativo plugin non viene rilevato: utile per i contenuti lasciati da un builder dopo la disattivazione o per un plugin caricato in modo insolito.	`bool $on` `string $id`	Free
`tranzly_integrations`	Filtro	Filtra le integrazioni eseguite da Tranzly. Aggiungi una sottoclasse di `Integration` per supportare un altro plugin.	nessuno	Free
`tranzly_is_pro`	Filtro	Filtra se il livello premium è attivo. Risponde solo il livello premium.	`bool $pro`	Free
`tranzly_job_created`	Azione	Viene eseguito dopo la creazione di un’attività di traduzione.	`int $job` `int $items`	Free
`tranzly_job_finished`	Action	Viene eseguito quando un’attività di traduzione non ha più elementi da elaborare.	`int $job_id`	Free
`tranzly_kit_api_base`	Filter	Filtra la base API di Zinn Digital® chiamata dalle schermate di supporto.	`string $base`	Free
`tranzly_kit_diagnostics`	Filter	Filtra la diagnostica prima che il proprietario del sito la visualizzi. Un plugin aggiunge i propri dati sotto `extra`. ⛔ Questo viene eseguito PRIMA dell’anteprima, mai tra l’anteprima e l’invio.	none	Free
`tranzly_kit_footprint_free`	Filter	Filtra se questo sito è privo di tracciamento, in modo che Zinn® Ads non vi sia mai promosso.	`bool $footprint_free`	Free
`tranzly_kit_promotions`	Filter	Filtra il registro delle promozioni prima che venga elaborato. Aggiungi una riga per promuovere un altro prodotto: `id`, `kind` (hosting\|marketplace\|platform\|plugin\|bundle\|ads), `slot` (promo\|cross-sell) e `url` o (per un plugin) `name`, `site`, `main_files`.	none	Free
`tranzly_kit_tier`	Filter	Filtra il piano segnalato dal kit per questo plugin (test e staging; la licenza decide in produzione).	`string $tier`	Free
`tranzly_localize_links`	Filter	Filtra se Tranzly indirizza i link interni di questa pagina alle rispettive traduzioni.	`bool $localize` `string $lang`	Free
`tranzly_memory_enabled`	Filter	Filtra se la memoria di traduzione è abilitata.	`bool $on`	Pro
`tranzly_microsoft_price_per_million`	Filter	Filtra il prezzo per milione di caratteri di Microsoft Translator, in dollari USA.	`float $price`	Pro
`tranzly_network_enabled`	Filter	Filtra se il livello di rete multisito è attivo.	`bool $agency`	Free
`tranzly_pbs_internal_post_types`	Filter	Filtra i tipi di contenuto di Page Builder Sandwich ignorati da Tranzly.	none	Free
`tranzly_post_segments`	Filter	Filtra i segmenti di un articolo inviati al motore. Chiave => `text` + `format` (`text` o `html`). Il parser compatibile con i blocchi e le integrazioni aggiungono, dividono o sostituiscono i segmenti qui e li riscrivono su `tranzly_translated_post_fields`.	`\WP_Post $post`	Free
`tranzly_post_translated`	Action	Viene eseguito dopo che un motore ha tradotto un articolo (o dopo che il file di una persona o un’importazione ne ha scritto uno).	`int $target` `int $source_id` `string $code` `string $engine`	Free
`tranzly_post_translation_created`	Action	Viene eseguito dopo che Tranzly ha creato la traduzione di un articolo.	`int $new_id` `int $source_id` `string $code`	Free
`tranzly_post_types`	Filter	Filtra i tipi di contenuto che Tranzly traduce.	none	Free
`tranzly_pre_current_language`	Filter	Bypassa la lingua corrente: restituisci un codice lingua per utilizzarlo. È così che funziona tranzly_switch_language(); restituisci null per lasciare decidere a Tranzly.	`string\|null $lang`	Free
`tranzly_query_var`	Filter	Filtra la query variable che seleziona la lingua.	`string $var`	Free
`tranzly_queue_lease_seconds`	Filter	Filtra la durata del blocco su un elemento assegnato: trascorso questo tempo, un worker terminato in modo anomalo restituisce l’elemento agli altri. Deve essere più lungo della singola traduzione più lenta.	`int $seconds`	Free
`tranzly_queue_worker_seconds`	Filter	Filtra per quanti secondi viene eseguito un singolo worker prima di passare il controllo.	`int $seconds`	Free
`tranzly_queue_workers`	Filter	Filtra quanti worker esegue contemporaneamente un’attività. È un limite sui WORKER per non sovraccaricare il servizio di traduzione; non è mai un limite sul numero di elementi completati.	`int $workers` `int $job_id`	Free
`tranzly_rate_source_`	Filter	Tassi da un’altra fonte (vedi `tranzly_rate_sources`).	none	Pro
`tranzly_rate_sources`	Filter	Filtra le fonti dei tassi di cambio. Aggiungine una con un filtro `tranzly_rate_source_<id>` che restituisca `[ code => tasso rispetto al riferimento ]` o un WP_Error.	none	Pro
`tranzly_register_engines`	Action	Registra i motori di traduzione. Chiama `$registry->add( new Tuo_Engine() )`.	`Registry $registry`	Free
`tranzly_relations_changed`	Action	Viene eseguito dopo che i collegamenti di traduzione degli oggetti sono cambiati: collegati, scollegati, spostati in un’altra lingua o rimossi. Viene eseguito una volta per gruppo modificato, quindi un singolo collegamento può attivarlo due volte.	`string $type` `array<int> $ids`	Free
`tranzly_robots_meta_keys`	Filter	Filtra i metadati degli articoli contenenti le impostazioni per i robot; ciascuno viene replicato dall’originale alle relative traduzioni.	none	Free
`tranzly_shared_string_scopes`	Filter	Filtra gli ambiti dei testi condivisi (corsia L06, T6: le integrazioni aggiungono `woocommerce`, `forms` e `theme`; i loro testi arrivano su `tranzly_shared_strings`).	nessuno	Gratuito
`tranzly_shared_strings`	Filter	Filtra i testi condivisi che Tranzly traduce come stringhe, per ambito. Il livello Pro aggiunge template di blocchi, parti di template e pattern a `templates`.	`string $scope`	Gratuito
`tranzly_shared_strings_covered`	Filter	Filtra i testi di un ambito di testo condiviso che un language pack traduce per una lingua. Il livello Pro segnala i pattern registrati del tema e del core per `templates`.	`string $scope` `string $lang`	Gratuito
`tranzly_source_changed`	Action	Si attiva quando il contenuto traducibile di un originale è cambiato, rendendo obsolete le sue traduzioni.	`int $post_id` `string $now` `string $before`	Gratuito
`tranzly_source_meta_keys`	Filter	Filtra i meta key la cui modifica rende obsolete le traduzioni di una pagina. Le integrazioni aggiungono le chiavi che traducono (dati del builder, campi SEO, campi personalizzati).	`int $post_id`	Gratuito
`tranzly_source_published`	Action	Si attiva una sola volta quando un originale viene pubblicato per la prima volta (dopo il salvataggio dei suoi metadati).	`int $post_id`	Gratuito
`tranzly_style_rules_enabled`	Filter	Indica se Tranzly applica le regole di stile del team di traduzione di WordPress.org della lingua (virgolette, spaziatura attorno alla punteggiatura, apostrofi, puntini di sospensione, spaziatura giapponese, pronomi allocutivi) a ogni nuova traduzione. Attivo per impostazione predefinita.	`bool $enabled` `string $locale`	Gratuito
`tranzly_taxonomies`	Filter	Filtra le tassonomie che Tranzly traduce.	nessuno	Gratuito
`tranzly_term_segments`	Filter	Filtra i segmenti di un termine inviati al motore (`name`, `description`, oltre a tutto ciò che le integrazioni aggiungono: titoli SEO, campi personalizzati). Scrivi quelli aggiunti su `tranzly_term_translated`.	`\WP_Term $term`	Gratuito
`tranzly_term_translated`	Action	Si attiva dopo che un motore ha tradotto un termine, con ogni segmento tradotto (le integrazioni scrivono i segmenti che hanno aggiunto su `tranzly_term_segments`).	`int $target` `int $term_id` `string $code`	Gratuito
`tranzly_term_translation_created`	Action	Si attiva dopo che Tranzly ha creato la traduzione di un termine.	`int $new_id` `int $term_id` `string $code`	Gratuito
`tranzly_translatable_attributes`	Filter	Filtra gli attributi che Tranzly traduce per un tipo di blocco.	`string $block_name`	Gratuito
`tranzly_translate_string`	Filter	Filtra una singola stringa traducibile in una lingua.	`string $value` `string $code` `array $context`	Gratuito
`tranzly_translated_post_fields`	Filter	Filtra i campi dell’articolo scritti in una traduzione, dopo l’esecuzione del motore. Le integrazioni che hanno aggiunto i propri segmenti (campi personalizzati, dati del builder) li scrivono qui.	`\WP_Post $post` `string $code`	Gratuito
`tranzly_translation_memory`	Filter	Filtra la memoria di traduzione in uso: nessuna nel plugin gratuito; il livello premium ne offre una (docs/843, linea guida 5 di WordPress.org).	`Translation_Memory\|null $memory`	Gratuito