Module PrestaShop de dropshipping VELLEMAN
🔌 ⚡ 🔬
Module Velleman Dropshipping Composants Électroniques
Le module qui automatise de A à Z votre dropshipping composants, modules, kits et audio sur PrestaShop
PrestaShop 1.7 → 9.x · ~6 000 produits · FTP sécurisé · 25 images/produit · CRON 24/7 · GPSR UE 2024
Vous lancez une boutique de composants électroniques, un site spécialisé Arduino / Raspberry / makers DIY, un e-commerce d'éclairage scénique ou d'audio professionnel ? Vous travaillez avec Velleman Group (grossiste belge historique fondé en 1976, référent européen sur les composants, modules, kits éducatifs, sonorisation, lumière scénique, outillage de mesure) et vous passez vos journées à recopier 6 000 fiches produit, à uploader manuellement 25 photos par produit, à recréer chaque catégorie sur 10 niveaux hiérarchiques, à parser à la main les caractéristiques techniques détaillées (Physique / Électrique / Technique / Installation), à gérer 10 paliers de prix dégressifs selon vos volumes d'achat ?
Avec le Module Velleman dropshipping composants électroniques modules kits FTP, tout devient automatique. Vous renseignez vos accès FTP Velleman (host, port, user, pass, chemin de votre fichier personnalisé), vous cliquez "Lancer l'import", et le module télécharge votre CSV 64 colonnes en Windows-1252, le convertit en UTF-8 cellule par cellule, télécharge le 2e CSV de mapping images depuis le CDN Velleman (URL hardcodée invisible côté client), et crée vos ~6 000 produits PrestaShop dans une arborescence à 10 niveaux générée à la volée, chacun avec sa fiche PREMIUM 10 sections (bandeau identité marque + EAN + statut, intro courte, points clés, cards caractéristiques techniques, dimensions, conditionnement, origine, éco-contribution, conformité GPSR UE 2024, CTA fournisseur), jusqu'à 25 images par produit, et conformité européenne GPSR alimentée par votre formulaire dédié.
⚡ Avant vs Après le Module Velleman
| Tâche |
❌ Sans le module |
✅ Avec le module |
| Import 6 000 références électroniques | 200h+ manuel, recopie portail B2B Velleman | 1 clic, ~5h en arrière-plan via CRON auto-relancé |
| Téléchargement du catalogue source | Téléchargement manuel par FTP / extranet B2B + upload BO | Connexion FTP automatique avec 5 champs (host, port, user, pass, path) |
| Multi-images (jusqu'à 25 par produit) | Téléchargement manuel sur le CDN, copie sur serveur, upload PS 1 par 1 | 2e CSV de mapping CDN Velleman + téléchargement auto · 1re = cover |
| Encodage Windows-1252 (legacy) | Caractères français cassés, accents en mojibake (« é », « ° ») | Conversion automatique cellule par cellule via mb_convert_encoding() |
| CSV 64 colonnes sans header | Parsing manuel par index numérique, erreurs garanties | Mapping symbolique en constantes (COL_SKU, COL_NAME, COL_BULLETS…) |
| Décimaux virgule + préfixe pointé (.354) | Erreurs de cast float, prix à 0 ou aberrants | parseDecimal() : virgule → point + leading dot fix (.354 → 0.354) |
| Caractéristiques techniques détaillées (col 63) | Texte plat, illisible, non SEO | Parsing en cards par groupe (Physique / Électrique / Technique / Installation) |
| Conformité GPSR UE 2024 | Risque amende UE pour absence des coordonnées fabricant sur fiches | Formulaire dédié 5 champs (fabricant, adresse, email, tel, repr. UE) — affichage automatique |
| 10 paliers de prix dégressifs Velleman | Choix au pifomètre du prix de revient, marge instable | Sélecteur du palier prix d'achat (5/25/100/500…) dans Paramètres |
| Hiérarchie catégories (10 niveaux) | Création manuelle, des heures pour aligner la nomenclature | Création à la volée niveau par niveau sous votre racine PS |
| Rafraîchir prix/stock | Tout refaire à zéro chaque jour | CRON light_sync 2-4h : MAJ prix+stock seulement (mode léger) |
👤 À qui s'adresse ce module ?
🔬
E-commerce composants & modules
Vous vendez résistances, condensateurs, LED, transistors, microcontrôleurs (Arduino, Raspberry, ESP32), capteurs, modules d'extension. Velleman propose une gamme historique référente en Europe sur ces niches makers / DIY / éducation.
🎓
Boutique kits éducatifs & STEM
Kits robotique, kits soudure pour débutants, kits Arduino enseignement, projets pédagogiques pour collèges/lycées et écoles d'ingénieurs. Velleman EDU est une gamme dédiée éducation depuis 30 ans.
🎵
E-commerce audio & sonorisation
Amplis, enceintes, micros, tables de mixage, projecteurs scéniques LED, lasers d'effets, machines à fumée. Velleman propose une gamme audio pro/semi-pro (HQ Power, Vonyx, Skytec, Showtec, BoomTone DJ) très demandée en France.
🛠️
Boutique outillage électronique
Multimètres, oscilloscopes, fers à souder, pinces, tournevis de précision, loupes, microscopes USB. Outils de mesure et de réparation pour techniciens, hobbyistes, écoles techniques.
🚨
Boutique sécurité & domotique
Caméras IP, détecteurs de présence, alarmes filaires/sans fil, sirènes, contrôle d'accès, gestion d'éclairage. Une niche en croissance avec PERFECT (gamme Velleman dédiée sécurité).
🎯 Fonctionnalités complètes du Module Velleman
🌐 Connexion FTP individuelle par revendeur
Particularité Velleman. Chaque revendeur partenaire reçoit un fichier CSV personnalisé sur le serveur FTP Velleman, avec ses propres conditions tarifaires (paliers dégressifs spécifiques à votre compte). Le fichier porte un nom unique (ex : VotreFichier.csv). Les accès FTP (host, port, user, pass) ne sont jamais partagés et restent strictement individuels.
Solution adoptée par le module : 5 champs FTP dans Paramètres, jamais hardcodés, mot de passe masqué dans la BDD et dans les retours JSON. Bouton "Tester la connexion FTP" qui valide en direct l'authentification, le mode passif et l'accessibilité du fichier.
5 champs FTP :
- Host : ftp.velleman.eu (ou variant régional)
- Port : 21 (par défaut, modifiable)
- User : votre identifiant Velleman B2B
- Password : masqué dans la base, jamais affiché en clair
- Path : /VotreFichier.csv
- Authentification + mode passif via
ftp_connect + ftp_login + ftp_pasv (compatible avec la quasi-totalité des firewalls)
- Vérification taille fichier (
ftp_size) avant téléchargement pour rejeter les fichiers vides/corrompus
- Téléchargement curl via URL
ftp://user:pass@host:port/path — robuste et performant
- Mot de passe sécurisé : stocké chiffré, masqué dans le retour JSON (• répétés), jamais loggué
📊 CSV 64 colonnes Windows-1252 — Parsing robuste
Le CSV Velleman comporte 64 colonnes sans header (premier enregistrement = données, pas en-têtes), encodé en Windows-1252 (legacy européen) avec séparateur point-virgule. Le module gère ces particularités héritées :
- Mapping symbolique en constantes 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. Plus de magic numbers, code lisible et maintenable.
- Conversion Windows-1252 → UTF-8 cellule par cellule via
mb_convert_encoding() avec détection préalable si déjà UTF-8 valide
- Parsing décimal européen : virgule → point automatique sur prix, poids, dimensions
- Fix leading dot : ".354" → "0.354" automatique (sinon cast float fait n'importe quoi)
- Streaming par fichiers JSON : 1 ligne CSV → 1 fichier
uploads/state/full_import_rows/<idx>.json pour permettre la reprise précise après interruption
📸 Multi-images jusqu'à 25 par produit via CDN Velleman
Innovation propre au module Velleman : un 2e CSV de mapping image est téléchargé automatiquement depuis le CDN Velleman public (URL hardcodée dans le code, jamais visible côté client) qui associe chaque SKU à une liste d'URLs d'images de produit (jusqu'à 25 vues). Le module split, valide chaque URL, et importe toutes les images dans l'ordre.
- 1re URL = cover automatiquement
- Validation HEAD HTTP (curl NOBODY) avant téléchargement : URLs cassées rejetées sans crasher l'import
- Cache 24h : le mapping est rechargé automatiquement seulement s'il a plus de 24h, économise la bande passante
- Génération auto de toutes les tailles PS (small, medium, large, home_default…)
- Fix BO PrestaShop 9 inclus : copie 1:1 du fichier original
<id>.jpg en plus des variantes (sinon image cassée dans la page édition produit BO)
🏆 Description PREMIUM auto-générée — 10 sections activables
Le module compose automatiquement une fiche produit visuellement riche, structurée en 10 sections indépendamment activables via switches dans l'onglet Options. Chaque section a son design, ses couleurs, ses icônes, son objectif SEO/conversion :
| Section | Description |
|---|
| 🏷️ Bandeau d'identité | Bloc d'en-tête coloré : marque, référence, EAN + badge statut (Nouveauté / Bientôt / Stock disponible) |
| 📝 Intro courte | Description résumée fournie par Velleman (col 3) — 1-2 phrases pour le contexte général |
| ✨ Points clés (puces) | Transforme les "•" du champ description longue en liste à puces stylée (encadré bleu) |
| 🔬 Cards techniques | Parse "Caractéristiques détaillées" (col 63) en cards visuelles par groupe (Couleur, Tension, Capacité, Pitch, Montage…) |
| 📐 Dimensions & poids | Tableau largeur / hauteur / profondeur / poids depuis les colonnes 55-58 |
| 📦 Conditionnement | Type emballage (Vrac/Lot), multiple de commande, qty par carton intérieur/extérieur |
| 🌍 Origine + HS Code | Pays d'origine + code douanier Intrastat (utile B2B + conformité commerce intra/extra UE) |
| ♻️ Éco-contribution | Bloc DEEE / environnement (cols 23-27) — transparence client, conformité environnement |
| ✅ Conformité GPSR | Coordonnées fabricant + représentant UE — issu de votre formulaire dédié dans Paramètres |
| 📞 CTA fournisseur | Bloc bas de fiche : "Une question ?" + nom boutique + téléphone cliquable + durée garantie |
Toutes les sections sont activables/désactivables individuellement dans l'onglet Options. Vous pouvez tout activer pour des fiches très riches, ou tout couper sauf l'identité + le CTA pour un rendu épuré.
✅ Conformité GPSR UE 2024 — Formulaire dédié
Le règlement GPSR (General Product Safety Regulation) de l'Union Européenne, en vigueur depuis le 13 décembre 2024, impose à tous les e-commerçants de la zone d'afficher sur chaque fiche produit les coordonnées du fabricant (et du représentant UE si fabricant hors UE). Manquement = amende.
Solution adoptée par le module : un panneau dédié dans l'onglet Paramètres avec 5 champs tous optionnels que vous remplissez une seule fois. Les coordonnées s'affichent automatiquement dans toutes les fiches produit Velleman.
- Nom du fabricant (ex : "Velleman Group NV")
- Adresse postale complète (rue, code postal, ville, pays)
- Email de contact (rendu cliquable via
mailto:)
- Téléphone (rendu cliquable via
tel:)
- Représentant UE (uniquement si fabricant hors UE — laisser vide pour Velleman Belgique)
Affichage conditionnel intelligent : la section GPSR ne s'affiche dans les fiches produit que si au moins un champ est rempli. Vous pouvez démarrer sans GPSR, le module ne plante pas. Format visuel rouge clair pour rappeler son caractère réglementaire.
💰 10 paliers de prix dégressifs Velleman
Velleman propose jusqu'à 10 paliers de prix dégressifs selon les quantités d'achat (typiquement : 1, 5, 10, 25, 50, 100, 250, 500, 1000, 5000+). Chaque palier a son propre prix HT négocié dans votre contrat B2B Velleman.
Solution adoptée par le module : un sélecteur dans Paramètres pour choisir le palier qui correspond à votre volume d'achat moyen réel. Le module utilise ce palier comme prix de revient unique pour calculer le prix de vente final selon votre mode (margins / fixed / wholesale).
- Sélecteur palier : 1 / 5 / 25 / 100 / 500 (par défaut 5, le plus courant pour PME)
- Mode margins : 6 paliers de marge configurables par tranche de prix HT
- Mode fixed : 1 markup en % appliqué uniformément (ex 50%)
- Mode wholesale : prix d'achat HT inchangé (vente B2B aux écoles, makers space, etc.)
🌳 Hiérarchie de catégories sur 10 niveaux
Le CSV Velleman fournit jusqu'à 10 colonnes "Titre catégorie 1..10" formant une hiérarchie linéaire profonde (root → enfant → petit-enfant → arrière-petit-enfant…). Chaque produit appartient à une feuille au bout d'une chaîne de catégories.
Solution adoptée par le module : création à la volée des catégories manquantes sous votre racine PrestaShop configurée. Lookup avant création (anti-doublons) avec query SQL optimisée.
Exemple :
"Composants Électroniques & Accessoires"
→ "Composants électroniques"
→ "Condensateurs"
→ "Tantale"
→ "Hauteur basse"
→ ...
- Création multilingue sous votre racine PS (toutes les langues actives reçoivent le même nom + slug)
- Lookup avant create : SELECT par nom + parent → si trouvée, on réutilise l'ID existant
- Liaison produit complète :
id_category_default = feuille la plus profonde, category_product rempli avec toute la chaîne (filtres facetedsearch fonctionnent à tous les niveaux)
- Slug automatique via
VlCompat::slug() (URL-safe, accents normalisés)
⚡ Architecture import temps réel + CRON 24/7
Le scénario qui change tout :
- 📥 Préparation : le module se connecte au FTP Velleman, télécharge votre CSV personnalisé (jusqu'à 10 Mo), le stream-parse et écrit chaque ligne dans un fichier JSON séparé
- 📦 Mapping CDN images : téléchargement automatique du 2e CSV CDN Velleman (cache 24h, URL invisible côté client)
- 🚀 Import "1 ligne CSV = 1 appel AJAX" : pas de freeze 5 heures, vous voyez chaque produit créé un par un
- 📊 Barre de progression bleue & or : pourcentage live + compteur X/Y
- 📋 Journal live : badge coloré (Créé / Mis à jour / Ignoré / Erreur) + référence + nom produit + ID PS#
- ⏸️ Bouton Arrêter à tout moment, reprise précise à la ligne d'arrêt
- 📈 Stats live : Lignes traitées · Créés · Mis à jour · Ignorés · Erreurs
→ Plus de page qui rame. Plus d'inquiétude. Vous voyez tout ce qui se passe.
⏰ CRON 24/7 — 4 actions automatisées
| Action CRON |
Rôle |
Fréquence conseillée |
full_import | Import complet (créations + light updates) | 1×/jour (heure creuse) |
light_sync | MAJ prix + stock + dispo des produits déjà importés | toutes les 2-4h |
rebuild_tags | Reconstruire les tags PS sur tous les produits déjà importés (utile après modif des règles de tagging) | à la demande |
cleanup_logs | Purge logs > N jours (rétention configurable) | 1×/semaine |
- Clé secrète 32 caractères hex générée à l'install — vos URLs CRON ne peuvent pas être devinées
- Régénération à 1 clic de la clé en cas de fuite
- Auto-relance asynchrone via curl loopback : auto-rappel en arrière-plan si le time-budget est atteint (60s par défaut), survie via
@ignore_user_abort(true)
- Reprise précise : reprend exactement à la ligne où il s'est arrêté
- Lock anti-concurrence via flock : pas d'exécutions parallèles
- Bouton Stop côté BO pour arrêter proprement un CRON en cours (flag file)
- Limite produits par exécution configurable (10-100 pour valider en mode test, 0 = illimité en production)
- Flash "tâche lancée en arrière-plan" immédiat sur clic Test BO — vous savez tout de suite que le serveur travaille
🏷️ Le catalogue Velleman en chiffres
~6 000
références électroniques
10
paliers prix dégressifs
Univers produits du catalogue Velleman (extrait par grandes familles) :
Composants passifs
Modules Arduino/Raspberry
Kits éducatifs
Audio pro / DJ
Éclairage scénique LED
Lasers d'effets
Outillage mesure
Sécurité / Domotique
Connectique RJ45/HDMI
Robotique STEM
+ accessoires variés
Marques internes Velleman : Velleman Kit (kits soudure), Velleman Modules, Vellight (éclairage), HQ Power (audio pro), Vonyx, Skytec, Showtec, BoomTone DJ, Perfect (sécurité), Toolland (outillage), Velleman EDU (éducation).
🛠️ Maintenance — Suppression sélective
- ☐ Produits importés : détection à 2 sources (table meta + id_supplier), compatible PS9 multi-shop avec fallback wipe SQL si
Product::delete() retourne false
- ☐ Catégories vides : balayage par profondeur descendante via nleft/nright, suppression seulement si zéro produit lié + zéro sous-cat (préserve les racines PS_HOME, PS_ROOT)
- ☐ Marque Velleman : supprime le manufacturer uniquement s'il n'a plus aucun produit lié (double confirmation requise)
- ☐ Journaux internes : truncate des tables history et import_errors
Confirmation simple ou double selon le périmètre, avec onglet dédié Outils → Suppression sélective. L'arborescence des catégories est préservée si vous avez des produits ailleurs (non-Velleman) qui les utilisent encore.
⭐ 12 raisons de choisir le Module Velleman
- 🌐 Connexion FTP individuelle par revendeur (5 champs) — chaque client a son fichier numéroté, ses paliers personnels
- 📸 Multi-images jusqu'à 25 vues/produit via 2e CSV CDN (URL hardcodée invisible client) — innovation propre Velleman
- 🏆 Description PREMIUM 10 sections activables individuellement (bandeau, intro, points clés, cards techniques, dimensions, conditionnement, origine, éco, GPSR, CTA)
- ✅ Conformité GPSR UE 2024 via formulaire dédié (5 champs optionnels) — affichage automatique dans toutes les fiches
- 🌳 10 niveaux de catégories hiérarchiques créés à la volée — gestion d'arborescences profondes spécifiques composants
- 💰 10 paliers de prix dégressifs Velleman + sélecteur prix d'achat dans Paramètres
- 🔬 Parsing intelligent caractéristiques détaillées (col 63) : 1 section = 1 card visuelle (Physique / Électrique / Technique / Installation)
- 🌍 Encodage Windows-1252 auto-converti en UTF-8 cellule par cellule (préserve "Métré", "Réservé", caractères techniques européens)
- 🔢 Décimaux virgule + préfixes pointés auto-corrigés (ex : .354 → 0.354 — sinon cast float plante)
- ⚡ Import temps réel produit-par-produit : barre live, journal console, bouton Arrêter, reprise précise
- ⏰ CRON 24/7 sécurisé avec time-budget, auto-relance asynchrone, retry, lock, mode test, limiteur produits
- 💎 Aucun AdminController, aucune Tab BO, aucun override : ne pollue pas votre menu, ne casse pas vos autres modules
🎬 Comment ça marche en 5 étapes
1
Installez le module
Téléchargez le ZIP, installez via le BO. Auto-création de 3 tables, du fournisseur Velleman, de la clé CRON.
2
Renseignez les 5 champs FTP
Demandez vos accès à votre commercial Velleman (host, user, pass, chemin du fichier personnalisé). Testez la connexion en 1 clic.
3
Configurez marges + GPSR
Choisissez le palier prix d'achat (5/25/100…). Mode marges (6 paliers) ou markup fixe ou wholesale. Remplissez le formulaire GPSR optionnel.
4
Composez les 10 sections
Onglet Options : activez/désactivez chacune des 10 sections de la description PREMIUM (tout est ON par défaut).
5
Lancez l'import
Mode test 10 produits d'abord pour valider, puis import complet ~6 000 produits (~5h via CRON auto-relancé).
🔧 Compatibilité technique
| PrestaShop | 1.7.x → 9.x (testé sur PS 9.0) |
| PHP | 7.4 minimum, recommandé 8.1+ |
| MySQL / MariaDB | 5.7+ / 10.3+ |
| cURL + ext FTP | Activés (téléchargement FTP CSV + CDN images) |
| Multi-shop | Compatible (force CONTEXT_ALL pour la suppression) |
| Hooks utilisés | Aucun (pas de pollution de la chaîne d'événements) |
| Override de classe | Aucun (préserve vos autres modules) |
| AdminController | Aucun |
| Onglet sidebar BO | Aucun (ne pollue pas votre menu) |
| Compte Velleman B2B | Compte revendeur partenaire requis (accès FTP individuel + paliers négociés) |
| Identifiants FTP | À demander à votre commercial Velleman (host, port, user, pass, path du fichier) |
❓ Foire aux questions
Q : Le Module Velleman fonctionne-t-il sur PrestaShop 9 ?
R : Oui, totalement compatible PS 9.x. Le module gère la migration spécifique PS9 où meta_keywords a été retiré (bascule auto vers ps_tag) ainsi que le bug PS9 où l'image originale n'apparaît pas dans la page d'édition produit BO (fix par copie 1:1 du fichier <id>.jpg). Tous les caractères interdits par PS9 (<>{}) sont nettoyés avant Tag::addTags() pour éviter le rejet de toute la liste.
Q : Pourquoi se connecter en FTP plutôt qu'en HTTPS classique ?
R : C'est la décision de Velleman. Chaque revendeur partenaire reçoit un fichier CSV personnalisé sur le serveur FTP B2B Velleman, avec ses paliers tarifaires individuels. Pas d'URL HTTPS publique. Le module gère cette spécificité : 5 champs FTP, mot de passe sécurisé masqué, mode passif compatible firewall, vérification taille avant téléchargement.
Q : Le 2e CSV de mapping images, c'est quoi exactement ?
R : Velleman publie un 2e CSV public sur son CDN qui associe chaque SKU à une liste d'URLs d'images du produit (jusqu'à 25 vues : face, dos, côté, en main, packaging, schéma, mode d'emploi…). L'URL CDN est hardcodée dans le code du module (jamais visible côté client) — vous n'avez rien à configurer. Le mapping est rechargé automatiquement toutes les 24h.
Q : Le CSV est en Windows-1252 — comment le module gère ça ?
R : Le module convertit chaque cellule de Windows-1252 vers UTF-8 via mb_convert_encoding() (avec détection auto si la cellule est déjà UTF-8 valide). Les caractères techniques européens (degrés °, micro µ, ohm Ω, plus-or-minus ±, etc.) sont préservés. Décimales virgule converties en point. Préfixes pointés (.354) corrigés en (0.354) pour éviter les casts float aberrants.
Q : La conformité GPSR est-elle obligatoire ?
R : Oui, depuis le 13 décembre 2024 dans toute l'UE. Cependant, le module ne vous force pas à remplir le formulaire — les 5 champs sont tous optionnels. Vous pouvez démarrer sans GPSR (pour vos tests) puis remplir le formulaire avant de mettre en ligne. La section ne s'affiche dans les fiches que si au moins un champ est rempli.
Q : Comment choisir le bon palier de prix dégressif ?
R : Le sélecteur dans Paramètres propose les paliers Velleman habituels (1, 5, 25, 100, 500). Choisissez celui qui correspond à votre volume d'achat moyen réel. Si vous achetez par lots de 25 sur la majorité des références, choisissez 25. Le module utilisera ce palier comme prix de revient pour calculer le prix de vente final (selon votre mode marges/fixed/wholesale).
Q : Puis-je désactiver certaines sections de la description PREMIUM ?
R : Oui, chacune des 10 sections (bandeau identité, intro, points clés, cards techniques, dimensions, conditionnement, origine, éco-contribution, GPSR, CTA) est activable/désactivable individuellement via switch dans l'onglet Options. Tout est ON par défaut pour offrir la fiche la plus riche, mais vous pouvez tout couper sauf l'identité + le CTA pour un rendu épuré.
Q : Puis-je importer plusieurs fois le même CSV ?
R : Oui. Mode léger automatique (action CRON light_sync) : les produits existants sont détectés via leur SKU unique et seuls leur prix + stock sont rafraîchis. Vos descriptions, images, catégories et tags personnalisés ne sont pas réécrits — vos modifications BO sont préservées.
Q : Comment supprimer tous les produits Velleman ?
R : Onglet Outils → Suppression sélective → cochez "Produits importés" + "Catégories vides" + "Marque Velleman" + "Journaux" → Exécuter. Confirmation simple ou double selon le périmètre. L'arborescence est préservée si elle est utilisée par des produits non-Velleman.
Q : Et si je veux arrêter un import en cours ?
R : Bouton "Arrêter" disponible pendant l'import (UI) et pendant le CRON (flag file). Stop propre à la fin du produit en cours, sauvegarde précise de l'état pour reprise à la ligne exacte d'arrêt. Le module survit même à un redémarrage serveur grâce au stream JSON par fichier.
Q : Le module est-il compatible multi-shop ?
R : Oui. Les catégories et produits sont créés sur tous les shops actifs. La suppression force CONTEXT_ALL pour éviter le quirk PS9 où Product->delete() retourne false en multi-shop. Le fournisseur Velleman est lié à tous les shops actifs via ps_supplier_shop.
Q : Aucun AdminController, aucune Tab BO ?
R : Confirmé. Le module utilise uniquement getContent() + AJAX. Pas de pollution du menu BO PrestaShop. Aucun override de classe core. Aucun hook (la chaîne d'événements PS reste intacte). Vos autres modules ne sont pas impactés à l'install ni à la désinstall.
⚡ Prêt à automatiser votre dropshipping électronique ?
Le Module Velleman dropshipping composants électroniques modules kits FTP est l'outil le plus complet pour vendre les ~6 000 références Velleman (composants, modules Arduino/Raspberry, kits éducatifs, audio pro, éclairage scénique, outillage, sécurité) sur PrestaShop. Une seule fois configuré, il télécharge automatiquement votre catalogue personnalisé via FTP, importe jusqu'à 25 images par produit depuis le CDN, génère une description PREMIUM 10 sections, et reste conforme GPSR UE 2024.
⚡ INSTALLATION 5 MIN · 📚 IMPORT TEMPS RÉEL · 🛡️ COMPATIBLE PS 1.7 → 9 · ✅ GPSR UE 2024 · 🇫🇷 SUPPORT FRANÇAIS
📋 Détails techniques pour développeurs
Tables BDD créées (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).
Configurations PS : WPVL_SETTINGS (JSON 30+ clés), WPVL_SUPPLIER_ID, WPVL_CRON_KEY, WPVL_LAST_IMPORT_AT, WPVL_CRON_LAST_*.
CSV Velleman (64 colonnes Windows-1252, séparateur point-virgule, sans 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.
Architecture : 8 classes PHP (VlCompat, VlCsvImporter, VlCategoryMapper, VlDescriptionBuilder, VlTagBuilder, VlFeatureMapper, VlMediaDownloader, VlParameterMapper) + module principal + dispatcher AJAX + CRON. Aucun override de classe core PrestaShop, aucun hook, aucun AdminController, aucune Tab BO.
FTP : téléchargement via VlCompat::downloadFromFtp() (curl URL ftp://user:pass@host:port/path). Test connexion via ftp_connect + ftp_login + ftp_pasv + ftp_size. Mot de passe stocké chiffré dans WPVL_SETTINGS, masqué dans les retours JSON (• répétés).
Encodage : conversion Windows-1252 → UTF-8 cellule par cellule via mb_convert_encoding() avec détection préalable si déjà UTF-8 valide. parseDecimal() : virgule → point + leading dot fix (.354 → 0.354).
Multi-images CDN : VlCompat::downloadPicturesMappingCsv() télécharge le 2e CSV mapping depuis URL hardcodée VL_PICTURES_MAPPING_URL. Cache 24h. loadPicturesMapping() retourne array SKU → [URL1, URL2, …, URL25]. importMultiImages() appelle imageUrlExists() (curl HEAD NOBODY) puis ImageManager::resize, fix BO PS9 par copie 1:1 du fichier original.
Streaming JSON : streamParseToFiles() écrit chaque ligne CSV dans un fichier uploads/state/full_import_rows/<idx>.json. Permet la reprise précise après interruption + résilience aux redémarrages serveur.
Auto-relance CRON : via curl loopback asynchrone vers le même endpoint avec la clé secrète. Time-budget 60s par défaut, @ignore_user_abort(true) pour survie pendant la relance. Lock anti-concurrence via flock sur uploads/state/cron_*.lock.
VlCategoryMapper : resolveChainOrCreate(array $names) sur 10 niveaux. Lookup SQL avant Category::add() (anti-doublons via SELECT par nom + parent — sans LIMIT 1 car PrestaShop l'ajoute auto, dupliquer = erreur SQL fatale). Slug via VlCompat::slug(). Multilingue (toutes les langues actives reçoivent le même nom).
GPSR UE 2024 : 5 champs settings (gpsr_manufacturer_name, gpsr_address, gpsr_email, gpsr_phone, gpsr_eu_representative) tous optionnels. VlDescriptionBuilder lit les settings (jamais le CSV pour GPSR — décision produit). Affichage conditionnel : la section ne s'affiche que si au moins un champ est rempli. Email + téléphone rendus cliquables (mailto: / tel:).
Sécurité : pSQL() partout, dossier uploads/ protégé par index.php redirect, validation HEAD HTTP des images, CSRF natif PS sur AJAX, échappements HTML systématiques, hash_equals() sur clé CRON, mot de passe FTP masqué dans les retours.
Compatibilité PS9 spécifique : migration auto meta_keywords → ps_tag/ps_product_tag via Tag::addTags(), gestion du quirk Product::delete() qui retourne false en multi-shop, fix BO PS9 image originale, nettoyage <>{} avant Tag::addTags() (sinon Validate::isGenericName rejette toute la liste).
Multi-shop : ensureSupplierExists() en INSERT SQL direct (bypass new Supplier() + ->add() qui plante silencieusement en PS9). Détection dynamique de la colonne meta_keywords dans ps_supplier_lang (présente PS7, retirée PS9). Liaison ps_supplier_shop sur tous les shops actifs.
📦 Module développé par WebPoint · webpoint.fr · Mises à jour régulières · Code propre & commenté
