Vývojáři

Referenční příručka schopností Tranzly

Tranzly registruje své akce pomocí WordPress Abilities API. Tyto stejné schopnosti fungují jako nástroje MCP na vlastním serveru webu a jako cesty REST pod /wp-json/wp-abilities/v1. Tato stránka je generována z vlastního registru pluginu.

Uživatelská příručka: připojení aplikace s umělou inteligencí

Koncové body

SchopnostREST
MCP přes HTTP (streamovatelné)/wp-json/tranzly/v1/mcp
MCP přes WP-CLI (standardní vstup a výstup)wp mcp-adapter serve --server=tranzly --user=<login>
REST: vypsat schopnosti/wp-json/wp-abilities/v1/abilities?category=tranzly
REST: spustit schopnost/wp-json/wp-abilities/v1/abilities/<name>/run (GET s ?input= pro schopnosti pouze pro čtení, jinak POST {"input": {...}})

Ověřování a oprávnění

Požadavky HTTP se ověřují pomocí aplikačního hesla WordPressu (HTTP Basic). Připojení k serveru MCP vyžaduje oprávnění (capability) uvedené níže; každá schopnost pak kontroluje své vlastní oprávnění pro každý objekt zvlášť. Schopnosti určené pouze pro čtení se spouštějí pomocí GET s parametry v query stringu; ostatní pomocí POST a tělem JSON ‚{„input“: {…}}‘.

aplikační heslo WordPressu (HTTP) nebo --user (WP-CLI); uživatel potřebuje oprávnění, které každá schopnost vyžaduje · Nastavení: Povolit agenty AI (MCP), ve výchozím stavu zapnuto

Všechny schopnosti

