Плагін ШІ-перекладу для сайту з підтримкою WooCommerce

Як це працює

Більшість багатомовних плагінів копіюють записи та зберігають окремі версії кожної сторінки. SDWSKi Translate влаштований інакше.

1. Перехоплення виведення. На сторінці потрібною мовою плагін перехоплює готовий HTML перед надсиланням у браузер і розбирає його як DOM-дерево.
2. Пошук вмісту для перекладу. Із дерева витягуються текстові вузли та атрибути: alt, title, placeholder, значення кнопок, а також <title>, meta description, og:title, og:description, og:site_name, twitter:title, twitter:description.
3. Словник. Для кожної мови в базі є окрема таблиця-словник «оригінал → переклад». Відомі рядки підставляються миттєво, без запитів до зовнішніх API.
4. Фоновий переклад. Нові рядки потрапляють у чергу, а фонове завдання перекладає їх пакетами одразу всіма цільовими мовами.
5. Захист від «сирого» виведення. Поки переклад сторінки не готовий, відвідувач і пошукова система не побачать вихідний текст чужою мовою (докладніше — у розділі про SEO).

Оскільки плагін працює з підсумковою розміткою, він перекладає й те, до чого не дістатися звичайними способами: тексти із шаблонів теми, віджети, кнопки, підписи форм, повідомлення WooCommerce, сповіщення та текст, отриманий через AJAX.

Автоматичний режим перекладу

Ви підключаєте свій ключ Azure або DeepL, вибираєте мови, а плагін усе робить сам. Ви платите безпосередньо провайдеру за його тарифами, плагін не стягує жодної додаткової плати.

• Azure Translator — швидкий і недорогий машинний переклад.
• Azure OpenAI (GPT) — контекстний переклад на рівні мовної моделі: звучить природніше, краще зберігає тон, але коштує дорожче й працює повільніше. Працює через розгортання, наприклад gpt-4o або gpt-4o-mini, із налаштовуваними endpoint, ключем і версією API.
• DeepL — резервний рушій. Ключі безкоштовного тарифу (:fx) визначаються автоматично, підключається потрібний хост API.

Автоматичне резервне перемикання. Якщо вибраний рушій відповідає помилкою (вичерпано квоту, закінчився термін дії ключа, стався збій сервісу), плагін сам переходить до наступного в ланцюжку: основний рушій → Azure Translator → Azure OpenAI → DeepL. Переклад продовжується без втручання адміністратора. Для кожного рушія є кнопка перевірки з’єднання.

Ручний режим перекладу

Увесь переклад можна виконувати вручну, без зовнішніх сервісів і ключів. Для цього є візуальний редактор і таблиця всіх рядків.

Візуальний редактор перекладу

Відкрийте будь-яку сторінку сайту в режимі редактора: ліворуч — панель, праворуч — попередній перегляд у реальному часі. Натисніть будь-який текст на сторінці (заголовок, абзац, пункт меню, кнопку, підпис до зображення), і він відкриється на панелі.

• оригінал і переклад поруч, вибір мови перекладу та рядка зі списку;
• кнопка Auto — автопереклад одного рядка рушієм за запитом;
• Зберегти / Відхилити, гарячі клавіші (Ctrl+S — зберегти, Ctrl+Alt+стрелки — перехід між рядками);
• посилання на редактор в адмін-панелі сайту (admin bar);
• коректно обробляє кліки у випадних меню тем, зокрема з stopPropagation;
• розрізняє однакові тексти на сторінці (наприклад, заголовок і посилання в меню з одним і тим самим словом);
• підтримує меню івритом, грецькою, гінді, тайською, грузинською та вірменською.

Таблиця всіх рядків («Переклади»)

Єдиний список усіх перекладів сайту.

• пошук і фільтри: усі / перекладені / неперекладені / машинні / перевірені людиною;
• редагування безпосередньо в таблиці, збереження кожного рядка;
• масова дія Автоматично перекласти вибране;
• експорт у CSV;
• будь-яке ручне редагування отримує статус «Перевірено людиною».

Захист ручних редагувань

