PS PrestaShop Iniciante

DataFirefly Specific Price Cleaner: limpar preços específicos expirados, duplicados e órfãos

Instalação, painel, assistente em 6 passos, categorias e proteções, histórico e restauro, agendamento, definições e resolução de problemas.

Atualizado Versão do módulo 2.0.0

Instalação

Instale o módulo em Módulos > Gestor de módulos > Enviar um módulo, enviando o ficheiro ZIP. Na instalação, o módulo cria as suas tabelas e acrescenta o separador Catálogo > Limpeza de preços específicos. A instalação não altera nenhum preço.

Para atualizar a partir da 1.0.x, basta enviar o novo ZIP. O histórico e as cópias da 1.0.x são mantidos, assim como as definições da tarefa cron (ativação, modo, frequência). Abra o separador Agendamento após a atualização para verificar se lhe convêm.

O painel

A página Saúde analisa a tabela de preços específicos, em todo o catálogo ou num âmbito escolhido (loja, categoria, ID de produto). Mostra:

  • o número de preços específicos, incluindo os ativos neste momento;
  • o número de linhas que se podem limpar sem risco com a limpeza por defeito (expirados, duplicados, órfãos);
  • o que nunca é apagado por defeito: preços ligados a um carrinho ativo, regras de preços do catálogo, preços futuros, preços sem data de fim, preços usados por outro módulo;
  • o detalhe por categoria de problema, com as linhas elimináveis e protegidas de cada uma;
  • os conflitos de prioridade e as regras de catálogo expiradas, para rever à mão;
  • o tamanho atual da tabela, medido pela base de dados.
Painel de saúde dos preços específicos: linhas a limpar, categorias de problemas e proteções

O painel indica quantas linhas a menos a tabela terá após a limpeza. O efeito na velocidade das páginas depende da sua loja: o módulo não o mede.

O assistente de limpeza em 6 passos

Clique em Iniciar o assistente de limpeza. Os passos são: Escolher, Simular, Verificar, Guardar, Limpar, Relatório. Nada é apagado antes do passo Limpar.

1. Escolher

Assinale as categorias a limpar. Cada contador indica as linhas que seriam apagadas com as proteções ativas. Defina o prazo dos preços expirados (por exemplo, expirados há pelo menos 7 dias) e o dos carrinhos terminados. As proteções ficam assinaladas por defeito; desmarque uma só se souber exatamente porque uma linha deve sair. Os filtros avançados limitam a limpeza a uma loja, uma categoria, ID de produto, um cliente, um grupo, um país, uma moeda, um tipo de valor ou uma data de expiração.

Assistente de limpeza, etapa 1: escolher as categorias, proteções e filtros avançados

2. Simular

Executar a simulação calcula o plano sem apagar nada: linhas previstas e protegidas por categoria. O plano fica congelado: só essas linhas poderão ser apagadas. Uma linha que corresponde a várias categorias é planeada uma só vez, na primeira. Pode exportar o plano em CSV.

Resultado da simulação: linhas previstas e protegidas por categoria, nada eliminado

3. Verificar

A lista das linhas previstas mostra, para cada uma, o produto, o alvo, o valor, o período e os sinais úteis. Desmarque uma linha para a manter: uma linha excluída nunca é apagada.

Verificação linha a linha do plano fixado, cada linha pode ser excluída

4. Guardar

Criar a cópia copia cada linha prevista, coluna a coluna, para o histórico do módulo. Pode descarregar esta cópia em CSV antes de continuar. Se a cópia estiver desativada nas definições, o módulo indica-o claramente: a eliminação será definitiva.

Cópia de segurança completa das linhas previstas antes de eliminar, descarregável em CSV

5. Limpar

Assinale Verifiquei a simulação e quero eliminar estas N linhas. e clique em Eliminar N linhas. Sem cópia, também é preciso escrever o número de linhas. A eliminação avança por lotes, cada um na sua própria transação, e cada linha é verificada de novo mesmo antes de ser apagada: uma linha ligada entretanto a um carrinho, regenerada por uma regra ou usada por um módulo é ignorada. Pode pausar e retomar.

Confirmação explícita antes da limpeza em lotes transacionais com retoma

6. Relatório

