WP Manifestindependent plugin directory
manifest / i18n / yandex-auto-translator

Yandex Auto Translator

WordPress plugin for simple translate pages based on Yandex Cloud API.

by xdxegit · github.com/xdxegit/yandex-auto-translator · website

★ 0stars
0forks

Install

No release zip yet. The repository archive installs, but the folder name will carry the branch suffix and updates will not flow:

wp plugin install https://github.com/xdxegit/yandex-auto-translator/archive/refs/heads/main.zip
Readme github.com/xdxegit/yandex-auto-translator ↗

WordPress-плагин для автоматического перевода публичных страниц сайта через Yandex Cloud Translate API.

Плагин добавляет переключатель языков, запоминает выбранный язык в cookie, переводит HTML-страницу на лету и кэширует результаты перевода во временных данных WordPress.

Возможности

  • Автоматический перевод страниц с русского языка на английский и турецкий.
  • Переключение языка через параметр ?lang=ru, ?lang=en или ?lang=tr.
  • Шорткод переключателя языка: [yandex_translator].
  • Сохранение выбранного языка в cookie на 30 дней.
  • Кэширование переведенных текстов через WordPress transients на 7 дней.
  • Пакетная отправка текстовых фрагментов в Yandex Cloud Translate API.
  • Добавление hreflang-ссылок для поддерживаемых языков.
  • Админ-страница для настройки API-ключа, Folder ID, проверки подключения и очистки кэша.

Требования

  • WordPress.
  • PHP с поддержкой mbstring.
  • Аккаунт Yandex Cloud.
  • API-ключ Yandex Cloud Translate.
  • Доступ к сервису Yandex Cloud Translate API.

Установка

  1. Скопируйте папку yandex-auto-translator в директорию WordPress:

    wp-content/plugins/yandex-auto-translator

  2. Убедитесь, что структура плагина выглядит так:

    yandex-auto-translator/
├── yandex-translator.php
└── assets/
    ├── script.js
    └── style.css

  3. В панели администратора WordPress откройте раздел Плагины.

  4. Активируйте плагин Yandex Auto Translator.

Настройка

После активации откройте:

Настройки -> Yandex Translator

Укажите параметры:

  • API Ключ - API-ключ Yandex Cloud.
  • Folder ID - идентификатор каталога Yandex Cloud. Поле необязательное, но рекомендуется заполнить его, если API-ключ привязан к конкретному каталогу.

После сохранения настроек можно нажать Проверить подключение. Плагин попробует перевести фразу Привет мир на английский язык и покажет результат проверки.

Использование

Добавьте переключатель языка в нужное место сайта с помощью шорткода:

[yandex_translator]

Переключатель формирует ссылки на текущую страницу с параметром lang:

?lang=ru
?lang=en
?lang=tr

Если выбран русский язык, страница выводится без перевода. Если выбран английский или турецкий, плагин буферизует HTML-вывод страницы, извлекает текстовые узлы и отправляет их на перевод.

Поддерживаемые языки

Код Язык
ru Русский, исходный язык
en English
tr Türkçe

Исходный язык задан в коде как ru.

Как работает перевод

  1. Пользователь открывает страницу с параметром lang=en или lang=tr.
  2. Плагин сохраняет выбранный язык в cookie yt_lang.
  3. На публичной части сайта включается буферизация HTML.
  4. Из HTML исключаются содержимое `