Oldalépítő-tartalom regisztrálása fordításra

Ez az útmutató azoknak szól, akik témát vagy bővítményt fejlesztenek, vagy saját oldalépítő-kódot adnak az oldalukhoz. A wpml-config.xml fájlban megadhatod, mely szövegeket, médiákat, linkeket és azonosítókat kezeljen a WPML fordíthatóként.

Ha harmadik féltől származó oldalépítőt használsz, és az egyedi widgetjeit nem tudod lefordítani, fordulj a WPML ügyfélszolgálatához.

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

Szövegek fordítása

Tegyük fel, hogy egy Visual Composerrel készült oldalon van egy szövegelválasztó címmel:

[vc_text_separator title="Separator Title"]

Hogy a WPML tudja, hogy a title fordítandó, vedd fel a wpml-config.xml fájlba:

<wpml-config>
  <shortcodes>
    <shortcode>
        <tag>vc_text_separator</tag>
        <attributes>
            <attribute>title</attribute>
        </attributes>
    </shortcode>
  </shortcodes>
</wpml-config>

A szerkezet:

• A shortcodes elembe kerül minden fordítandó shortcode.
• A shortcode elem fog össze egy shortcode-hoz tartozó minden elemet.
• A tag elem a shortcode neve (itt vc_text_separator).
• Egy shortcode-nak egy vagy több attribútuma lehet: ezeket az attributes elembe tedd, és mindegyiket egy attribute elemmel add meg.

Linkek

Az oldalépítők elemei között gyakran vannak linkattribútumok. A type="link" beállítással elérheted, hogy a belső linkek automatikusan a lefordított bejegyzésre mutassanak.

Mellé használhatod az encoding attribútumot, amely az oldalépítők különleges kódolását kezeli. Értéke általában az adott oldalépítőtől függ:

Érték	Mire való
base64	Visual Composer nyers HTML shortcode: a HTML base64-es szövegként van tárolva.
vc_link	A Visual Composer speciális linkformátuma.
vc_values	A Visual Composer speciális kódolása a folyamatjelző, a kördiagram és a vonaldiagram widgetek értékeihez.
av_link	Az Enfold speciális linkformátuma.
allow_html_tags	A shortcode-attribútumokból általában kiszűrődnek a HTML-címkék. Ezzel engedélyezheted őket. Óvatosan használd: bizonyos helyzetekben elrontja a formázást, és biztonsági kockázat is lehet.

<wpml-config>
  <shortcodes>
    <shortcode>
        <tag>av_button</tag>
        <attributes>
            <attribute>label</attribute>
            <attribute type="link" encoding="av_link">link</attribute>
        </attributes>
    </shortcode>
  </shortcodes>
</wpml-config>

Ha URL-kódolt shortcode-okat használsz, azokról külön tudnivalók vannak.

Címkék

A tag és az attribute elemhez megadhatsz egy label attribútumot. Ez a felirat megjelenik a szöveg mellett a Haladó fordítószerkesztőben és a klasszikus fordítószerkesztőben is, és bekerül az exportált XLIFF-fájlokba. Segít a fordítónak megérteni a szöveg összefüggését.

<wpml-config>
    <shortcodes>
        <shortcode>
            <tag label="My shortcode label">my_shortcode</tag>
            <attributes>
                <attribute label="Shortcode title">title</attribute>
            </attributes>
        </shortcode>
    </shortcodes>
</wpml-config>

Mezők csoportosítása

Az átláthatóság kedvéért a mezők címkéjének elejére beírhatod a csoport nevét. Például egy cselekvésre ösztönző gombnál:

<wpml-config>
    <shortcodes>
        <shortcode>
            <tag label="Call To Action: Content">et_pb_cta</tag>
            <attributes>
                <attribute label="Call To Action: Title">title</attribute>
                <attribute label="Call To Action: Button Text">button_text</attribute>
                <attribute label="Call To Action: Button URL" type="link">button_url</attribute>
            </attributes>
        </shortcode>
    </shortcodes>
</wpml-config>

Fontos: a WPML ezeket a címkéket nem adja át a Haladó fordítószerkesztőnek. A fordító minden attribútumot külön mezőként lát, a shortcode alatt csoportosítva, és a mezők tartalmából ismeri fel, melyik micsoda. A label attribútum viszont része a konfigurációs formátumnak, ezért érdemes beállítani.

Média fordítása

A Media Translation kiegészítővel az oldalépítős tartalomban nyelvenként más képet is használhatsz. Ehhez a WPML-nek le kell cserélnie a képek azonosítóit és URL-jeit, és neked kell megmondanod neki, hogy az oldalépítő shortcode-jai hol tárolják ezeket:

<wpml-config>
  <shortcodes>
    <shortcode>
        <!-- A gallery_ids attribútum médiaazonosítóit cseréli, a shortcode tartalmát figyelmen kívül hagyja -->
        <tag ignore-content="1">et_pb_gallery</tag>
        <attributes>
          <attribute type="media-ids">gallery_ids</attribute>
        </attributes>
    </shortcode>
    <shortcode>
        <!-- A tartalomban lévő média URL-jét cseréli, a title és alt fordítható, a src média URL -->
        <tag type="media-url">et_pb_image</tag>
        <attributes>
          <attribute>title_text</attribute>
          <attribute>alt</attribute>
          <attribute type="media-url">src</attribute>
        </attributes>
    </shortcode>
  </shortcodes>
