Masowa aktualizacja produktów

Dokumentacja CC Masowa Aktualizacja Produktów

1. Wprowadzenie
2. Instalacja
3. Aktywacja licencji
4. Panel zarządzania
5. Import plików
6. Masowa aktualizacja według kryteriów
7. Zadania CRON
8. System logowania
9. Typy identyfikatorów produktów
10. Mapowanie kolumn
11. Rozwiązywanie problemów
12. FAQ

1. Wprowadzenie

• Import z plików CSV, XLS, XLSX z różnych źródeł (upload, serwer, URL)
• Masową aktualizację produktów według kryteriów (kategorie, cenowy zakres, producent)
• Obsługę zadań CRON w dwóch trybach (konfiguracja i parametry URL)
• Wsparcie różnych typów identyfikatorów produktów (ID, EAN, UPC, ISBN, MPN, Reference, GTIN)
• Zaawansowany system logowania operacji
• Intuicyjne mapowanie kolumn z podglądem pliku
• Walidację i kontrolę błędów
• System zarządzania licencjami
• Zapamiętywanie ustawień użytkownika

2. Instalacja

• PrestaShop 1.7 lub nowszy
• PHP 7.1 lub nowszy
• Rozszerzenie PHP: PhpSpreadsheet (dla plików Excel)
• Minimalna ilość pamięci: 128MB
• Uprawnienia do tworzenia katalogów tymczasowych

1. Pobierz plik ZIP modułu z oficjalnego sklepu cocos.codes
2. Zaloguj się do panelu administracyjnego PrestaShop
3. Przejdź do: Moduły → Menedżer modułów → Dodaj nowy moduł
4. Kliknij „Dodaj moduł” i wybierz pobrany plik ZIP
5. Po zakończeniu instalacji kliknij „Konfiguruj”
6. Moduł automatycznie utworzy katalogi tymczasowe i zainstaluje wymagane ustawienia

3. Aktywacja licencji

1. Po instalacji przejdź do konfiguracji modułu
2. Wybierz zakładkę „Licencja”
3. Wprowadź klucz licencyjny otrzymany po zakupie
4. Kliknij „Aktywuj licencję”
5. Po pomyślnej aktywacji zobaczysz komunikat potwierdzający i odblokowane zostaną wszystkie funkcje

4. Panel zarządzania

• Import pliku – import danych z plików CSV/Excel
• Masowa aktualizacja – aktualizacja produktów według kryteriów
• Zadania CRON – konfiguracja automatyzacji
• Logi – podgląd i zarządzanie logami operacji

• Ustawienia – konfiguracja ogólna modułu
• Dokumentacja – link do instrukcji online
• Wsparcie – dostęp do pomocy technicznej
• Wtyczki – informacje o dodatkowych rozszerzeniach
• Licencja – zarządzanie licencją modułu

5. Import plików

• Upload pliku – przesłanie pliku bezpośrednio z komputera
• Ścieżka na serwerze – wskazanie pliku znajdującego się na serwerze
• URL do pliku – pobranie pliku z zewnętrznego adresu URL

• CSV (z automatycznym wykrywaniem separatora: , ; | tab)
• XLS (starsze pliki Excel)
• XLSX (nowsze pliki Excel)

1. Wybierz źródło pliku
2. Wskaż plik (upload, ścieżka lub URL)
3. Wybierz typ identyfikatora produktu
4. Określ, czy plik zawiera nagłówki
5. Kliknij „Podgląd i mapowanie”
6. Zmapuj kolumny z danymi (identyfikator, ilość, cena)
7. Kliknij „Wykonaj import”

• Maksymalny rozmiar pliku: 10MB (konfigurowalny)
• Sprawdzanie formatu i integralności pliku
• Walidacja struktury danych
• Kontrola dostępności plików zewnętrznych

6. Masowa aktualizacja według kryteriów

• Kategorie – wybór produktów z określonych kategorii
• Zakres ID produktów – od określonego ID do określonego ID
• Zakres cenowy – produkty o cenach w określonym przedziale
• Producent – produkty określonego producenta
• Status – aktywne lub nieaktywne produkty

• Nowa ilość – ustawienie określonej ilości dla wszystkich wybranych produktów
• Nowa cena – ustawienie określonej ceny dla wszystkich wybranych produktów
• Można aktualizować jednocześnie ilość i cenę lub tylko jeden z parametrów

1. Wybierz kryteria selekcji produktów
2. Określ nowe wartości (ilość i/lub cena)
3. Kliknij „Aktualizuj produkty”
4. System pokaże liczbę zaktualizowanych produktów i ewentualne błędy

7. Zadania CRON

• Zapisanie ustawień w bazie danych
• Jedno zadanie CRON dla wszystkich automatycznych aktualizacji
• Łatwa konfiguracja przez interfejs webowy
• URL zadania: /modules/cc_ps_mass_update_product/controllers/front/cron.php?token=…

• Przekazywanie wszystkich parametrów bezpośrednio w URL
• Możliwość tworzenia wielu różnych zadań CRON
• Elastyczność konfiguracji dla zaawansowanych użytkowników
• Każde zadanie może mieć inne ustawienia

1. Włącz „Zadania CRON”
2. Wybierz źródło pliku (serwer lub URL)
3. Wskaż ścieżkę lub URL do pliku
4. Skonfiguruj typ identyfikatora i mapowanie kolumn
5. Zapisz ustawienia
6. Dodaj URL do crontab serwera

