Розробники

Довідник можливостей (abilities) 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); користувачеві потрібна можливість, яку вимагає кожна дія · Налаштування: Дозволити ШІ-агентів (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
Зупиняє завдання; уже виконані переклади зберігаються.
FreePOST /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® (ім’я, електронна пошта, згода).
FreePOST /wp-json/wp-abilities/v1/abilities/tranzly/connect-support/runmanage_options (власна перевірка маршруту REST)email рядок (обов’язково)
name рядок
consent булеве (обов’язково)
tranzly/correct-segments
Зберігає виправлені сегменти перекладу (сегменти: ключ до тексту); виправлений текст захищено від повторного перекладу.
FreePOST /wp-json/wp-abilities/v1/abilities/tranzly/correct-segments/runedit_post (власна перевірка маршруту REST)id рядок (обов’язково)
segments об’єкт
texts об’єкт
tranzly/create-job
Запускає фонове завдання з перекладу перелічених дописів (posts) або цілого типу дописів мовами (langs).
FreePOST /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) для написання вручну, без системи машинного перекладу.
FreePOST /wp-json/wp-abilities/v1/abilities/tranzly/create-post-translation/runвласна перевірка дозволів маршруту REST для кожного елементаid рядок (обов’язково)
lang рядок (обов’язково)
name рядок
slug рядок
description рядок
tranzly/create-term-translation
Створює переклад терміна певною мовою із зазначеними назвою, слагом та описом.
FreePOST /wp-json/wp-abilities/v1/abilities/tranzly/create-term-translation/runвласна перевірка дозволів маршруту REST для кожного елементаid рядок (обов’язково)
lang рядок (обов’язково)
name рядок
slug рядок
description рядок
tranzly/disconnect-support
Відключає цей сайт від служби підтримки.
FreePOST /wp-json/wp-abilities/v1/abilities/tranzly/disconnect-support/runmanage_options (власна перевірка маршруту REST)немає
tranzly/estimate
Оцінює кількість символів і вартість перекладу дописів (posts або post_type) вибраними мовами (langs) за допомогою системи перекладу перед тим, як витрачати кошти.
FreePOST /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
Повертає основний і резервний рушії, рушії та моделі ШІ для окремих мов, стан кожного рушія, підключених постачальників ШІ з їхніми моделями та витрати за цей місяць.
Безкоштовно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
Повертає звіт про якість перекладу від ШІ: оцінку та позначені сегменти.
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
Повертає спосіб відображення мов в адресах (папка, субдомен або домен), перекладені ярлики й основи, а також 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
Створює запит до служби підтримки (тема, повідомлення, тип, електронна пошта) з діагностичними даними цього сайту, якщо адміністратор надав згоду. Ніколи не створює та не надсилає облікові дані для входу.
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).
FreePOST /wp-json/wp-abilities/v1/abilities/tranzly/retry-job-item/runedit_post і manage_options (власна перевірка маршруту REST)item string (обов’язково)
action string (обов’язково)
engine string
tranzly/review-translation
Схвалює переклад (і публікує його, коли опубліковано оригінал) або відправляє його назад (decision, note).
ProPOST /wp-json/wp-abilities/v1/abilities/tranzly/review-translation/runedit_post (власна перевірка маршруту REST)id string (обов’язково)
decision string (обов’язково): approve, changes, pending
note string
tranzly/run-legacy-import
Запускає імпорт 2.x: dry-run (тільки звіт), run або undo.
FreePOST /wp-json/wp-abilities/v1/abilities/tranzly/run-legacy-import/runmanage_options (власна перевірка маршруту REST)action string (обов’язково)
tranzly/scan-theme-strings
Сканує наступну сторінку PHP-файлів компонента на наявність перекладних текстів (повторюйте з after до завершення).
ProPOST /wp-json/wp-abilities/v1/abilities/tranzly/scan-theme-strings/runmanage_options (власна перевірка маршруту REST)component string (обов’язково)
after integer
tranzly/schedule-quality-check
Планує перевірку якості за допомогою ШІ для наступної сторінки перекладів мови (або для вказаних записів).
ProPOST /wp-json/wp-abilities/v1/abilities/tranzly/schedule-quality-check/runedit_posts (власна перевірка маршруту REST)lang string (обов’язково)
post_type string
posts array
after integer
tranzly/seo-audit
Перевіряє переклади на відсутність SEO-заголовків, описів, ярликів і hreflang для певної мови, сторінка за сторінкою.
ProGET /wp-json/wp-abilities/v1/abilities/tranzly/seo-audit/runmanage_options (власна перевірка маршруту REST)lang string (обов’язково)
after integer
tranzly/set-comments-setting
Спільно використовує коментарі між перекладами запису або зберігає їх окремо для кожної мови (mode).
ProPOST /wp-json/wp-abilities/v1/abilities/tranzly/set-comments-setting/runmanage_options і moderate_comments (власна перевірка маршруту REST)mode string (обов’язково): off, show, translate
tranzly/set-engine-key
Зберігає ключ API (і регіон для Microsoft) для DeepL, Google або Microsoft; порожній видаляє його. Ключі зберігаються в зашифрованому вигляді і ніколи не повертаються.
FreePOST /wp-json/wp-abilities/v1/abilities/tranzly/set-engine-key/runmanage_options (власна перевірка маршруту REST)engine string (обов’язково)
key string (обов’язково)
region string
tranzly/set-menus
Призначає меню для кожної мови для кожної області відображення (map).
FreePOST /wp-json/wp-abilities/v1/abilities/tranzly/set-menus/runedit_theme_options (власна перевірка маршруту REST)map object (обов’язково)
tranzly/set-protection
Захищає переклад від перезапису рушієм (protected: true) або розблоковує його.
FreePOST /wp-json/wp-abilities/v1/abilities/tranzly/set-protection/runedit_post (власна перевірка маршруту REST)id string (обов’язково)
protected boolean (обов’язково)
tranzly/set-shared-strings
Зберігає виправлені переклади текстів теми та плагінів (рядків); вони стають захищеними.
FreePOST /wp-json/wp-abilities/v1/abilities/tranzly/set-shared-strings/runedit_theme_options (власна перевірка маршруту REST)lang string (обов’язково)
scope string: menus, site, templates, gettext.plugin-<slug>, gettext.theme-<slug>
strings object (обов’язково)
tranzly/set-site-string
Зберігає один текст сайту (ключ) певною мовою, наприклад, назву сайту або опис.
FreePOST /wp-json/wp-abilities/v1/abilities/tranzly/set-site-string/runedit_theme_options і manage_options (власна перевірка маршруту REST)lang string (обов’язково)
key string (обов’язково)
translation string (обов’язково)
tranzly/set-urls
Встановлює режим адрес (mode), домени для кожної мови, перекладені основи та сегменти, noindex_untranslated і пропозиції ярликів.
FreePOST /wp-json/wp-abilities/v1/abilities/tranzly/set-urls/runmanage_options (власна перевірка маршруту REST)mode string
segments object
domains object
bases object
suggest boolean
noindex_untranslated boolean
tranzly/start-trial
Запускає 14-денну пробну версію Tranzly Pro для цього сайту (оплата не потрібна).
FreePOST /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 string (обов’язково)
lang string (обов’язково)
field string (обов’язково): alt, caption, title
translation string (обов’язково)
tranzly/translate-post
Перекладає один запис або сторінку однією чи кількома мовами сайту за допомогою рушія перекладу, створюючи або оновлюючи кожен переклад. Нові переклади є чернетками, якщо publish не true. Переклад, відредагований людиною, пропускається, якщо force не true.
БезкоштовноPOST /wp-json/wp-abilities/v1/abilities/tranzly/translate-post/runдозвіл перекладати цей запис (edit_post для нього); edit_post для наявного перекладу; право публікації для відповідного типу для публікаціїid integer (обов’язково)
languages array (обов’язково)
engine string
publish boolean
force boolean
tranzly/translate-shared-strings
Перекладає наступну сторінку неперекладених текстів теми та плагінів потрібною мовою за допомогою стандартного рушія (повторюйте з after до завершення).
БезкоштовноPOST /wp-json/wp-abilities/v1/abilities/tranzly/translate-shared-strings/runedit_theme_options (власна перевірка маршруту REST)lang string (обов’язково)
scope string: menus, site, templates, gettext.plugin-<slug>, gettext.theme-<slug>
after integer
tranzly/translate-site
Керований робочий процес: агент перевіряє мови та рушій, оцінює вартість і перекладає те, чого не вистачає, запитуючи підтвердження перед витратами або публікацією.
БезкоштовноPOST /wp-json/wp-abilities/v1/abilities/tranzly/translate-site/runedit_postslanguages string (обов’язково)
tranzly/translate-term
Перекладає один термін (категорію, позначку або атрибут товару) потрібною мовою (lang) за допомогою рушія, створюючи або оновлюючи його переклад.
БезкоштовноPOST /wp-json/wp-abilities/v1/abilities/tranzly/translate-term/runвласна перевірка дозволів маршруту REST для кожного елементаid string (обов’язково)
lang string (обов’язково)
engine string
force boolean
status string: publish, draft
tranzly/translation-status
З ідентифікатором запису: переклад цього запису кожною мовою, чи він застарів, і хто його створив. Без нього: яка частина сайту перекладена (для кожної мови).
БезкоштовноGET /wp-json/wp-abilities/v1/abilities/tranzly/translation-status/runedit_post для цього запису; edit_posts для зведення по сайтуid integer
post_type string
tranzly/unlink-post
Вилучає запис із його групи перекладу; його мова зберігається.
БезкоштовноPOST /wp-json/wp-abilities/v1/abilities/tranzly/unlink-post/runedit_post і edit_term (власна перевірка маршруту REST)id string (обов’язково)
tranzly/unlink-term
Вилучає термін із його групи перекладу.
БезкоштовноPOST /wp-json/wp-abilities/v1/abilities/tranzly/unlink-term/runedit_post і edit_term (власна перевірка маршруту REST)id string (обов’язково)
tranzly/update-display
Змінює перемикач (стиль, прапори, назви, розташування) та рядок авторства.
БезкоштовноPOST /wp-json/wp-abilities/v1/abilities/tranzly/update-display/runmanage_options (власна перевірка маршруту REST)switcher object
credit boolean
tranzly/update-engine-settings
Налаштовує стандартний рушій, резервний рушій, рушії для окремих мов та моделі ШІ для окремих мов (default, fallback, per_lang, models, caps). Усе, крім стандартного рушія, доступно лише у версії Pro.
БезкоштовноPOST /wp-json/wp-abilities/v1/abilities/tranzly/update-engine-settings/runmanage_options (власна перевірка маршруту REST)default string
per_lang object
fallback array
caps object
models object
tranzly/update-glossary
Замінює передані вами частини глосарія (слова, які ніколи не перекладаються, переклади термінів, тон); не передані частини залишаються без змін. Використовується кожним рушієм, починаючи з наступного перекладу.
ProPOST /wp-json/wp-abilities/v1/abilities/tranzly/update-glossary/runmanage_optionsdnt array
terms object
tone object
tranzly/update-settings
Встановлює мови сайту (languages: список кодів і назв; перша є оригінальною мовою), префікс класів для інтерфейсу, а також чи дозволені ШІ-агенти (MCP).
БезкоштовноPOST /wp-json/wp-abilities/v1/abilities/tranzly/update-settings/runmanage_options (власна перевірка маршруту REST)prefix string
mcp boolean
languages array
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 string: off, stale, translate
on_publish boolean
review boolean
quality_threshold integer
quality_provider string
quality_model string
tranzly/upload-translation-file
Завантажує файл Tranzly XLIFF або CSV (content, filename), перекладений в іншому місці; повертає токен, який ідентифікує завантаження для імпорту.
ProPOST /wp-json/wp-abilities/v1/abilities/tranzly/upload-translation-file/runedit_posts (власна перевірка маршруту REST)content string (обов’язково)
filename string (обов’язково)

