Salta al contenuto principale

Pet Nutrition Pro

Menu
Attiva Diet Engine

Pet Nutrition Pro · Guida operativa

Guida rapida

Dall’installazione al primo test completo. Segui le sezioni nell’ordine indicato per configurare Pet Nutrition Pro, preparare il catalogo WooCommerce e verificare il risultato prima della pubblicazione.

Scarica il plugin Consulta la guida completa

Configura Pet Nutrition Pro passo dopo passo

Questa pagina raccoglie le operazioni essenziali. Per spiegazioni, esempi, schermate e procedure di controllo complete trovi in ogni sezione il riferimento al relativo capitolo del manuale.

01

Preparazione

Installa e attiva Boma Pet Nutrition Pro

Boma Pet Nutrition Pro richiede WooCommerce installato e attivo. Verifica prima questo prerequisito, quindi installa il plugin e configura consapevolmente l’accesso al servizio remoto.

  1. Verifica che WooCommerce sia installato e attivo. Se non è presente, installalo e attivalo prima di procedere con Boma Pet Nutrition Pro.
  2. Apri Plugin → Aggiungi plugin → Carica plugin.
  3. Seleziona il file ZIP di Boma Pet Nutrition Pro, installalo e attivalo.
  4. Dopo l’attivazione apri Pet Nutrition Pro → Primi passi.
  5. Leggi le informazioni relative al servizio remoto e alla privacy.
  6. Quando vuoi utilizzare il servizio di calcolo, abilita nelle impostazioni la casella Autorizzazione servizio remoto.
  7. Verifica separatamente lo stato dell’eventuale Diet Engine.
  8. Se hai appena attivato Diet Engine e vuoi utilizzarlo immediatamente, premi Aggiorna verifica servizio per aggiornare lo stato memorizzato dal plugin.
Free e Diet Engine sono due stati diversi. L’autorizzazione al servizio remoto è necessaria anche per il calcolo Free. Diet Engine aggiunge prodotti consigliati, quantità coordinate e integrazione con il carrello WooCommerce.
Aggiorna verifica servizio non autorizza il servizio remoto. L’autorizzazione è gestita esclusivamente tramite la casella Autorizzazione servizio remoto. Il pulsante forza soltanto un nuovo controllo dello stato del servizio.
Approfondimento: Guida completa · Capitolo 17 → ↑ Torna all’indice
02

Pagine pubbliche

Configura form e pagina dei risultati

Pet Nutrition Pro utilizza due pagine distinte: una raccoglie i dati del pet e una mostra il risultato. Nelle nuove installazioni la pagina Resulting Diet viene creata e collegata automaticamente dal plugin.

  1. Crea o individua la pagina destinata al questionario.
  2. Inserisci una sola volta lo shortcode [pet_nutrition_form].
  3. Dopo l’attivazione di Boma Pet Nutrition Pro, verifica che sia presente e pubblicata la pagina Resulting Diet.
  4. Nelle nuove installazioni il plugin crea e collega automaticamente questa pagina inserendo lo shortcode [bomapnp_resulting_diet].
  5. Nelle impostazioni di Pet Nutrition Pro controlla che la Diet result page punti alla pagina Resulting Diet corretta.
  6. Se la pagina manca, è stata eliminata oppure il suo contenuto è stato modificato, ripristinala manualmente inserendo [bomapnp_resulting_diet] e selezionala nuovamente come pagina dei risultati.
  7. Pubblica la pagina del questionario e verifica l’intero flusso in HTTPS.
La creazione manuale di Resulting Diet è una procedura di ripristino. In una nuova installazione corretta la pagina viene creata automaticamente dal plugin.
Non intercambiare e non duplicare gli shortcode. La pagina del questionario utilizza [pet_nutrition_form], mentre la pagina dei risultati utilizza [bomapnp_resulting_diet].
Approfondimento: Guida completa · Capitoli 17–18 → ↑ Torna all’indice
03

Catalogo WooCommerce

Prepara i prodotti per la dieta

Un prodotto WooCommerce non entra automaticamente nelle raccomandazioni. Deve essere abilitato e configurato con i dati richiesti da Pet Nutrition Pro.

  1. Apri la scheda del prodotto WooCommerce.
  2. Attiva Presente nella Dieta.
  3. Assegna una sola categoria tecnica: Secco, Soffiato oppure Umido.
  4. Inserisci il valore energetico corretto in kcal per 100 g.
  5. Configura la destinazione per cane e/o gatto, taglia e fase di vita quando previste.
  6. Compila esclusioni alimentari e sensibilità soltanto quando supportate dall’etichetta, dalla scheda tecnica o dalle indicazioni del produttore.
  7. Salva il prodotto e verifica il risultato con un profilo di prova.
