Розробники
Довідник можливостей (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Запускає фонові завдання перекладу для кожного оригіналу вказаних типів вмісту (усі типи, що перекладаються, якщо жодного не вказано): відсутні переклади, застарілі або всі. Повертає запущені завдання, по одному на мову. | 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Зупиняє завдання; уже виконані переклади зберігаються. | Free | 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® (ім’я, електронна пошта, згода). | Free | POST /wp-json/wp-abilities/v1/abilities/tranzly/connect-support/run | manage_options (власна перевірка маршруту REST) | email рядок (обов’язково)name рядокconsent булеве (обов’язково) |
tranzly/correct-segmentsЗберігає виправлені сегменти перекладу (сегменти: ключ до тексту); виправлений текст захищено від повторного перекладу. | Free | POST /wp-json/wp-abilities/v1/abilities/tranzly/correct-segments/run | edit_post (власна перевірка маршруту REST) | id рядок (обов’язково)segments об’єктtexts об’єкт |
tranzly/create-jobЗапускає фонове завдання з перекладу перелічених дописів (posts) або цілого типу дописів мовами (langs). | Free | 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) для написання вручну, без системи машинного перекладу. | Free | POST /wp-json/wp-abilities/v1/abilities/tranzly/create-post-translation/run | власна перевірка дозволів маршруту REST для кожного елемента | id рядок (обов’язково)lang рядок (обов’язково)name рядокslug рядокdescription рядок |
tranzly/create-term-translationСтворює переклад терміна певною мовою із зазначеними назвою, слагом та описом. | Free | POST /wp-json/wp-abilities/v1/abilities/tranzly/create-term-translation/run | власна перевірка дозволів маршруту REST для кожного елемента | id рядок (обов’язково)lang рядок (обов’язково)name рядокslug рядокdescription рядок |
tranzly/disconnect-supportВідключає цей сайт від служби підтримки. | Free | POST /wp-json/wp-abilities/v1/abilities/tranzly/disconnect-support/run | manage_options (власна перевірка маршруту REST) | немає |
tranzly/estimateОцінює кількість символів і вартість перекладу дописів (posts або post_type) вибраними мовами (langs) за допомогою системи перекладу перед тим, як витрачати кошти. | Free | 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Повертає основний і резервний рушії, рушії та моделі ШІ для окремих мов, стан кожного рушія, підключених постачальників ШІ з їхніми моделями та витрати за цей місяць. | Безкоштовно | 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Повертає звіт про якість перекладу від ШІ: оцінку та позначені сегменти. | 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Повертає спосіб відображення мов в адресах (папка, субдомен або домен), перекладені ярлики й основи, а також 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Створює запит до служби підтримки (тема, повідомлення, тип, електронна пошта) з діагностичними даними цього сайту, якщо адміністратор надав згоду. Ніколи не створює та не надсилає облікові дані для входу. | 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). | Free | POST /wp-json/wp-abilities/v1/abilities/tranzly/retry-job-item/run | edit_post і manage_options (власна перевірка маршруту REST) | item string (обов’язково)action string (обов’язково)engine string |
tranzly/review-translationСхвалює переклад (і публікує його, коли опубліковано оригінал) або відправляє його назад (decision, note). | Pro | POST /wp-json/wp-abilities/v1/abilities/tranzly/review-translation/run | edit_post (власна перевірка маршруту REST) | id string (обов’язково)decision string (обов’язково): approve, changes, pendingnote string |
tranzly/run-legacy-importЗапускає імпорт 2.x: dry-run (тільки звіт), run або undo. | Free | POST /wp-json/wp-abilities/v1/abilities/tranzly/run-legacy-import/run | manage_options (власна перевірка маршруту REST) | action string (обов’язково) |
tranzly/scan-theme-stringsСканує наступну сторінку PHP-файлів компонента на наявність перекладних текстів (повторюйте з after до завершення). | Pro | POST /wp-json/wp-abilities/v1/abilities/tranzly/scan-theme-strings/run | manage_options (власна перевірка маршруту REST) | component string (обов’язково)after integer |
tranzly/schedule-quality-checkПланує перевірку якості за допомогою ШІ для наступної сторінки перекладів мови (або для вказаних записів). | Pro | POST /wp-json/wp-abilities/v1/abilities/tranzly/schedule-quality-check/run | edit_posts (власна перевірка маршруту REST) | lang string (обов’язково)post_type stringposts arrayafter integer |
tranzly/seo-auditПеревіряє переклади на відсутність SEO-заголовків, описів, ярликів і hreflang для певної мови, сторінка за сторінкою. | Pro | GET /wp-json/wp-abilities/v1/abilities/tranzly/seo-audit/run | manage_options (власна перевірка маршруту REST) | lang string (обов’язково)after integer |
tranzly/set-comments-settingСпільно використовує коментарі між перекладами запису або зберігає їх окремо для кожної мови (mode). | Pro | POST /wp-json/wp-abilities/v1/abilities/tranzly/set-comments-setting/run | manage_options і moderate_comments (власна перевірка маршруту REST) | mode string (обов’язково): off, show, translate |
tranzly/set-engine-keyЗберігає ключ API (і регіон для Microsoft) для DeepL, Google або Microsoft; порожній видаляє його. Ключі зберігаються в зашифрованому вигляді і ніколи не повертаються. | Free | POST /wp-json/wp-abilities/v1/abilities/tranzly/set-engine-key/run | manage_options (власна перевірка маршруту REST) | engine string (обов’язково)key string (обов’язково)region string |
tranzly/set-menusПризначає меню для кожної мови для кожної області відображення (map). | Free | POST /wp-json/wp-abilities/v1/abilities/tranzly/set-menus/run | edit_theme_options (власна перевірка маршруту REST) | map object (обов’язково) |
tranzly/set-protectionЗахищає переклад від перезапису рушієм (protected: true) або розблоковує його. | Free | POST /wp-json/wp-abilities/v1/abilities/tranzly/set-protection/run | edit_post (власна перевірка маршруту REST) | id string (обов’язково)protected boolean (обов’язково) |
tranzly/set-shared-stringsЗберігає виправлені переклади текстів теми та плагінів (рядків); вони стають захищеними. | Free | POST /wp-json/wp-abilities/v1/abilities/tranzly/set-shared-strings/run | edit_theme_options (власна перевірка маршруту REST) | lang string (обов’язково)scope string: menus, site, templates, gettext.plugin-<slug>, gettext.theme-<slug>strings object (обов’язково) |
tranzly/set-site-stringЗберігає один текст сайту (ключ) певною мовою, наприклад, назву сайту або опис. | Free | POST /wp-json/wp-abilities/v1/abilities/tranzly/set-site-string/run | edit_theme_options і manage_options (власна перевірка маршруту REST) | lang string (обов’язково)key string (обов’язково)translation string (обов’язково) |
tranzly/set-urlsВстановлює режим адрес (mode), домени для кожної мови, перекладені основи та сегменти, noindex_untranslated і пропозиції ярликів. | Free | POST /wp-json/wp-abilities/v1/abilities/tranzly/set-urls/run | manage_options (власна перевірка маршруту REST) | mode stringsegments objectdomains objectbases objectsuggest booleannoindex_untranslated boolean |
tranzly/start-trialЗапускає 14-денну пробну версію Tranzly Pro для цього сайту (оплата не потрібна). | Free | 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 string (обов’язково)lang string (обов’язково)field string (обов’язково): alt, caption, titletranslation 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 stringpublish booleanforce boolean |
tranzly/translate-shared-stringsПерекладає наступну сторінку неперекладених текстів теми та плагінів потрібною мовою за допомогою стандартного рушія (повторюйте з after до завершення). | Безкоштовно | POST /wp-json/wp-abilities/v1/abilities/tranzly/translate-shared-strings/run | edit_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/run | edit_posts | languages string (обов’язково) |
tranzly/translate-termПерекладає один термін (категорію, позначку або атрибут товару) потрібною мовою (lang) за допомогою рушія, створюючи або оновлюючи його переклад. | Безкоштовно | POST /wp-json/wp-abilities/v1/abilities/tranzly/translate-term/run | власна перевірка дозволів маршруту REST для кожного елемента | id string (обов’язково)lang string (обов’язково)engine stringforce booleanstatus string: publish, draft |
tranzly/translation-statusЗ ідентифікатором запису: переклад цього запису кожною мовою, чи він застарів, і хто його створив. Без нього: яка частина сайту перекладена (для кожної мови). | Безкоштовно | GET /wp-json/wp-abilities/v1/abilities/tranzly/translation-status/run | edit_post для цього запису; edit_posts для зведення по сайту | id integerpost_type string |
tranzly/unlink-postВилучає запис із його групи перекладу; його мова зберігається. | Безкоштовно | POST /wp-json/wp-abilities/v1/abilities/tranzly/unlink-post/run | edit_post і edit_term (власна перевірка маршруту REST) | id string (обов’язково) |
tranzly/unlink-termВилучає термін із його групи перекладу. | Безкоштовно | POST /wp-json/wp-abilities/v1/abilities/tranzly/unlink-term/run | edit_post і edit_term (власна перевірка маршруту REST) | id string (обов’язково) |
tranzly/update-displayЗмінює перемикач (стиль, прапори, назви, розташування) та рядок авторства. | Безкоштовно | POST /wp-json/wp-abilities/v1/abilities/tranzly/update-display/run | manage_options (власна перевірка маршруту REST) | switcher objectcredit boolean |
tranzly/update-engine-settingsНалаштовує стандартний рушій, резервний рушій, рушії для окремих мов та моделі ШІ для окремих мов (default, fallback, per_lang, models, caps). Усе, крім стандартного рушія, доступно лише у версії Pro. | Безкоштовно | POST /wp-json/wp-abilities/v1/abilities/tranzly/update-engine-settings/run | manage_options (власна перевірка маршруту REST) | default stringper_lang objectfallback arraycaps objectmodels object |
tranzly/update-glossaryЗамінює передані вами частини глосарія (слова, які ніколи не перекладаються, переклади термінів, тон); не передані частини залишаються без змін. Використовується кожним рушієм, починаючи з наступного перекладу. | Pro | POST /wp-json/wp-abilities/v1/abilities/tranzly/update-glossary/run | manage_options | dnt arrayterms objecttone object |
tranzly/update-settingsВстановлює мови сайту (languages: список кодів і назв; перша є оригінальною мовою), префікс класів для інтерфейсу, а також чи дозволені ШІ-агенти (MCP). | Безкоштовно | POST /wp-json/wp-abilities/v1/abilities/tranzly/update-settings/run | manage_options (власна перевірка маршруту REST) | prefix stringmcp booleanlanguages array |
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 string: off, stale, translateon_publish booleanreview booleanquality_threshold integerquality_provider stringquality_model string |
tranzly/upload-translation-fileЗавантажує файл Tranzly XLIFF або CSV (content, filename), перекладений в іншому місці; повертає токен, який ідентифікує завантаження для імпорту. | Pro | POST /wp-json/wp-abilities/v1/abilities/tranzly/upload-translation-file/run | edit_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=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 | Фонові завдання перекладу. | Free |
wp tranzly legacy <action> [--format=<format>]wp tranzly legacy dry-runwp tranzly legacy runwp tranzly legacy undo | Показати, провести тестовий запуск, виконати або скасувати імпорт перекладів зі старого сайту Tranzly (2.x). | Free |
wp tranzly link <source> <target> [--term] | Пов’язати наявний запис (або термін) як переклад іншого. | Free |
wp tranzly network <action> [--languages=<codes>]wp tranzly network setupwp 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=adminwp 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 ): ?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 | URL-адреса, що відображає вказану мову. | 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 $barint $id | Free |
tranzly_admin_data | Фільтр | Фільтрує дані, з якими завантажується додаток панелі адміністратора. Преміум-рівень використовує це для повідомлення своєї редакції; сюди не слід додавати конфіденційні дані, оскільки вони виводяться на сторінці. | немає | Free |
tranzly_ai_model | Фільтр | Фільтрує AI-провайдера та модель, які перекладають певною мовою. Free: провайдер і модель, вибрані для завдання `translate`, для кожної мови. Tranzly Pro: власний вибір мови, інакше вибір “всі інші мови”. | string $target | Free |
tranzly_ai_providers_in_use | Фільтр | Фільтрує AI-провайдерів, вибраних для конкретних мов. Відсутні у безкоштовному плагіні: кожна мова використовує провайдера та модель, вибрані для завдання `translate`. Tranzly Pro перераховує провайдерів своїх моделей для окремих мов. | немає | Free |
tranzly_content_before_rebuild | Фільтр | Фільтрує вихідний вміст безпосередньо перед записом перекладених сегментів, для кожної мови (використовується заміною зображень для кожної мови в Pro). | string $contentstring $lang | Free |
tranzly_copy_meta_keys | Фільтр | Фільтрує мета-ключі, скопійовані з публікації до її нового перекладу. Більше нічого не копіюється. | int $source_id | Free |
tranzly_deepl_host | Фільтр | Фільтрує хост DeepL API (проксі або тестовий дублер). | string $hoststring $key | Free |
tranzly_deepl_price_per_million | Фільтр | Фільтрує ціну DeepL за мільйон символів у доларах США. | float $price | Free |
tranzly_default_engine | Фільтр | Фільтрує id рушія, який використовується, якщо жоден не вказаний. | string $id | Free |
tranzly_engine_cap | Фільтр | Фільтрує щомісячний ліміт рушія в доларах США: відсутній у безкоштовному плагіні. | float|null $capstring $engine | Free |
tranzly_engine_chain | Фільтр | Фільтрує рушії для послідовної спроби для мови. Free: типовий рушій. Преміум-рівень додає власний рушій мови та резервний список. | string $langstring $first | Free |
tranzly_engine_options | Фільтр | Фільтрує параметри, що передаються рушію (список слів, які не перекладаються, глосарій, офіційність, інструкції). | string $targetEngine $engine | Free |
tranzly_engine_settings_save | Фільтр | Зберігає рушії та AI-моделі для кожної мови, резервний список і щомісячні ліміти. Відповідає лише преміум-рівень (правило WordPress.org 5: жодної Pro-поведінки в безкоштовному плагіні). | немає | Free |
tranzly_frontend_prefix | Фільтр | Фільтрує нейтральний префікс фронтенд-класів. | string $prefix | Free |
tranzly_fs_loaded | Дія (Action) | Спрацьовує після завантаження SDK ліцензування (в основному файлі, перед будь-яким кодом Tranzly). Підключайтеся сюди для взаємодії з `tranzly_fs()`. | немає | Free |
tranzly_glossary_options | Фільтр | Фільтрує параметри рушія для цільової мови: список слів, які не перекладаються, а також глосарій і тональність, коли їх додає преміум-рівень. | string $lang | Free |
tranzly_glossary_save | Фільтр | Зберігає бажані переклади та тональність для кожної мови. Відповідає лише преміум-рівень (правило WordPress.org 5: жодної Pro-поведінки в безкоштовному плагіні). | немає | Free |
tranzly_google_price_per_million | Фільтр | Фільтрує ціну Google Cloud Translation за мільйон символів у доларах США. | float $price | Pro |
tranzly_install_language_packs | Фільтр | Чи встановлює Tranzly мовні пакети WordPress, теми та плагінів для доданої на сайт мови (щоб власні слова WordPress і WooCommerce відображалися перекладеними). Увімкнено за замовчуванням. | bool $install | Free |
tranzly_integration_available | Фільтр | Фільтрує, чи запускається інтеграція, якщо її плагін не виявлено — для вмісту, залишеного конструктором сторінок після його вимкнення, або для плагіна, завантаженого незвичним способом. | bool $onstring $id | Free |
tranzly_integrations | Фільтр | Фільтрує інтеграції, які запускає Tranzly. Додайте підклас `Integration` для підтримки іншого плагіна. | немає | Free |
tranzly_is_pro | Фільтр | Фільтрує, чи працює преміум-рівень. На нього відповідає лише преміум-рівень. | bool $pro | Free |
tranzly_job_created | Дія (Action) | Спрацьовує після створення завдання перекладу. | int $jobint $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 $localizestring $lang | Безкоштовно |
tranzly_memory_enabled | Фільтр | Фільтрує, чи використовується пам’ять перекладів. | 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 | Фільтр | Фільтрує мета-ключі допису, які містять налаштування robots; кожен переноситься з оригіналу до його перекладів. | немає | Безкоштовно |
tranzly_shared_string_scopes | Filter | Фільтрує області спільного тексту (смуга L06, T6: інтеграції додають `woocommerce`, `forms` та `theme`; їхні тексти надходять через `tranzly_shared_strings`). | none | Free |
tranzly_shared_strings | Filter | Фільтрує спільні тексти, які Tranzly перекладає як рядки, для кожної області. Рівень Pro додає шаблони блоків, частини шаблонів і патерни до `templates`. | string $scope | Free |
tranzly_shared_strings_covered | Filter | Фільтрує тексти області спільного тексту, які мовний пакет перекладає для певної мови. Рівень Pro повідомляє про зареєстровані патерни теми та ядра для `templates`. | string $scopestring $lang | Free |
tranzly_source_changed | Action | Спрацьовує, коли перекладний вміст оригіналу змінився, тому його переклади застаріли. | int $post_idstring $nowstring $before | Free |
tranzly_source_meta_keys | Filter | Фільтрує метаключі, зміна яких робить переклади сторінки застарілими. Інтеграції додають ключі, які вони перекладають (дані конструктора сторінок, SEO-поля, довільні поля). | int $post_id | Free |
tranzly_source_published | Action | Спрацьовує один раз, коли оригінал публікується вперше (після збереження його метаданих). | int $post_id | Free |
tranzly_style_rules_enabled | Filter | Чи застосовує Tranzly правила стилю команди перекладу WordPress.org для відповідної мови (лапки, пробіли навколо розділових знаків, апострофи, трикрапка, японські пробіли, займенники звертання) до кожного нового перекладу. Увімкнено за замовчуванням. | bool $enabledstring $locale | Free |
tranzly_taxonomies | Filter | Фільтрує таксономії, які перекладає Tranzly. | none | Free |
tranzly_term_segments | Filter | Фільтрує сегменти терміна, що надсилаються до рушія (`name`, `description`, а також усе, що додають інтеграції: SEO-заголовки, довільні поля). Додані сегменти записуються в `tranzly_term_translated`. | \WP_Term $term | Free |
tranzly_term_translated | Action | Спрацьовує після того, як рушій переклав термін, разом з усіма перекладеними сегментами (інтеграції записують сегменти, які вони додали в `tranzly_term_segments`). | int $targetint $term_idstring $code | Free |
tranzly_term_translation_created | Action | Спрацьовує після того, як Tranzly створює переклад терміна. | int $new_idint $term_idstring $code | Free |
tranzly_translatable_attributes | Filter | Фільтрує атрибути, які Tranzly перекладає для типу блоку. | string $block_name | Free |
tranzly_translate_string | Filter | Фільтрує один рядок для перекладу на певну мову. | string $valuestring $codearray $context | Free |
tranzly_translated_post_fields | Filter | Фільтрує поля запису, записані в переклад, після виконання рушія. Інтеграції, які додали власні сегменти (довільні поля, дані конструктора), записують їх сюди. | \WP_Post $poststring $code | Free |
tranzly_translation_memory | Filter | Фільтрує використовувану пам’ять перекладів: відсутня у безкоштовному плагіні; преміум-рівень пропонує її (docs/843, правило WordPress.org 5). | Translation_Memory|null $memory | Free |