PrestaShop modul pro dropshipping VELLEMAN
🔌 ⚡ 🔬
Modul Velleman Dropshipping Elektronickych Soucastek
Modul, ktery automatizuje od A do Z vas dropshipping soucastek, modulu, kitu a audia v PrestaShopu
PrestaShop 1.7 → 9.x · ~6 000 produktu · zabezpeceny FTP · 25 obrazku/produkt · CRON 24/7 · GPSR EU 2024
Spoustite obchod s elektronickymi soucastkami, specializovany web Arduino / Raspberry / DIY makers, e-shop s jevistnim osvetlenim ci profesionalnim audiem? Pracujete s Velleman Group (historicky belgicky velkoobchodnik zalozeny v roce 1976, evropska reference v oblasti soucastek, modulu, vzdelavacich kitu, ozvuceni, jevistniho svetla, mericich pristroju) a travite dny prepisovanim 6 000 produktovych listu, manualnim nahravanim 25 fotek na produkt, opetovnym vytvarenim kategorii v 10 hierarchickych urovnich, rucnim parsovanim detailnich technickych specifikaci (Fyzicke / Elektricke / Technicke / Instalace), spravovanim 10 cenovych pasem se slevou podle vasich nakupnich objemu?
S Modulem Velleman dropshipping elektronicke soucastky moduly kity FTP se vse stane automatickym. Zadate sve FTP pristupy Velleman (host, port, user, pass, cesta k vasemu personalizovanemu souboru), kliknete na "Spustit import" a modul stahne vase CSV s 64 sloupci v kodovani Windows-1252, prevede ho do UTF-8 bunku po bunce, stahne 2. CSV s mapovanim obrazku z CDN Velleman (URL pevne zakodovana, neviditelna pro klienta) a vytvori vasich ~6 000 PrestaShop produktu ve stromove strukture s 10 urovnemi generovane za behu, kazdy s jeho PREMIUM listem 10 sekci (banner identity znacky + EAN + status, kratky uvod, klicove body, karty technickych parametru, rozmery, baleni, puvod, eko-prispevek, soulad GPSR EU 2024, CTA dodavatele), az 25 obrazky na produkt a evropskym souladem GPSR napajenym vasim dedikovanym formularem.
⚡ Pred vs Po Modulu Velleman
| Ukol |
❌ Bez modulu |
✅ S modulem |
| Import 6 000 elektronickych referenci | 200h+ manualne, prepis z B2B portalu Velleman | 1 klik, ~5h na pozadi pres CRON s automatickym restartem |
| Stazeni zdrojoveho katalogu | Manualni stazeni pres FTP / B2B extranet + upload do BO | Automaticke FTP pripojeni s 5 poli (host, port, user, pass, path) |
| Multi-obrazky (az 25 na produkt) | Manualni stazeni z CDN, kopirovani na server, upload do PS po jednom | 2. CSV mapovani CDN Velleman + automaticky download · 1. = obal |
| Kodovani Windows-1252 (legacy) | Rozbite ceske znaky, diakritika v mojibake (« é », « ° ») | Automaticka konverze bunku po bunce pres mb_convert_encoding() |
| CSV s 64 sloupci bez headeru | Manualni parsing podle ciselneho indexu, chyby zarucene | Symbolicke mapovani v konstantach (COL_SKU, COL_NAME, COL_BULLETS…) |
| Desetinna carka + tecka prefix (.354) | Chyby pretypovani na float, ceny 0 nebo nesmyslne | parseDecimal(): carka → tecka + leading dot fix (.354 → 0.354) |
| Detailni technicke parametry (sloupec 63) | Plain text, necitelne, bez SEO | Parsing do karet podle skupiny (Fyzicke / Elektricke / Technicke / Instalace) |
| Soulad GPSR EU 2024 | Riziko pokuty EU za chybejici udaje vyrobce na produktovych listech | Dedikovany formular 5 poli (vyrobce, adresa, email, tel, zastupce EU) — automaticke zobrazeni |
| 10 cenovych pasem Velleman | Volba nakupni ceny od oka, nestabilni marze | Volic nakupniho cenoveho pasma (5/25/100/500…) v Nastaveni |
| Hierarchie kategorii (10 urovni) | Manualni vytvareni, hodiny na sjednoceni nomenklatury | Vytvareni za behu uroven po urovni pod vasi PS root |
| Aktualizace cen/skladu | Vse delat znovu od nuly kazdy den | CRON light_sync 2-4h: pouze update cen+skladu (lehky rezim) |
👤 Pro koho je tento modul urcen?
🔬
E-shop soucastky a moduly
Prodavate rezistory, kondenzatory, LED, tranzistory, mikrokontrolery (Arduino, Raspberry, ESP32), senzory, rozsirujici moduly. Velleman nabizi historicky sortiment uznavany v Evrope v techto nikach makers / DIY / vzdelavani.
🎓
Obchod se vzdelavacimi kity a STEM
Roboticke kity, pajici kity pro zacatecniky, vyukove Arduino kity, pedagogicke projekty pro skoly a inzenyrske skoly. Velleman EDU je sortiment urceny vzdelavani jiz 30 let.
🎵
E-shop audio a ozvuceni
Zesilovace, reproduktory, mikrofony, mixazni pulty, jevistni LED reflektory, efektove lasery, mlhostroje. Velleman nabizi pro/semi-pro audio sortiment (HQ Power, Vonyx, Skytec, Showtec, BoomTone DJ) velmi zadany v Evrope.
🛠️
Obchod elektronicke naradi
Multimetry, osciloskopy, pajecky, klestě, presne sroubovaky, lupy, USB mikroskopy. Mericí a opravarenske pristroje pro techniky, hobbyisty, technicke skoly.
🚨
Obchod bezpecnost a domotika
IP kamery, detektory pohybu, dratove/bezdratove alarmy, sireny, kontrola pristupu, rizeni osvetleni. Rostouci nika s PERFECT (sortiment Velleman pro bezpecnost).
🎯 Kompletni funkce Modulu Velleman
🌐 Individualni FTP pripojeni pro kazdeho prodejce
Specifikum Velleman. Kazdy partnersky prodejce dostava personalizovany CSV soubor na FTP serveru Velleman s vlastnimi cenovymi podminkami (slevova pasma specificka pro vas ucet). Soubor ma unikatni nazev (napr. VasSoubor.csv). FTP pristupy (host, port, user, pass) nejsou nikdy sdilene a zustavaji prisne individualni.
Reseni prijate modulem: 5 FTP poli v Nastaveni, nikdy zakodovana napevno, heslo skryte v BDD i v JSON odpovedich. Tlacitko "Otestovat FTP pripojeni", ktere v realnem case overuje autentizaci, pasivni rezim a dostupnost souboru.
5 FTP poli:
- Host : ftp.velleman.eu (nebo regionalni varianta)
- Port : 21 (vychozi, lze upravit)
- User : vase Velleman B2B prihlasovaci jmeno
- Password : skryte v databazi, nikdy nezobrazene v plaintextu
- Path : /VasSoubor.csv
- Autentizace + pasivni rezim pres
ftp_connect + ftp_login + ftp_pasv (kompatibilni s temer vsemi firewally)
- Overeni velikosti souboru (
ftp_size) pred stazenim pro odmitnuti prazdnych/poskozenych souboru
- Stahovani pres curl URL
ftp://user:pass@host:port/path — robustni a vykonne
- Zabezpecene heslo: ulozene sifrovane, skryte v JSON odpovedi (• opakovane), nikdy logovane
📊 CSV 64 sloupcu Windows-1252 — Robustni parsing
CSV Velleman obsahuje 64 sloupcu bez headeru (prvni zaznam = data, ne hlavicky), kodovany ve Windows-1252 (legacy evropske) se separatorem strednikem. Modul resi tyto zdedene zvlastnosti:
- Symbolicke mapovani v PHP konstantach:
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. Zadne magicke cislice, citelny a udrzovatelny kod.
- Konverze Windows-1252 → UTF-8 bunku po bunce pres
mb_convert_encoding() s predchozi detekci, zda uz neni UTF-8 validni
- Parsing evropske desetinne: carka → tecka automaticky u cen, vah, rozmeru
- Fix leading dot: ".354" → "0.354" automaticky (jinak cast na float dela neporadek)
- Streaming pres JSON soubory: 1 radek CSV → 1 soubor
uploads/state/full_import_rows/<idx>.json pro presne pokracovani po preruseni
📸 Multi-obrazky az 25 na produkt pres CDN Velleman
Inovace specificka pro modul Velleman: 2. CSV mapovani obrazku se automaticky stahuje z verejneho CDN Velleman (URL pevne zakodovana v kodu, nikdy viditelna pro klienta), ktery prirazuje kazdemu SKU seznam URL produktovych obrazku (az 25 pohledu). Modul rozdeli, validuje kazdou URL a importuje vsechny obrazky v poradi.
- 1. URL = obal automaticky
- HTTP HEAD validace (curl NOBODY) pred stazenim: rozbite URL odmitnuty bez padu importu
- Cache 24h: mapovani se automaticky znovu nacita pouze pokud je starsi nez 24h, setri sirku pasma
- Automaticke generovani vsech velikosti PS (small, medium, large, home_default…)
- Fix BO PrestaShop 9 zahrnut: kopie 1:1 puvodniho souboru
<id>.jpg navic k variantam (jinak rozbity obrazek na strance editace produktu BO)
🏆 PREMIUM popis automaticky generovany — 10 aktivovatelnych sekci
Modul automaticky sestavuje vizualne bohaty produktovy list strukturovany do 10 nezavisle aktivovatelnych sekci pres prepinace v zalozce Moznosti. Kazda sekce ma svuj design, barvy, ikony, svuj SEO/konverzni cil:
| Sekce | Popis |
|---|
| 🏷️ Banner identity | Barevny zahlavni blok: znacka, reference, EAN + status badge (Novinka / Brzy / Skladem) |
| 📝 Kratky uvod | Shrnujici popis dodany Velleman (sl. 3) — 1-2 vety pro obecny kontext |
| ✨ Klicove body (odrazky) | Premenuje "•" z dlouheho popisu na stylizovany odrazkovy seznam (modry ramecek) |
| 🔬 Technicke karty | Parsuje "Detailni parametry" (sl. 63) na vizualni karty podle skupiny (Barva, Napeti, Kapacita, Pitch, Montaz…) |
| 📐 Rozmery a hmotnost | Tabulka sirka / vyska / hloubka / hmotnost ze sloupcu 55-58 |
| 📦 Baleni | Typ baleni (Volne/Set), nasobek objednavky, mnozstvi v kartonu vnitrnim/vnejsim |
| 🌍 Puvod + HS Code | Zeme puvodu + celni kod Intrastat (uzitecne B2B + soulad obchodu intra/extra EU) |
| ♻️ Eko-prispevek | Blok WEEE / zivotni prostredi (sl. 23-27) — transparentnost zakaznika, soulad s prostredim |
| ✅ Soulad GPSR | Udaje vyrobce + zastupce EU — z vaseho dedikovaneho formulare v Nastaveni |
| 📞 CTA dodavatel | Blok pod listem: "Mate dotaz?" + nazev obchodu + klikatelny telefon + delka zaruky |
Vsechny sekce lze individualne aktivovat/deaktivovat v zalozce Moznosti. Muzete vse aktivovat pro velmi bohate produktove listy nebo vse vypnout krome identity + CTA pro cisty vystup.
✅ Soulad GPSR EU 2024 — Dedikovany formular
Narizeni GPSR (General Product Safety Regulation) Evropske unie, platne od 13. prosince 2024, uklada vsem e-shopum v zone povinnost zobrazit na kazdem produktovem listu udaje vyrobce (a zastupce EU pokud je vyrobce mimo EU). Nedodrzeni = pokuta.
Reseni prijate modulem: dedikovany panel v zalozce Nastaveni s 5 poli vsechny volitelne, ktere vyplnite jen jednou. Udaje se zobrazuji automaticky na vsech produktovych listech Velleman.
- Nazev vyrobce (napr. "Velleman Group NV")
- Kompletni postovni adresa (ulice, PSC, mesto, zeme)
- Kontaktni email (klikatelny pres
mailto:)
- Telefon (klikatelny pres
tel:)
- Zastupce EU (pouze pokud je vyrobce mimo EU — nechte prazdne pro Velleman Belgie)
Inteligentni podminene zobrazovani: sekce GPSR se v produktovych listech zobrazuje jen pokud je alespon jedno pole vyplneno. Muzete zacit bez GPSR, modul nehavarejе. Svetle cerveny vizualni format pro pripomenuti regulacniho charakteru.
💰 10 cenovych pasem se slevou Velleman
Velleman nabizi az 10 cenovych pasem se slevou podle nakupnich mnozstvi (typicky: 1, 5, 10, 25, 50, 100, 250, 500, 1000, 5000+). Kazde pasmo ma svou nakupni cenu bez DPH vyjednanou ve vasi B2B smlouve s Velleman.
Reseni prijate modulem: volic v Nastaveni pro vyber pasma odpovidajiciho vasemu realnemu prumernemu nakupnimu objemu. Modul pouziva toto pasmo jako jedinou nakupni cenu pro vypocet finalni prodejni ceny podle vaseho rezimu (margins / fixed / wholesale).
- Volic pasma: 1 / 5 / 25 / 100 / 500 (vychozi 5, nejcastejsi pro SME)
- Rezim margins: 6 pasem marze konfigurovatelnych podle pasma ceny bez DPH
- Rezim fixed: 1 markup v % aplikovany rovnomerne (napr. 50%)
- Rezim wholesale: nakupni cena bez DPH nezmenena (B2B prodej skolam, makers space, atd.)
🌳 Hierarchie kategorii v 10 urovnich
CSV Velleman poskytuje az 10 sloupcu "Nazev kategorie 1..10" tvorici hlubokou linearni hierarchii (root → potomek → vnuk → pravnuk…). Kazdy produkt patri do listu na konci retezce kategorii.
Reseni prijate modulem: vytvareni chybejicich kategorii za behu pod vasim nakonfigurovanym PrestaShop rootem. Lookup pred vytvarenim (anti-duplicity) s optimalizovanym SQL dotazem.
Priklad:
"Elektronicke soucastky a prislusenstvi"
→ "Elektronicke soucastky"
→ "Kondenzatory"
→ "Tantal"
→ "Nizka vyska"
→ ...
- Multilingvalni vytvareni pod vasim PS rootem (vsechny aktivni jazyky dostavaji stejny nazev + slug)
- Lookup pred create: SELECT podle nazvu + parent → pokud nalezeno, znovu pouzije existujici ID
- Kompletni produktove vazby:
id_category_default = nejhlubsi list, category_product vyplneno celym retezcem (filtry facetedsearch funguji na vsech urovnich)
- Automaticky slug pres
VlCompat::slug() (URL-safe, normalizovana diakritika)
⚡ Architektura importu v realnem case + CRON 24/7
Scenar, ktery vse meni:
- 📥 Priprava: modul se pripoji k FTP Velleman, stahne vase personalizovane CSV (az 10 MB), stream-parsuje ho a zapise kazdy radek do separatniho JSON souboru
- 📦 Mapovani CDN obrazku: automaticke stahnuti 2. CSV CDN Velleman (cache 24h, URL neviditelna pro klienta)
- 🚀 Import "1 radek CSV = 1 AJAX volani": zadny zamrz na 5 hodin, vidite kazdy produkt vytvoreny po jednom
- 📊 Modry a zlaty progress bar: procento live + pocitadlo X/Y
- 📋 Live zurnal: barevny badge (Vytvoreno / Aktualizovano / Preskoceno / Chyba) + reference + nazev produktu + ID PS#
- ⏸️ Tlacitko Zastavit kdykoliv, presne pokracovani na radku zastaveni
- 📈 Live statistiky: Zpracovane radky · Vytvorene · Aktualizovane · Preskocene · Chyby
→ Zadne zasekavajici se stranky. Zadne starosti. Vidite vse, co se deje.
⏰ CRON 24/7 — 4 automatizovane akce
| CRON akce |
Role |
Doporucena frekvence |
full_import | Kompletni import (vytvoreni + lehke aktualizace) | 1×/den (mimo spicku) |
light_sync | Aktualizace cen + skladu + dostupnosti jiz importovanych produktu | kazde 2-4h |
rebuild_tags | Prebudovat PS tagy na vsech jiz importovanych produktech (uzitecne po zmene pravidel taggingu) | na pozadani |
cleanup_logs | Vycisteni logu starsich nez N dni (konfigurovatelna retence) | 1×/tyden |
- Tajny klic 32 hex znaku generovany pri instalaci — vase CRON URL nelze uhodnout
- Regenerace na 1 klik klice v pripade uniku
- Asynchronni auto-restart pres curl loopback: auto-volani na pozadi pokud je dosazen time-budget (vychozi 60s), preziti pres
@ignore_user_abort(true)
- Presne pokracovani: pokracuje presne na radku, kde se zastavil
- Anti-konkurencni zamek pres flock: zadne paralelni vykonavani
- Tlacitko Stop v BO pro cisty stop probihajiciho CRON (flag soubor)
- Limit produktu na vykonani konfigurovatelny (10-100 pro testovani, 0 = neomezeno v produkci)
- Flash "uloha spustena na pozadi" okamzity pri kliknuti Test BO — hned vite, ze server pracuje
🏷️ Velleman katalog v cislech
~6 000
elektronickych referenci
64
parsovanych CSV sloupcu
🇧🇪
belgicky velkoobchodnik EU
Produktovy svet katalogu Velleman (vyber podle hlavnich rodin):
Pasivni soucastky
Moduly Arduino/Raspberry
Vzdelavaci kity
Audio pro / DJ
Jevistni LED osvetleni
Efektove lasery
Mericí naradi
Bezpecnost / Domotika
Konektivita RJ45/HDMI
Robotika STEM
+ ruzne prislusenstvi
Interni znacky Velleman: Velleman Kit (pajici kity), Velleman Modules, Vellight (osvetleni), HQ Power (audio pro), Vonyx, Skytec, Showtec, BoomTone DJ, PERFECT (bezpecnost), Toolland (naradi), Velleman EDU (vzdelavani).
🛠️ Udrzba — Selektivni mazani
- ☐ Importovane produkty: detekce 2 zdroji (tabulka meta + id_supplier), kompatibilni s PS9 multi-shop s SQL wipe fallbackem pokud
Product::delete() vrati false
- ☐ Prazdne kategorie: prochazka podle sestupne hloubky pres nleft/nright, mazani jen pokud nula pripojenych produktu + nula sub-kat (zachovava PS_HOME, PS_ROOT rooty)
- ☐ Znacka Velleman: maze vyrobce pouze pokud uz nema zadne pripojene produkty (vyzadovano dvoji potvrzeni)
- ☐ Interni zurnaly: truncate tabulek history a import_errors
Jednoduche nebo dvoji potvrzeni podle rozsahu, s dedikovanou zalozkou Nastroje → Selektivni mazani. Stromova struktura kategorii je zachovana, pokud mate produkty jinde (ne-Velleman), kteri je jeste pouzivaji.
⭐ 12 duvodu pro vyber Modulu Velleman
- 🌐 Individualni FTP pripojeni pro kazdeho prodejce (5 poli) — kazdy klient ma svuj cislovany soubor, sva osobni pasma
- 📸 Multi-obrazky az 25 pohledu/produkt pres 2. CSV CDN (URL pevne zakodovana neviditelna pro klienta) — inovace specificka Velleman
- 🏆 PREMIUM popis 10 sekci aktivovatelnych individualne (banner, uvod, klicove body, technicke karty, rozmery, baleni, puvod, eko, GPSR, CTA)
- ✅ Soulad GPSR EU 2024 pres dedikovany formular (5 volitelnych poli) — automaticke zobrazeni na vsech produktech
- 🌳 10 urovni kategorii hierarchicky vytvarenych za behu — sprava hlubokych stromu specifickych pro soucastky
- 💰 10 cenovych pasem se slevou Velleman + volic nakupni ceny v Nastaveni
- 🔬 Inteligentni parsing detailnich parametru (sl. 63): 1 sekce = 1 vizualni karta (Fyzicke / Elektricke / Technicke / Instalace)
- 🌍 Windows-1252 kodovani auto-konvertovane do UTF-8 bunku po bunce (zachovava "Métré", "Réservé", evropske technicke znaky)
- 🔢 Desetinna carka + tecka prefixy auto-opraveny (napr.: .354 → 0.354 — jinak cast na float padne)
- ⚡ Import v realnem case produkt po produktu: live progress bar, console zurnal, tlacitko Zastavit, presne pokracovani
- ⏰ Bezpecny CRON 24/7 s time-budgetem, asynchronnim auto-restartem, retry, zamkem, test rezimem, limitem produktu
- 💎 Zadny AdminController, zadny BO Tab, zadny override: nezneciscuje vase menu, nepoškodi vase dalsi moduly
🎬 Jak to funguje v 5 krocich
1
Nainstalujte modul
Stahnete ZIP, nainstalujte pres BO. Auto-vytvoreni 3 tabulek, dodavatele Velleman, CRON klice.
2
Zadejte 5 FTP poli
Vyzadejte si pristupy od sveho obchodniho zastupce Velleman (host, user, pass, cesta personalizovaneho souboru). Otestujte pripojeni 1 klikem.
3
Konfigurujte marze + GPSR
Vyberte nakupni cenove pasmo (5/25/100…). Rezim marze (6 pasem) nebo fixni markup nebo wholesale. Vyplnte volitelny GPSR formular.
4
Sestavte 10 sekci
Zalozka Moznosti: aktivujte/deaktivujte kazdou z 10 sekci PREMIUM popisu (vse je ON ve vychozim stavu).
5
Spustte import
Test rezim 10 produktu nejprve pro overeni, pak kompletni import ~6 000 produktu (~5h pres CRON s auto-restartem).
🔧 Technicka kompatibilita
| PrestaShop | 1.7.x → 9.x (testovano na PS 9.0) |
| PHP | 7.4 minimum, doporuceno 8.1+ |
| MySQL / MariaDB | 5.7+ / 10.3+ |
| cURL + ext FTP | Aktivovany (FTP CSV stahovani + CDN obrazky) |
| Multi-shop | Kompatibilni (vynucuje CONTEXT_ALL pro mazani) |
| Pouzite hooky | Zadne (zadne znecistovani retezce udalosti) |
| Override tridy | Zadny (zachovava vase dalsi moduly) |
| AdminController | Zadny |
| BO sidebar zalozka | Zadna (nezneciscuje vase menu) |
| B2B ucet Velleman | Vyzadovan partnersky prodejce ucet (individualni FTP pristup + vyjednana pasma) |
| FTP udaje | Vyzadat od vaseho obchodniho zastupce Velleman (host, port, user, pass, path souboru) |
❓ Casto kladene otazky
Q: Funguje Modul Velleman na PrestaShop 9?
A: Ano, plne kompatibilni s PS 9.x. Modul resi specifickou PS9 migraci, kde byl meta_keywords odstraneno (auto prepnuti na ps_tag) i bug PS9, kdy se puvodni obrazek nezobrazuje na strance editace produktu BO (fix kopii 1:1 souboru <id>.jpg). Vsechny znaky zakazane PS9 (<>{}) jsou vycisteny pred Tag::addTags(), aby se zabranilo odmitnuti celeho seznamu.
Q: Proc se pripojovat pres FTP misto klasickeho HTTPS?
A: Je to rozhodnuti Velleman. Kazdy partnersky prodejce dostava personalizovany CSV soubor na B2B FTP serveru Velleman s individualnimi cenovymi pasmy. Zadne verejne HTTPS URL. Modul resi tuto specifiku: 5 FTP poli, zabezpecene skryte heslo, pasivni rezim kompatibilni s firewallem, overeni velikosti pred stahovanim.
Q: 2. CSV mapovani obrazku, co to presne je?
A: Velleman publikuje 2. verejne CSV na svem CDN, ktere prirazuje kazdemu SKU seznam URL produktovych obrazku (az 25 pohledu: predek, zad, bok, v ruce, baleni, schema, navod…). CDN URL je pevne zakodovana v kodu modulu (nikdy viditelna pro klienta) — nemusite nic konfigurovat. Mapovani se automaticky znovu nacita kazdych 24h.
Q: CSV je v Windows-1252 — jak to modul resi?
A: Modul prevadi kazdou bunku z Windows-1252 do UTF-8 pres mb_convert_encoding() (s automatickou detekci pokud bunka je uz UTF-8 validni). Evropske technicke znaky (stupne °, mikro µ, ohm Ω, plus-minus ±, atd.) jsou zachovany. Desetinne carky prevedeny na tecky. Tecka prefixy (.354) opraveny na (0.354) pro zabraneni nesmyslnym castum na float.
Q: Je soulad GPSR povinny?
A: Ano, od 13. prosince 2024 v cele EU. Modul vas vsak nenuti vyplnit formular — vsech 5 poli je volitelnych. Muzete zacit bez GPSR (pro testy) a pak vyplnit formular pred zverejnenim. Sekce se zobrazuje na produktech jen pokud je alespon jedno pole vyplneno.
Q: Jak vybrat spravne cenove pasmo se slevou?
A: Volic v Nastaveni nabizi obvykla pasma Velleman (1, 5, 25, 100, 500). Vyberte to, ktere odpovida vasemu realnemu prumernemu nakupnimu objemu. Pokud kupujete v davkach 25 u vetsiny referenci, vyberte 25. Modul pouzije toto pasmo jako nakupni cenu pro vypocet finalni prodejni ceny (podle vaseho rezimu margins/fixed/wholesale).
Q: Mohu deaktivovat nektere sekce PREMIUM popisu?
A: Ano, kazda z 10 sekci (banner identity, uvod, klicove body, technicke karty, rozmery, baleni, puvod, eko-prispevek, GPSR, CTA) je aktivovatelna/deaktivovatelna individualne pres prepinac v zalozce Moznosti. Vse je ON ve vychozim stavu pro nejbohatsi list, ale muzete vse vypnout krome identity + CTA pro cisty vystup.
Q: Mohu importovat stejne CSV nekolikrat?
A: Ano. Automaticky lehky rezim (CRON akce light_sync): existujici produkty se detekuji pres jejich unikatni SKU a pouze jejich ceny + sklady jsou aktualizovany. Vase popisy, obrazky, kategorie a vlastni tagy nejsou prepsany — vase BO upravy jsou zachovany.
Q: Jak smazat vsechny Velleman produkty?
A: Zalozka Nastroje → Selektivni mazani → zaskrtnete "Importovane produkty" + "Prazdne kategorie" + "Znacka Velleman" + "Zurnaly" → Spustit. Jednoduche nebo dvoji potvrzeni podle rozsahu. Strom je zachovan, pokud je pouzivan ne-Velleman produkty.
Q: A pokud chci zastavit probihajici import?
A: Tlacitko "Zastavit" dostupne behem importu (UI) i behem CRON (flag soubor). Cisty stop na konci aktualniho produktu, presne ulozeni stavu pro pokracovani na presnem radku zastaveni. Modul prezije i restart serveru diky JSON streamu na soubor.
Q: Je modul kompatibilni s multi-shop?
A: Ano. Kategorie a produkty se vytvareji na vsech aktivnich obchodech. Mazani vynucuje CONTEXT_ALL pro vyhnuti se PS9 quirku, kde Product->delete() vraci false v multi-shop. Dodavatel Velleman je propojen se vsemi aktivnimi obchody pres ps_supplier_shop.
Q: Zadny AdminController, zadny BO Tab?
A: Potvrzeno. Modul pouziva pouze getContent() + AJAX. Zadne znecistovani BO PrestaShop menu. Zadny override core tridy. Zadny hook (PS retezec udalosti zustava nedotcen). Vase dalsi moduly nejsou ovlivneny ani pri instalaci, ani pri odinstalaci.
⚡ Pripraveni automatizovat vas elektronicky dropshipping?
Modul Velleman dropshipping elektronicke soucastky moduly kity FTP je nejkomplexnejsi nastroj pro prodej ~6 000 referenci Velleman (soucastky, moduly Arduino/Raspberry, vzdelavaci kity, audio pro, jevistni osvetleni, naradi, bezpecnost) v PrestaShopu. Po jednorazove konfiguraci automaticky stahuje vas personalizovany katalog pres FTP, importuje az 25 obrazku na produkt z CDN, generuje PREMIUM popis 10 sekci a zustava v souladu s GPSR EU 2024.
⚡ INSTALACE 5 MIN · 📚 IMPORT V REALNEM CASE · 🛡️ KOMPATIBILNI PS 1.7 → 9 · ✅ GPSR EU 2024 · 🇨🇿 CESKA PODPORA
📋 Technicke detaily pro vyvojare
Vytvorene BDD tabulky (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).
PS konfigurace: WPVL_SETTINGS (JSON 30+ klicu), WPVL_SUPPLIER_ID, WPVL_CRON_KEY, WPVL_LAST_IMPORT_AT, WPVL_CRON_LAST_*.
CSV Velleman (64 sloupcu Windows-1252, separator strednik, bez headeru): 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 PHP trid (VlCompat, VlCsvImporter, VlCategoryMapper, VlDescriptionBuilder, VlTagBuilder, VlFeatureMapper, VlMediaDownloader, VlParameterMapper) + hlavni modul + AJAX dispatcher + CRON. Zadny override core PrestaShop tridy, zadny hook, zadny AdminController, zadny BO Tab.
FTP: stahovani pres VlCompat::downloadFromFtp() (curl URL ftp://user:pass@host:port/path). Test pripojeni pres ftp_connect + ftp_login + ftp_pasv + ftp_size. Heslo ulozene sifrovane v WPVL_SETTINGS, skryte v JSON odpovedich (• opakovane).
Kodovani: konverze Windows-1252 → UTF-8 bunku po bunce pres mb_convert_encoding() s predchozi detekci, zda uz neni UTF-8 validni. parseDecimal(): carka → tecka + leading dot fix (.354 → 0.354).
Multi-obrazky CDN: VlCompat::downloadPicturesMappingCsv() stahuje 2. CSV mapovani z URL pevne zakodovane VL_PICTURES_MAPPING_URL. Cache 24h. loadPicturesMapping() vraci array SKU → [URL1, URL2, …, URL25]. importMultiImages() vola imageUrlExists() (curl HEAD NOBODY) pak ImageManager::resize, fix BO PS9 kopii 1:1 puvodniho souboru.
JSON Streaming: streamParseToFiles() zapisuje kazdy CSV radek do souboru uploads/state/full_import_rows/<idx>.json. Umoznuje presne pokracovani po preruseni + odolnost vuci restartum serveru.
CRON auto-restart: pres curl loopback asynchronne na stejny endpoint s tajnym klicem. Time-budget 60s vychozi, @ignore_user_abort(true) pro preziti behem restartu. Anti-konkurencni zamek pres flock na uploads/state/cron_*.lock.
VlCategoryMapper: resolveChainOrCreate(array $names) v 10 urovnich. SQL lookup pred Category::add() (anti-duplicity pres SELECT podle nazvu + parent — bez LIMIT 1 protoze PrestaShop ho pridava automaticky, duplikat = fatalni SQL chyba). Slug pres VlCompat::slug(). Multilingvalni (vsechny aktivni jazyky dostavaji stejny nazev).
GPSR EU 2024: 5 settings poli (gpsr_manufacturer_name, gpsr_address, gpsr_email, gpsr_phone, gpsr_eu_representative) vsechny volitelne. VlDescriptionBuilder cte settings (nikdy CSV pro GPSR — produktove rozhodnuti). Podminene zobrazeni: sekce se zobrazuje jen pokud je alespon jedno pole vyplneno. Email + telefon klikatelne (mailto: / tel:).
Zabezpeceni: pSQL() vsude, uploads/ slozka chranena pres index.php redirect, HTTP HEAD validace obrazku, nativni PS CSRF na AJAX, systematicke HTML escapy, hash_equals() na CRON klici, FTP heslo skryte v odpovedich.
PS9 specificka kompatibilita: auto migrace meta_keywords → ps_tag/ps_product_tag pres Tag::addTags(), reseni Product::delete() quirku, ktery vraci false v multi-shop, fix BO PS9 puvodni obrazek, vycisteni <>{} pred Tag::addTags() (jinak Validate::isGenericName odmita cely seznam).
Multi-shop: ensureSupplierExists() pres primy SQL INSERT (bypass new Supplier() + ->add(), ktery tise padne v PS9). Dynamicka detekce sloupce meta_keywords v ps_supplier_lang (pritomny PS7, odstraneny PS9). Vazba ps_supplier_shop na vsechny aktivni obchody.
📦 Modul vyvinut WebPoint · webpoint.fr · Pravidelne aktualizace · Cisty & komentovany kod
