Moduł Velleman Dropshipping Komponenty Elektroniczne PrestaShop — Katalog FTP 6 000 referencji (Moduły, Zestawy, Audio)

Moduł PrestaShop dropshippingu VELLEMAN

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

👤 Do kogo skierowany jest ten moduł?

🎯 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:

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

⏰ CRON 24/7 — 4 zautomatyzowane akcje

• 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

Wszechświat produktów katalogu Velleman (wybór według głównych rodzin):

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

1. 🌐 Indywidualne połączenie FTP dla każdego dystrybutora (5 pól) — każdy klient ma swój ponumerowany plik, swoje osobiste progi
2. 📸 Wiele zdjęć — do 25 widoków/produkt przez 2. CSV CDN (URL hardkodowany niewidoczny dla klienta) — innowacja unikalna dla Velleman
3. 🏆 Opis PREMIUM 10 sekcji indywidualnie aktywowalnych (panel, wstęp, kluczowe punkty, karty techniczne, wymiary, opakowanie, pochodzenie, eko, GPSR, CTA)
4. ✅ Zgodność GPSR UE 2024 przez dedykowany formularz (5 pól opcjonalnych) — automatyczne wyświetlanie na wszystkich kartach
5. 🌳 10 poziomów kategorii hierarchicznych tworzonych w locie — zarządzanie głębokimi drzewami specyficznymi dla komponentów
6. 💰 10 progów cen degresywnych Velleman + selektor ceny zakupu w Ustawieniach
7. 🔬 Inteligentny parsing szczegółowych charakterystyk (kol. 63): 1 sekcja = 1 wizualna karta (Fizyczne / Elektryczne / Techniczne / Instalacja)
8. 🌍 Kodowanie Windows-1252 auto-konwertowane do UTF-8 komórka po komórce (zachowuje "Métré", "Réservé", techniczne znaki europejskie)
9. 🔢 Liczby dziesiętne z przecinkiem + prefiksy z kropką auto-poprawiane (np.: .354 → 0.354 — inaczej cast float pada)
10. ⚡ Import w czasie rzeczywistym produkt po produkcie: pasek live, dziennik konsoli, przycisk Zatrzymaj, precyzyjne wznowienie
11. ⏰ Bezpieczny CRON 24/7 z time-budget, asynchronicznym auto-restartem, retry, lock, trybem testu, ogranicznikiem produktów
12. 💎 Brak AdminController, brak zakładki BO, brak override: nie zaśmieca menu, nie psuje innych modułów

🎬 Jak to działa w 5 krokach

🔧 Kompatybilność techniczna

❓ Najczęściej zadawane pytania

📦 Moduł stworzony przez WebPoint · webpoint.fr · Regularne aktualizacje · Czysty i komentowany kod