Разработчици

Справочник за възможностите на Tranzly

Tranzly регистрира своите действия в WordPress Abilities API. Същите възможности са MCP инструменти на собствения сървър на сайта и REST маршрути под /wp-json/wp-abilities/v1. Тази страница е генерирана от собствения регистър на разширението.

Ръководство за потребителя: свързване на AI приложение

Крайни точки

Възможност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
Стартира фонови задачи за превод за всеки оригинал от посочените типове съдържание (всички превеждани типове, ако не са посочени конкретни): липсващите преводи, остарелите или всички. Връща стартираните задачи, по една за всеки език.
ProPOST /wp-json/wp-abilities/v1/abilities/tranzly/bulk-translate/runedit_posts; publish_posts за публикуванеlanguages масив (задължителен)
post_types масив
scope низ: missing, stale, all
engine низ
publish булев
tranzly/cancel-job
Спира задача; вече направените преводи се запазват.
БезплатноPOST /wp-json/wp-abilities/v1/abilities/tranzly/cancel-job/runmanage_options (собствена проверка на REST маршрута)id низ (задължителен)
tranzly/check-quality
Използва изкуствен интелект за сравняване на даден превод с оригинала му и оценяването му, след което записва доклада към превода. Използва модела за проверка на качеството с ИИ, зададен в настройките на работния процес на Tranzly.
ProPOST /wp-json/wp-abilities/v1/abilities/tranzly/check-quality/runedit_post за съответния преводid цяло число (задължително)
tranzly/connect-support
Свързва сайта с поддръжката на Zinn Digital® (име, имейл, съгласие).
БезплатноPOST /wp-json/wp-abilities/v1/abilities/tranzly/connect-support/runmanage_options (собствена проверка на REST маршрута)email низ (задължителен)
name низ
consent булев (задължителен)
tranzly/correct-segments
Запазва коригираните сегменти от даден превод (сегменти: ключ към текст); коригираният текст е защитен от повторно превеждане.
БезплатноPOST /wp-json/wp-abilities/v1/abilities/tranzly/correct-segments/runedit_post (собствена проверка на REST маршрута)id низ (задължителен)
segments обект
texts обект
tranzly/create-job
Стартира фонова задача за превод на изброените публикации (posts) или на цял тип публикация на избраните езици (langs).
БезплатноPOST /wp-json/wp-abilities/v1/abilities/tranzly/create-job/runedit_posts (собствена проверка на REST маршрута)posts масив
post_type низ
langs масив (задължителен)
engine низ
status низ: publish, draft
force булев
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/runmanage_options (собствена проверка на REST маршрута)няма
tranzly/estimate
Изчислява приблизителния брой знаци и цената за превод на публикации (posts или post_type) на избраните езици (langs) с дадена преводаческа система, преди да правите разходи.
БезплатноPOST /wp-json/wp-abilities/v1/abilities/tranzly/estimate/runedit_posts (собствена проверка на REST маршрута)posts масив
post_type низ
langs масив (задължителен)
engine низ
tranzly/estimate-bulk
Изчислява предварително превода на целия сайт на даден език (post_types, scope, engine), преди да го стартирате.
ProPOST /wp-json/wp-abilities/v1/abilities/tranzly/estimate-bulk/runedit_posts (собствена проверка на REST маршрута)post_types масив
scope низ: missing, stale, all
engine низ
lang низ (задължителен)
after цяло число
tranzly/export-translation-file
Връща XLIFF или CSV файл (като текст) с оригиналите и техните преводи на един език за преводач или агенция за преводи: посочените публикации или страница с до 100 оригинала от тип съдържание в определено състояние (missing, stale, translated или all; повторение с after). Същият файл може да бъде внесен обратно след превода.
ProGET /wp-json/wp-abilities/v1/abilities/tranzly/export-translation-file/runedit_posts; всяка публикация се включва само ако потребителят има право да я редактираlang низ (задължителен)
format низ: xliff, csv
posts масив
post_type низ
state низ: all, missing, stale, translated
after цяло число
tranzly/fix-status
Добавя на опашката за превод всеки липсващ (или остарял) елемент за даден език и тип публикация.
БезплатноPOST /wp-json/wp-abilities/v1/abilities/tranzly/fix-status/runedit_posts (собствена проверка на REST маршрута)post_type низ
lang низ (задължително)
state низ (задължително): missing, stale, quality
tranzly/get-comments-setting
Връща дали коментарите се споделят между езиците, или се пазят поотделно за всеки език.
ProGET /wp-json/wp-abilities/v1/abilities/tranzly/get-comments-setting/runmoderate_comments (собствена проверка на REST маршрута)няма
tranzly/get-deepl-usage
Връща използваните символи и лимита на запазения DeepL ключ за този месец.
БезплатноGET /wp-json/wp-abilities/v1/abilities/tranzly/get-deepl-usage/runmanage_options (собствена проверка на REST маршрута)няма
tranzly/get-diagnostics
Връща диагностичните данни за билет за поддръжка: версии, активни разширения, лимити и скорошни грешки.
БезплатноGET /wp-json/wp-abilities/v1/abilities/tranzly/get-diagnostics/runmanage_options (собствена проверка на REST маршрута)няма
tranzly/get-display
Връща настройките за показване на превключвателя за езици и признанията за авторство.
БезплатноGET /wp-json/wp-abilities/v1/abilities/tranzly/get-display/runmanage_options (собствена проверка на REST маршрута)няма
tranzly/get-engine-settings
Връща основния и резервния модул, модулите по езици и AI моделите, състоянието на всеки модул, свързаните AI доставчици с техните модели и разходите за този месец.
БезплатноGET /wp-json/wp-abilities/v1/abilities/tranzly/get-engine-settings/runmanage_options (собствена проверка на REST маршрута)няма
tranzly/get-glossary
Връща думите, които никога не се превеждат, установените преводи на термини и тона за всеки език.
ProGET /wp-json/wp-abilities/v1/abilities/tranzly/get-glossary/runmanage_optionsняма
tranzly/get-integrations
Извежда списък с разширенията за SEO, WooCommerce, визуални редактори и формуляри, поддържани от Tranzly, които са активни тук.
БезплатноGET /wp-json/wp-abilities/v1/abilities/tranzly/get-integrations/runmanage_options (собствена проверка на REST маршрута)няма
tranzly/get-job
Връща напредъка и броячите за дадена задача.
БезплатноGET /wp-json/wp-abilities/v1/abilities/tranzly/get-job/runmanage_options (собствена проверка на REST маршрута)id низ (задължително)
tranzly/get-job-failures
Извежда неуспешните елементи от дадена задача заедно с причината за всеки от тях.
БезплатноGET /wp-json/wp-abilities/v1/abilities/tranzly/get-job-failures/runmanage_options (собствена проверка на REST маршрута)id низ (задължително)
tranzly/get-legacy-import
Връща състоянието и доклада от внасянето на преводи от Tranzly 2.x.
БезплатноGET /wp-json/wp-abilities/v1/abilities/tranzly/get-legacy-import/runmanage_options (собствена проверка на REST маршрута)няма
tranzly/get-licence
Връща плана на Tranzly за сайта, състоянието на лиценза, датата на подновяване и включеното в плана.
БезплатноGET /wp-json/wp-abilities/v1/abilities/tranzly/get-licence/runmanage_options (собствена проверка на REST маршрута)няма
tranzly/get-menus
Връща кое меню се показва за всеки език във всяка позиция за меню.
БезплатноGET /wp-json/wp-abilities/v1/abilities/tranzly/get-menus/runedit_theme_options (собствена проверка на REST маршрута)няма
tranzly/get-post-group
Извежда преводната група на публикация: записа за всеки език със заглавие, статус и връзка за редактиране.
БезплатноGET /wp-json/wp-abilities/v1/abilities/tranzly/get-post-group/runedit_post и edit_term (собствена проверка на REST маршрута)id низ (задължително)
tranzly/get-quality-report
Връща AI доклада за качество на превода: оценка и отбелязаните сегменти.
ProGET /wp-json/wp-abilities/v1/abilities/tranzly/get-quality-report/runedit_post (собствена проверка на REST маршрута)id низ (задължително)
tranzly/get-segments
Връща сегментите на превода редом с оригинала за преглед и корекция.
БезплатноGET /wp-json/wp-abilities/v1/abilities/tranzly/get-segments/runedit_post (собствена проверка на REST маршрута)id низ (задължително)
tranzly/get-shared-strings
Връща текстовете от темата и разширенията (обхват) на даден език заедно с техните преводи.
БезплатноGET /wp-json/wp-abilities/v1/abilities/tranzly/get-shared-strings/runedit_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/runmanage_options (собствена проверка на REST маршрута)lang низ (задължително)
tranzly/get-support-connection
Показва дали сайтът е свързан с поддръжката на Zinn Digital® и от кое име.
FreeGET /wp-json/wp-abilities/v1/abilities/tranzly/get-support-connection/runmanage_options (собствена проверка на REST маршрута)refresh boolean
tranzly/get-term-group
Показва групата за превод на дадена категория или етикет.
FreeGET /wp-json/wp-abilities/v1/abilities/tranzly/get-term-group/runedit_post и edit_term (собствена проверка на REST маршрута)id string (задължително)
tranzly/get-urls
Връща начина на изписване на езиците в адресите (папка, поддомейн или домейн), преведените кратки имена (slugs) и бази, както и noindex за непреведените страници.
FreeGET /wp-json/wp-abilities/v1/abilities/tranzly/get-urls/runmanage_options (собствена проверка на REST маршрута)няма
tranzly/get-workflow-settings
Връща настройките за автоматичен превод при публикуване и обновяване, преглед преди публикуване, както и прага, доставчика и модела за проверка на качеството чрез изкуствен интелект.
ProGET /wp-json/wp-abilities/v1/abilities/tranzly/get-workflow-settings/runmanage_options (собствена проверка на REST маршрута)няма
tranzly/import-from-source
Внася следващата страница с преводи от друг плъгин за многоезичност (режим: dry-run или run; cursor).
ProPOST /wp-json/wp-abilities/v1/abilities/tranzly/import-from-source/runmanage_options (собствена проверка на REST маршрута)source string (задължително)
mode string: dry-run, run, undo
cursor string
tranzly/import-translation-file
Записва следващата страница с публикации от качен файл с преводи (повтаря се с after до завършване).
ProPOST /wp-json/wp-abilities/v1/abilities/tranzly/import-translation-file/runedit_posts (собствена проверка на REST маршрута)token string (задължително)
after integer
tranzly/link-post
Задава съществуваща публикация (target) като превод на тази публикация на съответния език.
FreePOST /wp-json/wp-abilities/v1/abilities/tranzly/link-post/runedit_post и edit_term (собствена проверка на REST маршрута)id string (задължително)
lang string (задължително)
target integer (задължително)
tranzly/link-term
Задава съществуващ таксономичен термин (target) като превод на този термин на съответния език.
FreePOST /wp-json/wp-abilities/v1/abilities/tranzly/link-term/runedit_post и edit_term (собствена проверка на REST маршрута)id string (задължително)
lang string (задължително)
target integer (задължително)
tranzly/list-engines
Извежда списък с платформите за превод, състоянието на настройката им и коя се използва по подразбиране.
FreeGET /wp-json/wp-abilities/v1/abilities/tranzly/list-engines/runedit_postsняма
tranzly/list-import-sources
Извежда откритите на сайта данни от WPML, Polylang и TranslatePress, които могат да бъдат внесени.
ProGET /wp-json/wp-abilities/v1/abilities/tranzly/list-import-sources/runmanage_options (собствена проверка на REST маршрута)няма
tranzly/list-jobs
Показва фоновите задачи за превод, започвайки от най-новите, с информация за напредъка.
FreeGET /wp-json/wp-abilities/v1/abilities/tranzly/list-jobs/runedit_posts (собствена проверка на REST маршрута)няма
tranzly/list-languages
Показва езиците на сайта. Първият е езикът, на който е написано оригиналното съдържание.
FreeGET /wp-json/wp-abilities/v1/abilities/tranzly/list-languages/runedit_postsняма
tranzly/list-status-items
Извежда оригиналите с тяхното състояние на превод за даден език (състояние: missing, stale, current), страница по страница.
FreeGET /wp-json/wp-abilities/v1/abilities/tranzly/list-status-items/runedit_posts (собствена проверка на REST маршрута)post_type string
lang string (задължително)
state string: all, missing, stale, translated, human, machine, review, quality
after integer
tranzly/list-theme-strings
Извежда списък с темите и плъгините, чиито текстове могат да се сканират за превод, както и броя низове във всеки от тях.
ProGET /wp-json/wp-abilities/v1/abilities/tranzly/list-theme-strings/runmanage_options (собствена проверка на REST маршрута)няма
tranzly/open-support-ticket
Подава запитване за поддръжка (subject, message, kind, email) заедно с диагностичните данни на сайта, ако администраторът е дал съгласие. Никога не създава и не изпраща данни за вход.
FreePOST /wp-json/wp-abilities/v1/abilities/tranzly/open-support-ticket/runmanage_options (собствена проверка на REST маршрута)subject string (задължително)
message string (задължително)
kind string: help, bug, feedback, feature_request
email string
name string
diagnostics boolean
tranzly/record-support-consent
Записва съгласието на администратора за изпращане на диагностични данни със запитванията за поддръжка.
FreePOST /wp-json/wp-abilities/v1/abilities/tranzly/record-support-consent/runmanage_options (собствена проверка на REST маршрута)consent boolean (задължително)
tranzly/retry-job-item
Повтаря неуспешен елемент (action: retry, по желание с друг модул) или го маркира за ръчен превод (action: by-hand).
БезплатнаPOST /wp-json/wp-abilities/v1/abilities/tranzly/retry-job-item/runedit_post и manage_options (собствена проверка на REST маршрута)item низ (задължително)
action низ (задължително)
engine низ
tranzly/review-translation
Одобрява превод (и го публикува при публикуван оригинал) или го връща за редакция (decision, note).
ProPOST /wp-json/wp-abilities/v1/abilities/tranzly/review-translation/runedit_post (собствена проверка на REST маршрута)id низ (задължително)
decision низ (задължително): approve, changes, pending
note низ
tranzly/run-legacy-import
Изпълнява импортирането от версия 2.x: пробно пускане (dry-run, само отчет), изпълнение или отмяна.
БезплатнаPOST /wp-json/wp-abilities/v1/abilities/tranzly/run-legacy-import/runmanage_options (собствена проверка на REST маршрута)action низ (задължително)
tranzly/scan-theme-strings
Сканира следващата страница от PHP файловете на даден компонент за текстове за превод (повтаря се с after до завършване).
ProPOST /wp-json/wp-abilities/v1/abilities/tranzly/scan-theme-strings/runmanage_options (собствена проверка на REST маршрута)component низ (задължително)
after цяло число
tranzly/schedule-quality-check
Планира проверка на качеството с изкуствен интелект на следващата страница от преводите за даден език (или на посочените публикации).
ProPOST /wp-json/wp-abilities/v1/abilities/tranzly/schedule-quality-check/runedit_posts (собствена проверка на REST маршрута)lang низ (задължително)
post_type низ
posts масив
after цяло число
tranzly/seo-audit
Проверява преводите за липсващи SEO заглавия, описания, адреси и hreflang на даден език, страница по страница.
ProGET /wp-json/wp-abilities/v1/abilities/tranzly/seo-audit/runmanage_options (собствена проверка на REST маршрута)lang низ (задължително)
after цяло число
tranzly/set-comments-setting
Споделя коментарите между преводите на публикацията или ги запазва отделно за всеки език (mode).
ProPOST /wp-json/wp-abilities/v1/abilities/tranzly/set-comments-setting/runmanage_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/runmanage_options (собствена проверка на REST маршрута)engine низ (задължително)
key низ (задължително)
region низ
tranzly/set-menus
Задава меню за всеки език по местоположение (map).
БезплатнаPOST /wp-json/wp-abilities/v1/abilities/tranzly/set-menus/runedit_theme_options (собствена проверка на REST маршрута)map обект (задължително)
tranzly/set-protection
Защитава превод от презаписване от модула (protected: true) или премахва защитата му.
БезплатнаPOST /wp-json/wp-abilities/v1/abilities/tranzly/set-protection/runedit_post (собствена проверка на REST маршрута)id низ (задължително)
protected булева стойност (задължително)
tranzly/set-shared-strings
Запазва коригирани преводи на текстове от теми и разширения (strings); те стават защитени.
БезплатнаPOST /wp-json/wp-abilities/v1/abilities/tranzly/set-shared-strings/runedit_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/runedit_theme_options и manage_options (собствена проверка на REST маршрута)lang низ (задължително)
key низ (задължително)
translation низ (задължително)
tranzly/set-urls
Задава режима за адреси (mode), домейните за всеки език, преведените основи и сегменти, noindex_untranslated и предложенията за адреси.
БезплатнаPOST /wp-json/wp-abilities/v1/abilities/tranzly/set-urls/runmanage_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/runmanage_options (собствена проверка на REST маршрута)няма
tranzly/translate-media-field
Запазва алтернативния текст, заглавието или описанието на изображение (field) на даден език (lang).
БезплатноPOST /wp-json/wp-abilities/v1/abilities/tranzly/translate-media-field/runedit_post (собствена проверка на REST маршрута)id низ (задължително)
lang низ (задължително)
field низ (задължително): alt, caption, title
translation низ (задължително)
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/runedit_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/runedit_postslanguages низ (задължително)
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/runedit_post за съответната публикация; edit_posts за обобщението на сайтаid цяло число
post_type низ
tranzly/unlink-post
Изважда публикация от преводната ѝ група; публикацията запазва езика си.
БезплатноPOST /wp-json/wp-abilities/v1/abilities/tranzly/unlink-post/runedit_post и edit_term (собствена проверка на REST маршрута)id низ (задължително)
tranzly/unlink-term
Изважда таксономия от преводната ѝ група.
БезплатноPOST /wp-json/wp-abilities/v1/abilities/tranzly/unlink-term/runedit_post и edit_term (собствена проверка на REST маршрута)id низ (задължително)
tranzly/update-display
Променя превключвателя (стил, знамена, имена, разположение) и реда с авторски права.
БезплатноPOST /wp-json/wp-abilities/v1/abilities/tranzly/update-display/runmanage_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/runmanage_options (собствена проверка на REST маршрута)default низ
per_lang обект
fallback масив
caps обект
models обект
tranzly/update-glossary
Замества изпратените части от речника (непревеждани думи, преводи на термини, тон); пропуснатите части се запазват. Използва се от всеки механизъм от следващия превод нататък.
ProPOST /wp-json/wp-abilities/v1/abilities/tranzly/update-glossary/runmanage_optionsdnt масив
terms обект
tone обект
tranzly/update-settings
Задава езиците на сайта (languages: списък с код и име; първият е оригиналният език), префикса на класовете за лицевата част и дали се разрешават AI агенти (MCP).
БезплатноPOST /wp-json/wp-abilities/v1/abilities/tranzly/update-settings/runmanage_options (собствена проверка на REST маршрута)prefix низ
mcp булева стойност
languages масив
tranzly/update-workflow-settings
Задава on_update (off, stale, translate), on_publish, review, quality_threshold, quality_provider и quality_model.
ProPOST /wp-json/wp-abilities/v1/abilities/tranzly/update-workflow-settings/runmanage_options (собствена проверка на маршрута на REST)on_update низ: off, stale, translate
on_publish булева стойност
review булева стойност
quality_threshold цяло число
quality_provider низ
quality_model низ
tranzly/upload-translation-file
Качва Tranzly XLIFF или CSV файл (съдържание, име на файл), преведен на друго място; връща токен, който идентифицира качването за импортирането.
ProPOST /wp-json/wp-abilities/v1/abilities/tranzly/upload-translation-file/runedit_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=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
Фонови задачи за превод.Безплатно
wp tranzly legacy <action> [--format=<format>]
wp tranzly legacy dry-run
wp tranzly legacy run
wp tranzly legacy undo
Показване, тестово изпълнение (dry-run), стартиране или отмяна на импортирането на преводи от наследен сайт на Tranzly (2.x).Безплатно
wp tranzly link <source> <target> [--term]Свързване на съществуваща публикация (или термин) като превод на друга.Безплатно
wp tranzly network <action> [--languages=<codes>]
wp tranzly network setup
wp 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=admin
wp 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 ): ?intID на превода на публикация на даден език или 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 $bar
int $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 $content
string $lang
Безплатно
tranzly_copy_meta_keysФилтърФилтрира мета ключовете, които се копират от публикация към нейния нов превод. Нищо друго не се копира.int $source_idБезплатно
tranzly_deepl_hostФилтърФилтрира хоста за API на DeepL (прокси или дублиращ тестов сървър).string $host
string $key
Безплатно
tranzly_deepl_price_per_millionФилтърФилтрира цената на DeepL за милион знака в щатски долари.float $priceБезплатно
tranzly_default_engineФилтърФилтрира идентификатора (ID) на машината, която се използва, когато не е посочена друга.string $idБезплатно
tranzly_engine_capФилтърФилтрира месечния лимит на машина в щатски долари: в безплатния разширител няма такъв.float|null $cap
string $engine
Безплатно
tranzly_engine_chainФилтърФилтрира машините, които да бъдат изпробвани за даден език, по реда на подредбата им. В безплатната версия: машината по подразбиране. Платената версия добавя собствената машина на езика и резервния списък.string $lang
string $first
Безплатно
tranzly_engine_optionsФилтърФилтрира опциите, подавани към машината (списък с фрази без превод, речник, стил на изказване, инструкции).string $target
Engine $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 $pricePro
tranzly_install_language_packsФилтърОпределя дали Tranzly инсталира езиковите пакети за WordPress, темата и разширенията за език, добавен към сайта (за да се показват системните съобщения на WordPress и WooCommerce в превод). Включено по подразбиране.bool $installБезплатно
tranzly_integration_availableФилтърФилтрира дали дадена интеграция да се изпълнява, когато съответният ѝ разширител не е открит – полезно за съдържание, оставено от визуален редактор след изключването му, или разширител, зареден по нестандартен начин.bool $on
string $id
Безплатно
tranzly_integrationsФилтърФилтрира интеграциите, изпълнявани от Tranzly. Добавете подклас на `Integration` за поддръжка на друг разширител.нямаБезплатно
tranzly_is_proФилтърФилтрира дали платената версия е активна. Обработва се единствено от нея.bool $proБезплатно
tranzly_job_createdДействиеЗадейства се след създаване на задача за превод.int $job
int $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 $localize
string $lang
Безплатна
tranzly_memory_enabledФилтърФилтрира дали се използва памет за преводи (translation memory).bool $onPro
tranzly_microsoft_price_per_millionФилтърФилтрира цената на Microsoft Translator за милион знака в щатски долари.float $pricePro
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 $target
int $source_id
string $code
string $engine
Безплатна
tranzly_post_translation_createdДействиеЗадейства се, след като Tranzly създаде превод на публикация.int $new_id
int $source_id
string $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 $workers
int $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 $type
array<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 $scope
string $lang
Безплатна
tranzly_source_changedДействиеЗадейства се при промяна в подлежащото на превод съдържание на оригинала, поради което преводите му вече са остарели.int $post_id
string $now
string $before
Безплатна
tranzly_source_meta_keysФилтърФилтрира мета ключовете, чиято промяна прави преводите на страницата остарели. Интеграциите добавят ключовете, които превеждат (данни от редактори на съдържание, SEO полета, персонализирани полета).int $post_idБезплатна
tranzly_source_publishedДействиеЗадейства се еднократно при първото публикуване на оригинала (след записването на метаданните му).int $post_idБезплатна
tranzly_style_rules_enabledФилтърДали Tranzly да прилага правилата за стил на преводаческия екип на WordPress.org за съответния език (кавички, разстояния около пунктуацията, апострофи, многоточие, разстояния в японски, учтиви форми) към всеки нов превод. Включено по подразбиране.bool $enabled
string $locale
Безплатна
tranzly_taxonomiesФилтърФилтрира таксономиите, които Tranzly превежда.нямаБезплатна
tranzly_term_segmentsФилтърФилтрира сегментите на термин, изпращани към машината (`name`, `description`, плюс добавеното от интеграции: SEO заглавия, персонализирани полета). Записвайте добавените чрез `tranzly_term_translated`.\WP_Term $termБезплатна
tranzly_term_translatedДействиеЗадейства се, след като машината преведе термин, с всеки преведен сегмент (интеграциите записват добавените от тях сегменти при `tranzly_term_segments`).int $target
int $term_id
string $code
Безплатна
tranzly_term_translation_createdДействиеЗадейства се, след като Tranzly създаде превод на термин.int $new_id
int $term_id
string $code
Безплатна
tranzly_translatable_attributesФилтърФилтрира атрибутите, които Tranzly превежда за даден тип блок.string $block_nameБезплатна
tranzly_translate_stringФилтърФилтрира конкретен низ за превод на даден език.string $value
string $code
array $context
Безплатна
tranzly_translated_post_fieldsФилтърФилтрира полетата на публикацията, записани в превода след работата на машината. Интеграциите, добавили свои собствени сегменти (персонализирани полета, данни от редактори на съдържание), ги записват тук.\WP_Post $post
string $code
Безплатна
tranzly_translation_memoryФилтърФилтрира използваната памет за преводи: няма в безплатния плъгин; платената версия предлага такава (docs/843, правило 5 на WordPress.org).Translation_Memory|null $memoryБезплатна