Pet Nutrition Pro · Guide opérationnel
Guide rapide
De l’installation au premier test complet. Suivez les sections dans l’ordre indiqué pour configurer Pet Nutrition Pro, préparer le catalogue WooCommerce et vérifier le résultat avant la mise en ligne.
Configurez Pet Nutrition Pro étape par étape
Cette page rassemble les opérations essentielles. Pour les explications, exemples, captures d’écran et procédures de contrôle complètes, chaque section renvoie au chapitre correspondant du manuel.
01
Préparation
Installez et activez Boma Pet Nutrition Pro
Boma Pet Nutrition Pro nécessite que WooCommerce soit installé et actif. Vérifiez d’abord ce prérequis, puis installez le plugin et configurez explicitement l’accès au service distant.
- Vérifiez que WooCommerce est installé et actif. S’il n’est pas présent, installez-le et activez-le avant de poursuivre avec Boma Pet Nutrition Pro.
- Ouvrez Extensions → Ajouter une extension → Téléverser une extension.
- Sélectionnez le fichier ZIP de Boma Pet Nutrition Pro, installez-le et activez-le.
- Après l’activation, ouvrez Pet Nutrition Pro → Premiers pas.
- Lisez les informations relatives au service distant et à la confidentialité.
- Lorsque vous souhaitez utiliser le service de calcul, activez dans les réglages la case Autorisation du service distant.
- Vérifiez séparément l’état de l’éventuel Diet Engine.
- Si vous venez d’activer Diet Engine et souhaitez l’utiliser immédiatement, cliquez sur Actualiser la vérification du service pour mettre à jour l’état mémorisé par le plugin.
Free et Diet Engine sont deux états distincts.
L’autorisation du service distant est également nécessaire pour le calcul Free. Diet Engine ajoute les produits recommandés, les quantités coordonnées et l’intégration au panier WooCommerce.
Actualiser la vérification du service n’autorise pas le service distant.
L’autorisation est gérée exclusivement au moyen de la case
Autorisation du service distant. Le bouton force uniquement une nouvelle vérification de l’état du service.
02
Pages publiques
Configurez le formulaire et la page de résultats
Pet Nutrition Pro utilise deux pages distinctes : l’une recueille les données de l’animal et l’autre affiche le résultat. Dans les nouvelles installations, la page Resulting Diet est créée et associée automatiquement par le plugin.
- Créez ou repérez la page destinée au questionnaire.
-
Insérez une seule fois le shortcode
[pet_nutrition_form]. - Après l’activation de Boma Pet Nutrition Pro, vérifiez que la page est présente et publiée : Resulting Diet.
-
Dans les nouvelles installations, le plugin crée et associe automatiquement cette page en y insérant le shortcode
[bomapnp_resulting_diet]. - Dans les réglages de Pet Nutrition Pro, vérifiez que la Page de résultats du régime pointe vers la page Resulting Diet correcte.
-
Si la page est absente, a été supprimée ou si son contenu a été modifié, restaurez-la manuellement en insérant
[bomapnp_resulting_diet]et sélectionnez-la de nouveau comme page de résultats. - Publiez la page du questionnaire et vérifiez l’ensemble du parcours en HTTPS.
La création manuelle de Resulting Diet est une procédure de restauration.
Dans une nouvelle installation correcte, la page est créée automatiquement par le plugin.
Ne permutez pas et ne dupliquez pas les shortcodes. La page du questionnaire utilise
[pet_nutrition_form], tandis que la page de résultats utilise
[bomapnp_resulting_diet].03
Catalogue WooCommerce
Préparez les produits pour la ration
Un produit WooCommerce n’entre pas automatiquement dans les recommandations. Il doit être activé et configuré avec les données requises par Pet Nutrition Pro.
- Ouvrez la fiche du produit WooCommerce.
- Activez Présent dans la ration.
- Attribuez une seule catégorie technique : Aliment sec, Aliment soufflé ou Aliment humide.
- Saisissez la valeur énergétique correcte en kcal pour 100 g.
- Configurez la destination pour chien et/ou chat, la taille et le stade de vie lorsqu’ils sont prévus.
- Renseignez les exclusions alimentaires et les sensibilités uniquement lorsqu’elles sont étayées par l’étiquette, la fiche technique ou les indications du fabricant.
- Enregistrez le produit et vérifiez le résultat avec un profil de test.
Présent dans la ration rend le produit éligible à l’évaluation, mais cela ne signifie pas qu’il soit compatible avec tous les animaux.
04
Donnée énergétique
Saisissez correctement les kcal pour 100 g
Le moteur utilise toujours une valeur normalisée exprimée en kcal pour 100 grammes, même lorsque l’étiquette présente l’énergie sous une autre forme.
- Si l’étiquette indique kcal/100 g, saisissez directement la valeur.
- Si elle indique kcal/kg, divisez la valeur par 10. Exemple : 3 650 kcal/kg → 365 kcal/100 g.
- Si elle indique les calories de l’ensemble de l’emballage, divisez par le poids en grammes puis multipliez par 100.
- Utilisez le calculateur guidé présent dans la fiche produit lorsque le format de l’étiquette nécessite une conversion.
- Avant d’enregistrer, comparez toujours le résultat avec l’étiquette ou la fiche technique du fabricant.
Les mentions énergétiques varient selon les marchés. L’Annexe A du Guide complet contient le mémento adapté aux zones/localisations prévues.
05
Règles de sélection
Configurez la compatibilité
La priorité commerciale n’est appliquée qu’après vérification des préférences de l’utilisateur et de la compatibilité du produit avec le profil de l’animal.
- Vérifiez d’abord l’espèce et le stade de vie pour lesquels le produit est déclaré adapté.
- Pour le chien, configurez correctement les tailles prévues.
- Renseignez les exclusions et intolérances avec prudence.
- Sélectionnez les sensibilités uniquement lorsqu’elles reposent sur une information documentable relative au produit.
- N’oubliez pas qu’une seule incompatibilité pertinente peut exclure le produit de la proposition.
- Vérifiez le comportement avec au moins un profil qui doit inclure le produit et un autre qui doit l’exclure.
L’ordre correct est :
préférences → compatibilité → classement → proposition. Un produit placé en première position ne devient pas compatible pour autant.
06
Stratégie commerciale
Classez les produits compatibles
Les classements déterminent quel produit compatible est considéré en premier pour chaque type d’aliment et chaque groupe d’animaux.
- Ouvrez Pet Nutrition Pro → Classement des produits.
- Sélectionnez le type : Aliment sec, Aliment soufflé ou Aliment humide.
- Sélectionnez le groupe : petit, moyen ou grand chien, ou chat.
- Appliquez les filtres et examinez l’ensemble du classement.
- Faites glisser les produits dans l’ordre souhaité.
- Enregistrez le nouveau classement.
- Générez une nouvelle ration afin d’en vérifier l’effet.
La position 1 a la priorité la plus élevée, mais uniquement parmi les produits compatibles. Pour le chien, des classements distincts existent selon la taille ; le chat utilise son propre classement.
07
Étendue de la proposition
Définissez le nombre d’aliments humides
Pour les aliments secs et soufflés, un seul produit est normalement sélectionné. Pour les aliments humides, vous pouvez définir le nombre maximal de produits compatibles à proposer.
- Ouvrez la page principale des réglages de Pet Nutrition Pro.
- Repérez le champ Nombre de produits humides.
- Définissez le nombre souhaité.
- Enregistrez les modifications.
- Générez une nouvelle ration comprenant des aliments humides.
- Vérifiez quels produits sont retenus selon la compatibilité et le classement.
Le nombre configuré est un maximum. Si vous demandez 3 aliments humides mais que seulement 2 sont compatibles, le système propose les 2 produits compatibles : il n’impose pas un troisième produit.
08
Boutiques et agences
Personnalisez l’apparence et la mise en page
Pet Nutrition Pro permet de personnaliser nativement l’affichage de la fiche nutritionnelle et des produits recommandés sans modifier la logique du plugin.
- Ouvrez Pet Nutrition Pro → Apparence et mise en page.
- Configurez la largeur, la typographie, les couleurs, les arrière-plans, les bordures et les arrondis de la fiche.
- Choisissez une grille ou une liste pour les produits recommandés.
- Définissez les colonnes pour ordinateur, tablette et smartphone.
- Configurez les images, le prix, la description et le bouton selon le projet de la boutique.
- Si vous travaillez pour une agence, vous pouvez ajouter un logo, un texte d’identification et une classe CSS supplémentaire.
- Pour le logo, utilisez si nécessaire Choisir dans la médiathèque.
- Enregistrez et vérifiez toujours un résultat réel sur ordinateur, tablette et smartphone.
Utilisez d’abord les options natives.
N’utilisez du CSS personnalisé que pour des besoins supplémentaires et ne modifiez pas directement les fichiers du plugin.
Apparence et mise en page concerne l’affichage à l’écran. L’impression et le PDF conservent une présentation distincte : une différence entre la page web et le PDF n’indique pas nécessairement une erreur.
09
Validation
Vérifiez avec la méthode TEST / CONTRÔLE
Avant la mise en ligne, vérifiez chaque critère en ne modifiant qu’une seule variable à la fois.
- Préparez deux produits : un TEST et un CONTRÔLE.
- Conservez toutes les données identiques, sauf le critère que vous souhaitez vérifier.
- Créez un profil d’animal reproductible.
- Générez le résultat et notez l’issue.
- Modifiez une seule condition et répétez le test avec le même profil.
- Pour les classements, utilisez au moins deux produits tous deux compatibles et vérifiez lequel est sélectionné.
- Vérifiez également le nombre d’aliments humides, l’impression/PDF et l’ajout au panier.
- Répétez le parcours en tant qu’utilisateur non connecté.
Après la validation, supprimez ou désactivez les produits techniques non destinés au public, rétablissez les classements commerciaux et générez une dernière ration réelle de confirmation.
10
Avant la mise en ligne
Effectuez le contrôle final et mettez en ligne
Avant de rendre le service accessible aux clients, vérifiez le fonctionnement, la sécurité et les informations publiques.
- Vérifiez que le site public utilise HTTPS.
- Vérifiez que la case Autorisation du service distant a été activée en connaissance de cause si le site doit utiliser le service de calcul.
- Mettez à jour la Politique de confidentialité afin qu’elle corresponde à l’utilisation réelle de Pet Nutrition Pro et du service distant.
- Vérifiez que le formulaire et le résultat fonctionnent sans être connecté à WordPress.
- Vérifiez le parcours complet : formulaire → résultat → produits → panier.
- Vérifiez sur ordinateur, tablette et smartphone.
- Vérifiez l’impression et l’enregistrement en PDF.
- Assurez-vous qu’aucune clé, aucun jeton ni aucune information technique confidentielle ne soit visible publiquement.
WordPress enregistre également un texte proposé par Pet Nutrition Pro pour la Politique de confidentialité. Il s’agit d’une base technique à adapter au site, et non d’un modèle juridique universel.
11
Diagnostic
Si quelque chose ne fonctionne pas
Procédez par élimination et ne modifiez qu’une seule variable à la fois. Évitez de changer simultanément la page, le CSS, le cache et la configuration du service.
-
Vérifiez que les shortcodes sont présents sur les bonnes pages :
[pet_nutrition_form]et[bomapnp_resulting_diet]. -
Vérifiez que la page
Resulting Diet
est publiée, contient
[bomapnp_resulting_diet]et est sélectionnée comme page de résultats. - Répétez le test dans une fenêtre de navigation privée avec un navigateur à jour.
- Vérifiez séparément la case Autorisation du service distant et l’état de Diet Engine.
- Si vous venez d’activer Diet Engine ou si vous souhaitez forcer une nouvelle vérification de l’état distant, utilisez Actualiser la vérification du service.
- Videz séparément le cache WordPress, celui du navigateur, du serveur et, le cas échéant, du CDN.
- Si nécessaire, désactivez temporairement la minification, le chargement différé ou les optimisations JavaScript.
- Dans un environnement de préproduction, testez avec un thème standard et uniquement les extensions indispensables.
Autorisation du service distant, Actualiser la vérification du service et vidage du cache sont trois opérations différentes.
La case autorise ou désautorise l’utilisation du service distant.
Actualiser la vérification du service force en revanche une nouvelle vérification de l’état mémorisé par le plugin. Aucune de ces deux opérations ne vide le cache WordPress, du navigateur, du serveur ou du CDN.
Si vous demandez de l’assistance, fournissez les versions, les étapes permettant de reproduire le problème, des captures d’écran et les erreurs pertinentes éventuelles. N’envoyez pas de mots de passe, clés API, jetons, cookies ou sauvegardes complètes.