Разработчици
Справочник за възможностите на Tranzly
Tranzly регистрира своите действия в WordPress Abilities API. Същите възможности са MCP инструменти на собствения сървър на сайта и REST маршрути под /wp-json/wp-abilities/v1. Тази страница е генерирана от собствения регистър на разширението.
Крайни точки
| Възможност | REST |
|---|---|
| MCP през HTTP (поточно предаване) | /wp-json/tranzly/v1/mcp |
| MCP през WP-CLI (стандартен вход и изход) | wp mcp-adapter serve --server=tranzly --user=<login> |
| REST: списък с възможности | /wp-json/wp-abilities/v1/abilities?category=tranzly |
| REST: изпълнение на възможност | /wp-json/wp-abilities/v1/abilities/<name>/run (GET с ?input= за възможности само за четене, в противен случай POST {"input": {...}}) |
Удостоверяване и права за достъп
HTTP заявките се удостоверяват с парола за приложение в WordPress (HTTP Basic). Свързването към MCP сървъра изисква правото, показано по-долу; след това всяка възможност проверява собствените си права за всеки обект. Възможностите само за четене се изпълняват с GET и техните входящи данни в низа на заявката; останалите с POST и JSON тяло ‘{„input“: {…}}’.
парола за приложение в WordPress (HTTP) или --user (WP-CLI); потребителят се нуждае от правото, посочено от всяка възможност · Настройки: Разрешаване на AI агенти (MCP), включено по подразбиране
Всички възможности
| Възможност | Издание | REST | Права | Параметри |
|---|---|---|---|---|
tranzly/bulk-translateСтартира фонови задачи за превод за всеки оригинал от посочените типове съдържание (всички превеждани типове, ако не са посочени конкретни): липсващите преводи, остарелите или всички. Връща стартираните задачи, по една за всеки език. | Pro | POST /wp-json/wp-abilities/v1/abilities/tranzly/bulk-translate/run | edit_posts; publish_posts за публикуване | languages масив (задължителен)post_types масивscope низ: missing, stale, allengine низpublish булев |
tranzly/cancel-jobСпира задача; вече направените преводи се запазват. | Безплатно | POST /wp-json/wp-abilities/v1/abilities/tranzly/cancel-job/run | manage_options (собствена проверка на REST маршрута) | id низ (задължителен) |
tranzly/check-qualityИзползва изкуствен интелект за сравняване на даден превод с оригинала му и оценяването му, след което записва доклада към превода. Използва модела за проверка на качеството с ИИ, зададен в настройките на работния процес на Tranzly. | Pro | POST /wp-json/wp-abilities/v1/abilities/tranzly/check-quality/run | edit_post за съответния превод | id цяло число (задължително) |
tranzly/connect-supportСвързва сайта с поддръжката на Zinn Digital® (име, имейл, съгласие). | Безплатно | POST /wp-json/wp-abilities/v1/abilities/tranzly/connect-support/run | manage_options (собствена проверка на REST маршрута) | email низ (задължителен)name низconsent булев (задължителен) |
tranzly/correct-segmentsЗапазва коригираните сегменти от даден превод (сегменти: ключ към текст); коригираният текст е защитен от повторно превеждане. | Безплатно | POST /wp-json/wp-abilities/v1/abilities/tranzly/correct-segments/run | edit_post (собствена проверка на REST маршрута) | id низ (задължителен)segments обектtexts обект |
tranzly/create-jobСтартира фонова задача за превод на изброените публикации (posts) или на цял тип публикация на избраните езици (langs). | Безплатно | POST /wp-json/wp-abilities/v1/abilities/tranzly/create-job/run | edit_posts (собствена проверка на REST маршрута) | posts масивpost_type низlangs масив (задължителен)engine низstatus низ: publish, draftforce булев |
tranzly/create-post-translationСъздава чернова на превод на публикация на даден език (lang) за ръчно въвеждане, без преводаческа система. | Безплатно | POST /wp-json/wp-abilities/v1/abilities/tranzly/create-post-translation/run | собствена проверка на правата за всеки елемент от REST маршрута | id низ (задължителен)lang низ (задължителен)name низslug низdescription низ |
tranzly/create-term-translationСъздава превод на таксономичен термин на даден език с посочени от вас име, калибър (slug) и описание. | Безплатно | POST /wp-json/wp-abilities/v1/abilities/tranzly/create-term-translation/run | собствена проверка на правата за всеки елемент от REST маршрута | id низ (задължителен)lang низ (задължителен)name низslug низdescription низ |
tranzly/disconnect-supportПрекъсва връзката на сайта с поддръжката. | Безплатно | POST /wp-json/wp-abilities/v1/abilities/tranzly/disconnect-support/run | manage_options (собствена проверка на REST маршрута) | няма |
tranzly/estimateИзчислява приблизителния брой знаци и цената за превод на публикации (posts или post_type) на избраните езици (langs) с дадена преводаческа система, преди да правите разходи. | Безплатно | POST /wp-json/wp-abilities/v1/abilities/tranzly/estimate/run | edit_posts (собствена проверка на REST маршрута) | posts масивpost_type низlangs масив (задължителен)engine низ |
tranzly/estimate-bulkИзчислява предварително превода на целия сайт на даден език (post_types, scope, engine), преди да го стартирате. | Pro | POST /wp-json/wp-abilities/v1/abilities/tranzly/estimate-bulk/run | edit_posts (собствена проверка на REST маршрута) | post_types масивscope низ: missing, stale, allengine низlang низ (задължителен)after цяло число |
tranzly/export-translation-fileВръща XLIFF или CSV файл (като текст) с оригиналите и техните преводи на един език за преводач или агенция за преводи: посочените публикации или страница с до 100 оригинала от тип съдържание в определено състояние (missing, stale, translated или all; повторение с after). Същият файл може да бъде внесен обратно след превода. | Pro | GET /wp-json/wp-abilities/v1/abilities/tranzly/export-translation-file/run | edit_posts; всяка публикация се включва само ако потребителят има право да я редактира | lang низ (задължителен)format низ: xliff, csvposts масивpost_type низstate низ: all, missing, stale, translatedafter цяло число |
tranzly/fix-statusДобавя на опашката за превод всеки липсващ (или остарял) елемент за даден език и тип публикация. | Безплатно | POST /wp-json/wp-abilities/v1/abilities/tranzly/fix-status/run | edit_posts (собствена проверка на REST маршрута) | post_type низlang низ (задължително)state низ (задължително): missing, stale, quality |
tranzly/get-comments-settingВръща дали коментарите се споделят между езиците, или се пазят поотделно за всеки език. | Pro | GET /wp-json/wp-abilities/v1/abilities/tranzly/get-comments-setting/run | moderate_comments (собствена проверка на REST маршрута) | няма |
tranzly/get-deepl-usageВръща използваните символи и лимита на запазения DeepL ключ за този месец. | Безплатно | GET /wp-json/wp-abilities/v1/abilities/tranzly/get-deepl-usage/run | manage_options (собствена проверка на REST маршрута) | няма |
tranzly/get-diagnosticsВръща диагностичните данни за билет за поддръжка: версии, активни разширения, лимити и скорошни грешки. | Безплатно | GET /wp-json/wp-abilities/v1/abilities/tranzly/get-diagnostics/run | manage_options (собствена проверка на REST маршрута) | няма |
tranzly/get-displayВръща настройките за показване на превключвателя за езици и признанията за авторство. | Безплатно | GET /wp-json/wp-abilities/v1/abilities/tranzly/get-display/run | manage_options (собствена проверка на REST маршрута) | няма |
tranzly/get-engine-settingsВръща основния и резервния модул, модулите по езици и AI моделите, състоянието на всеки модул, свързаните AI доставчици с техните модели и разходите за този месец. | Безплатно | GET /wp-json/wp-abilities/v1/abilities/tranzly/get-engine-settings/run | manage_options (собствена проверка на REST маршрута) | няма |
tranzly/get-glossaryВръща думите, които никога не се превеждат, установените преводи на термини и тона за всеки език. | Pro | GET /wp-json/wp-abilities/v1/abilities/tranzly/get-glossary/run | manage_options | няма |
tranzly/get-integrationsИзвежда списък с разширенията за SEO, WooCommerce, визуални редактори и формуляри, поддържани от Tranzly, които са активни тук. | Безплатно | GET /wp-json/wp-abilities/v1/abilities/tranzly/get-integrations/run | manage_options (собствена проверка на REST маршрута) | няма |
tranzly/get-jobВръща напредъка и броячите за дадена задача. | Безплатно | GET /wp-json/wp-abilities/v1/abilities/tranzly/get-job/run | manage_options (собствена проверка на REST маршрута) | id низ (задължително) |
tranzly/get-job-failuresИзвежда неуспешните елементи от дадена задача заедно с причината за всеки от тях. | Безплатно | GET /wp-json/wp-abilities/v1/abilities/tranzly/get-job-failures/run | manage_options (собствена проверка на REST маршрута) | id низ (задължително) |
tranzly/get-legacy-importВръща състоянието и доклада от внасянето на преводи от Tranzly 2.x. | Безплатно | GET /wp-json/wp-abilities/v1/abilities/tranzly/get-legacy-import/run | manage_options (собствена проверка на REST маршрута) | няма |
tranzly/get-licenceВръща плана на Tranzly за сайта, състоянието на лиценза, датата на подновяване и включеното в плана. | Безплатно | GET /wp-json/wp-abilities/v1/abilities/tranzly/get-licence/run | manage_options (собствена проверка на REST маршрута) | няма |
tranzly/get-menusВръща кое меню се показва за всеки език във всяка позиция за меню. | Безплатно | GET /wp-json/wp-abilities/v1/abilities/tranzly/get-menus/run | edit_theme_options (собствена проверка на REST маршрута) | няма |
tranzly/get-post-groupИзвежда преводната група на публикация: записа за всеки език със заглавие, статус и връзка за редактиране. | Безплатно | GET /wp-json/wp-abilities/v1/abilities/tranzly/get-post-group/run | edit_post и edit_term (собствена проверка на REST маршрута) | id низ (задължително) |
tranzly/get-quality-reportВръща AI доклада за качество на превода: оценка и отбелязаните сегменти. | Pro | GET /wp-json/wp-abilities/v1/abilities/tranzly/get-quality-report/run | edit_post (собствена проверка на REST маршрута) | id низ (задължително) |
tranzly/get-segmentsВръща сегментите на превода редом с оригинала за преглед и корекция. | Безплатно | GET /wp-json/wp-abilities/v1/abilities/tranzly/get-segments/run | edit_post (собствена проверка на REST маршрута) | id низ (задължително) |
tranzly/get-shared-stringsВръща текстовете от темата и разширенията (обхват) на даден език заедно с техните преводи. | Безплатно | GET /wp-json/wp-abilities/v1/abilities/tranzly/get-shared-strings/run | edit_theme_options (собствена проверка на REST маршрута) | lang низ (задължително)scope низ: menus, site, templates, gettext.plugin-<slug>, gettext.theme-<slug> |
tranzly/get-site-stringsВръща заглавието на сайта, краткото описание и текстовете от уиджетите на даден език. | Безплатно | GET /wp-json/wp-abilities/v1/abilities/tranzly/get-site-strings/run | manage_options (собствена проверка на REST маршрута) | lang низ (задължително) |
tranzly/get-support-connectionПоказва дали сайтът е свързан с поддръжката на Zinn Digital® и от кое име. | Free | GET /wp-json/wp-abilities/v1/abilities/tranzly/get-support-connection/run | manage_options (собствена проверка на REST маршрута) | refresh boolean |
tranzly/get-term-groupПоказва групата за превод на дадена категория или етикет. | Free | GET /wp-json/wp-abilities/v1/abilities/tranzly/get-term-group/run | edit_post и edit_term (собствена проверка на REST маршрута) | id string (задължително) |
tranzly/get-urlsВръща начина на изписване на езиците в адресите (папка, поддомейн или домейн), преведените кратки имена (slugs) и бази, както и noindex за непреведените страници. | Free | GET /wp-json/wp-abilities/v1/abilities/tranzly/get-urls/run | manage_options (собствена проверка на REST маршрута) | няма |
tranzly/get-workflow-settingsВръща настройките за автоматичен превод при публикуване и обновяване, преглед преди публикуване, както и прага, доставчика и модела за проверка на качеството чрез изкуствен интелект. | Pro | GET /wp-json/wp-abilities/v1/abilities/tranzly/get-workflow-settings/run | manage_options (собствена проверка на REST маршрута) | няма |
tranzly/import-from-sourceВнася следващата страница с преводи от друг плъгин за многоезичност (режим: dry-run или run; cursor). | Pro | POST /wp-json/wp-abilities/v1/abilities/tranzly/import-from-source/run | manage_options (собствена проверка на REST маршрута) | source string (задължително)mode string: dry-run, run, undocursor string |
tranzly/import-translation-fileЗаписва следващата страница с публикации от качен файл с преводи (повтаря се с after до завършване). | Pro | POST /wp-json/wp-abilities/v1/abilities/tranzly/import-translation-file/run | edit_posts (собствена проверка на REST маршрута) | token string (задължително)after integer |
tranzly/link-postЗадава съществуваща публикация (target) като превод на тази публикация на съответния език. | Free | POST /wp-json/wp-abilities/v1/abilities/tranzly/link-post/run | edit_post и edit_term (собствена проверка на REST маршрута) | id string (задължително)lang string (задължително)target integer (задължително) |
tranzly/link-termЗадава съществуващ таксономичен термин (target) като превод на този термин на съответния език. | Free | POST /wp-json/wp-abilities/v1/abilities/tranzly/link-term/run | edit_post и edit_term (собствена проверка на REST маршрута) | id string (задължително)lang string (задължително)target integer (задължително) |
tranzly/list-enginesИзвежда списък с платформите за превод, състоянието на настройката им и коя се използва по подразбиране. | Free | GET /wp-json/wp-abilities/v1/abilities/tranzly/list-engines/run | edit_posts | няма |
tranzly/list-import-sourcesИзвежда откритите на сайта данни от WPML, Polylang и TranslatePress, които могат да бъдат внесени. | Pro | GET /wp-json/wp-abilities/v1/abilities/tranzly/list-import-sources/run | manage_options (собствена проверка на REST маршрута) | няма |
tranzly/list-jobsПоказва фоновите задачи за превод, започвайки от най-новите, с информация за напредъка. | Free | GET /wp-json/wp-abilities/v1/abilities/tranzly/list-jobs/run | edit_posts (собствена проверка на REST маршрута) | няма |
tranzly/list-languagesПоказва езиците на сайта. Първият е езикът, на който е написано оригиналното съдържание. | Free | GET /wp-json/wp-abilities/v1/abilities/tranzly/list-languages/run | edit_posts | няма |
tranzly/list-status-itemsИзвежда оригиналите с тяхното състояние на превод за даден език (състояние: missing, stale, current), страница по страница. | Free | GET /wp-json/wp-abilities/v1/abilities/tranzly/list-status-items/run | edit_posts (собствена проверка на REST маршрута) | post_type stringlang string (задължително)state string: all, missing, stale, translated, human, machine, review, qualityafter integer |
tranzly/list-theme-stringsИзвежда списък с темите и плъгините, чиито текстове могат да се сканират за превод, както и броя низове във всеки от тях. | Pro | GET /wp-json/wp-abilities/v1/abilities/tranzly/list-theme-strings/run | manage_options (собствена проверка на REST маршрута) | няма |
tranzly/open-support-ticketПодава запитване за поддръжка (subject, message, kind, email) заедно с диагностичните данни на сайта, ако администраторът е дал съгласие. Никога не създава и не изпраща данни за вход. | Free | POST /wp-json/wp-abilities/v1/abilities/tranzly/open-support-ticket/run | manage_options (собствена проверка на REST маршрута) | subject string (задължително)message string (задължително)kind string: help, bug, feedback, feature_requestemail stringname stringdiagnostics boolean |
tranzly/record-support-consentЗаписва съгласието на администратора за изпращане на диагностични данни със запитванията за поддръжка. | Free | POST /wp-json/wp-abilities/v1/abilities/tranzly/record-support-consent/run | manage_options (собствена проверка на REST маршрута) | consent boolean (задължително) |
tranzly/retry-job-itemПовтаря неуспешен елемент (action: retry, по желание с друг модул) или го маркира за ръчен превод (action: by-hand). | Безплатна | POST /wp-json/wp-abilities/v1/abilities/tranzly/retry-job-item/run | edit_post и manage_options (собствена проверка на REST маршрута) | item низ (задължително)action низ (задължително)engine низ |
tranzly/review-translationОдобрява превод (и го публикува при публикуван оригинал) или го връща за редакция (decision, note). | Pro | POST /wp-json/wp-abilities/v1/abilities/tranzly/review-translation/run | edit_post (собствена проверка на REST маршрута) | id низ (задължително)decision низ (задължително): approve, changes, pendingnote низ |
tranzly/run-legacy-importИзпълнява импортирането от версия 2.x: пробно пускане (dry-run, само отчет), изпълнение или отмяна. | Безплатна | POST /wp-json/wp-abilities/v1/abilities/tranzly/run-legacy-import/run | manage_options (собствена проверка на REST маршрута) | action низ (задължително) |
tranzly/scan-theme-stringsСканира следващата страница от PHP файловете на даден компонент за текстове за превод (повтаря се с after до завършване). | Pro | POST /wp-json/wp-abilities/v1/abilities/tranzly/scan-theme-strings/run | manage_options (собствена проверка на REST маршрута) | component низ (задължително)after цяло число |
tranzly/schedule-quality-checkПланира проверка на качеството с изкуствен интелект на следващата страница от преводите за даден език (или на посочените публикации). | Pro | POST /wp-json/wp-abilities/v1/abilities/tranzly/schedule-quality-check/run | edit_posts (собствена проверка на REST маршрута) | lang низ (задължително)post_type низposts масивafter цяло число |
tranzly/seo-auditПроверява преводите за липсващи SEO заглавия, описания, адреси и hreflang на даден език, страница по страница. | Pro | GET /wp-json/wp-abilities/v1/abilities/tranzly/seo-audit/run | manage_options (собствена проверка на REST маршрута) | lang низ (задължително)after цяло число |
tranzly/set-comments-settingСподеля коментарите между преводите на публикацията или ги запазва отделно за всеки език (mode). | Pro | POST /wp-json/wp-abilities/v1/abilities/tranzly/set-comments-setting/run | manage_options и moderate_comments (собствена проверка на REST маршрута) | mode низ (задължително): off, show, translate |
tranzly/set-engine-keyЗапазва API ключа (и региона за Microsoft) за DeepL, Google или Microsoft; празна стойност го премахва. Ключовете се съхраняват криптирани и никога не се връщат като отговор. | Безплатна | POST /wp-json/wp-abilities/v1/abilities/tranzly/set-engine-key/run | manage_options (собствена проверка на REST маршрута) | engine низ (задължително)key низ (задължително)region низ |
tranzly/set-menusЗадава меню за всеки език по местоположение (map). | Безплатна | POST /wp-json/wp-abilities/v1/abilities/tranzly/set-menus/run | edit_theme_options (собствена проверка на REST маршрута) | map обект (задължително) |
tranzly/set-protectionЗащитава превод от презаписване от модула (protected: true) или премахва защитата му. | Безплатна | POST /wp-json/wp-abilities/v1/abilities/tranzly/set-protection/run | edit_post (собствена проверка на REST маршрута) | id низ (задължително)protected булева стойност (задължително) |
tranzly/set-shared-stringsЗапазва коригирани преводи на текстове от теми и разширения (strings); те стават защитени. | Безплатна | POST /wp-json/wp-abilities/v1/abilities/tranzly/set-shared-strings/run | edit_theme_options (собствена проверка на REST маршрута) | lang низ (задължително)scope низ: menus, site, templates, gettext.plugin-<slug>, gettext.theme-<slug>strings обект (задължително) |
tranzly/set-site-stringЗапазва един текст на сайта (key) на даден език, напр. заглавието или описанието на сайта. | Безплатна | POST /wp-json/wp-abilities/v1/abilities/tranzly/set-site-string/run | edit_theme_options и manage_options (собствена проверка на REST маршрута) | lang низ (задължително)key низ (задължително)translation низ (задължително) |
tranzly/set-urlsЗадава режима за адреси (mode), домейните за всеки език, преведените основи и сегменти, noindex_untranslated и предложенията за адреси. | Безплатна | POST /wp-json/wp-abilities/v1/abilities/tranzly/set-urls/run | manage_options (собствена проверка на REST маршрута) | mode низsegments обектdomains обектbases обектsuggest булева стойностnoindex_untranslated булева стойност |
tranzly/start-trialСтартира 14-дневен пробен период за Tranzly Pro за този сайт (не се изисква плащане). | Безплатна | POST /wp-json/wp-abilities/v1/abilities/tranzly/start-trial/run | manage_options (собствена проверка на REST маршрута) | няма |
tranzly/translate-media-fieldЗапазва алтернативния текст, заглавието или описанието на изображение (field) на даден език (lang). | Безплатно | POST /wp-json/wp-abilities/v1/abilities/tranzly/translate-media-field/run | edit_post (собствена проверка на REST маршрута) | id низ (задължително)lang низ (задължително)field низ (задължително): alt, caption, titletranslation низ (задължително) |
tranzly/translate-postПревежда публикация или страница на един или повече от езиците на сайта чрез механизъм за превод, като създава или обновява всеки превод. Новите преводи са чернови, освен ако publish не е true. Превод, редактиран от човек, се пропуска, освен ако force не е true. | Безплатно | POST /wp-json/wp-abilities/v1/abilities/tranzly/translate-post/run | право на превод на публикацията (edit_post за нея); edit_post за съществуващ превод; право за публикуване на съответния тип съдържание за публикуване | id цяло число (задължително)languages масив (задължително)engine низpublish булева стойностforce булева стойност |
tranzly/translate-shared-stringsПревежда следващата страница с непреведени текстове от тема и разширения на даден език чрез механизма по подразбиране (повтаря се с after до завършване). | Безплатно | POST /wp-json/wp-abilities/v1/abilities/tranzly/translate-shared-strings/run | edit_theme_options (собствена проверка на REST маршрута) | lang низ (задължително)scope низ: menus, site, templates, gettext.plugin-<slug>, gettext.theme-<slug>after цяло число |
tranzly/translate-siteВоден процес: агентът проверява езиците и механизма, изчислява стойността и превежда липсващото съдържание, като иска потвърждение преди разход или публикуване. | Безплатно | POST /wp-json/wp-abilities/v1/abilities/tranzly/translate-site/run | edit_posts | languages низ (задължително) |
tranzly/translate-termПревежда таксономия (категория, етикет или атрибут на продукт) на даден език (lang) чрез даден механизъм, като създава или обновява превода. | Безплатно | POST /wp-json/wp-abilities/v1/abilities/tranzly/translate-term/run | собствена проверка на правата за всеки елемент на REST маршрута | id низ (задължително)lang низ (задължително)engine низforce булева стойностstatus низ: publish, draft |
tranzly/translation-statusПри подаден идентификатор на публикация: преводът на публикацията за всеки език, дали е остарял и кой го е написал. Без идентификатор: обем на преведения сайт по езици. | Безплатно | GET /wp-json/wp-abilities/v1/abilities/tranzly/translation-status/run | edit_post за съответната публикация; edit_posts за обобщението на сайта | id цяло числоpost_type низ |
tranzly/unlink-postИзважда публикация от преводната ѝ група; публикацията запазва езика си. | Безплатно | POST /wp-json/wp-abilities/v1/abilities/tranzly/unlink-post/run | edit_post и edit_term (собствена проверка на REST маршрута) | id низ (задължително) |
tranzly/unlink-termИзважда таксономия от преводната ѝ група. | Безплатно | POST /wp-json/wp-abilities/v1/abilities/tranzly/unlink-term/run | edit_post и edit_term (собствена проверка на REST маршрута) | id низ (задължително) |
tranzly/update-displayПроменя превключвателя (стил, знамена, имена, разположение) и реда с авторски права. | Безплатно | POST /wp-json/wp-abilities/v1/abilities/tranzly/update-display/run | manage_options (собствена проверка на REST маршрута) | switcher обектcredit булева стойност |
tranzly/update-engine-settingsЗадава механизма по подразбиране, резервния механизъм, механизмите по езици и AI моделите по езици (default, fallback, per_lang, models, caps). Всичко освен механизма по подразбиране е част от Pro. | Безплатно | POST /wp-json/wp-abilities/v1/abilities/tranzly/update-engine-settings/run | manage_options (собствена проверка на REST маршрута) | default низper_lang обектfallback масивcaps обектmodels обект |
tranzly/update-glossaryЗамества изпратените части от речника (непревеждани думи, преводи на термини, тон); пропуснатите части се запазват. Използва се от всеки механизъм от следващия превод нататък. | Pro | POST /wp-json/wp-abilities/v1/abilities/tranzly/update-glossary/run | manage_options | dnt масивterms обектtone обект |
tranzly/update-settingsЗадава езиците на сайта (languages: списък с код и име; първият е оригиналният език), префикса на класовете за лицевата част и дали се разрешават AI агенти (MCP). | Безплатно | POST /wp-json/wp-abilities/v1/abilities/tranzly/update-settings/run | manage_options (собствена проверка на REST маршрута) | prefix низmcp булева стойностlanguages масив |
tranzly/update-workflow-settingsЗадава on_update (off, stale, translate), on_publish, review, quality_threshold, quality_provider и quality_model. | Pro | POST /wp-json/wp-abilities/v1/abilities/tranzly/update-workflow-settings/run | manage_options (собствена проверка на маршрута на REST) | on_update низ: off, stale, translateon_publish булева стойностreview булева стойностquality_threshold цяло числоquality_provider низquality_model низ |
tranzly/upload-translation-fileКачва Tranzly XLIFF или CSV файл (съдържание, име на файл), преведен на друго място; връща токен, който идентифицира качването за импортирането. | Pro | POST /wp-json/wp-abilities/v1/abilities/tranzly/upload-translation-file/run | edit_posts (собствена проверка на маршрута на REST) | content низ (задължително)filename низ (задължително) |
Генерирано от abilities.json на разширението, който сам по себе си е генериран от работещ сайт; даден тест се проваля, когато двете се различават.
WP-CLI команди
Изпълнете ги на сървъра с WP-CLI. Всяка команда проверява същите права като екраните на разширението; примерите са взети от собствения помощен текст на разширението.
| Команда | Какво прави | Издание |
|---|---|---|
wp tranzly create <id> [--term]wp tranzly create 42 --lang=de_DE --user=admin | Създаване на чернова превод на публикация (или термин), свързана с нея. | Безплатно |
wp tranzly engines | Извеждане на списък с двигателите за превод. | Безплатно |
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 | Фонови задачи за превод. | Безплатно |
wp tranzly legacy <action> [--format=<format>]wp tranzly legacy dry-runwp tranzly legacy runwp tranzly legacy undo | Показване, тестово изпълнение (dry-run), стартиране или отмяна на импортирането на преводи от наследен сайт на Tranzly (2.x). | Безплатно |
wp tranzly link <source> <target> [--term] | Свързване на съществуваща публикация (или термин) като превод на друга. | Безплатно |
wp tranzly network <action> [--languages=<codes>]wp tranzly network setupwp tranzly network languages --languages=en_US,de_DE,fr_FR | Multisite (Агенция): конфигуриране на всеки сайт от мрежата или задаване на езиците, с които започват новите сайтове. | Безплатно |
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 | Превеждане на публикации чрез двигател. | Безплатно |
wp tranzly translations <id> [--term] [--format=<format>] | Извеждане на списък с преводите на публикация (или термин). | Безплатно |
PHP функции
Функции, които темите и другите разширения могат да извикват. Първо проверете с function_exists(), за да продължи кодът ви да работи, докато разширението е неактивно.
| Функция | Действие | Издание |
|---|---|---|
icl_object_id( $id, $type = 'post', $return_original_if_missing = false, $lang = null ) | WPML: превод на обект. | Pro |
pll__( $text ) | Polylang: регистриран низ, преведен. Tranzly превежда низовете на темите чрез собствения gettext на WordPress, така че низът се връща както е подаден. | Pro |
pll_current_language( $field = 'slug' ) | Polylang: текущият език. | Pro |
pll_default_language( $field = 'slug' ) | Polylang: езикът по подразбиране. | Pro |
pll_e( $text ) | Polylang: извеждане на регистриран низ с екраниране. | Pro |
pll_get_post( $post_id, $lang = null ) | Polylang: превод на публикация. | Pro |
pll_get_post_language( $post_id, $field = 'slug' ) | Polylang: езикът на публикацията. | Pro |
pll_get_post_translations( $post_id ) | Polylang: всички преводи на публикация, slug => ID. | Pro |
pll_get_term( $term_id, $lang = null ) | Polylang: превод на термин. | Pro |
pll_get_term_language( $term_id, $field = 'slug' ) | Polylang: езикът на термина. | Pro |
pll_get_term_translations( $term_id ) | Polylang: всички преводи на термин, slug => ID. | Pro |
pll_home_url( $lang = '' ) | Polylang: адресът на началната страница на определен език. | Pro |
pll_is_translated_post_type( $post_type ) | Polylang: превежда ли се този тип публикация? | Pro |
pll_is_translated_taxonomy( $taxonomy ) | Polylang: превежда ли се тази таксономия? | Pro |
pll_languages_list( $args = array( ) | Polylang: езиците. | Pro |
pll_register_string() | Polylang: регистрация на низ (приема се и се игнорира — вижте pll__()). | Pro |
pll_the_languages( $args = array( ) | Polylang: превключвателят на езици. `raw` връща масива на Polylang (slug => подробности); в противен случай се връща списък `<li>` в синтаксиса на Polylang, който се извежда директно, освен ако `echo` не е 0. Зачита `hide_current`, `hide_if_no_translation` и `display_names_as` (`name` или `slug`). Стойността `dropdown` се визуализира като списък: за падащо меню използвайте собствения блок/уиджет за превключване на Tranzly. | Pro |
pll_translate_string( $text ) | Polylang: регистриран низ на даден език. Както при pll__(), низът се връща както е подаден. | Pro |
tranzly_compat_field( string $code, string $field ) | Едно поле на език по терминологията на Polylang. | Pro |
tranzly_current_language(): string | Езикът на текущата заявка (код на локала в WordPress, например `fr_FR`). | Free |
tranzly_default_language(): string | Езикът по подразбиране: първият в списъка. | Free |
tranzly_get_engines(): array | Наличните системи: id => име. | Free |
tranzly_get_post_language( int $post_id ): string | Езикът, на който е написана публикацията. | Free |
tranzly_get_term_language( int $term_id ): string | Езикът, на който е записан терминът. | Free |
tranzly_get_term_translation( int $term_id, string $lang ): ?int | Преводът на термин на даден език или null. | Free |
tranzly_get_term_translations( int $term_id ): array | Всички версии на термин: код на езика => ID на термина. | Free |
tranzly_get_translation( int $post_id, string $lang ): ?int | ID на превода на публикация на даден език или null, ако няма такъв. Връща собственото ID на публикацията, когато тя вече е написана на този език. | Free |
tranzly_get_translations( int $post_id ): array | Всички версии на публикация, включително самата тя: код на езика => ID на публикацията. Публикация без преводи връща само себе си на съответния език. | Free |
tranzly_language_switcher( array $args = array( ) | HTML код за превключвател на езици за всяка тема, редактор или разширение (T5). Елементът на Page Builder Sandwich го извиква; вашият код също може да го направи. Остава празен, когато има по-малко от два езика. | Free |
tranzly_language_url( string $lang, ?string $url = null ): string | Адрес, показващ посочения език. | Free |
tranzly_languages(): array | Езиците на сайта, като първи е този по подразбиране. | Free |
tranzly_register_engine( Engine $engine ) | Добавяне на система за превод. Извиква се при `tranzly_register_engines` или по всяко време преди първия превод от заявката. | Free |
tranzly_restore_language(): bool | Отмяна на последното изпълнение на tranzly_switch_language(). | Free |
tranzly_switch_language( string $lang ): bool | Изпълнение на код на друг език до извикване на tranzly_restore_language(): текущият език и собствените преводи на WordPress се превключват едновременно. Влага се подобно на switch_to_blog(): | Free |
tranzly_translatable_attributes( string $block_name ): array | Имената на атрибутите, които Tranzly превежда за даден тип блок: `role: content` в неговия block.json, прецизиран от филтъра `tranzly_translatable_attributes`. | Free |
tranzly_translate_post( int $post_id, string $lang, string $engine = '', array $args = array( ) | Превод на публикация на определен език чрез избран механизъм, от името на текущия потребител (прилагат се неговите права). | Безплатно |
Действия и филтри
Всяка кука, която разширението предлага, с описанието от неговия изходен код. Филтрите променят стойност; действията ви позволяват да изпълнявате код в даден момент; входните точки са действия, които задействате, за да поискате от разширението да направи нещо.
| Кука | Вид | Действие | Параметри | Издание |
|---|---|---|---|---|
tranzly_admin_bar | Действие | Задейства се след изграждането на менюто за преводи в лентата за управление (визуалният редактор в Pro добавя елемента „Превод на тази страница“ тук). | \WP_Admin_Bar $barint $id | Безплатно |
tranzly_admin_data | Филтър | Филтрира данните, с които се зарежда административният панел. Платената версия го използва, за да оповести своето издание; тук не бива да има поверителни данни, тъй като се извеждат директно в страницата. | няма | Безплатно |
tranzly_ai_model | Филтър | Филтрира доставчика и модела с изкуствен интелект, превеждащи на даден език. В безплатната версия: доставчикът и моделът, избрани за задачата `translate`, за всички езици. В Tranzly Pro: избраните специално за езика, а при липса – изборът за „всички останали езици“. | string $target | Безплатно |
tranzly_ai_providers_in_use | Филтър | Филтрира доставчиците на изкуствен интелект, избрани за конкретни езици. В безплатния разширител няма такива: всеки език използва доставчика и модела, избрани за задачата `translate`. Tranzly Pro извежда доставчиците на моделите за отделните езици. | няма | Безплатно |
tranzly_content_before_rebuild | Филтър | Филтрира изходното съдържание непосредствено преди преведените сегменти да бъдат записани в него, за всеки език поотделно (използва се от функцията за подмяна на изображения по езици в Pro). | string $contentstring $lang | Безплатно |
tranzly_copy_meta_keys | Филтър | Филтрира мета ключовете, които се копират от публикация към нейния нов превод. Нищо друго не се копира. | int $source_id | Безплатно |
tranzly_deepl_host | Филтър | Филтрира хоста за API на DeepL (прокси или дублиращ тестов сървър). | string $hoststring $key | Безплатно |
tranzly_deepl_price_per_million | Филтър | Филтрира цената на DeepL за милион знака в щатски долари. | float $price | Безплатно |
tranzly_default_engine | Филтър | Филтрира идентификатора (ID) на машината, която се използва, когато не е посочена друга. | string $id | Безплатно |
tranzly_engine_cap | Филтър | Филтрира месечния лимит на машина в щатски долари: в безплатния разширител няма такъв. | float|null $capstring $engine | Безплатно |
tranzly_engine_chain | Филтър | Филтрира машините, които да бъдат изпробвани за даден език, по реда на подредбата им. В безплатната версия: машината по подразбиране. Платената версия добавя собствената машина на езика и резервния списък. | string $langstring $first | Безплатно |
tranzly_engine_options | Филтър | Филтрира опциите, подавани към машината (списък с фрази без превод, речник, стил на изказване, инструкции). | string $targetEngine $engine | Безплатно |
tranzly_engine_settings_save | Филтър | Запазва машините и моделите с изкуствен интелект по езици, резервния списък и месечните лимити. Обработва се само от платената версия (насока 5 на WordPress.org: без Pro функционалност в безплатния разширител). | няма | Безплатно |
tranzly_frontend_prefix | Филтър | Филтрира неутралния префикс на класовете за лицевата част на сайта. | string $prefix | Безплатно |
tranzly_fs_loaded | Действие | Задейства се след зареждане на SDK за лицензиране (в основния файл, преди какъвто и да е код на Tranzly). Закачете се тук за комуникация с `tranzly_fs()`. | няма | Безплатно |
tranzly_glossary_options | Филтър | Филтрира опциите на машината за целеви език: списъка с фрази без превод, плюс речника и тона на изказ, когато са добавени от платената версия. | string $lang | Безплатно |
tranzly_glossary_save | Филтър | Запазва предпочитаните преводи и тона на изказ по езици. Обработва се само от платената версия (насока 5 на WordPress.org: без Pro функционалност в безплатния разширител). | няма | Безплатно |
tranzly_google_price_per_million | Филтър | Филтрира цената на Google Cloud Translation за милион знака в щатски долари. | float $price | Pro |
tranzly_install_language_packs | Филтър | Определя дали Tranzly инсталира езиковите пакети за WordPress, темата и разширенията за език, добавен към сайта (за да се показват системните съобщения на WordPress и WooCommerce в превод). Включено по подразбиране. | bool $install | Безплатно |
tranzly_integration_available | Филтър | Филтрира дали дадена интеграция да се изпълнява, когато съответният ѝ разширител не е открит – полезно за съдържание, оставено от визуален редактор след изключването му, или разширител, зареден по нестандартен начин. | bool $onstring $id | Безплатно |
tranzly_integrations | Филтър | Филтрира интеграциите, изпълнявани от Tranzly. Добавете подклас на `Integration` за поддръжка на друг разширител. | няма | Безплатно |
tranzly_is_pro | Филтър | Филтрира дали платената версия е активна. Обработва се единствено от нея. | bool $pro | Безплатно |
tranzly_job_created | Действие | Задейства се след създаване на задача за превод. | int $jobint $items | Безплатно |
tranzly_job_finished | Действие | Задейства се, когато в дадена задача за превод няма останала работа. | int $job_id | Безплатна |
tranzly_kit_api_base | Филтър | Филтрира базовия адрес на API на Zinn Digital®, извикван от екраните за поддръжка. | string $base | Безплатна |
tranzly_kit_diagnostics | Филтър | Филтрира диагностичните данни, преди собственикът на сайта да ги види. Разширение добавя свои собствени факти в `extra`. ⛔ Изпълнява се ПРЕДИ предварителен преглед, никога между прегледа и изпращането. | няма | Безплатна |
tranzly_kit_footprint_free | Филтър | Филтрира дали сайтът е без следи (footprint-free), така че Zinn® Ads никога да не се промотира в него. | bool $footprint_free | Безплатна |
tranzly_kit_promotions | Филтър | Филтрира регистъра за промоции преди обработката му. Добавяне на ред за промотиране на друг продукт: `id`, `kind` (hosting|marketplace|platform|plugin|bundle|ads), `slot` (promo|cross-sell) и `url` или (за разширение) `name`, `site`, `main_files`. | няма | Безплатна |
tranzly_kit_tier | Филтър | Филтрира плана, който пакетът отчита за това разширение (тестови и работни среди; лицензът определя това в продукционна среда). | string $tier | Безплатна |
tranzly_localize_links | Филтър | Филтрира дали Tranzly насочва вътрешните връзки на тази страница към съответните им преводи. | bool $localizestring $lang | Безплатна |
tranzly_memory_enabled | Филтър | Филтрира дали се използва памет за преводи (translation memory). | bool $on | Pro |
tranzly_microsoft_price_per_million | Филтър | Филтрира цената на Microsoft Translator за милион знака в щатски долари. | float $price | Pro |
tranzly_network_enabled | Филтър | Филтрира дали мрежовият слой за мултисайт е включен. | bool $agency | Безплатна |
tranzly_pbs_internal_post_types | Филтър | Филтрира типовете публикации на Page Builder Sandwich, които Tranzly не променя. | няма | Безплатна |
tranzly_post_segments | Филтър | Филтрира сегментите от публикация, изпратени към машината за превод. Ключ => `text` + `format` (`text` или `html`). Парсерът за блокове и интеграциите добавят, разделят или заменят сегменти тук и ги записват обратно в `tranzly_translated_post_fields`. | \WP_Post $post | Безплатна |
tranzly_post_translated | Действие | Задейства се, след като машина преведе публикация (или е записана чрез файл от човек или импортиране). | int $targetint $source_idstring $codestring $engine | Безплатна |
tranzly_post_translation_created | Действие | Задейства се, след като Tranzly създаде превод на публикация. | int $new_idint $source_idstring $code | Безплатна |
tranzly_post_types | Филтър | Филтрира типовете публикации, които Tranzly превежда. | няма | Безплатна |
tranzly_pre_current_language | Филтър | Прескача определянето на текущия език: връщане на езиков код за директното му използване. По този начин работи tranzly_switch_language(); връща се null, за да реши Tranzly. | string|null $lang | Безплатна |
tranzly_query_var | Филтър | Филтрира променливата от заявката, която избира езика. | string $var | Безплатна |
tranzly_queue_lease_seconds | Филтър | Филтрира времетраенето на заемане на заявен елемент: след изтичането му, работен процес, прекъснал по средата на елемента, го връща обратно на останалите. По-дълго от най-бавния единичен превод. | int $seconds | Безплатна |
tranzly_queue_worker_seconds | Филтър | Филтрира продължителността на работа на един работен процес преди прехвърляне, в секунди. | int $seconds | Безплатна |
tranzly_queue_workers | Филтър | Филтрира колко работни процеса се изпълняват едновременно за една задача. Ограничение за броя процеси, с цел ненатоварване на услугата за превод; не ограничава броя завършени елементи. | int $workersint $job_id | Безплатна |
tranzly_rate_source_ | Филтър | Курсове от друг източник (вижте `tranzly_rate_sources`). | няма | Pro |
tranzly_rate_sources | Филтър | Филтрира източниците на валутни курсове. Добавяне на такъв с филтър `tranzly_rate_source_<id>`, който връща `[ code => курс спрямо референтната стойност ]` или WP_Error. | няма | Pro |
tranzly_register_engines | Действие | Регистриране на системи за превод. Извикване на `$registry->add( new Your_Engine() )`. | Registry $registry | Безплатна |
tranzly_relations_changed | Действие | Задейства се след промяна на връзките за превод на обекти: свързани, разкачени, преместени на друг език или премахнати. Задейства се по веднъж за всяка засегната група, така че една връзка може да го извика два пъти. | string $typearray<int> $ids | Безплатна |
tranzly_robots_meta_keys | Филтър | Филтрира мета ключовете на публикацията, съдържащи настройките за роботи; всеки от тях следва оригинала към неговите преводи. | няма | Безплатна |
tranzly_shared_string_scopes | Филтър | Филтрира обхватите на споделен текст (линия L06, T6: интеграциите добавят `woocommerce`, `forms` и `theme`; техните текстове постъпват чрез `tranzly_shared_strings`). | няма | Безплатна |
tranzly_shared_strings | Филтър | Филтрира споделените текстове, които Tranzly превежда като низове, за всеки обхват. Професионалното разширение добавя блокови шаблони, части от шаблони и мотиви към `templates`. | string $scope | Безплатна |
tranzly_shared_strings_covered | Филтър | Филтрира текстовете от даден обхват на споделен текст, които езиковият пакет превежда за съответния език. Професионалното разширение подава регистрираните мотиви на темата и ядрото за `templates`. | string $scopestring $lang | Безплатна |
tranzly_source_changed | Действие | Задейства се при промяна в подлежащото на превод съдържание на оригинала, поради което преводите му вече са остарели. | int $post_idstring $nowstring $before | Безплатна |
tranzly_source_meta_keys | Филтър | Филтрира мета ключовете, чиято промяна прави преводите на страницата остарели. Интеграциите добавят ключовете, които превеждат (данни от редактори на съдържание, SEO полета, персонализирани полета). | int $post_id | Безплатна |
tranzly_source_published | Действие | Задейства се еднократно при първото публикуване на оригинала (след записването на метаданните му). | int $post_id | Безплатна |
tranzly_style_rules_enabled | Филтър | Дали Tranzly да прилага правилата за стил на преводаческия екип на WordPress.org за съответния език (кавички, разстояния около пунктуацията, апострофи, многоточие, разстояния в японски, учтиви форми) към всеки нов превод. Включено по подразбиране. | bool $enabledstring $locale | Безплатна |
tranzly_taxonomies | Филтър | Филтрира таксономиите, които Tranzly превежда. | няма | Безплатна |
tranzly_term_segments | Филтър | Филтрира сегментите на термин, изпращани към машината (`name`, `description`, плюс добавеното от интеграции: SEO заглавия, персонализирани полета). Записвайте добавените чрез `tranzly_term_translated`. | \WP_Term $term | Безплатна |
tranzly_term_translated | Действие | Задейства се, след като машината преведе термин, с всеки преведен сегмент (интеграциите записват добавените от тях сегменти при `tranzly_term_segments`). | int $targetint $term_idstring $code | Безплатна |
tranzly_term_translation_created | Действие | Задейства се, след като Tranzly създаде превод на термин. | int $new_idint $term_idstring $code | Безплатна |
tranzly_translatable_attributes | Филтър | Филтрира атрибутите, които Tranzly превежда за даден тип блок. | string $block_name | Безплатна |
tranzly_translate_string | Филтър | Филтрира конкретен низ за превод на даден език. | string $valuestring $codearray $context | Безплатна |
tranzly_translated_post_fields | Филтър | Филтрира полетата на публикацията, записани в превода след работата на машината. Интеграциите, добавили свои собствени сегменти (персонализирани полета, данни от редактори на съдържание), ги записват тук. | \WP_Post $poststring $code | Безплатна |
tranzly_translation_memory | Филтър | Филтрира използваната памет за преводи: няма в безплатния плъгин; платената версия предлага такава (docs/843, правило 5 на WordPress.org). | Translation_Memory|null $memory | Безплатна |