Кожен переклад має статус: не перекладено, машинний, перевірено людиною, помилка, premium. Рядки зі статусом «перевірено людиною» автоматичний переклад ніколи не перезаписує, навіть під час повторного проходу. Автопереклади не видаляються автоматично за жодних умов: усі переклади належать вам і зберігаються у вашій базі.

Вміст, що перекладається

• записи, сторінки, довільні типи записів;
• заголовки, текст, уривки, підписи, alt до зображень;
• навігаційні меню;
• назви та слаги рубрик і позначок;
• рядки тем і плагінів (усе, що проходить через __(), _e(), _n());
• віджети та динамічне виведення;
• SEO-мета: Yoast SEO, Rank Math, SEOPress, All in One SEO;
• відповіді REST API (записи, сторінки, медіа, таксономії);
• AJAX-відповіді фронтенду;
• Custom HTML-блоки Gutenberg перекладаються окремим безпечним проходом, який не порушує розмітку.

Мова, URL і слаги

• префікси мов в адресах: site.com/es/…, site.com/de/…;
• необов’язковий префікс і для мови за замовчуванням;
• працює як у корені домену, так і під час встановлення WordPress у підпапку;
• переклад слагів: /contact/ → /es/contacto/, з автоматичним перетворенням перекладеної адреси назад на початкову до маршрутизації WordPress;
• переклад слагів запланованих (future) записів створюється в момент планування;
• примусове підставляння мови у внутрішні посилання;
• для кожної мови можна задати власний слаг. Наприклад, білоруська: адреса /by/, бейдж «BY», але внутрішній ISO-код be для API та be у hreflang залишаються стандартними;
• автовизначення мови за браузером (заголовок Accept-Language) з перенаправленням під час першого відвідування та cookie на 24 години для запобігання циклам.

Перемикач мов

• плаваюча кнопка у будь-якому куті сторінки (4 позиції) з налаштовуваним стилем;
• шорткод
  UA

  • RU
  • EN
  • LT
  • BY
  • UA
  для вставлення в будь-яке місце, із власним стилем;
• пункт меню «Language Switcher»: додається в Зовнішній вигляд → Меню та розгортається в елементи за кількістю мов;
• стилі відображення: прапори + повні назви, прапори + короткі коди, лише прапори, лише назви, лише коди;
• назви мов — рідною мовою («Español», «Deutsch», «Русский»);
• порядок мов змінюється перетягуванням на вкладці «Languages»;
• вбудований шрифт прапорів, щоб прапори коректно відображалися у Windows і Linux, де системні шрифти не відтворюють прапори.

Мови й писемність

• 55 мов і регіональних варіантів, зокрема: англійська (США, Велика Британія, Австралія), іспанська (Іспанія, Аргентина, Мексика), португальська (Португалія, Бразилія), китайська (спрощена, традиційна), арабська, іврит, гінді, японська, корейська, тайська, в’єтнамська, турецька, українська, російська, білоруська, литовська, латиська, естонська, польська, чеська, словацька, грецька, перська, урду, есперанто та інші;
• підтримка RTL для арабської, івриту, перської та урду;
• автоматичне підвантаження вебшрифтів Noto для мов, яких немає у шрифті теми (деванагарі, китайська, японська, корейська, арабська, тайська, іврит, грузинська тощо). Замість порожніх квадратиків текст відображається належним чином. Шрифти піктограм не зачіпаються, функцію можна вимкнути;
• регіональні словники: плагін додатково коригує лексику таких варіантів, як pt-PT/pt-BR, en-GB/en-AU, es-AR/es-MX, щоб регіональні сторінки справді відрізнялися й не об’єднувалися пошуковими системами. Словники розширюються за допомогою фільтра.

Якість перекладу та захист контенту

Машинний переклад порушує верстку, шорткоди та назви брендів. SDWSKi Translate захищає від цього на кількох рівнях:

