DF Samples: pedido de amostras (PrestaShop 8 e 9)

Apresentação

O DF Samples acrescenta um botão « Pedir uma amostra » às suas fichas de produto. A amostra pode ser gratuita ou cobrada por alguns euros. O módulo gera automaticamente um produto amostra oculto para cada produto inscrito no programa, aplica limites por cliente, regista a conversão amostra → compra e envia automaticamente um lembrete por e-mail aos seus clientes com um vale de desconto opcional.

O módulo é compatível com PrestaShop 8.0 a 9.x, multiloja e multilingue, e não usa nenhum override do núcleo.

Instalação

1. No back-office, vá a Módulos > Gestor de módulos.
2. Clique em Instalar um módulo e carregue o ficheiro dfsamples.zip.
3. Na instalação, o módulo cria as suas duas tabelas, as suas definições por defeito, um token de segurança para a tarefa cron e um separador de administração Catálogo > Amostras (DF).

O módulo regista-se nos hooks displayProductActions, displayProductAdditionalInfo, actionFrontControllerSetMedia, actionValidateOrder e actionObjectProductDeleteAfter.

Adicionar um produto ao programa de amostras

1. Abra Catálogo > Amostras (DF).
2. Clique em Adicionar.
3. Pesquise um produto por nome ou por referência no campo de preenchimento automático e selecione-o na lista. Os produtos já inscritos no programa e os próprios produtos amostra são automaticamente excluídos dos resultados.
4. Introduza o preço da amostra com IVA. Introduza 0,00 para uma amostra gratuita.
5. Defina o máximo por cliente para este produto (0 = ilimitado).
6. Guarde.

O que o módulo faz ao guardar

O módulo cria automaticamente um produto amostra oculto:

• Nome com prefixo traduzido nos seus idiomas: Échantillon, Sample, Muestra, Muster, Campione.
• Referência dedicada no formato SMPL seguido do identificador do produto de origem.
• Preço sem IVA calculado a partir do preço com IVA introduzido e da taxa de IVA do produto de origem.
• Imagem de capa do produto de origem copiada e redimensionada em todos os formatos.
• Visibilidade definida em « em lado nenhum »: o produto não aparece nem na navegação nem na pesquisa.
• Stock ilimitado (autorização de encomenda em rutura) para nunca bloquear um pedido.
• Peso da amostra proveniente da definição global, usado pelas transportadoras.

Se alterar depois o preço, o peso global ou o estado ativo, o produto amostra é ressincronizado. Se o produto amostra tiver sido eliminado manualmente do catálogo, é recriado na próxima gravação.

Definições

As definições encontram-se no fundo da página Catálogo > Amostras (DF), sob a lista de produtos.

Definições gerais

• Posição do botão: sob o botão de adição ao carrinho (displayProductActions) ou no bloco de informações complementares (displayProductAdditionalInfo). Altere esta definição se o seu tema não renderizar o primeiro hook.
• Preço de amostra por defeito com IVA: valor pré-preenchido na criação de uma nova amostra.
• Peso da amostra: em quilogramas, aplicado a todos os produtos amostra gerados. Usado para o cálculo dos portes.
• Conta de cliente obrigatória: recomendado e ativado por defeito. Os limites por cliente só podem ser aplicados de forma fiável a clientes identificados.
• Conversão contabilizada em: a compra do produto amostrado apenas, ou qualquer compra posterior.

Limites

• Máximo de amostras por carrinho: 0 para ilimitado.
• Máximo de amostras por cliente e por janela: todos os produtos amostra em conjunto. 0 para ilimitado.
• Janela deslizante: em dias, 30 por defeito. Os contadores por cliente incidem sobre este período deslizante.

Uma mesma amostra nunca pode ser adicionada duas vezes ao mesmo carrinho, qualquer que seja a configuração.

Lembrete automático

• Ativar os e-mails de lembrete.
• Prazo depois da encomenda de amostra: em dias, 14 por defeito.
• Incluir um vale de desconto: é gerado um vale nominativo, de utilização única, para cada lembrete.
• Montante do vale: em percentagem, 10 por defeito.
• Validade do vale: em dias, 30 por defeito.

