PrestaShop Dropshipping-Modul VELLEMAN
🔌 ⚡ 🔬
Velleman Dropshipping Modul Elektronische Bauteile
Das Modul, das Ihr Dropshipping mit Bauteilen, Modulen, Kits und Audio auf PrestaShop von A bis Z automatisiert
PrestaShop 1.7 bis 9.x · ~6.000 Produkte · sicheres FTP · 25 Bilder/Produkt · CRON 24/7 · GPSR EU 2024
Sie eröffnen einen Shop für elektronische Bauteile, eine Spezialseite für Arduino / Raspberry / DIY-Maker, einen Online-Shop für Bühnenbeleuchtung oder Profi-Audio? Sie arbeiten mit Velleman Group (belgischer Traditionsgrosshändler, gegründet 1976, europäische Referenz für Bauteile, Module, Lernkits, Beschallung, Bühnenlicht, Messwerkzeuge) und verbringen Ihre Tage damit, 6.000 Produktdatenblätter abzutippen, manuell 25 Fotos pro Produkt hochzuladen, jede Kategorie über 10 hierarchische Ebenen neu anzulegen, die ausführlichen technischen Merkmale (Physisch / Elektrisch / Technisch / Installation) von Hand zu zerlegen und 10 Mengenrabattstufen je nach Einkaufsvolumen zu verwalten?
Mit dem Velleman Dropshipping Modul Elektronische Bauteile Module Kits FTP wird alles automatisch. Sie hinterlegen Ihre Velleman-FTP-Zugangsdaten (Host, Port, Benutzer, Passwort, Pfad zu Ihrer personalisierten Datei), klicken auf „Import starten", und das Modul lädt Ihre 64-spaltige CSV-Datei in Windows-1252 herunter, konvertiert sie Zelle für Zelle nach UTF-8, lädt die zweite CSV mit der Bildzuordnung vom Velleman-CDN (hartkodierte URL, clientseitig unsichtbar) und legt Ihre ~6.000 PrestaShop-Produkte in einer im Vorgang erzeugten 10-stufigen Baumstruktur an, jedes mit einem PREMIUM-Datenblatt aus 10 Abschnitten (Marken-Banner mit Identität + EAN + Status, kurze Einleitung, Highlights, Cards mit technischen Merkmalen, Abmessungen, Verpackung, Herkunft, Umweltbeitrag, GPSR EU 2024, Lieferanten-CTA), bis zu 25 Bildern pro Produkt und europäischer GPSR-Konformität, gespeist aus Ihrem dedizierten Formular.
⚡ Vorher vs. Nachher mit dem Velleman-Modul
| Aufgabe |
❌ Ohne Modul |
✅ Mit Modul |
| Import von 6.000 Elektronik-Artikeln | 200+ Stunden manuell, Abtippen aus dem B2B-Portal von Velleman | 1 Klick, ~5 Std. im Hintergrund über automatisch erneuten CRON |
| Download des Quellkatalogs | Manueller Download via FTP / B2B-Extranet + BO-Upload | Automatische FTP-Verbindung über 5 Felder (Host, Port, Benutzer, Passwort, Pfad) |
| Mehrere Bilder (bis zu 25 pro Produkt) | Manueller Download vom CDN, Kopie auf Server, einzelner Upload nach PS | 2. CSV mit Velleman-CDN-Mapping + automatischer Download · 1. Bild = Cover |
| Windows-1252-Kodierung (Legacy) | Beschädigte Sonderzeichen, Umlaute als Mojibake („ é ", „ ° ") | Automatische Konvertierung Zelle für Zelle via mb_convert_encoding() |
| CSV mit 64 Spalten ohne Header | Manuelles Parsen über numerische Indizes, Fehler garantiert | Symbolisches Mapping als Konstanten (COL_SKU, COL_NAME, COL_BULLETS…) |
| Komma-Dezimalen + Punktpräfix (.354) | Float-Cast-Fehler, Preise auf 0 oder unrealistisch | parseDecimal(): Komma → Punkt + Leading-Dot-Fix (.354 → 0.354) |
| Ausführliche technische Merkmale (Sp. 63) | Fließtext, unleserlich, nicht SEO-tauglich | Parsing in Cards nach Gruppen (Physisch / Elektrisch / Technisch / Installation) |
| GPSR-Konformität EU 2024 | Bußgeldrisiko EU bei fehlenden Herstellerangaben auf Datenblättern | Dediziertes 5-Feld-Formular (Hersteller, Adresse, E-Mail, Tel., EU-Vertreter) – automatische Anzeige |
| 10 Mengenrabattstufen Velleman | Pi-mal-Daumen-Wahl des Einkaufspreises, instabile Marge | Auswahl der Einkaufsstufe (5/25/100/500…) in den Einstellungen |
| Kategoriehierarchie (10 Ebenen) | Manuelle Anlage, stundenlanges Angleichen der Nomenklatur | Anlage „on-the-fly" Ebene für Ebene unter Ihrer PS-Wurzel |
| Preis/Bestand aktualisieren | Täglich alles von Null neu | CRON light_sync 2-4 Std.: nur Preis+Bestand-Update (leichter Modus) |
👤 Für wen ist dieses Modul?
🔬
E-Commerce für Bauteile & Module
Sie verkaufen Widerstände, Kondensatoren, LEDs, Transistoren, Mikrocontroller (Arduino, Raspberry, ESP32), Sensoren, Erweiterungsmodule. Velleman bietet ein traditionsreiches Sortiment, das in Europa für Maker-/DIY-/Bildungsnischen Referenzcharakter hat.
🎓
Shop für Lernkits & STEM
Robotik-Kits, Lötkits für Anfänger, Arduino-Unterrichtskits, pädagogische Projekte für Sekundarstufen und Ingenieurschulen. Velleman EDU ist seit 30 Jahren eine eigene Bildungs-Reihe.
🎵
E-Commerce für Audio & Beschallung
Verstärker, Lautsprecher, Mikrofone, Mischpulte, LED-Bühnenscheinwerfer, Effektlaser, Nebelmaschinen. Velleman bietet ein Profi-/Semipro-Audio-Sortiment (HQ Power, Vonyx, Skytec, Showtec, BoomTone DJ), das in Europa stark nachgefragt wird.
🛠️
Shop für Elektronik-Werkzeug
Multimeter, Oszilloskope, Lötkolben, Zangen, Präzisionsschraubendreher, Lupen, USB-Mikroskope. Mess- und Reparaturwerkzeuge für Techniker, Hobbyisten und technische Schulen.
🚨
Shop für Sicherheit & Smart Home
IP-Kameras, Bewegungsmelder, drahtlose/verkabelte Alarmanlagen, Sirenen, Zutrittskontrolle, Beleuchtungssteuerung. Eine wachsende Nische mit PERFECT (Velleman-Marke für Sicherheit).
🎯 Vollständige Funktionen des Velleman-Moduls
🌐 Individuelle FTP-Verbindung pro Wiederverkäufer
Velleman-Besonderheit. Jeder Partner-Wiederverkäufer erhält auf dem Velleman-FTP-Server eine personalisierte CSV-Datei mit eigenen Tarifkonditionen (kontospezifische Mengenrabatte). Die Datei trägt einen eindeutigen Namen (z. B. IhreDatei.csv). Die FTP-Zugangsdaten (Host, Port, Benutzer, Passwort) werden niemals geteilt und bleiben strikt individuell.
Lösungsansatz des Moduls: 5 FTP-Felder in den Einstellungen, niemals hartkodiert, Passwort in der Datenbank und in JSON-Antworten maskiert. Schaltfläche „FTP-Verbindung testen", die Authentifizierung, Passive-Modus und Dateiverfügbarkeit live prüft.
5 FTP-Felder:
- Host : ftp.velleman.eu (oder regionale Variante)
- Port : 21 (Standard, anpassbar)
- Benutzer : Ihre Velleman-B2B-Kennung
- Passwort : maskiert in der Datenbank, nie im Klartext angezeigt
- Pfad : /IhreDatei.csv
- Authentifizierung + Passive-Modus via
ftp_connect + ftp_login + ftp_pasv (kompatibel mit nahezu allen Firewalls)
- Dateigrößenprüfung (
ftp_size) vor dem Download, um leere/beschädigte Dateien abzuweisen
- cURL-Download über URL
ftp://user:pass@host:port/path – robust und performant
- Sicheres Passwort: verschlüsselt gespeichert, im JSON-Rückgabewert maskiert (• wiederholt), niemals geloggt
📊 CSV mit 64 Spalten in Windows-1252 — Robustes Parsing
Die Velleman-CSV besitzt 64 Spalten ohne Header (erster Datensatz = Daten, keine Kopfzeilen), kodiert in Windows-1252 (Legacy-Europa) mit Semikolon als Trennzeichen. Das Modul beherrscht diese Alteigenheiten:
- Symbolisches Mapping als PHP-Konstanten:
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. Keine Magic Numbers mehr, lesbarer und wartbarer Code.
- Konvertierung Windows-1252 → UTF-8 Zelle für Zelle via
mb_convert_encoding() mit vorheriger Erkennung, falls bereits gültiges UTF-8
- Europäisches Dezimalparsing: Komma → Punkt automatisch bei Preisen, Gewichten, Abmessungen
- Leading-Dot-Fix: „.354" → „0.354" automatisch (sonst macht der Float-Cast Unfug)
- Streaming in JSON-Dateien: 1 CSV-Zeile → 1 Datei
uploads/state/full_import_rows/<idx>.json, um eine punktgenaue Wiederaufnahme nach Unterbrechung zu ermöglichen
📸 Bis zu 25 Bilder pro Produkt über Velleman-CDN
Eine Innovation, die nur das Velleman-Modul bietet: Eine zweite CSV mit Bild-Mapping wird automatisch vom öffentlichen Velleman-CDN heruntergeladen (URL hartkodiert im Code, niemals clientseitig sichtbar) und ordnet jede SKU einer Liste von Produktbild-URLs zu (bis zu 25 Ansichten). Das Modul splittet, validiert jede URL und importiert alle Bilder in der Reihenfolge.
- 1. URL = Cover automatisch
- HTTP-HEAD-Validierung (cURL NOBODY) vor dem Download: ungültige URLs werden verworfen, ohne den Import abzubrechen
- Cache 24 Std.: Das Mapping wird nur erneut geladen, wenn es älter als 24 Std. ist – schont die Bandbreite
- Automatische Erzeugung aller PS-Bildgrößen (small, medium, large, home_default…)
- Inkl. Fix für PrestaShop 9 BO: 1:1-Kopie der Originaldatei
<id>.jpg zusätzlich zu den Varianten (sonst defektes Bild auf der BO-Produktbearbeitungsseite)
🏆 PREMIUM-Beschreibung automatisch erzeugt — 10 aktivierbare Abschnitte
Das Modul erstellt automatisch ein optisch ansprechendes Produktdatenblatt, gegliedert in 10 unabhängig aktivierbare Abschnitte über Schalter im Reiter „Optionen". Jeder Abschnitt hat sein eigenes Design, seine Farben, seine Icons und sein SEO-/Conversion-Ziel:
| Abschnitt | Beschreibung |
|---|
| 🏷️ Identitäts-Banner | Farbiger Kopfblock: Marke, Referenz, EAN + Status-Badge (Neu / Demnächst / Auf Lager) |
| 📝 Kurze Einleitung | Zusammenfassende Beschreibung von Velleman (Sp. 3) – 1-2 Sätze für den allgemeinen Kontext |
| ✨ Highlights (Aufzählungen) | Wandelt die „•" der ausführlichen Beschreibung in eine stilisierte Aufzählung um (blauer Rahmen) |
| 🔬 Technik-Cards | Parst die „Detaillierten Merkmale" (Sp. 63) in visuelle Cards je Gruppe (Farbe, Spannung, Kapazität, Pitch, Montage…) |
| 📐 Abmessungen & Gewicht | Tabelle Breite / Höhe / Tiefe / Gewicht aus den Spalten 55-58 |
| 📦 Verpackung | Verpackungsart (Lose/Set), Bestellmehrfaches, Stückzahl pro Innen-/Außenkarton |
| 🌍 Herkunft + HS-Code | Herkunftsland + Intrastat-Zollcode (nützlich B2B + EU-Außen-/Binnenhandel) |
| ♻️ Umweltbeitrag | Block WEEE / Umwelt (Sp. 23-27) – Transparenz für Kunden, Umweltkonformität |
| ✅ GPSR-Konformität | Herstellerkontaktdaten + EU-Vertreter – aus Ihrem dedizierten Formular in den Einstellungen |
| 📞 Lieferanten-CTA | Block am Ende des Datenblatts: „Eine Frage?" + Shop-Name + klickbare Telefonnummer + Garantiedauer |
Alle Abschnitte lassen sich individuell im Reiter Optionen aktivieren/deaktivieren. Sie können alles aktivieren für besonders reichhaltige Datenblätter, oder alles ausschalten bis auf Identität + CTA für eine schlanke Darstellung.
✅ GPSR-Konformität EU 2024 — Dediziertes Formular
Die GPSR-Verordnung (General Product Safety Regulation) der Europäischen Union, in Kraft seit dem 13. Dezember 2024, verpflichtet alle E-Commerce-Händler im EU-Raum, auf jedem Produktdatenblatt die Kontaktdaten des Herstellers anzugeben (sowie des EU-Vertreters, falls Hersteller außerhalb der EU). Verstöße werden mit Bußgeldern geahndet.
Lösungsansatz des Moduls: Ein eigenes Panel im Reiter Einstellungen mit 5 komplett optionalen Feldern, die Sie einmalig ausfüllen. Die Kontaktdaten werden automatisch in allen Velleman-Produktdatenblättern angezeigt.
- Herstellername (z. B. „Velleman Group NV")
- Vollständige Postanschrift (Straße, PLZ, Stadt, Land)
- Kontakt-E-Mail (klickbar via
mailto:)
- Telefon (klickbar via
tel:)
- EU-Vertreter (nur falls Hersteller außerhalb der EU – für Velleman Belgien leer lassen)
Intelligente bedingte Anzeige: Der GPSR-Abschnitt erscheint im Produktdatenblatt nur, wenn mindestens ein Feld ausgefüllt ist. Sie können ohne GPSR starten, ohne dass das Modul abstürzt. Hellrote Optik unterstreicht den regulatorischen Charakter.
💰 10 Mengenrabattstufen Velleman
Velleman bietet bis zu 10 Mengenrabattstufen je Einkaufsmenge (typisch: 1, 5, 10, 25, 50, 100, 250, 500, 1.000, 5.000+). Jede Stufe hat ihren eigenen, in Ihrem B2B-Vertrag mit Velleman verhandelten Netto-Einkaufspreis.
Lösungsansatz des Moduls: Ein Selektor in den Einstellungen, mit dem Sie die Stufe wählen, die Ihrem tatsächlichen durchschnittlichen Einkaufsvolumen entspricht. Das Modul nutzt diese Stufe als einheitlichen Einkaufspreis, um den endgültigen Verkaufspreis nach Ihrem Modus (margins / fixed / wholesale) zu berechnen.
- Stufenwahl: 1 / 5 / 25 / 100 / 500 (Standard 5, der gängigste für KMU)
- Modus margins: 6 konfigurierbare Margenstufen je Netto-Preisspanne
- Modus fixed: 1 Aufschlag in % einheitlich angewandt (z. B. 50 %)
- Modus wholesale: Netto-Einkaufspreis unverändert (B2B-Verkauf an Schulen, Maker Spaces usw.)
🌳 Kategoriehierarchie über 10 Ebenen
Die Velleman-CSV liefert bis zu 10 Spalten „Kategorie-Titel 1..10", die eine tiefe lineare Hierarchie bilden (Wurzel → Kind → Enkel → Urenkel…). Jedes Produkt gehört zu einem Blatt am Ende einer Kategorienkette.
Lösungsansatz des Moduls: „On-the-fly"-Anlage der fehlenden Kategorien unter Ihrer konfigurierten PrestaShop-Wurzel. Lookup vor Anlage (Doppelvermeidung) per optimierter SQL-Query.
Beispiel:
„Elektronische Bauteile & Zubehör"
→ „Elektronische Bauteile"
→ „Kondensatoren"
→ „Tantal"
→ „Niedrige Bauhöhe"
→ ...
- Mehrsprachige Anlage unter Ihrer PS-Wurzel (alle aktiven Sprachen erhalten denselben Namen + Slug)
- Lookup vor Create: SELECT nach Name + Eltern → wenn gefunden, wird die bestehende ID wiederverwendet
- Komplette Produktverknüpfung:
id_category_default = tiefstes Blatt, category_product mit der vollständigen Kette gefüllt (Faceted-Search-Filter funktionieren auf allen Ebenen)
- Automatischer Slug via
VlCompat::slug() (URL-sicher, normalisierte Akzente)
⚡ Echtzeit-Import-Architektur + CRON 24/7
Das Szenario, das alles verändert:
- 📥 Vorbereitung: Das Modul verbindet sich mit dem Velleman-FTP, lädt Ihre personalisierte CSV (bis zu 10 MB) herunter, parst sie im Stream und schreibt jede Zeile in eine separate JSON-Datei
- 📦 CDN-Bild-Mapping: automatischer Download der zweiten Velleman-CDN-CSV (Cache 24 Std., URL clientseitig unsichtbar)
- 🚀 Import „1 CSV-Zeile = 1 AJAX-Aufruf": kein 5-stündiges Einfrieren, Sie sehen jedes Produkt einzeln entstehen
- 📊 Fortschrittsbalken in Blau & Gold: Live-Prozentwert + Zähler X/Y
- 📋 Live-Journal: farbiges Badge (Erstellt / Aktualisiert / Übersprungen / Fehler) + Referenz + Produktname + PS-ID#
- ⏸️ Stopp-Schaltfläche jederzeit, punktgenaue Wiederaufnahme an der Stoppzeile
- 📈 Live-Statistiken: Verarbeitete Zeilen · Erstellt · Aktualisiert · Übersprungen · Fehler
→ Keine hängende Seite mehr. Keine Sorgen mehr. Sie sehen alles, was passiert.
⏰ CRON 24/7 — 4 automatisierte Aktionen
| CRON-Aktion |
Aufgabe |
Empfohlene Frequenz |
full_import | Vollständiger Import (Anlage + leichte Updates) | 1×/Tag (Nebenzeit) |
light_sync | Aktualisierung Preis + Bestand + Verfügbarkeit der bereits importierten Produkte | alle 2-4 Std. |
rebuild_tags | PS-Tags auf allen bereits importierten Produkten neu aufbauen (nützlich nach Änderung der Tag-Regeln) | bei Bedarf |
cleanup_logs | Bereinigung von Logs > N Tagen (konfigurierbare Aufbewahrung) | 1×/Woche |
- 32-stelliger Hex-Geheimschlüssel, generiert bei der Installation – Ihre CRON-URLs sind nicht erratbar
- Schlüsselneugenerierung mit 1 Klick bei einem Leak
- Asynchroner Auto-Restart via cURL-Loopback: Selbstaufruf im Hintergrund, wenn das Zeitbudget erreicht ist (60 s Standard), Überleben dank
@ignore_user_abort(true)
- Punktgenaue Wiederaufnahme: setzt exakt an der Zeile fort, an der der Vorgang stoppte
- Anti-Konkurrenz-Lock via flock: keine parallelen Ausführungen
- Stopp-Schaltfläche im BO, um einen laufenden CRON sauber zu beenden (Flag-Datei)
- Konfigurierbares Produkt-Limit pro Lauf (10-100 zur Validierung im Testmodus, 0 = unbegrenzt in Produktion)
- Sofortiger „Aufgabe im Hintergrund gestartet"-Flash beim BO-Test-Klick – Sie wissen sofort, dass der Server arbeitet
🏷️ Der Velleman-Katalog in Zahlen
~6.000
Elektronik-Artikel
🇧🇪
belgischer EU-Grosshändler
Produktwelten des Velleman-Katalogs (Auszug nach Hauptfamilien):
Passive Bauteile
Arduino-/Raspberry-Module
Lernkits
Profi-Audio / DJ
LED-Bühnenbeleuchtung
Effektlaser
Messwerkzeuge
Sicherheit / Smart Home
Konnektivität RJ45/HDMI
STEM-Robotik
+ vielfältiges Zubehör
Eigenmarken Velleman: Velleman Kit (Lötkits), Velleman Modules, Vellight (Beleuchtung), HQ Power (Profi-Audio), Vonyx, Skytec, Showtec, BoomTone DJ, Perfect (Sicherheit), Toolland (Werkzeug), Velleman EDU (Bildung).
🛠️ Wartung — Selektive Löschung
- ☐ Importierte Produkte: Erkennung über 2 Quellen (Meta-Tabelle + id_supplier), kompatibel mit PS9 Multi-Shop, Fallback per SQL-Wipe, falls
Product::delete() false zurückgibt
- ☐ Leere Kategorien: Durchlauf in absteigender Tiefe via nleft/nright, Löschung nur bei null verknüpften Produkten + null Unterkategorien (PS_HOME-/PS_ROOT-Wurzeln bleiben erhalten)
- ☐ Marke Velleman: Hersteller wird nur entfernt, wenn keine Produkte mehr verknüpft sind (Doppelbestätigung erforderlich)
- ☐ Interne Journale: Truncate der Tabellen history und import_errors
Einfache oder doppelte Bestätigung je nach Umfang, mit eigenem Tab Werkzeuge → Selektive Löschung. Die Kategoriestruktur bleibt erhalten, wenn andere Produkte (nicht-Velleman) sie noch verwenden.
⭐ 12 Gründe, das Velleman-Modul zu wählen
- 🌐 Individuelle FTP-Verbindung pro Wiederverkäufer (5 Felder) – jeder Kunde hat seine nummerierte Datei und seine persönlichen Stufen
- 📸 Bis zu 25 Bilder pro Produkt über zweite CDN-CSV (URL hartkodiert, clientseitig unsichtbar) – eine Velleman-spezifische Innovation
- 🏆 PREMIUM-Beschreibung mit 10 Abschnitten, individuell aktivierbar (Banner, Einleitung, Highlights, Technik-Cards, Abmessungen, Verpackung, Herkunft, Umwelt, GPSR, CTA)
- ✅ GPSR-Konformität EU 2024 über dediziertes Formular (5 optionale Felder) – automatische Anzeige in allen Datenblättern
- 🌳 10 Kategorieebenen hierarchisch „on-the-fly" angelegt – Verwaltung tiefer, bauteilspezifischer Strukturen
- 💰 10 Mengenrabattstufen Velleman + Einkaufspreis-Selektor in den Einstellungen
- 🔬 Intelligentes Parsen der Detailmerkmale (Sp. 63): 1 Abschnitt = 1 visuelle Card (Physisch / Elektrisch / Technisch / Installation)
- 🌍 Windows-1252 automatisch konvertiert nach UTF-8 Zelle für Zelle (bewahrt „Métré", „Réservé", europäische Sonderzeichen)
- 🔢 Komma-Dezimalen + Punktpräfixe automatisch korrigiert (z. B. .354 → 0.354 – sonst hängt der Float-Cast)
- ⚡ Echtzeit-Import Produkt für Produkt: Live-Balken, Konsolen-Journal, Stopp-Schaltfläche, punktgenaue Wiederaufnahme
- ⏰ Sicherer CRON 24/7 mit Zeitbudget, asynchronem Auto-Restart, Retry, Lock, Testmodus, Produktbegrenzer
- 💎 Kein AdminController, kein BO-Tab, kein Override: verschmutzt Ihr Menü nicht, bricht Ihre anderen Module nicht
🎬 So funktioniert es in 5 Schritten
1
Modul installieren
ZIP-Datei herunterladen, über das BO installieren. Automatische Anlage von 3 Tabellen, des Lieferanten Velleman und des CRON-Schlüssels.
2
Die 5 FTP-Felder ausfüllen
Fragen Sie Ihre Zugangsdaten bei Ihrem Velleman-Außendienst an (Host, Benutzer, Passwort, Pfad zur personalisierten Datei). Verbindung in 1 Klick testen.
3
Margen + GPSR konfigurieren
Wählen Sie die Einkaufsstufe (5/25/100…). Modus Margen (6 Stufen), fester Aufschlag oder Wholesale. Optional GPSR-Formular ausfüllen.
4
Die 10 Abschnitte zusammenstellen
Reiter Optionen: Aktivieren/Deaktivieren Sie jeden der 10 PREMIUM-Beschreibungsabschnitte (alle standardmäßig EIN).
5
Import starten
Zuerst Testmodus mit 10 Produkten zur Validierung, dann vollständiger Import von ~6.000 Produkten (~5 Std. via auto-erneutem CRON).
🔧 Technische Kompatibilität
| PrestaShop | 1.7.x bis 9.x (getestet auf PS 9.0) |
| PHP | 7.4 Minimum, empfohlen 8.1+ |
| MySQL / MariaDB | 5.7+ / 10.3+ |
| cURL + FTP-Erweiterung | Aktiviert (FTP-CSV-Download + CDN-Bilder) |
| Multi-Shop | Kompatibel (erzwingt CONTEXT_ALL beim Löschen) |
| Genutzte Hooks | Keine (kein Eingriff in die Ereigniskette) |
| Klassen-Override | Keiner (schützt Ihre anderen Module) |
| AdminController | Keiner |
| BO-Sidebar-Tab | Keiner (verschmutzt Ihr Menü nicht) |
| Velleman-B2B-Konto | Partner-Wiederverkäuferkonto erforderlich (individueller FTP-Zugang + verhandelte Stufen) |
| FTP-Zugangsdaten | Bei Ihrem Velleman-Außendienst anzufragen (Host, Port, Benutzer, Passwort, Pfad zur Datei) |
❓ Häufig gestellte Fragen
F: Funktioniert das Velleman-Modul auf PrestaShop 9?
A: Ja, vollständig kompatibel mit PS 9.x. Das Modul behandelt die PS9-spezifische Migration, bei der meta_keywords entfernt wurde (automatischer Wechsel zu ps_tag) sowie den PS9-Bug, bei dem das Originalbild auf der BO-Produktbearbeitungsseite nicht erscheint (Fix per 1:1-Kopie der Datei <id>.jpg). Alle in PS9 unzulässigen Zeichen (<>{}) werden vor Tag::addTags() bereinigt, um die Ablehnung der gesamten Liste zu verhindern.
F: Warum FTP statt klassisches HTTPS?
A: Das ist eine Entscheidung von Velleman. Jeder Partner-Wiederverkäufer erhält auf dem Velleman-B2B-FTP-Server eine personalisierte CSV-Datei mit individuellen Tarifstufen. Es gibt keine öffentliche HTTPS-URL. Das Modul handhabt diese Besonderheit: 5 FTP-Felder, sicheres maskiertes Passwort, firewall-kompatibler Passive-Modus, Größenprüfung vor Download.
F: Was genau ist die zweite CSV mit Bild-Mapping?
A: Velleman veröffentlicht eine zweite öffentliche CSV auf seinem CDN, die jede SKU einer Liste von Produktbild-URLs zuordnet (bis zu 25 Ansichten: vorne, hinten, seitlich, in der Hand, Verpackung, Schaltplan, Anleitung…). Die CDN-URL ist im Modulcode hartkodiert (clientseitig nie sichtbar) – Sie müssen nichts konfigurieren. Das Mapping wird automatisch alle 24 Std. neu geladen.
F: Die CSV liegt in Windows-1252 vor – wie geht das Modul damit um?
A: Das Modul konvertiert jede Zelle von Windows-1252 nach UTF-8 via mb_convert_encoding() (mit automatischer Erkennung, falls die Zelle bereits gültiges UTF-8 ist). Europäische Sonderzeichen (Grad °, Mikro µ, Ohm Ω, Plus-Minus ±, usw.) bleiben erhalten. Komma-Dezimalen werden in Punkte umgewandelt. Punkt-Präfixe (.354) werden zu (0.354) korrigiert, um falsche Float-Casts zu vermeiden.
F: Ist die GPSR-Konformität verpflichtend?
A: Ja, seit dem 13. Dezember 2024 in der gesamten EU. Das Modul zwingt Sie jedoch nicht, das Formular auszufüllen – die 5 Felder sind alle optional. Sie können ohne GPSR starten (für Tests) und das Formular vor der Veröffentlichung ausfüllen. Der Abschnitt erscheint im Datenblatt nur, wenn mindestens ein Feld ausgefüllt ist.
F: Wie wähle ich die richtige Mengenrabattstufe?
A: Der Selektor in den Einstellungen bietet die üblichen Velleman-Stufen (1, 5, 25, 100, 500). Wählen Sie diejenige, die Ihrem tatsächlichen durchschnittlichen Einkaufsvolumen entspricht. Wenn Sie überwiegend Pakete zu 25 kaufen, wählen Sie 25. Das Modul nutzt diese Stufe als Einkaufspreis zur Berechnung des endgültigen Verkaufspreises (gemäß Modus Margen/fester Aufschlag/Wholesale).
F: Kann ich bestimmte Abschnitte der PREMIUM-Beschreibung deaktivieren?
A: Ja, jeder der 10 Abschnitte (Identitäts-Banner, Einleitung, Highlights, Technik-Cards, Abmessungen, Verpackung, Herkunft, Umweltbeitrag, GPSR, CTA) lässt sich individuell über Schalter im Reiter Optionen aktivieren/deaktivieren. Standardmäßig ist alles EIN, um das reichhaltigste Datenblatt zu bieten, aber Sie können alles ausschalten bis auf Identität + CTA für eine schlanke Darstellung.
F: Kann ich dieselbe CSV mehrmals importieren?
A: Ja. Automatischer leichter Modus (CRON-Aktion light_sync): Bestehende Produkte werden über ihre eindeutige SKU erkannt, und nur Preis + Bestand werden aktualisiert. Ihre Beschreibungen, Bilder, Kategorien und individuellen Tags werden nicht überschrieben – Ihre BO-Änderungen bleiben erhalten.
F: Wie lösche ich alle Velleman-Produkte?
A: Reiter Werkzeuge → Selektive Löschung → Häkchen bei „Importierte Produkte" + „Leere Kategorien" + „Marke Velleman" + „Journale" → Ausführen. Einfache oder doppelte Bestätigung je nach Umfang. Die Struktur bleibt erhalten, wenn sie von nicht-Velleman-Produkten verwendet wird.
F: Und wenn ich einen laufenden Import abbrechen möchte?
A: Schaltfläche „Stopp" verfügbar während des Imports (UI) und während des CRONs (Flag-Datei). Sauberer Stopp am Ende des aktuellen Produkts, präzise Statussicherung für Wiederaufnahme an der exakten Stoppzeile. Das Modul übersteht dank Stream-JSON pro Datei sogar einen Server-Neustart.
F: Ist das Modul Multi-Shop-kompatibel?
A: Ja. Kategorien und Produkte werden in allen aktiven Shops angelegt. Die Löschung erzwingt CONTEXT_ALL, um den PS9-Quirk zu vermeiden, bei dem Product->delete() in Multi-Shop false zurückgibt. Der Lieferant Velleman wird über ps_supplier_shop mit allen aktiven Shops verknüpft.
F: Kein AdminController, kein BO-Tab?
A: Bestätigt. Das Modul nutzt ausschließlich getContent() + AJAX. Keine Verschmutzung des PrestaShop-BO-Menüs. Kein Override einer Core-Klasse. Keine Hooks (die PS-Ereigniskette bleibt intakt). Ihre anderen Module sind weder bei Installation noch Deinstallation betroffen.
⚡ Bereit, Ihr Elektronik-Dropshipping zu automatisieren?
Das Velleman Dropshipping Modul Elektronische Bauteile Module Kits FTP ist das vollständigste Tool, um die ~6.000 Velleman-Artikel (Bauteile, Arduino-/Raspberry-Module, Lernkits, Profi-Audio, Bühnenbeleuchtung, Werkzeug, Sicherheit) auf PrestaShop zu verkaufen. Einmal konfiguriert, lädt es automatisch Ihren personalisierten Katalog via FTP herunter, importiert bis zu 25 Bilder pro Produkt vom CDN, generiert eine PREMIUM-Beschreibung mit 10 Abschnitten und bleibt GPSR-EU-2024-konform.
⚡ INSTALLATION 5 MIN · 📚 ECHTZEIT-IMPORT · 🛡️ KOMPATIBEL PS 1.7 BIS 9 · ✅ GPSR EU 2024 · 🇩🇪 DEUTSCHSPRACHIGER SUPPORT
📋 Technische Details für Entwickler
Erstellte DB-Tabellen (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-Konfigurationen: WPVL_SETTINGS (JSON 30+ Schlüssel), WPVL_SUPPLIER_ID, WPVL_CRON_KEY, WPVL_LAST_IMPORT_AT, WPVL_CRON_LAST_*.
Velleman-CSV (64 Spalten Windows-1252, Trennzeichen Semikolon, ohne Header): 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.
Architektur: 8 PHP-Klassen (VlCompat, VlCsvImporter, VlCategoryMapper, VlDescriptionBuilder, VlTagBuilder, VlFeatureMapper, VlMediaDownloader, VlParameterMapper) + Hauptmodul + AJAX-Dispatcher + CRON. Kein Override einer PrestaShop-Core-Klasse, kein Hook, kein AdminController, kein BO-Tab.
FTP: Download via VlCompat::downloadFromFtp() (cURL-URL ftp://user:pass@host:port/path). Verbindungstest via ftp_connect + ftp_login + ftp_pasv + ftp_size. Passwort verschlüsselt in WPVL_SETTINGS gespeichert, in JSON-Antworten maskiert (• wiederholt).
Kodierung: Konvertierung Windows-1252 → UTF-8 Zelle für Zelle via mb_convert_encoding() mit Vorabprüfung, ob bereits gültiges UTF-8. parseDecimal(): Komma → Punkt + Leading-Dot-Fix (.354 → 0.354).
Multi-Bilder CDN: VlCompat::downloadPicturesMappingCsv() lädt die zweite Mapping-CSV von der hartkodierten URL VL_PICTURES_MAPPING_URL. Cache 24 Std. loadPicturesMapping() liefert Array SKU → [URL1, URL2, …, URL25]. importMultiImages() ruft imageUrlExists() auf (cURL HEAD NOBODY), dann ImageManager::resize, Fix BO PS9 per 1:1-Kopie der Originaldatei.
Streaming JSON: streamParseToFiles() schreibt jede CSV-Zeile in eine Datei uploads/state/full_import_rows/<idx>.json. Ermöglicht punktgenaue Wiederaufnahme nach Unterbrechung + Resilienz bei Server-Neustarts.
Auto-Restart CRON: via asynchroner cURL-Loopback zum selben Endpoint mit dem Geheimschlüssel. Zeitbudget 60 s Standard, @ignore_user_abort(true) für Überleben während des Restarts. Anti-Konkurrenz-Lock via flock auf uploads/state/cron_*.lock.
VlCategoryMapper: resolveChainOrCreate(array $names) über 10 Ebenen. SQL-Lookup vor Category::add() (Doppelvermeidung per SELECT nach Name + Eltern – ohne LIMIT 1, da PrestaShop es automatisch hinzufügt; eine Verdopplung wäre ein fataler SQL-Fehler). Slug via VlCompat::slug(). Mehrsprachig (alle aktiven Sprachen erhalten denselben Namen).
GPSR EU 2024: 5 Settings-Felder (gpsr_manufacturer_name, gpsr_address, gpsr_email, gpsr_phone, gpsr_eu_representative) alle optional. VlDescriptionBuilder liest die Settings (niemals die CSV für GPSR – Produkt-Entscheidung). Bedingte Anzeige: Der Abschnitt erscheint nur, wenn mindestens ein Feld ausgefüllt ist. E-Mail + Telefon klickbar gemacht (mailto: / tel:).
Sicherheit: pSQL() überall, Ordner uploads/ per index.php-Redirect geschützt, HTTP-HEAD-Validierung der Bilder, nativer PS-CSRF auf AJAX, systematische HTML-Escapes, hash_equals() auf CRON-Schlüssel, FTP-Passwort in Antworten maskiert.
PS9-spezifische Kompatibilität: automatische Migration meta_keywords → ps_tag/ps_product_tag via Tag::addTags(), Behandlung des Product::delete()-Quirks, der in Multi-Shop false zurückgibt, BO-PS9-Fix für Originalbild, Bereinigung von <>{} vor Tag::addTags() (sonst lehnt Validate::isGenericName die gesamte Liste ab).
Multi-Shop: ensureSupplierExists() als direkter SQL-INSERT (Bypass new Supplier() + ->add(), das in PS9 still abstürzt). Dynamische Erkennung der Spalte meta_keywords in ps_supplier_lang (in PS7 vorhanden, in PS9 entfernt). Verknüpfung ps_supplier_shop auf allen aktiven Shops.
📦 Modul entwickelt von WebPoint · webpoint.fr · Regelmäßige Updates · Sauberer & kommentierter Code
