# Zoohandlung Modul für PrestaShop: Moduldokumentation > Dieses Modul ergänzt PrestaShop 8 und 9 um Tierprofile im Kundenkonto, eine Rationsberechnung und eine Empfehlung der Sackgröße auf den Futterseiten sowie Nachbestellpläne, die vor dem Ende des Sacks eine… - Seite: - Sprache: de - Aktualisiert am: 2026-09-24 - Weitere Sprachen: [fr](https://www.datafirefly.com/documentation/dfpetcare/index.md), [en](https://www.datafirefly.com/en/documentation/dfpetcare/index.md), [es](https://www.datafirefly.com/es/documentation/dfpetcare/index.md), [it](https://www.datafirefly.com/it/documentation/dfpetcare/index.md), [pl](https://www.datafirefly.com/pl/documentation/dfpetcare/index.md), [nl](https://www.datafirefly.com/nl/documentation/dfpetcare/index.md), [pt](https://www.datafirefly.com/pt/documentation/dfpetcare/index.md) - Index: Dieses Modul ergänzt PrestaShop 8 und 9 um Tierprofile im Kundenkonto, eine Rationsberechnung und eine Empfehlung der Sackgröße auf den Futterseiten sowie Nachbestellpläne, die vor dem Ende des Sacks eine Erinnerung senden, berechnet auf dem tatsächlichen Verbrauch des Kunden. Technischer Name: `dfpetcare`. ## Installation 1. Klicken Sie unter **Module > Modulmanager** auf **Modul hochladen** und ziehen Sie die ZIP-Datei hinein. 2. Das Modul legt seine Tabellen und drei Tierarten mit ihren Rassen an: Hund (32 Rassen), Katze (12 Rassen) und Kaninchen (2 Rassen). 3. Ein Menü **Verkauf > Tierbedarf** erscheint mit vier Seiten: **Futtereinstellungen**, **Nachbestellpläne**, **Tierprofile** und **Tierarten und Rassen**. Auf der Seite Mein Konto des Kunden wird ein Link **Meine Tiere** ergänzt. 4. Richten Sie die Cron-URL ein, die auf der Konfigurationsseite des Moduls angezeigt wird (siehe unten). ## Futterprodukte einrichten Nur Produkte, die unter **Tierbedarf > Futtereinstellungen** angelegt sind, zeigen den Rationsblock. Klicken Sie auf **Hinzufügen**, suchen Sie das Produkt nach Name, Referenz oder ID und geben Sie an: - **Für**: die betroffenen Tierarten. Nur Tiere dieser Arten werden auf der Produktseite angeboten. Leer lassen für alle Arten. - Die **Lebensphase** des Futters (alle Altersstufen, Wachstum, erwachsen, Senior): Ein Hinweis erscheint, wenn das Tier des Kunden nicht in dieser Phase ist. - **Berechnung**: über die Energie oder über die Fütterungstabelle (siehe unten). - **Haltbarkeit nach dem Öffnen** in Tagen: Säcke, die länger offen blieben, werden nicht empfohlen. 0 = keine Grenze. - **Nettogewicht**: bei einem Produkt mit Varianten das Gewicht jeder Variante in Gramm. Der Button **Aus den Variantennamen übernehmen** übernimmt die in den Namen gelesenen Gewichte (`12 kg`, `400 g`, `12 x 85 g`). Lassen Sie Varianten leer, die kein Futter sind. Bei einem einfachen Produkt geben Sie das gesamte Nettogewicht ein. ### Berechnung über die Energie Geben Sie die umsetzbare Energie des Futters in kcal/kg ein (Trockenfutter: meist 3400 bis 4200, Nassfutter: 700 bis 1200). Für Hund oder Katze berechnet das Modul den Ruheenergiebedarf (70 × Gewicht0,75), multipliziert ihn mit einem Faktor für Lebensphase, Kastration und Aktivität und rechnet ihn in Gramm um. Diese Methode gilt nicht für Tierarten mit dem Modell „Andere“. ### Berechnung über die Fütterungstabelle Übertragen Sie die Tabelle vom Sack: eine Zeile pro Tiergewicht mit Gramm pro Tag und der Lebensphase der Zeile. Zwischen zwei Zeilen wird interpoliert. Außerhalb der Tabelle folgt die Ration dem metabolischen Gewicht. Die Option **An das Tier anpassen** korrigiert die Ration bei erwachsenen Tieren und Senioren nach Kastration und Aktivität. Für Kaninchen, Nager und Vögel ist dies die einzige mögliche Methode. Hat der Tierarzt ein Zielgewicht festgelegt, berechnet das Modul die Ration für dieses Gewicht und nicht für das aktuelle. ## Tierarten und Rassen Unter **Tierbedarf > Tierarten und Rassen** hat jede Tierart einen Namen pro Sprache und ein **Ernährungsmodell**: Hund, Katze oder Andere (nur Fütterungstabelle). Rassen haben einen Namen pro Sprache und eine **Größe** von Zwerg bis Riesig: Bei einem Welpen legt die Größe das Erwachsenenalter fest (12 Monate bei kleinen Rassen, 18 Monate bei großen, 24 Monate bei Riesenrassen). Ohne Rasse wird die Größe aus dem Gewicht abgeleitet. Eine Tierart, die von Tieren genutzt wird, kann nicht gelöscht werden: Deaktivieren Sie sie. Wird eine Rasse gelöscht, bleiben die betroffenen Tiere ohne Rasse. ## Was der Kunde sieht ### Meine Tiere Unter Mein Konto legt der Kunde bis zu 20 Profile an: Name, Tierart, Rasse, Geschlecht, Geburtsdatum, aktuelles Gewicht, Zielgewicht, Kastration und Aktivitätsniveau. Jede Karte zeigt Alter und Lebensphase (Welpe, Kitten, erwachsen, Senior). ### Produktseite Unter dem Preis bietet der Block **Tagesration und Packungsgröße** die zum Futter passenden Tiere des Kunden an. Für die ausgewählten Tiere zeigt er die Ration in Gramm pro Tag, die empfohlene Anzahl der Mahlzeiten, die Summe bei mehreren Tieren und eine Tabelle der Größen mit Reichweite und Kilopreis. Die empfohlene Größe trägt ein Badge und einen Button **Den Sack wählen**. Eine 7-Tage-Futterumstellung zeigt die Gramm des neuen Futters Tag für Tag, mit dem Namen des bisherigen Futters, wenn er bekannt ist. Empfohlen wird die günstigste Größe pro Kilo unter den verfügbaren Größen, die mindestens die eingestellte **Mindestreichweite** erreichen, ohne die Haltbarkeit nach dem Öffnen zu überschreiten. Das Kästchen **Mich einige Tage vor Ende des Sacks per E-Mail erinnern** aktiviert die Erinnerungen für dieses Futter. Tierauswahl und Kästchen werden für die nächste Bestellung gespeichert. ### Besucher Mit dem **Rationsrechner für Besucher** gibt ein Besucher oder ein Kunde ohne Tier Tierart, Gewicht, Alter, Aktivität und Kastration ein und erhält dieselbe Empfehlung. Ein angemeldeter Kunde kann dieses Profil mit einem Namen speichern. ### Bestellbestätigung Nach einer Futterbestellung bietet ein Block an, die Erinnerungen zu aktivieren und, bei mehreren Tieren, die Tiere zu wählen, die dieses Futter fressen. Dieser Block schaltet aktive Erinnerungen nie ab: Er kann sie nur aktivieren und die Tiere festlegen. ## Nachbestellpläne Jeder Kunde hat einen Plan pro Futter. Eine Bestellung wird bei ihrer Bestätigung erfasst und dem Plan hinzugefügt, sobald ihr Status als bezahlt gilt. Der Bestand beginnt am Bestelldatum plus der **durchschnittlichen Lieferzeit** und sinkt täglich mit dem Verbrauch: - der **theoretische Verbrauch** ist die Summe der Rationen der mit dem Plan verknüpften Tiere; - bei jeder Angabe des Kunden zur Restmenge (mindestens 5 Tage nach der vorherigen) berechnet das Modul den beobachteten Verbrauch, begrenzt ihn auf das 0,4- bis 2,5-Fache des theoretischen, um Tippfehler auszuschließen, und kombiniert ihn mit der vorherigen Schätzung; - ändert der Kunde ein Tierprofil, folgt der Verbrauch im selben Verhältnis. Daraus ergibt sich das Leerdatum, und die Erinnerung wird um den **Vorlauf der Erinnerung** früher geplant. Ein Plan, dessen Sack seit 90 Tagen ohne neue Bestellung leer ist, wird geschlossen. ### Kundenbereich Unter Meine Tiere zeigt jedes verfolgte Futter eine Bestandsanzeige, die verbleibenden Tage, das geschätzte Leerdatum, das Datum der nächsten Erinnerung und den verwendeten Verbrauch. Der Kunde kann angeben, was noch da ist (leer, ein Viertel, die Hälfte, drei Viertel, ein Sack, anderthalb Säcke, zwei Säcke), die Tiere wählen, die das Futter fressen, Erinnerungen ein- oder ausschalten, nachbestellen oder die Verfolgung beenden. ## Erinnerungen und Nachbestellung Nur Pläne, deren Kunde die Erinnerungen aktiviert hat, erhalten E-Mails: - die **erste Erinnerung** geht am geplanten Tag raus; - die **Nachfass-Erinnerung** folgt nach der eingestellten Anzahl von Tagen, wenn der Kunde weder nachbestellt noch geantwortet hat (0 deaktiviert sie). Die E-Mail enthält einen Button **Nachbestellen**, drei Antwortlinks (noch etwa 2 Wochen, noch etwa 1 Woche, der Sack ist leer) und einen Link zum Pausieren der Erinnerungen. Die Antwortlinks öffnen eine Bestätigungsseite: Nichts wird gespeichert, bevor der Kunde klickt, was vor Mail-Scannern schützt, die Links öffnen. Der Button Nachbestellen verlangt die Anmeldung, füllt den Warenkorb mit derselben Größe und Menge und leitet zur Kasse weiter. Ist diese Größe ausverkauft, bietet das Modul die verfügbare Größe mit der nächstliegenden Menge an. Ist der **Nachbestellrabatt** größer als 0 und lässt der Kunde die Erinnerungen aktiviert, wird ein Einmal-Gutschein angewendet, beschränkt auf dieses Futter und für die eingestellte Anzahl von Tagen gültig (Code `PET` gefolgt von 8 Zeichen). Das Modul bucht nie beim Kunden ab: Er bezahlt die Nachbestellung mit Ihren üblichen Zahlungsarten. ## Modulkonfiguration - **Vorlauf der Erinnerung** (7 Tage): wie viele Tage vor dem geschätzten Leerdatum die Erinnerung rausgeht. Rechnen Sie Ihre Lieferzeit ein. - **Nachfass-Erinnerung** (5 Tage, 0 = aus). - **Durchschnittliche Lieferzeit** (3 Tage): Beginn des Verbrauchs eines neuen Sacks. - **Nachbestellrabatt** (5 %, 0 = kein Gutschein) und **Gültigkeit des Gutscheins** (14 Tage). - **Mindestreichweite des empfohlenen Sacks** (14 Tage) und **Standard-Haltbarkeit nach dem Öffnen** (42 Tage), bei neuen Futterprodukten vorausgefüllt. - **Rationsrechner für Besucher**, **Aufgaben über Back-Office-Aufrufe ausführen** und **Erinnerungen pro Durchlauf** (50). Werte außerhalb des zulässigen Bereichs werden automatisch auf die Grenzen gesetzt. ## Cronjob Die Konfigurationsseite zeigt eine mit Token geschützte URL. Rufen Sie sie stündlich auf, zum Beispiel: ``` 0 * * * * curl -s "https://ihr-shop.de/module/dfpetcare/cron?token=..." > /dev/null ``` Jeder Durchlauf übernimmt bezahlte Bestellungen, sendet fällige Erinnerungen und schließt inaktive Pläne. Ohne Cronjob lassen Sie die Ausführung über Back-Office-Aufrufe aktiviert: Die Aufgaben laufen dann höchstens alle 3 Stunden, wenn ein Mitarbeiter das Back-Office nutzt. Der Button **Aufgaben jetzt ausführen** startet sie bei Bedarf. ## Back-Office - **Nachbestellpläne**: Planliste, filterbar nach Kunde, E-Mail, Futter, Status, Erinnerungen und Leerdatum, als CSV exportierbar, mit den Kennzahlen des Monats (gesendete Erinnerungen, Nachbestellungen nach einer Erinnerung, Bestandsangaben). Die Planansicht zeigt die Tiere und ihre Ration, den theoretischen und den verwendeten Verbrauch, den geschätzten Bestand und den vollständigen Verlauf, und Sie können die vom Kunden gemeldete Restmenge erfassen oder die Erinnerung erneut senden. - **Tierprofile**: filterbare und exportierbare Liste für Ihre Marketingsegmente (Tierart, Rasse, Alter, Gewicht, Kastration, Kunde). - **Kundenseite**: Ein Block zeigt die Tiere und Pläne des Kunden mit einem Link zu jedem Plan. ## E-Mails und Übersetzungen Die Vorlage `dfpetcare_reorder` wird in 8 Sprachen (Französisch, Englisch, Spanisch, Deutsch, Italienisch, Niederländisch, Polnisch, Portugiesisch) als HTML und Text geliefert, mit eigenem Betreff und eigener Einleitung für die Nachfass-Erinnerung. Für jede andere installierte Sprache wird die englische Vorlage kopiert. Die Oberfläche des Moduls ist in dieselben Sprachen übersetzt. ## DSGVO Das Modul beantwortet Anfragen zum Export und zur Löschung personenbezogener Daten: Tierprofile, Pläne, verfolgte Bestellungen und gespeicherte Auswahl. Das Löschen eines Kunden löscht auch seine Daten im Modul. ## Aktualisierung von 1.0.0 Installieren Sie das ZIP 1.1.0 über die bestehende Version. Das Update-Skript ergänzt das Datum der letzten Erinnerung, aktiviert die Nachfass-Erinnerung mit 5 Tagen, registriert die Hooks der Bestellbestätigung und der Kundenseite und behält Ihre Tiere, Futterprodukte und Pläne. ## Häufige Fragen ### Der Rationsblock erscheint nicht auf der Produktseite Prüfen Sie, ob das Produkt in den Futtereinstellungen angelegt und aktiviert ist, ob eine Energie oder eine Tabelle eingetragen ist und ob der Kunde ein Tier einer passenden Art hat. Ohne Tier erscheint der Rechner nur, wenn er aktiviert ist. ### Die Reichweite der Säcke wird nicht angezeigt Das Nettogewicht der Variante fehlt. Tragen Sie es in den Futtereinstellungen ein. ### Es wird keine Erinnerung gesendet Prüfen Sie, ob der Kunde die Erinnerungen für dieses Futter aktiviert hat, ob der Cronjob läuft (Datum der letzten Ausführung auf der Konfigurationsseite) und ob die E-Mails des Shops funktionieren. Der Button Erinnerung jetzt senden in der Planansicht zeigt einen Fehler, wenn der Versand scheitert. ### Was passiert bei der Deinstallation? Die Tabellen des Moduls werden gelöscht: Tiere, Futterprodukte, Pläne und Verläufe. Bereits erstellte Gutscheine bleiben in den Warenkorbregeln erhalten.