Разработчикам

Справочник возможностей 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
Запускает фоновые задания перевода для каждого оригинала указанных типов контента (для всех переводимых типов, если ничего не указано): недостающие переводы, устаревшие или все сразу. Возвращает запущенные задания, по одному на язык.
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собственная поэлементная проверка прав маршрута RESTid строка (обязательно)
lang строка (обязательно)
name строка
slug строка
description строка
tranzly/create-term-translation
Создаёт перевод термина таксономии на определённый язык с указанными вами названием, ярлыком и описанием.
FreePOST /wp-json/wp-abilities/v1/abilities/tranzly/create-term-translation/runсобственная поэлементная проверка прав маршрута RESTid строка (обязательно)
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
Ставит в очередь перевод каждого отсутствующего (или устаревшего) элемента для указанного языка и типа записи.
FreePOST /wp-json/wp-abilities/v1/abilities/tranzly/fix-status/runedit_posts (собственная проверка REST-маршрута)post_type string
lang string (обязательно)
state string (обязательно): 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 за текущий месяц.
FreeGET /wp-json/wp-abilities/v1/abilities/tranzly/get-deepl-usage/runmanage_options (собственная проверка REST-маршрута)нет
tranzly/get-diagnostics
Возвращает диагностические данные, передаваемые в заявке в службу поддержки: версии, активные плагины, лимиты и недавние ошибки.
FreeGET /wp-json/wp-abilities/v1/abilities/tranzly/get-diagnostics/runmanage_options (собственная проверка REST-маршрута)нет
tranzly/get-display
Возвращает параметры отображения переключателя языков и копирайта/кредитов.
FreeGET /wp-json/wp-abilities/v1/abilities/tranzly/get-display/runmanage_options (собственная проверка REST-маршрута)нет
tranzly/get-engine-settings
Возвращает основной и резервный движки, языковые движки и модели ИИ, состояние каждого движка, подключённых поставщиков ИИ с их моделями, а также расходы за текущий месяц.
FreeGET /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
Отображает список поддерживаемых Tranzly плагинов для SEO, WooCommerce, конструкторов страниц и форм, а также указывает, какие из них активны.
FreeGET /wp-json/wp-abilities/v1/abilities/tranzly/get-integrations/runmanage_options (собственная проверка REST-маршрута)нет
tranzly/get-job
Возвращает ход выполнения и показатели одной задачи.
FreeGET /wp-json/wp-abilities/v1/abilities/tranzly/get-job/runmanage_options (собственная проверка REST-маршрута)id string (обязательно)
tranzly/get-job-failures
Отображает список элементов задачи с ошибками и причину каждой из них.
FreeGET /wp-json/wp-abilities/v1/abilities/tranzly/get-job-failures/runmanage_options (собственная проверка REST-маршрута)id string (обязательно)
tranzly/get-legacy-import
Возвращает состояние и отчёт об импорте переводов из Tranzly 2.x.
FreeGET /wp-json/wp-abilities/v1/abilities/tranzly/get-legacy-import/runmanage_options (собственная проверка REST-маршрута)нет
tranzly/get-licence
Возвращает тарифный план Tranzly для этого сайта, статус лицензии, дату продления и состав тарифного плана.
FreeGET /wp-json/wp-abilities/v1/abilities/tranzly/get-licence/runmanage_options (собственная проверка REST-маршрута)нет
tranzly/get-menus
Возвращает информацию о том, какое меню для каждого языка отображается в каждой области меню.
FreeGET /wp-json/wp-abilities/v1/abilities/tranzly/get-menus/runedit_theme_options (собственная проверка REST-маршрута)нет
tranzly/get-post-group
Отображает группу переводов записи: элемент каждого языка с его заголовком, статусом и ссылкой на редактирование.
FreeGET /wp-json/wp-abilities/v1/abilities/tranzly/get-post-group/runedit_post и edit_term (собственная проверка REST-маршрута)id string (обязательно)
tranzly/get-quality-report
Возвращает отчёт ИИ о качестве перевода: оценку и отмеченные сегменты.
ProGET /wp-json/wp-abilities/v1/abilities/tranzly/get-quality-report/runedit_post (собственная проверка REST-маршрута)id string (обязательно)
tranzly/get-segments
Возвращает сегменты перевода рядом с оригиналом для проверки и корректировки.
FreeGET /wp-json/wp-abilities/v1/abilities/tranzly/get-segments/runedit_post (собственная проверка REST-маршрута)id string (обязательно)
tranzly/get-shared-strings
Возвращает тексты темы и плагинов (область видимости) на определённом языке вместе с их переводами.
FreeGET /wp-json/wp-abilities/v1/abilities/tranzly/get-shared-strings/runedit_theme_options (собственная проверка REST-маршрута)lang string (обязательно)
scope string: menus, site, templates, gettext.plugin-<slug>, gettext.theme-<slug>
tranzly/get-site-strings
Возвращает название сайта, краткое описание и тексты виджетов на определённом языке.
FreeGET /wp-json/wp-abilities/v1/abilities/tranzly/get-site-strings/runmanage_options (собственная проверка REST-маршрута)lang string (обязательно)
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; курсор).
ProPOST /wp-json/wp-abilities/v1/abilities/tranzly/import-from-source/runmanage_options (собственная проверка REST-маршрута)source string (обязательно)
mode string: dry-run, run, undo
cursor string
tranzly/import-translation-file
Записывает следующую страницу записей из загруженного файла перевода (повторяйте с параметром after до завершения).
ProPOST /wp-json/wp-abilities/v1/abilities/tranzly/import-translation-file/runedit_posts (собственная проверка REST-маршрута)token string (обязательно)
after integer
tranzly/link-post
Делает существующую запись (target) переводом этой записи на указанный язык.
FreePOST /wp-json/wp-abilities/v1/abilities/tranzly/link-post/runedit_post и edit_term (собственная проверка REST-маршрута)id string (обязательно)
lang string (обязательно)
target integer (обязательно)
tranzly/link-term
Делает существующий элемент таксономии (target) переводом этого элемента на указанный язык.
FreePOST /wp-json/wp-abilities/v1/abilities/tranzly/link-term/runedit_post и edit_term (собственная проверка REST-маршрута)id string (обязательно)
lang string (обязательно)
target integer (обязательно)
tranzly/list-engines
Возвращает список систем перевода, сведения об их настройке и систему по умолчанию, если ни одна не указана.
FreeGET /wp-json/wp-abilities/v1/abilities/tranzly/list-engines/runedit_postsнет
tranzly/list-import-sources
Возвращает найденные на этом сайте данные WPML, Polylang и TranslatePress, доступные для импорта.
ProGET /wp-json/wp-abilities/v1/abilities/tranzly/list-import-sources/runmanage_options (собственная проверка REST-маршрута)нет
tranzly/list-jobs
Возвращает список фоновых задач перевода от новых к старым с информацией о ходе выполнения.
FreeGET /wp-json/wp-abilities/v1/abilities/tranzly/list-jobs/runedit_posts (собственная проверка REST-маршрута)нет
tranzly/list-languages
Возвращает список языков сайта. Первый — язык, на котором написан исходный контент.
FreeGET /wp-json/wp-abilities/v1/abilities/tranzly/list-languages/runedit_postsнет
tranzly/list-status-items
Постранично возвращает список оригиналов с состоянием их перевода на указанный язык (состояние: missing, stale, current).
FreeGET /wp-json/wp-abilities/v1/abilities/tranzly/list-status-items/runedit_posts (собственная проверка REST-маршрута)post_type string
lang string (обязательно)
state string: all, missing, stale, translated, human, machine, review, quality
after integer
tranzly/list-theme-strings
Возвращает список тем и плагинов, тексты которых можно просканировать для перевода, и количество строк в каждом из них.
ProGET /wp-json/wp-abilities/v1/abilities/tranzly/list-theme-strings/runmanage_options (собственная проверка REST-маршрута)нет
tranzly/open-support-ticket
Создаёт обращение в службу поддержки (subject, message, kind, email) с диагностическими данными этого сайта, если администратор дал согласие. Никогда не создаёт и не отправляет учетные данные для входа.
FreePOST /wp-json/wp-abilities/v1/abilities/tranzly/open-support-ticket/runmanage_options (собственная проверка REST-маршрута)subject string (обязательно)
message string (обязательно)
kind string: help, bug, feedback, feature_request
email string
name string
diagnostics boolean
tranzly/record-support-consent
Записывает согласие администратора на отправку диагностических данных вместе с обращениями в службу поддержки.
FreePOST /wp-json/wp-abilities/v1/abilities/tranzly/record-support-consent/runmanage_options (собственная проверка REST-маршрута)consent boolean (обязательно)
tranzly/retry-job-item
Повторяет попытку для неудачного элемента (action: retry, при необходимости с другим движком) или отмечает его для ручного перевода (action: by-hand).
БесплатноPOST /wp-json/wp-abilities/v1/abilities/tranzly/retry-job-item/runedit_post и manage_options (собственная проверка маршрута REST)item строка (обязательно)
action строка (обязательно)
engine строка
tranzly/review-translation
Одобряет перевод (и публикует его, если оригинал опубликован) или отправляет его на доработку (decision, note).
ProPOST /wp-json/wp-abilities/v1/abilities/tranzly/review-translation/runedit_post (собственная проверка маршрута REST)id строка (обязательно)
decision строка (обязательно): approve, changes, pending
note строка
tranzly/run-legacy-import
Запускает импорт 2.x: dry-run (только отчёт), run или undo.
БесплатноPOST /wp-json/wp-abilities/v1/abilities/tranzly/run-legacy-import/runmanage_options (собственная проверка маршрута REST)action строка (обязательно)
tranzly/scan-theme-strings
Сканирует следующую страницу PHP-файлов компонента на наличие переводимых текстов (повторяйте с параметром after до завершения).
ProPOST /wp-json/wp-abilities/v1/abilities/tranzly/scan-theme-strings/runmanage_options (собственная проверка маршрута REST)component строка (обязательно)
after целое число
tranzly/schedule-quality-check
Планирует проверку качества с помощью ИИ для следующей страницы переводов языка (или указанных записей).
ProPOST /wp-json/wp-abilities/v1/abilities/tranzly/schedule-quality-check/runedit_posts (собственная проверка маршрута REST)lang строка (обязательно)
post_type строка
posts массив
after целое число
tranzly/seo-audit
Проверяет переводы на наличие отсутствующих SEO-заголовков, описаний, ярлыков и hreflang для языка, страница за страницей.
ProGET /wp-json/wp-abilities/v1/abilities/tranzly/seo-audit/runmanage_options (собственная проверка маршрута REST)lang строка (обязательно)
after целое число
tranzly/set-comments-setting
Делает комментарии общими для всех переводов записи или сохраняет их отдельно для каждого языка (mode).
ProPOST /wp-json/wp-abilities/v1/abilities/tranzly/set-comments-setting/runmanage_options и moderate_comments (собственная проверка маршрута REST)mode строка (обязательно): off, show, translate
tranzly/set-engine-key
Сохраняет API-ключ (и регион для Microsoft) для DeepL, Google или Microsoft; пустое значение удаляет его. Ключи хранятся в зашифрованном виде и никогда не возвращаются.
БесплатноPOST /wp-json/wp-abilities/v1/abilities/tranzly/set-engine-key/runmanage_options (собственная проверка маршрута REST)engine строка (обязательно)
key строка (обязательно)
region строка
tranzly/set-menus
Назначает меню для каждого языка и области отображения (map).
БесплатноPOST /wp-json/wp-abilities/v1/abilities/tranzly/set-menus/runedit_theme_options (собственная проверка маршрута REST)map объект (обязательно)
tranzly/set-protection
Защищает перевод от перезаписи движком (protected: true) или снимает блокировку.
БесплатноPOST /wp-json/wp-abilities/v1/abilities/tranzly/set-protection/runedit_post (собственная проверка маршрута REST)id строка (обязательно)
protected логическое (обязательно)
tranzly/set-shared-strings
Сохраняет исправленные переводы текстов тем и плагинов (strings); они становятся защищёнными.
БесплатноPOST /wp-json/wp-abilities/v1/abilities/tranzly/set-shared-strings/runedit_theme_options (собственная проверка маршрута REST)lang строка (обязательно)
scope строка: menus, site, templates, gettext.plugin-<slug>, gettext.theme-<slug>
strings объект (обязательно)
tranzly/set-site-string
Сохраняет один текст сайта (key) на определённом языке, например, название сайта или краткое описание.
БесплатноPOST /wp-json/wp-abilities/v1/abilities/tranzly/set-site-string/runedit_theme_options и manage_options (собственная проверка маршрута REST)lang строка (обязательно)
key строка (обязательно)
translation строка (обязательно)
tranzly/set-urls
Задаёт режим адресов (mode), домены для отдельных языков, переведённые основы и сегменты, noindex_untranslated и варианты ярлыков.
БесплатноPOST /wp-json/wp-abilities/v1/abilities/tranzly/set-urls/runmanage_options (собственная проверка маршрута REST)mode строка
segments объект
domains объект
bases объект
suggest логическое
noindex_untranslated логическое
tranzly/start-trial
Запускает 14-дневный пробный период Tranzly Pro для этого сайта (оплата не требуется).
БесплатноPOST /wp-json/wp-abilities/v1/abilities/tranzly/start-trial/runmanage_options (собственная проверка маршрута REST)нет
tranzly/translate-media-field
Сохраняет замещающий текст, заголовок или подпись к изображению (поле field) на выбранном языке (lang).
БесплатноPOST /wp-json/wp-abilities/v1/abilities/tranzly/translate-media-field/runedit_post (собственная проверка маршрута REST)id строка (обязательно)
lang строка (обязательно)
field строка (обязательно): alt, caption, title
translation строка (обязательно)
tranzly/translate-post
Переводит запись или страницу на один либо несколько языков сайта с помощью механизма перевода, создавая или обновляя каждый перевод. Новые переводы сохраняются как черновики, если publish не равно true. Перевод, отредактированный пользователем, пропускается, если force не равно true.
БесплатноPOST /wp-json/wp-abilities/v1/abilities/tranzly/translate-post/runправо на перевод этой записи (edit_post для неё); edit_post для существующего перевода; право публикации этого типа записей для публикацииid целое число (обязательно)
languages массив (обязательно)
engine строка
publish логическое значение
force логическое значение
tranzly/translate-shared-strings
Переводит следующую страницу непереведённых строк темы и плагинов на указанный язык с помощью механизма по умолчанию (повторяйте с параметром after до завершения).
БесплатноPOST /wp-json/wp-abilities/v1/abilities/tranzly/translate-shared-strings/runedit_theme_options (собственная проверка маршрута REST)lang строка (обязательно)
scope строка: menus, site, templates, gettext.plugin-<slug>, gettext.theme-<slug>
after целое число
tranzly/translate-site
Пошаговый процесс: агент проверяет языки и механизм, оценивает стоимость и переводит недостающие материалы, запрашивая подтверждение перед расходованием средств или публикацией.
БесплатноPOST /wp-json/wp-abilities/v1/abilities/tranzly/translate-site/runedit_postslanguages строка (обязательно)
tranzly/translate-term
Переводит элемент таксономии (рубрику, метку или атрибут товара) на указанный язык (lang) с помощью механизма, создавая или обновляя его перевод.
БесплатноPOST /wp-json/wp-abilities/v1/abilities/tranzly/translate-term/runсобственная проверка прав для каждого элемента в маршруте RESTid строка (обязательно)
lang строка (обязательно)
engine строка
force логическое значение
status строка: publish, draft
tranzly/translation-status
При указании ID записи: перевод этой записи для каждого языка, актуальность перевода и автор. Без него: процент перевода сайта по каждому языку.
БесплатноGET /wp-json/wp-abilities/v1/abilities/tranzly/translation-status/runedit_post для указанной записи; edit_posts для общей сводки сайтаid целое число
post_type строка
tranzly/unlink-post
Удаляет запись из её группы перевода; исходный язык записи сохраняется.
БесплатноPOST /wp-json/wp-abilities/v1/abilities/tranzly/unlink-post/runedit_post и edit_term (собственная проверка маршрута REST)id строка (обязательно)
tranzly/unlink-term
Удаляет элемент таксономии из его группы перевода.
БесплатноPOST /wp-json/wp-abilities/v1/abilities/tranzly/unlink-term/runedit_post и edit_term (собственная проверка маршрута REST)id строка (обязательно)
tranzly/update-display
Изменяет переключатель языков (стиль, флаги, названия, расположение) и строку с благодарностью.
БесплатноPOST /wp-json/wp-abilities/v1/abilities/tranzly/update-display/runmanage_options (собственная проверка маршрута REST)switcher объект
credit логическое значение
tranzly/update-engine-settings
Задаёт механизм по умолчанию, резервный механизм, механизмы для отдельных языков и модели ИИ для отдельных языков (default, fallback, per_lang, models, caps). Все параметры, кроме механизма по умолчанию, доступны только в Pro.
БесплатноPOST /wp-json/wp-abilities/v1/abilities/tranzly/update-engine-settings/runmanage_options (собственная проверка маршрута REST)default строка
per_lang объект
fallback массив
caps объект
models объект
tranzly/update-glossary
Заменяет переданные вами разделы глоссария (непереводимые слова, переводы терминов, тональность); разделы, которые вы не передали, сохраняются. Применяется всеми механизмами начиная со следующего перевода.
ProPOST /wp-json/wp-abilities/v1/abilities/tranzly/update-glossary/runmanage_optionsdnt массив
terms объект
tone объект
tranzly/update-settings
Задаёт языки сайта (languages: список кодов и названий; первый является исходным языком), префикс классов интерфейса, а также доступ для агентов ИИ (MCP).
БесплатноPOST /wp-json/wp-abilities/v1/abilities/tranzly/update-settings/runmanage_options (собственная проверка маршрута REST)prefix строка
mcp логическое значение
languages массив
tranzly/update-workflow-settings
Задаёт on_update (off, stale, translate), on_publish, review, quality_threshold, quality_provider и quality_model.
ProPOST /wp-json/wp-abilities/v1/abilities/tranzly/update-workflow-settings/runmanage_options (собственная проверка маршрута REST)on_update строка: off, stale, translate
on_publish логическое значение
review логическое значение
quality_threshold целое число
quality_provider строка
quality_model строка
tranzly/upload-translation-file
Загружает файл Tranzly XLIFF или CSV (content, filename), переведённый в другом месте; возвращает токен, идентифицирующий загрузку для импорта.
ProPOST /wp-json/wp-abilities/v1/abilities/tranzly/upload-translation-file/runedit_posts (собственная проверка маршрута REST)content строка (обязательно)
filename строка (обязательно)

