# Lista de desejos avançada, partilha, alertas e estatísticas: guia completo

> Apresentação e pré-requisitos A Lista de Desejos Avançada transforma a lista de desejos numa verdadeira alavanca de conversão. Os seus clientes criam várias listas com nome, partilham-nas por ligação e…

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

## Apresentação e pré-requisitos

A Lista de Desejos Avançada transforma a lista de desejos numa verdadeira alavanca de conversão. Os seus clientes criam várias listas com nome, partilham-nas por ligação e recebem alertas automáticos em caso de descida de preço ou de regresso ao stock. Do lado do comerciante, cada interação fica registada num painel de estatísticas, e mensagens de lembrete configuráveis trazem os clientes de volta aos seus favoritos.

- Compatível com PrestaShop 8.0 a 9.x, tema Classic e temas derivados que respeitem os hooks nativos.
- Multiloja e multi-idioma (FR/EN/ES/DE/IT).
- JavaScript nativo, sem dependências adicionais de jQuery.
- Arquitetura conforme ao PrestaShop (ModuleAdminController, ObjectModel), sem dependências Composer.
- É necessária uma tarefa CRON para o envio dos alertas e dos lembretes.

O botão da lista de desejos aparece através dos hooks padrão da ficha de produto e das listagens. Num tema conforme, não é preciso qualquer alteração de template.

## Instalação

Instale o módulo como qualquer outro módulo PrestaShop:

1. Descarregue o arquivo `dfwishlist.zip` a partir da sua conta de cliente.
2. No back-office, vá a **Módulos > Gestor de módulos**.
3. Clique em **Carregar um módulo** e coloque o arquivo.
4. Depois de instalado, clique em **Configurar**.

Na instalação, o módulo cria as suas tabelas (listas, produtos, partilhas, alertas, lembretes, estatísticas, visitantes), regista os seus hooks, acrescenta o separador **Lista de desejos** ao menu e gera automaticamente um **token de CRON** seguro. Pode começar logo a configurar.

## Definições gerais do módulo

A página de configuração reúne todas as definições, organizadas em secções. As principais definições gerais são:

- **Ativar o módulo**: ativa ou desativa a apresentação do botão e das funcionalidades do lado da loja.
- **Lista de desejos para visitantes**: permite que visitantes sem sessão iniciada acrescentem produtos. A lista fica guardada num cookie e é depois fundida com a conta do cliente no início de sessão ou no registo.
- **Número máximo de listas por cliente**: limite de listas com nome que um cliente pode criar (10 por predefinição).
- **Estilo do botão**: apenas ícone (coração), ícone e texto, ou apenas texto.
- **Posição do botão na ficha de produto**: depois do botão «Adicionar ao carrinho», antes dele, ou na zona de informações adicionais.
- **Mostrar nas listagens de produtos**: acrescenta o botão às páginas de categorias, de pesquisa e de novidades.

## O botão, a área de cliente e os URL

Com o módulo ativo, aparece um botão de lista de desejos (coração) nas fichas de produto e, se a opção estiver ativa, nas listagens de produtos. É acrescentada uma ligação **As minhas listas de desejos** à área de cliente («A minha conta»).

O módulo expõe URL limpos e legíveis para o SEO:

```
/mes-listes-de-souhaits          → todas as listas do cliente
/liste-de-souhaits/{token}       → uma lista concreta
/wishlist-partagee/{token}       → uma lista partilhada publicamente
```

Estes caminhos vêm em francês tal como são fornecidos. Numa loja portuguesa, traduza-os para `/as-minhas-listas-de-desejos`, `/lista-de-desejos/{token}` e `/lista-partilhada/{token}` em **Parâmetros da loja > Tráfego e SEO**, antes de os URL serem indexados. Mudar um caminho depois da indexação obriga a redirecionamentos.

Depois da instalação, limpe a cache do PrestaShop e regenere as rotas (desativando e reativando os URL simplificados, se for preciso), para que os novos URL sejam considerados.

## Listas múltiplas e lista de visitante

Cada cliente pode criar várias listas com nome («Natal», «Casamento», «Ideias para o escritório»), até ao limite que definir, e gerir nelas os seus produtos com as respetivas combinações. Os visitantes sem sessão iniciada têm uma lista guardada num cookie: assim que criam uma conta ou iniciam sessão, os seus produtos são automaticamente fundidos na área de cliente, sem perdas.

Com a opção **Retirar da lista após a compra** ativa, um produto comprado é retirado automaticamente das listas do cliente na validação da encomenda, para manter as listas pertinentes.

O cookie da lista de visitante serve para prestar um serviço pedido pelo próprio visitante, o que o aproxima da exceção prevista na Lei n.º 41/2004 para o armazenamento estritamente necessário. Declare-o de qualquer forma na sua política de cookies, com a sua duração: é a transparência que se espera, e custa uma linha.

## Partilha de lista

Com a partilha ativa, cada lista pode ser partilhada através de um URL público único e protegido por token. O destinatário consulta a lista sem precisar de conta, o que é ideal para listas de prendas de aniversário ou de casamento. É fornecido um e-mail de partilha pronto a usar, em francês e em inglês.

Uma lista partilhada é acessível apenas para leitura através do seu token. O token é aleatório e impossível de adivinhar; revogar a partilha inutiliza a ligação.

## Prova social (efeito FOMO)

A prova social mostra, na ficha de produto, o número de pessoas que acrescentaram esse produto à sua lista de desejos («X pessoas acrescentaram este produto à lista de desejos»). Para evitar mostrar números pouco favoráveis nos produtos novos, define um **limiar mínimo**: o contador só aparece a partir desse número de adições.

