Разработчикам
Справочник возможностей 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 требуется право (capability), указанное ниже; затем каждая возможность проверяет собственные права для каждого объекта. Возможности только для чтения выполняются с помощью 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Ставит в очередь перевод каждого отсутствующего (или устаревшего) элемента для указанного языка и типа записи. | Free | POST /wp-json/wp-abilities/v1/abilities/tranzly/fix-status/run | edit_posts (собственная проверка REST-маршрута) | post_type stringlang string (обязательно)state string (обязательно): 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 за текущий месяц. | Free | GET /wp-json/wp-abilities/v1/abilities/tranzly/get-deepl-usage/run | manage_options (собственная проверка REST-маршрута) | нет |
tranzly/get-diagnosticsВозвращает диагностические данные, передаваемые в заявке в службу поддержки: версии, активные плагины, лимиты и недавние ошибки. | Free | GET /wp-json/wp-abilities/v1/abilities/tranzly/get-diagnostics/run | manage_options (собственная проверка REST-маршрута) | нет |
tranzly/get-displayВозвращает параметры отображения переключателя языков и копирайта/кредитов. | Free | GET /wp-json/wp-abilities/v1/abilities/tranzly/get-display/run | manage_options (собственная проверка REST-маршрута) | нет |
tranzly/get-engine-settingsВозвращает основной и резервный движки, языковые движки и модели ИИ, состояние каждого движка, подключённых поставщиков ИИ с их моделями, а также расходы за текущий месяц. | Free | 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Отображает список поддерживаемых Tranzly плагинов для SEO, WooCommerce, конструкторов страниц и форм, а также указывает, какие из них активны. | Free | GET /wp-json/wp-abilities/v1/abilities/tranzly/get-integrations/run | manage_options (собственная проверка REST-маршрута) | нет |
tranzly/get-jobВозвращает ход выполнения и показатели одной задачи. | Free | GET /wp-json/wp-abilities/v1/abilities/tranzly/get-job/run | manage_options (собственная проверка REST-маршрута) | id string (обязательно) |
tranzly/get-job-failuresОтображает список элементов задачи с ошибками и причину каждой из них. | Free | GET /wp-json/wp-abilities/v1/abilities/tranzly/get-job-failures/run | manage_options (собственная проверка REST-маршрута) | id string (обязательно) |
tranzly/get-legacy-importВозвращает состояние и отчёт об импорте переводов из Tranzly 2.x. | Free | GET /wp-json/wp-abilities/v1/abilities/tranzly/get-legacy-import/run | manage_options (собственная проверка REST-маршрута) | нет |
tranzly/get-licenceВозвращает тарифный план Tranzly для этого сайта, статус лицензии, дату продления и состав тарифного плана. | Free | GET /wp-json/wp-abilities/v1/abilities/tranzly/get-licence/run | manage_options (собственная проверка REST-маршрута) | нет |
tranzly/get-menusВозвращает информацию о том, какое меню для каждого языка отображается в каждой области меню. | Free | GET /wp-json/wp-abilities/v1/abilities/tranzly/get-menus/run | edit_theme_options (собственная проверка REST-маршрута) | нет |
tranzly/get-post-groupОтображает группу переводов записи: элемент каждого языка с его заголовком, статусом и ссылкой на редактирование. | Free | GET /wp-json/wp-abilities/v1/abilities/tranzly/get-post-group/run | edit_post и edit_term (собственная проверка REST-маршрута) | id string (обязательно) |
tranzly/get-quality-reportВозвращает отчёт ИИ о качестве перевода: оценку и отмеченные сегменты. | Pro | GET /wp-json/wp-abilities/v1/abilities/tranzly/get-quality-report/run | edit_post (собственная проверка REST-маршрута) | id string (обязательно) |
tranzly/get-segmentsВозвращает сегменты перевода рядом с оригиналом для проверки и корректировки. | Free | GET /wp-json/wp-abilities/v1/abilities/tranzly/get-segments/run | edit_post (собственная проверка REST-маршрута) | id string (обязательно) |
tranzly/get-shared-stringsВозвращает тексты темы и плагинов (область видимости) на определённом языке вместе с их переводами. | Free | GET /wp-json/wp-abilities/v1/abilities/tranzly/get-shared-strings/run | edit_theme_options (собственная проверка REST-маршрута) | lang string (обязательно)scope string: menus, site, templates, gettext.plugin-<slug>, gettext.theme-<slug> |
tranzly/get-site-stringsВозвращает название сайта, краткое описание и тексты виджетов на определённом языке. | Free | GET /wp-json/wp-abilities/v1/abilities/tranzly/get-site-strings/run | manage_options (собственная проверка REST-маршрута) | lang string (обязательно) |
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; курсор). | Pro | POST /wp-json/wp-abilities/v1/abilities/tranzly/import-from-source/run | manage_options (собственная проверка REST-маршрута) | source string (обязательно)mode string: dry-run, run, undocursor string |
tranzly/import-translation-fileЗаписывает следующую страницу записей из загруженного файла перевода (повторяйте с параметром after до завершения). | Pro | POST /wp-json/wp-abilities/v1/abilities/tranzly/import-translation-file/run | edit_posts (собственная проверка REST-маршрута) | token string (обязательно)after integer |
tranzly/link-postДелает существующую запись (target) переводом этой записи на указанный язык. | Free | POST /wp-json/wp-abilities/v1/abilities/tranzly/link-post/run | edit_post и edit_term (собственная проверка REST-маршрута) | id string (обязательно)lang string (обязательно)target integer (обязательно) |
tranzly/link-termДелает существующий элемент таксономии (target) переводом этого элемента на указанный язык. | Free | POST /wp-json/wp-abilities/v1/abilities/tranzly/link-term/run | edit_post и edit_term (собственная проверка REST-маршрута) | id string (обязательно)lang string (обязательно)target integer (обязательно) |
tranzly/list-enginesВозвращает список систем перевода, сведения об их настройке и систему по умолчанию, если ни одна не указана. | Free | GET /wp-json/wp-abilities/v1/abilities/tranzly/list-engines/run | edit_posts | нет |
tranzly/list-import-sourcesВозвращает найденные на этом сайте данные WPML, Polylang и TranslatePress, доступные для импорта. | Pro | GET /wp-json/wp-abilities/v1/abilities/tranzly/list-import-sources/run | manage_options (собственная проверка REST-маршрута) | нет |
tranzly/list-jobsВозвращает список фоновых задач перевода от новых к старым с информацией о ходе выполнения. | Free | GET /wp-json/wp-abilities/v1/abilities/tranzly/list-jobs/run | edit_posts (собственная проверка REST-маршрута) | нет |
tranzly/list-languagesВозвращает список языков сайта. Первый — язык, на котором написан исходный контент. | Free | GET /wp-json/wp-abilities/v1/abilities/tranzly/list-languages/run | edit_posts | нет |
tranzly/list-status-itemsПостранично возвращает список оригиналов с состоянием их перевода на указанный язык (состояние: missing, stale, current). | Free | GET /wp-json/wp-abilities/v1/abilities/tranzly/list-status-items/run | edit_posts (собственная проверка REST-маршрута) | post_type stringlang string (обязательно)state string: all, missing, stale, translated, human, machine, review, qualityafter integer |
tranzly/list-theme-stringsВозвращает список тем и плагинов, тексты которых можно просканировать для перевода, и количество строк в каждом из них. | Pro | GET /wp-json/wp-abilities/v1/abilities/tranzly/list-theme-strings/run | manage_options (собственная проверка REST-маршрута) | нет |
tranzly/open-support-ticketСоздаёт обращение в службу поддержки (subject, message, kind, email) с диагностическими данными этого сайта, если администратор дал согласие. Никогда не создаёт и не отправляет учетные данные для входа. | Free | POST /wp-json/wp-abilities/v1/abilities/tranzly/open-support-ticket/run | manage_options (собственная проверка REST-маршрута) | subject string (обязательно)message string (обязательно)kind string: help, bug, feedback, feature_requestemail stringname stringdiagnostics boolean |
tranzly/record-support-consentЗаписывает согласие администратора на отправку диагностических данных вместе с обращениями в службу поддержки. | Free | POST /wp-json/wp-abilities/v1/abilities/tranzly/record-support-consent/run | manage_options (собственная проверка REST-маршрута) | consent boolean (обязательно) |
tranzly/retry-job-itemПовторяет попытку для неудачного элемента (action: retry, при необходимости с другим движком) или отмечает его для ручного перевода (action: by-hand). | Бесплатно | POST /wp-json/wp-abilities/v1/abilities/tranzly/retry-job-item/run | edit_post и manage_options (собственная проверка маршрута REST) | item строка (обязательно)action строка (обязательно)engine строка |
tranzly/review-translationОдобряет перевод (и публикует его, если оригинал опубликован) или отправляет его на доработку (decision, note). | Pro | POST /wp-json/wp-abilities/v1/abilities/tranzly/review-translation/run | edit_post (собственная проверка маршрута REST) | id строка (обязательно)decision строка (обязательно): approve, changes, pendingnote строка |
tranzly/run-legacy-importЗапускает импорт 2.x: dry-run (только отчёт), run или undo. | Бесплатно | POST /wp-json/wp-abilities/v1/abilities/tranzly/run-legacy-import/run | manage_options (собственная проверка маршрута REST) | action строка (обязательно) |
tranzly/scan-theme-stringsСканирует следующую страницу PHP-файлов компонента на наличие переводимых текстов (повторяйте с параметром after до завершения). | Pro | POST /wp-json/wp-abilities/v1/abilities/tranzly/scan-theme-strings/run | manage_options (собственная проверка маршрута REST) | component строка (обязательно)after целое число |
tranzly/schedule-quality-checkПланирует проверку качества с помощью ИИ для следующей страницы переводов языка (или указанных записей). | Pro | POST /wp-json/wp-abilities/v1/abilities/tranzly/schedule-quality-check/run | edit_posts (собственная проверка маршрута REST) | lang строка (обязательно)post_type строкаposts массивafter целое число |
tranzly/seo-auditПроверяет переводы на наличие отсутствующих SEO-заголовков, описаний, ярлыков и hreflang для языка, страница за страницей. | Pro | GET /wp-json/wp-abilities/v1/abilities/tranzly/seo-audit/run | manage_options (собственная проверка маршрута REST) | lang строка (обязательно)after целое число |
tranzly/set-comments-settingДелает комментарии общими для всех переводов записи или сохраняет их отдельно для каждого языка (mode). | Pro | POST /wp-json/wp-abilities/v1/abilities/tranzly/set-comments-setting/run | manage_options и moderate_comments (собственная проверка маршрута REST) | mode строка (обязательно): off, show, translate |
tranzly/set-engine-keyСохраняет API-ключ (и регион для Microsoft) для DeepL, Google или Microsoft; пустое значение удаляет его. Ключи хранятся в зашифрованном виде и никогда не возвращаются. | Бесплатно | POST /wp-json/wp-abilities/v1/abilities/tranzly/set-engine-key/run | manage_options (собственная проверка маршрута REST) | engine строка (обязательно)key строка (обязательно)region строка |
tranzly/set-menusНазначает меню для каждого языка и области отображения (map). | Бесплатно | POST /wp-json/wp-abilities/v1/abilities/tranzly/set-menus/run | edit_theme_options (собственная проверка маршрута REST) | map объект (обязательно) |
tranzly/set-protectionЗащищает перевод от перезаписи движком (protected: true) или снимает блокировку. | Бесплатно | POST /wp-json/wp-abilities/v1/abilities/tranzly/set-protection/run | edit_post (собственная проверка маршрута REST) | id строка (обязательно)protected логическое (обязательно) |
tranzly/set-shared-stringsСохраняет исправленные переводы текстов тем и плагинов (strings); они становятся защищёнными. | Бесплатно | POST /wp-json/wp-abilities/v1/abilities/tranzly/set-shared-strings/run | edit_theme_options (собственная проверка маршрута REST) | lang строка (обязательно)scope строка: menus, site, templates, gettext.plugin-<slug>, gettext.theme-<slug>strings объект (обязательно) |
tranzly/set-site-stringСохраняет один текст сайта (key) на определённом языке, например, название сайта или краткое описание. | Бесплатно | POST /wp-json/wp-abilities/v1/abilities/tranzly/set-site-string/run | edit_theme_options и manage_options (собственная проверка маршрута REST) | lang строка (обязательно)key строка (обязательно)translation строка (обязательно) |
tranzly/set-urlsЗадаёт режим адресов (mode), домены для отдельных языков, переведённые основы и сегменты, noindex_untranslated и варианты ярлыков. | Бесплатно | POST /wp-json/wp-abilities/v1/abilities/tranzly/set-urls/run | manage_options (собственная проверка маршрута REST) | mode строкаsegments объектdomains объектbases объектsuggest логическоеnoindex_untranslated логическое |
tranzly/start-trialЗапускает 14-дневный пробный период Tranzly Pro для этого сайта (оплата не требуется). | Бесплатно | POST /wp-json/wp-abilities/v1/abilities/tranzly/start-trial/run | manage_options (собственная проверка маршрута REST) | нет |
tranzly/translate-media-fieldСохраняет замещающий текст, заголовок или подпись к изображению (поле field) на выбранном языке (lang). | Бесплатно | POST /wp-json/wp-abilities/v1/abilities/tranzly/translate-media-field/run | edit_post (собственная проверка маршрута REST) | id строка (обязательно)lang строка (обязательно)field строка (обязательно): alt, caption, titletranslation строка (обязательно) |
tranzly/translate-postПереводит запись или страницу на один либо несколько языков сайта с помощью механизма перевода, создавая или обновляя каждый перевод. Новые переводы сохраняются как черновики, если publish не равно true. Перевод, отредактированный пользователем, пропускается, если force не равно true. | Бесплатно | POST /wp-json/wp-abilities/v1/abilities/tranzly/translate-post/run | право на перевод этой записи (edit_post для неё); edit_post для существующего перевода; право публикации этого типа записей для публикации | id целое число (обязательно)languages массив (обязательно)engine строкаpublish логическое значениеforce логическое значение |
tranzly/translate-shared-stringsПереводит следующую страницу непереведённых строк темы и плагинов на указанный язык с помощью механизма по умолчанию (повторяйте с параметром after до завершения). | Бесплатно | POST /wp-json/wp-abilities/v1/abilities/tranzly/translate-shared-strings/run | edit_theme_options (собственная проверка маршрута REST) | lang строка (обязательно)scope строка: menus, site, templates, gettext.plugin-<slug>, gettext.theme-<slug>after целое число |
tranzly/translate-siteПошаговый процесс: агент проверяет языки и механизм, оценивает стоимость и переводит недостающие материалы, запрашивая подтверждение перед расходованием средств или публикацией. | Бесплатно | POST /wp-json/wp-abilities/v1/abilities/tranzly/translate-site/run | edit_posts | languages строка (обязательно) |
tranzly/translate-termПереводит элемент таксономии (рубрику, метку или атрибут товара) на указанный язык (lang) с помощью механизма, создавая или обновляя его перевод. | Бесплатно | POST /wp-json/wp-abilities/v1/abilities/tranzly/translate-term/run | собственная проверка прав для каждого элемента в маршруте REST | id строка (обязательно)lang строка (обязательно)engine строкаforce логическое значениеstatus строка: publish, draft |
tranzly/translation-statusПри указании ID записи: перевод этой записи для каждого языка, актуальность перевода и автор. Без него: процент перевода сайта по каждому языку. | Бесплатно | GET /wp-json/wp-abilities/v1/abilities/tranzly/translation-status/run | edit_post для указанной записи; edit_posts для общей сводки сайта | id целое числоpost_type строка |
tranzly/unlink-postУдаляет запись из её группы перевода; исходный язык записи сохраняется. | Бесплатно | POST /wp-json/wp-abilities/v1/abilities/tranzly/unlink-post/run | edit_post и edit_term (собственная проверка маршрута REST) | id строка (обязательно) |
tranzly/unlink-termУдаляет элемент таксономии из его группы перевода. | Бесплатно | POST /wp-json/wp-abilities/v1/abilities/tranzly/unlink-term/run | edit_post и edit_term (собственная проверка маршрута REST) | id строка (обязательно) |
tranzly/update-displayИзменяет переключатель языков (стиль, флаги, названия, расположение) и строку с благодарностью. | Бесплатно | POST /wp-json/wp-abilities/v1/abilities/tranzly/update-display/run | manage_options (собственная проверка маршрута REST) | switcher объектcredit логическое значение |
tranzly/update-engine-settingsЗадаёт механизм по умолчанию, резервный механизм, механизмы для отдельных языков и модели ИИ для отдельных языков (default, fallback, per_lang, models, caps). Все параметры, кроме механизма по умолчанию, доступны только в Pro. | Бесплатно | POST /wp-json/wp-abilities/v1/abilities/tranzly/update-engine-settings/run | manage_options (собственная проверка маршрута REST) | default строкаper_lang объектfallback массивcaps объектmodels объект |
tranzly/update-glossaryЗаменяет переданные вами разделы глоссария (непереводимые слова, переводы терминов, тональность); разделы, которые вы не передали, сохраняются. Применяется всеми механизмами начиная со следующего перевода. | Pro | POST /wp-json/wp-abilities/v1/abilities/tranzly/update-glossary/run | manage_options | dnt массивterms объектtone объект |
tranzly/update-settingsЗадаёт языки сайта (languages: список кодов и названий; первый является исходным языком), префикс классов интерфейса, а также доступ для агентов ИИ (MCP). | Бесплатно | POST /wp-json/wp-abilities/v1/abilities/tranzly/update-settings/run | manage_options (собственная проверка маршрута REST) | prefix строкаmcp логическое значениеlanguages массив |
tranzly/update-workflow-settingsЗадаёт on_update (off, stale, translate), on_publish, review, quality_threshold, quality_provider и quality_model. | Pro | POST /wp-json/wp-abilities/v1/abilities/tranzly/update-workflow-settings/run | manage_options (собственная проверка маршрута REST) | on_update строка: off, stale, translateon_publish логическое значениеreview логическое значениеquality_threshold целое числоquality_provider строкаquality_model строка |
tranzly/upload-translation-fileЗагружает файл Tranzly XLIFF или CSV (content, filename), переведённый в другом месте; возвращает токен, идентифицирующий загрузку для импорта. | Pro | POST /wp-json/wp-abilities/v1/abilities/tranzly/upload-translation-file/run | edit_posts (собственная проверка маршрута REST) | content строка (обязательно)filename строка (обязательно) |
Сгенерировано из файла abilities.json плагина, который сам формируется на основе работающего сайта; тест завершается ошибкой, если они расходятся.
Команды WP-CLI
Запускайте их на сервере с помощью WP-CLI. Каждая команда проверяет те же права доступа, что и экраны плагина; примеры взяты из собственной встроенной справки плагина.
| Команда | Описание | Редакция |
|---|---|---|
wp tranzly create <id> [--term]wp tranzly create 42 --lang=de_DE --user=admin | Создать черновик перевода записи (или термина), связанный с ней. | Бесплатно |
wp tranzly engines | Список систем перевода. | Бесплатно |
wp tranzly jobs <action> [<id>...] [--lang=<codes>] [--post-type=<type>] [--engine=<id>] [--publish] [--force] [--format=<format>]wp tranzly jobs create --lang=de,fr --post-type=page --user=adminwp tranzly jobs status 12wp tranzly jobs failures 12wp tranzly jobs retry 345 --engine=deeplwp tranzly jobs retry-failed 12wp tranzly jobs run 12 # work the job here instead of waiting for the queue runner | Фоновые задачи перевода. | Бесплатно |
wp tranzly legacy <action> [--format=<format>]wp tranzly legacy dry-runwp tranzly legacy runwp tranzly legacy undo | Показать, протестировать (dry-run), выполнить или отменить импорт переводов устаревшего сайта Tranzly (2.x). | Бесплатно |
wp tranzly link <source> <target> [--term] | Связать существующую запись (или термин) как перевод другой. | Бесплатно |
wp tranzly network <action> [--languages=<codes>]wp tranzly network setupwp tranzly network languages --languages=en_US,de_DE,fr_FR | Multisite (Agency): настроить каждый сайт сети или задать языки, с которыми создаются новые сайты. | Бесплатно |
wp tranzly translate [<id>...] [--post-type=<type>] [--engine=<id>] [--force] [--publish] [--dry-run]wp tranzly translate --lang=de --post-type=page --user=adminwp tranzly translate 42 43 --lang=de_DE,fr_FR --engine=deepl --user=admin | Перевести записи с помощью системы перевода. | Бесплатно |
wp tranzly translations <id> [--term] [--format=<format>] | Список переводов записи (или термина). | Бесплатно |
Функции PHP
Функции, которые могут вызывать темы и другие плагины. Сначала проверяйте с помощью function_exists(), чтобы ваш код продолжал работать, если плагин отключен.
| Функция | Что делает | Редакция |
|---|---|---|
icl_object_id( $id, $type = 'post', $return_original_if_missing = false, $lang = null ) | WPML: перевод объекта. | Pro |
pll__( $text ) | Polylang: зарегистрированная строка, переведённая. Tranzly переводит строки тем через собственный gettext WordPress, поэтому строка возвращается в исходном виде. | Pro |
pll_current_language( $field = 'slug' ) | Polylang: текущий язык. | Pro |
pll_default_language( $field = 'slug' ) | Polylang: язык по умолчанию. | Pro |
pll_e( $text ) | Polylang: вывод зарегистрированной строки с экранированием. | Pro |
pll_get_post( $post_id, $lang = null ) | Polylang: перевод записи. | Pro |
pll_get_post_language( $post_id, $field = 'slug' ) | Polylang: язык записи. | Pro |
pll_get_post_translations( $post_id ) | Polylang: все переводы записи, ярлык => 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 => название. | 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 | Filter | Фильтрует данные, с которыми запускается приложение панели управления. Премиум-слой использует его для передачи сведений о редакции; конфиденциальные данные передавать сюда не следует, так как они выводятся в код страницы. | нет | Free |
tranzly_ai_model | Filter | Фильтрует поставщика и модель ИИ, выполняющие перевод на язык. Free: поставщик и модель, выбранные для задачи `translate`, для всех языков. Tranzly Pro: выбор конкретного языка либо вариант «все остальные языки». | string $target | Free |
tranzly_ai_providers_in_use | Filter | Фильтрует поставщиков ИИ, выбранных для конкретных языков. В бесплатном плагине отсутствует: каждый язык использует поставщика и модель, выбранные для задачи `translate`. Tranzly Pro выводит список поставщиков моделей для каждого языка. | нет | Free |
tranzly_content_before_rebuild | Filter | Фильтрует исходное содержимое непосредственно перед записью в него переведённых сегментов для каждого языка (используется функцией подмены изображений по языкам в версии Pro). | string $contentstring $lang | Free |
tranzly_copy_meta_keys | Filter | Фильтрует ключи метаданных, копируемые из записи в её новый перевод. Другие данные не копируются. | int $source_id | Free |
tranzly_deepl_host | Filter | Фильтрует хост DeepL API (прокси-сервер или тестовый дублёр). | string $hoststring $key | Free |
tranzly_deepl_price_per_million | Filter | Фильтрует стоимость одного миллиона символов DeepL в долларах США. | float $price | Free |
tranzly_default_engine | Filter | Фильтрует идентификатор механизма, используемого по умолчанию, когда механизм не указан явно. | string $id | Free |
tranzly_engine_cap | Filter | Фильтрует ежемесячный лимит механизма в долларах США: в бесплатном плагине отсутствует. | float|null $capstring $engine | Free |
tranzly_engine_chain | Filter | Фильтрует механизмы для проверки на соответствие языку в порядке очерёдности. Free: механизм по умолчанию. Премиум-слой добавляет собственный механизм языка и резервный список. | string $langstring $first | Free |
tranzly_engine_options | Filter | Фильтрует параметры, передаваемые механизму (список запрещённых для перевода слов, глоссарий, уровень формальности, инструкции). | string $targetEngine $engine | Free |
tranzly_engine_settings_save | Filter | Сохраняет настройки механизмов и моделей ИИ для отдельных языков, резервный список и ежемесячные лимиты. Обрабатывается только премиум-слоем (правило 5 WordPress.org: никакого Pro-поведения в бесплатном плагине). | нет | Free |
tranzly_frontend_prefix | Filter | Фильтрует нейтральный префикс классов для внешнего интерфейса. | string $prefix | Free |
tranzly_fs_loaded | Action | Срабатывает после загрузки SDK лицензирования (в основном файле, перед кодом Tranzly). Подключайтесь здесь для взаимодействия с `tranzly_fs()`. | нет | Free |
tranzly_glossary_options | Filter | Фильтрует параметры механизма для целевого языка: список непереводимых терминов, а также глоссарий и стиль речи, если они добавлены премиум-слоем. | string $lang | Free |
tranzly_glossary_save | Filter | Сохраняет предпочтительные переводы и стиль речи для каждого языка. Обрабатывается только премиум-слоем (правило 5 WordPress.org: никакого Pro-поведения в бесплатном плагине). | нет | Free |
tranzly_google_price_per_million | Filter | Фильтрует стоимость миллиона символов Google Cloud Translation в долларах США. | float $price | Pro |
tranzly_install_language_packs | Filter | Определяет, устанавливает ли Tranzly языковые пакеты WordPress, тем и плагинов для языка, добавленного на сайт (чтобы собственные фразы WordPress и WooCommerce отображались переведёнными). По умолчанию включено. | bool $install | Free |
tranzly_integration_available | Filter | Фильтрует, запускается ли интеграция, если плагин не обнаружен (для содержимого, оставленного конструктором страниц после отключения, или если плагин загружен нестандартным способом). | bool $onstring $id | Free |
tranzly_integrations | Filter | Фильтрует интеграции, запускаемые Tranzly. Добавьте подкласс `Integration` для поддержки другого плагина. | нет | Free |
tranzly_is_pro | Filter | Фильтрует состояние активности премиум-слоя. Отвечает только премиум-слой. | bool $pro | Free |
tranzly_job_created | Action | Срабатывает после создания задачи перевода. | int $jobint $items | Free |
tranzly_job_finished | Действие | Срабатывает, когда в задаче перевода не осталось работы. | int $job_id | Free |
tranzly_kit_api_base | Фильтр | Фильтрует базовый адрес API Zinn Digital®, к которому обращаются экраны поддержки. | string $base | Free |
tranzly_kit_diagnostics | Фильтр | Фильтрует диагностические данные перед тем, как их увидит владелец сайта. Плагин добавляет свои факты в extra. ⛔ Выполняется ДО предпросмотра, но никогда между предпросмотром и отправкой. | нет | Free |
tranzly_kit_footprint_free | Фильтр | Фильтрует, является ли сайт свободным от цифрового следа, чтобы на нём никогда не рекламировался Zinn® Ads. | bool $footprint_free | Free |
tranzly_kit_promotions | Фильтр | Фильтрует реестр промо-акций перед его обработкой. Добавьте строку для продвижения другого продукта: id, kind (hosting|marketplace|platform|plugin|bundle|ads), slot (promo|cross-sell) и url или (для плагина) name, site, main_files. | нет | Free |
tranzly_kit_tier | Фильтр | Фильтрует уровень тарифа, о котором набор сообщает для этого плагина (тесты и среда разработки; в продакшене определяет лицензия). | string $tier | Free |
tranzly_localize_links | Фильтр | Фильтрует, перенаправляет ли Tranzly внутренние ссылки этой страницы на их переводы. | bool $localizestring $lang | Free |
tranzly_memory_enabled | Фильтр | Фильтрует, используется ли память переводов. | bool $on | Pro |
tranzly_microsoft_price_per_million | Фильтр | Фильтрует цену Microsoft Translator за миллион символов в долларах США. | float $price | Pro |
tranzly_network_enabled | Фильтр | Фильтрует, включён ли сетевой уровень мультисайта. | bool $agency | Free |
tranzly_pbs_internal_post_types | Фильтр | Фильтрует типы записей Page Builder Sandwich, которые Tranzly оставляет без изменений. | нет | Free |
tranzly_post_segments | Фильтр | Фильтрует сегменты записи, отправляемые в движок. Key => text + format (text или html). Парсер с поддержкой блоков и интеграции добавляют, разделяют или заменяют сегменты здесь и записывают их обратно в tranzly_translated_post_fields. | \WP_Post $post | Free |
tranzly_post_translated | Действие | Срабатывает после того, как движок перевёл запись (или когда её записал файл пользователя или импорт). | int $targetint $source_idstring $codestring $engine | Free |
tranzly_post_translation_created | Действие | Срабатывает после того, как Tranzly создаёт перевод записи. | int $new_idint $source_idstring $code | Free |
tranzly_post_types | Фильтр | Фильтрует типы записей, которые переводит Tranzly. | нет | Free |
tranzly_pre_current_language | Фильтр | Переопределяет текущий язык напрямую: верните код языка, чтобы использовать его. Так работает tranzly_switch_language(); верните null, чтобы Tranzly определил его сам. | string|null $lang | Free |
tranzly_query_var | Фильтр | Фильтрует переменную запроса, выбирающую язык. | string $var | Free |
tranzly_queue_lease_seconds | Фильтр | Фильтрует время аренды запрошенного элемента: по его истечении воркер, аварийно завершившийся во время обработки, возвращает элемент остальным. Должно быть больше времени самого медленного одиночного перевода. | int $seconds | Free |
tranzly_queue_worker_seconds | Фильтр | Фильтрует время работы одного воркера до передачи управления в секундах. | int $seconds | Free |
tranzly_queue_workers | Фильтр | Фильтрует количество воркеров, одновременно запускаемых одной задачей. Ограничение именно ВОРКЕРОВ, чтобы бережно использовать сервис перевода; но не ограничение количества выполняемых элементов. | int $workersint $job_id | Free |
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 | Free |
tranzly_relations_changed | Действие | Срабатывает после изменения связей перевода объектов: при связывании, отмене связи, переносе на другой язык или удалении. Срабатывает один раз для каждой затронутой группы, поэтому одно связывание может вызвать его дважды. | string $typearray<int> $ids | Free |
tranzly_robots_meta_keys | Фильтр | Фильтрует мета-ключи записей с настройками robots; каждый копируется из оригинала в его переводы. | нет | Free |
tranzly_shared_string_scopes | Фильтр | Фильтрует области общих текстов (дорожка L06, T6: интеграции добавляют `woocommerce`, `forms` и `theme`; их тексты поступают через `tranzly_shared_strings`). | нет | Бесплатно |
tranzly_shared_strings | Фильтр | Фильтрует общие тексты, которые Tranzly переводит как строки, по областям. Уровень Pro добавляет шаблоны блоков, части шаблонов и паттерны в `templates`. | string $scope | Бесплатно |
tranzly_shared_strings_covered | Фильтр | Фильтрует тексты области общих текстов, которые языковой пакет переводит для языка. Уровень Pro сообщает о зарегистрированных паттернах темы и ядра для `templates`. | string $scopestring $lang | Бесплатно |
tranzly_source_changed | Действие | Срабатывает, когда переводимое содержимое оригинала изменилось, и его переводы устарели. | int $post_idstring $nowstring $before | Бесплатно |
tranzly_source_meta_keys | Фильтр | Фильтрует метаключи, изменение которых делает переводы страницы устаревшими. Интеграции добавляют переводимые ими ключи (данные конструктора, SEO-поля, произвольные поля). | int $post_id | Бесплатно |
tranzly_source_published | Действие | Срабатывает один раз при первой публикации оригинала (после сохранения его метаданных). | int $post_id | Бесплатно |
tranzly_style_rules_enabled | Фильтр | Определяет, применяет ли Tranzly правила стиля команды перевода WordPress.org для соответствующего языка (кавычки, пробелы вокруг знаков препинания, апострофы, многоточие, японские пробелы, местоимения обращения) к каждому новому переводу. По умолчанию включено. | bool $enabledstring $locale | Бесплатно |
tranzly_taxonomies | Фильтр | Фильтрует таксономии, которые переводит Tranzly. | нет | Бесплатно |
tranzly_term_segments | Фильтр | Фильтрует сегменты термина, отправляемые в движок (`name`, `description`, а также всё, что добавляют интеграции: SEO-заголовки, произвольные поля). Записывайте добавленные сегменты в `tranzly_term_translated`. | \WP_Term $term | Бесплатно |
tranzly_term_translated | Действие | Срабатывает после того, как движок перевёл термин, передавая каждый переведённый сегмент (интеграции записывают добавленные ими сегменты в `tranzly_term_segments`). | int $targetint $term_idstring $code | Бесплатно |
tranzly_term_translation_created | Действие | Срабатывает после создания перевода термина плагином Tranzly. | int $new_idint $term_idstring $code | Бесплатно |
tranzly_translatable_attributes | Фильтр | Фильтрует атрибуты, переводимые Tranzly для типа блока. | string $block_name | Бесплатно |
tranzly_translate_string | Фильтр | Фильтрует одну переводимую строку на целевой язык. | string $valuestring $codearray $context | Бесплатно |
tranzly_translated_post_fields | Фильтр | Фильтрует поля записи, записываемые в перевод после работы движка. Интеграции, добавившие свои сегменты (произвольные поля, данные конструктора), записывают их здесь. | \WP_Post $poststring $code | Бесплатно |
tranzly_translation_memory | Фильтр | Фильтрует используемую память переводов: отсутствует в бесплатном плагине; премиум-уровень предоставляет её (docs/843, правило 5 WordPress.org). | Translation_Memory|null $memory | Бесплатно |