Сгенерировано из файла abilities.json плагина, который сам формируется на основе работающего сайта; тест завершается ошибкой, если они расходятся.

Команды WP-CLI

Запускайте их на сервере с помощью WP-CLI. Каждая команда проверяет те же права доступа, что и экраны плагина; примеры взяты из собственной встроенной справки плагина.

КомандаОписаниеРедакция
wp tranzly create <id> [--term]
wp tranzly create 42 --lang=de_DE --user=admin
Создать черновик перевода записи (или термина), связанный с ней.Бесплатно
wp tranzly enginesСписок систем перевода.Бесплатно
wp tranzly jobs <action> [<id>...] [--lang=<codes>] [--post-type=<type>] [--engine=<id>] [--publish] [--force] [--format=<format>]
wp tranzly jobs create --lang=de,fr --post-type=page --user=admin
wp tranzly jobs status 12
wp tranzly jobs failures 12
wp tranzly jobs retry 345 --engine=deepl
wp tranzly jobs retry-failed 12
wp tranzly jobs run 12 # work the job here instead of waiting for the queue runner
Фоновые задачи перевода.Бесплатно
wp tranzly legacy <action> [--format=<format>]
wp tranzly legacy dry-run
wp tranzly legacy run
wp tranzly legacy undo
Показать, протестировать (dry-run), выполнить или отменить импорт переводов устаревшего сайта Tranzly (2.x).Бесплатно
wp tranzly link <source> <target> [--term]Связать существующую запись (или термин) как перевод другой.Бесплатно
wp tranzly network <action> [--languages=<codes>]
wp tranzly network setup
wp tranzly network languages --languages=en_US,de_DE,fr_FR
Multisite (Agency): настроить каждый сайт сети или задать языки, с которыми создаются новые сайты.Бесплатно
wp tranzly translate [<id>...] [--post-type=<type>] [--engine=<id>] [--force] [--publish] [--dry-run]
wp tranzly translate --lang=de --post-type=page --user=admin
wp tranzly translate 42 43 --lang=de_DE,fr_FR --engine=deepl --user=admin
Перевести записи с помощью системы перевода.Бесплатно
wp tranzly translations <id> [--term] [--format=<format>]Список переводов записи (или термина).Бесплатно

