A wp_options táblában tárolt szövegek fordítása

A témák és bővítmények néha szövegeket is mentenek a wp_options táblába, a beállítások részeként. A WPML a get_option hívások eredményét a wpml-config.xml fájlban megadott fordításokkal cseréli le.

Ez az útmutató azoknak szól, akik saját témát vagy bővítményt fejlesztenek. Ha harmadik féltől származó téma vagy bővítmény szövegeit akarod fordítani, olvasd el a Sztringek keresése és regisztrálása fejezetet.

A konfigurációs fájl elkészítésében a Multilingual Tools bővítmény segít.

Sztringek fordítása a wp_options táblában

Amikor egy téma vagy bővítmény a get_option függvényt hívja, a wp_options tábla értékét olvassa. A WPML ezeket a hívásokat szűri, és az opciók értékéhez fordítást ad. Ez egyszerű szöveges rekordnál és szerializált tömbnél is működik.

Egyetlen opció fordításához vegyél fel egy key elemet az admin-texts alá. Szerializált tömbhöz egy key alá több key elemet tegyél, ahogy lent a my_plugins_options esetében látod:

<wpml-config>
  <admin-texts>
    <key name="my_plugins_options">
      <key name="option_name_1" />
      <key name="option_name_2" />
      <key name="options_group_1">
        <key name="sub_option_name_11" />
        <key name="sub_option_name_12" />
      </key>
      <key name="options_group_2">
        <key name="sub_option_name_21" />
        <key name="sub_option_name_22" />
      </key>
    </key>
    <key name="simple_string_option" />
  </admin-texts>
</wpml-config>

Helyettesítő karakter az alkulcsokban

Az alkulcsokban használhatod a * karaktert:

<wpml-config>
  <admin-texts>
    <key name="testing_option">
      <key name="*"/>
    </key>
  </admin-texts>
</wpml-config>

Ez azt jelenti, hogy a testing_option minden alkulcsa és annak minden alkulcsa fordítható, mintha mindet kézzel felsoroltad volna.

Figyelem: a * a szülőkulcsokban nem működik:

<wpml-config>
  <admin-texts>
    <key name="some_option_*" />
    <key name="*"/>
  </admin-texts>
</wpml-config>

Objektumazonosítók automatikus cseréje

A WPML 4.8-tól megadhatod, hogy bizonyos admin szövegek objektumazonosítókat (bejegyzés, termék vagy taxonómia azonosítóját) tartalmaznak. A WPML ezeket az oldal frontendjén automatikusan a megfelelő nyelvű azonosítóra cseréli.

Ez a shortcode-azonosítók cseréjének kiterjesztése, és ugyanazt a szintaxist használja (lásd: Oldalépítő-tartalom regisztrálása fordításra). Az admin-texts alatti key elemeken használd:

• type: a hivatkozott objektum fajtája, post-ids vagy taxonomy-ids,
• sub-type (nem kötelező): a konkrét entitás, például product.

A type és a sub-type bármelyik beágyazási szinten megadható.

A WPML ezeket az azonosítóformákat ismeri fel és cseréli:

• egyetlen azonosító (például 123),
• azonosítók tömbje vagy kódolt tömbje (például [123,456,789]),
• vesszővel elválasztott lista (például "123,456,789").

<wpml-config>
  <admin-texts>
    <key name="admin_text_option_key" type="post-ids" sub-type="product" />
    <key name="admin_text_with_nested_ids">
      <key name="admin_text_nested_key_with_ids" type="post-ids" sub-type="product" />
      <key name="admin_text_nested_key_with_ids_with_wildcard_*" type="post-ids" sub-type="product" />
      <key name="admin_text_nested_key_with_subkey">
        <key name="admin_text_nested_key_with_subkey_with_ids" type="post-ids" sub-type="product" />
      </key>
    </key>
  </admin-texts>
</wpml-config>

Kapcsolódó fejezetek

• Egyedi shortcode-ok fordítása
• Oldalépítő-tartalom regisztrálása fordításra
• Egyedi mezők a wpml-config.xml fájlban
• Egyedi bejegyzéstípusok és taxonómiák
• Egyedi Gutenberg-blokkok fordíthatóvá tétele
• A nyelvváltó testreszabása XML-ből