• захист HTML-сутностей і шорткодів — ©, [shortcode], плейсхолдери %s, %1$s, {name} залишаються недоторканими;
• список «Do not translate»: бренди, коди товарів, абревіатури; назва сайту захищається автоматично;
• перевірки результату: плейсхолдери збережено, переклад написано потрібною писемністю, немає сторонніх символів, захищені слова не пошкоджено. Погана відповідь відхиляється, а текст перекладається заново, а не зберігається;
• повтор з ізоляцією брендів, якщо модель пошкодила захищене слово (наприклад, тайська обрізає «WordPress» на останній літері);
• примусовий глосарій для випадків, коли модель систематично помиляється (розширюється фільтром);
• виявлення чужої мови: якщо тема вже вивела текст мовою відвідувача, плагін не сприйме його як оригінал і не буде ані перекладати, ані дублювати іншими мовами;
• API-ключі, токени та хеші не надсилаються на переклад.

Зображення за мовами

Вкладка «Images» дає змогу замінити будь-яке зображення локалізованою версією: логотип, інфографіку, скриншот, банер із текстом. Плагін сам знаходить зображення, які трапляються на перекладених сторінках, і реєструє їх у списку, а ви підставляєте версію для потрібної мови з медіабібліотеки. Заміна працює і для src, і для srcset.

Ролі та доступ

• окрема роль Translator (перекладач): доступ до візуального редактора без доступу до налаштувань сайту;
• права sdwski_translate і sdwski_manage;
• усі дії захищені nonce та перевіркою прав.

Видимість за мовами

Для кожного запису можна вказати, якими мовами він відображається, включно з початковою мовою. Наприклад, російська новина, яка не потрібна в англійській версії. Обмеження враховуються в списках, меню та sitemap, а пряме посилання на вже наявний запис і надалі відкривається без помилки 404. Для записів без обмежень нічого не змінюється, налаштування повністю зворотно сумісне.

Мета-бокс у редакторі запису

У редакторі запису є панель «Re-translate»: переклад конкретного запису можна запустити повторно. Видимість за мовами доступна в самому редакторі (класичному та блоковому).

SEO

Багатомовність без SEO не працює, тому це одна з основних складових плагіна.

• hreflang у <head> кожної сторінки й у sitemap, взаємні посилання між усіма мовними версіями та x-default;
• окремий <url> для кожної мови у sitemap, як рекомендує Google, із коректно оголошеним простором імен xhtml;
• інтеграція із sitemap: ядро WordPress, Yoast SEO, Rank Math, SEOPress, All in One SEO;
• у <loc> завжди канонічна адреса вихідної мови, а /sitemap.xml і /robots.txt ніколи не отримують мовного префікса;
• переклад SEO-метаданих: title, description, Open Graph і Twitter-теги;
• складової <title> вигляду «Запис — Сайт — Слоган» береться з відрендереної сторінки та перекладається заздалегідь, до першого візиту;
• виправлення <html lang> на поточну мову й відновлення порожнього <title>, якщо SEO-плагін сформував шапку раніше, ніж стала відома мова;
• SEO Gate: доки сторінку цією мовою не перекладено, вона повертає HTTP 503 з Retry-After, noindex і охайною заглушкою «переклад готується» замість англійського тексту на /es/. В архівах, на головній і в пошуку ще не перекладені записи приховуються. Заглушку локалізовано десятками мов. Якщо заголовок так і не вдається перекласти, спрацьовує fail-open, і сторінка не залишається закритою назавжди;
• переклад назв і слагів рубрик і позначок, щоб /pt-br/tag/… був справді португальською.

Інтеграція з WooCommerce

Для інтернет-магазинів плагін має окремий шар сумісності:

