Pet Nutrition Pro · Guia operacional
Guia rápida
Da instalação ao primeiro teste completo. Siga as secções pela ordem indicada para configurar o Pet Nutrition Pro, preparar o catálogo WooCommerce e verificar o resultado antes da publicação.
Configure o Pet Nutrition Pro passo a passo
Esta página reúne as operações essenciais. Para explicações, exemplos, capturas de ecrã e procedimentos completos de verificação, encontrará em cada secção a referência ao respetivo capítulo 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 este pré-requisito, depois instale o plugin e configure conscientemente o acesso ao serviço remoto.
- 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.
- Abra Plugins → Adicionar plugin → Carregar plugin.
- Selecione o ficheiro ZIP do Boma Pet Nutrition Pro, instale-o e ative-o.
- Após a ativação, abra Pet Nutrition Pro → Primeiros passos.
- Leia as informações relativas ao serviço remoto e à privacidade.
- Quando pretender utilizar o serviço de cálculo, ative nas definições a caixa Autorização do serviço remoto.
- Verifique separadamente o estado do eventual Diet Engine.
- Se acabou de ativar o Diet Engine e pretende utilizá-lo imediatamente, prima Atualizar verificação do serviço para atualizar o estado 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 acrescenta 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 é gerida exclusivamente através da caixa
Autorização do serviço remoto.
O botão apenas força uma nova verificação do estado do serviço.
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 recolhe os dados do animal e outra apresenta o resultado. Nas novas instalações, a página Resulting Diet é criada e associada automaticamente pelo plugin.
- Crie ou identifique a página destinada ao questionário.
-
Insira uma única vez o shortcode
[pet_nutrition_form]. - Após a ativação do Boma Pet Nutrition Pro, verifique se a página Resulting Diet está presente e publicada.
-
Nas novas instalações, o plugin cria e associa
automaticamente esta página, inserindo o shortcode
[bomapnp_resulting_diet]. - Nas definições do Pet Nutrition Pro, verifique se Diet result page aponta para a página Resulting Diet correta.
-
Se a página não existir, tiver sido eliminada ou o seu conteúdo
tiver sido alterado, restaure-a manualmente inserindo
[bomapnp_resulting_diet]e selecione-a novamente como página de resultados. - 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.
Numa 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].03
Catálogo WooCommerce
Prepare os produtos para a dieta
Um produto WooCommerce não entra automaticamente nas recomendações. Tem de ser ativado e configurado com os dados exigidos pelo Pet Nutrition Pro.
- Abra a ficha do produto WooCommerce.
- Ative Presente na Dieta.
- Atribua apenas uma categoria técnica: Seco, Expandido ou Húmido.
- Introduza o valor energético correto em kcal por 100 g.
- Configure a destinação para cão e/ou gato, porte e fase de vida, quando aplicáveis.
- Preencha as exclusões alimentares e sensibilidades apenas quando forem suportadas pelo rótulo, pela ficha técnica ou pelas indicações do fabricante.
- Guarde o produto e verifique o resultado com um perfil de teste.
Presente na Dieta permite que o produto seja
avaliado, mas não significa que esse produto seja
compatível com todos os animais.
04
Dados energéticos
Introduza corretamente as kcal por 100 g
O motor utiliza sempre um valor normalizado expresso em kcal por 100 gramas, mesmo quando o rótulo apresenta a energia num formato diferente.
- Se o rótulo indicar kcal/100 g, introduza diretamente o valor.
- Se indicar kcal/kg, divida o valor por 10. Exemplo: 3.650 kcal/kg → 365 kcal/100 g.
- Se indicar as calorias da embalagem inteira, divida pelo peso em gramas e multiplique por 100.
- Utilize a calculadora guiada presente na ficha do produto quando o formato do rótulo exigir uma conversão.
- Antes de guardar, compare sempre o resultado com o rótulo ou com a ficha técnica do fabricante.
As indicações energéticas variam entre os diferentes mercados.
O Guia completo contém, no Apêndice A, o guia de referência
dedicado às áreas/localizações previstas.
05
Regras de seleção
Configure a compatibilidade
A prioridade comercial é aplicada apenas após a verificação das preferências do utilizador e da compatibilidade do produto com o perfil do animal.
- Verifique primeiro a espécie e a fase de vida para as quais o produto é declarado adequado.
- Para o cão, configure corretamente os portes previstos.
- Preencha as exclusões e intolerâncias segundo um critério conservador.
- Selecione as sensibilidades apenas quando existir uma base documentável no produto.
- Lembre-se de que uma única incompatibilidade relevante pode excluir o produto da proposta.
- Verifique o comportamento com pelo menos um perfil que deva incluir o produto e outro que deva excluí-lo.
A ordem correta é:
preferências → compatibilidade → ordenação → proposta.
Um produto colocado em primeiro lugar não se torna compatível.
06
Estratégia comercial
Ordene os produtos compatíveis
As ordenações estabelecem qual produto compatível é considerado primeiro para cada tipo de alimento e para cada grupo de animais.
- Abra Pet Nutrition Pro → Ordenação dos produtos.
- Selecione o tipo: Seco, Expandido ou Húmido.
- Selecione o grupo: cão pequeno, médio, grande ou gato.
- Aplique os filtros e observe toda a classificação.
- Arraste os artigos para a sequência pretendida.
- Guarde a nova ordenação.
- Gere uma nova dieta para verificar o efeito.
A posição 1 tem a prioridade mais elevada,
mas apenas entre os produtos compatíveis.
Para o cão existem classificações distintas por porte;
o gato utiliza a sua própria ordenação.
07
Amplitude da proposta
Defina o número de alimentos húmidos
Para Seco e Expandido é normalmente selecionado apenas um produto. Para Húmido, pode definir quantos produtos compatíveis o sistema deve tentar propor.
- Abra a página principal das definições do Pet Nutrition Pro.
- Localize o campo Número de Artigos Húmidos.
- Defina o número pretendido.
- Guarde as alterações.
- Gere uma nova dieta que inclua Húmido.
- Verifique quais os produtos incluídos de acordo com a compatibilidade e a ordenação.
O número configurado é um máximo.
Se solicitar 3 alimentos húmidos mas apenas 2 forem compatíveis,
o sistema propõe os 2 compatíveis:
não força a inclusão de um terceiro produto.
08
Lojas e agências
Personalize o Aspeto e layout
O Pet Nutrition Pro permite personalizar nativamente a apresentação da ficha nutricional e dos produtos recomendados sem modificar a lógica do plugin.
- Abra Pet Nutrition Pro → Aspeto e layout.
- Configure a largura, tipografia, cores, fundos, contornos e arredondamentos da ficha.
- Escolha grelha ou lista para os produtos recomendados.
- Defina as colunas para computador, tablet e smartphone.
- Configure imagens, preço, descrição e botão de acordo com o projeto da loja.
- Se trabalha para uma agência, pode inserir logótipo, texto identificativo e uma classe CSS adicional.
- Para o logótipo utilize, quando adequado, Escolher da Biblioteca multimédia.
- Guarde e verifique sempre um resultado real em computador, tablet e smartphone.
Utilize primeiro as opções nativas.
Recorra a CSS personalizado apenas para necessidades adicionais
e não modifique diretamente os ficheiros do plugin.
Aspeto e layout refere-se à apresentação no ecrã.
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.
09
Teste
Verifique com o método TESTE / CONTROLO
Antes da publicação, verifique cada critério alterando apenas uma variável de cada vez.
- Prepare dois produtos: um TESTE e um CONTROLO.
- Mantenha todos os dados iguais, exceto o critério que pretende verificar.
- Crie um perfil de animal reproduzível.
- Gere o resultado e registe o resultado obtido.
- Altere apenas uma condição e repita o mesmo perfil.
- Para as ordenações, utilize pelo menos dois produtos compatíveis e verifique qual é selecionado.
- Verifique também o número de alimentos húmidos, impressão/PDF e adição ao carrinho.
- Repita o fluxo como utilizador anónimo.
Após o teste, elimine 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.
10
Antes de publicar
Efetue 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.
- Verifique se o site público utiliza HTTPS.
- Verifique se a caixa Autorização do serviço remoto foi ativada conscientemente caso o site deva utilizar o serviço de cálculo.
- Atualize a Política de Privacidade de forma coerente com a utilização real do Pet Nutrition Pro e do serviço remoto.
- Verifique se o formulário e o resultado funcionam sem autenticação no WordPress.
- Verifique o percurso completo: formulário → resultado → produtos → carrinho.
- Verifique computador, tablet e smartphone.
- Verifique a impressão e a gravação em PDF.
- Certifique-se de que nenhuma chave, token ou informação técnica reservada está publicamente visível.
O WordPress também regista um texto sugerido pelo Pet Nutrition Pro
para a Política de Privacidade. É uma base técnica a adaptar ao site,
não um modelo jurídico universal.
11
Diagnóstico
Se algo não funcionar
Proceda por exclusão e altere apenas uma variável de cada vez. Evite alterar simultaneamente a página, o CSS, a cache e a configuração do serviço.
-
Verifique se os shortcodes estão presentes nas páginas corretas:
[pet_nutrition_form]e[bomapnp_resulting_diet]. -
Verifique se a página
Resulting Diet
está publicada, contém
[bomapnp_resulting_diet]e está selecionada como página de resultados. - Repita o teste numa janela anónima com um navegador atualizado.
- Verifique separadamente a caixa Autorização do serviço remoto e o estado do Diet Engine.
- Se acabou de ativar o Diet Engine ou pretende forçar uma nova verificação do estado remoto, utilize Atualizar verificação do serviço.
- Limpe separadamente a cache do WordPress, do navegador, do servidor e de eventual CDN.
- Se necessário, desative temporariamente a minificação, defer ou otimizações JavaScript.
- 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 da cache são três operações diferentes.
A caixa autoriza ou desautoriza a utilização do serviço remoto.
Atualizar verificação do serviço força, por sua vez,
uma nova verificação do estado armazenado pelo plugin.
Nenhuma das duas operações limpa a cache do WordPress,
do navegador, do servidor ou da CDN.
Se solicitar assistência, forneça versões, passos para reproduzir
o problema, capturas de ecrã e eventuais erros relevantes.
Não envie palavras-passe, chaves API, tokens, cookies ou cópias de segurança completas.