06/07/2024

Adicionar Atributos HTML Personalizados a um Widget no Elementor

add_action('elementor/frontend/widget/before_render', function($widget) {
    if ('text-editor' === $widget->get_name()) {
        $widget->add_render_attribute('_wrapper', 'data-custom-attribute', 'valor-personalizado');
    }
});

Como funciona:

1. Ação Antes da Renderização do Widget:
   • add_action('elementor/frontend/widget/before_render', function($widget) { ... });: Adiciona uma função anônima ao gancho elementor/frontend/widget/before_render, que é acionado antes que qualquer widget seja renderizado no front-end.
     
2. Verificação do Nome do Widget:
   • if ('text-editor' === $widget->get_name()) { ... }: Verifica se o nome do widget atual é ‘text-editor’. Isso garante que o código só será aplicado aos widgets de editor de texto.
     
3. Adicionar Atributo Personalizado:
   • $widget->add_render_attribute('_wrapper', 'data-custom-attribute', 'valor-personalizado');: Adiciona um atributo personalizado ao elemento wrapper do widget.
     • '_wrapper': Especifica que o atributo será adicionado ao elemento wrapper do widget.
     • 'data-custom-attribute': Nome do atributo personalizado a ser adicionado.
     • 'valor-personalizado': Valor do atributo personalizado.

Instruções de Uso

Substitua 'text-editor' pelo nome do widget que você deseja adicionar o atributo personalizado.

Esse código pode ser usado adicionando-o ao arquivo functions.php do seu tema ou, preferencialmente, em um plugin específico para o site. Utilizar um plugin para essas customizações mantém o código organizado e seguro contra atualizações do tema.

Conclusão

Este snippet permite que você adicione atributos personalizados aos widgets de editor de texto do Elementor, oferecendo mais flexibilidade para personalizações e integrações avançadas. O atributo data-custom-attribute com o valor valor-personalizado será adicionado ao elemento wrapper de cada widget de editor de texto antes de sua renderização.