SchopnostEdiceRESTOprávněníParametry
tranzly/bulk-translate
Spustí úlohy překladu na pozadí pro každý originál zadaných typů obsahu (všechny překládané typy, pokud nejsou zadány): chybějící překlady, zastaralé nebo všechny. Vrací spuštěné úlohy, jednu pro každý jazyk.
ProPOST /wp-json/wp-abilities/v1/abilities/tranzly/bulk-translate/runedit_posts; publish_posts pro publikovánílanguages pole (povinné)
post_types pole
scope řetězec: missing, stale, all
engine řetězec
publish boolean
tranzly/cancel-job
Zastaví úlohu; již vytvořené překlady zůstanou zachovány.
FreePOST /wp-json/wp-abilities/v1/abilities/tranzly/cancel-job/runmanage_options (vlastní kontrola REST trasy)id řetězec (povinné)
tranzly/check-quality
Nechá AI porovnat překlad s originálem, ohodnotit jej a uloží zprávu k danému překladu. Používá AI model pro kontrolu kvality nastavený v předvolbách workflow v Tranzly.
ProPOST /wp-json/wp-abilities/v1/abilities/tranzly/check-quality/runedit_post pro daný překladid celé číslo (povinné)
tranzly/connect-support
Připojí tento web k podpoře Zinn Digital® (jméno, e-mail, souhlas).
FreePOST /wp-json/wp-abilities/v1/abilities/tranzly/connect-support/runmanage_options (vlastní kontrola REST trasy)email řetězec (povinné)
name řetězec
consent boolean (povinné)
tranzly/correct-segments
Uloží opravené segmenty překladu (segments: klíč k textu); opravený text je chráněn před opětovným překladem.
FreePOST /wp-json/wp-abilities/v1/abilities/tranzly/correct-segments/runedit_post (vlastní kontrola REST trasy)id řetězec (povinné)
segments objekt
texts objekt
tranzly/create-job
Spustí úlohu na pozadí překládající vybrané příspěvky (posts) nebo celý typ příspěvku do zvolených jazyků (langs).
FreePOST /wp-json/wp-abilities/v1/abilities/tranzly/create-job/runedit_posts (vlastní kontrola REST trasy)posts pole
post_type řetězec
langs pole (povinné)
engine řetězec
status řetězec: publish, draft
force boolean
tranzly/create-post-translation
Vytvoří koncept překladu příspěvku v daném jazyce (lang) pro ruční úpravu bez překladového enginu.
FreePOST /wp-json/wp-abilities/v1/abilities/tranzly/create-post-translation/runvlastní kontrola oprávnění REST trasy pro danou položkuid řetězec (povinné)
lang řetězec (povinné)
name řetězec
slug řetězec
description řetězec
tranzly/create-term-translation
Vytvoří překlad položky taxonomie v daném jazyce se zadaným názvem, zkráceným názvem a popisem.
FreePOST /wp-json/wp-abilities/v1/abilities/tranzly/create-term-translation/runvlastní kontrola oprávnění REST trasy pro danou položkuid řetězec (povinné)
lang řetězec (povinné)
name řetězec
slug řetězec
description řetězec
tranzly/disconnect-support
Odpojí tento web od podpory.
FreePOST /wp-json/wp-abilities/v1/abilities/tranzly/disconnect-support/runmanage_options (vlastní kontrola REST trasy)žádné
tranzly/estimate
Odhadne počet znaků a náklady na překlad příspěvků (posts nebo post_type) do jazyků (langs) pomocí enginu před zahájením čerpání kreditu.
FreePOST /wp-json/wp-abilities/v1/abilities/tranzly/estimate/runedit_posts (vlastní kontrola REST trasy)posts pole
post_type řetězec
langs pole (povinné)
engine řetězec
tranzly/estimate-bulk
Odhadne překlad celého webu v určitém jazyce (post_types, scope, engine) před jeho spuštěním.
ProPOST /wp-json/wp-abilities/v1/abilities/tranzly/estimate-bulk/runedit_posts (vlastní kontrola REST trasy)post_types pole
scope řetězec: missing, stale, all
engine řetězec
lang řetězec (povinné)
after celé číslo
tranzly/export-translation-file
Vrátí soubor XLIFF nebo CSV (ve formě textu) s originály a jejich překlady v jednom jazyce pro překladatele nebo překladatelskou agenturu: zadané příspěvky nebo stránku až se 100 originály typu obsahu v daném stavu (missing, stale, translated nebo all; opakujte s parametrem after). Po přeložení lze tentýž soubor naimportovat zpět.
ProGET /wp-json/wp-abilities/v1/abilities/tranzly/export-translation-file/runedit_posts; každý příspěvek je zahrnut pouze v případě, že k němu má uživatel oprávnění k úpravámlang řetězec (povinné)
format řetězec: xliff, csv
posts pole
post_type řetězec
state řetězec: all, missing, stale, translated
after celé číslo
tranzly/fix-status
Zařadí do fronty překlad každé chybějící (nebo neaktuální) položky v daném jazyce a typu obsahu.
ZdarmaPOST /wp-json/wp-abilities/v1/abilities/tranzly/fix-status/runedit_posts (vlastní kontrola REST trasy)post_type string
lang string (vyžadováno)
state string (vyžadováno): missing, stale, quality
tranzly/get-comments-setting
Vrací, zda jsou komentáře sdíleny napříč jazyky, nebo vedeny pro každý jazyk zvlášť.
ProGET /wp-json/wp-abilities/v1/abilities/tranzly/get-comments-setting/runmoderate_comments (vlastní kontrola REST trasy)žádné
tranzly/get-deepl-usage
Vrací počet využitých znaků a limit uloženého klíče DeepL pro tento měsíc.
ZdarmaGET /wp-json/wp-abilities/v1/abilities/tranzly/get-deepl-usage/runmanage_options (vlastní kontrola REST trasy)žádné
tranzly/get-diagnostics
Vrací diagnostické údaje, které by obsahoval požadavek na podporu: verze, aktivní pluginy, limity a nedávné chyby.
ZdarmaGET /wp-json/wp-abilities/v1/abilities/tranzly/get-diagnostics/runmanage_options (vlastní kontrola REST trasy)žádné
tranzly/get-display
Vrací možnosti přepínače jazyků a zobrazení informací o autorství.
ZdarmaGET /wp-json/wp-abilities/v1/abilities/tranzly/get-display/runmanage_options (vlastní kontrola REST trasy)žádné
tranzly/get-engine-settings
Vrací výchozí a záložní překladový modul, moduly a modely AI pro jednotlivé jazyky, stav každého modulu, připojené poskytovatele AI včetně jejich modelů a výdaje za tento měsíc.
ZdarmaGET /wp-json/wp-abilities/v1/abilities/tranzly/get-engine-settings/runmanage_options (vlastní kontrola REST trasy)žádné
tranzly/get-glossary
Vrací slova, která se nikdy nepřekládají, pevně stanovené překlady termínů a tón komunikace pro jednotlivé jazyky.
ProGET /wp-json/wp-abilities/v1/abilities/tranzly/get-glossary/runmanage_optionsžádné
tranzly/get-integrations
Vypisuje pluginy pro SEO, WooCommerce, page buildery a formuláře, které Tranzly podporuje a které jsou zde aktivní.
ZdarmaGET /wp-json/wp-abilities/v1/abilities/tranzly/get-integrations/runmanage_options (vlastní kontrola REST trasy)žádné
tranzly/get-job
Vrací průběh a počty konkrétní úlohy.
ZdarmaGET /wp-json/wp-abilities/v1/abilities/tranzly/get-job/runmanage_options (vlastní kontrola REST trasy)id string (vyžadováno)
tranzly/get-job-failures
Vypisuje neúspěšné položky úlohy včetně důvodu selhání u každé z nich.
ZdarmaGET /wp-json/wp-abilities/v1/abilities/tranzly/get-job-failures/runmanage_options (vlastní kontrola REST trasy)id string (vyžadováno)
tranzly/get-legacy-import
Vrací stav a přehled importu překladů z Tranzly 2.x.
ZdarmaGET /wp-json/wp-abilities/v1/abilities/tranzly/get-legacy-import/runmanage_options (vlastní kontrola REST trasy)žádné
tranzly/get-licence
Vrací tarif Tranzly pro tento web, stav licence, datum obnovení a obsah tarifu.
ZdarmaGET /wp-json/wp-abilities/v1/abilities/tranzly/get-licence/runmanage_options (vlastní kontrola REST trasy)žádné
tranzly/get-menus
Vrací, které menu se v jednotlivých jazycích zobrazuje v daných umístěních nabídek.
ZdarmaGET /wp-json/wp-abilities/v1/abilities/tranzly/get-menus/runedit_theme_options (vlastní kontrola REST trasy)žádné
tranzly/get-post-group
Vypisuje překladovou skupinu příspěvku: položku v každém jazyce včetně názvu, stavu a odkazu pro úpravy.
ZdarmaGET /wp-json/wp-abilities/v1/abilities/tranzly/get-post-group/runedit_post a edit_term (vlastní kontrola REST trasy)id string (vyžadováno)
tranzly/get-quality-report
Vrací přehled kvality překladu z AI: skóre a označené segmenty.
ProGET /wp-json/wp-abilities/v1/abilities/tranzly/get-quality-report/runedit_post (vlastní kontrola REST trasy)id string (vyžadováno)
tranzly/get-segments
Vrací segmenty překladu vedle původního textu ke kontrole a opravě.
ZdarmaGET /wp-json/wp-abilities/v1/abilities/tranzly/get-segments/runedit_post (vlastní kontrola REST trasy)id string (vyžadováno)
tranzly/get-shared-strings
Vrací texty šablony a pluginu (scope) v daném jazyce včetně jejich překladů.
ZdarmaGET /wp-json/wp-abilities/v1/abilities/tranzly/get-shared-strings/runedit_theme_options (vlastní kontrola REST trasy)lang string (vyžadováno)
scope string: menus, site, templates, gettext.plugin-<slug>, gettext.theme-<slug>
tranzly/get-site-strings
Vrací název webu, popis a texty widgetů v daném jazyce.
ZdarmaGET /wp-json/wp-abilities/v1/abilities/tranzly/get-site-strings/runmanage_options (vlastní kontrola REST trasy)lang string (vyžadováno)
tranzly/get-support-connection
Sdělí, zda je tento web připojen k podpoře Zinn Digital® a pod jakým účtem.
ZdarmaGET /wp-json/wp-abilities/v1/abilities/tranzly/get-support-connection/runmanage_options (vlastní kontrola REST trasy)refresh boolean
tranzly/get-term-group
Vypíše překladovou skupinu kategorie nebo štítku.
ZdarmaGET /wp-json/wp-abilities/v1/abilities/tranzly/get-term-group/runedit_post a edit_term (vlastní kontrola REST trasy)id string (vyžadováno)
tranzly/get-urls
Vrací způsob zobrazení jazyků v adresách (složka, subdoména nebo doména), přeložené trvalé odkazy a základy a direktivu noindex pro nepřeložené stránky.
ZdarmaGET /wp-json/wp-abilities/v1/abilities/tranzly/get-urls/runmanage_options (vlastní kontrola REST trasy)žádné
tranzly/get-workflow-settings
Vrací automatický překlad při publikování a aktualizaci, kontrolu před publikováním a prahovou hodnotu, poskytovatele a model kontroly kvality pomocí AI.
ProGET /wp-json/wp-abilities/v1/abilities/tranzly/get-workflow-settings/runmanage_options (vlastní kontrola REST trasy)žádné
tranzly/import-from-source
Importuje další stránku překladů z jiného vícejazyčného pluginu (režim: dry-run nebo run; kurzor).
ProPOST /wp-json/wp-abilities/v1/abilities/tranzly/import-from-source/runmanage_options (vlastní kontrola REST trasy)source string (vyžadováno)
mode string: dry-run, run, undo
cursor string
tranzly/import-translation-file
Zapisuje další stránku příspěvků z nahraného překladového souboru (opakujte s parametrem after až do dokončení).
ProPOST /wp-json/wp-abilities/v1/abilities/tranzly/import-translation-file/runedit_posts (vlastní kontrola REST trasy)token string (vyžadováno)
after integer
tranzly/link-post
Nastaví existující příspěvek (target) jako překlad tohoto příspěvku v daném jazyce.
ZdarmaPOST /wp-json/wp-abilities/v1/abilities/tranzly/link-post/runedit_post a edit_term (vlastní kontrola REST trasy)id string (vyžadováno)
lang string (vyžadováno)
target integer (vyžadováno)
tranzly/link-term
Nastaví existující položku taxonomie (target) jako překlad této položky v daném jazyce.
ZdarmaPOST /wp-json/wp-abilities/v1/abilities/tranzly/link-term/runedit_post a edit_term (vlastní kontrola REST trasy)id string (vyžadováno)
lang string (vyžadováno)
target integer (vyžadováno)
tranzly/list-engines
Vypíše překladové moduly, stav jejich nastavení a modul použitý ve výchozím stavu.
ZdarmaGET /wp-json/wp-abilities/v1/abilities/tranzly/list-engines/runedit_postsžádné
tranzly/list-import-sources
Vypíše data z pluginů WPML, Polylang a TranslatePress nalezená na tomto webu, která lze importovat.
ProGET /wp-json/wp-abilities/v1/abilities/tranzly/list-import-sources/runmanage_options (vlastní kontrola REST trasy)žádné
tranzly/list-jobs
Vypíše úlohy překladu na pozadí od nejnovějších, včetně postupu.
ZdarmaGET /wp-json/wp-abilities/v1/abilities/tranzly/list-jobs/runedit_posts (vlastní kontrola REST trasy)žádné
tranzly/list-languages
Vypíše jazyky webu. Prvním z nich je jazyk, ve kterém je napsán původní obsah.
ZdarmaGET /wp-json/wp-abilities/v1/abilities/tranzly/list-languages/runedit_postsžádné
tranzly/list-status-items
Vypisuje originály s jejich stavem překladu v daném jazyce (stav: missing, stale, current), stránku po stránce.
ZdarmaGET /wp-json/wp-abilities/v1/abilities/tranzly/list-status-items/runedit_posts (vlastní kontrola REST trasy)post_type string
lang string (vyžadováno)
state string: all, missing, stale, translated, human, machine, review, quality
after integer
tranzly/list-theme-strings
Vypíše šablony a pluginy, jejichž texty lze zkontrolovat pro překlad, a počet řetězců každého z nich.
ProGET /wp-json/wp-abilities/v1/abilities/tranzly/list-theme-strings/runmanage_options (vlastní kontrola REST trasy)žádné
tranzly/open-support-ticket
Odešle požadavek na podporu (předmět, zpráva, typ, e-mail) spolu s diagnostickými údaji webu, pokud k tomu dal správce souhlas. Nikdy nevytváří ani neodesílá přihlašovací údaje.
ZdarmaPOST /wp-json/wp-abilities/v1/abilities/tranzly/open-support-ticket/runmanage_options (vlastní kontrola REST trasy)subject string (vyžadováno)
message string (vyžadováno)
kind string: help, bug, feedback, feature_request
email string
name string
diagnostics boolean
tranzly/record-support-consent
Zaznamená souhlas správce s odesíláním diagnostických údajů v požadavcích na podporu.
ZdarmaPOST /wp-json/wp-abilities/v1/abilities/tranzly/record-support-consent/runmanage_options (vlastní kontrola REST trasy)consent boolean (vyžadováno)
tranzly/retry-job-item
Znovu zkusí zpracovat neúspěšnou položku (akce: retry, volitelně s jiným překladačem) nebo ji označí pro ruční překlad (akce: by-hand).
ZdarmaPOST /wp-json/wp-abilities/v1/abilities/tranzly/retry-job-item/runedit_post a manage_options (vlastní kontrola REST trasy)item řetězec (vyžadováno)
action řetězec (vyžadováno)
engine řetězec
tranzly/review-translation
Schválí překlad (a publikuje jej, pokud je publikován originál) nebo jej vrátí zpět (rozhodnutí, poznámka).
ProPOST /wp-json/wp-abilities/v1/abilities/tranzly/review-translation/runedit_post (vlastní kontrola REST trasy)id řetězec (vyžadováno)
decision řetězec (vyžadováno): approve, changes, pending
note řetězec
tranzly/run-legacy-import
Spustí import z verze 2.x: zkušební běh (pouze přehled), spuštění nebo vrácení zpět.
ZdarmaPOST /wp-json/wp-abilities/v1/abilities/tranzly/run-legacy-import/runmanage_options (vlastní kontrola REST trasy)action řetězec (vyžadováno)
tranzly/scan-theme-strings
Prohledá další stránku PHP souborů komponenty a vyhledá přeložitelné texty (opakujte s parametrem after až do dokončení).
ProPOST /wp-json/wp-abilities/v1/abilities/tranzly/scan-theme-strings/runmanage_options (vlastní kontrola REST trasy)component řetězec (vyžadováno)
after celé číslo
tranzly/schedule-quality-check
Naplánuje kontrolu kvality pomocí AI pro další stránku překladů daného jazyka (nebo pro zadané příspěvky).
ProPOST /wp-json/wp-abilities/v1/abilities/tranzly/schedule-quality-check/runedit_posts (vlastní kontrola REST trasy)lang řetězec (vyžadováno)
post_type řetězec
posts pole
after celé číslo
tranzly/seo-audit
Zkontroluje v překladech daného jazyka chybějící SEO titulky, popisy, trvalé odkazy a hreflang, stránku po stránce.
ProGET /wp-json/wp-abilities/v1/abilities/tranzly/seo-audit/runmanage_options (vlastní kontrola REST trasy)lang řetězec (vyžadováno)
after celé číslo
tranzly/set-comments-setting
Sdílí komentáře napříč překlady příspěvku nebo je ponechává oddělené podle jazyka (režim).
ProPOST /wp-json/wp-abilities/v1/abilities/tranzly/set-comments-setting/runmanage_options a moderate_comments (vlastní kontrola REST trasy)mode řetězec (vyžadováno): off, show, translate
tranzly/set-engine-key
Uloží API klíč (a region pro Microsoft) služeb DeepL, Google nebo Microsoft; prázdná hodnota jej odstraní. Klíče jsou uloženy šifrovaně a nikdy se nevracejí.
ZdarmaPOST /wp-json/wp-abilities/v1/abilities/tranzly/set-engine-key/runmanage_options (vlastní kontrola REST trasy)engine řetězec (vyžadováno)
key řetězec (vyžadováno)
region řetězec
tranzly/set-menus
Přiřadí menu pro jednotlivé jazyky a umístění (mapa).
ZdarmaPOST /wp-json/wp-abilities/v1/abilities/tranzly/set-menus/runedit_theme_options (vlastní kontrola REST trasy)map objekt (vyžadováno)
tranzly/set-protection
Ochrání překlad před přepsáním překladačem (protected: true), nebo jej odemkne.
ZdarmaPOST /wp-json/wp-abilities/v1/abilities/tranzly/set-protection/runedit_post (vlastní kontrola REST trasy)id řetězec (vyžadováno)
protected boolean (vyžadováno)
tranzly/set-shared-strings
Uloží opravené překlady textů šablony a pluginů (řetězce); tyto texty budou chráněny.
ZdarmaPOST /wp-json/wp-abilities/v1/abilities/tranzly/set-shared-strings/runedit_theme_options (vlastní kontrola REST trasy)lang řetězec (vyžadováno)
scope řetězec: menus, site, templates, gettext.plugin-<slug>, gettext.theme-<slug>
strings objekt (vyžadováno)
tranzly/set-site-string
Uloží jeden text webu (klíč) v daném jazyce, například název webu nebo popis.
ZdarmaPOST /wp-json/wp-abilities/v1/abilities/tranzly/set-site-string/runedit_theme_options a manage_options (vlastní kontrola REST trasy)lang řetězec (vyžadováno)
key řetězec (vyžadováno)
translation řetězec (vyžadováno)
tranzly/set-urls
Nastaví režim adres URL (mode), domény pro jednotlivé jazyky, přeložené základy a segmenty, noindex_untranslated a návrhy trvalých odkazů.
ZdarmaPOST /wp-json/wp-abilities/v1/abilities/tranzly/set-urls/runmanage_options (vlastní kontrola REST trasy)mode řetězec
segments objekt
domains objekt
bases objekt
suggest boolean
noindex_untranslated boolean
tranzly/start-trial
Spustí 14denní zkušební verzi Tranzly Pro pro tento web (bez nutnosti platby).
ZdarmaPOST /wp-json/wp-abilities/v1/abilities/tranzly/start-trial/runmanage_options (vlastní kontrola REST trasy)žádné
tranzly/translate-media-field
Uloží alternativní text, název nebo popisek obrázku (field) v daném jazyce (lang).
ZdarmaPOST /wp-json/wp-abilities/v1/abilities/tranzly/translate-media-field/runedit_post (vlastní kontrola cesty REST)id řetězec (vyžadováno)
lang řetězec (vyžadováno)
field řetězec (vyžadováno): alt, caption, title
translation řetězec (vyžadováno)
tranzly/translate-post
Přeloží jeden příspěvek nebo stránku do jednoho či více jazyků webu pomocí překladového nástroje, přičemž vytvoří nebo aktualizuje jednotlivé překlady. Nové překlady jsou koncepty, pokud není publish true. Překlad upravený člověkem je přeskočen, pokud není force true.
ZdarmaPOST /wp-json/wp-abilities/v1/abilities/tranzly/translate-post/runoprávnění překládat daný příspěvek (edit_post na něm); edit_post na existujícím překladu; oprávnění typu obsahu k publikování pro publikaciid celé číslo (vyžadováno)
languages pole (vyžadováno)
engine řetězec
publish logická hodnota
force logická hodnota
tranzly/translate-shared-strings
Přeloží další stránku nepřeložených textů šablon a pluginů v daném jazyce pomocí výchozího nástroje (opakujte s parametrem after až do dokončení).
ZdarmaPOST /wp-json/wp-abilities/v1/abilities/tranzly/translate-shared-strings/runedit_theme_options (vlastní kontrola cesty REST)lang řetězec (vyžadováno)
scope řetězec: menus, site, templates, gettext.plugin-<slug>, gettext.theme-<slug>
after celé číslo
tranzly/translate-site
Řízený postup: agent zkontroluje jazyky a nástroj, odhadne náklady a přeloží chybějící části, přičemž před čerpáním nákladů či publikováním vyžádá potvrzení.
ZdarmaPOST /wp-json/wp-abilities/v1/abilities/tranzly/translate-site/runedit_postslanguages řetězec (vyžadováno)
tranzly/translate-term
Přeloží jeden výraz (rubriku, štítek nebo vlastnost produktu) do daného jazyka (lang) pomocí zvoleného nástroje a vytvoří či aktualizuje jeho překlad.
ZdarmaPOST /wp-json/wp-abilities/v1/abilities/tranzly/translate-term/runvlastní kontrola oprávnění pro jednotlivé položky v cestě RESTid řetězec (vyžadováno)
lang řetězec (vyžadováno)
engine řetězec
force logická hodnota
status řetězec: publish, draft
tranzly/translation-status
S ID příspěvku: překlad daného příspěvku v jednotlivých jazycích, zda je zastaralý a kdo jej vytvořil. Bez ID: míra přeložení webu podle jazyků.
ZdarmaGET /wp-json/wp-abilities/v1/abilities/tranzly/translation-status/runedit_post pro daný příspěvek; edit_posts pro souhrn webuid celé číslo
post_type řetězec
tranzly/unlink-post
Odebere příspěvek z překladové skupiny; jazyk zůstane zachován.
ZdarmaPOST /wp-json/wp-abilities/v1/abilities/tranzly/unlink-post/runedit_post a edit_term (vlastní kontrola cesty REST)id řetězec (vyžadováno)
tranzly/unlink-term
Odebere výraz z překladové skupiny.
ZdarmaPOST /wp-json/wp-abilities/v1/abilities/tranzly/unlink-term/runedit_post a edit_term (vlastní kontrola cesty REST)id řetězec (vyžadováno)
tranzly/update-display
Upraví přepínač (styl, vlajky, názvy, umístění) a řádek s uvedením autorství.
ZdarmaPOST /wp-json/wp-abilities/v1/abilities/tranzly/update-display/runmanage_options (vlastní kontrola cesty REST)switcher objekt
credit logická hodnota
tranzly/update-engine-settings
Nastaví výchozí nástroj, záložní nástroj, nástroje pro jednotlivé jazyky a modely AI pro jednotlivé jazyky (default, fallback, per_lang, models, caps). Vše kromě výchozího nástroje vyžaduje verzi Pro.
ZdarmaPOST /wp-json/wp-abilities/v1/abilities/tranzly/update-engine-settings/runmanage_options (vlastní kontrola cesty REST)default řetězec
per_lang objekt
fallback pole
caps objekt
models objekt
tranzly/update-glossary
Nahradí odeslané části glosáře (nepřekládaná slova, překlady výrazů, tón); vynechané části zůstanou zachovány. Použije se u všech nástrojů od příštího překladu.
ProPOST /wp-json/wp-abilities/v1/abilities/tranzly/update-glossary/runmanage_optionsdnt pole
terms objekt
tone objekt
tranzly/update-settings
Nastaví jazyky webu (languages: seznam kódů a názvů; první z nich je původní jazyk), předponu tříd na front-endu a povolení pro agenty AI (MCP).
ZdarmaPOST /wp-json/wp-abilities/v1/abilities/tranzly/update-settings/runmanage_options (vlastní kontrola cesty REST)prefix řetězec
mcp logická hodnota
languages pole
tranzly/update-workflow-settings
Nastavuje on_update (off, stale, translate), on_publish, review, quality_threshold, quality_provider a quality_model.
ProPOST /wp-json/wp-abilities/v1/abilities/tranzly/update-workflow-settings/runmanage_options (vlastní kontrola REST cesty)on_update řetězec: off, stale, translate
on_publish logická hodnota
review logická hodnota
quality_threshold celé číslo
quality_provider řetězec
quality_model řetězec
tranzly/upload-translation-file
Nahrává soubor Tranzly XLIFF nebo CSV (obsah, název souboru) přeložený jinde; vrací token identifikující nahraný soubor pro import.
ProPOST /wp-json/wp-abilities/v1/abilities/tranzly/upload-translation-file/runedit_posts (vlastní kontrola REST cesty)content řetězec (vyžadováno)
filename řetězec (vyžadováno)

