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

Як гэта працуе

Большасць шматмоўных плагінаў капіруюць запісы і захоўваюць асобныя версіі кожнай старонкі. SDWSKi Translate працуе інакш.

1. Перахоп вываду. На старонцы на патрэбнай мове плагін перахоплівае гатовы HTML перад адпраўкай у браўзер і разбірае яго як DOM-дрэва.
2. Пошук змесціва для перакладу. З дрэва здабываюцца тэкставыя вузлы і атрыбуты: alt, title, placeholder, значэнні кнопак, а таксама <title>, метаапісанне, 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. Пераклад працягваецца без умяшання адміністратара. Для кожнага рухавіка ёсць кнопка праверкі злучэння.

Ручны рэжым перакладу

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

Візуальны рэдактар перакладу

Адкрыйце любую старонку сайта ў рэжыме рэдактара: злева панэль, справа жывое прэв’ю. Націсніце на любы тэкст на старонцы (загаловак, абзац, пункт меню, кнопку, подпіс да выявы), і ён адкрыецца ў панэлі.

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

Табліца ўсіх радкоў («Translations»)

Адзіны спіс усіх перакладаў сайта.

• пошук і фільтры: усе / перакладзеныя / неперакладзеныя / машынныя / правераныя чалавекам;
• рэдагаванне непасрэдна ў табліцы, захаванне па радках;
• масавае дзеянне Аўтаматычна перакласці выбранае;
• экспарт у 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 пазіцыі) з наладжвальным стылем;
• шорткод
  BY

  • 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.

Ролі і доступ

• асобная роля Перакладчык (перакладчык): доступ да візуальнага рэдактара без доступу да налад сайта;
• правы 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

Для інтэрнэт-крам у плагіна ёсць асобны пласт сумяшчальнасці:

• пераклад назваў, апісанняў, атрыбутаў і варыяцый тавараў;
• Cart і Checkout на блоках: пераклад адказаў Store API (/wc/store/v1/*) і гідратацыі блокаў, дзе даныя перадаюцца праз JSON, а не праз HTML;
• прымусовае выкарыстанне правільных слагаў сістэмных старонак крамы (кошык, афармленне замовы, мой акаўнт, крама) для асноўных моў;
• пераклад подпісаў палёў адраса, рэгіянальных назваў і тэкстаў формаў;
• Мова пакупніка захоўваецца ў заказе, і лісты WooCommerce адпраўляюцца на мове, на якой кліент афармляў пакупку: пацвярджэнні, статусы, вяртанні, нататкі да замовы, скід пароля, падпіскі;
• пераклад змесціва лістоў (HTML і звычайны тэкст) і вызначэнне мовы атрымальніка;
• мова кліента запамінаецца пры рэгістрацыі і ўваходзе, яе можна змяніць у профілі («мова лістоў»);
• сувязь мова ↔ валюта пры выкарыстанні мультывалютнага плагіна WCMC: змена мовы можа пераключаць валюту;
• абарона плацежных AJAX-запытаў (Stripe і інш.): токены і сакрэтны ключ кліента застаюцца некранутымі;
• ачыстка ўнутраных службовых абгортак з нататак да замоў і метаданых.

Асобна ўлічаны вядомыя праблемы блокаў WooCommerce: абразанне апісанняў у Cart/Checkout у лакалях з некарэктным перакладам службовай падказкі і вызначэнне мовы запытаў Store API, у якіх няма моўнага прэфікса ў URL.

Фонавая чарга і прадукцыйнасць

• Пераклад выконваецца паралельна на ўсе мовы (curl_multi). Сайт на 10 мовах перакладаецца прыкладна за той жа час, што і на 1–2.
• Падзейная мадэль: плагін не «цікае» бясконца паводле раскладу. Пераклад запускаецца, калі сапраўды з’явілася падстава: аўтар захаваў запіс, запіс запланаваны або на старонцы выяўлены новы неперакладзены радок. Калі чарга вычарпана, яна сама спыняецца. Няма падставы — няма і платных запытаў да API.
• Абарона ад лішніх спісанняў. Паўторны пераклад запускаецца толькі пры сапраўдным ручным рэдагаванні запісу ў рэдактары (класічны рэдактар, хуткае рэдагаванне, Gutenberg). Праграмныя захаванні ад cron-задач, іншых плагінаў, імпартаў і REST-інтэграцый не прыводзяць да расходавання токенаў. Змены вызначаюцца паводле MD5-хэша змесціва.
• Прыярытэты чаргі: запланаваныя запісы перакладаюцца першымі, затым новыя запісы раней за старыя.
• Устойлівасць да збояў: часовыя збоі рухавіка (тайм-аўт, памылка сервера) не лічацца спробамі і паўтараюцца бясконца, а канчатковыя адмовы абмежаваныя лічыльнікам, каб чарга не захрасала. Кантроль памяці і блакіроўка ад паралельных запускаў.
• Аўтааднаўленне: радкі, якія захраслі і засталіся пасля папярэдняга збою рухавіка, пры абнаўленні аўтаматычна вяртаюцца ў чаргу.
• Кэшаванне: transients і група аб’ектнага кэша; адна кнопка скідае кэшы плагіна, 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 і інш.
• Старонка налад: укладкі General, Languages, Machine Translation, Language Switcher, Translation Process, Translations, Images і Support.

Для каго

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