Personalizza il selettore di lingua WPML con il file di configurazione

WPML ti permette di personalizzare il selettore di lingua per soddisfare le tue esigenze specifiche configurando le impostazioni nel file wpml-config.xml.

Il file wpml-config.xml è un file di configurazione che ti permette di personalizzare l'aspetto e il comportamento del tuo selettore di lingua di WPML sul tuo sito web. Puoi configurare una serie di attributi, come lo stile CSS, le impostazioni di visualizzazione e gli shortcode.

Questa guida è rivolta agli sviluppatori che vogliono personalizzare il selettore di lingua integrato di WPML. Se vuoi crearne uno personalizzato, leggi la nostra pagina su come creare un selettore di lingua personalizzato.

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

Cosa posso personalizzare nel mio selettore di lingua?

WPML ti permette di personalizzare diverse variabili nel tuo selettore di lingua. Queste includono:

Stili CSS in linea – aggiungi CSS personalizzato direttamente al selettore di lingua
Link ai contenuti non tradotti – decidi se mostrare o nascondere i link ai contenuti non tradotti
Parametri URL da copiare – specifica i parametri URL che dovrebbero essere copiati quando si cambia lingua
Selettore di lingua nella barra laterale / nel footer – configura l'aspetto del selettore di lingua nella barra laterale e nel footer, includendo:
- se mostrare le bandiere e/o i nomi delle lingue
- se la lingua attuale deve essere mostrata come link
- l'impostazione di un titolo per il widget del selettore di lingua
- la scelta di un template per il layout del selettore
- la personalizzazione dei colori per testo, sfondo e bordi usando i codici colore esadecimali

Azioni degli shortcode – definisci l'aspetto dei selettori di lingua aggiunti tramite shortcode

Esempio di aggiunta di una configurazione personalizzata per il selettore di lingua integrato di WPML

<wpml-config>
  <language-switcher-settings>
    <key name="additional_css">{inline CSS styles}</key>
    <key name="link_empty">{0 or 1}</key>
    <key name="copy_parameters">{parameter1, parameter2}</key>
    <key name="sidebars">
        <key name="{sidebar slug}">
            <key name="display_flags">{0 or 1}</key>
            <key name="display_names_in_current_lang">{0 or 1}</key>
            <key name="display_names_in_native_lang">{0 or 1}</key>
            <key name="display_link_for_current_lang">{0 or 1}</key>
            <key name="widget_title">{widget title}</key>
            <key name="template">{template slug}</key>
            <!-- color picker keys -->
            <key name="background_normal">#{hex color}</key>
            <key name="border_normal">#{hex color}</key>
            <key name="font_current_normal">#{hex color}</key>
            <key name="font_current_hover">#{hex color}</key>
            <key name="background_current_normal">#{hex color}</key>
            <key name="background_current_hover">#{hex color}</key>
            <key name="font_other_normal">#{hex color}</key>
            <key name="font_other_hover">#{hex color}</key>
            <key name="background_other_normal">#{hex color}</key>
            <key name="background_other_hover">#{hex color}</key>
        </key>
    </key>
    <key name="statics">
        <key name="footer">
            <key name="show">{0 or 1}</key>
            <key name="display_flags">{0 or 1}</key>
            <key name="display_names_in_current_lang">{0 or 1}</key>
            <key name="display_names_in_native_lang">{0 or 1}</key>
            <key name="display_link_for_current_lang">{0 or 1}</key>
            <key name="template">{template slug}</key>
            <!-- color picker keys -->
            <key name="background_normal">#{hex color}</key>
            <key name="border_normal">#{hex color}</key>
            <key name="font_current_normal">#{hex color}</key>
            <key name="font_current_hover">#{hex color}</key>
            <key name="background_current_normal">#{hex color}</key>
            <key name="background_current_hover">#{hex color}</key>
            <key name="font_other_normal">#{hex color}</key>
            <key name="font_other_hover">#{hex color}</key>
            <key name="background_other_normal">#{hex color}</key>
            <key name="background_other_hover">#{hex color}</key>
        </key>
        <key name="post_translations">
            <key name="show">{0 or 1}</key>
            <key name="display_flags">{0 or 1}</key>
            <key name="display_names_in_current_lang">{0 or 1}</key>
            <key name="display_names_in_native_lang">{0 or 1}</key>
            <key name="display_link_for_current_lang">{0 or 1}</key>
            <key name="display_before_content">{0 or 1}</key>
            <key name="display_after_content">{0 or 1}</key>
            <key name="template">{template slug}</key>
            <key name="availability_text">{string like "See post translations: %s"}</key>
        </key>
        <key name="shortcode_actions">
            <key name="display_flags">{0 or 1}</key>
            <key name="display_names_in_current_lang">{0 or 1}</key>
            <key name="display_names_in_native_lang">{0 or 1}</key>
            <key name="display_link_for_current_lang">{0 or 1}</key>
            <key name="template">{template slug}</key>
            <!-- color picker keys -->
            <key name="background_normal">#{hex color}</key>
            <key name="border_normal">#{hex color}</key>
            <key name="font_current_normal">#{hex color}</key>
            <key name="font_current_hover">#{hex color}</key>
            <key name="background_current_normal">#{hex color}</key>
            <key name="background_current_hover">#{hex color}</key>
            <key name="font_other_normal">#{hex color}</key>
            <key name="font_other_hover">#{hex color}</key>
            <key name="background_other_normal">#{hex color}</key>
            <key name="background_other_hover">#{hex color}</key>
        </key>
    </key>
  </language-switcher-settings>
</wpml-config>

Non tutte queste sezioni devono essere presenti nel tuo file di configurazione. Solo quelle che si applicano al tuo plugin o tema.

Ripristinare il selettore di lingua di WPML alle impostazioni predefinite

Puoi usare wpml-config.xml anche per ripristinare la configurazione del selettore di lingua se è stata modificata dal back-end (rispetto ai suoi valori iniziali).
Per vedere le nuove modifiche, assicurati di fare clic sul pulsante Ripristina predefinito in fondo alla pagina WPML → Impostazioni → Selettori di lingua.

Risorse aggiuntive

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

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