O relatório dá, por categoria, as linhas previstas, apagadas, ignoradas, excluídas e protegidas, e a duração. Mostra também o que foi feito após a limpeza: caches de preços do PrestaShop limpas e índice de preços da pesquisa facetada atualizado para os produtos afetados. A partir do relatório pode restaurar, descarregar a cópia ou o relatório detalhado em CSV, ou enviar-se o relatório por e-mail.

Relatório de limpeza por categoria, caches de preços esvaziadas e restauro em 1 clique

Se o separador for fechado ou o servidor parar durante a limpeza, nada fica a meio. O painel mostra a limpeza inacabada com Abrir e retomar, ou pode abandonar o resto.

Categorias de limpeza

  • Preços expirados: a data de fim já passou, estes preços já não se aplicam a ninguém.
  • Duplicados exatos: mesmo produto, alvo, datas, quantidade e valor que uma linha mais antiga; fica a mais antiga. O índice único do PrestaShop normalmente impede-os: a verificação continua útil para dados importados.
  • Órfãos: produto eliminado (ou ausente da loja do preço), combinação, cliente, grupo, país, moeda, loja ou grupo de lojas eliminado.
  • Preços sem efeito: «manter o preço base» sem desconto. Os que podem anular outro desconto estão protegidos.
  • Preços de carrinhos terminados: preços criados para um carrinho (orçamento, negociação, oferta…) encomendado ou sem alterações desde o prazo escolhido, ou eliminado.
  • Prioridades de produtos eliminados e prioridades idênticas à global.
  • Seleção manual: linhas escolhidas na lista de preços.

Proteções

  • Gerado por uma regra de preços do catálogo: o PrestaShop regenera-o a partir da regra. Sempre protegido: altere ou elimine a regra.
  • Ligado a um carrinho: criado para o carrinho de um cliente por um módulo de orçamentos, B2B, configurador ou oferta. Só a categoria Carrinhos terminados o pode remover.
  • Começa no futuro: promoções agendadas.
  • Sem data de fim (ilimitado): mantidos por defeito, mesmo que pareçam inúteis.
  • Usado por outro módulo: um módulo ainda o referencia nas suas próprias tabelas. O painel lista os módulos detetados.
  • Pode anular outro desconto: um preço sem efeito pode prevalecer sobre um desconto de grupo ou global e anulá-lo para o seu alvo.

A lista de preços

O separador Preços específicos mostra todos os preços específicos com os mesmos filtros do assistente, e sinais para os preços ligados a um carrinho, gerados por uma regra ou usados por um módulo de terceiros. Assinale linhas para lançar uma simulação só sobre essa seleção.

Lista de preços específicos com filtros avançados e sinais de carrinho, regra e módulo

Histórico e restauro

O separador Histórico e restauro lista cada limpeza e cada simulação agendada, com o autor, o relatório e a cópia. As limpezas são conservadas com a sua cópia durante o prazo escolhido nas definições (90 dias por defeito) e depois purgadas automaticamente.

Histórico das limpezas e simulações agendadas, com cópias e restauro

Restaurar repõe as linhas com o seu ID original e depois compara cada uma com a cópia. O relatório mostra então o número de linhas restauradas e a data.

Restauro em 1 clique: confirmação antes de repor as linhas com o seu ID original
Restauro concluído: linhas repostas com o seu ID e verificadas idênticas à cópia

Agendamento

O separador Agendamento configura uma limpeza automática chamada pela tarefa cron do seu alojamento. As proteções do assistente estão sempre ativas.

  • Modo: Apenas simulação (relatório, nada é apagado), recomendado para começar, ou Limpeza com cópia automática.
  • Frequência: a cada hora, dia, semana ou mês. As chamadas feitas antes da próxima data prevista são ignoradas.
  • Categorias, prazo dos preços expirados e dos carrinhos terminados, limitação aos preços reservados a um cliente ou a uma loja.
  • No máximo N linhas por execução: o resto é tratado na execução seguinte.
  • Relatório por e-mail após cada execução, para o endereço escolhido ou o da loja.

Copie o URL do cron apresentado e chame-o a partir do seu alojamento, por exemplo a cada hora: o módulo aplica a frequência escolhida. Acrescente &dry=1 para forçar uma simulação. Mantenha este URL privado: o token protege-o e pode gerar um novo. Uma chamada com um token errado recebe um erro 403; se já houver uma execução em curso, a chamada recebe um erro 423.

