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 selettore di lingua di WPML sul tuo sito web. Puoi configurare diversi 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 dopo passo per generare automaticamente un file di configurazione utilizzando 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 devono 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, tra cui:
- Se visualizzare le bandiere e/o i nomi delle lingue
- Se la lingua attuale deve essere visualizzata 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 il testo, lo sfondo e i bordi utilizzando 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.

Ripristino delle impostazioni predefinite del selettore di lingua di WPML

Puoi anche utilizzare wpml-config.xml 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 le impostazioni predefinite” in fondo alla pagina WPML → Lingue.

Risorse aggiuntive

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

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