Ako Polylang ukladá preklady v databáze WordPress: technický hlboký ponor

Robbert Vermeulen

Robbert Vermeulen

· 4 min read

Pochopenie toho, ako Polylang spravuje viacjazyčný obsah na úrovni databázy, je pre vývojárov, ktorí vytvárajú pokročilé prekladové nástroje alebo riešia problémy s prekladmi, kľúčové. Po rozsiahlej analýze architektúry Polylangu sme zmapovali, ako presne tento populárny viacjazyčný plugin pre WordPress organizuje jazykové údaje a vzťahy medzi prekladmi.

Základ: tabuľky taxonómií WordPressu

Polylang šikovne využíva natívny systém taxonómií WordPressu. Namiesto vytvárania vlastných tabuliek používa existujúce tabuľky wp_term_relationships a wp_term_taxonomy na ukladanie priradení jazykov aj vzťahov medzi prekladmi. Tento prístup udržiava štruktúru databázy jednoduchú a zároveň poskytuje silnú funkcionalitu.

Ako sú príspevky prepojené s jazykmi

Keď je príspevku priradený jazyk, Polylang vytvorí záznamy v tabuľke wp_term_relationships. Postup je nasledovný:

Krok 1: Priradenie jazyka

Príspevok (napr. ID 7834) má zodpovedajúce object_id v wp_term_relationships s viacerými riadkami, pričom každý má iné term_taxonomy_id. Ak chcete identifikovať jazyk, postupujete takto:

  1. Nájdite zodpovedajúce riadky v wp_term_taxonomy, kde sa taxonomy rovná 'language'
  2. Získajte stĺpec description, ktorý obsahuje serializované jazykové údaje

Pole description obsahuje údaje napríklad takto:

a:4:{s:9:"fallbacks";a:0:{}s:6:"locale";s:5:"en_US";s:3:"rtl";i:0;s:9:"flag_code";s:2:"us";}

Ak chcete filtrovať príspevky podľa jazyka, jednoducho skontrolujete, či sa term_taxonomy_id zhoduje s konkrétnym jazykovým termom (napr. 140 pre angličtinu).

Krok 2: Vzťahy prekladov

Prekladové prepojenia medzi príspevkami používajú rovnakú štruktúru tabuliek, len s inou taxonómiou:

  1. Vykonajte dotaz na wp_term_taxonomy, kde sa taxonomy rovná 'post_translations'
  2. Stĺpec description obsahuje všetky ID prekladov

Typický výsledok vyzerá takto:

a:3:{s:2:"en";i:7834;s:2:"de";i:7859;s:2:"nl";i:7860;}

Toto serializované pole mapuje kódy jazykov na ID príspevkov a vytvára prekladovú skupinu.

Ako termy (kategórie/značky) pracujú s jazykmi

Termy sa riadia podobným, ale mierne odlišným vzorom:

Priradenie jazyka pre termy

Pre term s ID 14850:

  1. V wp_term_relationships existuje viacero riadkov s rôznymi hodnotami term_taxonomy_id
  2. Zodpovedajúci záznam v wp_term_taxonomy má taxonomy 'term_language' (poznámka: nie iba 'language')
  3. Hodnota term_taxonomy_id pre jazyky termov je zvyčajne ID jazyka príspevkov + 1 (napr. ak príspevky používajú 140, termy používajú 141)

Vzťahy prekladov termínov

Vzťahy prekladov pre termíny používajú:

  1. Hodnotu taxonómie 'term_translations' v wp_term_taxonomy
  2. Rovnaký formát serializovaného poľa v stĺpci description:
a:3:{s:2:"en";i:14850;s:2:"nl";i:15004;s:2:"de";i:15012;}

Prečo je to dôležité pre pokročilé prekladové nástroje

Pochopenie tejto databázovej štruktúry je kľúčové pre budovanie sofistikovaných prekladových funkcií. Keď sme vyvíjali polylang ai bulk translator pre náš plugin Polylang AI Automatic Translation, tieto hlboké znalosti nám umožnili:

  • Efektívne dopytovať a spracovávať veľké dávky nepreloženého obsahu
  • Zachovať správne prekladové vzťahy medzi článkami, stránkami a taxonómiami
  • Riešiť komplexné štruktúry tvorcov stránok pri zachovaní integrity údajov Polylang
  • Vytvárať prekladové úlohy, ktoré bezproblémovo fungujú s architektúrou Polylang

Kľúčové poznatky

  • Polylang používa natívny taxonomický systém WordPressu na ukladanie viacjazyčných údajov
  • Príspevky používajú taxonómie 'language' a 'post_translations'
  • Termíny používajú taxonómie 'term_language' a 'term_translations'
  • Všetky jazykové a prekladové údaje sú serializované v stĺpci description tabuľky wp_term_taxonomy
  • term_taxonomy_id slúži ako prepojenie medzi obsahom a jeho jazykovými/prekladovými údajmi

Táto architektúra je elegantná svojou jednoduchosťou, no na jej úplné pochopenie je potrebné ponoriť sa do databázovej štruktúry. Pre vývojárov pluginov pracujúcich s Polylang sú tieto znalosti neoceniteľné pri vytváraní nástrojov, ktoré sa správne integrujú do viacjazyčného ekosystému.

Robbert Vermeulen

Robbert Vermeulen

Founder of EPIC WP Solutions

View all posts →