Presente nella Dieta abilita il prodotto alla valutazione, ma non significa che quel prodotto sia compatibile con tutti i pet.
Approfondimento: Guida completa · Capitolo 10 → ↑ Torna all’indice
04

Dato energetico

Inserisci correttamente le kcal per 100 g

Il motore utilizza sempre un valore normalizzato espresso in kcal per 100 grammi, anche quando l’etichetta riporta l’energia in una forma diversa.

  1. Se l’etichetta riporta kcal/100 g, inserisci direttamente il valore.
  2. Se riporta kcal/kg, dividi il valore per 10. Esempio: 3.650 kcal/kg → 365 kcal/100 g.
  3. Se riporta le calorie dell’intera confezione, dividi per il peso in grammi e moltiplica per 100.
  4. Usa il calcolatore guidato presente nella scheda prodotto quando il formato dell’etichetta richiede una conversione.
  5. Prima di salvare, confronta sempre il risultato con l’etichetta o con la scheda tecnica del produttore.
Le diciture energetiche cambiano fra i diversi mercati. La Guida completa contiene nell’Appendice A il vademecum dedicato alle aree/localizzazioni previste.
Approfondimento: Guida completa · §10.4 e Appendice A → ↑ Torna all’indice
05

Regole di selezione

Configura la compatibilità

La priorità commerciale viene applicata soltanto dopo la verifica delle preferenze dell’utente e della compatibilità del prodotto con il profilo del pet.

  1. Verifica prima la specie e la fase di vita per cui il prodotto è dichiarato idoneo.
  2. Per il cane configura correttamente le taglie previste.
  3. Compila esclusioni e intolleranze con criterio conservativo.
  4. Seleziona le sensibilità soltanto quando esiste una base documentabile nel prodotto.
  5. Ricorda che una sola incompatibilità rilevante può escludere il prodotto dalla proposta.
  6. Verifica il comportamento con almeno un profilo che deve includere il prodotto e uno che deve escluderlo.
L’ordine corretto è: preferenze → compatibilità → ordinamento → proposta. Un prodotto messo al primo posto non diventa compatibile.
Approfondimento: Guida completa · Capitoli 4, 5 e 10 → ↑ Torna all’indice
06

Strategia commerciale

Ordina i prodotti compatibili

Gli ordinamenti stabiliscono quale prodotto compatibile viene considerato per primo per ciascuna tipologia e per ciascun gruppo animale.

  1. Apri Pet Nutrition Pro → Ordinamento prodotti.
  2. Seleziona la tipologia: Secco, Soffiato o Umido.
  3. Seleziona il gruppo: cane piccolo, medio, grande oppure gatto.
  4. Applica i filtri e osserva l’intera graduatoria.
  5. Trascina gli articoli nella sequenza desiderata.
  6. Salva il nuovo ordinamento.
  7. Genera una nuova dieta per verificarne l’effetto.
La posizione 1 ha la priorità maggiore, ma soltanto fra i prodotti compatibili. Per il cane esistono graduatorie distinte per taglia; il gatto utilizza il proprio ordinamento.
Approfondimento: Guida completa · Capitolo 11 → ↑ Torna all’indice
07

Ampiezza della proposta

Imposta il numero degli alimenti Umidi

Per Secco e Soffiato viene normalmente selezionato un solo prodotto. Per l’Umido puoi stabilire quanti prodotti compatibili tentare di proporre.

  1. Apri la pagina principale delle impostazioni di Pet Nutrition Pro.
  2. Individua il campo Numero di Articoli Umidi.
  3. Imposta il numero desiderato.
  4. Salva le modifiche.
  5. Genera una nuova dieta che comprenda l’Umido.
  6. Controlla quali prodotti entrano secondo compatibilità e ordinamento.
Il numero configurato è un massimo. Se chiedi 3 Umidi ma soltanto 2 sono compatibili, il sistema propone i 2 compatibili: non forza un terzo prodotto.
Approfondimento: Guida completa · Capitolo 12 → ↑ Torna all’indice
08

Negozi e agenzie

Personalizza Aspetto e layout

Pet Nutrition Pro consente di personalizzare nativamente la visualizzazione della scheda nutrizionale e dei prodotti consigliati senza modificare la logica del plugin.

  1. Apri Pet Nutrition Pro → Aspetto e layout.
  2. Configura larghezza, tipografia, colori, sfondi, bordi e arrotondamenti della scheda.
  3. Scegli griglia o elenco per i prodotti consigliati.
  4. Imposta le colonne per desktop, tablet e smartphone.
  5. Configura immagini, prezzo, descrizione e pulsante secondo il progetto del negozio.
  6. Se lavori per un’agenzia, puoi inserire logo, testo identificativo e una classe CSS aggiuntiva.
  7. Per il logo usa, quando opportuno, Scegli dalla Libreria media.
  8. Salva e controlla sempre un risultato reale su desktop, tablet e smartphone.
Prima usa le opzioni native. Ricorri al CSS personalizzato soltanto per esigenze ulteriori e non modificare direttamente i file del plugin.
Aspetto e layout riguarda la resa a schermo. La stampa e il PDF mantengono una presentazione separata: una differenza fra pagina web e PDF non indica necessariamente un errore.
Approfondimento: Guida completa · Capitolo 19 → ↑ Torna all’indice
09

Collaudo

Verifica con il metodo TEST / CONTROLLO

Prima della pubblicazione verifica ogni criterio modificando una sola variabile per volta.

  1. Prepara due prodotti: uno TEST e uno CONTROLLO.
  2. Mantieni uguali tutti i dati tranne il criterio che vuoi verificare.
  3. Costruisci un profilo di pet ripetibile.
  4. Genera il risultato e annota l’esito.
  5. Cambia una sola condizione e ripeti lo stesso profilo.
  6. Per gli ordinamenti usa almeno due prodotti entrambi compatibili e verifica quale viene selezionato.
  7. Controlla anche numero degli Umidi, stampa/PDF e aggiunta al carrello.
  8. Ripeti il flusso come utente anonimo.
Dopo il collaudo elimina o disattiva i prodotti tecnici non destinati al pubblico, ripristina gli ordinamenti commerciali e genera un’ultima dieta reale di conferma.
Approfondimento: Guida completa · Capitolo 15 → ↑ Torna all’indice
10

Prima di andare online

Esegui il controllo finale e pubblica

Prima di rendere il servizio disponibile ai clienti, verifica funzionamento, sicurezza e informazioni pubbliche.

  1. Verifica che il sito pubblico utilizzi HTTPS.
  2. Controlla che la casella Autorizzazione servizio remoto sia stata abilitata consapevolmente se il sito deve utilizzare il servizio di calcolo.
  3. Aggiorna la Privacy Policy in modo coerente con l’uso reale di Pet Nutrition Pro e del servizio remoto.
  4. Verifica che form e risultato funzionino senza essere autenticati in WordPress.
  5. Controlla il percorso completo: form → risultato → prodotti → carrello.
  6. Controlla desktop, tablet e smartphone.
  7. Controlla stampa e salvataggio PDF.
  8. Assicurati che nessuna chiave, token o informazione tecnica riservata sia visibile pubblicamente.
WordPress registra anche un testo suggerito da Pet Nutrition Pro per la Privacy Policy. È una base tecnica da adattare al sito, non un modello legale universale.
Approfondimento: Guida completa · §§17.8, 21.7 e 21.8 → ↑ Torna all’indice
11

Diagnosi

Se qualcosa non funziona

Procedi per esclusione e modifica una sola variabile per volta. Evita di cambiare contemporaneamente pagina, CSS, cache e configurazione del servizio.

  1. Controlla che gli shortcode siano presenti nelle pagine corrette: [pet_nutrition_form] e [bomapnp_resulting_diet].
  2. Verifica che la pagina Resulting Diet sia pubblicata, contenga [bomapnp_resulting_diet] e sia selezionata come pagina dei risultati.
  3. Ripeti il test in una finestra anonima con un browser aggiornato.
  4. Controlla separatamente la casella Autorizzazione servizio remoto e lo stato di Diet Engine.
  5. Se hai appena attivato Diet Engine oppure vuoi forzare una nuova verifica dello stato remoto, usa Aggiorna verifica servizio.
  6. Svuota separatamente cache WordPress, browser, server ed eventuale CDN.
  7. Se necessario disattiva temporaneamente minificazione, defer o ottimizzazioni JavaScript.
  8. In staging prova con tema standard e soli plugin indispensabili.
Autorizzazione servizio remoto, Aggiorna verifica servizio e svuotamento della cache sono tre operazioni diverse. La casella autorizza o disautorizza l’uso del servizio remoto. Aggiorna verifica servizio forza invece un nuovo controllo dello stato memorizzato dal plugin. Nessuna delle due operazioni svuota la cache WordPress, del browser, del server o della CDN.
Se richiedi assistenza, fornisci versioni, passaggi per riprodurre il problema, screenshot ed eventuali errori pertinenti. Non inviare password, chiavi API, token, cookie o backup completi.
Approfondimento: Guida completa · Capitoli 20 e 22 → ↑ Torna all’indice