• token – token bezpieczeństwa (wymagany)
• source – źródło pliku (server|url)
• file_path – ścieżka do pliku na serwerze
• file_url – URL do pliku
• identifier_type – typ identyfikatora produktu
• has_header – czy plik zawiera nagłówki (1|0)
• mapping_identifier – numer kolumny z identyfikatorem
• mapping_quantity – numer kolumny z ilością
• mapping_price – numer kolumny z ceną

# Codziennie o 2:00 - tryb konfiguracji
0 2 * * * /usr/bin/curl "https://sklep.pl/modules/cc_ps_mass_update_product/controllers/front/cron.php?token=abc123"
Codziennie o 3:00 - aktualizacja ilości z serwera
0 3 * * * /usr/bin/curl "https://sklep.pl/modules/cc_ps_mass_update_product/controllers/front/cron.php?token=abc123&source=server&file_path=/var/www/files/quantities.csv&identifier_type=ean&has_header=1&mapping_identifier=0&mapping_quantity=1"
Codziennie o 4:00 - aktualizacja cen z URL
0 4 * * * /usr/bin/curl "https://sklep.pl/modules/cc_ps_mass_update_product/controllers/front/cron.php?token=abc123&source=url&file_url=https://dostawca.pl/prices.csv&identifier_type=reference&has_header=1&mapping_identifier=0&mapping_price=2"

8. System logowania

• Automatyczne logowanie wszystkich operacji aktualizacji
• Różne poziomy logowania (INFO, WARNING, ERROR)
• Oddzielne pliki logów dla każdego dnia
• Podgląd logów bezpośrednio w panelu administracyjnym
• Możliwość pobierania pełnych plików logów
• Automatyczne czyszczenie starych logów

• Status logowania – włączenie/wyłączenie zapisywania logów
• Lista plików logów – przegląd wszystkich plików z datami i rozmiarami
• Podgląd logów – wyświetlanie ostatnich 200 linii z kolorowaniem według poziomu
• Pobieranie logów – download pełnych plików logów
• Czyszczenie starych logów – usuwanie logów starszych niż 30 dni

[2025-01-15 14:30:22] [INFO] Rozpoczynam masową aktualizację z pliku: /var/www/files/products.csv
[2025-01-15 14:30:23] [INFO] Zaktualizowano ilość produktu: ID 123, Ilość: 50
[2025-01-15 14:30:23] [WARNING] Produkt nie znaleziony po kodzie EAN: 1234567890123
[2025-01-15 14:30:25] [INFO] Masowa aktualizacja zakończona | Context: {"success":45,"failed":2}

9. Typy identyfikatorów produktów

• ID produktu – najszybszy, ale wymagający znajomości wewnętrznych ID
• Reference/SKU – najczęściej używany w sklepach internetowych
• EAN – standard dla produktów fizycznych
• GTIN – uniwersalny, sprawdza wszystkie możliwe kody kreskowe

10. Mapowanie kolumn

1. Po wybraniu pliku system pokazuje podgląd pierwszych 5 wierszy
2. Użytkownik wskazuje, która kolumna zawiera identyfikator produktu
3. Opcjonalnie wskazuje kolumny z ilością i/lub ceną
4. System waliduje poprawność mapowania
5. Po zatwierdzeniu następuje import danych

• Kolumna identyfikatora – zawsze wymagana
• Kolumna ilości – opcjonalna (liczby całkowite ≥ 0)
• Kolumna ceny – opcjonalna (liczby rzeczywiste ≥ 0, max 2 miejsca po przecinku)
• Minimum jedna z kolumn (ilość lub cena) musi być zmapowana
• Kolumny nie mogą być identyczne

• Moduł automatycznie zapamiętuje ostatnie mapowania w localStorage
• Mapowania są przywracane dla plików o identycznej strukturze
• Każde mapowanie zawiera informację o typie identyfikatora i nagłówkach
• Mapowania są ważne przez 7 dni
• Możliwość ręcznego wyczyszczenia zapamiętanych ustawień

ean,nazwa,ilosc,cena
1234567890123,"Produkt A",50,19.99
1234567890124,"Produkt B",30,29.99
1234567890125,"Produkt C",0,39.99

11. Rozwiązywanie problemów

1. Sprawdź, czy moduł ma aktywną licencję
2. Upewnij się, że plik ma obsługiwany format (CSV, XLS, XLSX)
3. Sprawdź rozmiar pliku (domyślnie max 10MB)
4. Dla plików z serwera sprawdź uprawnienia do odczytu
5. Dla URL sprawdź dostępność i poprawność adresu
6. Sprawdź logi modułu w poszukiwaniu szczegółów błędu

1. Sprawdź poprawność mapowania kolumn
2. Zweryfikuj typ identyfikatora produktu
3. Upewnij się, że identyfikatory w pliku są poprawne
4. Sprawdź, czy produkty istnieją w sklepie
5. Zweryfikuj format danych (liczby dla ilości i cen)
6. Przejrzyj logi w poszukiwaniu ostrzeżeń

1. Sprawdź poprawność tokena bezpieczeństwa
2. Upewnij się, że cron jest włączony w konfiguracji (tryb konfiguracji)
3. Zweryfikuj dostępność pliku źródłowego
4. Sprawdź logi zadań CRON na serwerze
5. Upewnij się, że URL zadania CRON jest poprawny
6. Sprawdź, czy serwer może wykonywać zapytania HTTP

1. Zmniejsz rozmiar importowanych plików
2. Zwiększ limit czasu wykonania PHP (max_execution_time)
3. Zwiększ limit pamięci PHP (memory_limit)
4. Wyłącz logowanie dla bardzo dużych importów
5. Użyj zadań CRON zamiast importu przez przeglądarkę
6. Podziel duże pliki na mniejsze części

12. FAQ