# 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… - Página: - Idioma: pt - Atualizado em: 2026-09-15 - Outros idiomas: [fr](https://www.datafirefly.com/documentation/dffitmentfinder/index.md), [en](https://www.datafirefly.com/en/documentation/dffitmentfinder/index.md), [es](https://www.datafirefly.com/es/documentation/dffitmentfinder/index.md), [de](https://www.datafirefly.com/de/documentation/dffitmentfinder/index.md), [it](https://www.datafirefly.com/it/documentation/dffitmentfinder/index.md), [pl](https://www.datafirefly.com/pl/documentation/dffitmentfinder/index.md), [nl](https://www.datafirefly.com/nl/documentation/dffitmentfinder/index.md) - Índice: 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. Compatível com PrestaShop 8.0 a 9.x, PHP 7.4 a 8.3, em loja simples como em multiloja. ## 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. ## Posicionamentos, ícone e disposição (v1.1.0) Desde a versão 1.1.0, os interruptores «Mostrar no cabeçalho» e «Mostrar na página inicial» foram substituídos por um bloco **Mostrar o seletor em**: sete caixas de seleção que cobrem os posicionamentos habituais do tema (cabeçalho, barra sob o cabeçalho, página inicial, topo do conteúdo, colunas esquerda e direita, acima do rodapé). O campo **Hooks personalizados** aceita ainda os seus próprios hooks display, separados por vírgulas: são registados automaticamente ao guardar. O widget `{widget name='dffitmentfinder'}` continua a funcionar, independentemente destas definições. - **Ícone de veículo**: seis modelos incluídos (carro, garagem, impressora, telefone, chave, chip), sem ícone, ou a sua própria imagem PNG, JPG ou SVG enviada a partir da configuração. O ícone aparece no botão de guardar, no distintivo do veículo atual, na página da garagem e no verificador da página de produto. - **Disposição no desktop**: horizontal (campos numa linha) ou vertical (campos empilhados). No telemóvel o seletor empilha-se sempre verticalmente. ## Filtro global por veículo (v1.2.0) A definição **Filtrar as páginas de categoria pelo veículo selecionado**, ativa por predefinição, estende a seleção a toda a loja: enquanto um veículo estiver ativo, as páginas de categorias, marcas e fornecedores mostram apenas produtos compatíveis, com a ordenação e a paginação nativas do tema. Uma barra aparece por cima da listagem com o veículo ativo e duas ações: - **Mostrar todos os produtos**: pausa o filtro durante 30 dias (ou até à reativação). A barra continua visível e propõe então reativar o filtro. - **Mudar de veículo**: leva de volta ao seletor. Se a Navegação por facetas (ps_facetedsearch) estiver ativa, o filtro de veículo assume temporariamente estas páginas enquanto houver um veículo selecionado: a paginação, os contadores e a ordenação continuam exatos. Os filtros por facetas voltam assim que o cliente pausa o filtro ou apaga o veículo.