Moduł PrestaShop dropshippingowy ELEMTECHNIC
🌐 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ł Elemtechnic Dropshipping Narzędzia i Ogród
Moduł, który automatyzuje od A do Z Twój francuski dropshipping majsterkowicza z Elemtechnic na PrestaShop
PrestaShop 1.7 → 9.x · 1310 referencji · 50 marek · 10 natywnych kategorii · CRON 24/7
Uruchamiasz lub prowadzisz sklep online z narzędziami, ogrodem lub majsterkowaniem? Pracujesz z Elemtechnic (francuskim hurtownikiem B2B specjalizującym się w narzędziach, elektronarzędziach, ogrodzie, domu) i spędzasz dni ręcznie kopiując karty produktów z ich portalu, klasyfikując każdy artykuł do właściwej podkategorii (Wkrętarka / Kosiarka spalinowa / Myjka ciśnieniowa / Pompa zatapialna / Ogrzewanie…), wgrywając zdjęcia z ich CDN, przeliczając ceny sprzedaży z Twoją marżą?
Z Modułem Elemtechnic dropshipping narzędzia ogród dom wszystko staje się automatyczne. Wpisujesz URL CSV Elemtechnic, klikasz „Uruchom import", a moduł tworzy Twoich 1310 produktów PrestaShop na Twoich oczach, w czasie rzeczywistym, z ich 5 obrazami pochodnymi na wariant, w idealnie zorganizowanym natywnym drzewie.
⚡ Przed vs Po Module Elemtechnic
| Zadanie |
❌ Bez modułu |
✅ Z modułem |
| Import 1310 referencji majsterkowicza | 20h+ ręcznie, kopiowanie z portalu Elemtechnic | 1 kliknięcie, ~1h w tle |
| Multi-kąty produktu (przód, tył, góra, zoom) | Jedno zdjęcie dostępne w CSV | 5 URL auto-pochodnych przez sufiksy _F/_B/_U/_Z |
| 216 par KATEGORIA+SUB_CAT | Ręczne tworzenie hierarchii 2-poziomowej | Bezpośrednie mapowanie CSV → PS, podkategorie w locie |
| Niespójna wielkość liter CSV („ogród", „DOM") | Duplikaty kategorii w drzewie PS | Auto normalizacja do czystej formy |
| URL PHOTO_BIG z pasożytniczą spacją (~50 wierszy) | Cichy 404, brakujący obraz | Auto regex trim („<REF> .jpg" → „<REF>.jpg") |
| 50 marek Elemtechnic do utworzenia | Ręczne dodawanie producent po producencie | Auto tworzenie przy imporcie (Manufacturer PS) |
| Brak ceny RRP od dostawcy | Obliczanie marż w Excelu produkt po produkcie | 4 tryby (Stała marża / Progi / Wholesale / RRP) |
| Oryginalny obraz BO PrestaShop 9 | Uszkodzony obraz w BO PS9 (oficjalny bug) | Fix BO PS9 w zestawie: kopia 1:1 oryginalnego pliku |
👤 Dla kogo jest ten moduł?
🛠️
Sklep online z narzędziami / majsterkowaniem
Sprzedajesz wiertarki, wkrętarki, szlifierki, piły, młotowiertarki, walizki narzędziowe online i chcesz pomnożyć swój katalog bez zarządzania fizycznym zapasem.
🌱
E-commerce ogrodniczy
Oferujesz kosiarki spalinowe/elektryczne, nożyce do żywopłotu, kosy spalinowe, glebogryzarki, rozdrabniacze, pompy zatapialne, pompy do piwnic… a sezon wiosna/lato to Twój szczyt aktywności.
🏠
Sklep dom / wyposażenie domowe
Sprzedajesz ogrzewanie, oświetlenie, wentylację, odkurzacze, elektrykę, i potrzebujesz niezawodnego francuskiego dostawcy B2B z szerokim sezonowym katalogiem.
🎯 Kompletne funkcje Modułu Elemtechnic
🌳 Natywne drzewo Elemtechnic — 10 głównych kategorii
CSV Elemtechnic wystawia 12 głównych kategorii (z 2 znormalizowanymi duplikatami wielkości liter) i 166 odrębnych podkategorii (216 par KATEGORIA × SUB_CAT). Moduł zachowuje natywne drzewo dostawcy — bez sztucznego stałego drzewa, które wymuszałoby uciążliwe re-mapowanie.
| Główna kategoria |
Wolumen |
Podkategorie (wyciąg) |
| 🌱 Ogród | ~450 | Kosiarka spalinowa/elektryczna · Nożyce do żywopłotu · Podkaszarka · Kosa spalinowa · Traktor · Glebogryzarka · Rozdrabniacz · Odkurzacz dmuchawa… |
| 🏠 Dom | ~384 | Ogrzewanie · Oświetlenie · Odkurzacz · Wentylator · Plandeka · Elektryka… |
| 🔧 Narzędzia | ~233 | Wkrętarka · Wiertarka · Szlifierka · Szlifierka kątowa · Pilarka tarczowa · Wyrzynarka · Młotowiertarka · Zestawy · Kity… |
| ⚡ Elektronarzędzia | ~67 | Akumulator · Sprężarka · Wózek narzędziowy… |
| 🚧 Budowa | ~66 | Myjka ciśnieniowa · Odkurzacz dmuchawa · Betoniarka · Generator… |
| 💧 Pompy | ~59 | Pompy do piwnic · Pompy zatapialne · Pompy powierzchniowe… |
| 🗄️ Przechowywanie warsztatowe | ~26 | Wózki narzędziowe · Modułowe przechowywanie… |
| ⚙️ Stacjonarne | ~20 | Narzędzia stacjonarne |
| 🚲 Sport · 🚐 Transport | 3 | Mniejszościowe kategorie zachowane z wierności dla katalogu |
- Automatyczna normalizacja wielkości liter: „ogród" → „Ogród", „DOM" → „Dom", „przechowywanie warsztatowe" → „Przechowywanie warsztatowe" — koniec z duplikatami w drzewie PS
- Podkategorie w locie: tworzone w momencie importu z kolumny SUB_CAT CSV (z ich dokładną nazwą)
- Siatka bezpieczeństwa: jeśli główna kategoria zostanie ręcznie usunięta z BO PS, jest tworzona ponownie przy następnym otwarciu modułu
- Konfigurowalny korzeń podrzędny: Home domyślnie, lub dowolna kategoria Twojego drzewa
📸 Multi-obrazy pochodne przez sufiksy _F/_B/_U/_Z — Innowacja Elemtechnic
Wyjątkowa cecha tego modułu. CSV Elemtechnic dostarcza tylko jedną kolumnę PHOTO_BIG (URL głównego obrazu). Jednak CDN Elemtechnic zwykle hostuje 4 warianty na produkt (Front, Back, Up, Zoom) dostępne przez konwencję nazewnictwa. Moduł automatycznie wyprowadza te 4 dodatkowe URL zastępując .jpg sufiksami.
| Pozycja |
Sufiks |
Wygenerowany URL (np. REF = SP1150-210) |
Widok |
| Obraz 1 (cover) | (brak) | https://eshop.elemtechnic.com/photos/SP1150-210.jpg | Standardowy 3/4 frontalny |
| Obraz 2 | _F.jpg | SP1150-210_F.jpg | Front (przód) |
| Obraz 3 | _B.jpg | SP1150-210_B.jpg | Back (tył) |
| Obraz 4 | _U.jpg | SP1150-210_U.jpg | Up (góra) |
| Obraz 5 | _Z.jpg | SP1150-210_Z.jpg | Zoom szczegół |
- Odporne pobieranie: jeśli wariant nie istnieje u Elemtechnic (HTTP 404), moduł cicho przechodzi do następnego. Otrzymujesz dokładnie obrazy faktycznie dostępne, bez uszkodzonej karty.
- Auto trim bug dostawcy: ~50 wierszy CSV ma pasożytniczą spację przed
.jpg („<REF> .jpg"). Moduł czyści je automatycznie przez preg_replace('/\s+\.jpg$/i', '.jpg', $url).
- Walidacja formatu przez
getimagesize(): JPEG/PNG/GIF/WebP, uszkodzone pliki odrzucane bez zawieszania importu.
- Auto generowanie wszystkich rozmiarów PS (small, medium, large, home_default…) przez
ImageManager::resize()
- Fix BO PrestaShop 9 w zestawie: kopia 1:1 oryginalnego pliku
<id>.jpg oprócz wariantów — bez tego fixa obraz nie wyświetla się na stronie edycji produktu BO PS9 (znany bug PS9).
📦 1 wiersz CSV = 1 produkt PS — Brak wariantów do zarządzania
Katalog Elemtechnic nie zawiera wariantów rozmiar/kolor (każda REFERENCE jest odrębnym gotowym produktem, jak kompletna „wiertarka XYZ 18V"). Zalety:
- Proste mapowanie: 1 wiersz CSV = 1 produkt PS, bez logiki grupowania parent do zrozumienia
- Bezpośredni stan na produkcie: brak kombinacji ani atrybutów do tworzenia/utrzymywania
- EAN13 bezpośrednio na produkcie (brak złożoności combination → EAN)
- Czysta karta produktu: brak rozwijanego menu wariantów na froncie jeśli puste, tylko produkt prezentowany z jego 5 obrazami pochodnymi
📋 CSV Elemtechnic — Czysty i łatwy format
| Cecha | Wartość |
|---|
| Liczba kolumn | 22 kolumny (NUM, REFERENCE, CATEGORIE, SOUS_CAT, TITRE, DESCRIPTION, EAN, POIDS, STOCK, PRIX, …, PHOTO_BIG, …, MARQUE, GARANTIE) |
| Separator | ; (średnik) |
| Quotechar | " (cudzysłów) |
| Kodowanie | Natywne UTF-8 (bez Windows-1252 ani konwersji) |
| Dziesiętne | Z kropką („26.00", bez francuskiego przecinka do konwersji) |
| Waga | W kilogramach (importowana bez zmian po stronie PS) |
| Opis | HTML akceptowany (z <br/>, listami, pogrubieniem), wielowierszowy w cudzysłowach |
| Wolumen katalogu | 1310 produktów · 50 marek · 216 odrębnych par KATEGORIA+SUB_CAT |
✍️ Automatyczny opis jeśli pusty
Jeśli kolumna DESCRIPTION CSV zawiera co najmniej 30 znaków tekstu (po strip_tags), jest zachowywana i poprawnie przeformatowywana w HTML. Jeśli jest pusta lub zbyt krótka, moduł automatycznie generuje strukturalny opis HTML z TITRE, MARQUE, kategorii i REFERENCE — aby nigdy nie mieć pustej karty produktu szkodliwej dla SEO.
Moduł nigdy nie nadpisuje opisu dostarczonego przez dostawcę.
⚡ Architektura importu w czasie rzeczywistym
Scenariusz, który wszystko zmienia:
- 📥 Przygotowanie: moduł pobiera CSV ze skonfigurowanego URL Elemtechnic i umieszcza 1310 wierszy w cache JSON
- 🚀 Import „1 produkt = 1 wywołanie AJAX": bez 30-minutowego zamrożenia, widzisz każdy produkt tworzony jeden po drugim
- 📊 Pomarańczowy pasek postępu: procent na żywo + licznik X/Y
- 📋 Dziennik na żywo w stylu konsoli: kolorowa odznaka (Utworzony / Zaktualizowany / Pominięty / Błąd) + REFERENCE + TITRE + ID PS#
- ⏸️ Przycisk Zatrzymaj w dowolnym momencie, wznowienie możliwe
- 📈 Statystyki na żywo: Utworzone · Zaktualizowane · Pominięte · Błędy
→ Koniec ze spowolnioną stroną. Koniec z obawami. Widzisz wszystko, co się dzieje.
💰 Konfigurowalne marże i SEO
4 tryby obliczania ceny
Specyfika Elemtechnic: CSV nie dostarcza ceny RRP (recommended retail price). Moduł obsługuje 4 strategie:
| Tryb | Opis |
|---|
| Stała marża ⭐ (domyślnie) | Jeden % stosowany do wszystkich produktów (50% domyślnie → PRIX × 1.5). Najprostszy do startu. |
| Progi | Inny % w zależności od progu ceny zakupu netto (5 progów domyślnie, konfigurowalnych: 0-15€/15-30€/30-60€/60-120€/120€+). Optymalizuje marże na produktach według ich gamy. |
| Wholesale | Cena zakupu netto bez zmian (sprzedaż B2B do profesjonalistów). |
| RRP (= PRIX wobec braku RRP) | Tryb awaryjny: używa PRIX jako ceny sprzedaży (więc marża = 0). Przydatny w oczekiwaniu na konfigurację. |
Konfigurowalne szablony SEO
- Meta title / meta description ze zmiennymi:
{name}, {brand}
- PS Tagi auto-generowane z brand + category
- Inteligentny mini-opis: wyciągnięty z 2 pierwszych zdań CSV, jeśli dostarczone, auto-generowany w przeciwnym razie
- Auto-dezaktywacja przy braku stanu (opcja) lub „zachowaj widoczne dla SEO"
- Opcja „obraz w opisie": wstrzyknięcie 1. obrazu bezpośrednio do długiego opisu (boost SEO on-page), pozycja początek lub koniec do wyboru
⏰ CRON 24/7 — 3 zautomatyzowane akcje
| Akcja CRON |
Rola |
Zalecana częstotliwość |
full_import | Pełny import katalogu (tworzenia + light updates) | 1×/dzień |
light_sync | Aktualizacja ceny + stanu + dostępności już zaimportowanych produktów (tryb lekki) | 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ć odgadnięte
- Regeneracja 1 kliknięciem klucza w przypadku wycieku
- Asynchroniczny auto-restart: moduł sam się wywołuje w tle, jeśli zostanie osiągnięty time-budget (60s domyślnie, konfigurowalny) — bez timeoutu Apache 5xx
- Precyzyjne wznowienie: wznawia dokładnie od linii, na której się zatrzymał
- Lock anti-konkurencja przez flock: brak równoległych wykonań
- Retry pobierania CSV 3× z backoff 2s/4s/6s
- Przycisk Stop po stronie BO do czystego zatrzymania trwającego CRON
- Tryb testowy z konfigurowalnym limitem produktów (50 do szybkiej walidacji)
🏷️ Katalog Elemtechnic w liczbach
10
natywnych głównych kat
5
obrazów max/produkt (pochodne)
Czołowe marki katalogu (wyciąg, według wolumenu):
ELEM Garden Technic (255)
WARM TECH (157)
CONSTRUCTOR (140)
X-PERFORMER (125)
BRICK (61)
ELEM Technic (60)
GARDEO Pro (53)
I-WATTS (52)
WORK MEN (43)
MASTER PUMPS (41)
I-WATTS OUTDOOR LIGHTING (35)
COOL CLIMA (34)
Lawnmaster (22)
Vacmaster Professional (19)
+ 35 innych marek
🛠️ Konserwacja — Selektywne usuwanie
- ☐ Zaimportowane produkty: wykrywanie z 4 źródeł (meta, supplier, product_supplier, mapowanie kategorii), kompatybilne z quirk PS9 multi-shop z fallback wipe SQL na 25 połączonych tabelach
- ☐ Osierocone marki: usuwa 50 producentów Elemtechnic (ELEM Garden Technic, WARM TECH, CONSTRUCTOR, X-PERFORMER, BRICK, GARDEO Pro, I-WATTS, MASTER PUMPS, COOL CLIMA…), które nie mają już żadnego produktu
- ☐ Dostawca Elemtechnic: usuwa supplier tylko jeśli nie ma już żadnego powiązanego produktu
- ☐ Wewnętrzne dzienniki: truncate tabel history i import_errors
Potrójne potwierdzenie (okno dialogowe + wpisanie USUŃ + przycisk). Brak pola „Osierocone atrybuty" (Elemtechnic nie ma wariantów rozmiar/kolor). Brak pola „Kategorie": drzewo jest zarządzane przez moduł i odtwarzane jeśli usunięte ręcznie z BO.
⭐ 12 powodów, by wybrać Moduł Elemtechnic
- 🚀 Instalacja w 3 minuty: URL CSV + utworzone drzewo + uruchom import
- 🌳 Natywne drzewo zachowane: 10 głównych kategorii + podkategorie w locie (vs narzucanie sztucznego stałego drzewa)
- 🔡 Auto normalizacja wielkości liter: „ogród" / „DOM" / „przechowywanie warsztatowe" scalone do ich czystej formy
- 📸 Multi-obrazy pochodne przez sufiksy _F/_B/_U/_Z: unikalna innowacja modułu Elemtechnic, wykorzystuje konwencję nazewnictwa CDN dostawcy
- 🛡️ Auto trim bug dostawcy: ~50 wierszy z pasożytniczą spacją przed
.jpg automatycznie czyszczone
- 📦 1 wiersz CSV = 1 produkt: brak złożoności wariantów, bezpośrednie i deterministyczne mapowanie
- ✍️ Auto-generowany opis jeśli pusty: brak fantomowej karty produktu na froncie
- 💰 4 tryby cen: Stała marża (domyślnie 50%) / Progi / Wholesale / RRP — dostosowane do braku ceny RRP od dostawcy
- ⚡ Import w czasie rzeczywistym produkt po produkcie: pasek na żywo, dziennik konsoli, przycisk Zatrzymaj
- ⏰ CRON 24/7 z time-budget, asynchronicznym auto-restartem, retry, lock
- 🛡️ Kompatybilny PS 1.7 → 9.x: warstwa kompatybilności
EtCompat + fix bug obrazu BO PS9 w zestawie
- 🇫🇷 Francuski autor · Bez AdminController, bez override: nie zaśmieca Twojego menu BO, nie psuje Twoich innych modułów
🎬 Jak to działa w 4 krokach
1
Zainstaluj moduł
Pobierz ZIP, zainstaluj przez BO. Auto-tworzenie 5 tabel, dostawcy Elemtechnic, klucza CRON, 10 natywnych głównych kategorii.
2
Wpisz URL CSV
Idź do Ustawień, wklej URL pliku CSV dostarczonego przez Elemtechnic (placeholder: https://eshop.elemtechnic.com/exports/catalog.csv), skonfiguruj opcję obrazu w opisie.
3
Skonfiguruj marże
Stała marża 50% domyślnie, lub wybierz Progi (5 progów) / Wholesale / RRP. Konfigurowalne szablony SEO z {name}/{brand}.
4
Uruchom import
Kliknij „Uruchom import". Tryb testowy 50 produktów najpierw do walidacji, potem pełny import 1310 wierszy. Widzisz każdy produkt utworzony na Twoich oczach.
🔧 Kompatybilność techniczna
| PrestaShop | 1.7.x → 9.x (testowane na PS 9.0) |
| PHP | 7.4 minimum, zalecany 8.1+ |
| MySQL / MariaDB | 5.7+ / 10.3+ |
| cURL | Aktywny (pobieranie CSV + obrazów) |
| Multi-shop | Kompatybilny (wymusza CONTEXT_ALL przy usuwaniu) |
| Używane hooki | Brak (bez zaśmiecania łańcucha zdarzeń) |
| Override klasy | Brak (zachowuje Twoje inne moduły) |
| AdminController | Brak |
| Zakładka sidebar BO | Brak (nie zaśmieca Twojego menu) |
| Konto Elemtechnic B2B | Konto wymagane do fakturowania i dostawy |
| URL CSV | Do uzyskania od Twojego handlowca Elemtechnic |
❓ Najczęstsze pytania
P: Czy Moduł Elemtechnic działa na PrestaShop 9?
O: Tak, w pełni kompatybilny z PS 9.x. Moduł obsługuje specyficzną migrację PS9, gdzie meta_keywords zostały usunięte (automatyczne przełączenie na ps_tag) jak również bug PS9, gdzie oryginalny obraz nie pojawia się na stronie edycji produktu BO (fix przez kopię 1:1 pliku <id>.jpg oprócz przeskalowanych wariantów).
P: Co się dzieje, jeśli wariant obrazu (_F/_B/_U/_Z) nie istnieje u Elemtechnic?
O: Pobieranie kończy się błędem 404 i moduł cicho przechodzi do następnego. Brak wygenerowanego błędu. Otrzymujesz dokładnie obrazy, które rzeczywiście istnieją u dostawcy, bez uszkodzonej karty. W obecnym katalogu zdecydowana większość produktów ma co najmniej obraz cover, niektóre 2-3 warianty, kilka wszystkie 5.
P: A co z ~50 wierszami, gdzie PHOTO_BIG ma pasożytniczą spację przed „.jpg"?
O: Moduł wykrywa je automatycznie regex /\s+\.jpg$/ i czyści je przed pobraniem („SP1150-210 .jpg" staje się „SP1150-210.jpg"). Bug dostawcy obsługiwany w przejrzysty sposób, nic nie musisz robić.
P: Czy mój współdzielony hosting za 9€/miesiąc to wytrzyma?
O: Tak, moduł jest specjalnie zoptymalizowany. Architektura „1 produkt = 1 wywołanie AJAX" gwarantuje, że żadne wywołanie nie przekracza 2-3 sekund. Brak ryzyka timeoutu Apache 5xx, w przeciwieństwie do modułów importu „all-in-one".
P: CSV nie ma ceny RRP, jak skonfigurować marże?
O: Elemtechnic dostarcza tylko PRIX zakupu netto (brak rekomendowanej ceny detalicznej). Moduł jest skonfigurowany domyślnie w trybie „Stała marża 50%" (PRIX × 1.5). Możesz przejść w tryb „Progi" (5 konfigurowalnych progów: 0-15€/15-30€/30-60€/60-120€/120€+) lub „Wholesale" (sprzedaż B2B w cenie zakupu) w zakładce Marże i SEO.
P: Jak działa drzewo 10 kategorii?
O: Przy instalacji moduł tworzy 10 natywnych głównych kategorii Elemtechnic (Ogród, Dom, Narzędzia, Elektronarzędzia, Budowa, Pompy, Przechowywanie warsztatowe, Stacjonarne, Sport, Transport). Podkategorie są tworzone w locie przy imporcie z kolumny SUB_CAT CSV (z ich dokładną nazwą). Auto normalizacja scala literówki wielkości liter („ogród" i „Ogród" → jedna kategoria „Ogród").
P: Czy mogę zaimportować ten sam CSV wielokrotnie?
O: Tak. Automatyczny tryb lekki: istniejące produkty są wykrywane przez ich REFERENCE i tylko ich cena + stan są odświeżane. Twoje opisy, obrazy, kategorie i tagi nie są przepisywane — zachowujesz swoje personalizacje. Idealne do codziennego odświeżania (lub przez CRON light_sync).
P: Jak usunąć wszystkie produkty Elemtechnic?
O: Zakładka Import → Selektywne usuwanie → zaznacz „Zaimportowane produkty" → USUŃ. Możesz dodać „Osierocone marki / Dostawca" dla pełnego czyszczenia. Potrójne potwierdzenie aby uniknąć błędów.
P: A jeśli chcę zatrzymać trwający import?
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.
P: Czy moduł jest kompatybilny multi-shop?
O: Tak. Kategorie i produkty są tworzone na wszystkich aktywnych sklepach. Usuwanie wymusza CONTEXT_ALL aby uniknąć quirk PS9, gdzie Product->delete() zwraca false w multi-shop.
P: Czy mogę odinstalować w czysty sposób?
O: Tak, ale odinstalowanie celowo zachowuje Twoje zaimportowane produkty (uniknięta nieodwracalna strata). Strefa „Selektywne usuwanie" pozwala na granularne czyszczenie z potrójnym potwierdzeniem: produkty / marki / dostawca / dzienniki, niezależne.
🔧 Gotowy zautomatyzować swój dropshipping majsterkowicza?
Moduł Elemtechnic dropshipping narzędzia ogród dom to najbardziej kompletne narzędzie do sprzedaży 1310 referencji Elemtechnic (wiertarki, kosiarki, nożyce do żywopłotu, myjki, pompy, ogrzewanie, oświetlenie…) na PrestaShop. Raz skonfigurowany, automatycznie importuje katalog w Twoim tempie z 5 obrazami pochodnymi na produkt.
⚡ INSTALACJA 3 MIN · 📚 IMPORT W CZASIE RZECZYWISTYM · 🛡️ KOMPATYBILNY PS 1.7 → 9 · 🇫🇷 WSPARCIE FRANCUSKIE
📋 Szczegóły techniczne dla deweloperów
Utworzone tabele BD (5): wp_elemtechnic_history, wp_elemtechnic_import_errors, wp_elemtechnic_product_meta (sku unique = REFERENCE), wp_elemtechnic_combination_meta (nieużywana — brak wariantów), wp_elemtechnic_category_mapping (csv_path unique = „MAIN > SUB" znormalizowane)
Konfiguracje PS: WPET_SETTINGS (JSON), WPET_SUPPLIER_ID, WPET_CRON_KEY, WPET_LAST_IMPORT_AT, WPET_LAST_IMPORT_COUNT, WPET_CRON_LAST_*
CSV Elemtechnic (22 kolumny UTF-8): NUM, REFERENCE (SKU), CATEGORIE + SOUS_CAT, TITRE, DESCRIPTION (HTML), EAN, POIDS (kg), STOCK, PRIX (netto), TRANSPORT, EN_PROMO, PRIX_PROMO, PHOTO_110, PHOTO_300, PHOTO_BIG, REAPPRO, INSERT, UPDATE, CHARGE_COLIS, MARQUE, GARANTIE
Architektura: 5 czystych klas PHP (EtCompat, EtCategoryTaxonomy, EtCategoryMapper, EtFeatureMapper [martwy kod by design], EtCsvImporter) + główny moduł + router AJAX + CRON. Brak override klasy core PrestaShop. Kod komentowany po francusku.
Syntetyczne kolumny generowane w parseCsvToArray: 6 kolumn dodanych do każdego wiersza po odczycie — CATEGORY_COMBINED („CATEGORIE > SOUS_CAT"), IMG_COVER (oczyszczony PHOTO_BIG), IMG_F, IMG_B, IMG_U, IMG_Z (URL pochodne przez sufiksy).
Aliasy kompatybilności wspólnego silnika: sku → reference, name_fr → titre, description_fr → description, brand → marque, parent → reference, price → prix, recommended-retail-price → prix (wobec braku RRP), weight → poids, qty → stock, category → CATEGORY_COMBINED, image-url-1..5 → IMG_*.
Mapowanie kategorii: bezpośrednie i deterministyczne (CSV dostarcza MAIN+SUB jawnie). Brak fuzzy matching potrzebny. Cache DB do ponownego użycia rozwiązanych asocjacji.
Bezpieczeństwo: pSQL() wszędzie, folder uploads/ chroniony, walidacja formatu obrazów (getimagesize), natywny CSRF PS na AJAX, systematyczne escape HTML (htmlspecialchars), hash_equals() na kluczu CRON.
Specyficzna kompatybilność PS9: automatyczna migracja meta_keywords → ps_tag/ps_product_tag przez Tag::addTags(), obsługa quirk Product::delete(), który zwraca false w multi-shop, fix BO PS9 oryginalny obraz (kopia 1:1 pliku <id>.jpg przed wariantami ImageManager::resize).
Obsługa bug dostawcy: preg_replace('/\s+\.jpg$/i', '.jpg', $url) stosowane na PHOTO_BIG w parseCsvToArray dla ~50 wierszy z pasożytniczą spacją.
📦 Moduł opracowany przez WebPoint · webpoint.fr · Regularne aktualizacje · Czysty i komentowany kod
