Moduł PrestaShop do dropshippingu TRAINING-DISTRIBUTION
🌐 Katalog źródłowy dostępny w: 
🇫🇷 Katalog 100% natywnie francuski. Bez automatycznego tłumaczenia: teksty napisane bezpośrednio w FR przez dostawcę, idealny dla sklepów 🇫🇷 FR / 🇧🇪 BE / 🇨🇭 CH / 🇨🇦 CA.
💪 🏋️ 🔥
Moduł Training-Distribution Dropshipping Sport
Moduł, który automatyzuje od A do Z Twój dropshipping cross-training, fitness i odżywek sportowych na PrestaShop
PrestaShop 1.7 → 9.x · 2 300 produktów · 32 marki · 10 kategorii sportowych · CRON 24/7
Uruchamiasz sklep ze sprzętem do treningu siłowego, stronę cross-training, e-commerce z odżywkami sportowymi lub odzieżą sportową? Pracujesz z Training-Distribution (francuskim hurtownikiem specjalizującym się w Cross Training i fitness) i spędzasz dni przepisując 2 300 kart produktowych, ręcznie wgrywając wiele zdjęć na produkt, odtwarzając każdy rozmiar/kolor jako osobny produkt (ponieważ referencje dostawcy zmieniają się między rozmiarami), mapując każdą kategorię do odpowiednich sekcji swojego drzewa?
Z Modułem Training-Distribution dropshipping sport cross-training fitness wszystko staje się automatyczne. Wprowadzasz URL CSV Training-Distribution, klikasz "Uruchom import", a moduł tworzy Twoje 2 300 produktów PrestaShop po francusku z rozmiarem + kolorem w tytule, ich N zdjęciami z pojedynczej komórki CSV, ich natywną referencją, w drzewie 10 kategorii sportowych gotowych do użycia (Odzież Damska, Odzież Sportowa, Buty, Skarpetki, Dłonie & Uchwyty, Ochrona ciała, Liny & Ciężary, Odżywki & Suplementy, Akcesoria sportowe, Inne).
⚡ Przed vs Po Module Training-Distribution
| Zadanie |
❌ Bez modułu |
✅ Z modułem |
| Import 2 300 referencji sportowych | 80h+ ręcznie, kopiowanie z portalu Training-Distribution | 1 klik, ~2h w tle |
| Kolor + Rozmiar w tytule | Ręczne wprowadzenie „Stabilizatory kolan Czarny Rozmiar XL" na końcu tytułu | Auto-dodanie „— Kolor · Rozmiar XX" + obcięcie 128 znaków |
| Multi-obrazy z pojedynczej komórki | Ręczne parsowanie URL połączonych przecinkami | Auto split + walidacja, 1. = cover |
| Pusty opis CSV (brak dostarczony) | Karty-widma, słabe SEO, współczynnik odrzuceń | Auto-generacja strukturalnego HTML nazwa + marka + kat |
| Pojedyncza kategoria CSV (1 poziom) | Ręczne tworzenie spójnego drzewa sportowego | 10 kat głównych + 42 podkat utworzonych przy instalacji |
| Kodowanie ISO-8859-1 (nie UTF-8) | Uszkodzone francuskie znaki („Mapalé", „Genouillères") | Automatyczna konwersja komórka po komórce |
| Symbol € źle zakodowany (¤ w ISO) | Ceny z „¤" lub błędy importu | ¤ usuwany automatycznie, czyste ceny |
| Oryginalny obraz BO PrestaShop 9 | Uszkodzony obraz BO PS9 (oficjalny bug) | Fix BO PS9 dołączony: kopia 1:1 oryginalnego pliku |
| Odświeżenie cen/stanów | Robić wszystko od zera każdego dnia | Automatyczny tryb light: aktualizacja tylko cen+stanów |
👤 Do kogo skierowany jest ten moduł?
🏋️
E-commerce Cross Training & Fitness
Sprzedajesz sprzęt cross-training (stabilizatory kolan, pasy, uchwyty, skakanki, talerze bumper, taśmy), odzież treningową, buty Podnoszenia Ciężarów. Training-Distribution jest referencją FR w tych niszach z ROKFIT, REHBAND, PICSIL, VELITES jako flagowymi markami.
💪
Sklep z treningiem siłowym
Oferujesz akcesoria siłowe i kulturystyczne: pasy siłowe, ochraniacze nadgarstków, stabilizatory kolan, kamizelki obciążeniowe, podnoszenie ciężarów. ~150 referencji konkretnie do treningu siłowego w katalogu.
🥤
E-commerce odżywek sportowych
Białka, BCAA, pre-workout, przekąski białkowe (BAREBELLS, NOCCO), napoje energetyczne, omega 3 i suplementy diety sportowe. ~150 referencji odżywczych dla pełnej francuskojęzycznej oferty.
🎯 Pełne funkcje Modułu Training-Distribution
🎨 Kolor + Rozmiar dodane do tytułu — Innowacja Training-Distribution
Cecha CSV Training-Distribution. W przeciwieństwie do innych dostawców, „Referencja" zmienia się dla każdego rozmiaru (np. `R_N_GEN_0535_XS`, `_S`, `_M`, `_L`, `_XL` — wszystkie różne). Co gorsza: spójność nie jest nawet zagwarantowana przy obcinaniu (linia L ma `R-N_GEN_0535_L` z myślnikiem zamiast podkreślenia). Konsekwencja: niemożliwe pogrupowanie kilku linii w 1 produkt z jego combinations PS.
Rozwiązanie przyjęte przez moduł: 1 linia CSV = 1 odrębny produkt PS, a kolor + rozmiar są automatycznie dodawane do tytułu produktu z dopracowanym formatem graficznym.
Przykład:
"Para Stabilizatorów Kolan Czarny 5 mm | REHBAND" + Kolor "Czarny" + Rozmiar "XL"
→ "Para Stabilizatorów Kolan Czarny 5 mm | REHBAND — Czarny · Rozmiar XL"
- Automatyczne obcinanie do max 128 znaków (limit
Product::name PS): jeśli złączony tytuł przekracza, oryginalny tytuł jest obcinany z „…", aby zostawić miejsce na kolor + rozmiar w całości
- UTF-8 safe: obcinanie używa
mb_substr(), nigdy nie cięte w środku znaku multi-byte
- Format graficzny: em-dash (—) + middot (·) dla dobrej czytelności wizualnej
- Natywna referencja na produkt: „Referencja" z CSV jest używana jako
Product::reference (natywne pole PS)
🌳 Drzewo sportowe — 10 kategorii głównych × 42 podkategorie
CSV Training-Distribution udostępnia tylko JEDEN POZIOM kategorii na produkt („Catégorie"). Moduł kompensuje to, proponując przy instalacji drzewo sportowe z 10 kategoriami głównymi gotowymi do użycia, z 42 podkategoriami, które identycznie odtwarzają nazwy udostępniane przez CSV.
| Kategoria główna | Pogrupowane podkategorie CSV |
|---|
| Odzież Damska | Biustonosze sportowe · T-shirty - Crop topy · Tekstylia Damskie Sportowe |
| Odzież Sportowa | T-shirty - Tank topy · Bluzy - Hoodies · Szorty - Legginsy · Szorty - Joggery · Strój kąpielowy |
| Buty | Cross Training · Podnoszenie Ciężarów & Powerlifting |
| Skarpetki | Trening · Sport dziecięcy · Skarpetki oddychające & treningowe lekkie |
| Dłonie & Uchwyty | Uchwyty z/bez magnezji · Uchwyty Cross Training · Tape & Ochrona · Magnezja · Łatki Velcro |
| Ochrona ciała | Pasy siłowe · Stabilizatory kolan · Ochraniacze nadgarstków · Kamizelka obciążeniowa |
| Liny & Ciężary | Skakanki · Kable zamienne · Talerze Bumper · Taśma do podciągania |
| Odżywki & Suplementy | Białka/BCAA/Pre Workout · Przekąski · Napoje energetyczne · Witaminy · Omega 3 · Odżywianie Sportowe |
| Akcesoria sportowe | Opaski · Czapki/Czapeczki · Okulary · Bidony · Torba sportowa · Karta podarunkowa |
| Inne | Różne / Do sklasyfikowania (fallback: Strona główna, puste, „Catalogue Sport…", nieznane) |
- Tworzenie wielojęzyczne przy instalacji: 10 kat głównych + 42 podkat utworzonych idempotentnie pod Twoją kategorią root PS
- Cache DB mapowania: rozwiązana kat CSV jest zapamiętywana w
wp_trainingdist_category_mapping dla kolejnych importów
- Zakładka Mapowania kategorii w BO: tabela auto-ładowana z selektorem 42 podkat + przycisk Re-mapuj do łączenia lub zmiany nazwy po imporcie
- Inteligentny fallback: jeśli kat CSV jest pusta, „Strona główna", „Kategoria" lub „Catalogue Sport…", produkt jest kierowany do Inne > Różne / Do sklasyfikowania
- Sieć bezpieczeństwa: przy każdym otwarciu modułu BO drzewo jest re-weryfikowane. Ręcznie usunięta kat jest automatycznie odtwarzana
📸 Multi-obrazy z pojedynczej komórki „URL Images"
Kolumna „URL Images" CSV zawiera N URL oddzielonych przecinkami w komórce w cudzysłowie (np. „url1.jpg,url2.jpg,url3.jpg"). Moduł dzieli po przecinku, waliduje każdy URL (prefiks http(s)) i importuje wszystkie obrazy.
- 1. URL = cover automatycznie
- Walidacja formatu przez
getimagesize(): JPEG/PNG/GIF/WebP, uszkodzone pliki odrzucane bez crashowania importu
- Auto-generacja wszystkich rozmiarów PS (small, medium, large, home_default…)
- Fix BO PrestaShop 9 dołączony: kopia 1:1 oryginalnego pliku
<id>.jpg oprócz wariantów
- Pobieranie odporne: retry × 3 z backoff przy 503/timeout, log błędu jeśli całkowite niepowodzenie (import kontynuuje)
📝 Auto-generowany opis (CSV bez opisu dostawcy)
Training-Distribution nie dostarcza ŻADNEJ kolumny opisu w CSV. Moduł systematycznie generuje strukturalny opis HTML z etykiety, marki, kategorii i referencji — aby nigdy nie mieć karty produktu-widma na froncie (anti-bounce + dobre SEO).
🔤 Kodowanie ISO-8859-1 + separator przecinek
CSV training-distribution jest w ISO-8859-1 ze separatorem przecinka (w przeciwieństwie do innych modułów używających UTF-8 + ";"). Moduł obsługuje to:
- Konwersja ISO-8859-1 → UTF-8 komórka po komórce przez
mb_convert_encoding() z auto-detekcją jeśli już w UTF-8
- Symbol waluty ¤ (= € źle zakodowany Win-1252) usuwany automatycznie z końca cen
- Dziesiętne przecinki konwertowane na kropki w kolumnach Cena i Waga
- Komórka URL Images w cudzysłowach: wewnętrzne przecinki zachowane przez standardowe
fgetcsv, splitting wykonany w importMultiImages()
⚡ Architektura importu w czasie rzeczywistym
Scenariusz, który zmienia wszystko:
- 📥 Przygotowanie: moduł pobiera CSV z URL Training-Distribution i cache'uje 2 300 linii jako JSON
- 🚀 Import "1 linia CSV = 1 wywołanie AJAX": bez 2-godzinnego freeze'a, widzisz każdy produkt utworzony jeden po drugim
- 📊 Czerwono-złoty pasek postępu: procent na żywo + licznik X/Y
- 📋 Dziennik na żywo: kolorowy badge (Utworzony / Zaktualizowany / Pominięty / Błąd) + referencja + tytuł + ID PS#
- ⏸️ Przycisk Zatrzymaj w dowolnym momencie, wznowienie możliwe
- 📈 Statystyki na żywo: Linie przetworzone · Utworzone · Zaktualizowane · Pominięte · Błędy
→ Koniec z zawieszającą się stroną. Koniec z niepokojem. Widzisz wszystko, co się dzieje.
💰 Konfigurowalne Marże & SEO
4 tryby obliczania ceny
| Tryb | Opis |
|---|
| RRP ⭐ (domyślnie) | Cena sprzedaży CSV taka jaka jest — najprostsza na start. |
| Progi | % różny w zależności od progu ceny netto (5 progów konfigurowalnych: 0-15€/15-30€/30-60€/60-120€/120€+ — dostosowane do białek po 30€ jak i do talerzy bumper po 200€+). |
| Stała narzut | Jeden % stosowany (50% domyślnie → cena netto × 1.5). |
| Wholesale | Cena zakupu netto taka jaka jest (sprzedaż B2B do siłowni, trenerów itp.). |
Konfigurowalne szablony SEO
- Meta title / meta description ze zmiennymi:
{name}, {brand}
- Francuskie tagi PS auto-generowane z brand + category + kolor (jeśli obecny)
- Tryb light (light update): 2. import = aktualizacja tylko cen+stanów, Twoje personalizacje BO są zachowane
- Auto-dezaktywacja brak na stanie (opcja) lub „zachowaj widoczność dla SEO"
- Obraz w opisie: wstrzyknięcie 1. obrazu w długi opis (boost SEO on-page)
⏰ CRON 24/7 — 3 zautomatyzowane akcje
| Akcja CRON |
Rola |
Zalecana częstotliwość |
full_import | Pełny import (utworzenia + light updates) | 1×/dzień |
light_sync | Aktualizacja cena + stan + dostępność produktów już zaimportowanych (tryb light) | co 2-4h |
cleanup_logs | Czyszczenie logów > N dni (konfigurowalne przechowywanie) | 1×/tydzień |
- 32-znakowy klucz hex wygenerowany przy instalacji — Twoje URL CRON nie mogą być zgadnięte
- Regeneracja na 1 klik klucza w przypadku wycieku
- Asynchroniczne auto-wznowienie: auto-wywołanie w tle gdy time-budget jest osiągnięty (60s domyślnie)
- Precyzyjne wznowienie: wznawia dokładnie w linii, w której się zatrzymał
- Lock anti-konkurencja przez flock: brak równoległych wykonań
- Retry pobrania CSV 3× z backoff 2s/4s/6s
- Przycisk Stop po stronie BO do czystego zatrzymania trwającego CRON
- Tryb test z konfigurowalnym limitem produktów (10-100 do szybkiej walidacji)
🏷️ Katalog Training-Distribution w liczbach
2 300
referencji katalogu
Flagowe marki katalogu Training-Distribution (wyciąg według wolumenu):
ROKFIT
REHBAND
PICSIL
BAREBELLS
NOCCO
TYR
NORTHERN SPIRIT
VELITES
CELLUCOR C4
VERY BAD WOD
HEXXEE SOCKS
BARBELL REGIMENT
+ 20 innych marek
🛠️ Konserwacja — Selektywne usuwanie
- ☐ Zaimportowane produkty: detekcja z 4 źródeł (meta, supplier, product_supplier, mapowanie kategorii), kompatybilna PS9 multi-shop z fallback wipe SQL na powiązanych tabelach
- ☐ Atrybuty osierocone: ten moduł nie tworzy ŻADNEGO atrybutu PS (kolor+rozmiar dodane do tytułu, brak combinations). To pole ma efekt tylko jeśli ręcznie utworzyłeś atrybuty w BO
- ☐ Marki osierocone: usuwa producentów Training-Distribution (ROKFIT, REHBAND, PICSIL, BAREBELLS, NOCCO, TYR, NORTHERN SPIRIT, VELITES, …), którzy nie mają już żadnego produktu
- ☐ Dostawca Training-Distribution: usuwa dostawcę tylko jeśli nie ma już żadnego powiązanego produktu
- ☐ Dzienniki wewnętrzne: truncate tabel history i import_errors
Potrójne potwierdzenie (okno dialogowe + wpisanie USUŃ + przycisk). Drzewo kategorii nie jest usuwane — zarządzane przez moduł, odtwarzane przy następnym otwarciu jeśli usunąłeś je ręcznie.
⭐ 12 powodów, by wybrać Moduł Training-Distribution
- 🚀 Instalacja 3 minuty: URL CSV + uruchom import
- 🎨 Kolor + Rozmiar dodane do tytułu z obcięciem 128 znaków UTF-8 safe — czyste rozwiązanie wobec niespójnych ref CSV
- 🇫🇷 Natywny mono-językowy francuski — opisy FR napisane ludzko przez Training-Distribution
- 🔤 Automatyczna konwersja ISO-8859-1 → UTF-8 (francuskie znaki zachowane)
- 📝 Systematyczna auto-generacja SDE (CSV bez opisu dostawcy)
- 🌳 10 kategorii sport gotowych przy instalacji + 42 podkategorie zgodne z CSV
- 📸 Multi-obrazy N URL z pojedynczej komórki + fix BO PS9 dołączony
- 💰 4 tryby ceny (RRP / Progi / Stała narzut / Wholesale) — dostosowane do różnic cen białka/talerze bumper
- ⚡ Import w czasie rzeczywistym produkt-po-produkcie: pasek na żywo, dziennik konsoli, przycisk Zatrzymaj
- ♻️ Automatyczny tryb light przy re-imporcie: aktualizacja tylko cen+stanów
- ⏰ CRON 24/7 z time-budget, asynchroniczne auto-wznowienie, retry, lock
- 💎 Brak AdminController, brak Tab BO, brak override: nie zaśmieca menu, nie psuje innych modułów
🎬 Jak to działa w 4 krokach
1
Zainstaluj moduł
Pobierz ZIP, zainstaluj przez BO. Auto-tworzenie 5 tabel, dostawcy Training-Distribution, klucza CRON i drzewa sportowego (10 kat × 42 podkat).
2
Wprowadź URL CSV
Idź do Ustawień, wklej URL dostarczony przez Training-Distribution. Skonfiguruj kategorię root, pod którą drzewo jest tworzone (Strona główna domyślnie).
3
Skonfiguruj marże
Tryb RRP domyślnie. Możesz też wybrać Progi (5 progów) / Stała narzut / Wholesale. Konfigurowalne szablony SEO z {name}/{brand}.
4
Uruchom import
Kliknij "Uruchom import". Tryb test 20 produktów najpierw do walidacji, potem pełny import 2 300 produktów (~2h). Widzisz każdy produkt utworzony z jego Kolorem + Rozmiarem w tytule na własne oczy.
🔧 Kompatybilność techniczna
| PrestaShop | 1.7.x → 9.x (przetestowany na PS 9.0) |
| PHP | 7.4 minimum, zalecane 8.1+ |
| MySQL / MariaDB | 5.7+ / 10.3+ |
| cURL | Aktywne (pobranie CSV + obrazów) |
| Multi-shop | Kompatybilny (wymusza CONTEXT_ALL przy usuwaniu) |
| Używane hooki | Brak (brak zaśmiecania łańcucha zdarzeń) |
| Override klasy | Brak (zachowuje inne moduły) |
| AdminController | Brak |
| Zakładka sidebar BO | Brak (nie zaśmieca menu) |
| Konto Training-Distribution B2B | Konto wymagane do rozliczeń i dostępu do CSV |
| URL CSV | Należy poprosić swojego handlowca Training-Distribution |
❓ Najczęściej zadawane pytania
P: Czy Moduł Training-Distribution działa na PrestaShop 9?
O: Tak, w pełni kompatybilny PS 9.x. Moduł obsługuje specyficzną migrację PS9, gdzie meta_keywords zostało usunięte (auto-przełączenie na ps_tag) oraz bug PS9, gdzie oryginalny obraz nie pojawia się na stronie edycji produktu BO (fix przez kopię 1:1 pliku <id>.jpg).
P: Dlaczego 1 linia CSV = 1 produkt (brak grupowania rozmiar/kolor)?
O: Ponieważ CSV training-distribution nie udostępnia wspólnej referencji rodzica między rozmiarami tego samego produktu. Każdy rozmiar ma całkowicie inną ref (np. `R_N_GEN_0535_XS`, `_S`, `_M`, `_L`, `_XL` — wszystkie odrębne) i nawet obcinanie nie działa (linia L ma `R-N_GEN_0535_L` z myślnikiem). Więc niemożliwe pogrupowanie. Rozwiązanie: 1 linia = 1 produkt, rozmiar dodany do tytułu.
P: Tytuły „— Kolor · Rozmiar XL" mogą być długie. Jak jest to obsługiwane?
O: Moduł automatycznie obcina oryginalny tytuł (z „…") jeśli to konieczne, aby pozostać poniżej limitu PS 128 znaków, zawsze zachowując kolor + rozmiar w całości. UTF-8 safe (nigdy nie cięte w środku znaku multi-byte).
P: Jak tworzona jest hierarchia kategorii?
O: Przy instalacji moduł tworzy 10 głównych kategorii sport + 42 podkategorie pod Twoim root PS (Strona główna domyślnie). Przy każdym imporcie „Catégorie" CSV jest mapowana do właściwej podkategorii przez tabelę wewnętrzną. Jeśli nie pasuje, wpada do „Inne > Różne / Do sklasyfikowania" (nigdy błąd). Zakładka Mapowania do łączenia lub zmiany nazwy po imporcie.
P: CSV jest w ISO-8859-1 — jak moduł to obsługuje?
O: Moduł konwertuje każdą komórkę z ISO-8859-1 na UTF-8 przez mb_convert_encoding() (z auto-detekcją jeśli komórka jest już UTF-8). Francuskie znaki jak „Genouillères", „Brassières", „Mapalé" są zachowane. Symbol „¤" na końcu cen (= € źle zakodowany Win-1252) jest usuwany automatycznie. Dziesiętne przecinki konwertowane na kropki.
P: Dlaczego mój opis jest auto-generowany?
O: Dostawca Training-Distribution nie dostarcza żadnej kolumny opisu w CSV. Aby nigdy nie mieć karty produktu-widma na froncie (i szkodliwej dla SEO), moduł generuje strukturalny tekst HTML z nazwy + marki + kategorii + referencji. Możesz ręcznie spersonalizować interesujące Cię karty — tryb light już ich nie nadpisze.
P: Czy mogę importować ten sam CSV wielokrotnie?
O: Tak. Automatyczny tryb light: istniejące produkty są wykrywane przez ich Referencję CSV (= unikalne sku na linię) i tylko ich cena + stan są odświeżane. Twoje opisy, obrazy, kategorie i tagi nie są nadpisywane — zachowujesz personalizacje.
P: Jak usunąć wszystkie produkty Training-Distribution?
O: Zakładka Import → Selektywne usuwanie → zaznacz „Zaimportowane produkty" + „Marki osierocone" + „Dostawca Training-Distribution" + „Dzienniki" → USUŃ. Potrójne potwierdzenie, aby uniknąć błędów.
P: A jeśli chcę zatrzymać import w toku?
O: Przycisk „Zatrzymaj" dostępny podczas importu (UI) i podczas CRON (flag file). Czyste zatrzymanie na końcu trwającego produktu, zapis stanu do wznowienia w dokładnej linii zatrzymania.
P: Czy moduł jest kompatybilny multi-shop?
O: Tak. Kategorie i produkty są tworzone na wszystkich aktywnych sklepach. Usuwanie wymusza CONTEXT_ALL, aby uniknąć quirka PS9, gdzie Product->delete() zwraca false w multi-shop.
P: Brak AdminController, brak Tab BO?
O: Potwierdzone. Moduł używa wyłącznie getContent() + AJAX. Brak zaśmiecania menu BO PrestaShop. Brak override klasy core.
💪 Gotowy zautomatyzować swój dropshipping sport?
Ten Moduł Training-Distribution dropshipping sport cross-training fitness to najbardziej kompletne narzędzie do sprzedaży 2 300 referencji Training-Distribution (cross-training, fitness, trening siłowy, odżywki sportowe) na PrestaShop. Raz skonfigurowany, automatycznie importuje katalog z kolorem + rozmiarem w tytule, jego N zdjęciami na produkt, jego gotową hierarchię sportową.
⚡ INSTALACJA 3 MIN · 📚 IMPORT W CZASIE RZECZYWISTYM · 🛡️ KOMPATYBILNY PS 1.7 → 9 · 🇫🇷 FRANCUSKI SUPPORT
📋 Szczegóły techniczne dla deweloperów
Tabele BDD utworzone (5): wp_trainingdist_history, wp_trainingdist_import_errors, wp_trainingdist_product_meta (sku unikalne = Referencja CSV), wp_trainingdist_combination_meta (sku unikalne), wp_trainingdist_category_mapping (csv_path unikalne)
Konfiguracje PS: WPTD_SETTINGS (JSON), WPTD_SUPPLIER_ID, WPTD_CRON_KEY, WPTD_LAST_IMPORT_AT, WPTD_LAST_IMPORT_COUNT, WPTD_LAST_UPLOADED_CSV, WPTD_CRON_LAST_*
CSV Training-Distribution (10 kolumn ISO-8859-1, separator przecinek): Marque, Catégorie, Nom, Taille, Couleur, URL Images, Stock, Poids, Référence, Prix de vente (z ¤ stripped)
Architektura: 5 czystych klas PHP (TdCompat, TdCategoryTaxonomy, TdCategoryMapper, TdFeatureMapper [martwy kod by design — brak Features na tym CSV], TdCsvImporter) + moduł główny + router AJAX + CRON. Brak override klasy core PrestaShop.
Aliasy wspólnego silnika: sku → Référence, name_fr → Nom, brand → Marque, category → Catégorie, price → Prix de vente, weight → Poids (w kg natywnych, nie gramach), qty → Stock, size → Taille, color → Couleur, image-url-1 → URL Images (pojedyncza komórka splitowana).
appendVariantToName(): helper, który dodaje „— Kolor · Rozmiar XX" do nazwy produktu z obcięciem 128 znaków UTF-8 safe (mb_substr). Jeśli złączony tytuł przekracza, oryginalny tytuł jest obcinany z „…", aby zachować kolor+rozmiar w całości.
importMultiImages(): dzieli komórkę URL Images po przecinku, waliduje każdy URL (preg_match `^https?://`), 1. URL = cover. Pobranie z retry × 3 backoff, walidacja getimagesize JPEG/PNG/GIF/WebP, auto-generacja wszystkich rozmiarów PS przez ImageManager::resize, fix BO PS9 przez kopię 1:1 oryginalnego pliku <id>.jpg.
ensureSupplierExists(): bezpośredni INSERT SQL (nie new Supplier() + ->add(), który cicho zawodzi w PS9). Dynamiczna detekcja kolumny meta_keywords w ps_supplier_lang (obecna PS7, usunięta PS9). Multi-shop przez ps_supplier_shop. Sieć bezpieczeństwa: wywoływana również przed każdym importem (nie tylko przy instalacji).
Cache statyczny Db::getValue(): 4 zapytania o istnienie w processRow() używają useCache=false, aby ominąć statyczny cache PS, który persystuje między workerami PHP-FPM (inaczej re-importy nie znajdują już zaimportowanych produktów i tworzą duplikaty).
Bezpieczeństwo: pSQL() wszędzie, folder uploads/ chroniony, walidacja formatu obrazów, natywne CSRF PS na AJAX, systematyczne escape HTML, hash_equals() na kluczu CRON.
Specyficzna kompatybilność PS9: auto migracja meta_keywords → ps_tag/ps_product_tag przez Tag::addTags(), obsługa quirka Product::delete(), który zwraca false w multi-shop, fix BO PS9 oryginalnego obrazu.
Kodowanie: konwersja ISO-8859-1 → UTF-8 komórka po komórce przez mb_convert_encoding() z wcześniejszą detekcją czy już prawidłowy UTF-8. Stripping symbolu ¤ + spacji nierozdzielnych w cenach. Konwersja przecinek dziesiętny → kropka.
📦 Moduł stworzony przez WebPoint · webpoint.fr · Regularne aktualizacje · Czysty & skomentowany kod