Функции PHP

Функции, которые могут вызывать темы и другие плагины. Сначала проверяйте с помощью function_exists(), чтобы ваш код продолжал работать, если плагин отключен.

ФункцияЧто делаетРедакция
icl_object_id( $id, $type = 'post', $return_original_if_missing = false, $lang = null )WPML: перевод объекта.Pro
pll__( $text )Polylang: зарегистрированная строка, переведённая. Tranzly переводит строки тем через собственный gettext WordPress, поэтому строка возвращается в исходном виде.Pro
pll_current_language( $field = 'slug' )Polylang: текущий язык.Pro
pll_default_language( $field = 'slug' )Polylang: язык по умолчанию.Pro
pll_e( $text )Polylang: вывод зарегистрированной строки с экранированием.Pro
pll_get_post( $post_id, $lang = null )Polylang: перевод записи.Pro
pll_get_post_language( $post_id, $field = 'slug' )Polylang: язык записи.Pro
pll_get_post_translations( $post_id )Polylang: все переводы записи, ярлык => 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 ): ?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_barActionСрабатывает после формирования меню «Переводы» на панели администрирования (визуальный редактор Pro добавляет сюда пункт «Перевести на этой странице»).\WP_Admin_Bar $bar
int $id
Free
tranzly_admin_dataFilterФильтрует данные, с которыми запускается приложение панели управления. Премиум-слой использует его для передачи сведений о редакции; конфиденциальные данные передавать сюда не следует, так как они выводятся в код страницы.нетFree
tranzly_ai_modelFilterФильтрует поставщика и модель ИИ, выполняющие перевод на язык. Free: поставщик и модель, выбранные для задачи `translate`, для всех языков. Tranzly Pro: выбор конкретного языка либо вариант «все остальные языки».string $targetFree
tranzly_ai_providers_in_useFilterФильтрует поставщиков ИИ, выбранных для конкретных языков. В бесплатном плагине отсутствует: каждый язык использует поставщика и модель, выбранные для задачи `translate`. Tranzly Pro выводит список поставщиков моделей для каждого языка.нетFree
tranzly_content_before_rebuildFilterФильтрует исходное содержимое непосредственно перед записью в него переведённых сегментов для каждого языка (используется функцией подмены изображений по языкам в версии Pro).string $content
string $lang
Free
tranzly_copy_meta_keysFilterФильтрует ключи метаданных, копируемые из записи в её новый перевод. Другие данные не копируются.int $source_idFree
tranzly_deepl_hostFilterФильтрует хост DeepL API (прокси-сервер или тестовый дублёр).string $host
string $key
Free
tranzly_deepl_price_per_millionFilterФильтрует стоимость одного миллиона символов DeepL в долларах США.float $priceFree
tranzly_default_engineFilterФильтрует идентификатор механизма, используемого по умолчанию, когда механизм не указан явно.string $idFree
tranzly_engine_capFilterФильтрует ежемесячный лимит механизма в долларах США: в бесплатном плагине отсутствует.float|null $cap
string $engine
Free
tranzly_engine_chainFilterФильтрует механизмы для проверки на соответствие языку в порядке очерёдности. Free: механизм по умолчанию. Премиум-слой добавляет собственный механизм языка и резервный список.string $lang
string $first
Free
tranzly_engine_optionsFilterФильтрует параметры, передаваемые механизму (список запрещённых для перевода слов, глоссарий, уровень формальности, инструкции).string $target
Engine $engine
Free
tranzly_engine_settings_saveFilterСохраняет настройки механизмов и моделей ИИ для отдельных языков, резервный список и ежемесячные лимиты. Обрабатывается только премиум-слоем (правило 5 WordPress.org: никакого Pro-поведения в бесплатном плагине).нетFree
tranzly_frontend_prefixFilterФильтрует нейтральный префикс классов для внешнего интерфейса.string $prefixFree
tranzly_fs_loadedActionСрабатывает после загрузки SDK лицензирования (в основном файле, перед кодом Tranzly). Подключайтесь здесь для взаимодействия с `tranzly_fs()`.нетFree
tranzly_glossary_optionsFilterФильтрует параметры механизма для целевого языка: список непереводимых терминов, а также глоссарий и стиль речи, если они добавлены премиум-слоем.string $langFree
tranzly_glossary_saveFilterСохраняет предпочтительные переводы и стиль речи для каждого языка. Обрабатывается только премиум-слоем (правило 5 WordPress.org: никакого Pro-поведения в бесплатном плагине).нетFree
tranzly_google_price_per_millionFilterФильтрует стоимость миллиона символов Google Cloud Translation в долларах США.float $pricePro
tranzly_install_language_packsFilterОпределяет, устанавливает ли Tranzly языковые пакеты WordPress, тем и плагинов для языка, добавленного на сайт (чтобы собственные фразы WordPress и WooCommerce отображались переведёнными). По умолчанию включено.bool $installFree
tranzly_integration_availableFilterФильтрует, запускается ли интеграция, если плагин не обнаружен (для содержимого, оставленного конструктором страниц после отключения, или если плагин загружен нестандартным способом).bool $on
string $id
Free
tranzly_integrationsFilterФильтрует интеграции, запускаемые Tranzly. Добавьте подкласс `Integration` для поддержки другого плагина.нетFree
tranzly_is_proFilterФильтрует состояние активности премиум-слоя. Отвечает только премиум-слой.bool $proFree
tranzly_job_createdActionСрабатывает после создания задачи перевода.int $job
int $items
Free
tranzly_job_finishedДействиеСрабатывает, когда в задаче перевода не осталось работы.int $job_idFree
tranzly_kit_api_baseФильтрФильтрует базовый адрес API Zinn Digital®, к которому обращаются экраны поддержки.string $baseFree
tranzly_kit_diagnosticsФильтрФильтрует диагностические данные перед тем, как их увидит владелец сайта. Плагин добавляет свои факты в extra. ⛔ Выполняется ДО предпросмотра, но никогда между предпросмотром и отправкой.нетFree
tranzly_kit_footprint_freeФильтрФильтрует, является ли сайт свободным от цифрового следа, чтобы на нём никогда не рекламировался Zinn® Ads.bool $footprint_freeFree
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 $tierFree
tranzly_localize_linksФильтрФильтрует, перенаправляет ли Tranzly внутренние ссылки этой страницы на их переводы.bool $localize
string $lang
Free
tranzly_memory_enabledФильтрФильтрует, используется ли память переводов.bool $onPro
tranzly_microsoft_price_per_millionФильтрФильтрует цену Microsoft Translator за миллион символов в долларах США.float $pricePro
tranzly_network_enabledФильтрФильтрует, включён ли сетевой уровень мультисайта.bool $agencyFree
tranzly_pbs_internal_post_typesФильтрФильтрует типы записей Page Builder Sandwich, которые Tranzly оставляет без изменений.нетFree
tranzly_post_segmentsФильтрФильтрует сегменты записи, отправляемые в движок. Key => text + format (text или html). Парсер с поддержкой блоков и интеграции добавляют, разделяют или заменяют сегменты здесь и записывают их обратно в tranzly_translated_post_fields.\WP_Post $postFree
tranzly_post_translatedДействиеСрабатывает после того, как движок перевёл запись (или когда её записал файл пользователя или импорт).int $target
int $source_id
string $code
string $engine
Free
tranzly_post_translation_createdДействиеСрабатывает после того, как Tranzly создаёт перевод записи.int $new_id
int $source_id
string $code
Free
tranzly_post_typesФильтрФильтрует типы записей, которые переводит Tranzly.нетFree
tranzly_pre_current_languageФильтрПереопределяет текущий язык напрямую: верните код языка, чтобы использовать его. Так работает tranzly_switch_language(); верните null, чтобы Tranzly определил его сам.string|null $langFree
tranzly_query_varФильтрФильтрует переменную запроса, выбирающую язык.string $varFree
tranzly_queue_lease_secondsФильтрФильтрует время аренды запрошенного элемента: по его истечении воркер, аварийно завершившийся во время обработки, возвращает элемент остальным. Должно быть больше времени самого медленного одиночного перевода.int $secondsFree
tranzly_queue_worker_secondsФильтрФильтрует время работы одного воркера до передачи управления в секундах.int $secondsFree
tranzly_queue_workersФильтрФильтрует количество воркеров, одновременно запускаемых одной задачей. Ограничение именно ВОРКЕРОВ, чтобы бережно использовать сервис перевода; но не ограничение количества выполняемых элементов.int $workers
int $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 $registryFree
tranzly_relations_changedДействиеСрабатывает после изменения связей перевода объектов: при связывании, отмене связи, переносе на другой язык или удалении. Срабатывает один раз для каждой затронутой группы, поэтому одно связывание может вызвать его дважды.string $type
array<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 $scope
string $lang
Бесплатно
tranzly_source_changedДействиеСрабатывает, когда переводимое содержимое оригинала изменилось, и его переводы устарели.int $post_id
string $now
string $before
Бесплатно
tranzly_source_meta_keysФильтрФильтрует метаключи, изменение которых делает переводы страницы устаревшими. Интеграции добавляют переводимые ими ключи (данные конструктора, SEO-поля, произвольные поля).int $post_idБесплатно
tranzly_source_publishedДействиеСрабатывает один раз при первой публикации оригинала (после сохранения его метаданных).int $post_idБесплатно
tranzly_style_rules_enabledФильтрОпределяет, применяет ли Tranzly правила стиля команды перевода WordPress.org для соответствующего языка (кавычки, пробелы вокруг знаков препинания, апострофы, многоточие, японские пробелы, местоимения обращения) к каждому новому переводу. По умолчанию включено.bool $enabled
string $locale
Бесплатно
tranzly_taxonomiesФильтрФильтрует таксономии, которые переводит Tranzly.нетБесплатно
tranzly_term_segmentsФильтрФильтрует сегменты термина, отправляемые в движок (`name`, `description`, а также всё, что добавляют интеграции: SEO-заголовки, произвольные поля). Записывайте добавленные сегменты в `tranzly_term_translated`.\WP_Term $termБесплатно
tranzly_term_translatedДействиеСрабатывает после того, как движок перевёл термин, передавая каждый переведённый сегмент (интеграции записывают добавленные ими сегменты в `tranzly_term_segments`).int $target
int $term_id
string $code
Бесплатно
tranzly_term_translation_createdДействиеСрабатывает после создания перевода термина плагином Tranzly.int $new_id
int $term_id
string $code
Бесплатно
tranzly_translatable_attributesФильтрФильтрует атрибуты, переводимые Tranzly для типа блока.string $block_nameБесплатно
tranzly_translate_stringФильтрФильтрует одну переводимую строку на целевой язык.string $value
string $code
array $context
Бесплатно
tranzly_translated_post_fieldsФильтрФильтрует поля записи, записываемые в перевод после работы движка. Интеграции, добавившие свои сегменты (произвольные поля, данные конструктора), записывают их здесь.\WP_Post $post
string $code
Бесплатно
tranzly_translation_memoryФильтрФильтрует используемую память переводов: отсутствует в бесплатном плагине; премиум-уровень предоставляет её (docs/843, правило 5 WordPress.org).Translation_Memory|null $memoryБесплатно