Traduci i testi che temi e plugin salvano in wp_options

Scopri come rendere traducibili i testi salvati nella tabella wp_options e come convertire automaticamente gli ID degli oggetti.

A volte i temi e i plugin includono testi come parte delle opzioni che salvano nella tabella wp_options. WPML ti permette di tradurre questi testi sostituendo le chiamate get_option con le traduzioni che specifichi nel file wpml-config.xml.

Il file wpml-config.xml è un documento di configurazione che indica a WPML quali stringhe nelle opzioni salvate necessitano di traduzione.

Questa guida è per gli sviluppatori che creano i propri temi e plugin. Se stai cercando di tradurre stringhe provenienti da temi e plugin di terze parti, leggi la nostra pagina su come trovare le stringhe che non compaiono nella pagina Traduzione stringhe.

Hai bisogno di generare un file wpml-config.xml? Visita la nostra guida passo dopo passo per generare automaticamente un file di configurazione utilizzando il plugin Multilingual Tools.

Tradurre le stringhe nella tabella wp_options

Quando i temi e i plugin usano get_option, leggono i valori dalla tabella wp_options. WPML può filtrare queste chiamate e fornire una traduzione ai valori di queste opzioni.

Questo funziona se il record wp_option è una semplice stringa, ma anche quando è un array serializzato.

Per tradurre una singola opzione, aggiungi una voce key sotto admin-texts. Per tradurre un array serializzato, aggiungi diverse chiavi sotto una key, come puoi vedere in my_plugin_options nell'esempio seguente.

Testi admin nel file di configurazione della lingua

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

È possibile usare il carattere jolly * nelle sottochiavi, come nel caso seguente.

Esempio di utilizzo del carattere jolly

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

È equivalente a questo codice:

Il codice equivalente

<wpml-config>
  <admin-texts>
    <key name="testing_option">
      <key name="sub_key_1"/>
      <key name="sub_key_2">
        <key name="sub_sub_21">
          <key name="sub_sub_211"/> 
        </key> 
        <key name="sub_sub_21"/>
        </key>
      <key name="more_sub_keys"/>
    </key>
  </admin-texts>
</wpml-config>

Tieni presente che il carattere jolly * NON funziona nelle chiavi genitore:

Il carattere jolly non funziona nelle chiavi genitore

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

Convertire automaticamente gli ID degli oggetti nei testi admin

A partire da WPML 4.8, puoi dichiarare che determinati testi admin contengono ID di oggetti come ID di articoli, prodotti o tassonomie. WPML converte automaticamente questi ID sul frontend del sito.

Questa è un'estensione della funzionalità esistente per convertire automaticamente gli ID negli shortcode e usa la stessa sintassi.

Nelle voci key sotto admin-texts, usa:

type per indicare a quale oggetto si fa riferimento, ad esempio post-ids o taxonomy-ids
sub-type (opzionale) quando vuoi dichiarare l'entità specifica (ad esempio product)

Gli attributi Type e sub-type possono essere aggiunti a qualsiasi livello di annidamento.

WPML può rilevare e convertire gli ID in questi formati:

Un singolo ID (ad esempio 123)
Un array (e un array codificato) di ID (ad esempio [123,456,789])
Un elenco di ID separati da virgola (ad esempio “123,456,789”)

Esempio di dichiarazione degli ID degli oggetti nei testi admin

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

Risorse aggiuntive

Per saperne di più sul file wpml-config.xml , visita la guida ai File di configurazione della lingua.

Per personalizzare altri elementi usando il file wpml-config.xml, visita le nostre guide aggiuntive: