DataFirefly Inflation Pricing para WooCommerce

O que o plugin faz

O DataFirefly Inflation Pricing aplica uma percentagem a todo o seu catálogo WooCommerce, ou a parte dele, e depois ajusta cada preço obtido a uma escala de preços psicológicos que você define. Um aumento de 3% num produto de 59 € não dá 60,77 € mas 60,90 €, ou 69 € se preferir inteiros terminados em 9.

O percurso completo faz-se em três tempos: descreve o âmbito e a percentagem, o plugin calcula todos os novos preços e apresenta-os numa tabela, e depois valida. Nada é gravado na base de dados antes dessa validação, e cada preço antigo é conservado para permitir uma anulação.

Instalação

1. Descarregue o arquivo ZIP a partir da sua conta de cliente DataFirefly.
2. Na administração do WordPress, vá a Plugins, depois Adicionar plugin, e clique em Carregar plugin.
3. Selecione o ficheiro ZIP, instale e ative.
4. Aparece um novo menu em WooCommerce, Inflation Pricing.

A ativação cria duas tabelas: wp_df_inflation_campaigns para as campanhas e wp_df_inflation_items para as linhas de preço. O prefixo segue o da sua instalação.

Requisitos: WordPress 5.8 ou superior, WooCommerce 6.0 ou superior, PHP 7.4 ou superior. O plugin declara a compatibilidade com HPOS e com os blocos de carrinho e de encomenda logo na inicialização.

Os três ecrãs

Nova campanha

É o ecrã de trabalho principal. Reúne três cartões: Aumento, Âmbito e Arredondamento. Aí constrói a campanha e depois lança a pré-visualização.

Histórico

A lista de todas as campanhas com o respetivo estado. A partir desta página consulta o detalhe linha a linha de uma campanha, aplica uma campanha que ficou pendente, anula uma campanha aplicada ou elimina uma campanha que deixou de ser útil.

Regras de arredondamento

As definições globais: escalões de arredondamento, sentido, garantia de aumento, base de cálculo com ou sem IVA, tamanho dos lotes e comportamento na desinstalação. Um simulador no fundo da página mostra o resultado em preços de exemplo.

Compreender os escalões de arredondamento

Um escalão define-se por três valores:

• Aplica-se até: o limite superior da faixa de preços em causa. O valor 0 significa sem limite, e designa portanto o escalão que trata todos os preços acima dos outros escalões.
• Passo: o intervalo entre dois preços possíveis.
• Terminação: o desvio aplicado a esse intervalo.

O preço final é sempre o passo multiplicado por um inteiro, mais a terminação. Alguns exemplos:

• Passo 10, terminação 9 dá 9, 19, 29, 59, 89, 569, 899
• Passo 1, terminação 0,90 dá 9,90, 14,90, 60,90, 99,90
• Passo 5, terminação 4 dá 24, 29, 124, 129, 134
• Passo 0,50, terminação 0,40 dá 4,40, 4,90, 9,40, 9,90
• Passo 100, terminação 99 dá 599, 1299, 2499

A terminação tem de ficar abaixo do passo, caso contrário deixa de ter efeito visível. Um passo de 1 com uma terminação de 9 produz simplesmente todos os inteiros.

O escalão é escolhido sobre o preço de origem

Para evitar que um produto situado logo abaixo de um limite passe para uma faixa muito mais grosseira, o escalão escolhido é o do preço atual do produto, e não o do preço calculado. Um artigo de 19,90 € continua portanto a ser tratado pelo escalão dos preços baixos mesmo que o aumento o faça passar acima de 20 €.

O compromisso entre legibilidade e precisão

É o ponto mais importante a compreender antes de lançar uma campanha. Quanto mais grosseira for a escala de arredondamento, mais a variação real se afasta da percentagem pedida.

Tomemos um aumento de 3% num produto de 59 €. O preço bruto calculado é 60,77 €. Consoante a escala escolhida:

• Passo 1, terminação 0,90 dá 60,90 €, ou seja +3,2%
• Passo 5, terminação 4 dá 64 €, ou seja +8,5%
• Passo 10, terminação 9 dá 69 €, ou seja +16,9%