Vygenerováno ze souboru abilities.json pluginu, který je sám generován z běžícího webu; test selže, pokud se tyto dva neshodují.

Příkazy WP-CLI

Spouštějte je na serveru pomocí WP-CLI. Každý příkaz kontroluje stejná oprávnění jako obrazovky pluginu; příklady jsou převzaty z vlastní nápovědy pluginu.

PříkazCo děláEdice
wp tranzly create <id> [--term]
wp tranzly create 42 --lang=de_DE --user=admin
Vytvoří koncept překladu příspěvku (nebo výrazu), propojený s ním.Zdarma
wp tranzly enginesVypíše překladové moduly.Zdarma
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 # work the job here instead of waiting for the queue runner
Úlohy překladu na pozadí.Zdarma
wp tranzly legacy <action> [--format=<format>]
wp tranzly legacy dry-run
wp tranzly legacy run
wp tranzly legacy undo
Zobrazí, nanečisto vyzkouší, spustí nebo vrátí zpět import překladů staršího webu Tranzly (2.x).Zdarma
wp tranzly link <source> <target> [--term]Propojí existující příspěvek (nebo výraz) jako překlad jiného.Zdarma
wp tranzly network <action> [--languages=<codes>]
wp tranzly network setup
wp tranzly network languages --languages=en_US,de_DE,fr_FR
Multisite (Agency): nastaví každý web v síti nebo nastaví jazyky, se kterými nové weby začínají.Zdarma
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
Přeloží příspěvky pomocí překladového modulu.Zdarma
wp tranzly translations <id> [--term] [--format=<format>]Vypíše překlady příspěvku (nebo výrazu).Zdarma

