Traduci gli shortcode personalizzati con WPML

Scopri come tradurre gli shortcode di plugin, temi e quelli che sviluppi tu stesso con WPML.

Con WPML, puoi tradurre gli shortcode basati su testo e quelli basati su ID. Gli shortcode basati su testo restituiscono del testo, come questo:

[goodmorning name="Dear client"]

D'altra parte, gli shortcode basati su ID restituiscono un elemento utilizzando il suo numero ID:

[myslider id="1"]
[myslider id="2"]

Qui, ogni shortcode restituisce uno slider diverso. Ad esempio, uno potrebbe restituire uno slider in inglese e l'altro in spagnolo.

Per tradurre lo shortcode, dovrai sostituire l'ID di uno slider con l'altro (ad es. 1 → 2).

Traduci gli shortcode di plugin e temi compatibili

Per tradurre gli shortcode di plugin e temi compatibili, vai su WPML → Dashboard di traduzione e invia la pagina che contiene il tuo shortcode per la traduzione. Il tuo shortcode apparirà nell'Editor di traduzione avanzato insieme al resto dei contenuti della pagina.

Ad esempio, ecco come appare il seguente shortcode nell'editor:

[goodmorning name="Dear client"]

Tradurre uno shortcode basato su testo nell'Editor di traduzione avanzato

Se il tuo shortcode include un attributo link (URL), usa la barra di ricerca per trovarlo. WPML nasconde i link negli shortcode per impostazione predefinita.

Tradurre gli attributi dei link degli shortcode nell'Editor di traduzione avanzato

Traduci gli shortcode di plugin e temi non compatibili

Per tradurre gli shortcode di plugin e temi non compatibili, devi prima registrarli nel file Configurazione XML personalizzata di WPML.

Considera questo esempio con due shortcode:

[fanpage link="https://example.com"]Some content[/fanpage]
[goodmorning name="dear client" type="official"]

Per registrare questi shortcode in WPML, useremo il seguente codice di configurazione:

<wpml-config>
  <shortcodes>
    <shortcode>
      <tag>goodmorning</tag>
      <attributes>
        <attribute>name</attribute>
        <attribute>type</attribute>
      </attributes>
    </shortcode>
    <shortcode>
      <tag label="Fanpage shortcode">fanpage</tag>
      <attributes>
        <attribute>link</attribute>
      </attributes>
    </shortcode>
  </shortcodes>
</wpml-config>

Ecco come funziona la configurazione in WPML:

Posiziona tutti gli shortcode all'interno di <shortcodes>
Racchiudi le singole impostazioni degli shortcode all'interno di <shortcode>
Definisci i nomi degli shortcode con <tag> e includi etichette personalizzate se necessario. Queste etichette vengono visualizzate accanto al testo nell'Editor di traduzione avanzato.
Definisci ogni titolo di attributo con <attribute>
Racchiudi tutti gli attributi con <attributes>

Una volta registrati i tuoi shortcode, puoi tradurli insieme al resto dei contenuti della pagina tramite WPML → Dashboard di traduzione.

Traduci gli shortcode personalizzati

Per tradurre gli shortcode personalizzati che sviluppi tu stesso, devi prima registrarli in WPML. Una volta fatto, puoi tradurli insieme al resto dei contenuti della pagina.

Traduci i testi hardcoded all'interno degli shortcode

Per impostazione predefinita, i testi hardcoded non sono traducibili in WPML. Per renderli traducibili, puoi usare il framework Gettext. Considera questo esempio, con “Good morning” come testo hardcoded:

function goodmorning_att($atts) {
    $default = array(
        'name' => 'there',
    );
    $a = shortcode_atts($default, $atts);
    return 'Good morning, '.$a['name'];
}
add_shortcode('goodmorning', 'goodmorning_att');

Per rendere “Good morning” traducibile, puoi adattare il codice per usare Gettext:

function goodmorning_att($atts) {
    $default = array(
        'name' => 'there',
    );
    $a = shortcode_atts($default, $atts);
    return __('Good morning, ', 'default').$a['name'];
}
add_shortcode('goodmorning', 'goodmorning_att');

Questo renderà il testo “Good morning” traducibile e lo popolerà in Traduzione stringhe.

Risorse aggiuntive

Per saperne di più sul file wpml-config.xml, visita la guida sui File di configurazione delle lingue. Per configurare altri elementi in WPML, consulta le nostre guide aggiuntive: