# Moduł Sklep Zoologiczny dla PrestaShop: dokumentacja modułu > Ten moduł dodaje do PrestaShop 8 i 9 profile zwierząt na koncie klienta, obliczanie dawki i rekomendację opakowania na stronach karmy oraz plany uzupełniania, które wysyłają przypomnienie przed końcem worka,… - Strona: - Język: pl - Zaktualizowano: 2026-09-24 - Inne języki: [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), [de](https://www.datafirefly.com/de/documentation/dfpetcare/index.md), [it](https://www.datafirefly.com/it/documentation/dfpetcare/index.md), [nl](https://www.datafirefly.com/nl/documentation/dfpetcare/index.md), [pt](https://www.datafirefly.com/pt/documentation/dfpetcare/index.md) - Indeks: Ten moduł dodaje do PrestaShop 8 i 9 profile zwierząt na koncie klienta, obliczanie dawki i rekomendację opakowania na stronach karmy oraz plany uzupełniania, które wysyłają przypomnienie przed końcem worka, liczone na podstawie rzeczywistego zużycia klienta. Nazwa techniczna: `dfpetcare`. ## Instalacja 1. W **Moduły > Menedżer modułów** kliknij **Załaduj moduł** i upuść plik ZIP. 2. Moduł tworzy swoje tabele i trzy gatunki z rasami: pies (32 rasy), kot (12 ras) i królik (2 rasy). 3. Pojawia się menu **Sprzedaż > Zoologia** z czterema stronami: **Ustawienia karmienia**, **Plany uzupełniania**, **Profile zwierząt** i **Gatunki i rasy**. Na stronie Moje konto klienta dodawany jest link **Moje zwierzęta**. 4. Zaplanuj adres URL cron widoczny na stronie konfiguracji modułu (patrz niżej). ## Ustawienia karm Blok dawki wyświetlają tylko produkty dodane w **Zoologia > Ustawienia karmienia**. Kliknij **Dodaj**, wyszukaj produkt po nazwie, indeksie lub ID i uzupełnij: - **Dla**: gatunki, których dotyczy karma. Na stronie produktu proponowane są tylko zwierzęta tych gatunków. Zostaw puste dla wszystkich. - **Etap życia** karmy (każdy wiek, wzrost, dorosły, senior): gdy zwierzę klienta jest na innym etapie, pojawia się ostrzeżenie. - **Obliczenie**: według energii lub według tabeli dawkowania (patrz niżej). - **Trwałość po otwarciu** w dniach: worki, które byłyby otwarte dłużej, nie są polecane. 0 = bez limitu. - **Waga netto**: dla produktu z kombinacjami waga każdej kombinacji w gramach. Przycisk **Uzupełnij z nazw kombinacji** przejmuje wagi odczytane z nazw (`12 kg`, `400 g`, `12 x 85 g`). Zostaw puste kombinacje, które nie są karmą. Dla produktu prostego wpisz łączną wagę netto. ### Obliczenie według energii Wpisz energię metaboliczną karmy w kcal/kg (karma sucha: zwykle 3400 do 4200, mokra: 700 do 1200). Dla psa lub kota moduł oblicza spoczynkowe zapotrzebowanie energetyczne (70 × waga0,75), mnoży je przez współczynnik zależny od etapu życia, sterylizacji i aktywności, a następnie przelicza na gramy. Ta metoda nie dotyczy gatunków ustawionych jako „Inny”. ### Obliczenie według tabeli dawkowania Przepisz tabelę z worka: jeden wiersz na wagę zwierzęcia z gramami dziennie i etapem życia wiersza. Między dwoma wierszami dawka jest interpolowana. Poza tabelą zależy od masy metabolicznej. Opcja **Dostosuj do zwierzęcia** koryguje dawkę dorosłych i seniorów według sterylizacji i aktywności. To jedyna możliwa metoda dla królików, gryzoni i ptaków. Gdy weterynarz ustalił wagę docelową, moduł liczy dawkę dla tej wagi, a nie dla obecnej. ## Gatunki i rasy W **Zoologia > Gatunki i rasy** każdy gatunek ma nazwę w każdym języku i **model żywieniowy**: pies, kot lub inny (tylko tabela dawkowania). Rasy mają nazwę w każdym języku i **rozmiar** od miniaturowego do olbrzymiego: u szczenięcia rozmiar określa wiek dorosły (12 miesięcy dla małych ras, 18 miesięcy dla dużych, 24 miesiące dla olbrzymich). Bez rasy rozmiar wynika z wagi. Gatunku używanego przez zwierzęta nie można usunąć: wyłącz go. Usunięcie rasy pozostawia dane zwierzęta bez rasy. ## Co widzi klient ### Moje zwierzęta Z poziomu Moje konto klient tworzy do 20 profili: imię, gatunek, rasa, płeć, data urodzenia, obecna waga, waga docelowa, sterylizacja i poziom aktywności. Każda karta pokazuje wiek i etap życia (szczenię, kocię, dorosły, senior). ### Strona produktu Pod ceną blok **Dzienna dawka i opakowanie** proponuje zwierzęta klienta pasujące do karmy. Dla zaznaczonych zwierząt pokazuje dawkę w gramach dziennie, zalecaną liczbę posiłków, sumę przy kilku zwierzętach oraz tabelę opakowań z czasem starczenia i ceną za kilogram. Zalecane opakowanie ma znaczek i przycisk **Wybierz worek**. Siedmiodniowy przewodnik zmiany karmy podaje gramy nowej karmy dzień po dniu, z nazwą obecnej karmy zwierzęcia, jeśli jest znana. Zalecane jest najtańsze opakowanie za kilogram spośród dostępnych, które starcza co najmniej na ustawiony **minimalny czas**, bez przekraczania trwałości po otwarciu. Pole **Wyślij mi e-mail kilka dni przed końcem worka** włącza przypomnienia dla tej karmy. Wybór zwierząt i pole są zapamiętywane do następnego zamówienia. ### Odwiedzający Dzięki **kalkulatorowi dawki dla odwiedzających** odwiedzający lub klient bez zwierząt podaje gatunek, wagę, wiek, aktywność i sterylizację i otrzymuje tę samą rekomendację. Zalogowany klient może zapisać ten profil, nadając mu imię. ### Strona potwierdzenia zamówienia Po zamówieniu karmy blok proponuje włączenie przypomnień oraz, gdy klient ma kilka zwierząt, wybór tych, które jedzą tę karmę. Ten blok nigdy nie wyłącza aktywnych przypomnień: może je tylko włączyć i wskazać zwierzęta. ## Plany uzupełniania Każdy klient ma jeden plan na karmę. Zamówienie jest zapisywane przy zatwierdzeniu i dodawane do planu, gdy jego status oznacza opłacenie. Zapas startuje od daty zamówienia plus **średni czas dostawy** i maleje codziennie według zużycia: - **zużycie teoretyczne** to suma dawek zwierząt przypisanych do planu; - przy każdej odpowiedzi klienta o pozostałej ilości (co najmniej 5 dni po poprzedniej) moduł oblicza zużycie rzeczywiste, ogranicza je do przedziału od 0,4 do 2,5 zużycia teoretycznego, aby odrzucić błędy wpisu, i łączy je z poprzednim szacunkiem; - gdy klient zmienia profil zwierzęcia, zużycie zmienia się w tej samej proporcji. Z tego wynika data końca worka, a przypomnienie jest planowane z ustawionym **wyprzedzeniem przypomnienia**. Plan, którego worek jest pusty od 90 dni bez nowego zamówienia, zostaje zamknięty. ### Panel klienta W Moje zwierzęta każda śledzona karma pokazuje wskaźnik zapasu, pozostałe dni, szacowaną datę końca, datę następnego przypomnienia i przyjęte zużycie. Klient może podać, ile zostało (pusty, ćwierć, pół, trzy czwarte, jeden worek, półtora worka, dwa worki), wybrać zwierzęta jedzące tę karmę, włączyć lub wyłączyć przypomnienia, zamówić ponownie lub przestać śledzić karmę. ## Przypomnienia i ponowne zamówienie E-maile otrzymują tylko plany, w których klient włączył przypomnienia: - **pierwsze przypomnienie** wychodzi w zaplanowanym dniu; - **ponowne przypomnienie** wychodzi po ustawionej liczbie dni, jeśli klient nie zamówił ani nie odpowiedział (0 je wyłącza). E-mail zawiera przycisk **Zamów ponownie**, trzy linki odpowiedzi (zostały ok. 2 tygodnie, ok. 1 tydzień, worek jest pusty) oraz link do wstrzymania przypomnień. Linki odpowiedzi otwierają stronę potwierdzenia: nic nie jest zapisywane, dopóki klient nie kliknie, co chroni przed skanerami poczty otwierającymi linki. Przycisk Zamów ponownie wymaga zalogowania, wypełnia koszyk tym samym opakowaniem i ilością i przekierowuje do zamówienia. Jeśli to opakowanie jest niedostępne, moduł proponuje dostępne opakowanie o najbliższej ilości. Jeśli **rabat na uzupełnienie** jest większy od 0, a klient ma włączone przypomnienia, naliczany jest jednorazowy kupon ograniczony do tej karmy i ważny przez ustawioną liczbę dni (kod `PET` i 8 znaków). Moduł nigdy nie obciąża klienta: płaci on za zamówienie Twoimi zwykłymi metodami płatności. ## Konfiguracja modułu - **Wyprzedzenie przypomnienia** (7 dni): ile dni przed szacowanym końcem wychodzi przypomnienie. Uwzględnij czas dostawy. - **Ponowne przypomnienie** (5 dni, 0 = wyłączone). - **Średni czas dostawy** (3 dni): początek zużycia nowego worka. - **Rabat na uzupełnienie** (5%, 0 = bez kuponu) i **ważność kuponu** (14 dni). - **Minimalny czas starczenia polecanego worka** (14 dni) i **domyślna trwałość po otwarciu** (42 dni), wpisywana w nowych karmach. - **Kalkulator dawki dla odwiedzających**, **uruchamianie zadań przy ruchu w panelu** i **przypomnienia na uruchomienie** (50). Wartości spoza zakresu są automatycznie sprowadzane do dozwolonych granic. ## Zadanie cron Strona konfiguracji pokazuje adres URL chroniony tokenem. Wywołuj go co godzinę, na przykład: ``` 0 * * * * curl -s "https://twoj-sklep.pl/module/dfpetcare/cron?token=..." > /dev/null ``` Każde uruchomienie dołącza opłacone zamówienia, wysyła należne przypomnienia i zamyka nieaktywne plany. Bez crona zostaw włączone uruchamianie przy ruchu w panelu: zadania działają wtedy najwyżej co 3 godziny, gdy pracownik korzysta z panelu. Przycisk **Uruchom zadania teraz** uruchamia je na żądanie. ## Panel administracyjny - **Plany uzupełniania**: lista planów z filtrami (klient, e-mail, karma, status, przypomnienia, data końca), eksport do CSV i wskaźniki miesiąca (wysłane przypomnienia, zamówienia po przypomnieniu, odczyty zapasu). Widok planu pokazuje zwierzęta i ich dawki, zużycie teoretyczne i przyjęte, szacowany zapas i pełną historię, a także pozwala wpisać zapas podany przez klienta lub ponownie wysłać przypomnienie. - **Profile zwierząt**: lista z filtrami i eksportem dla segmentów marketingowych (gatunek, rasa, wiek, waga, sterylizacja, klient). - **Strona klienta**: blok pokazuje jego zwierzęta i plany z linkiem do każdego planu. ## E-maile i tłumaczenia Szablon `dfpetcare_reorder` jest dostarczany w 8 językach (francuski, angielski, hiszpański, niemiecki, włoski, niderlandzki, polski, portugalski), w HTML i tekście, z osobnym tematem i wstępem dla ponownego przypomnienia. Dla innego zainstalowanego języka kopiowany jest szablon angielski. Interfejs modułu jest przetłumaczony na te same języki. ## RODO Moduł obsługuje żądania eksportu i usunięcia danych osobowych: profile zwierząt, plany, śledzone zamówienia i zapisane wybory. Usunięcie klienta usuwa też jego dane w module. ## Aktualizacja z wersji 1.0.0 Zainstaluj ZIP 1.1.0 na istniejącej wersji. Skrypt aktualizacji dodaje datę ostatniego przypomnienia, włącza ponowne przypomnienie po 5 dniach, podpina hooki strony potwierdzenia zamówienia i strony klienta oraz zachowuje zwierzęta, karmy i plany. ## Najczęstsze pytania ### Blok dawki nie pojawia się na stronie produktu Sprawdź, czy produkt jest dodany i włączony w Ustawieniach karmienia, czy wpisano energię lub tabelę i czy klient ma zwierzę pasującego gatunku. Bez zwierząt kalkulator pojawia się tylko wtedy, gdy jest włączony. ### Czas starczenia worków nie jest wyświetlany Brakuje wagi netto kombinacji. Uzupełnij ją w Ustawieniach karmienia. ### Nie są wysyłane żadne przypomnienia Sprawdź, czy klient włączył przypomnienia dla tej karmy, czy cron działa (data ostatniego uruchomienia na stronie konfiguracji) i czy e-maile sklepu działają. Przycisk Wyślij przypomnienie teraz w widoku planu pokazuje błąd, jeśli wysyłka się nie powiedzie. ### Co dzieje się przy odinstalowaniu? Tabele modułu są usuwane: zwierzęta, karmy, plany i historie. Utworzone już kupony pozostają w regułach koszyka.