PHP funkce

Funkce, které mohou šablony a jiné pluginy volat. Nejprve zkontrolujte function_exists(), aby váš kód fungoval i v době, kdy je plugin neaktivní.

FunkceCo děláEdice
icl_object_id( $id, $type = 'post', $return_original_if_missing = false, $lang = null )WPML: překlad objektu.Pro
pll__( $text )Polylang: registrovaný řetězec, přeložený. Tranzly překládá řetězce šablony prostřednictvím vlastního gettextu WordPressu, takže se řetězec vrací v původním znění.Pro
pll_current_language( $field = 'slug' )Polylang: aktuální jazyk.Pro
pll_default_language( $field = 'slug' )Polylang: výchozí jazyk.Pro
pll_e( $text )Polylang: vypsání registrovaného řetězce s ošetřením znaků (escaped).Pro
pll_get_post( $post_id, $lang = null )Polylang: překlad příspěvku.Pro
pll_get_post_language( $post_id, $field = 'slug' )Polylang: jazyk příspěvku.Pro
pll_get_post_translations( $post_id )Polylang: všechny překlady příspěvku, slug => ID.Pro
pll_get_term( $term_id, $lang = null )Polylang: překlad položky taxonomie.Pro
pll_get_term_language( $term_id, $field = 'slug' )Polylang: jazyk položky taxonomie.Pro
pll_get_term_translations( $term_id )Polylang: všechny překlady položky taxonomie, slug => ID.Pro
pll_home_url( $lang = '' )Polylang: adresa URL domovské stránky v daném jazyce.Pro
pll_is_translated_post_type( $post_type )Polylang: je tento typ příspěvku překládán?Pro
pll_is_translated_taxonomy( $taxonomy )Polylang: je tato taxonomie překládána?Pro
pll_languages_list( $args = array( )Polylang: jazyky.Pro
pll_register_string()Polylang: registrace řetězce (přijato a ignorováno – viz pll__()).Pro
pll_the_languages( $args = array( )Polylang: přepínač jazyků. Parametr `raw` vrátí pole z Polylangu (slug => podrobnosti); jinak seznam `<li>` ve značkování Polylangu, vypsaný přímo, pokud není `echo` nastaveno na 0. Respektuje `hide_current`, `hide_if_no_translation` a `display_names_as` (`name` nebo `slug`). Hodnota `dropdown` je vykreslena jako seznam: pro rozbalovací nabídku slouží vlastní blok/widget přepínače v Tranzly.Pro
pll_translate_string( $text )Polylang: registrovaný řetězec v daném jazyce. Stejně jako u pll__() se řetězec vrací v původním znění.Pro
tranzly_compat_field( string $code, string $field )Jedno pole jazyka v terminologii Polylangu.Pro
tranzly_current_language(): stringJazyk aktuálního požadavku (kód národního prostředí WordPressu, například `fr_FR`).Free
tranzly_default_language(): stringVýchozí jazyk: první v seznamu.Free
tranzly_get_engines(): arrayDostupné překladové enginy: id => název.Free
tranzly_get_post_language( int $post_id ): stringJazyk, ve kterém je příspěvek napsán.Free
tranzly_get_term_language( int $term_id ): stringJazyk, ve kterém je položka taxonomie napsána.Free
tranzly_get_term_translation( int $term_id, string $lang ): ?intPřeklad položky taxonomie do daného jazyka, případně null.Free
tranzly_get_term_translations( int $term_id ): arrayVšechny verze položky taxonomie: kód jazyka => ID položky.Free
tranzly_get_translation( int $post_id, string $lang ): ?intID překladu příspěvku do daného jazyka, případně null, pokud neexistuje. Vrací vlastní ID příspěvku, pokud je již v tomto jazyce napsán.Free
tranzly_get_translations( int $post_id ): arrayVšechny verze příspěvku včetně příspěvku samotného: kód jazyka => ID příspěvku. Příspěvek bez překladů vrátí pouze sám sebe ve svém jazyce.Free
tranzly_language_switcher( array $args = array( )HTML kód přepínače jazyků pro libovolnou šablonu, builder nebo plugin (T5). Element Page Builder Sandwich jej volá a lze jej použít i ve vlastním řešení. Zůstává prázdný, pokud existují méně než dva jazyky.Free
tranzly_language_url( string $lang, ?string $url = null ): stringAdresa URL zobrazující daný jazyk.Free
tranzly_languages(): arrayJazyky webu, výchozí na prvním místě.Free
tranzly_register_engine( Engine $engine )Přidání překladového enginu. Volá se při akci `tranzly_register_engines` nebo kdykoli před prvním překladem v rámci požadavku.Free
tranzly_restore_language(): boolVrátí zpět poslední tranzly_switch_language().Free
tranzly_switch_language( string $lang ): boolSpustí kód v jiném jazyce až do zavolání tranzly_restore_language(): přepne se aktuální jazyk i vlastní překlady WordPressu. Zanořuje se stejně jako switch_to_blog():Free
tranzly_translatable_attributes( string $block_name ): arrayNázvy atributů, které Tranzly překládá pro daný typ bloku: `role: content` v jeho block.json, upravené filtrem `tranzly_translatable_attributes`.Free
tranzly_translate_post( int $post_id, string $lang, string $engine = '', array $args = array( )Překlad příspěvku do daného jazyka pomocí překladového modulu jako aktuální uživatel (s uplatněním jeho oprávnění).Zdarma

Akce a filtry

Každý hook, který plugin nabízí, s popisem z jeho zdrojového kódu. Filtry mění hodnotu; akce umožňují spustit kód v určitý okamžik; vstupní body jsou akce, které spouštíte, abyste plugin požádali o provedení nějaké činnosti.

HookTypPopis činnostiParametryVerze
tranzly_admin_barAkceSpouští se po vytvoření nabídky Překlady v horní liště administrace (vizuální editor verze Pro sem přidává položku „Přeložit na této stránce“).\WP_Admin_Bar $bar
int $id
Zdarma
tranzly_admin_dataFiltrFiltruje data, se kterými se spouští administrační aplikace. Prémiová vrstva jej používá k nahlášení své edice; nepatří sem žádné citlivé údaje, protože se vypisují přímo do stránky.žádnéZdarma
tranzly_ai_modelFiltrFiltruje poskytovatele a model AI, které překládají do daného jazyka. Bezplatná verze: poskytovatel a model vybraný pro úlohu `translate` pro každý jazyk. Tranzly Pro: vlastní volba pro daný jazyk, jinak volba „všechny ostatní jazyky“.string $targetZdarma
tranzly_ai_providers_in_useFiltrFiltruje poskytovatele AI vybrané pro konkrétní jazyky. V bezplatném pluginu žádní: každý jazyk používá poskytovatele a model vybraný pro úlohu `translate`. Tranzly Pro vypisuje poskytovatele modelů pro jednotlivé jazyky.žádnéZdarma
tranzly_content_before_rebuildFiltrFiltruje zdrojový obsah těsně před tím, než jsou do něj zapsány přeložené segmenty, pro každý jazyk (používá jej výměna obrázků podle jazyka ve verzi Pro).string $content
string $lang
Zdarma
tranzly_copy_meta_keysFiltrFiltruje meta klíče zkopírované z příspěvku do jeho nového překladu. Nic jiného se nekopíruje.int $source_idZdarma
tranzly_deepl_hostFiltrFiltruje hostitele DeepL API (proxy nebo testovací dvojník).string $host
string $key
Zdarma
tranzly_deepl_price_per_millionFiltrFiltruje cenu služby DeepL za milion znaků v amerických dolarech.float $priceZdarma
tranzly_default_engineFiltrFiltruje ID překladače použitého v případě, kdy není žádný určen.string $idZdarma
tranzly_engine_capFiltrFiltruje měsíční limit překladače v amerických dolarech: v bezplatném pluginu není žádný.float|null $cap
string $engine
Zdarma
tranzly_engine_chainFiltrFiltruje překladače, které se mají postupně vyzkoušet pro daný jazyk. Bezplatná verze: výchozí překladač. Prémiová vrstva přidává vlastní překladač daného jazyka a záložní seznam.string $lang
string $first
Zdarma
tranzly_engine_optionsFiltrFiltruje možnosti předávané překladači (seznam nepřekládaných výrazů, glosář, formálnost, instrukce).string $target
Engine $engine
Zdarma
tranzly_engine_settings_saveFiltrUkládá překladače a modely AI pro jednotlivé jazyky, záložní seznam a měsíční limity. Reaguje pouze prémiová vrstva (pravidlo 5 na WordPress.org: žádné chování verze Pro v bezplatném pluginu).žádnéZdarma
tranzly_frontend_prefixFiltrFiltruje neutrální předponu třídy pro frontend.string $prefixZdarma
tranzly_fs_loadedAkceSpouští se po načtení licenčního SDK (v hlavním souboru před jakýmkoli kódem Tranzly). Vhodné místo pro komunikaci s `tranzly_fs()`.žádnéZdarma
tranzly_glossary_optionsFiltrFiltruje možnosti překladače pro cílový jazyk: seznam nepřekládaných výrazů a dále glosář a tón, pokud je prémiová vrstva přidá.string $langZdarma
tranzly_glossary_saveFiltrUkládá preferované překlady a tón pro jednotlivé jazyky. Reaguje pouze prémiová vrstva (pravidlo 5 na WordPress.org: žádné chování verze Pro v bezplatném pluginu).žádnéZdarma
tranzly_google_price_per_millionFiltrFiltruje cenu služby Google Cloud Translation za milion znaků v amerických dolarech.float $pricePro
tranzly_install_language_packsFiltrUrčuje, zda Tranzly instaluje jazykové balíčky WordPressu, šablon a pluginů pro jazyk přidaný na web (aby se texty WordPressu a WooCommerce zobrazovaly přeložené). Ve výchozím nastavení zapnuto.bool $installZdarma
tranzly_integration_availableFiltrFiltruje, zda integrace běží i v případě, že její plugin není detekován – pro obsah, který po sobě zanechal page builder po vypnutí, nebo pro plugin načtený neobvyklým způsobem.bool $on
string $id
Zdarma
tranzly_integrationsFiltrFiltruje integrace, které Tranzly spouští. Přidáním podtřídy `Integration` lze podpořit další plugin.žádnéZdarma
tranzly_is_proFiltrFiltruje, zda běží prémiová vrstva. Reaguje na něj pouze prémiová vrstva.bool $proZdarma
tranzly_job_createdAkceSpouští se po vytvoření úlohy překladu.int $job
int $items
Zdarma
tranzly_job_finishedAkceSpustí se, když v úloze překladu nezbývá žádná práce.int $job_idZdarma
tranzly_kit_api_baseFiltrFiltruje základní URL API Zinn Digital®, které volají obrazovky podpory.string $baseZdarma
tranzly_kit_diagnosticsFiltrFiltruje diagnostiku předtím, než ji uvidí majitel webu. Plugin přidává vlastní údaje pod `extra`. ⛔ Spouští se PŘED náhledem, nikdy mezi náhledem a odesláním.žádnéZdarma
tranzly_kit_footprint_freeFiltrFiltruje, zda je tento web bez digitální stopy, takže na něm Zinn® Ads nejsou nikdy propagovány.bool $footprint_freeZdarma
tranzly_kit_promotionsFiltrFiltruje registr propagací před jeho vyhodnocením. Přidáním řádku lze propagovat jiný produkt: `id`, `kind` (hosting|marketplace|platform|plugin|bundle|ads), `slot` (promo|cross-sell) a `url` nebo (u pluginu) `name`, `site`, `main_files`.žádnéZdarma
tranzly_kit_tierFiltrFiltruje úroveň tarifu, kterou sada pro tento plugin hlásí (testy a staging; v produkci rozhoduje licence).string $tierZdarma
tranzly_localize_linksFiltrFiltruje, zda Tranzly přesměruje interní odkazy této stránky na jejich překlady.bool $localize
string $lang
Zdarma
tranzly_memory_enabledFiltrFiltruje, zda se používá překladová paměť.bool $onPro
tranzly_microsoft_price_per_millionFiltrFiltruje cenu služby Microsoft Translator za milion znaků v amerických dolarech.float $pricePro
tranzly_network_enabledFiltrFiltruje, zda je zapnutá vrstva sítě multisite.bool $agencyZdarma
tranzly_pbs_internal_post_typesFiltrFiltruje typy příspěvků Page Builder Sandwich, které Tranzly ponechává beze změny.žádnéZdarma
tranzly_post_segmentsFiltrFiltruje segmenty příspěvku odesílané do překladače. Klíč => `text` + `format` (`text` nebo `html`). Parser zohledňující bloky a integrace zde segmenty přidávají, rozdělují nebo nahrazují a zapisují je zpět do `tranzly_translated_post_fields`.\WP_Post $postZdarma
tranzly_post_translatedAkceSpustí se poté, co překladač přeložil příspěvek (nebo jej zapsal soubor od člověka či import).int $target
int $source_id
string $code
string $engine
Zdarma
tranzly_post_translation_createdAkceSpustí se poté, co Tranzly vytvoří překlad příspěvku.int $new_id
int $source_id
string $code
Zdarma
tranzly_post_typesFiltrFiltruje typy příspěvků, které Tranzly překládá.žádnéZdarma
tranzly_pre_current_languageFiltrPřednostně určuje aktuální jazyk: pro jeho použití vraťte kód jazyka. Takto funguje tranzly_switch_language(); vrácením null rozhodne Tranzly.string|null $langZdarma
tranzly_query_varFiltrFiltruje proměnnou dotazu, která vybírá jazyk.string $varZdarma
tranzly_queue_lease_secondsFiltrFiltruje dobu propůjčení převzaté položky: po jejím uplynutí proces, který selhal uprostřed zpracování položky, vrátí položku ostatním. Delší než nejpomalejší jednotlivý překlad.int $secondsZdarma
tranzly_queue_worker_secondsFiltrFiltruje, jak dlouho jeden proces běží před předáním dalšímu, v sekundách.int $secondsZdarma
tranzly_queue_workersFiltrFiltruje, kolik procesů najednou jedna úloha spouští. Omezení počtu procesů pro šetření překladové služby; nikdy omezení počtu hotových položek.int $workers
int $job_id
Zdarma
tranzly_rate_source_FiltrKurzy z jiného zdroje (viz `tranzly_rate_sources`).žádnéPro
tranzly_rate_sourcesFiltrFiltruje zdroje směnných kurzů. Další lze přidat pomocí filtru `tranzly_rate_source_<id>`, který vrací `[ kód => kurz vůči referenční měně ]` nebo WP_Error.žádnéPro
tranzly_register_enginesAkceRegistrace překladových služeb. Volejte `$registry->add( new Your_Engine() )`.Registry $registryZdarma
tranzly_relations_changedAkceSpustí se po změně překladových vazeb objektů: propojení, odpojení, přesunutí do jiného jazyka nebo odstranění. Spouští se jednou pro každou dotčenou skupinu, takže jedno propojení ji může spustit dvakrát.string $type
array<int> $ids
Zdarma
tranzly_robots_meta_keysFiltrFiltruje uživatelská pole příspěvku obsahující nastavení pro roboty; každé z nich následuje originál do jeho překladů.žádnéZdarma
tranzly_shared_string_scopesFiltrFiltruje rozsahy sdíleného textu (lane L06, T6: integrace přidávají woocommerce, forms a theme; jejich texty přicházejí přes tranzly_shared_strings).žádnéZdarma
tranzly_shared_stringsFiltrFiltruje sdílené texty, které Tranzly překládá jako řetězce, podle rozsahu. Verze Pro přidává šablony bloků, části šablon a vzory do templates.string $scopeZdarma
tranzly_shared_strings_coveredFiltrFiltruje texty rozsahu sdíleného textu, které jazykový balíček překládá pro daný jazyk. Verze Pro hlásí registrované vzory šablony a jádra pro templates.string $scope
string $lang
Zdarma
tranzly_source_changedAkceSpouští se při změně přeložitelného obsahu originálu, takže jeho překlady jsou nyní zastaralé.int $post_id
string $now
string $before
Zdarma
tranzly_source_meta_keysFiltrFiltruje meta klíče, jejichž změna způsobí zastarání překladů stránky. Integrace přidávají klíče, které překládají (data editorů stránek, SEO pole, uživatelská pole).int $post_idZdarma
tranzly_source_publishedAkceSpouští se jednou při prvním publikování originálu (po uložení jeho meta dat).int $post_idZdarma
tranzly_style_rules_enabledFiltrUrčuje, zda Tranzly u každého nového překladu uplatňuje stylistická pravidla překladatelského týmu WordPress.org pro daný jazyk (uvozovky, mezery kolem interpunkce, apostrofy, výpustky, japonské mezery, zájmena oslovení). Ve výchozím nastavení zapnuto.bool $enabled
string $locale
Zdarma
tranzly_taxonomiesFiltrFiltruje taxonomie, které Tranzly překládá.žádnéZdarma
tranzly_term_segmentsFiltrFiltruje segmenty položky taxonomie odeslané překladovému modulu (name, description a další přidané integracemi: SEO názvy, uživatelská pole). Přidané segmenty se zapisují v tranzly_term_translated.\WP_Term $termZdarma
tranzly_term_translatedAkceSpouští se po překladu položky taxonomie modulem se všemi přeloženými segmenty (integrace zapisují segmenty, které přidaly v tranzly_term_segments).int $target
int $term_id
string $code
Zdarma
tranzly_term_translation_createdAkceSpouští se po vytvoření překladu položky taxonomie v Tranzly.int $new_id
int $term_id
string $code
Zdarma
tranzly_translatable_attributesFiltrFiltruje atributy, které Tranzly překládá pro daný typ bloku.string $block_nameZdarma
tranzly_translate_stringFiltrFiltruje jeden přeložitelný řetězec do jazyka.string $value
string $code
array $context
Zdarma
tranzly_translated_post_fieldsFiltrFiltruje pole příspěvku zapsaná do překladu po spuštění modulu. Integrace, které přidaly vlastní segmenty (uživatelská pole, data editorů), je zapisují sem.\WP_Post $post
string $code
Zdarma
tranzly_translation_memoryFiltrFiltruje používanou překladovou paměť: v bezplatném pluginu žádná; prémiová vrstva ji nabízí (docs/843, pravidlo 5 pro WordPress.org).Translation_Memory|null $memoryZdarma