Blueberry Studio

BlueReports: automatyczny raport sprzedaży

Moduł, który sam wysyła na e-mail raport sprzedaży (codziennie, co tydzień, co miesiąc i co rok). Ta instrukcja prowadzi za rękę, krok po kroku, bez wiedzy technicznej.

Moduł bluereports • wersja 3.2.1 • PrestaShop 1.7 – 9.x

1.Co dokładnie robi moduł

BlueReports przygotowuje i wysyła e-mailem podsumowania sprzedaży. Masz do dyspozycji cztery rodzaje raportów, każdy można włączyć lub wyłączyć osobno:

Każdy e-mail zawiera: liczbę zamówień, łączny przychód, średnią wartość zamówienia, liczbę sprzedanych produktów oraz tabelę najlepiej sprzedających się produktów (nazwa, ilość, przychód, udział). Dodatkowo w panelu możesz w każdej chwili obejrzeć raport za dowolny okres i pobrać go jako plik HTML.

2.Instalacja / aktualizacja modułu

Jeśli moduł nie jest jeszcze w sklepie, wgrywasz go z pliku ZIP. Jeśli już jest, robisz to samo, a sklep sam wykona aktualizację.

1. Zaloguj się do panelu administracyjnego sklepu.
2. Z menu po lewej wybierz Moduły → Menedżer modułów.
3. W prawym górnym rogu kliknij przycisk „Prześlij moduł” (lub „Wgraj nowy moduł”).
4. Przeciągnij plik bluereports_szok_GOTOWY.zip albo kliknij i wskaż go na dysku.
5. Poczekaj na komunikat o powodzeniu. Jeśli moduł już istniał, zobaczysz informację, że został zaktualizowany.
6. Jeśli widzisz przycisk „Zainstaluj” przy module, kliknij go.

3.Jak wejść w konfigurację

1. W panelu wejdź w Moduły → Menedżer modułów.
2. W polu wyszukiwania wpisz BlueReports.
3. Przy module kliknij „Konfiguruj”.

Otworzy się strona z dwoma formularzami: na górze ustawienia wyglądu, niżej raporty cykliczne (wysyłka e-mail).

4.Ustawienia wyglądu raportu

To kosmetyka, wpływa na to, jak wygląda raport. Ustaw raz i zapomnij.

Na koniec kliknij „Zapisz” pod tym formularzem.

5.Raporty cykliczne: e-mail i przełączniki

To jest sedno modułu. Tu ustawiasz, na jaki adres i jakie raporty mają przychodzić.

1. W polu „Email odbiorcy” wpisz adres, na który mają trafiać raporty, np. kontakt@odziezowyszokcenowy.pl. Możesz podać kilka adresów, oddziel je przecinkami.
2. Włącz przełączniki raportów, których chcesz używać. Dla wymogu „raport co 24h” ustaw Raport dzienny na Tak.
3. Kliknij „Zapisz ustawienia”.

6.Cron: uruchom raport automatycznie (krok po kroku)

Cron to ustawienie na serwerze (w panelu hostingu), które codziennie o wybranej godzinie samo otwiera adres modułu. Robisz to tylko raz.

6.1. Skopiuj swój adres (URL) crona

1. Wróć do konfiguracji modułu (krok 3), do sekcji raporty cykliczne.
2. Znajdź pole z gotowym adresem i kliknij przycisk „Kopiuj” obok niego.

Adres wygląda mniej więcej tak (Twój będzie miał inny token na końcu):

https://twoj-sklep.pl/modules/bluereports/cron/cron.php?token=TUTAJ_DŁUGI_CIĄG_ZNAKÓW

6.2. Dodaj zadanie cron w panelu hostingu

Wejdź do panelu swojego hostingu (np. cPanel / DirectAdmin). Szukaj sekcji „Cron” lub „Zadania cron”.

1. Kliknij „Dodaj nowe zadanie cron”.
2. Ustaw częstotliwość na codziennie o 6:00 rano. W polach czasu wybierz: minuta 0, godzina 6, reszta „każdy / *”.
3. W polu komendy wklej (zamiast adresu wstaw swój skopiowany URL):

curl -s "https://twoj-sklep.pl/modules/bluereports/cron/cron.php?token=TWÓJ_TOKEN" > /dev/null

4. Zapisz zadanie.

7.Wyślij raport testowy (sprawdzenie)

Nie czekaj do następnego dnia, żeby sprawdzić czy działa. Jest do tego przycisk.

1. Upewnij się, że w sekcji raportów cyklicznych wpisałeś i zapisałeś adres e-mail odbiorcy.
2. Kliknij przycisk „Wyślij raport testowy”.
3. Zobaczysz zielony komunikat, że raport został wysłany.
4. Sprawdź skrzynkę e-mail (również folder SPAM). Powinien przyjść raport z dopiskiem [TEST].

8.Raporty w panelu: podgląd i eksport

Oprócz e-maili możesz oglądać sprzedaż na bieżąco w panelu.

1. W menu wejdź w Blueberry Reports (sekcja Sprzedaż/Statystyki), albo w konfiguracji modułu kliknij „Przejdź do raportów”.
2. U góry ustaw zakres dat od–do i potwierdź.
3. Zobaczysz podsumowanie, top produkty i listę transakcji.
4. Przycisk „Eksport HTML” pobiera raport jako plik, który możesz zapisać lub wydrukować.
5. Zakładka „Porównaj okresy” pozwala zestawić dwa okresy obok siebie (np. ten miesiąc vs poprzedni).

9.Najczęstsze pytania i problemy

Raporty nie przychodzą na e-mail

• Sprawdź, czy cron jest dodany w panelu hostingu i czy adres (URL z tokenem) jest poprawny.
• Sprawdź, czy w module jest włączony Raport dzienny i wpisany adres e-mail.
• Zrób raport testowy (krok 7), jeśli on dochodzi, a cykliczne nie, problem leży po stronie crona.
• Zajrzyj do folderu SPAM.

Raport testowy zgłasza błąd wysyłki

• To ustawienia poczty sklepu. Wejdź w Ustawienia zaawansowane → E-mail i skonfiguruj SMTP (dla tego sklepu serwer poczty to host296736.hostido.net.pl, port 587).
• Wyślij e-mail testowy z tej strony, musi dojść, zanim moduł zacznie działać.

Raport przyszedł, ale jest pusty / brak produktów

• To znaczy, że w danym okresie nie było opłaconych zamówień. Moduł liczy tylko zamówienia opłacone (pomija anulowane i zwrócone). Po pierwszej realnej sprzedaży raport się wypełni.

Zmieniłem token: i raporty przestały chodzić

• Po regeneracji tokena zmienia się adres URL. Musisz zaktualizować komendę w cronie nowym adresem (skopiuj go ponownie z konfiguracji).

O której godzinie przychodzi raport?

• O tej, na którą ustawisz cron (sugerujemy 6:00 rano: raport dzienny podsumowuje poprzedni dzień).