Pular para o conteúdo principal

Pet Nutrition Pro

Menu
Ativar Diet Engine

Pet Nutrition Pro · Guia operacional

Guia rápida

Da instalação ao primeiro teste completo. Siga as seções na ordem indicada para configurar o Pet Nutrition Pro, preparar o catálogo WooCommerce e verificar o resultado antes da publicação.

Baixar o plugin Consultar o guia completo

Configure o Pet Nutrition Pro passo a passo

Esta página reúne as operações essenciais. Para explicações, exemplos, capturas de tela e procedimentos completos de verificação, cada seção contém uma referência ao capítulo correspondente do manual.

01

Preparação

Instale e ative o Boma Pet Nutrition Pro

O Boma Pet Nutrition Pro requer que o WooCommerce esteja instalado e ativo. Verifique primeiro esse pré-requisito, depois instale o plugin e configure de forma consciente o acesso ao serviço remoto.

  1. Verifique se o WooCommerce está instalado e ativo. Se não estiver presente, instale-o e ative-o antes de prosseguir com o Boma Pet Nutrition Pro.
  2. Abra Plugins → Adicionar plugin → Enviar plugin.
  3. Selecione o arquivo ZIP do Boma Pet Nutrition Pro, instale-o e ative-o.
  4. Após a ativação, abra Pet Nutrition Pro → Primeiros passos.
  5. Leia as informações relacionadas ao serviço remoto e à privacidade.
  6. Quando quiser utilizar o serviço de cálculo, habilite nas configurações a caixa Autorização do serviço remoto.
  7. Verifique separadamente o status do eventual Diet Engine.
  8. Se você acabou de ativar o Diet Engine e deseja utilizá-lo imediatamente, pressione Atualizar verificação do serviço para atualizar o status armazenado pelo plugin.
Free e Diet Engine são dois estados diferentes. A autorização do serviço remoto também é necessária para o cálculo Free. O Diet Engine adiciona produtos recomendados, quantidades coordenadas e integração com o carrinho WooCommerce.
Atualizar verificação do serviço não autoriza o serviço remoto. A autorização é gerenciada exclusivamente pela caixa Autorização do serviço remoto. O botão apenas força uma nova verificação do status do serviço.
Saiba mais: Guia completo · Capítulo 17 → ↑ Voltar ao índice
02

Páginas públicas

Configure o formulário e a página de resultados

O Pet Nutrition Pro utiliza duas páginas distintas: uma coleta os dados do pet e outra exibe o resultado. Nas novas instalações, a página Resulting Diet é criada e vinculada automaticamente pelo plugin.

  1. Crie ou localize a página destinada ao questionário.
  2. Insira uma única vez o shortcode [pet_nutrition_form].
  3. Após a ativação do Boma Pet Nutrition Pro, verifique se a página Resulting Diet está presente e publicada.
  4. Nas novas instalações, o plugin cria e vincula automaticamente essa página inserindo o shortcode [bomapnp_resulting_diet].
  5. Nas configurações do Pet Nutrition Pro, verifique se Diet result page aponta para a página Resulting Diet correta.
  6. Se a página estiver ausente, tiver sido excluída ou seu conteúdo tiver sido modificado, restaure-a manualmente inserindo [bomapnp_resulting_diet] e selecione-a novamente como página de resultados.
  7. Publique a página do questionário e verifique todo o fluxo em HTTPS.
A criação manual da página Resulting Diet é um procedimento de recuperação. Em uma nova instalação correta, a página é criada automaticamente pelo plugin.
Não troque nem duplique os shortcodes. A página do questionário utiliza [pet_nutrition_form], enquanto a página de resultados utiliza [bomapnp_resulting_diet].
Saiba mais: Guia completo · Capítulos 17–18 → ↑ Voltar ao índice
03

Catálogo WooCommerce

Prepare os produtos para a dieta

Um produto WooCommerce não entra automaticamente nas recomendações. Ele deve ser habilitado e configurado com os dados exigidos pelo Pet Nutrition Pro.

  1. Abra a página do produto WooCommerce.
  2. Ative Presente na Dieta.
  3. Atribua apenas uma categoria técnica: Seco, Extrusado ou Úmido.
  4. Insira o valor energético correto em kcal por 100 g.
  5. Configure a destinação para cão e/ou gato, porte e fase da vida, quando aplicável.
  6. Preencha exclusões alimentares e sensibilidades somente quando forem respaldadas pelo rótulo, pela ficha técnica ou pelas indicações do fabricante.
  7. Salve o produto e verifique o resultado com um perfil de teste.
Presente na Dieta habilita o produto para avaliação, mas não significa que ele seja compatível com todos os pets.
Saiba mais: Guia completo · Capítulo 10 → ↑ Voltar ao índice
04

Dado energético

Insira corretamente as kcal por 100 g

O mecanismo utiliza sempre um valor normalizado expresso em kcal por 100 gramas, mesmo quando o rótulo apresenta a energia em outro formato.

  1. Se o rótulo apresentar kcal/100 g, insira diretamente o valor.
  2. Se apresentar kcal/kg, divida o valor por 10. Exemplo: 3.650 kcal/kg → 365 kcal/100 g.
  3. Se apresentar as calorias da embalagem inteira, divida pelo peso em gramas e multiplique por 100.
  4. Use a calculadora guiada presente na página do produto quando o formato do rótulo exigir uma conversão.
  5. Antes de salvar, compare sempre o resultado com o rótulo ou com a ficha técnica do fabricante.
As informações energéticas variam entre os diferentes mercados. O Guia completo contém, no Apêndice A, as orientações específicas para as áreas/localizações previstas.
Saiba mais: Guia completo · §10.4 e Apêndice A → ↑ Voltar ao índice
05

Regras de seleção

Configure a compatibilidade

A prioridade comercial é aplicada somente depois da verificação das preferências do usuário e da compatibilidade do produto com o perfil do pet.

  1. Verifique primeiro a espécie e a fase da vida para as quais o produto é declarado adequado.
  2. Para cães, configure corretamente os portes previstos.
  3. Preencha exclusões e intolerâncias com critério conservador.
  4. Selecione as sensibilidades somente quando houver uma base documentável no produto.
  5. Lembre-se de que uma única incompatibilidade relevante pode excluir o produto da proposta.
  6. Verifique o comportamento com pelo menos um perfil que deve incluir o produto e outro que deve excluí-lo.
A ordem correta é: preferências → compatibilidade → ordenação → proposta. Um produto colocado em primeiro lugar não se torna compatível.
Saiba mais: Guia completo · Capítulos 4, 5 e 10 → ↑ Voltar ao índice
06

Estratégia comercial

Ordene os produtos compatíveis

As ordenações estabelecem qual produto compatível será considerado primeiro para cada tipo e para cada grupo de animais.

  1. Abra Pet Nutrition Pro → Ordenação de produtos.
  2. Selecione o tipo: Seco, Extrusado ou Úmido.
  3. Selecione o grupo: cão de porte pequeno, médio ou grande, ou gato.
  4. Aplique os filtros e observe toda a classificação.
  5. Arraste os itens para a sequência desejada.
  6. Salve a nova ordenação.
  7. Gere uma nova dieta para verificar o efeito.
A posição 1 tem a maior prioridade, mas somente entre os produtos compatíveis. Para cães existem classificações distintas por porte; os gatos utilizam sua própria ordenação.
Saiba mais: Guia completo · Capítulo 11 → ↑ Voltar ao índice
07

Amplitude da proposta

Defina o número de alimentos úmidos

Para Seco e Extrusado, normalmente é selecionado apenas um produto. Para Úmido, você pode definir quantos produtos compatíveis o sistema tentará propor.

  1. Abra a página principal das configurações do Pet Nutrition Pro.
  2. Localize o campo Número de Itens Úmidos.
  3. Defina o número desejado.
  4. Salve as alterações.
  5. Gere uma nova dieta que inclua alimentos Úmidos.
  6. Verifique quais produtos são incluídos de acordo com a compatibilidade e a ordenação.
O número configurado é um máximo. Se você solicitar 3 produtos Úmidos, mas apenas 2 forem compatíveis, o sistema proporá os 2 compatíveis: ele não forçará um terceiro produto.
Saiba mais: Guia completo · Capítulo 12 → ↑ Voltar ao índice
08

Lojas e agências

Personalize Aparência e layout

O Pet Nutrition Pro permite personalizar nativamente a exibição da ficha nutricional e dos produtos recomendados sem modificar a lógica do plugin.

  1. Abra Pet Nutrition Pro → Aparência e layout.
  2. Configure largura, tipografia, cores, fundos, bordas e arredondamentos da ficha.
  3. Escolha grade ou lista para os produtos recomendados.
  4. Defina as colunas para desktop, tablet e smartphone.
  5. Configure imagens, preço, descrição e botão de acordo com o projeto da loja.
  6. Se você trabalha para uma agência, pode inserir logotipo, texto de identificação e uma classe CSS adicional.
  7. Para o logotipo, use, quando apropriado, Escolher na Biblioteca de mídia.
  8. Salve e sempre verifique um resultado real no desktop, tablet e smartphone.
