Personalize o seletor de idiomas do WPML usando o arquivo de configuração

O WPML permite que você personalize o seletor de idiomas para atender às suas necessidades específicas definindo as configurações no arquivo wpml-config.xml.

O wpml-config.xml é um arquivo de configuração que permite que você personalize como o seu seletor de idiomas do WPML aparece e se comporta no seu site. Você pode configurar vários atributos, como estilo CSS, configurações de exibição e shortcodes.

Este guia é para desenvolvedores que querem personalizar o seletor de idiomas integrado do WPML. Se você quiser criar um personalizado, leia nossa página sobre como criar um seletor de idiomas personalizado.

Precisa gerar um arquivo wpml-config.xml? Visite nosso guia passo a passo para gerar automaticamente um arquivo de configuração usando o plugin Multilingual Tools.

O que posso personalizar no meu seletor de idiomas?

O WPML permite que você personalize várias variáveis no seu seletor de idiomas. Isso inclui:

Estilos CSS embutidos – Adicione CSS personalizado diretamente ao seletor de idiomas
Link para conteúdo não traduzido – Decida se quer mostrar ou ocultar links para conteúdo não traduzido
Parâmetros de URL a copiar – Especifique os parâmetros de URL que devem ser copiados ao alternar os idiomas
Seletor de idiomas da barra lateral / rodapé – Configure a aparência do seletor de idiomas na barra lateral e no rodapé, incluindo:
- Se deve exibir bandeiras e/ou nomes de idiomas
- Se o idioma atual deve ser exibido como um link
- Definir um título para o widget do seletor de idiomas
- Escolher um modelo para o layout do seletor
- Personalizar cores para texto, fundo e bordas usando códigos de cores hexadecimais

Ações de shortcodes – Defina a aparência dos seletores de idiomas adicionados via shortcodes

Exemplo de adição de configuração personalizada para o seletor de idiomas integrado do 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>

Nem todas essas seções precisam estar presentes no seu arquivo de configuração. Apenas as que se aplicam ao seu plugin ou tema.

Como redefinir o seletor de idiomas do WPML para as configurações padrão

Você também pode usar o wpml-config.xml para redefinir a configuração do seletor de idiomas se ela tiver sido alterada no back-end (a partir de seus valores iniciais).
Para ver as novas alterações, certifique-se de clicar no botão Restaurar padrão na parte inferior da página WPML → Configurações → Seletores de idiomas.

Recursos adicionais

Para saber mais sobre o arquivo wpml-config.xml, visite o guia Arquivos de configuração de idioma.

Para personalizar outros elementos usando o arquivo wpml-config.xml, visite nossos guias adicionais: