Zum Hauptinhalt springen

Pet Nutrition Pro

Menü
Diet Engine starten

Pet Nutrition Pro · Praxisleitfaden

Kurzanleitung

Von der Installation bis zum ersten vollständigen Test. Folgen Sie den Abschnitten in der angegebenen Reihenfolge, um Pet Nutrition Pro zu konfigurieren, den WooCommerce-Katalog vorzubereiten und das Ergebnis vor der Veröffentlichung zu prüfen.

Plugin herunterladen Vollständige Anleitung öffnen

Pet Nutrition Pro Schritt für Schritt konfigurieren

Diese Seite fasst die wichtigsten Arbeitsschritte zusammen. Für ausführliche Erklärungen, Beispiele, Bildschirmabbildungen und vollständige Prüfverfahren finden Sie in jedem Abschnitt den Verweis auf das entsprechende Kapitel der Anleitung.

01

Vorbereitung

Boma Pet Nutrition Pro installieren und aktivieren

Boma Pet Nutrition Pro erfordert ein installiertes und aktives WooCommerce. Prüfen Sie zuerst diese Voraussetzung, installieren Sie anschließend das Plugin und konfigurieren Sie den Zugriff auf den Remote-Dienst bewusst.

  1. Stellen Sie sicher, dass WooCommerce installiert und aktiv ist. Falls WooCommerce noch nicht vorhanden ist, installieren und aktivieren Sie es, bevor Sie mit Boma Pet Nutrition Pro fortfahren.
  2. Öffnen Sie Plugins → Plugin hinzufügen → Plugin hochladen.
  3. Wählen Sie die ZIP-Datei von Boma Pet Nutrition Pro, installieren Sie das Plugin und aktivieren Sie es.
  4. Öffnen Sie nach der Aktivierung Pet Nutrition Pro → Erste Schritte.
  5. Lesen Sie die Informationen zum Remote-Dienst und zum Datenschutz.
  6. Wenn Sie den Berechnungsdienst verwenden möchten, aktivieren Sie in den Einstellungen die Option Remote service authorization.
  7. Prüfen Sie den Status eines gegebenenfalls vorhandenen Diet Engine.
  8. Wenn Sie Diet Engine gerade aktiviert haben und den Dienst sofort verwenden möchten, wählen Sie Refresh service check, um den vom Plugin gespeicherten Dienststatus zu aktualisieren.
Free und Diet Engine sind zwei unterschiedliche Zustände. Die Autorisierung des Remote-Dienstes ist auch für die Free-Berechnung erforderlich. Diet Engine ergänzt empfohlene Produkte, koordinierte Mengen und die Integration in den WooCommerce-Warenkorb.
Refresh service check autorisiert den Remote-Dienst nicht. Die Autorisierung wird ausschließlich über die Option Remote service authorization gesteuert. Die Schaltfläche erzwingt lediglich eine neue Prüfung des Dienststatus.
Mehr dazu: Vollständige Anleitung · Kapitel 17 → ↑ Zurück zur Übersicht
02

Öffentliche Seiten

Formular und Ergebnisseite konfigurieren

Pet Nutrition Pro verwendet zwei getrennte Seiten: Eine erfasst die Daten des Tieres, die andere zeigt das Ergebnis. Bei neuen Installationen wird die Seite Resulting Diet automatisch vom Plugin erstellt und verknüpft.

  1. Erstellen oder bestimmen Sie die Seite für den Fragebogen.
  2. Fügen Sie den Shortcode genau einmal ein: [pet_nutrition_form].
  3. Prüfen Sie nach der Aktivierung von Boma Pet Nutrition Pro, ob die Seite Resulting Diet vorhanden und veröffentlicht ist.
  4. Bei neuen Installationen erstellt und verknüpft das Plugin diese Seite automatisch und fügt dabei den Shortcode [bomapnp_resulting_diet].
  5. Prüfen Sie in den Einstellungen von Pet Nutrition Pro, ob Diet result page auf die richtige Seite Resulting Diet verweist.
  6. Falls die Seite fehlt, gelöscht wurde oder ihr Inhalt verändert wurde, stellen Sie sie manuell wieder her und fügen Sie [bomapnp_resulting_diet] ein. Wählen Sie sie anschließend erneut als Ergebnisseite aus.
  7. Veröffentlichen Sie die Fragebogenseite und prüfen Sie den gesamten Ablauf über HTTPS.
Die manuelle Erstellung von Resulting Diet ist ein Wiederherstellungsverfahren. Bei einer korrekten Neuinstallation wird die Seite automatisch vom Plugin erstellt.
Vertauschen oder duplizieren Sie die Shortcodes nicht. Die Fragebogenseite verwendet [pet_nutrition_form], während die Ergebnisseite den Shortcode [bomapnp_resulting_diet] verwendet.
Mehr dazu: Vollständige Anleitung · Kapitel 17–18 → ↑ Zurück zur Übersicht
03

WooCommerce-Katalog

Produkte für die Diätauswahl vorbereiten

Ein WooCommerce-Produkt wird nicht automatisch in die Empfehlungen aufgenommen. Es muss aktiviert und mit den von Pet Nutrition Pro benötigten Daten konfiguriert werden.

  1. Öffnen Sie die WooCommerce-Produktbearbeitung.
  2. Aktivieren Sie In der Diät enthalten.
  3. Weisen Sie genau eine technische Kategorie zu: Trockenfutter, Gepufftes Futter oder Nassfutter.
  4. Tragen Sie den korrekten Energiewert in kcal pro 100 g.
  5. Konfigurieren Sie die Eignung für Hund und/oder Katze sowie, soweit vorgesehen, Größe und Lebensphase.
  6. Konfigurieren Sie Futterausschlüsse und Empfindlichkeiten nur dann, wenn sie durch Etikett, technisches Datenblatt oder Herstellerangaben gestützt werden.
  7. Speichern Sie das Produkt und prüfen Sie das Ergebnis mit einem Testprofil.
In der Diät enthalten gibt das Produkt für die Bewertung frei, bedeutet aber nicht, dass es mit jedem Tierprofil kompatibel ist.
Mehr dazu: Vollständige Anleitung · Kapitel 10 → ↑ Zurück zur Übersicht
04

Energiewert

kcal pro 100 g korrekt eintragen

Die Engine verwendet immer einen normierten Wert in kcal pro 100 Gramm, auch wenn das Etikett die Energie in einer anderen Einheit angibt.

  1. Wenn das Etikett kcal/100 g angibt, übernehmen Sie den Wert direkt.
  2. Bei kcal/kg teilen Sie den Wert durch 10. Beispiel: 3.650 kcal/kg → 365 kcal/100 g.
  3. Wenn die Kalorien für die gesamte Packung angegeben sind, teilen Sie die Gesamtkalorien durch das Gewicht in Gramm und multiplizieren Sie mit 100.
  4. Verwenden Sie den geführten Rechner in der Produktbearbeitung, wenn die Energieangabe umgerechnet werden muss.
  5. Vergleichen Sie das Ergebnis vor dem Speichern immer mit dem Etikett oder dem technischen Datenblatt des Herstellers.
Für Deutschland und den EU-Markt können unter anderem kcal/kg, kcal/100 g, kJ/kg oder MJ/kg angegeben sein. Verwenden Sie stets den deklarierten Herstellerwert und normalisieren Sie ihn nachvollziehbar auf kcal/100 g. Die vollständigen Regeln stehen in Anhang A.
Mehr dazu: Vollständige Anleitung · §10.4 und Anhang A → ↑ Zurück zur Übersicht
05

Auswahlregeln

Kompatibilität konfigurieren

Die kommerzielle Priorität wird erst angewendet, nachdem die Präferenzen des Nutzers und die Kompatibilität des Produkts mit dem Tierprofil geprüft wurden.

  1. Prüfen Sie zuerst Tierart und Lebensphase, für die das Produkt als geeignet deklariert ist.
  2. Konfigurieren Sie bei Hunden die vorgesehenen Größen korrekt.
  3. Konfigurieren Sie Ausschlüsse und Unverträglichkeiten konservativ.
  4. Wählen Sie Empfindlichkeiten nur dann aus, wenn dafür eine dokumentierbare Grundlage zum Produkt vorliegt.
  5. Beachten Sie, dass bereits eine relevante Inkompatibilität das Produkt aus dem Vorschlag ausschließen kann.
  6. Prüfen Sie das Verhalten mit mindestens einem Profil, das das Produkt einschließen soll, und einem, das es ausschließen soll.
Die richtige Reihenfolge lautet: Präferenzen → Kompatibilität → Sortierung → Vorschlag. Ein Produkt wird nicht dadurch kompatibel, dass es an erster Stelle steht.
Mehr dazu: Vollständige Anleitung · Kapitel 4, 5 und 10 → ↑ Zurück zur Übersicht
06

Kommerzielle Strategie

Kompatible Produkte sortieren