• переклад назв, описів, атрибутів і варіацій товарів;
• Кошик і оформлення замовлення на блоках: переклад відповідей Store API (/wc/store/v1/*) і гідратації блоків, де дані передаються через JSON, а не через HTML;
• примусове встановлення правильних слагів системних сторінок магазину (кошик, оформлення замовлення, мій обліковий запис, магазин) для основних мов;
• переклад підписів полів адреси, регіональних назв і текстів форм;
• Мова покупця зберігається в замовленні, і листи WooCommerce надсилаються мовою, якою клієнт оформлював покупку: підтвердження, статуси, повернення, примітки до замовлення, скидання пароля, підписки;
• переклад вмісту листів (HTML і plain text) та визначення мови отримувача;
• мова клієнта запам’ятовується під час реєстрації та входу, її можна змінити в профілі («мова листів»);
• зв’язка мова ↔ валюта під час використання мультивалютного плагіна WCMC: зміна мови може перемикати валюту;
• захист платіжних AJAX-запитів (Stripe та ін.): токени й client secret залишаються без змін;
• очищення внутрішніх службових обгорток із приміток до замовлень і метаданих.

Окремо враховано відомі проблеми блоків WooCommerce: обрізання описів у Cart/Checkout у локалях із некоректним перекладом службової підказки та визначення мови запитів Store API, у яких немає мовного префікса в URL.

Фонова черга та продуктивність

• Переклад виконується паралельно всіма мовами (curl_multi). Сайт 10 мовами перекладається приблизно за той самий час, що й 1–2 мовами.
• Подієва модель: плагін не «цокає» постійно за розкладом. Переклад запускається, коли справді з’являється привід: автор зберіг запис, запис заплановано або на сторінці виявлено новий неперекладений рядок. Коли черга завершується, вона сама зупиняється. Немає приводу — немає й платних запитів до API.
• Захист від зайвих списань. Повторний переклад запускається лише в разі справжнього ручного редагування запису в редакторі (класичний редактор, швидке редагування, Gutenberg). Програмні збереження від cron-завдань, інших плагінів, імпортів та REST-інтеграцій не спричиняють витрат токенів. Зміни визначаються за MD5-хешем вмісту.
• Пріоритети черги: заплановані записи перекладаються першими, потім нові записи — раніше за старі.
• Стійкість до збоїв: тимчасові збої рушія (тайм-аут, помилка сервера) не зараховуються як спроби й повторюються безкінечно, а остаточні відмови обмежуються лічильником, щоб черга не застрягала. Контроль пам’яті та блокування паралельних запусків.
• Автовідновлення: рядки, що застрягли й залишилися після попереднього збою рушія, під час оновлення автоматично повертаються до черги.
• Кешування: транзієнти та група об’єктного кешу; одна кнопка очищає кеші плагіна, WordPress і популярних плагінів кешування (LiteSpeed, WP Rocket, W3 Total Cache, WP Super Cache).
• Адмінпанель процесу: індикатори прогресу для кожної мови (усього, перекладено, машинний переклад, перевірено людиною), кнопки Start / Stop / Reset, попередження про «застряглі» переклади з можливістю повторити або проігнорувати, діагностика «чому нічого не запускається» (ключ, пам’ять, WP-Cron, наступний запуск).
• Інструменти обслуговування: очищення кешів, відновлення словника й об’єднання дублікатів, очищення мови.

Архітектура та надійність

• Чиста архітектура PHP 8+: ядро-синглтон і ~27 класів з автозавантаженням, кожен із власною зоною відповідальності (рендеринг, словники, SEO, URL, WooCommerce, редактор тощо).
• Власні таблиці БД: словник і gettext-таблиця для кожної мови, таблиці оригіналів і підмін зображень, індекси та повнотекстовий пошук.
• Захист від повторного завантаження файлу плагіна, міграція налаштувань і даних під час оновлень (зокрема міграція старих префіксів параметрів).
• Безпека: nonce для всіх AJAX-дій, перевірка прав, wp_unslash і санітизація всіх вхідних даних, підготовлені SQL-запити, безпечні перенаправлення (wp_safe_redirect).
• Сумісність із WordPress 6.0+ і PHP 8.0+, протестовано з WordPress 7.0.
• Ліцензія GPL v2 або новіша, вихідний код відкритий для аудиту.
• Розширюваний інтерфейс: фільтри sdwski_no_translate_xpath, sdwski_translation_glossary, sdwski_regional_dictionary, sdwski_load_webfonts, sdwski_load_flag_font, sdwski_allow_hash_invalidation та ін.
• Сторінка налаштувань: вкладки Загальні, Мови, Машинний переклад, Перемикач мов, Процес перекладу, Переклади, Зображення та Підтримка.

Для кого

• сайти-візитівки та корпоративні сайти, яким потрібні кілька мов без ручного дублювання;
• медіа та блоги з матеріалами, що постійно публікуються: нові публікації перекладаються автоматично;
• інтернет-магазини на WooCommerce з покупцями з різних країн, включно з листами та кошиком;
• агентства та фрилансери, які здають багатомовні сайти клієнтам: роль «Перекладач», ручне редагування та експорт.