O URL da tarefa cron, protegido por um token, é apresentado nesta secção e no painel de estatísticas.

Configurar a tarefa cron

Os lembretes são enviados por uma tarefa cron. Agende o URL apresentado nas definições de hora a hora. Exemplo de crontab:

0 * * * * wget -q -O /dev/null "https://a-sua-loja.pt/module/dfsamples/cron?token=O_SEU_TOKEN"

Cada execução processa até cinquenta lembretes pendentes e devolve um resumo JSON: número de registos processados, enviados, ignorados e pendentes.

Regras aplicadas pela tarefa cron

• Só são consideradas as amostras ainda não convertidas e ainda sem lembrete.
• A encomenda de amostra deve ter atingido um estado pago, enviado ou entregue.
• As encomendas canceladas ou com erro de pagamento são definitivamente ignoradas.
• As encomendas à espera de pagamento são adiadas para a execução seguinte.

Seguimento de conversão

Na validação de cada encomenda, o módulo regista as linhas de amostra: cliente, e-mail, produto de origem, idioma e loja.

Quando esse mesmo cliente faz uma encomenda posterior, o módulo marca como convertidas as amostras correspondentes:

• Em modo produto (por defeito): apenas se a encomenda contiver o produto cuja amostra foi recebida.
• Em modo qualquer compra: assim que a encomenda contenha um produto real, qualquer que seja.

A encomenda atual é excluída do cálculo: encomendar uma amostra e o seu produto no mesmo carrinho não conta como conversão.

Painel

O painel apresentado acima da lista de produtos mostra:

• Amostras pedidas: número total de linhas de amostra registadas.
• Conversões: número de amostras seguidas de uma compra, e taxa de conversão associada.
• Volume de negócios das conversões: soma do montante com IVA das encomendas de conversão.
• Lembretes pendentes: número de amostras elegíveis para um lembrete ainda não enviado.

A lista de produtos mostra também, por produto, o número de amostras pedidas e o número de conversões.

E-mails de lembrete

Os modelos encontram-se na pasta mails do módulo, em cinco idiomas: fr, en, es, de, it. Cada idioma dispõe de uma versão HTML e de uma versão de texto do modelo dfsamples_followup.

Variáveis disponíveis: firstname, lastname, product_name, product_link, voucher_block e shop_name. O bloco voucher_block contém o vale de desconto formatado, ou uma cadeia vazia se o vale estiver desativado.

Pode personalizar livremente estes modelos. Conserve as variáveis entre chavetas para que a substituição funcione.

Vales de desconto

Quando a opção está ativada, cada lembrete gera uma regra de carrinho PrestaShop:

• Código no formato SMPL seguido de oito caracteres aleatórios.
• Restrito ao cliente destinatário.
• Utilizável uma única vez.
• Desconto em percentagem, sobre o montante com IVA.
• Duração de validade configurável.

Os vales gerados são visíveis em Promoções > Regras de carrinho.

Desinstalação

Na desinstalação, o módulo elimina as suas duas tabelas, as suas definições e o seu separador de administração. Os produtos amostra gerados são desativados e não eliminados, para que o histórico das suas encomendas passadas se mantenha coerente. Pode eliminá-los manualmente a partir do catálogo se assim o desejar.

Resolução de problemas

O botão não aparece na ficha de produto

Verifique que o produto está inscrito no programa e ativo em Catálogo > Amostras (DF). Se o produto estiver ativo, altere a definição « Posição do botão »: alguns temas não renderizam o hook displayProductActions.

Os lembretes não partem

Verifique que a tarefa cron está agendada e que o URL contém o token correto. Chame o URL manualmente num navegador: o módulo devolve um resumo JSON. Verifique também que a opção de lembrete está ativada e que o prazo configurado já decorreu desde as encomendas de amostra.

O preço da amostra não é o esperado

O preço é introduzido com IVA e convertido em preço sem IVA segundo o IVA do produto de origem. Se o produto de origem não tiver regra de imposto, o preço sem IVA é igual ao preço introduzido.

Um cliente ultrapassa os seus limites

Os limites por cliente só se aplicam a clientes identificados. Ative a definição « Conta de cliente obrigatória » para os tornar efetivos.