# Como corrigir o erro do widget Team Member no Happy Addons no WordPress

O widget Team Member do Happy Addons não funciona quando ele está desligado no Feature Controller, quando o On Demand Asset Loading não carrega o CSS e o JS do widget, ou quando a foto e os ícones sociais não foram configurados corretamente no painel do Elementor.

## O que é erro do Team Member no Happy Addons?

O Team Member é um widget do Happy Addons para Elementor que monta cartões de perfil da equipe com foto, nome, cargo, uma breve biografia e ícones de redes sociais como Facebook, LinkedIn e Twitter, conforme a documentação oficial do plugin. Cada item é configurado na aba Conteúdo e estilizado nas seções Photo, Name, Job Title & Bio e Social Icons da aba Style. O widget também aceita telefone no campo de redes sociais a partir da versão 3.7.1.

O erro aparece de três formas principais. O widget some da lista de busca do editor do Elementor, normalmente porque foi desativado no Feature Controller do Happy Addons. Ou o cartão é inserido, mas renderiza sem estilo, com a foto, o alinhamento e os ícones sociais quebrados, o que costuma ser o CSS do widget que não foi carregado por causa do On Demand Asset Loading combinado com cache. Ou ainda o conteúdo aparece incompleto, sem foto ou sem ícones, porque a imagem e os links sociais não foram preenchidos na aba Conteúdo do widget.

## Como identificar

- Ao digitar 'Team Member' na busca de widgets do editor do Elementor, o widget do Happy Addons não aparece na lista.
- O cartão Team Member é inserido na página, mas renderiza sem estilo: foto sem dimensão, texto desalinhado e ícones sociais como links de texto cru.
- A foto do membro não aparece no cartão, mesmo com a imagem selecionada, deixando um espaço vazio ou um ícone de imagem quebrada.
- Os ícones de redes sociais (Facebook, LinkedIn, Twitter) somem ou aparecem todos com o mesmo ícone genérico.
- O widget funciona no editor do Elementor, mas no site publicado o cartão perde o estilo e volta ao visual padrão do tema.
- No console do navegador (F12) aparece um erro 404 para um arquivo de CSS ou JS do Happy Addons ao abrir a página com o Team Member.

**Antes de começar:** Antes de atualizar plugins, regenerar arquivos do Elementor ou limpar cache em um site em produção, faça um backup completo (arquivos e banco de dados) ou teste primeiro em um ambiente de staging, para poder reverter caso a página com o Team Member quebre.

## Como prevenir

- Mantenha o Happy Addons e o Elementor sempre na versão estável mais recente, validando antes em staging, para acompanhar mudanças nos widgets e na renderização.
- Antes de desligar widgets no Feature Controller para ganhar performance, confirme que nenhuma página publicada usa o Team Member, evitando que o cartão suma do editor sem querer.
- Configure as regras de exclusão de cache e de CDN para não servir páginas com assets do Happy Addons incompletos quando o On Demand Asset Loading estiver ativo.
- Ao montar um cartão de equipe, preencha sempre foto e links sociais completos na aba Conteúdo e revise o resultado no preview antes de publicar.

Erros relacionados