Nenhum plugin consegue contornar esta aritmética: se exigir preços inteiros terminados em 9, o intervalo mínimo entre dois preços é de 10 €, o que representa 17% a 59 €. O plugin não esconde este facto, torna-o visível antes da gravação graças ao simulador, à coluna Variação da pré-visualização e ao limite por campanha.

As predefinições

Cinco predefinições preenchem a tabela de escalões num clique a partir do separador Regras de arredondamento.

• Equilibrado: a definição por omissão. Até 10 €, passo 0,50 e terminação 0,40; até 100 €, passo 1 e terminação 0,90; até 300 €, passo 5 e terminação 4; acima, passo 10 e terminação 9. A variação real fica entre 2 e 5% para uma instrução de 3%.
• Inteiros terminados em 9: até 100 € e acima, passo 10 e terminação 9. Obtém exatamente 59, 89, 569, 899. Os desvios nos preços baixos são grandes.
• Inteiros terminados em 4 ou 9: passo 5 e terminação 4 abaixo de 100 €, passo 10 e terminação 9 acima. Um compromisso corrente no retalho.
• Decimais terminados em ,90: passo 1 e terminação 0,90 abaixo de 100 €, passo 10 e terminação 9,90 acima.
• Sem arredondamento psicológico: passo 0,01 e terminação 0. A percentagem é aplicada ao cêntimo.

As predefinições são apenas um ponto de partida. Pode acrescentar, retirar ou alterar escalões livremente e depois guardar.

Sentido do arredondamento e garantia de aumento

Sentido

• Preço psicológico mais próximo: o comportamento recomendado. O preço calculado passa para o valor mais próximo do seu escalão, acima ou abaixo.
• Sempre para cima: o preço sobe sistematicamente para o patamar superior. As margens ficam protegidas, mas os aumentos reais ultrapassam muitas vezes a instrução.
• Sempre para baixo: o preço desce para o patamar inferior. A reservar para as descidas de preço.

Garantia de aumento

Com o sentido ao mais próximo, uma percentagem pequena pode ser totalmente absorvida pelo arredondamento. Um aumento de 3% sobre 59 € dá 60,77 €, e o preço mais próximo numa escala de 10 continua a ser 59 €: o preço não se mexe.

A opção Nunca deixar o arredondamento anular o aumento corrige este caso empurrando para o patamar seguinte enquanto o resultado ficar inferior ou igual ao preço de partida. Só atua nas percentagens positivas. Numa descida de preço, desative-a.

Arredondamento sobre o preço com IVA ou sobre o preço guardado

O WooCommerce guarda os preços sem impostos ou com impostos incluídos consoante a definição Introduzir os preços com o imposto. Se a sua loja guarda preços sem IVA e apresenta preços com IVA, arredondar o valor guardado não produz nada de legível do lado do cliente: 49,17 € sem IVA apresentado com 20% de IVA dá 59,00 € com IVA, mas 49,00 € sem IVA dá 58,80 € com IVA.

A definição Arredondar sobre propõe dois comportamentos:

• O preço visto pelo cliente, com IVA: o plugin converte o preço guardado para preço com IVA através da classe de imposto do produto, aplica o arredondamento sobre esse valor e reconverte para preço sem IVA com quatro decimais antes de gravar. É a definição por omissão.
• O preço guardado: o arredondamento aplica-se diretamente ao valor registado na base de dados, sem conversão.

Se a sua loja já guarda preços com IVA, ou se o imposto estiver desativado, as duas definições produzem o mesmo resultado. Os produtos marcados como não tributáveis não sofrem qualquer conversão.

Construir uma campanha

Cartão Aumento

• Nome da campanha: facultativo; é gerado um nome com data e hora se o deixar vazio.
• Percentagem: positiva para um aumento, negativa para uma descida. Aceita duas decimais.
• Preço promocional: ver a secção dedicada mais abaixo.
• Ignorar um produto se a variação real ultrapassar X%: a salvaguarda principal. Com uma instrução de 3% e um limite de 6%, qualquer produto cujo arredondamento produzisse um aumento superior a 6% é afastado da campanha, com o motivo indicado na pré-visualização. Deixe o campo vazio para desativar este controlo.