</wpml-config>

Használható értékek:

• ignore-content (a tag elemen, nem kötelező, 0 vagy 1): az új média-shortcode-ok visszamenőleges kompatibilitásához. Ha értéke 1, a shortcode tartalmát nem dolgozza fel.
• type a tag elemen: ha a shortcode tartalma média URL-t tartalmaz, media-url az értéke.
• type az attribute elemen:
  • media-ids: médiaazonosítók vesszővel elválasztott listája,
  • media-url: a média URL-je,
  • link: az oldal egy másik oldalára mutat, és a WPML automatikusan a lefordított oldal URL-jére cseréli.

Média a blokkattribútumokban

A media-url és a media-ids típus Gutenberg-blokkoknál is használható, például háttérképek fordításához. A shortcode-októl eltérően itt a <gutenberg-block> elem és a beágyazott <key> elemek adják meg a type="media-url" vagy type="media-ids" beállítást. Így a Media Translation kiegészítő a háttérképeket is le tudja fordítani.

Ez a Gutenberg-blokkokra és a Divi 5-re is működik, mert a Divi 5 blokkokban tárolja a tartalmat:

<wpml-config>
  <gutenberg-blocks>
    <gutenberg-block type="divi/section" translate="1">
      <key name="module">
        <key name="decoration">
          <key name="background">
            <key name="desktop">
              <key name="value">
                <key name="image">
                  <key name="url" type="media-url" />
                </key>
              </key>
            </key>
          </key>
        </key>
      </key>
    </gutenberg-block>
  </gutenberg-blocks>
</wpml-config>

Oldalépítő-widgetek

Az oldalépítő-widgeteket is regisztrálhatod a konfigurációs fájlban, ennek részleteit az Egyedi oldalépítő-widgetek regisztrálása fejezet írja le.

Shortcode-azonosítók automatikus cseréje

A WPML 4.5.9-től megadhatod, hogy egy shortcode-attribútum bejegyzés- vagy taxonómiatag-azonosítókat tartalmaz. A WPML ezeket az oldal frontendjén automatikusan a megfelelő nyelvű azonosítóra cseréli.

A WPML 4.8-tól ugyanez a logika működik az admin szövegekben tárolt objektumazonosítókra, valamint a bejegyzések egyedi mezőiben és az egyedi taxonómiatagok mezőiben lévő azonosítókra is.

Példa: ebben a shortcode-ban a product_ids termékazonosítókat tartalmaz.

[foo_product_list product_ids="12,34,56"]

Jelezd a WPML-nek, hogy az attribútum bejegyzésazonosítókat tárol:

<shortcode>
    <tag ignore-content="1">foo_product_list</tag>
    <attributes>
        <attribute type="post-ids" sub-type="product">product_ids</attribute>
    </attributes>
</shortcode>

A frontenden a shortcode automatikusan így jelenik meg a másik nyelven:

[foo_product_list product_ids="13,35,57"]

Beállítások:

• type: post-ids vagy taxonomy-ids.
• sub-type (nem kötelező): a konkrét entitás, ha ismered. Például product a WooCommerce termék bejegyzéstípusához. Ha nem adod meg, a WPML kitalálja.

Az azonosítók cseréje rugalmas, és a legtöbb formátumot felismeri: egyetlen azonosítót, azonosítólistát, szerializált tömböt és JSON-ba kódolt tömböt.

Helyettesítő karakter az attribútumnevekben

Egyes shortcode-ok sok, hasonló nevű attribútumban tárolnak azonosítót, például include_category, include_portfolio_category, include_product_cat. Egy <attribute> sor mindet lefedheti, ha az attribútumnévben * karaktert használsz:

<shortcode>
    <tag>fusion_post_cards</tag>
    <attributes>
        <attribute type="taxonomy-ids" exclude="include_product_skus">include_*</attribute>
        <attribute type="taxonomy-ids" exclude="exclude_product_skus">exclude_*</attribute>
    </attributes>
</shortcode>

• A * egy vagy több betűt, számjegyet, _ vagy - jelet helyettesít.
• A * csak a type="post-ids" és a type="taxonomy-ids" beállításnál működik.
• A név többi részét a WPML pontosan egyezteti, reguláris kifejezést az attribútumnevekben nem fogad el.
• Az exclude (nem kötelező) teljes attribútumnevek vesszővel elválasztott listája. Ezekben a WPML nem cseréli az azonosítókat. Használd azokra az attribútumokra, amelyek neve illeszkedik, de nem azonosítót tárolnak, például include_product_skus.

Kapcsolódó fejezetek

• Egyedi shortcode-ok fordítása
• 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 wp_options táblában tárolt szövegek
• A nyelvváltó testreszabása XML-ből