- [Como corrigir o erro do Image Grid no Happy Addons](https://full.services/wp-fixer/corrigir-image-grid-happy-addons/)
- [Como corrigir o erro do Advanced Heading no Happy Addons](https://full.services/wp-fixer/corrigir-advanced-heading-happy-addons/)
- [Como corrigir o Happy Addons que não carrega no Elementor](https://full.services/wp-fixer/corrigir-happy-addons-nao-carrega-elementor/)

## Causa

- O widget Team Member está desligado no Feature Controller do Happy Addons (menu Features no painel): quando um widget é desativado ali, ele deixa de aparecer no editor do Elementor, segundo a documentação oficial do plugin.
- O On Demand Asset Loading do Happy Addons, que só carrega o CSS e o JS dos widgets em uso, não entregou os arquivos do Team Member porque um plugin de cache serviu uma versão antiga da página sem esses assets.
- O arquivo de CSS do Team Member ficou desatualizado depois de uma atualização do Happy Addons ou do Elementor, e os arquivos CSS gerados pelo Elementor não foram regenerados, deixando o widget sem estilo.
- A imagem do membro não foi selecionada na aba Conteúdo do widget, ou foi apagada da Biblioteca de Mídia depois de inserida, fazendo a foto sumir do cartão.
- Os links sociais não foram adicionados via botão ADD ITEM na aba Conteúdo, ou a URL ficou sem o domínio reconhecível, então o widget não consegue mapear o ícone correto de cada rede.
- Uma versão do Happy Addons anterior à 3.7.1 está em uso e não reconhece o campo de telefone nos perfis sociais, quebrando a lista de ícones quando esse campo é usado.

## Como resolver

1. Reative o widget no Feature Controller: Se o Team Member não aparece na busca de widgets, abra o menu Features do Happy Addons no painel do WordPress, localize o widget Team Member e ligue o botão. Salve para que ele volte a aparecer no editor do Elementor, conforme a documentação do Feature Controller.

```
Painel WP -> Happy Addons -> Features
Localize 'Team Member' na lista de widgets e ative o botão
Clique em Save Changes (Salvar) e recarregue o editor do Elementor
```

2. Atualize o Happy Addons e o Elementor: Garanta o Happy Addons na versão 3.7.1 ou superior, que ajustou os campos sociais do Team Member, e o Elementor na versão estável mais recente. Versões antigas podem renderizar o widget sem o tratamento atual dos ícones e da foto.

```
Painel WP -> Plugins -> verifique a versão do Happy Elementor Addons (alvo: 3.7.1+)
Painel WP -> Plugins -> atualize também o Elementor para a versão estável mais recente
```

3. Regenere os arquivos CSS do Elementor: Quando o cartão aparece sem estilo, force o Elementor a recriar os arquivos de CSS para que o estilo do Team Member seja gerado de novo. Isso resolve o caso em que o CSS ficou desatualizado após uma atualização.

```
Painel WP -> Elementor -> Ferramentas -> aba Geral
Clique em 'Regenerar Arquivos & Dados' (Regenerate Files & Data)
```

4. Limpe o cache do site e do navegador: Como o On Demand Asset Loading só carrega o CSS e o JS dos widgets em uso, um cache antigo pode servir a página sem esses arquivos. Limpe o cache do plugin de cache, do CDN e do navegador para forçar o recarregamento dos assets do widget.

```
Limpe o cache do seu plugin de cache (ex.: WP Rocket -> Configurações -> Limpar cache)
Purgue o cache do CDN se usar Cloudflare ou similar
Recarregue a página com o cache do navegador ignorado (Ctrl + Shift + R)
```

5. Revise a foto e os links sociais na aba Conteúdo: Se o cartão renderiza, mas sem foto ou sem ícones, abra o widget e confirme que a imagem foi selecionada e que cada link social foi adicionado pelo botão ADD ITEM com a URL completa da rede. URLs sem domínio reconhecível impedem o widget de mapear o ícone certo.

```
Edite o widget Team Member no Elementor -> aba Conteúdo (Content)
Reenvie ou reselecione a imagem do membro no campo de foto
Em Social Links, use ADD ITEM e cole a URL completa de cada rede (ex.: https://linkedin.com/in/usuário)
```


## Código

```php
<?php
// Força o carregamento dos assets do Happy Addons em todas as páginas
// quando o On Demand Asset Loading deixa o Team Member sem estilo.
// Coloque em um plugin de snippets (ex.: Code Snippets) ou no functions.php do tema filho.
add_filter( 'happyaddons_load_assets_on_demand', '__return_false' );

// Opcional: garante o enqueue do CSS do Happy Addons no frontend.
add_action( 'wp_enqueue_scripts', 'full_force_happy_addons_css', 20 );
function full_force_happy_addons_css() {
    if ( wp_style_is( 'hello-elementor', 'registered' ) || did_action( 'elementor/loaded' ) ) {
        wp_enqueue_style( 'happy-addons-style' );
    }
}
```

## Perguntas frequentes

### Por que o widget Team Member do Happy Addons sumiu do editor do Elementor

Na maioria dos casos ele foi desativado no Feature Controller do Happy Addons. A documentação oficial diz que um widget desligado ali deixa de aparecer no editor. Abra o menu Features, reative o Team Member e salve para que ele volte à busca de widgets.

### Por que o cartão Team Member aparece sem estilo no site publicado

Geralmente o CSS do widget não foi carregado por causa do On Demand Asset Loading combinado com cache antigo. Regenere os arquivos do Elementor em Elementor, Ferramentas e limpe o cache do site, do CDN e do navegador para forçar o recarregamento dos assets.

### A foto do membro não aparece no Team Member, o que fazer

Confirme na aba Conteúdo do widget se a imagem foi mesmo selecionada e se ela ainda existe na Biblioteca de Mídia. Se a imagem foi apagada depois de inserida, reenvie ou reselecione a foto no campo correspondente do widget.

### Por que os ícones sociais do Team Member não aparecem corretamente

O widget mapeia o ícone pela URL da rede. Adicione cada link pelo botão ADD ITEM na aba Conteúdo usando a URL completa, como a do Facebook, LinkedIn ou Twitter. URLs incompletas impedem o widget de identificar e exibir o ícone certo.

### Preciso de qual versão do Happy Addons para o Team Member funcionar bem

Use o Happy Addons 3.7.1 ou superior, versão que ajustou os campos sociais do Team Member e adicionou o suporte a telefone no perfil. Mantenha também o Elementor atualizado para garantir a renderização correta do cartão.

### Desligar o On Demand Asset Loading resolve o Team Member sem estilo

Pode ajudar como teste, pois ele passa a carregar o CSS e o JS de todos os widgets. Antes disso, prefira regenerar os arquivos do Elementor e limpar o cache, que costuma resolver mantendo o ganho de performance do carregamento sob demanda.

### O Team Member do Happy Addons é gratuito

Sim, o Team Member faz parte do conjunto gratuito de widgets do Happy Elementor Addons, listado na documentação oficial como widget da versão Free. Ele depende do Elementor instalado e ativo para aparecer no editor.

### O Team Member funciona no editor mas quebra ao publicar, por quê

Esse padrão indica que o editor carrega os assets, mas a versão pública é servida do cache sem o CSS do widget. Limpe o cache do plugin e do CDN e regenere os arquivos do Elementor para que a página publicada receba o estilo do Team Member.

**Fonte:** [Happy Addons — Team Member Widget (documentação oficial)](https://happyaddons.com/docs/happy-addons-for-elementor/widgets/team-member/)
