Assistente de Escolha de Produto: documentação
Instalar e configurar o Assistente de Escolha de Produto: construtor de questionário, mapeamento das respostas, motor de correspondência, apresentação no front-office e página de resultados.
O Assistente de Escolha de Produto (módulo dffinder) transforma um catálogo complexo num percurso de compra guiado. Constrói uma árvore de perguntas no back-office; o visitante responde etapa a etapa e chega a uma seleção de produtos filtrada, exatamente como faria um vendedor especializado na loja.
Apresentação
O módulo destina-se a catálogos em que o cliente hesita: colchões, bicicletas, informática, cosmética, peças sobresselentes. Cada resposta do questionário está ligada a um ou vários critérios do seu catálogo (atributos, características, categorias, fabricantes, escalões de preço) e o módulo traduz as escolhas do visitante numa pesquisa de produtos nativa.
- Construtor da árvore de perguntas por arrastar e largar, sem código.
- Perguntas de escolha única ou múltipla, títulos e legendas multilingues.
- Contador de produtos correspondentes em tempo real em cada etapa.
- Página de resultados nativa (ordenação e paginação do tema) através de
ProductSearchProviderInterface. - Apresentação em widget na página inicial, etiqueta de widget ou página dedicada.
- Compatível com o PrestaShop 8.0 a 9.x, multiloja e multilingue.
Instalação
- Vá a Módulos > Gestor de módulos > Carregar um módulo.
- Selecione o ficheiro
dffinder-1.0.0.zipe valide a instalação. - O módulo cria as suas tabelas, um separador de administração DF Product Finder e as rotas reescritas
product-findereproduct-finder/results.
Depois da instalação, se os URL product-finder não responderem, regenere as ligações: Parâmetros avançados > Desempenho > Limpar a cache e verifique depois se os URL simplificados estão ativados em Tráfego e SEO.
Criar um primeiro assistente
Abra Módulos > DF Product Finder e clique em Adicionar um assistente. Dê-lhe um nome interno e um texto de introdução apresentado no topo do questionário. O construtor organiza-se em colunas: as perguntas à esquerda, as respostas de cada pergunta e os mapeamentos de cada resposta.
Acrescentar perguntas
Clique em Adicionar uma pergunta. Para cada pergunta, indique:
- o título (por exemplo, «Para que utilização?») e um texto de ajuda facultativo;
- o tipo de apresentação: escolha única (uma só resposta, com avanço automático) ou escolha múltipla (várias respostas assinaláveis);
- a ordem, arrastando a pergunta para a posição pretendida.
Acrescentar respostas
Por baixo de cada pergunta, acrescente as respostas propostas ao visitante (por exemplo, «Desporto», «Cidade», «Criança»). Cada resposta tem uma legenda multilingue e reordena-se por arrastar e largar dentro da sua pergunta.
Mapear as respostas para o catálogo
É o coração do módulo: cada resposta aponta para um ou vários critérios de produto. Os tipos de mapeamento disponíveis são:
- Atributo — um valor de atributo de combinação (tamanho, cor…), procurado nas combinações de produto;
- Característica — um valor de característica de produto;
- Categoria — a pertença a uma categoria;
- Fabricante — a marca do produto;
- Preço — um intervalo
min/maxsobre o preço base da loja.
Os campos de atributo, característica, categoria e fabricante têm preenchimento automático: escreva algumas letras para encontrar o valor. Uma mesma resposta pode acumular vários mapeamentos (por exemplo, uma categoria e um intervalo de preço).
Os intervalos de preço filtram pelo preço base sem impostos do produto para a loja atual (product_shop.price). Os impostos e os preços específicos (promoções, preços por grupo) não são aplicados neste filtro.
Quando a sua árvore estiver pronta, clique em Gravar. A gravação é idempotente: a árvore completa é reconstruída em cada gravação, o que garante um estado coerente.
Compreender o motor de correspondência
O módulo combina as escolhas do visitante segundo duas regras simples:
- OU entre as respostas de uma mesma pergunta: assinalar «Desporto» e «Cidade» alarga a seleção aos produtos que correspondam a uma ou a outra.
- E entre as perguntas: os critérios de cada pergunta ultrapassada acumulam-se para restringir a seleção.
Em cada etapa, o módulo recalcula por AJAX o número de produtos correspondentes e apresenta-o ao visitante, o que evita chegar a uma seleção vazia.
Apresentar o assistente
Widget na página inicial
Ative a apresentação na página inicial a partir da configuração do módulo. O widget apresenta um cartão com apelo à ação que leva ao questionário.
Etiqueta de widget
Para inserir o assistente em qualquer ponto de um template do seu tema, utilize a etiqueta Smarty:
{widget name='dffinder' id_finder=1}Substitua id_finder pelo identificador do assistente pretendido (visível na lista do back-office).
URL dedicados
O questionário também está diretamente acessível através de URL limpos, práticos para as suas campanhas:
a-sua-loja/product-finder— o questionário;a-sua-loja/product-finder/results?answers=1,4,9— a página de resultados.
A página de resultados
No fim do questionário, o visitante é encaminhado para uma página de resultados que estende o controlador de listagem nativo do PrestaShop. Na prática, obtém sem qualquer configuração adicional:
- o modelo de lista de produtos do seu tema;
- a ordenação por data, preço ou nome;
- a paginação padrão.
Uma ligação Recomeçar permite ao visitante relançar o questionário desde o início.
Multiloja e multilingue
O módulo está associado ao contexto de loja: cada assistente pertence à loja ou lojas à sua escolha. Todos os textos (nome, introdução, títulos das perguntas, legendas das respostas) podem ser introduzidos por idioma, através do seletor de idioma de edição presente no topo do construtor.
Resolução de problemas
O contador apresenta sempre zero. Verifique se os mapeamentos apontam para valores realmente utilizados pelos seus produtos (atributo ou característica devidamente atribuídos aos produtos) e se os produtos estão ativos e associados à loja atual.
O intervalo de preço não filtra como esperado. Lembre-se de que o filtro se aplica ao preço base sem impostos, sem preços específicos. Um produto em promoção continua a ser filtrado pelo preço de catálogo.
Boa prática. Comece por uma pergunta geral (utilização, perfil) e afine depois (orçamento, tamanho). Limite cada pergunta a algumas respostas claras para manter um percurso fluido.