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

Install

Download source zip No release zip yet

This is the repository archive. It installs, but the folder name will carry the branch suffix and updates will not flow.

Install straight from GitHub with WP-CLI:

wp plugin install https://github.com/xdxegit/yandex-auto-translator/archive/refs/heads/main.zip
No built-in updater. New versions won't appear under Dashboard → Updates. Install new releases yourself, or let Git Updater track the repository.
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 исключаются содержимое `