# Notification Center: guia completo

> Guia completo de instalação, configuração e utilização do DataFirefly Notification Center para WordPress e WooCommerce.

- Página: <https://www.datafirefly.com/pt/documentation/notification-center/>
- Idioma: pt
- Atualizado em: 2026-09-02
- Outros idiomas: [fr](https://www.datafirefly.com/documentation/notification-center/index.md), [en](https://www.datafirefly.com/en/documentation/notification-center/index.md), [es](https://www.datafirefly.com/es/documentation/notification-center/index.md), [de](https://www.datafirefly.com/de/documentation/notification-center/index.md), [it](https://www.datafirefly.com/it/documentation/notification-center/index.md), [pl](https://www.datafirefly.com/pl/documentation/notification-center/index.md), [nl](https://www.datafirefly.com/nl/documentation/notification-center/index.md)
- Índice: <https://www.datafirefly.com/pt/documentation/llms.txt>

## Apresentação

O DataFirefly Notification Center acrescenta um sino de notificações ao cabeçalho da sua loja WooCommerce, ao lado do carrinho e da área de cliente. Um ponto vermelho assinala as novidades por ler e leva naturalmente ao clique, sem e-mail nem pop-up intrusiva.

O módulo divulga automaticamente os seus novos produtos, os seus códigos promocionais e os seus artigos do blogue, e permite-lhe publicar anúncios livres a partir do painel. É multilingue (Polylang / WPML), compatível com a cache de página e com o armazenamento de encomendas de alto desempenho (HPOS).

**Em resumo:** um sino e um painel pendente, um ponto de não lidos, e três acionadores automáticos (produtos, códigos promocionais, artigos) prontos a usar.

## Instalação

1. Carregue a pasta `df-notification-center` para `wp-content/plugins/`, ou instale o ZIP a partir de Plugins e depois Adicionar.
2. Ative a extensão **DataFirefly Notification Center**.
3. Abra o menu **Notificações e depois Definições** para escolher a apresentação do sino.

O WooCommerce é recomendado para as notificações de produtos e de códigos promocionais. Os anúncios manuais e os artigos do blogue funcionam mesmo sem o WooCommerce.

## Apresentar o sino

O módulo propõe quatro métodos de colocação, a escolher em **Definições, Método de inserção**.

### Os 4 métodos

- **Menu de navegação**: o sino é acrescentado no fim de um menu (escolha a localização do tema, normalmente «primary»).
- **Seletor CSS**: o sino é inserido imediatamente antes ou depois de um elemento que designar. Ideal para o colar ao ícone do carrinho.
- **Sino flutuante**: um botão fixo em baixo à direita ou à esquerda do ecrã.
- **Shortcode**: coloque `[df_notification_center]` onde quiser.

### Colar o sino ao ícone do carrinho

Escolha o método **Seletor CSS** e indique o seletor do seu ícone de carrinho, por exemplo `a.cart-contents`. O sino é inserido automaticamente ao lado. O seletor exato depende do seu tema: inspecione o ícone do carrinho para o identificar.

### Aparência

Pode ajustar a cor de destaque, a cor do ponto e do sino, escolher entre um simples ponto vermelho ou um contador numérico, ativar a animação do sino quando há não lidos, e mostrar ou ocultar o sino em telemóvel.

## Anunciar os seus conteúdos

### Novos produtos (automático)

Quando a opção está ativa, cada produto publicado cria automaticamente uma notificação, sem qualquer ação. Ative ou desative este comportamento em **Definições, Produtos**.

### Códigos promocionais

No editor de um código promocional do WooCommerce aparece uma caixa **Centro de notificações**. Assinale-a para divulgar o código, com uma mensagem personalizada facultativa. O código aparece no painel com um botão **Copiar**. Se o cupão tiver data de expiração, a notificação desaparece automaticamente nessa data.

### Artigos do blogue

No editor de artigos, uma metabox **Centro de notificações** propõe uma caixa de seleção. Assinale-a para anunciar o artigo; pode acrescentar uma mensagem personalizada.

### Anúncios manuais

A partir do ecrã **Notificações**, crie anúncios livres (título, mensagem, ligação, data de expiração). A tabela também gere a ativação, a desativação e a eliminação de todas as notificações.

## Agendamento e acompanhamento dos cliques

Cada notificação pode receber uma data de fim: passada essa data, desaparece do painel. O painel de administração mostra ainda o número de cliques por notificação, para medir o que interessa aos seus visitantes. Uma limpeza automática opcional elimina as notificações inativas depois de um determinado número de dias.

## Lidas e não lidas

Para os clientes com sessão iniciada, o estado lido/não lido é memorizado no servidor e sincronizado entre os seus dispositivos. Para os visitantes sem sessão, é guardado no navegador. O sino mantém-se assim compatível com a cache de página: o conteúdo dinâmico é carregado em AJAX e não impede a colocação em cache.

Abrir o painel marca as notificações como lidas e apaga o ponto.

## Multilingue (Polylang e WPML)

Quando o filtro de idioma está ativo, cada notificação só aparece no seu idioma de origem: um produto publicado em francês só aparece na versão francesa do site, e assim sucessivamente. O módulo deteta o idioma através do Polylang ou do WPML. Pode desativar este filtro para divulgar todas as notificações em todos os idiomas.

## API REST (headless)

Um ponto de acesso de leitura expõe as notificações visíveis, útil para um front-end headless:

```
GET /wp-json/df-nc/v1/notifications
```

A resposta contém as notificações ativas (filtradas por idioma) e os identificadores já lidos pelo utilizador atual.

## FAQ e resolução de problemas

### O sino não aparece

Verifique o método de inserção escolhido. No modo **Menu**, confirme que há um menu atribuído à localização selecionada. No modo **Seletor CSS**, verifique que o seletor corresponde mesmo a um elemento presente na página.

### O ponto não aparece

O ponto só aparece se existir pelo menos uma notificação ativa por ler. Crie um anúncio de teste a partir do ecrã **Notificações** para confirmar.

### É compatível com a minha cache?

Sim. O sino é apresentado em HTML estático e as notificações são carregadas em AJAX, o que se mantém compatível com o WP Rocket, o LiteSpeed Cache e os restantes sistemas de cache.

### É compatível com HPOS?

Sim, o módulo declara a compatibilidade com o armazenamento de encomendas de alto desempenho do WooCommerce.