Cartão Âmbito

• Categorias a incluir: deixe vazio para tratar todo o catálogo. As subcategorias das categorias escolhidas são incluídas automaticamente.
• Categorias a excluir: prioritário sobre a inclusão, subcategorias incluídas.
• Etiquetas: restringe aos produtos com uma das etiquetas assinaladas.
• Tipos de produtos: simples, variável, externo, agrupado. Assinalar variável trata as variações, e não o produto principal, que não tem preço próprio.
• Estado dos produtos: publicado, rascunho, privado, pendente. Nas variações, é avaliado o estado do produto principal.
• Preço base entre: dois limites facultativos avaliados sobre o preço base registado.
• Ignorar os produtos atualmente em promoção: afasta os produtos com um preço promocional definido.
• Excluir estes ID ou SKU e Limitar a estes ID ou SKU: listas livres separadas por vírgulas, espaços ou mudanças de linha. Os SKU são resolvidos em identificadores no momento da seleção. Num produto variável, indicar o ID do produto principal cobre todas as suas variações.

Cartão Arredondamento

Por predefinição, a campanha usa as regras globais, recordadas no topo do cartão. Assinale Substituir as regras globais nesta campanha para ajustar o sentido, a garantia de aumento e a base de cálculo apenas nesta campanha. Os próprios escalões continuam a ser os das definições globais.

A caixa Numa anulação, ignorar os produtos alterados depois da aplicação determina o comportamento do rollback. Deixe-a assinalada na grande maioria dos casos.

Os preços promocionais

São propostos quatro modos. Só se aplicam aos produtos que tenham mesmo um preço promocional definido.

• Recalcular mantendo a mesma taxa de desconto: o modo por omissão. Um produto de 100 € apresentado a 80 € mantém o desconto de 20% depois do aumento. O novo preço promocional também passa pelo arredondamento.
• Aplicar a mesma percentagem: o preço promocional sofre exatamente o mesmo tratamento que o preço base.
• Não tocar: o preço promocional fica estritamente inalterado. O desconto apresentado aumenta portanto mecanicamente.
• Eliminar o preço promocional: a promoção é retirada, bem como as datas de início e de fim.

Em todos os casos, se o novo preço promocional atingisse ou ultrapassasse o novo preço base, é eliminado automaticamente para evitar uma incoerência na loja.

Pré-visualização e aplicação

O botão Pré-visualizar os novos preços desencadeia três operações sucessivas, com uma barra de progresso:

1. Seleção dos produtos que correspondem ao âmbito e registo da fila de espera.
2. Cálculo do novo preço de cada linha, por lotes.
3. Apresentação da tabela e das estatísticas.

A tabela mostra, para cada linha, o produto com uma ligação para a sua ficha, o SKU, o preço atual, o novo preço, a variação real em percentagem, o preço promocional antes e depois, e o estado. As linhas afastadas têm o estado skipped e um motivo: produto gratuito, sem preço base, preço já no valor alvo, ou variação superior ao limite permitido.

O botão Carregar mais 50 linhas pagina a tabela. Descarregar o CSV exporta a totalidade da campanha, incluindo as linhas afastadas, o que permite uma releitura offline ou uma validação por terceiros.

Enquanto não clicar em Aplicar ao catálogo, nenhum preço é alterado. A campanha fica consultável no histórico com o estado Pronta a aplicar, e pode ser aplicada mais tarde.

A aplicação é feita por lotes através da API de produto do WooCommerce, o que garante a atualização do preço apresentado, da tabela de pesquisa interna e das caches. Após cada lote, os produtos variáveis em causa são ressincronizados para que os preços mínimo e máximo apresentados na loja se mantenham corretos.

Anular uma campanha