Згенеровано з abilities.json плагіна, який сам генерується з працюючого сайту; тест не проходить, якщо вони не збігаються.

Команди WP-CLI

Запускайте їх на сервері за допомогою WP-CLI. Кожна команда перевіряє ті самі дозволи, що й екрани плагіна; приклади взято з власного тексту довідки плагіна.

КомандаЩо вона робитьВидання
wp tranzly create <id> [--term]
wp tranzly create 42 --lang=de_DE --user=admin
Створити чернетку перекладу запису (або терміна), зв’язану з ним.Free
wp tranzly enginesПоказати список рушіїв перекладу.Free
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
Фонові завдання перекладу.Free
wp tranzly legacy <action> [--format=<format>]
wp tranzly legacy dry-run
wp tranzly legacy run
wp tranzly legacy undo
Показати, провести тестовий запуск, виконати або скасувати імпорт перекладів зі старого сайту Tranzly (2.x).Free
wp tranzly link <source> <target> [--term]Пов’язати наявний запис (або термін) як переклад іншого.Free
wp tranzly network <action> [--languages=<codes>]
wp tranzly network setup
wp tranzly network languages --languages=en_US,de_DE,fr_FR
Мультисайт (Agency): налаштувати кожен сайт мережі або встановити мови, з якими створюються нові сайти.Free
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
Перекладати записи за допомогою рушія.Free
wp tranzly translations <id> [--term] [--format=<format>]Показати список перекладів запису (або терміна).Free

