DF Fitment Finder: pesquisa por veículo e compatibilidade de produto

O DF Fitment Finder acrescenta à sua loja PrestaShop uma pesquisa por compatibilidade: o cliente seleciona o seu veículo (ou o seu aparelho) e o catálogo passa a mostrar-lhe apenas os produtos que lhe servem. Esta documentação cobre a instalação, a configuração, a alimentação da base de veículos e a apresentação no front-office.

Instalação

1. Vá a Módulos > Gestor de módulos e clique em Instalar um módulo.
2. Carregue o ficheiro dffitmentfinder.zip e inicie a instalação.
3. Clique em Configurar para aceder às definições.

A instalação cria três tabelas (base de veículos, correspondências de produtos, garagens de clientes), regista os hooks necessários e acrescenta o separador Veículos sob o menu Catálogo. Não é colocado nenhum override do núcleo nem é necessária qualquer dependência Composer.

Configuração

Níveis de pesquisa

O seletor assenta em quatro níveis: Marca, Modelo, Ano e Motorização. Os dois primeiros estão sempre ativos; os dois últimos ativam-se ou desativam-se consoante o seu catálogo.

• Usar o ano: a desativar para um catálogo sem noção de ano (tinteiros de impressora, capas de telemóvel, peças de eletrodomésticos).
• Usar a motorização: a desativar se o nível mais fino da sua base for o modelo.

A pesquisa é possível assim que a marca e o modelo estão preenchidos: o cliente nunca é obrigado a ir até ao nível mais fino.

Etiquetas dos níveis

Cada nível tem uma etiqueta modificável por idioma. Por defeito: Marca, Modelo, Ano, Motorização. Adapte-as ao seu setor:

• Peças automóveis: Marca / Modelo / Ano / Motorização
• Tinteiros de impressora: Marca / Série / (vazio) / Referência
• Capas de telemóvel: Marca / Modelo
• Eletrodomésticos: Fabricante / Gama / Ano / Referência

Zonas de apresentação

• Mostrar no cabeçalho: o seletor aparece no topo de todas as páginas.
• Mostrar na página inicial: o seletor aparece no conteúdo da página inicial.
• Widget: coloque o seletor onde quiser no seu tema com a tag Smarty {widget name='dffitmentfinder'}.

Ficha de produto

• Verificação de compatibilidade: mostra sob o preço uma faixa verde (o produto serve no veículo atual), vermelha (não serve) ou neutra (nenhum veículo selecionado).
• Tabela de correspondências: mostra no fundo da ficha a lista completa dos veículos compatíveis, agrupada por marca e retrátil.

Resultados por página

Número de produtos apresentados por página na página de resultados. Valor por defeito: 12.

Alimentar a base de veículos

Introdução manual

Vá a Catálogo > Veículos. O botão Adicionar abre o formulário de um veículo:

• Marca e Modelo: obrigatórios.
• Ano de início e Ano de fim: facultativos. Deixados vazios, o veículo é considerado válido para todos os anos. Preenchidos, definem um intervalo: um veículo 2012–2019 aparecerá para cada um dos anos do intervalo no seletor.
• Motorização: facultativa, é o nível mais fino (por exemplo « 1.2 PureTech »).
• Ativo: um veículo inativo deixa de aparecer no seletor mas conserva as suas correspondências.

Associar produtos a um veículo

Depois de o veículo estar guardado, aparece um painel Produtos compatíveis no fundo do seu formulário. Escreva pelo menos dois caracteres (nome ou referência) no campo de pesquisa, clique num resultado e o produto é associado imediatamente. O campo Nota, facultativo, permite precisar o alcance da compatibilidade: « apenas eixo dianteiro », « caixa manual », « a partir do chassis n.º 12000 »… Esta nota é apresentada na tabela de correspondências na ficha de produto.

Importação CSV

Para bases volumosas, a importação CSV é a via recomendada. O ficheiro esperado tem seis colunas:

make;model;year_from;year_to;variant;references

Exemplo:

Peugeot;208;2012;2019;1.2 PureTech;BRK-P208-F|FLT-P208
Peugeot;208;2012;2019;1.6 BlueHDi;BRK-P208-F
HP;LaserJet Pro M404;;;;TNR-59A|TNR-59X

• O separador, ponto e vírgula ou vírgula, é detetado automaticamente (o Excel em português exporta em ponto e vírgula por defeito).
• A coluna references contém as referências de produto compatíveis, separadas por uma barra vertical.
• As colunas de anos e de motorização podem ficar vazias.
• Um veículo já presente na base não é duplicado: as suas correspondências são simplesmente completadas.
• No fim da importação, um relatório indica o número de veículos criados, de correspondências acrescentadas e de linhas com erro.

Exportação CSV

O botão Exportar em CSV, na página de configuração do módulo, descarrega a totalidade da base no mesmo formato. Prático para retrabalhar os dados numa folha de cálculo e depois reimportá-los.

O percurso do cliente

Seleção do veículo

O cliente escolhe a sua marca, depois o seu modelo e depois (se os níveis estiverem ativos) o seu ano e a sua motorização. Cada menu preenche-se a partir do anterior, sem recarregar a página. O botão Pesquisar abre a página de resultados, que mostra os produtos compatíveis com as miniaturas nativas do seu tema.

O veículo selecionado é depois memorizado e recordado em todas as páginas, até que o cliente o mude ou apague.

A minha garagem

O botão Adicionar à minha garagem guarda o veículo atual. A página A minha garagem, acessível a partir da área de cliente, lista os veículos guardados e permite:

• designar um veículo como veículo atual;
• ver diretamente os produtos compatíveis com um veículo;
• eliminar um veículo da garagem.

A garagem funciona também para os visitantes não autenticados: os seus veículos são conservados e associados automaticamente à sua conta assim que iniciam sessão ou criam uma conta.

Na ficha de produto

Se a verificação de compatibilidade estiver ativada e houver um veículo atual selecionado, aparece uma faixa sob o preço: verde se o produto for compatível, vermelha caso contrário. Na ausência de veículo selecionado, uma mensagem neutra convida o cliente a escolher um.

Se a tabela de correspondências estiver ativada, a ficha mostra no fundo a lista completa dos veículos compatíveis, agrupada por marca e retrátil, com a eventual nota de cada correspondência.

Perguntas frequentes

Posso usar o módulo sem noção de veículo?

Sim. Desative os níveis Ano e Motorização, renomeie as etiquetas, e o módulo torna-se um seletor Marca / Série adequado a tinteiros, capas, peças de eletrodomésticos ou a qualquer catálogo em que a compatibilidade condiciona a compra.

O que acontece a uma correspondência quando elimino um produto?

É eliminada automaticamente. A base não conserva linhas órfãs.

O seletor torna o meu site mais lento?

Não. Os menus são preenchidos em AJAX a pedido, em JavaScript nativo e sem dependência de jQuery: só a lista de marcas é carregada na primeira apresentação.

O módulo é compatível com multiloja?

Sim. As correspondências de produtos e as garagens dos clientes respeitam o contexto de loja.