Moduł PrestaShop dropshippingu VELLEMAN
🔌 ⚡ 🔬
Moduł Velleman Dropshipping Komponenty Elektroniczne
Moduł, który automatyzuje od A do Z Twój dropshipping komponentów, modułów, zestawów i audio na PrestaShop
PrestaShop 1.7 → 9.x · ~6 000 produktów · bezpieczny FTP · 25 zdjęć/produkt · CRON 24/7 · GPSR UE 2024
Uruchamiasz sklep z komponentami elektronicznymi, witrynę specjalistyczną Arduino / Raspberry / makers DIY, e-commerce z oświetleniem scenicznym lub profesjonalnym sprzętem audio? Współpracujesz z Velleman Group (historyczny belgijski hurtownik założony w 1976 r., europejski lider w komponentach, modułach, zestawach edukacyjnych, nagłośnieniu, oświetleniu scenicznym i narzędziach pomiarowych) i spędzasz całe dni na ręcznym przepisywaniu 6 000 kart produktowych, ręcznym przesyłaniu 25 zdjęć na produkt, odtwarzaniu każdej kategorii na 10 poziomach hierarchicznych, ręcznym parsowaniu szczegółowych charakterystyk technicznych (Fizyczne / Elektryczne / Techniczne / Instalacja), zarządzaniu 10 progami cen degresywnych zależnie od wolumenów zakupu?
Z Modułem Velleman dropshipping komponenty elektroniczne moduły zestawy FTP wszystko staje się automatyczne. Wprowadzasz swoje dane FTP Velleman (host, port, użytkownik, hasło, ścieżka do Twojego spersonalizowanego pliku), klikasz "Uruchom import", a moduł pobiera Twój CSV z 64 kolumnami w Windows-1252, konwertuje go do UTF-8 komórka po komórce, pobiera 2. CSV mapowania zdjęć z CDN Velleman (URL hardkodowany, niewidoczny po stronie klienta) i tworzy ~6 000 produktów PrestaShop w drzewie 10-poziomowym generowanym w locie, każdy z kartą PREMIUM 10 sekcji (panel tożsamości marki + EAN + status, krótki wstęp, kluczowe punkty, karty charakterystyk technicznych, wymiary, opakowanie, pochodzenie, eko-składka, zgodność GPSR UE 2024, CTA dostawcy), do 25 zdjęć na produkt oraz zgodność europejską GPSR zasilaną przez Twój dedykowany formularz.
⚡ Przed vs Po wdrożeniu Modułu Velleman
| Zadanie |
❌ Bez modułu |
✅ Z modułem |
| Import 6 000 referencji elektronicznych | 200h+ ręcznie, przepisywanie z portalu B2B Velleman | 1 kliknięcie, ~5h w tle przez auto-restartowany CRON |
| Pobieranie katalogu źródłowego | Ręczne pobieranie przez FTP / extranet B2B + upload do BO | Automatyczne połączenie FTP z 5 polami (host, port, user, pass, path) |
| Wiele zdjęć (do 25 na produkt) | Ręczne pobieranie z CDN, kopia na serwer, upload PS po jednym | 2. CSV mapowania CDN Velleman + automatyczne pobieranie · 1. = okładka |
| Kodowanie Windows-1252 (legacy) | Uszkodzone znaki, akcenty w mojibake (« é », « ° ») | Automatyczna konwersja komórka po komórce przez mb_convert_encoding() |
| CSV 64 kolumny bez nagłówka | Ręczny parsing po indeksie liczbowym, błędy gwarantowane | Mapowanie symboliczne w stałych (COL_SKU, COL_NAME, COL_BULLETS…) |
| Liczby dziesiętne z przecinkiem + prefiks z kropką (.354) | Błędy castowania float, ceny zerowe lub absurdalne | parseDecimal(): przecinek → kropka + leading dot fix (.354 → 0.354) |
| Szczegółowe charakterystyki techniczne (kol. 63) | Płaski tekst, nieczytelny, nie SEO | Parsing w karty według grupy (Fizyczne / Elektryczne / Techniczne / Instalacja) |
| Zgodność GPSR UE 2024 | Ryzyko grzywny UE za brak danych producenta na kartach | Dedykowany formularz 5 pól (producent, adres, e-mail, tel., przedst. UE) — automatyczne wyświetlanie |
| 10 progów cen degresywnych Velleman | Wybór ceny zakupu na oko, niestabilna marża | Selektor progu ceny zakupu (5/25/100/500…) w Ustawieniach |
| Hierarchia kategorii (10 poziomów) | Tworzenie ręczne, godziny pracy nad nomenklaturą | Tworzenie w locie poziom po poziomie pod Twoim rootem PS |
| Odświeżanie cen/stanów | Wszystko od zera każdego dnia | CRON light_sync co 2-4h: tylko aktualizacja cen+stanu (tryb lekki) |
👤 Do kogo skierowany jest ten moduł?
🔬
E-commerce komponenty i moduły
Sprzedajesz rezystory, kondensatory, diody LED, tranzystory, mikrokontrolery (Arduino, Raspberry, ESP32), czujniki, moduły rozszerzeń. Velleman oferuje historyczną gamę, europejską referencję w niszach makers / DIY / edukacja.
🎓
Sklep z zestawami edukacyjnymi i STEM
Zestawy robotyki, zestawy lutownicze dla początkujących, zestawy edukacyjne Arduino, projekty pedagogiczne dla szkół średnich i uczelni technicznych. Velleman EDU to gama dedykowana edukacji od 30 lat.
🎵
E-commerce audio i nagłośnienie
Wzmacniacze, kolumny, mikrofony, miksery, projektory sceniczne LED, lasery efektowe, wytwornice dymu. Velleman oferuje gamę audio pro/półpro (HQ Power, Vonyx, Skytec, Showtec, BoomTone DJ) bardzo poszukiwaną w Europie.
🛠️
Sklep z narzędziami elektronicznymi
Multimetry, oscyloskopy, lutownice, szczypce, śrubokręty precyzyjne, lupy, mikroskopy USB. Narzędzia pomiarowe i naprawcze dla techników, hobbystów, szkół technicznych.
🚨
Sklep bezpieczeństwo i automatyka domowa
Kamery IP, czujniki ruchu, alarmy przewodowe/bezprzewodowe, syreny, kontrola dostępu, zarządzanie oświetleniem. Rosnąca nisza z PERFECT (gama Velleman dedykowana bezpieczeństwu).
🎯 Pełne funkcje Modułu Velleman
🌐 Indywidualne połączenie FTP dla każdego dystrybutora
Specyfika Velleman. Każdy partner-dystrybutor otrzymuje spersonalizowany plik CSV na serwerze FTP Velleman, z własnymi warunkami cenowymi (progi degresywne specyficzne dla Twojego konta). Plik nosi unikalną nazwę (np. TwojPlik.csv). Dane FTP (host, port, user, pass) nigdy nie są współdzielone i pozostają ściśle indywidualne.
Rozwiązanie modułu: 5 pól FTP w Ustawieniach, nigdy hardkodowanych, hasło zamaskowane w bazie i w odpowiedziach JSON. Przycisk "Testuj połączenie FTP", który na żywo waliduje uwierzytelnianie, tryb pasywny i dostępność pliku.
5 pól FTP:
- Host : ftp.velleman.eu (lub wariant regionalny)
- Port : 21 (domyślnie, modyfikowalny)
- User : Twój identyfikator Velleman B2B
- Password : zamaskowane w bazie, nigdy nie wyświetlane jawnie
- Path : /TwojPlik.csv
- Uwierzytelnianie + tryb pasywny przez
ftp_connect + ftp_login + ftp_pasv (kompatybilne z prawie wszystkimi firewallami)
- Weryfikacja rozmiaru pliku (
ftp_size) przed pobraniem, aby odrzucić puste/uszkodzone pliki
- Pobieranie curl przez URL
ftp://user:pass@host:port/path — solidne i wydajne
- Bezpieczne hasło: przechowywane szyfrowane, zamaskowane w odpowiedzi JSON (powtórzone •), nigdy nie logowane
📊 CSV 64 kolumny Windows-1252 — Solidny parsing
CSV Velleman zawiera 64 kolumny bez nagłówka (pierwszy rekord = dane, nie nagłówki), zakodowane w Windows-1252 (legacy europejskie) z separatorem średnika. Moduł obsługuje te odziedziczone specyfiki:
- Mapowanie symboliczne w stałych PHP:
COL_SKU=0, COL_NAME=1, COL_INTRO=2, COL_RECYCLE_NAME=23, …, COL_CAT_FROM=37, COL_CAT_TO=46, COL_PACKAGING=53, COL_STOCK=58, COL_BULLETS=61, COL_TECH_DETAILS=62. Koniec z magic numbers, kod czytelny i utrzymywalny.
- Konwersja Windows-1252 → UTF-8 komórka po komórce przez
mb_convert_encoding() z wstępną detekcją, czy już jest poprawne UTF-8
- Parsing dziesiętnych europejski: przecinek → kropka automatycznie dla cen, wag, wymiarów
- Fix leading dot: ".354" → "0.354" automatycznie (inaczej cast float robi cokolwiek)
- Strumieniowanie do plików JSON: 1 wiersz CSV → 1 plik
uploads/state/full_import_rows/<idx>.json, aby umożliwić precyzyjne wznowienie po przerwie
📸 Wiele zdjęć — do 25 na produkt przez CDN Velleman
Innowacja unikalna dla modułu Velleman: 2. CSV mapowania zdjęć jest pobierany automatycznie z publicznego CDN Velleman (URL hardkodowany w kodzie, nigdy widoczny po stronie klienta), który wiąże każdy SKU z listą URL-i zdjęć produktu (do 25 widoków). Moduł rozdziela, waliduje każdy URL i importuje wszystkie zdjęcia w kolejności.
- 1. URL = okładka automatycznie
- Walidacja HEAD HTTP (curl NOBODY) przed pobraniem: uszkodzone URL-e odrzucane bez krachu importu
- Cache 24h: mapowanie jest automatycznie ponownie pobierane tylko jeśli ma więcej niż 24h, oszczędza pasmo
- Automatyczne generowanie wszystkich rozmiarów PS (small, medium, large, home_default…)
- Fix BO PrestaShop 9 wbudowany: kopia 1:1 oryginalnego pliku
<id>.jpg oprócz wariantów (inaczej uszkodzone zdjęcie na stronie edycji produktu w BO)
🏆 Opis PREMIUM generowany automatycznie — 10 sekcji aktywowalnych
Moduł komponuje automatycznie wizualnie bogatą kartę produktową, ustrukturyzowaną w 10 niezależnie aktywowalnych sekcji przez przełączniki w zakładce Opcje. Każda sekcja ma swój design, kolory, ikony, cel SEO/konwersji:
| Sekcja | Opis |
|---|
| 🏷️ Panel tożsamości | Kolorowy nagłówek: marka, referencja, EAN + odznaka statusu (Nowość / Wkrótce / Dostępny w magazynie) |
| 📝 Krótki wstęp | Skrócony opis dostarczany przez Velleman (kol. 3) — 1-2 zdania dla ogólnego kontekstu |
| ✨ Kluczowe punkty (lista) | Przekształca "•" pola długiego opisu w stylizowaną listę punktowaną (niebieska ramka) |
| 🔬 Karty techniczne | Parsuje "Szczegółowe charakterystyki" (kol. 63) w karty wizualne według grupy (Kolor, Napięcie, Pojemność, Pitch, Montaż…) |
| 📐 Wymiary i waga | Tabela szerokość / wysokość / głębokość / waga z kolumn 55-58 |
| 📦 Opakowanie | Typ opakowania (luzem/zestaw), wielokrotność zamówienia, ilość w kartonie wewnętrznym/zewnętrznym |
| 🌍 Pochodzenie + kod HS | Kraj pochodzenia + kod celny Intrastat (przydatne B2B + zgodność handlu intra/extra UE) |
| ♻️ Eko-składka | Blok WEEE / środowisko (kol. 23-27) — przejrzystość dla klienta, zgodność środowiskowa |
| ✅ Zgodność GPSR | Dane producenta + przedstawiciel UE — z Twojego dedykowanego formularza w Ustawieniach |
| 📞 CTA dostawcy | Blok na dole karty: "Masz pytanie?" + nazwa sklepu + klikalny telefon + okres gwarancji |
Wszystkie sekcje można indywidualnie aktywować/dezaktywować w zakładce Opcje. Możesz aktywować wszystko dla bardzo bogatych kart lub wyłączyć wszystko poza tożsamością + CTA dla minimalistycznego wyglądu.
✅ Zgodność GPSR UE 2024 — Dedykowany formularz
Rozporządzenie GPSR (General Product Safety Regulation) Unii Europejskiej, obowiązujące od 13 grudnia 2024 r., nakazuje wszystkim e-sprzedawcom w strefie wyświetlać na każdej karcie produktu dane producenta (oraz przedstawiciela UE, jeśli producent spoza UE). Brak = grzywna.
Rozwiązanie modułu: dedykowany panel w zakładce Ustawienia z 5 polami wszystkimi opcjonalnymi, które wypełniasz tylko raz. Dane wyświetlane są automatycznie na wszystkich kartach produktowych Velleman.
- Nazwa producenta (np. "Velleman Group NV")
- Pełny adres pocztowy (ulica, kod pocztowy, miasto, kraj)
- E-mail kontaktowy (klikalny przez
mailto:)
- Telefon (klikalny przez
tel:)
- Przedstawiciel UE (tylko jeśli producent spoza UE — zostaw puste dla Velleman Belgia)
Inteligentne wyświetlanie warunkowe: sekcja GPSR wyświetla się na kartach produktowych tylko jeśli wypełnione jest co najmniej jedno pole. Możesz wystartować bez GPSR, moduł nie zawiedzie. Format wizualny w jasnoczerwonym, aby przypomnieć o jego regulacyjnym charakterze.
💰 10 progów cen degresywnych Velleman
Velleman oferuje do 10 progów cen degresywnych w zależności od ilości zakupowych (typowo: 1, 5, 10, 25, 50, 100, 250, 500, 1000, 5000+). Każdy próg ma własną cenę netto wynegocjowaną w Twoim kontrakcie B2B Velleman.
Rozwiązanie modułu: selektor w Ustawieniach, aby wybrać próg odpowiadający Twojemu rzeczywistemu średniemu wolumenowi zakupów. Moduł używa tego progu jako jednolitej ceny zakupu do obliczenia ostatecznej ceny sprzedaży zgodnie z Twoim trybem (margins / fixed / wholesale).
- Selektor progu: 1 / 5 / 25 / 100 / 500 (domyślnie 5, najczęstszy dla MŚP)
- Tryb margins: 6 progów marży konfigurowalnych według przedziału ceny netto
- Tryb fixed: 1 markup w % stosowany jednolicie (np. 50%)
- Tryb wholesale: cena zakupu netto bez zmian (sprzedaż B2B do szkół, makers space itp.)
🌳 Hierarchia kategorii na 10 poziomach
CSV Velleman dostarcza do 10 kolumn "Tytuł kategorii 1..10" tworzących głęboką liniową hierarchię (root → dziecko → wnuk → prawnuk…). Każdy produkt należy do liścia na końcu łańcucha kategorii.
Rozwiązanie modułu: tworzenie w locie brakujących kategorii pod Twoim skonfigurowanym rootem PrestaShop. Lookup przed utworzeniem (anty-duplikaty) z zoptymalizowanym zapytaniem SQL.
Przykład:
"Komponenty Elektroniczne i Akcesoria"
→ "Komponenty elektroniczne"
→ "Kondensatory"
→ "Tantalowe"
→ "Niska wysokość"
→ ...
- Tworzenie wielojęzyczne pod Twoim rootem PS (wszystkie aktywne języki otrzymują tę samą nazwę + slug)
- Lookup przed create: SELECT po nazwie + parent → jeśli znaleziona, użycie istniejącego ID
- Pełne powiązanie produktu:
id_category_default = najgłębszy liść, category_product wypełniony całym łańcuchem (filtry facetedsearch działają na wszystkich poziomach)
- Automatyczny slug przez
VlCompat::slug() (URL-safe, akcenty znormalizowane)
⚡ Architektura import w czasie rzeczywistym + CRON 24/7
Scenariusz, który zmienia wszystko:
- 📥 Przygotowanie: moduł łączy się z FTP Velleman, pobiera Twój spersonalizowany CSV (do 10 MB), strumieniowo go parsuje i zapisuje każdy wiersz do osobnego pliku JSON
- 📦 Mapowanie CDN zdjęć: automatyczne pobieranie 2. CSV CDN Velleman (cache 24h, URL niewidoczny po stronie klienta)
- 🚀 Import "1 wiersz CSV = 1 wywołanie AJAX": brak zamrożenia na 5 godzin, widzisz każdy produkt tworzony jeden po drugim
- 📊 Niebiesko-złoty pasek postępu: procent na żywo + licznik X/Y
- 📋 Dziennik na żywo: kolorowa odznaka (Utworzony / Zaktualizowany / Pominięty / Błąd) + referencja + nazwa produktu + ID PS#
- ⏸️ Przycisk Zatrzymaj w dowolnym momencie, precyzyjne wznowienie od linii zatrzymania
- 📈 Statystyki na żywo: Przetworzone wiersze · Utworzone · Zaktualizowane · Pominięte · Błędy
→ Koniec ze zwolnioną stroną. Koniec z niepokojem. Widzisz wszystko, co się dzieje.
⏰ CRON 24/7 — 4 zautomatyzowane akcje
| Akcja CRON |
Rola |
Zalecana częstotliwość |
full_import | Pełny import (utworzenia + light updates) | 1×/dzień (godziny niskiego ruchu) |
light_sync | Aktualizacja cen + stanu + dostępności już zaimportowanych produktów | co 2-4h |
rebuild_tags | Odbudowa tagów PS na wszystkich już zaimportowanych produktach (przydatne po modyfikacji reguł tagowania) | na żądanie |
cleanup_logs | Czyszczenie logów > N dni (retencja konfigurowalna) | 1×/tydzień |
- Klucz tajny 32 znaki hex generowany przy instalacji — Twoich URL-i CRON nie da się odgadnąć
- Regeneracja jednym kliknięciem klucza w razie wycieku
- Asynchroniczny auto-restart przez curl loopback: auto-rappel w tle, jeśli osiągnięto time-budget (60s domyślnie), przetrwanie przez
@ignore_user_abort(true)
- Precyzyjne wznowienie: wznawia dokładnie od linii, na której się zatrzymał
- Lock anty-konkurencja przez flock: brak równoległych wykonań
- Przycisk Stop w BO do czystego zatrzymania CRON-a w toku (flag file)
- Limit produktów na wykonanie konfigurowalny (10-100 do walidacji w trybie testu, 0 = nieograniczony w produkcji)
- Flash "zadanie uruchomione w tle" natychmiastowy po kliknięciu Test BO — od razu wiesz, że serwer pracuje
🏷️ Katalog Velleman w liczbach
~6 000
referencji elektronicznych
10
progów cen degresywnych
64
parsowanych kolumn CSV
🇧🇪
belgijski hurtownik UE
Wszechświat produktów katalogu Velleman (wybór według głównych rodzin):
Komponenty pasywne
Moduły Arduino/Raspberry
Zestawy edukacyjne
Audio pro / DJ
Oświetlenie sceniczne LED
Lasery efektowe
Narzędzia pomiarowe
Bezpieczeństwo / Domotyka
Złącza RJ45/HDMI
Robotyka STEM
+ akcesoria różne
Marki wewnętrzne Velleman: Velleman Kit (zestawy lutownicze), Velleman Modules, Vellight (oświetlenie), HQ Power (audio pro), Vonyx, Skytec, Showtec, BoomTone DJ, Perfect (bezpieczeństwo), Toolland (narzędzia), Velleman EDU (edukacja).
🛠️ Konserwacja — Selektywne usuwanie
- ☐ Zaimportowane produkty: detekcja z 2 źródeł (tabela meta + id_supplier), kompatybilne z PS9 multi-shop z fallback wipe SQL, jeśli
Product::delete() zwraca false
- ☐ Puste kategorie: skanowanie według malejącej głębokości przez nleft/nright, usunięcie tylko jeśli zero powiązanych produktów + zero podkategorii (zachowuje rooty PS_HOME, PS_ROOT)
- ☐ Marka Velleman: usuwa producenta tylko jeśli nie ma już żadnego powiązanego produktu (wymagane podwójne potwierdzenie)
- ☐ Dzienniki wewnętrzne: truncate tabel history i import_errors
Pojedyncze lub podwójne potwierdzenie zależnie od zakresu, z dedykowaną zakładką Narzędzia → Selektywne usuwanie. Drzewo kategorii jest zachowywane, jeśli masz produkty gdzieś indziej (nie-Velleman), które ich nadal używają.
⭐ 12 powodów, by wybrać Moduł Velleman
- 🌐 Indywidualne połączenie FTP dla każdego dystrybutora (5 pól) — każdy klient ma swój ponumerowany plik, swoje osobiste progi
- 📸 Wiele zdjęć — do 25 widoków/produkt przez 2. CSV CDN (URL hardkodowany niewidoczny dla klienta) — innowacja unikalna dla Velleman
- 🏆 Opis PREMIUM 10 sekcji indywidualnie aktywowalnych (panel, wstęp, kluczowe punkty, karty techniczne, wymiary, opakowanie, pochodzenie, eko, GPSR, CTA)
- ✅ Zgodność GPSR UE 2024 przez dedykowany formularz (5 pól opcjonalnych) — automatyczne wyświetlanie na wszystkich kartach
- 🌳 10 poziomów kategorii hierarchicznych tworzonych w locie — zarządzanie głębokimi drzewami specyficznymi dla komponentów
- 💰 10 progów cen degresywnych Velleman + selektor ceny zakupu w Ustawieniach
- 🔬 Inteligentny parsing szczegółowych charakterystyk (kol. 63): 1 sekcja = 1 wizualna karta (Fizyczne / Elektryczne / Techniczne / Instalacja)
- 🌍 Kodowanie Windows-1252 auto-konwertowane do UTF-8 komórka po komórce (zachowuje "Métré", "Réservé", techniczne znaki europejskie)
- 🔢 Liczby dziesiętne z przecinkiem + prefiksy z kropką auto-poprawiane (np.: .354 → 0.354 — inaczej cast float pada)
- ⚡ Import w czasie rzeczywistym produkt po produkcie: pasek live, dziennik konsoli, przycisk Zatrzymaj, precyzyjne wznowienie
- ⏰ Bezpieczny CRON 24/7 z time-budget, asynchronicznym auto-restartem, retry, lock, trybem testu, ogranicznikiem produktów
- 💎 Brak AdminController, brak zakładki BO, brak override: nie zaśmieca menu, nie psuje innych modułów
🎬 Jak to działa w 5 krokach
1
Zainstaluj moduł
Pobierz ZIP, zainstaluj przez BO. Auto-tworzenie 3 tabel, dostawcy Velleman, klucza CRON.
2
Wpisz 5 pól FTP
Poproś swojego handlowca Velleman o dostęp (host, user, pass, ścieżka spersonalizowanego pliku). Przetestuj połączenie jednym kliknięciem.
3
Skonfiguruj marże + GPSR
Wybierz próg ceny zakupu (5/25/100…). Tryb marży (6 progów), markup stały lub wholesale. Wypełnij opcjonalny formularz GPSR.
4
Skomponuj 10 sekcji
Zakładka Opcje: aktywuj/dezaktywuj każdą z 10 sekcji opisu PREMIUM (wszystko ON domyślnie).
5
Uruchom import
Najpierw tryb testu 10 produktów, aby zwalidować, potem pełny import ~6 000 produktów (~5h przez auto-restartowany CRON).
🔧 Kompatybilność techniczna
| PrestaShop | 1.7.x → 9.x (testowane na PS 9.0) |
| PHP | 7.4 minimum, zalecane 8.1+ |
| MySQL / MariaDB | 5.7+ / 10.3+ |
| cURL + ext FTP | Aktywne (pobieranie FTP CSV + zdjęć CDN) |
| Multi-shop | Kompatybilny (wymusza CONTEXT_ALL przy usuwaniu) |
| Używane hooki | Żadne (brak zaśmiecania łańcucha zdarzeń) |
| Override klas | Żadne (zachowuje Twoje inne moduły) |
| AdminController | Żaden |
| Zakładka sidebar BO | Żadna (nie zaśmieca menu) |
| Konto Velleman B2B | Wymagane konto partnera-dystrybutora (indywidualny dostęp FTP + wynegocjowane progi) |
| Dane logowania FTP | Należy poprosić swojego handlowca Velleman (host, port, user, pass, ścieżka pliku) |
❓ Najczęściej zadawane pytania
P: Czy Moduł Velleman działa na PrestaShop 9?
O: Tak, w pełni kompatybilny z PS 9.x. Moduł obsługuje migrację specyficzną dla PS9, gdzie meta_keywords zostały usunięte (auto-przełączenie na ps_tag), a także bug PS9, gdzie oryginalny obraz nie pojawia się na stronie edycji produktu w BO (fix przez kopię 1:1 pliku <id>.jpg). Wszystkie znaki zabronione przez PS9 (<>{}) są oczyszczane przed Tag::addTags(), aby uniknąć odrzucenia całej listy.
P: Dlaczego łączyć się przez FTP zamiast klasycznego HTTPS?
O: To decyzja Velleman. Każdy partner-dystrybutor otrzymuje spersonalizowany plik CSV na serwerze FTP B2B Velleman, ze swoimi indywidualnymi progami cenowymi. Brak publicznego URL HTTPS. Moduł obsługuje tę specyfikę: 5 pól FTP, bezpieczne zamaskowane hasło, tryb pasywny kompatybilny z firewallem, weryfikacja rozmiaru przed pobraniem.
P: Czym dokładnie jest 2. CSV mapowania zdjęć?
O: Velleman publikuje 2. publiczny CSV na swoim CDN, który wiąże każdy SKU z listą URL-i zdjęć produktu (do 25 widoków: przód, tył, bok, w dłoni, opakowanie, schemat, instrukcja…). URL CDN jest hardkodowany w kodzie modułu (nigdy widoczny po stronie klienta) — nie musisz nic konfigurować. Mapowanie jest przeładowywane automatycznie co 24h.
P: CSV jest w Windows-1252 — jak moduł to obsługuje?
O: Moduł konwertuje każdą komórkę z Windows-1252 do UTF-8 przez mb_convert_encoding() (z auto-detekcją, czy komórka jest już poprawnym UTF-8). Techniczne znaki europejskie (stopnie °, mikro µ, om Ω, plus-or-minus ±, itd.) są zachowane. Dziesiętne z przecinkiem konwertowane na kropkę. Prefiksy z kropką (.354) poprawiane na (0.354), aby uniknąć błędnych castów float.
P: Czy zgodność GPSR jest obowiązkowa?
O: Tak, od 13 grudnia 2024 r. w całej UE. Jednak moduł nie zmusza do wypełnienia formularza — wszystkie 5 pól jest opcjonalnych. Możesz wystartować bez GPSR (do testów), a następnie wypełnić formularz przed publikacją. Sekcja wyświetla się na kartach tylko jeśli wypełnione jest co najmniej jedno pole.
P: Jak wybrać odpowiedni próg ceny degresywnej?
O: Selektor w Ustawieniach proponuje typowe progi Velleman (1, 5, 25, 100, 500). Wybierz ten, który odpowiada Twojemu rzeczywistemu średniemu wolumenowi zakupów. Jeśli kupujesz partiami po 25 dla większości referencji, wybierz 25. Moduł użyje tego progu jako ceny zakupu do obliczenia ostatecznej ceny sprzedaży (zgodnie z trybem margins/fixed/wholesale).
P: Czy mogę dezaktywować niektóre sekcje opisu PREMIUM?
O: Tak, każda z 10 sekcji (panel tożsamości, wstęp, kluczowe punkty, karty techniczne, wymiary, opakowanie, pochodzenie, eko-składka, GPSR, CTA) może być indywidualnie aktywowana/dezaktywowana przez przełącznik w zakładce Opcje. Wszystko jest ON domyślnie, aby zaoferować najbogatszą kartę, ale możesz wyłączyć wszystko poza tożsamością + CTA dla minimalistycznego wyglądu.
P: Czy mogę importować ten sam CSV wiele razy?
O: Tak. Tryb lekki automatyczny (akcja CRON light_sync): istniejące produkty są wykrywane przez ich unikalny SKU i odświeżane są tylko ich cena + stan. Twoje opisy, zdjęcia, kategorie i tagi spersonalizowane nie są nadpisywane — Twoje modyfikacje BO są zachowane.
P: Jak usunąć wszystkie produkty Velleman?
O: Zakładka Narzędzia → Selektywne usuwanie → zaznacz "Zaimportowane produkty" + "Puste kategorie" + "Marka Velleman" + "Dzienniki" → Wykonaj. Pojedyncze lub podwójne potwierdzenie zależnie od zakresu. Drzewo jest zachowywane, jeśli używają go produkty nie-Velleman.
P: A jeśli chcę zatrzymać import w toku?
O: Przycisk "Zatrzymaj" dostępny podczas importu (UI) i podczas CRON (flag file). Czyste zatrzymanie po zakończeniu bieżącego produktu, precyzyjny zapis stanu do wznowienia od dokładnej linii zatrzymania. Moduł przeżywa nawet restart serwera dzięki strumieniowi JSON na plik.
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. Dostawca Velleman jest powiązany ze wszystkimi aktywnymi sklepami przez ps_supplier_shop.
P: Brak AdminController, brak zakładki BO?
O: Potwierdzone. Moduł używa wyłącznie getContent() + AJAX. Brak zaśmiecania menu BO PrestaShop. Brak override klasy core. Brak hooków (łańcuch zdarzeń PS pozostaje nienaruszony). Twoje inne moduły nie są dotknięte ani przy instalacji, ani przy odinstalowaniu.
⚡ Gotowy zautomatyzować swój dropshipping elektroniczny?
Moduł Velleman dropshipping komponenty elektroniczne moduły zestawy FTP to najbardziej kompletne narzędzie do sprzedaży ~6 000 referencji Velleman (komponenty, moduły Arduino/Raspberry, zestawy edukacyjne, audio pro, oświetlenie sceniczne, narzędzia, bezpieczeństwo) na PrestaShop. Skonfigurowany raz, automatycznie pobiera Twój spersonalizowany katalog przez FTP, importuje do 25 zdjęć na produkt z CDN, generuje opis PREMIUM 10 sekcji i pozostaje zgodny z GPSR UE 2024.
⚡ INSTALACJA 5 MIN · 📚 IMPORT W CZASIE RZECZYWISTYM · 🛡️ KOMPATYBILNY PS 1.7 → 9 · ✅ GPSR UE 2024 · 🇵🇱 WSPARCIE
📋 Szczegóły techniczne dla deweloperów
Utworzone tabele BD (3): wp_velleman_product_meta (sku unique, id_product, ean, last_price, wholesale, last_stock, dates), wp_velleman_history (event_type, message, payload JSON, date_add), wp_velleman_import_errors (error_type, csv_index, sku, message, payload).
Konfiguracje PS: WPVL_SETTINGS (JSON 30+ kluczy), WPVL_SUPPLIER_ID, WPVL_CRON_KEY, WPVL_LAST_IMPORT_AT, WPVL_CRON_LAST_*.
CSV Velleman (64 kolumny Windows-1252, separator średnik, bez nagłówka): COL_SKU=0, COL_NAME=1, COL_INTRO=2, COL_RECYCLE_NAME=23, COL_RECYCLE_PRICE=24, COL_ECO_NAME=25, COL_ECO_PRICE=26, COL_CURRENCY=27, COL_HS_CODE=29, COL_ORIGIN=30, COL_OBSOLETE=31, COL_COMING_SOON=32, COL_NEW=33, COL_THUMB=34, COL_MAIN_IMG=35, COL_BRAND_CODE=36, COL_CAT_FROM=37, COL_CAT_TO=46, COL_QTY_INNER=47, COL_QTY_OUTER=48, COL_EAN=49, COL_PACKAGING=53, COL_WIDTH=54, COL_HEIGHT=55, COL_DEPTH=56, COL_WEIGHT=57, COL_STOCK=58, COL_BULLETS=61, COL_TECH_DETAILS=62.
Architektura: 8 klas PHP (VlCompat, VlCsvImporter, VlCategoryMapper, VlDescriptionBuilder, VlTagBuilder, VlFeatureMapper, VlMediaDownloader, VlParameterMapper) + moduł główny + dispatcher AJAX + CRON. Brak override klasy core PrestaShop, brak hooków, brak AdminController, brak zakładki BO.
FTP: pobieranie przez VlCompat::downloadFromFtp() (curl URL ftp://user:pass@host:port/path). Test połączenia przez ftp_connect + ftp_login + ftp_pasv + ftp_size. Hasło przechowywane szyfrowane w WPVL_SETTINGS, zamaskowane w odpowiedziach JSON (powtórzone •).
Kodowanie: konwersja Windows-1252 → UTF-8 komórka po komórce przez mb_convert_encoding() z wstępną detekcją, czy już jest poprawne UTF-8. parseDecimal(): przecinek → kropka + leading dot fix (.354 → 0.354).
Wiele zdjęć CDN: VlCompat::downloadPicturesMappingCsv() pobiera 2. CSV mapowania z hardkodowanego URL VL_PICTURES_MAPPING_URL. Cache 24h. loadPicturesMapping() zwraca tablicę SKU → [URL1, URL2, …, URL25]. importMultiImages() wywołuje imageUrlExists() (curl HEAD NOBODY) następnie ImageManager::resize, fix BO PS9 przez kopię 1:1 oryginalnego pliku.
Strumieniowanie JSON: streamParseToFiles() zapisuje każdy wiersz CSV do pliku uploads/state/full_import_rows/<idx>.json. Pozwala na precyzyjne wznowienie po przerwie + odporność na restarty serwera.
Auto-restart CRON: przez asynchroniczny curl loopback do tego samego endpointu z kluczem tajnym. Time-budget 60s domyślnie, @ignore_user_abort(true) dla przetrwania podczas restartu. Lock anty-konkurencja przez flock na uploads/state/cron_*.lock.
VlCategoryMapper: resolveChainOrCreate(array $names) na 10 poziomach. Lookup SQL przed Category::add() (anty-duplikaty przez SELECT po nazwie + parent — bez LIMIT 1, ponieważ PrestaShop dodaje go automatycznie, duplikacja = krytyczny błąd SQL). Slug przez VlCompat::slug(). Wielojęzyczność (wszystkie aktywne języki otrzymują tę samą nazwę).
GPSR UE 2024: 5 pól settings (gpsr_manufacturer_name, gpsr_address, gpsr_email, gpsr_phone, gpsr_eu_representative) wszystkie opcjonalne. VlDescriptionBuilder czyta settings (nigdy CSV dla GPSR — decyzja produktowa). Wyświetlanie warunkowe: sekcja wyświetla się tylko jeśli wypełnione jest co najmniej jedno pole. E-mail + telefon klikalne (mailto: / tel:).
Bezpieczeństwo: pSQL() wszędzie, folder uploads/ chroniony przez index.php redirect, walidacja HEAD HTTP zdjęć, natywne CSRF PS na AJAX, systematyczne escape HTML, hash_equals() na kluczu CRON, hasło FTP zamaskowane w odpowiedziach.
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 oryginalne zdjęcie, czyszczenie <>{} przed Tag::addTags() (inaczej Validate::isGenericName odrzuca całą listę).
Multi-shop: ensureSupplierExists() w bezpośrednim INSERT SQL (bypass new Supplier() + ->add(), które po cichu pada w PS9). Dynamiczna detekcja kolumny meta_keywords w ps_supplier_lang (obecna w PS7, usunięta w PS9). Powiązanie ps_supplier_shop ze wszystkimi aktywnymi sklepami.
📦 Moduł stworzony przez WebPoint · webpoint.fr · Regularne aktualizacje · Czysty i komentowany kod
