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
| Schopnost | REST |
|---|---|
| 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
| Schopnost | Edice | REST | Oprávnění | Parametry |
|---|---|---|---|---|
tranzly/bulk-translateSpustí ú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. | Pro | POST /wp-json/wp-abilities/v1/abilities/tranzly/bulk-translate/run | edit_posts; publish_posts pro publikování | languages pole (povinné)post_types polescope řetězec: missing, stale, allengine řetězecpublish boolean |
tranzly/cancel-jobZastaví úlohu; již vytvořené překlady zůstanou zachovány. | Free | POST /wp-json/wp-abilities/v1/abilities/tranzly/cancel-job/run | manage_options (vlastní kontrola REST trasy) | id řetězec (povinné) |
tranzly/check-qualityNechá 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. | Pro | POST /wp-json/wp-abilities/v1/abilities/tranzly/check-quality/run | edit_post pro daný překlad | id celé číslo (povinné) |
tranzly/connect-supportPřipojí tento web k podpoře Zinn Digital® (jméno, e-mail, souhlas). | Free | POST /wp-json/wp-abilities/v1/abilities/tranzly/connect-support/run | manage_options (vlastní kontrola REST trasy) | email řetězec (povinné)name řetězecconsent boolean (povinné) |
tranzly/correct-segmentsUloží opravené segmenty překladu (segments: klíč k textu); opravený text je chráněn před opětovným překladem. | Free | POST /wp-json/wp-abilities/v1/abilities/tranzly/correct-segments/run | edit_post (vlastní kontrola REST trasy) | id řetězec (povinné)segments objekttexts objekt |
tranzly/create-jobSpustí úlohu na pozadí překládající vybrané příspěvky (posts) nebo celý typ příspěvku do zvolených jazyků (langs). | Free | POST /wp-json/wp-abilities/v1/abilities/tranzly/create-job/run | edit_posts (vlastní kontrola REST trasy) | posts polepost_type řetězeclangs pole (povinné)engine řetězecstatus řetězec: publish, draftforce boolean |
tranzly/create-post-translationVytvoří koncept překladu příspěvku v daném jazyce (lang) pro ruční úpravu bez překladového enginu. | Free | POST /wp-json/wp-abilities/v1/abilities/tranzly/create-post-translation/run | vlastní kontrola oprávnění REST trasy pro danou položku | id řetězec (povinné)lang řetězec (povinné)name řetězecslug řetězecdescription řetězec |
tranzly/create-term-translationVytvoří překlad položky taxonomie v daném jazyce se zadaným názvem, zkráceným názvem a popisem. | Free | POST /wp-json/wp-abilities/v1/abilities/tranzly/create-term-translation/run | vlastní kontrola oprávnění REST trasy pro danou položku | id řetězec (povinné)lang řetězec (povinné)name řetězecslug řetězecdescription řetězec |
tranzly/disconnect-supportOdpojí tento web od podpory. | Free | POST /wp-json/wp-abilities/v1/abilities/tranzly/disconnect-support/run | manage_options (vlastní kontrola REST trasy) | žádné |
tranzly/estimateOdhadne 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. | Free | POST /wp-json/wp-abilities/v1/abilities/tranzly/estimate/run | edit_posts (vlastní kontrola REST trasy) | posts polepost_type řetězeclangs pole (povinné)engine řetězec |
tranzly/estimate-bulkOdhadne překlad celého webu v určitém jazyce (post_types, scope, engine) před jeho spuštěním. | Pro | POST /wp-json/wp-abilities/v1/abilities/tranzly/estimate-bulk/run | edit_posts (vlastní kontrola REST trasy) | post_types polescope řetězec: missing, stale, allengine řetězeclang řetězec (povinné)after celé číslo |
tranzly/export-translation-fileVrá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. | Pro | GET /wp-json/wp-abilities/v1/abilities/tranzly/export-translation-file/run | edit_posts; každý příspěvek je zahrnut pouze v případě, že k němu má uživatel oprávnění k úpravám | lang řetězec (povinné)format řetězec: xliff, csvposts polepost_type řetězecstate řetězec: all, missing, stale, translatedafter celé číslo |
tranzly/fix-statusZařadí do fronty překlad každé chybějící (nebo neaktuální) položky v daném jazyce a typu obsahu. | Zdarma | POST /wp-json/wp-abilities/v1/abilities/tranzly/fix-status/run | edit_posts (vlastní kontrola REST trasy) | post_type stringlang string (vyžadováno)state string (vyžadováno): missing, stale, quality |
tranzly/get-comments-settingVrací, zda jsou komentáře sdíleny napříč jazyky, nebo vedeny pro každý jazyk zvlášť. | Pro | GET /wp-json/wp-abilities/v1/abilities/tranzly/get-comments-setting/run | moderate_comments (vlastní kontrola REST trasy) | žádné |
tranzly/get-deepl-usageVrací počet využitých znaků a limit uloženého klíče DeepL pro tento měsíc. | Zdarma | GET /wp-json/wp-abilities/v1/abilities/tranzly/get-deepl-usage/run | manage_options (vlastní kontrola REST trasy) | žádné |
tranzly/get-diagnosticsVrací diagnostické údaje, které by obsahoval požadavek na podporu: verze, aktivní pluginy, limity a nedávné chyby. | Zdarma | GET /wp-json/wp-abilities/v1/abilities/tranzly/get-diagnostics/run | manage_options (vlastní kontrola REST trasy) | žádné |
tranzly/get-displayVrací možnosti přepínače jazyků a zobrazení informací o autorství. | Zdarma | GET /wp-json/wp-abilities/v1/abilities/tranzly/get-display/run | manage_options (vlastní kontrola REST trasy) | žádné |
tranzly/get-engine-settingsVrací 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. | Zdarma | GET /wp-json/wp-abilities/v1/abilities/tranzly/get-engine-settings/run | manage_options (vlastní kontrola REST trasy) | žádné |
tranzly/get-glossaryVrací slova, která se nikdy nepřekládají, pevně stanovené překlady termínů a tón komunikace pro jednotlivé jazyky. | Pro | GET /wp-json/wp-abilities/v1/abilities/tranzly/get-glossary/run | manage_options | žádné |
tranzly/get-integrationsVypisuje pluginy pro SEO, WooCommerce, page buildery a formuláře, které Tranzly podporuje a které jsou zde aktivní. | Zdarma | GET /wp-json/wp-abilities/v1/abilities/tranzly/get-integrations/run | manage_options (vlastní kontrola REST trasy) | žádné |
tranzly/get-jobVrací průběh a počty konkrétní úlohy. | Zdarma | GET /wp-json/wp-abilities/v1/abilities/tranzly/get-job/run | manage_options (vlastní kontrola REST trasy) | id string (vyžadováno) |
tranzly/get-job-failuresVypisuje neúspěšné položky úlohy včetně důvodu selhání u každé z nich. | Zdarma | GET /wp-json/wp-abilities/v1/abilities/tranzly/get-job-failures/run | manage_options (vlastní kontrola REST trasy) | id string (vyžadováno) |
tranzly/get-legacy-importVrací stav a přehled importu překladů z Tranzly 2.x. | Zdarma | GET /wp-json/wp-abilities/v1/abilities/tranzly/get-legacy-import/run | manage_options (vlastní kontrola REST trasy) | žádné |
tranzly/get-licenceVrací tarif Tranzly pro tento web, stav licence, datum obnovení a obsah tarifu. | Zdarma | GET /wp-json/wp-abilities/v1/abilities/tranzly/get-licence/run | manage_options (vlastní kontrola REST trasy) | žádné |
tranzly/get-menusVrací, které menu se v jednotlivých jazycích zobrazuje v daných umístěních nabídek. | Zdarma | GET /wp-json/wp-abilities/v1/abilities/tranzly/get-menus/run | edit_theme_options (vlastní kontrola REST trasy) | žádné |
tranzly/get-post-groupVypisuje překladovou skupinu příspěvku: položku v každém jazyce včetně názvu, stavu a odkazu pro úpravy. | Zdarma | GET /wp-json/wp-abilities/v1/abilities/tranzly/get-post-group/run | edit_post a edit_term (vlastní kontrola REST trasy) | id string (vyžadováno) |
tranzly/get-quality-reportVrací přehled kvality překladu z AI: skóre a označené segmenty. | Pro | GET /wp-json/wp-abilities/v1/abilities/tranzly/get-quality-report/run | edit_post (vlastní kontrola REST trasy) | id string (vyžadováno) |
tranzly/get-segmentsVrací segmenty překladu vedle původního textu ke kontrole a opravě. | Zdarma | GET /wp-json/wp-abilities/v1/abilities/tranzly/get-segments/run | edit_post (vlastní kontrola REST trasy) | id string (vyžadováno) |
tranzly/get-shared-stringsVrací texty šablony a pluginu (scope) v daném jazyce včetně jejich překladů. | Zdarma | GET /wp-json/wp-abilities/v1/abilities/tranzly/get-shared-strings/run | edit_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-stringsVrací název webu, popis a texty widgetů v daném jazyce. | Zdarma | GET /wp-json/wp-abilities/v1/abilities/tranzly/get-site-strings/run | manage_options (vlastní kontrola REST trasy) | lang string (vyžadováno) |
tranzly/get-support-connectionSdělí, zda je tento web připojen k podpoře Zinn Digital® a pod jakým účtem. | Zdarma | GET /wp-json/wp-abilities/v1/abilities/tranzly/get-support-connection/run | manage_options (vlastní kontrola REST trasy) | refresh boolean |
tranzly/get-term-groupVypíše překladovou skupinu kategorie nebo štítku. | Zdarma | GET /wp-json/wp-abilities/v1/abilities/tranzly/get-term-group/run | edit_post a edit_term (vlastní kontrola REST trasy) | id string (vyžadováno) |
tranzly/get-urlsVrací 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. | Zdarma | GET /wp-json/wp-abilities/v1/abilities/tranzly/get-urls/run | manage_options (vlastní kontrola REST trasy) | žádné |
tranzly/get-workflow-settingsVrací 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. | Pro | GET /wp-json/wp-abilities/v1/abilities/tranzly/get-workflow-settings/run | manage_options (vlastní kontrola REST trasy) | žádné |
tranzly/import-from-sourceImportuje další stránku překladů z jiného vícejazyčného pluginu (režim: dry-run nebo run; kurzor). | Pro | POST /wp-json/wp-abilities/v1/abilities/tranzly/import-from-source/run | manage_options (vlastní kontrola REST trasy) | source string (vyžadováno)mode string: dry-run, run, undocursor string |
tranzly/import-translation-fileZapisuje další stránku příspěvků z nahraného překladového souboru (opakujte s parametrem after až do dokončení). | Pro | POST /wp-json/wp-abilities/v1/abilities/tranzly/import-translation-file/run | edit_posts (vlastní kontrola REST trasy) | token string (vyžadováno)after integer |
tranzly/link-postNastaví existující příspěvek (target) jako překlad tohoto příspěvku v daném jazyce. | Zdarma | POST /wp-json/wp-abilities/v1/abilities/tranzly/link-post/run | edit_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-termNastaví existující položku taxonomie (target) jako překlad této položky v daném jazyce. | Zdarma | POST /wp-json/wp-abilities/v1/abilities/tranzly/link-term/run | edit_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-enginesVypíše překladové moduly, stav jejich nastavení a modul použitý ve výchozím stavu. | Zdarma | GET /wp-json/wp-abilities/v1/abilities/tranzly/list-engines/run | edit_posts | žádné |
tranzly/list-import-sourcesVypíše data z pluginů WPML, Polylang a TranslatePress nalezená na tomto webu, která lze importovat. | Pro | GET /wp-json/wp-abilities/v1/abilities/tranzly/list-import-sources/run | manage_options (vlastní kontrola REST trasy) | žádné |
tranzly/list-jobsVypíše úlohy překladu na pozadí od nejnovějších, včetně postupu. | Zdarma | GET /wp-json/wp-abilities/v1/abilities/tranzly/list-jobs/run | edit_posts (vlastní kontrola REST trasy) | žádné |
tranzly/list-languagesVypíše jazyky webu. Prvním z nich je jazyk, ve kterém je napsán původní obsah. | Zdarma | GET /wp-json/wp-abilities/v1/abilities/tranzly/list-languages/run | edit_posts | žádné |
tranzly/list-status-itemsVypisuje originály s jejich stavem překladu v daném jazyce (stav: missing, stale, current), stránku po stránce. | Zdarma | GET /wp-json/wp-abilities/v1/abilities/tranzly/list-status-items/run | edit_posts (vlastní kontrola REST trasy) | post_type stringlang string (vyžadováno)state string: all, missing, stale, translated, human, machine, review, qualityafter integer |
tranzly/list-theme-stringsVypíše šablony a pluginy, jejichž texty lze zkontrolovat pro překlad, a počet řetězců každého z nich. | Pro | GET /wp-json/wp-abilities/v1/abilities/tranzly/list-theme-strings/run | manage_options (vlastní kontrola REST trasy) | žádné |
tranzly/open-support-ticketOdeš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. | Zdarma | POST /wp-json/wp-abilities/v1/abilities/tranzly/open-support-ticket/run | manage_options (vlastní kontrola REST trasy) | subject string (vyžadováno)message string (vyžadováno)kind string: help, bug, feedback, feature_requestemail stringname stringdiagnostics boolean |
tranzly/record-support-consentZaznamená souhlas správce s odesíláním diagnostických údajů v požadavcích na podporu. | Zdarma | POST /wp-json/wp-abilities/v1/abilities/tranzly/record-support-consent/run | manage_options (vlastní kontrola REST trasy) | consent boolean (vyžadováno) |
tranzly/retry-job-itemZnovu 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). | Zdarma | POST /wp-json/wp-abilities/v1/abilities/tranzly/retry-job-item/run | edit_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-translationSchválí překlad (a publikuje jej, pokud je publikován originál) nebo jej vrátí zpět (rozhodnutí, poznámka). | Pro | POST /wp-json/wp-abilities/v1/abilities/tranzly/review-translation/run | edit_post (vlastní kontrola REST trasy) | id řetězec (vyžadováno)decision řetězec (vyžadováno): approve, changes, pendingnote řetězec |
tranzly/run-legacy-importSpustí import z verze 2.x: zkušební běh (pouze přehled), spuštění nebo vrácení zpět. | Zdarma | POST /wp-json/wp-abilities/v1/abilities/tranzly/run-legacy-import/run | manage_options (vlastní kontrola REST trasy) | action řetězec (vyžadováno) |
tranzly/scan-theme-stringsProhledá další stránku PHP souborů komponenty a vyhledá přeložitelné texty (opakujte s parametrem after až do dokončení). | Pro | POST /wp-json/wp-abilities/v1/abilities/tranzly/scan-theme-strings/run | manage_options (vlastní kontrola REST trasy) | component řetězec (vyžadováno)after celé číslo |
tranzly/schedule-quality-checkNaplánuje kontrolu kvality pomocí AI pro další stránku překladů daného jazyka (nebo pro zadané příspěvky). | Pro | POST /wp-json/wp-abilities/v1/abilities/tranzly/schedule-quality-check/run | edit_posts (vlastní kontrola REST trasy) | lang řetězec (vyžadováno)post_type řetězecposts poleafter celé číslo |
tranzly/seo-auditZkontroluje v překladech daného jazyka chybějící SEO titulky, popisy, trvalé odkazy a hreflang, stránku po stránce. | Pro | GET /wp-json/wp-abilities/v1/abilities/tranzly/seo-audit/run | manage_options (vlastní kontrola REST trasy) | lang řetězec (vyžadováno)after celé číslo |
tranzly/set-comments-settingSdílí komentáře napříč překlady příspěvku nebo je ponechává oddělené podle jazyka (režim). | Pro | POST /wp-json/wp-abilities/v1/abilities/tranzly/set-comments-setting/run | manage_options a moderate_comments (vlastní kontrola REST trasy) | mode řetězec (vyžadováno): off, show, translate |
tranzly/set-engine-keyUloží 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í. | Zdarma | POST /wp-json/wp-abilities/v1/abilities/tranzly/set-engine-key/run | manage_options (vlastní kontrola REST trasy) | engine řetězec (vyžadováno)key řetězec (vyžadováno)region řetězec |
tranzly/set-menusPřiřadí menu pro jednotlivé jazyky a umístění (mapa). | Zdarma | POST /wp-json/wp-abilities/v1/abilities/tranzly/set-menus/run | edit_theme_options (vlastní kontrola REST trasy) | map objekt (vyžadováno) |
tranzly/set-protectionOchrání překlad před přepsáním překladačem (protected: true), nebo jej odemkne. | Zdarma | POST /wp-json/wp-abilities/v1/abilities/tranzly/set-protection/run | edit_post (vlastní kontrola REST trasy) | id řetězec (vyžadováno)protected boolean (vyžadováno) |
tranzly/set-shared-stringsUloží opravené překlady textů šablony a pluginů (řetězce); tyto texty budou chráněny. | Zdarma | POST /wp-json/wp-abilities/v1/abilities/tranzly/set-shared-strings/run | edit_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-stringUloží jeden text webu (klíč) v daném jazyce, například název webu nebo popis. | Zdarma | POST /wp-json/wp-abilities/v1/abilities/tranzly/set-site-string/run | edit_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-urlsNastaví 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ů. | Zdarma | POST /wp-json/wp-abilities/v1/abilities/tranzly/set-urls/run | manage_options (vlastní kontrola REST trasy) | mode řetězecsegments objektdomains objektbases objektsuggest booleannoindex_untranslated boolean |
tranzly/start-trialSpustí 14denní zkušební verzi Tranzly Pro pro tento web (bez nutnosti platby). | Zdarma | POST /wp-json/wp-abilities/v1/abilities/tranzly/start-trial/run | manage_options (vlastní kontrola REST trasy) | žádné |
tranzly/translate-media-fieldUloží alternativní text, název nebo popisek obrázku (field) v daném jazyce (lang). | Zdarma | POST /wp-json/wp-abilities/v1/abilities/tranzly/translate-media-field/run | edit_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, titletranslation řetězec (vyžadováno) |
tranzly/translate-postPř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. | Zdarma | POST /wp-json/wp-abilities/v1/abilities/tranzly/translate-post/run | oprá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 publikaci | id celé číslo (vyžadováno)languages pole (vyžadováno)engine řetězecpublish logická hodnotaforce logická hodnota |
tranzly/translate-shared-stringsPř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í). | Zdarma | POST /wp-json/wp-abilities/v1/abilities/tranzly/translate-shared-strings/run | edit_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í. | Zdarma | POST /wp-json/wp-abilities/v1/abilities/tranzly/translate-site/run | edit_posts | languages řetězec (vyžadováno) |
tranzly/translate-termPř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. | Zdarma | POST /wp-json/wp-abilities/v1/abilities/tranzly/translate-term/run | vlastní kontrola oprávnění pro jednotlivé položky v cestě REST | id řetězec (vyžadováno)lang řetězec (vyžadováno)engine řetězecforce logická hodnotastatus řetězec: publish, draft |
tranzly/translation-statusS 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ů. | Zdarma | GET /wp-json/wp-abilities/v1/abilities/tranzly/translation-status/run | edit_post pro daný příspěvek; edit_posts pro souhrn webu | id celé číslopost_type řetězec |
tranzly/unlink-postOdebere příspěvek z překladové skupiny; jazyk zůstane zachován. | Zdarma | POST /wp-json/wp-abilities/v1/abilities/tranzly/unlink-post/run | edit_post a edit_term (vlastní kontrola cesty REST) | id řetězec (vyžadováno) |
tranzly/unlink-termOdebere výraz z překladové skupiny. | Zdarma | POST /wp-json/wp-abilities/v1/abilities/tranzly/unlink-term/run | edit_post a edit_term (vlastní kontrola cesty REST) | id řetězec (vyžadováno) |
tranzly/update-displayUpraví přepínač (styl, vlajky, názvy, umístění) a řádek s uvedením autorství. | Zdarma | POST /wp-json/wp-abilities/v1/abilities/tranzly/update-display/run | manage_options (vlastní kontrola cesty REST) | switcher objektcredit logická hodnota |
tranzly/update-engine-settingsNastaví 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. | Zdarma | POST /wp-json/wp-abilities/v1/abilities/tranzly/update-engine-settings/run | manage_options (vlastní kontrola cesty REST) | default řetězecper_lang objektfallback polecaps objektmodels objekt |
tranzly/update-glossaryNahradí 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. | Pro | POST /wp-json/wp-abilities/v1/abilities/tranzly/update-glossary/run | manage_options | dnt poleterms objekttone objekt |
tranzly/update-settingsNastaví 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). | Zdarma | POST /wp-json/wp-abilities/v1/abilities/tranzly/update-settings/run | manage_options (vlastní kontrola cesty REST) | prefix řetězecmcp logická hodnotalanguages pole |
tranzly/update-workflow-settingsNastavuje on_update (off, stale, translate), on_publish, review, quality_threshold, quality_provider a quality_model. | Pro | POST /wp-json/wp-abilities/v1/abilities/tranzly/update-workflow-settings/run | manage_options (vlastní kontrola REST cesty) | on_update řetězec: off, stale, translateon_publish logická hodnotareview logická hodnotaquality_threshold celé čísloquality_provider řetězecquality_model řetězec |
tranzly/upload-translation-fileNahrává soubor Tranzly XLIFF nebo CSV (obsah, název souboru) přeložený jinde; vrací token identifikující nahraný soubor pro import. | Pro | POST /wp-json/wp-abilities/v1/abilities/tranzly/upload-translation-file/run | edit_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říkaz | Co 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 engines | Vypíš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=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 | Úlohy překladu na pozadí. | Zdarma |
wp tranzly legacy <action> [--format=<format>]wp tranzly legacy dry-runwp tranzly legacy runwp 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 setupwp 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=adminwp 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í.
| Funkce | Co 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(): string | Jazyk aktuálního požadavku (kód národního prostředí WordPressu, například `fr_FR`). | Free |
tranzly_default_language(): string | Výchozí jazyk: první v seznamu. | Free |
tranzly_get_engines(): array | Dostupné překladové enginy: id => název. | Free |
tranzly_get_post_language( int $post_id ): string | Jazyk, ve kterém je příspěvek napsán. | Free |
tranzly_get_term_language( int $term_id ): string | Jazyk, ve kterém je položka taxonomie napsána. | Free |
tranzly_get_term_translation( int $term_id, string $lang ): ?int | Překlad položky taxonomie do daného jazyka, případně null. | Free |
tranzly_get_term_translations( int $term_id ): array | Všechny verze položky taxonomie: kód jazyka => ID položky. | Free |
tranzly_get_translation( int $post_id, string $lang ): ?int | ID 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 ): array | Vš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 ): string | Adresa URL zobrazující daný jazyk. | Free |
tranzly_languages(): array | Jazyky 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(): bool | Vrátí zpět poslední tranzly_switch_language(). | Free |
tranzly_switch_language( string $lang ): bool | Spustí 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 ): array | Ná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.
| Hook | Typ | Popis činnosti | Parametry | Verze |
|---|---|---|---|---|
tranzly_admin_bar | Akce | Spouš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 $barint $id | Zdarma |
tranzly_admin_data | Filtr | Filtruje 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_model | Filtr | Filtruje 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 $target | Zdarma |
tranzly_ai_providers_in_use | Filtr | Filtruje 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_rebuild | Filtr | Filtruje 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 $contentstring $lang | Zdarma |
tranzly_copy_meta_keys | Filtr | Filtruje meta klíče zkopírované z příspěvku do jeho nového překladu. Nic jiného se nekopíruje. | int $source_id | Zdarma |
tranzly_deepl_host | Filtr | Filtruje hostitele DeepL API (proxy nebo testovací dvojník). | string $hoststring $key | Zdarma |
tranzly_deepl_price_per_million | Filtr | Filtruje cenu služby DeepL za milion znaků v amerických dolarech. | float $price | Zdarma |
tranzly_default_engine | Filtr | Filtruje ID překladače použitého v případě, kdy není žádný určen. | string $id | Zdarma |
tranzly_engine_cap | Filtr | Filtruje měsíční limit překladače v amerických dolarech: v bezplatném pluginu není žádný. | float|null $capstring $engine | Zdarma |
tranzly_engine_chain | Filtr | Filtruje 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 $langstring $first | Zdarma |
tranzly_engine_options | Filtr | Filtruje možnosti předávané překladači (seznam nepřekládaných výrazů, glosář, formálnost, instrukce). | string $targetEngine $engine | Zdarma |
tranzly_engine_settings_save | Filtr | Uklá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_prefix | Filtr | Filtruje neutrální předponu třídy pro frontend. | string $prefix | Zdarma |
tranzly_fs_loaded | Akce | Spouš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_options | Filtr | Filtruje 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 $lang | Zdarma |
tranzly_glossary_save | Filtr | Uklá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_million | Filtr | Filtruje cenu služby Google Cloud Translation za milion znaků v amerických dolarech. | float $price | Pro |
tranzly_install_language_packs | Filtr | Urč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 $install | Zdarma |
tranzly_integration_available | Filtr | Filtruje, 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 $onstring $id | Zdarma |
tranzly_integrations | Filtr | Filtruje integrace, které Tranzly spouští. Přidáním podtřídy `Integration` lze podpořit další plugin. | žádné | Zdarma |
tranzly_is_pro | Filtr | Filtruje, zda běží prémiová vrstva. Reaguje na něj pouze prémiová vrstva. | bool $pro | Zdarma |
tranzly_job_created | Akce | Spouští se po vytvoření úlohy překladu. | int $jobint $items | Zdarma |
tranzly_job_finished | Akce | Spustí se, když v úloze překladu nezbývá žádná práce. | int $job_id | Zdarma |
tranzly_kit_api_base | Filtr | Filtruje základní URL API Zinn Digital®, které volají obrazovky podpory. | string $base | Zdarma |
tranzly_kit_diagnostics | Filtr | Filtruje 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_free | Filtr | Filtruje, zda je tento web bez digitální stopy, takže na něm Zinn® Ads nejsou nikdy propagovány. | bool $footprint_free | Zdarma |
tranzly_kit_promotions | Filtr | Filtruje 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_tier | Filtr | Filtruje úroveň tarifu, kterou sada pro tento plugin hlásí (testy a staging; v produkci rozhoduje licence). | string $tier | Zdarma |
tranzly_localize_links | Filtr | Filtruje, zda Tranzly přesměruje interní odkazy této stránky na jejich překlady. | bool $localizestring $lang | Zdarma |
tranzly_memory_enabled | Filtr | Filtruje, zda se používá překladová paměť. | bool $on | Pro |
tranzly_microsoft_price_per_million | Filtr | Filtruje cenu služby Microsoft Translator za milion znaků v amerických dolarech. | float $price | Pro |
tranzly_network_enabled | Filtr | Filtruje, zda je zapnutá vrstva sítě multisite. | bool $agency | Zdarma |
tranzly_pbs_internal_post_types | Filtr | Filtruje typy příspěvků Page Builder Sandwich, které Tranzly ponechává beze změny. | žádné | Zdarma |
tranzly_post_segments | Filtr | Filtruje 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 $post | Zdarma |
tranzly_post_translated | Akce | Spustí se poté, co překladač přeložil příspěvek (nebo jej zapsal soubor od člověka či import). | int $targetint $source_idstring $codestring $engine | Zdarma |
tranzly_post_translation_created | Akce | Spustí se poté, co Tranzly vytvoří překlad příspěvku. | int $new_idint $source_idstring $code | Zdarma |
tranzly_post_types | Filtr | Filtruje typy příspěvků, které Tranzly překládá. | žádné | Zdarma |
tranzly_pre_current_language | Filtr | Př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 $lang | Zdarma |
tranzly_query_var | Filtr | Filtruje proměnnou dotazu, která vybírá jazyk. | string $var | Zdarma |
tranzly_queue_lease_seconds | Filtr | Filtruje 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 $seconds | Zdarma |
tranzly_queue_worker_seconds | Filtr | Filtruje, jak dlouho jeden proces běží před předáním dalšímu, v sekundách. | int $seconds | Zdarma |
tranzly_queue_workers | Filtr | Filtruje, 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 $workersint $job_id | Zdarma |
tranzly_rate_source_ | Filtr | Kurzy z jiného zdroje (viz `tranzly_rate_sources`). | žádné | Pro |
tranzly_rate_sources | Filtr | Filtruje 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_engines | Akce | Registrace překladových služeb. Volejte `$registry->add( new Your_Engine() )`. | Registry $registry | Zdarma |
tranzly_relations_changed | Akce | Spustí 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 $typearray<int> $ids | Zdarma |
tranzly_robots_meta_keys | Filtr | Filtruje 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_scopes | Filtr | Filtruje 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_strings | Filtr | Filtruje 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 $scope | Zdarma |
tranzly_shared_strings_covered | Filtr | Filtruje 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 $scopestring $lang | Zdarma |
tranzly_source_changed | Akce | Spouští se při změně přeložitelného obsahu originálu, takže jeho překlady jsou nyní zastaralé. | int $post_idstring $nowstring $before | Zdarma |
tranzly_source_meta_keys | Filtr | Filtruje 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_id | Zdarma |
tranzly_source_published | Akce | Spouští se jednou při prvním publikování originálu (po uložení jeho meta dat). | int $post_id | Zdarma |
tranzly_style_rules_enabled | Filtr | Urč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 $enabledstring $locale | Zdarma |
tranzly_taxonomies | Filtr | Filtruje taxonomie, které Tranzly překládá. | žádné | Zdarma |
tranzly_term_segments | Filtr | Filtruje 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 $term | Zdarma |
tranzly_term_translated | Akce | Spouš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 $targetint $term_idstring $code | Zdarma |
tranzly_term_translation_created | Akce | Spouští se po vytvoření překladu položky taxonomie v Tranzly. | int $new_idint $term_idstring $code | Zdarma |
tranzly_translatable_attributes | Filtr | Filtruje atributy, které Tranzly překládá pro daný typ bloku. | string $block_name | Zdarma |
tranzly_translate_string | Filtr | Filtruje jeden přeložitelný řetězec do jazyka. | string $valuestring $codearray $context | Zdarma |
tranzly_translated_post_fields | Filtr | Filtruje 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 $poststring $code | Zdarma |
tranzly_translation_memory | Filtr | Filtruje 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 $memory | Zdarma |