Die Sortierungen legen fest, welches kompatible Produkt für jede Futterart und jede Tiergruppe zuerst berücksichtigt wird.

  1. Öffnen Sie Pet Nutrition Pro → Sort diet products.
  2. Wählen Sie die Futterart: Trockenfutter, Gepufftes Futter oder Nassfutter.
  3. Wählen Sie die Tiergruppe: kleiner, mittlerer oder großer Hund beziehungsweise Katze.
  4. Wenden Sie die Filter an und prüfen Sie die vollständige Rangfolge.
  5. Ziehen Sie die Produkte in die gewünschte Reihenfolge.
  6. Speichern Sie die neue Sortierung.
  7. Erzeugen Sie eine neue Diät, um die Auswirkung zu prüfen.
Position 1 hat die höchste Priorität, jedoch nur unter kompatiblen Produkten. Für Hunde gibt es getrennte Rangfolgen nach Größe; Katzen verwenden eine eigene Sortierung.
Mehr dazu: Vollständige Anleitung · Kapitel 11 → ↑ Zurück zur Übersicht
07

Umfang des Vorschlags

Anzahl der Nassfutterprodukte festlegen

Für Trockenfutter und Gepufftes Futter wird normalerweise jeweils nur ein Produkt ausgewählt. Für Nassfutter können Sie festlegen, wie viele kompatible Produkte maximal vorgeschlagen werden sollen.

  1. Öffnen Sie die Hauptseite der Einstellungen von Pet Nutrition Pro.
  2. Suchen Sie das Feld Number of wet food products.
  3. Stellen Sie die gewünschte Anzahl ein.
  4. Speichern Sie die Änderungen.
  5. Erzeugen Sie eine neue Diät, in der Nassfutter ausgewählt ist.
  6. Prüfen Sie, welche Produkte entsprechend Kompatibilität und Sortierung aufgenommen werden.
Die konfigurierte Anzahl ist ein Maximum. Wenn 3 Nassfutterprodukte eingestellt sind, aber nur 2 kompatibel sind, schlägt das System die 2 kompatiblen Produkte vor: Ein drittes Produkt wird nicht erzwungen.
Mehr dazu: Vollständige Anleitung · Kapitel 12 → ↑ Zurück zur Übersicht
08

Shops und Agenturen

Aussehen und Layout anpassen

Pet Nutrition Pro ermöglicht die native Anpassung der Ernährungsübersicht und der empfohlenen Produkte, ohne die Logik des Plugins zu verändern.

  1. Öffnen Sie Pet Nutrition Pro → Aussehen und Layout.
  2. Konfigurieren Sie Breite, Typografie, Farben, Hintergründe, Rahmen und Rundungen der Übersicht.
  3. Wählen Sie Raster oder Liste für die empfohlenen Produkte.
  4. Legen Sie die Spalten für Desktop, Tablet und Smartphone fest.
  5. Konfigurieren Sie Bilder, Preis, Beschreibung und Schaltfläche passend zum Design des Shops.
  6. Wenn Sie für eine Agentur arbeiten, können Sie Logo, Kennzeichnungstext und eine zusätzliche CSS-Klasse einfügen.
  7. Verwenden Sie für das Logo, sofern passend, Aus Mediathek auswählen.
  8. Speichern Sie und prüfen Sie immer ein echtes Ergebnis auf Desktop, Tablet und Smartphone.
Verwenden Sie zuerst die nativen Optionen. Verwenden Sie eigenes CSS nur für zusätzliche Anforderungen und ändern Sie die Plugin-Dateien nicht direkt.
Aussehen und Layout betrifft die Darstellung auf dem Bildschirm. Druck und PDF verwenden eine separate Darstellung: Ein Unterschied zwischen Webseite und PDF bedeutet daher nicht zwangsläufig einen Fehler.
Mehr dazu: Vollständige Anleitung · Kapitel 19 → ↑ Zurück zur Übersicht
09

Prüfung

Mit der Methode TEST / KONTROLLE prüfen

Prüfen Sie vor der Veröffentlichung jedes Kriterium, indem Sie jeweils nur eine Variable ändern.

  1. Bereiten Sie zwei Produkte vor: eines als TEST und eines als KONTROLLE.
  2. Lassen Sie alle Daten gleich, mit Ausnahme des Kriteriums, das Sie prüfen möchten.
  3. Erstellen Sie ein reproduzierbares Tierprofil.
  4. Erzeugen Sie das Ergebnis und notieren Sie den Ausgang.
  5. Ändern Sie nur eine Bedingung und wiederholen Sie dasselbe Profil.
  6. Verwenden Sie für Sortierungstests mindestens zwei kompatible Produkte und prüfen Sie, welches ausgewählt wird.
  7. Prüfen Sie außerdem die Anzahl der Nassfutterprodukte, Druck/PDF und das Hinzufügen zum Warenkorb.
  8. Wiederholen Sie den Ablauf als nicht angemeldeter Benutzer.
Entfernen oder deaktivieren Sie nach der Prüfung technische Produkte, die nicht für die Öffentlichkeit bestimmt sind, stellen Sie die kommerziellen Sortierungen wieder her und erzeugen Sie abschließend eine echte Diät zur Bestätigung.
Mehr dazu: Vollständige Anleitung · Kapitel 15 → ↑ Zurück zur Übersicht
10

Vor dem Livegang

Abschlusstest durchführen und veröffentlichen

Bevor Sie den Dienst für Kunden freigeben, prüfen Sie Funktion, Sicherheit und öffentliche Informationen.

  1. Stellen Sie sicher, dass die öffentliche Website HTTPS verwendet.
  2. Prüfen Sie, ob die Option Remote service authorization bewusst aktiviert wurde, wenn die Website den Berechnungsdienst verwenden soll.
  3. Aktualisieren Sie die Datenschutzerklärung entsprechend der tatsächlichen Nutzung von Pet Nutrition Pro und des Remote-Dienstes.
  4. Prüfen Sie, ob Formular und Ergebnis auch ohne Anmeldung in WordPress funktionieren.
  5. Prüfen Sie den vollständigen Ablauf: Formular → Ergebnis → Produkte → Warenkorb.
  6. Prüfen Sie Desktop, Tablet und Smartphone.
  7. Prüfen Sie Druck und PDF-Speicherung.
  8. Stellen Sie sicher, dass keine Schlüssel, Tokens oder vertraulichen technischen Informationen öffentlich sichtbar sind.
WordPress registriert außerdem einen von Pet Nutrition Pro vorgeschlagenen Text für die Datenschutzerklärung. Er ist eine technische Ausgangsbasis, die an die Website angepasst werden muss, und keine allgemeingültige Rechtsvorlage.
Mehr dazu: Vollständige Anleitung · §§17.8, 21.7 und 21.8 → ↑ Zurück zur Übersicht
11

Diagnose

Wenn etwas nicht funktioniert

Gehen Sie schrittweise vor und ändern Sie jeweils nur eine Variable. Vermeiden Sie es, gleichzeitig Seite, CSS, Cache und Dienstkonfiguration zu verändern.

  1. Prüfen Sie, ob die Shortcodes auf den richtigen Seiten vorhanden sind: [pet_nutrition_form] und [bomapnp_resulting_diet].
  2. Prüfen Sie, ob die Seite Resulting Diet veröffentlicht ist, [bomapnp_resulting_diet] enthält und als Ergebnisseite ausgewählt ist.
  3. Wiederholen Sie den Test in einem privaten/Inkognito-Fenster mit einem aktuellen Browser.
  4. Prüfen Sie separat die Option Remote service authorization und den Status von Diet Engine.
  5. Wenn Sie Diet Engine gerade aktiviert haben oder eine neue Prüfung des Remote-Status erzwingen möchten, verwenden Sie Refresh service check.
  6. Leeren Sie WordPress-, Browser-, Server- und gegebenenfalls CDN-Cache jeweils separat.
  7. Deaktivieren Sie bei Bedarf vorübergehend Minifizierung, Defer oder JavaScript-Optimierungen.
  8. Testen Sie in einer Staging-Umgebung mit einem Standard-Theme und nur den unbedingt erforderlichen Plugins.
Remote service authorization, Refresh service check und das Leeren des Caches sind drei unterschiedliche Vorgänge. Die Option autorisiert oder widerruft die Nutzung des Remote-Dienstes. Refresh service check erzwingt dagegen eine neue Prüfung des vom Plugin gespeicherten Status. Keiner der beiden Vorgänge leert den WordPress-, Browser-, Server- oder CDN-Cache.
Wenn Sie Support anfordern, geben Sie Versionen, Schritte zur Reproduktion des Problems, Screenshots und relevante Fehlermeldungen an. Senden Sie keine Passwörter, API-Schlüssel, Tokens, Cookies oder vollständigen Backups.
Mehr dazu: Vollständige Anleitung · Kapitel 20 und 22 → ↑ Zurück zur Übersicht