Функції 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: усі переклади запису, ярлик => 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: усі переклади терміна, ярлик => ID.Pro
pll_home_url( $lang = '' )Polylang: URL головної сторінки певною мовою.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 (ярлик => подробиці); інакше повертає список `<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 => name.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 ): stringURL-адреса, що відображає вказану мову.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Дія (Action)Спрацьовує після побудови меню перекладів на панелі адміністратора (візуальний редактор Pro додає сюди свій пункт “Перекласти на цій сторінці”).\WP_Admin_Bar $bar
int $id
Free
tranzly_admin_dataФільтрФільтрує дані, з якими завантажується додаток панелі адміністратора. Преміум-рівень використовує це для повідомлення своєї редакції; сюди не слід додавати конфіденційні дані, оскільки вони виводяться на сторінці.немаєFree
tranzly_ai_modelФільтрФільтрує AI-провайдера та модель, які перекладають певною мовою. Free: провайдер і модель, вибрані для завдання `translate`, для кожної мови. Tranzly Pro: власний вибір мови, інакше вибір “всі інші мови”.string $targetFree
tranzly_ai_providers_in_useФільтрФільтрує AI-провайдерів, вибраних для конкретних мов. Відсутні у безкоштовному плагіні: кожна мова використовує провайдера та модель, вибрані для завдання `translate`. Tranzly Pro перераховує провайдерів своїх моделей для окремих мов.немаєFree
tranzly_content_before_rebuildФільтрФільтрує вихідний вміст безпосередньо перед записом перекладених сегментів, для кожної мови (використовується заміною зображень для кожної мови в Pro).string $content
string $lang
Free
tranzly_copy_meta_keysФільтрФільтрує мета-ключі, скопійовані з публікації до її нового перекладу. Більше нічого не копіюється.int $source_idFree
tranzly_deepl_hostФільтрФільтрує хост DeepL API (проксі або тестовий дублер).string $host
string $key
Free
tranzly_deepl_price_per_millionФільтрФільтрує ціну DeepL за мільйон символів у доларах США.float $priceFree
tranzly_default_engineФільтрФільтрує id рушія, який використовується, якщо жоден не вказаний.string $idFree
tranzly_engine_capФільтрФільтрує щомісячний ліміт рушія в доларах США: відсутній у безкоштовному плагіні.float|null $cap
string $engine
Free
tranzly_engine_chainФільтрФільтрує рушії для послідовної спроби для мови. Free: типовий рушій. Преміум-рівень додає власний рушій мови та резервний список.string $lang
string $first
Free
tranzly_engine_optionsФільтрФільтрує параметри, що передаються рушію (список слів, які не перекладаються, глосарій, офіційність, інструкції).string $target
Engine $engine
Free
tranzly_engine_settings_saveФільтрЗберігає рушії та AI-моделі для кожної мови, резервний список і щомісячні ліміти. Відповідає лише преміум-рівень (правило WordPress.org 5: жодної Pro-поведінки в безкоштовному плагіні).немаєFree
tranzly_frontend_prefixФільтрФільтрує нейтральний префікс фронтенд-класів.string $prefixFree
tranzly_fs_loadedДія (Action)Спрацьовує після завантаження SDK ліцензування (в основному файлі, перед будь-яким кодом Tranzly). Підключайтеся сюди для взаємодії з `tranzly_fs()`.немаєFree
tranzly_glossary_optionsФільтрФільтрує параметри рушія для цільової мови: список слів, які не перекладаються, а також глосарій і тональність, коли їх додає преміум-рівень.string $langFree
tranzly_glossary_saveФільтрЗберігає бажані переклади та тональність для кожної мови. Відповідає лише преміум-рівень (правило WordPress.org 5: жодної Pro-поведінки в безкоштовному плагіні).немаєFree
tranzly_google_price_per_millionФільтрФільтрує ціну Google Cloud Translation за мільйон символів у доларах США.float $pricePro
tranzly_install_language_packsФільтрЧи встановлює Tranzly мовні пакети WordPress, теми та плагінів для доданої на сайт мови (щоб власні слова WordPress і WooCommerce відображалися перекладеними). Увімкнено за замовчуванням.bool $installFree
tranzly_integration_availableФільтрФільтрує, чи запускається інтеграція, якщо її плагін не виявлено — для вмісту, залишеного конструктором сторінок після його вимкнення, або для плагіна, завантаженого незвичним способом.bool $on
string $id
Free
tranzly_integrationsФільтрФільтрує інтеграції, які запускає Tranzly. Додайте підклас `Integration` для підтримки іншого плагіна.немаєFree
tranzly_is_proФільтрФільтрує, чи працює преміум-рівень. На нього відповідає лише преміум-рівень.bool $proFree
tranzly_job_createdДія (Action)Спрацьовує після створення завдання перекладу.int $job
int $items
Free
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ФільтрФільтрує, чи використовується пам’ять перекладів.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ФільтрФільтрує мета-ключі допису, які містять налаштування robots; кожен переноситься з оригіналу до його перекладів.немаєБезкоштовно
tranzly_shared_string_scopesFilterФільтрує області спільного тексту (смуга L06, T6: інтеграції додають `woocommerce`, `forms` та `theme`; їхні тексти надходять через `tranzly_shared_strings`).noneFree
tranzly_shared_stringsFilterФільтрує спільні тексти, які Tranzly перекладає як рядки, для кожної області. Рівень Pro додає шаблони блоків, частини шаблонів і патерни до `templates`.string $scopeFree
tranzly_shared_strings_coveredFilterФільтрує тексти області спільного тексту, які мовний пакет перекладає для певної мови. Рівень Pro повідомляє про зареєстровані патерни теми та ядра для `templates`.string $scope
string $lang
Free
tranzly_source_changedActionСпрацьовує, коли перекладний вміст оригіналу змінився, тому його переклади застаріли.int $post_id
string $now
string $before
Free
tranzly_source_meta_keysFilterФільтрує метаключі, зміна яких робить переклади сторінки застарілими. Інтеграції додають ключі, які вони перекладають (дані конструктора сторінок, SEO-поля, довільні поля).int $post_idFree
tranzly_source_publishedActionСпрацьовує один раз, коли оригінал публікується вперше (після збереження його метаданих).int $post_idFree
tranzly_style_rules_enabledFilterЧи застосовує Tranzly правила стилю команди перекладу WordPress.org для відповідної мови (лапки, пробіли навколо розділових знаків, апострофи, трикрапка, японські пробіли, займенники звертання) до кожного нового перекладу. Увімкнено за замовчуванням.bool $enabled
string $locale
Free
tranzly_taxonomiesFilterФільтрує таксономії, які перекладає Tranzly.noneFree
tranzly_term_segmentsFilterФільтрує сегменти терміна, що надсилаються до рушія (`name`, `description`, а також усе, що додають інтеграції: SEO-заголовки, довільні поля). Додані сегменти записуються в `tranzly_term_translated`.\WP_Term $termFree
tranzly_term_translatedActionСпрацьовує після того, як рушій переклав термін, разом з усіма перекладеними сегментами (інтеграції записують сегменти, які вони додали в `tranzly_term_segments`).int $target
int $term_id
string $code
Free
tranzly_term_translation_createdActionСпрацьовує після того, як Tranzly створює переклад терміна.int $new_id
int $term_id
string $code
Free
tranzly_translatable_attributesFilterФільтрує атрибути, які Tranzly перекладає для типу блоку.string $block_nameFree
tranzly_translate_stringFilterФільтрує один рядок для перекладу на певну мову.string $value
string $code
array $context
Free
tranzly_translated_post_fieldsFilterФільтрує поля запису, записані в переклад, після виконання рушія. Інтеграції, які додали власні сегменти (довільні поля, дані конструктора), записують їх сюди.\WP_Post $post
string $code
Free
tranzly_translation_memoryFilterФільтрує використовувану пам’ять перекладів: відсутня у безкоштовному плагіні; преміум-рівень пропонує її (docs/843, правило WordPress.org 5).Translation_Memory|null $memoryFree