Agendamento: simulação ou limpeza por cron, frequência, categorias e relatório por e-mail
Relatório de limpeza recebido por e-mail, detalhado por categoria

Definições

  • Cópia de segurança antes de cada eliminação: fortemente recomendada, permite o restauro num clique.
  • Conservação das cópias em dias (0 = para sempre).
  • Perfis autorizados a limpar e restaurar, além da permissão «Eliminar» do separador.
  • Manter o histórico e as cópias ao desinstalar.
  • Eliminar através dos objetos do PrestaShop: sim por defeito, para que os hooks de eliminação sejam executados (ERP, feeds e módulos de sincronização ficam informados). Não: SQL direto, mais rápido em volumes muito grandes.
  • Linhas por lote (500 por defeito): cada lote é uma transação. Reduza o valor se o servidor cortar os pedidos longos.
  • Atualizar o índice de preços da pesquisa facetada para os produtos afetados (até 300).
  • Purgar agora o histórico antigo: remove as limpezas mais antigas do que o prazo de conservação e as simulações nunca executadas.
Definições: cópia de segurança, conservação, perfis autorizados e processamento em lotes

Blocos na ficha de produto e de cliente

Na ficha de produto, o bloco Saúde dos preços específicos indica o número de preços do produto, os que se podem limpar e o estado de cada um (ativo, expirado, futuro, carrinho, regra, módulo). O botão Simular uma limpeza deste produto abre o assistente já filtrado.

Bloco da ficha de produto: saúde dos preços específicos do produto e simulação direta

Na ficha de cliente, o bloco lista os preços reservados ao cliente e os carrinhos ligados, com uma limpeza dirigida a esse cliente.

Bloco da ficha de cliente: preços reservados, carrinhos ligados e limpeza direcionada

Permissões dos funcionários

Consultar o módulo exige a permissão «Ver» do separador. Limpar e restaurar exigem a permissão «Eliminar» do separador em Parâmetros avançados > Equipa > Permissões, e que o perfil esteja assinalado nas definições do módulo. O perfil SuperAdmin está sempre autorizado. Um perfil sem estes direitos vê as páginas só em leitura.

Para programadores de módulos

Mesmo antes de apagar um lote, o módulo executa o hook actionDfSpecificPriceCleanerBeforeDelete com o ID da limpeza e a lista dos ID de preços. Um módulo pode acrescentar ao array veto os ID dos preços que quer manter: essas linhas são ignoradas e ficam no lugar.

Resolução de problemas

Algumas linhas são «ignoradas» durante a limpeza

Mudaram desde a simulação: ligadas a um carrinho, regeneradas por uma regra ou usadas por um módulo. É intencional. Lance uma nova simulação para as rever.

A simulação não prevê nenhuma linha

Todas as linhas correspondentes estão protegidas, ou nenhuma corresponde aos filtros. O contador «protegidas» de cada categoria indica o que é mantido e porquê.

A limpeza para num grande volume

Reduza Linhas por lote nas definições e retome a limpeza a partir do painel. Os lotes já tratados não são refeitos.

O URL do cron responde 403, 423 ou SKIPPED

403: token errado, copie de novo o URL a partir do separador Agendamento. 423: ainda há uma execução em curso. SKIPPED: agendamento desativado, data prevista ainda não atingida ou nenhuma categoria assinalada.

O relatório recomenda reconstruir o índice

Acima de 300 produtos afetados, o módulo não atualiza sozinho o índice de preços da pesquisa facetada. Reconstrua o índice a partir da configuração do módulo de pesquisa facetada.

Limitações

  • Os conflitos de prioridade e as regras de catálogo expiradas são assinalados, nunca apagados automaticamente.
  • O relatório por e-mail é enviado no idioma do funcionário (botão do relatório) ou no idioma por defeito da loja (cron).
  • Sem cópia de segurança, uma eliminação não pode ser anulada.

Compatibilidade

  • PrestaShop 1.7.8 a 9.x com o mesmo ZIP. Testado em 1.7.8.11, 8.2.1 e 9.1.5, com PHP 7.4, 8.1 e 8.5.
  • Multiloja: a análise e a limpeza podem limitar-se a uma loja.
  • Arquitetura ModuleAdminController, sem dependência Composer.
  • Interface traduzida em francês, inglês, espanhol, alemão, italiano, neerlandês, polaco e português.
Esta página foi útil?

Ainda com dúvidas? Contacte o suporte