Primeiro use as opções nativas. Recorra ao CSS personalizado somente para necessidades adicionais e não modifique diretamente os arquivos do plugin.
Aparência e layout diz respeito à exibição na tela. A impressão e o PDF mantêm uma apresentação separada: uma diferença entre a página web e o PDF não indica necessariamente um erro.
Saiba mais: Guia completo · Capítulo 19 → ↑ Voltar ao índice
09

Teste

Verifique com o método TESTE / CONTROLE

Antes da publicação, verifique cada critério modificando apenas uma variável por vez.

  1. Prepare dois produtos: um TESTE e um CONTROLE.
  2. Mantenha todos os dados iguais, exceto o critério que deseja verificar.
  3. Crie um perfil de pet reproduzível.
  4. Gere o resultado e anote o resultado obtido.
  5. Altere apenas uma condição e repita o mesmo perfil.
  6. Para as ordenações, use pelo menos dois produtos que sejam compatíveis e verifique qual deles é selecionado.
  7. Verifique também o número de produtos Úmidos, impressão/PDF e adição ao carrinho.
  8. Repita o fluxo como usuário não autenticado.
Após o teste, exclua ou desative os produtos técnicos que não se destinam ao público, restaure as ordenações comerciais e gere uma última dieta real para confirmação.
Saiba mais: Guia completo · Capítulo 15 → ↑ Voltar ao índice
10

Antes de publicar

Faça a verificação final e publique

Antes de disponibilizar o serviço aos clientes, verifique o funcionamento, a segurança e as informações públicas.

  1. Verifique se o site público utiliza HTTPS.
  2. Verifique se a caixa Autorização do serviço remoto foi habilitada conscientemente caso o site deva utilizar o serviço de cálculo.
  3. Atualize a Política de Privacidade de forma coerente com o uso real do Pet Nutrition Pro e do serviço remoto.
  4. Verifique se o formulário e o resultado funcionam sem que o usuário esteja autenticado no WordPress.
  5. Verifique todo o fluxo: formulário → resultado → produtos → carrinho.
  6. Verifique desktop, tablet e smartphone.
  7. Verifique a impressão e o salvamento em PDF.
  8. Certifique-se de que nenhuma chave, token ou informação técnica confidencial esteja visível publicamente.
O WordPress também registra um texto sugerido pelo Pet Nutrition Pro para a Política de Privacidade. Trata-se de uma base técnica a ser adaptada ao site, e não de um modelo jurídico universal.
Saiba mais: Guia completo · §§17.8, 21.7 e 21.8 → ↑ Voltar ao índice
11

Diagnóstico

Se algo não funcionar

Proceda por eliminação e modifique apenas uma variável por vez. Evite alterar simultaneamente página, CSS, cache e configuração do serviço.

  1. Verifique se os shortcodes estão presentes nas páginas corretas: [pet_nutrition_form] e [bomapnp_resulting_diet].
  2. Verifique se a página Resulting Diet está publicada, contém [bomapnp_resulting_diet] e está selecionada como página de resultados.
  3. Repita o teste em uma janela anônima com um navegador atualizado.
  4. Verifique separadamente a caixa Autorização do serviço remoto e o status do Diet Engine.
  5. Se você acabou de ativar o Diet Engine ou deseja forçar uma nova verificação do status remoto, use Atualizar verificação do serviço.
  6. Limpe separadamente o cache do WordPress, do navegador, do servidor e de uma eventual CDN.
  7. Se necessário, desative temporariamente a minificação, defer ou otimizações de JavaScript.
  8. Em staging, teste com um tema padrão e apenas os plugins indispensáveis.
Autorização do serviço remoto, Atualizar verificação do serviço e limpeza do cache são três operações diferentes. A caixa autoriza ou revoga a autorização para o uso do serviço remoto. Atualizar verificação do serviço força, por sua vez, uma nova verificação do status armazenado pelo plugin. Nenhuma das duas operações limpa o cache do WordPress, do navegador, do servidor ou da CDN.
Se solicitar suporte, forneça versões, etapas para reproduzir o problema, capturas de tela e eventuais erros relevantes. Não envie senhas, chaves de API, tokens, cookies ou backups completos.
Saiba mais: Guia completo · Capítulos 20 e 22 → ↑ Voltar ao índice