O número apresentado tem de corresponder à realidade. Inflacionar um contador de prova social é uma prática comercial enganosa nos termos do Decreto-Lei n.º 57/2008, fiscalizada pela ASAE. O limiar mínimo serve para esconder um número baixo, nunca para o substituir por outro.

## Alertas automáticos: descida de preço e regresso ao stock

O módulo vigia os produtos presentes nas listas e aciona dois tipos de alerta por e-mail:

- **Alerta de descida de preço**: quando o preço de um produto na lista desce, os clientes em causa são notificados.
- **Alerta de regresso ao stock**: quando um produto esgotado volta a estar disponível, os clientes que o esperavam são avisados.

Cada tipo de alerta ativa-se de forma independente na configuração. O envio efetivo dos e-mails é feito pelo CRON (ver mais abaixo). São fornecidos modelos de e-mail em HTML, em francês e em inglês.

Um e-mail que anuncia uma descida de preço é um anúncio de redução: o Decreto-Lei n.º 66/2021 obriga a indicar o preço mais baixo praticado nos 30 dias anteriores. Se personalizar os modelos, inclua essa indicação junto do preço novo, e não apenas o preço antigo riscado.

## Mensagens de lembrete configuráveis

À maneira dos lembretes de carrinho abandonado, estas mensagens recordam aos clientes os produtos que têm na lista de desejos. Configura até **5 etapas**, cada uma com:

- Um **intervalo** em horas (por exemplo, 24 h, 72 h e depois 168 h, ou seja, 7 dias).
- Um **assunto personalizado** em francês e em inglês.

Deixe o intervalo de uma etapa a **0** para a desativar. Um limite ao número de e-mails de lembrete por cliente evita solicitar demasiado. Os valores predefinidos propõem três etapas (24 h, 72 h e 168 h) prontas a usar.

Mantenha assuntos curtos e apelativos, e espace bem as etapas. Três lembretes bem distribuídos costumam converter melhor do que uma série demasiado cerrada.

Estes lembretes são comunicações comerciais na aceção da Lei n.º 41/2004. Para um cliente que já lhe comprou produtos semelhantes, o regime de soft opt-in permite enviá-los desde que ofereça em cada mensagem uma forma simples de recusa. Para um visitante que apenas criou uma lista sem nunca ter comprado, é mais seguro exigir um consentimento explícito. Garanta que os modelos que personaliza incluem sempre a ligação de cancelamento.

## Configurar o CRON

Os alertas e os lembretes são enviados por uma tarefa agendada. Na instalação, o módulo gera um **token** que protege o URL do CRON. Acrescente no seu servidor (ou no seu alojamento) uma tarefa que chame o URL do módulo a intervalos regulares; uma passagem por hora é um bom ponto de partida.

```
curl "https://a-sua-loja.pt/modules/dfwishlist/cron/cron.php?action=all&token=O_SEU_TOKEN"
```

O parâmetro `action` aceita três valores:

- `all`: trata os alertas e os lembretes (recomendado).
- `alerts`: trata apenas os alertas de descida de preço e de regresso ao stock.
- `reminders`: trata apenas os lembretes.

O token é obrigatório: uma chamada sem token, ou com um token errado, é recusada. Não divulgue publicamente o URL completo do CRON. Pode gerar um novo token em caso de fuga.

## Painel de estatísticas do comerciante

O separador **Lista de desejos** do back-office dá uma vista em tempo real da atividade:

- Os **produtos mais adicionados às listas**, com o respetivo número de adições.
- As **categorias mais populares** nas listas.
- A **taxa de conversão** de lista para compra e a taxa de colocação no carrinho.
- O volume de **partilhas** ativas.

As tabelas podem ser **exportadas em CSV**, para trabalhar numa folha de cálculo ou cruzar com os seus outros dados de marketing.

## Perguntas frequentes e resolução de problemas

### Os visitantes sem sessão iniciada podem usar a lista de desejos?

Sim, se a opção de visitante estiver ativa. A lista de visitante é guardada num cookie e fundida automaticamente com a conta do cliente no início de sessão ou no registo.

### O botão da lista não aparece na ficha de produto

Confirme que o módulo está ativo, que o tema respeita os hooks nativos (**displayProductActions**, **displayProductAdditionalInfo**) e experimente outra posição de botão. Nas listagens de produtos, verifique que a opção «Mostrar nas listagens de produtos» está ativa e que o tema chama o hook **displayProductListFunctionalButtons**. Limpe a cache depois de qualquer alteração.

### Os alertas ou os lembretes não são enviados

Os e-mails são enviados pelo CRON, e não em tempo real. Confirme que a tarefa agendada chama mesmo o URL do módulo com o token correto, que a ação usada é `all` (ou `alerts` / `reminders`), e que o envio de e-mails da loja funciona (configuração SMTP do PrestaShop).

### Como personalizar os e-mails de lembrete?

Configura até 5 etapas, cada uma com um intervalo em horas e um assunto em francês e em inglês, diretamente na página de configuração. Os modelos HTML estão na pasta `mails` do módulo e podem ser substituídos através do seu tema.

Os modelos e os assuntos são fornecidos apenas em francês e em inglês. Antes de ativar os alertas e os lembretes numa loja portuguesa, crie a pasta `mails/pt` a partir de `mails/en`, traduza os modelos e preencha os assuntos em português. Sem isso, os seus clientes recebem uma mensagem numa língua que não é a deles, e a taxa de abertura reflete-o.

### A prova social está sempre visível?

Não. O contador só aparece a partir do limiar mínimo de adições que definir, para não mostrar números demasiado baixos nos produtos novos.

### O que acontece na desinstalação?

A desinstalação retira os hooks e o separador do módulo, e elimina as suas tabelas e os dados de listas de desejos associados. Faça uma cópia de segurança prévia se quiser conservar esses dados.