No ecrã Histórico, uma campanha no estado Aplicada propõe um botão Anular. O restauro é feito por lotes e repõe em cada produto o preço base e o preço promocional de origem.

Se a opção de segurança estava ativa na criação da campanha, cada produto é verificado antes do restauro: se o preço atual já não corresponder ao preço aplicado pela campanha, a linha é deixada de lado com uma mensagem explícita. Isso evita sobrepor uma alteração manual feita entretanto.

Eliminar uma campanha apaga também os seus dados de restauro. Uma campanha aplicada e depois eliminada já não pode ser anulada.

Comandos WP-CLI

Quatro comandos cobrem o mesmo percurso sem passar pelo navegador, o que convém a catálogos muito grandes e a scripts de implantação.

wp df-inflation preview --percent=3 --categories=15,22
wp df-inflation apply --campaign=12 --yes
wp df-inflation apply --percent=4.5 --types=simple,variable --sale=ratio --yes
wp df-inflation revert --campaign=12 --yes
wp df-inflation campaigns

Opções disponíveis: --percent, --name, --categories, --types, --sale (keep, percent, ratio ou remove), --campaign e --yes. O comando preview constrói a campanha e mostra as estatísticas sem gravar nada, e devolve o identificador a reutilizar com apply.

Definições globais

• Escalões de preço: a tabela descrita acima, com os botões de adição e de remoção e as predefinições.
• Sentido e Garantia de aumento: valores por omissão propostos em cada nova campanha.
• Arredondar sobre: base de cálculo com IVA ou preço guardado.
• Tamanho dos lotes: número de produtos tratados por pedido, de 1 a 200. O valor por omissão de 25 convém à maioria dos alojamentos. Desça para 10 em caso de tempo de execução excedido, suba para 50 ou 100 num servidor dedicado.
• Desinstalação: se a caixa estiver assinalada, a remoção da extensão apaga as duas tabelas e as opções. Desassinalada, os dados de campanha sobrevivem a uma reinstalação.

Personalização para programadores

Dois filtros permitem intervir no comportamento do motor.

// Ajustar um preço arredondado.
add_filter( 'df_inflation_rounded_price', function ( $result, $raw_price, $tier ) {
    return $result;
}, 10, 3 );

// Alterar a lista de produtos selecionados por uma campanha.
add_filter( 'df_inflation_scope_rows', function ( $rows, $filters ) {
    return $rows;
}, 10, 2 );

Todas as ações de administração exigem a permissão manage_woocommerce. Os pedidos AJAX estão protegidos por um nonce e verificam essa permissão no servidor.

Resolução de problemas

Nenhum produto corresponde ao âmbito

Verifique que os tipos de produtos assinalados correspondem mesmo ao seu catálogo e que os produtos visados têm um preço base definido. Um produto variável em que só as variações têm preço exige assinalar o tipo variável, e não o tipo simples.

A barra de progresso bloqueia

Reduza o tamanho dos lotes nas definições e volte a lançar. Um lote de 10 produtos chega nos alojamentos mais limitados. A consola do navegador mostra o detalhe do pedido que falhou.

Os novos preços não aparecem na loja

Limpe a cache da sua extensão de cache e a cache do servidor. O plugin limpa os transientes do WooCommerce dos produtos alterados, mas não controla uma cache de página de terceiros.

Os preços dos produtos variáveis estão incoerentes

Os preços mínimo e máximo apresentados na ficha do produto principal vêm de uma sincronização do WooCommerce. O plugin aciona-a após cada lote. Se persistir um desvio, a ferramenta WooCommerce, Estado, Ferramentas, Limpar os transientes dos produtos força um recálculo completo.

Uma variação real muito superior à instrução

É o comportamento esperado numa escala grosseira. Preencha o campo de limite por campanha para afastar esses produtos, ou acrescente um escalão mais fino na faixa de preços em causa.

Desinstalação

Desativar a extensão não elimina nada: as campanhas e os dados de restauro ficam na base de dados. A remoção completa a partir da lista de plugins só desencadeia a limpeza se a opção correspondente tiver sido assinalada nas definições antes da remoção.