Módulo PrestaShop de dropshipping TRAINING-DISTRIBUTION
🌐 Catálogo fuente disponible en: 
🇫🇷 Catálogo 100% francés nativo. Sin traducción automática: textos redactados directamente en FR por el proveedor, ideal para tiendas 🇫🇷 FR / 🇧🇪 BE / 🇨🇭 CH / 🇨🇦 CA.
💪 🏋️ 🔥
Módulo Training-Distribution Dropshipping Deporte
El módulo que automatiza de la A a la Z tu dropshipping de cross-training, fitness y nutrición deportiva en PrestaShop
PrestaShop 1.7 → 9.x · 2 300 productos · 32 marcas · 10 categorías deporte · CRON 24/7
¿Vas a lanzar una tienda de material de musculación, una web de cross-training, un e-commerce de nutrición deportiva o de ropa deportiva? Trabajas con Training-Distribution (mayorista francés especializado en Cross Training y fitness) y te pasas los días copiando 2 300 fichas de producto, subiendo manualmente las múltiples fotos por producto, recreando cada talla/color como un producto distinto (porque las referencias del proveedor cambian entre tallas), mapeando cada categoría a las secciones correctas de tu árbol?
Con el Módulo Training-Distribution dropshipping deporte cross-training fitness, todo se vuelve automático. Introduces la URL del CSV Training-Distribution, haces clic en "Iniciar importación", y el módulo crea tus 2 300 productos PrestaShop en francés con su talla + color en el título, sus N fotos desde la celda única CSV, su referencia nativa, en un árbol de 10 categorías deporte listo para usar (Ropa Mujer, Ropa Deportiva, Calzado, Calcetines, Manos & Calleras, Protecciones cuerpo, Cuerdas & Cargas, Nutrición & Suplementos, Accesorios deporte, Otro).
⚡ Antes vs Después del Módulo Training-Distribution
| Tarea |
❌ Sin el módulo |
✅ Con el módulo |
| Importar 2 300 referencias deporte | 80h+ manual, copia desde portal Training-Distribution | 1 clic, ~2h en segundo plano |
| Color + Talla en el título | Introducción manual «Rodilleras Negro Talla XL» al final del título | Auto-añade «— Color · Talla XX» + truncado 128 chars |
| Multi-imágenes desde celda única | Parsing manual de URLs concatenadas por comas | Split + validación auto, 1ª = cover |
| Descripción CSV vacía (no se proporciona) | Fichas fantasma, mal SEO, tasa de rebote | Auto-generación HTML estructurado nombre + marca + cat |
| Categoría única CSV (1 nivel) | Creación manual de un árbol coherente deporte | 10 cats principales + 42 sub-cats creadas en la instalación |
| Codificación ISO-8859-1 (no UTF-8) | Caracteres franceses rotos («Mapalé», «Genouillères») | Conversión automática celda por celda |
| Símbolo € mal codificado (¤ en ISO) | Precios con «¤» o fallidos en la importación | ¤ stripped automáticamente, precios limpios |
| Imagen original BO PrestaShop 9 | Imagen rota BO PS9 (bug oficial) | Fix BO PS9 incluido: copia 1:1 del archivo original |
| Refrescar precios/stock | Rehacer todo desde cero cada día | Modo ligero automático: actualización precios+stock solo |
👤 ¿A quién va dirigido este módulo?
🏋️
E-commerce Cross Training & Fitness
Vendes material cross-training (rodilleras, cinturones, calleras, cuerdas para saltar, discos bumper, correas), ropa training, calzado de Halterofilia. Training-Distribution es referente FR en estos nichos con ROKFIT, REHBAND, PICSIL, VELITES como marcas estrella.
💪
Tienda de musculación
Ofreces accesorios de fuerza y musculación: cinturones de fuerza, muñequeras, rodilleras, chalecos lastrados, halterofilia. ~150 referencias específicamente de musculación en el catálogo.
🥤
E-commerce nutrición deportiva
Proteínas, BCAA, pre-workout, snacks proteicos (BAREBELLS, NOCCO), bebidas energéticas, omega 3 y suplementos alimentarios deporte. ~150 referencias nutrición para una oferta francófona completa.
🎯 Funcionalidades completas del Módulo Training-Distribution
🎨 Color + Talla añadidos al título — Innovación Training-Distribution
Particularidad del CSV Training-Distribution. A diferencia de otros proveedores, la «Referencia» cambia para cada talla (ej. `R_N_GEN_0535_XS`, `_S`, `_M`, `_L`, `_XL` — todas distintas). Peor aún: la coherencia ni siquiera se garantiza en el truncado (línea L tiene `R-N_GEN_0535_L` con guión en lugar de subrayado). Consecuencia: imposible agrupar varias líneas en 1 producto con sus combinaciones PS.
Solución adoptada por el módulo: 1 línea CSV = 1 producto PS distinto, y el color + talla se añaden automáticamente al título del producto con un formato gráfico cuidado.
Ejemplo:
"Par de Rodilleras Negro 5 mm | REHBAND" + Color "Negro" + Talla "XL"
→ "Par de Rodilleras Negro 5 mm | REHBAND — Negro · Talla XL"
- Truncado automático a máx. 128 caracteres (límite
Product::name PS): si el título concatenado supera, el título original se trunca con «…» para dejar sitio al color + talla intactos
- UTF-8 safe: el truncado utiliza
mb_substr(), nunca cortado en medio de un carácter multi-byte
- Formato gráfico: em-dash (—) + middot (·) para buena legibilidad visual
- Referencia nativa por producto: la «Referencia» del CSV se utiliza como
Product::reference (campo PS nativo)
🌳 Árbol deporte — 10 categorías principales × 42 sub-categorías
El CSV Training-Distribution solo expone UN ÚNICO nivel de categoría por producto («Catégorie»). El módulo lo compensa proponiendo en la instalación un árbol deporte de 10 categorías principales listas para usar, con 42 sub-categorías que reproducen idénticamente los nombres expuestos por el CSV.
| Categoría principal | Sub-categorías CSV agrupadas |
|---|
| Ropa Mujer | Sujetadores deporte · Camisetas - Crop tops · Textil Mujer Deporte |
| Ropa Deportiva | Camisetas - Camisetas tirantes · Sudaderas - Hoodies · Pantalones cortos - Mallas · Pantalones cortos - Joggers · Bañador |
| Calzado | Cross Training · Halterofilia & Powerlifting |
| Calcetines | Entrenamiento · Deporte infantil · Calcetines tobilleros transpirables & training ligeros |
| Manos & Calleras | Calleras con/sin magnesio · Calleras Cross Training · Tape & Protección · Magnesio · Parches Velcro |
| Protecciones cuerpo | Cinturones de fuerza · Rodilleras · Muñequeras · Chaleco lastrado |
| Cuerdas & Cargas | Cuerdas para saltar · Cables de repuesto · Discos Bumper · Correa de tracción |
| Nutrición & Suplementos | Proteínas/BCAA/Pre Workout · Snacks · Bebidas energéticas · Vitaminas · Omega 3 · Nutrición Deporte |
| Accesorios deporte | Cintas · Gorras/Gorros · Gafas · Botellas · Bolsa de deporte · Tarjeta regalo |
| Otro | Varios / Por clasificar (fallback: Inicio, vacío, «Catalogue Sport…», desconocido) |
- Creación multilingüe en la instalación: 10 cats principales + 42 sub-cats creadas idempotentemente bajo tu categoría raíz PS
- Caché DB del mapeo: la cat CSV resuelta se memoriza en
wp_trainingdist_category_mapping para las próximas importaciones
- Pestaña Mapeos categorías en el BO: tabla auto-cargada con selector de las 42 sub-cats + botón Re-mapear para fusionar o renombrar después de la importación
- Fallback inteligente: si la cat CSV está vacía, «Inicio», «Categoría» o «Catalogue Sport…», el producto se enruta a Otro > Varios / Por clasificar
- Red de seguridad: en cada apertura del módulo BO, el árbol se reverifica. Una cat eliminada manualmente se recrea automáticamente
📸 Multi-imágenes desde celda única «URL Images»
La columna «URL Images» del CSV contiene N URLs separadas por comas en una celda entre comillas (ej. «url1.jpg,url2.jpg,url3.jpg»). El módulo separa por coma, valida cada URL (prefijo http(s)) e importa todas las imágenes.
- 1ª URL = cover automáticamente
- Validación formato vía
getimagesize(): JPEG/PNG/GIF/WebP, archivos corruptos rechazados sin crashear la importación
- Generación auto de todos los tamaños PS (small, medium, large, home_default…)
- Fix BO PrestaShop 9 incluido: copia 1:1 del archivo original
<id>.jpg además de las variantes
- Descarga resiliente: retry × 3 con backoff en 503/timeout, log de error si fallo total (la importación continúa)
📝 Descripción auto-generada (CSV sin descripción del proveedor)
Training-Distribution no proporciona NINGUNA columna de descripción en el CSV. El módulo genera sistemáticamente una descripción HTML estructurada a partir del nombre, marca, categoría y referencia — para no tener nunca una ficha de producto fantasma en el front (anti-rebote + buen SEO).
🔤 Codificación ISO-8859-1 + separador coma
El CSV training-distribution está en ISO-8859-1 con separador coma (a diferencia de otros módulos que usan UTF-8 + ";"). El módulo gestiona esto:
- Conversión ISO-8859-1 → UTF-8 celda por celda vía
mb_convert_encoding() con auto-detección si ya está en UTF-8
- Símbolo moneda ¤ (= € mal codificado Win-1252) eliminado automáticamente al final de los precios
- Decimales coma convertidos a punto en las columnas Precio y Peso
- Celda URL Images entre comillas: comas internas preservadas por
fgetcsv estándar, splitting hecho en importMultiImages()
⚡ Arquitectura importación tiempo real
El escenario que lo cambia todo:
- 📥 Preparación: el módulo descarga el CSV desde la URL Training-Distribution y pone las 2 300 líneas en caché JSON
- 🚀 Importación "1 línea CSV = 1 llamada AJAX": sin congelación de 2 horas, ves cada producto creado uno por uno
- 📊 Barra de progreso roja & dorada: porcentaje en vivo + contador X/Y
- 📋 Diario en vivo: badge coloreado (Creado / Actualizado / Ignorado / Error) + referencia + título + ID PS#
- ⏸️ Botón Detener en cualquier momento, reanudación posible
- 📈 Stats en vivo: Líneas tratadas · Creados · Actualizados · Ignorados · Errores
→ Fin de la página que se atasca. Fin de la preocupación. Ves todo lo que pasa.
💰 Márgenes & SEO configurables
4 modos de cálculo de precio
| Modo | Descripción |
|---|
| RRP ⭐ (defecto) | Precio de venta CSV tal cual — el más simple para empezar. |
| Tramos | % diferente según el tramo de precio sin IVA (5 tramos configurables: 0-15€/15-30€/30-60€/60-120€/120€+ — adaptado a las proteínas a 30€ como a los discos bumper a 200€+). |
| Markup fijo | Un solo % aplicado (50% por defecto → precio sin IVA × 1.5). |
| Wholesale | Precio de compra sin IVA tal cual (venta B2B a gimnasios, coaches, etc.). |
Plantillas SEO personalizables
- Meta title / meta description con variables:
{name}, {brand}
- PS Tags franceses auto-generados desde brand + category + color (si presente)
- Modo ligero (light update): 2ª importación = actualización precios+stock solo, tus personalizaciones BO se preservan
- Auto-desactivación rotura stock (opción) o «mantener visible para el SEO»
- Imagen en descripción: inyección de la 1ª imagen en la descripción larga (boost SEO on-page)
⏰ CRON 24/7 — 3 acciones automatizadas
| Acción CRON |
Rol |
Frecuencia recomendada |
full_import | Importación completa (creaciones + light updates) | 1×/día |
light_sync | Actualización precio + stock + disponibilidad de productos ya importados (modo ligero) | cada 2-4h |
cleanup_logs | Purga logs > N días (retención configurable) | 1×/semana |
- Clave secreta 32 caracteres hex generada en la instalación — tus URLs CRON no se pueden adivinar
- Regeneración a 1 clic de la clave en caso de fuga
- Auto-relanzamiento asíncrono: auto-rellamada en segundo plano si se alcanza el time-budget (60s por defecto)
- Reanudación precisa: reanuda exactamente en la línea donde se detuvo
- Lock anti-concurrencia vía flock: sin ejecuciones paralelas
- Retry descarga CSV 3× con backoff 2s/4s/6s
- Botón Stop en el lado BO para detener limpiamente un CRON en curso
- Modo test con límite de productos configurable (10-100 para validar rápidamente)
🏷️ El catálogo Training-Distribution en cifras
2 300
referencias catálogo
10
cats principales deporte
Marcas estrella del catálogo Training-Distribution (extracto por volumen):
ROKFIT
REHBAND
PICSIL
BAREBELLS
NOCCO
TYR
NORTHERN SPIRIT
VELITES
CELLUCOR C4
VERY BAD WOD
HEXXEE SOCKS
BARBELL REGIMENT
+ 20 marcas más
🛠️ Mantenimiento — Eliminación selectiva
- ☐ Productos importados: detección a 4 fuentes (meta, supplier, product_supplier, mapeo categorías), compatible PS9 multi-shop con fallback wipe SQL en las tablas relacionadas
- ☐ Atributos huérfanos: este módulo no crea NINGÚN atributo PS (color+talla añadidos al título, sin combinaciones). Esta casilla solo tiene efecto si has creado manualmente atributos en el BO
- ☐ Marcas huérfanas: elimina los fabricantes Training-Distribution (ROKFIT, REHBAND, PICSIL, BAREBELLS, NOCCO, TYR, NORTHERN SPIRIT, VELITES, …) que ya no tienen ningún producto
- ☐ Proveedor Training-Distribution: elimina el proveedor solo si ya no tiene ningún producto vinculado
- ☐ Diarios internos: truncate de las tablas history e import_errors
Triple confirmación (cuadro de diálogo + introducción ELIMINAR + botón). El árbol de categorías no se borra — gestionado por el módulo, recreado en la próxima apertura si lo has eliminado manualmente.
⭐ 12 razones para elegir el Módulo Training-Distribution
- 🚀 Instalación 3 minutos: URL CSV + iniciar la importación
- 🎨 Color + Talla añadidos al título con truncado 128 chars UTF-8 safe — solución limpia frente a refs CSV incoherentes
- 🇫🇷 Mono-idioma francés nativo — descripciones FR redactadas humanamente por Training-Distribution
- 🔤 Conversión ISO-8859-1 → UTF-8 automática (caracteres franceses preservados)
- 📝 Auto-generación SDE sistemática (CSV sin descripción del proveedor)
- 🌳 10 categorías deporte listas en la instalación + 42 sub-categorías alineadas con el CSV
- 📸 Multi-imágenes N URLs desde celda única + fix BO PS9 incluido
- 💰 4 modos de precio (RRP / Tramos / Markup fijo / Wholesale) — adaptados a las brechas de precio proteínas/discos bumper
- ⚡ Importación tiempo real producto-por-producto: barra en vivo, diario consola, botón Detener
- ♻️ Modo ligero automático en re-importación: actualización precios+stock solo
- ⏰ CRON 24/7 con time-budget, auto-relanzamiento asíncrono, retry, lock
- 💎 Ningún AdminController, ninguna Tab BO, ningún override: no contamina tu menú, no rompe tus otros módulos
🎬 Cómo funciona en 4 pasos
1
Instala el módulo
Descarga el ZIP, instala vía el BO. Auto-creación de 5 tablas, del proveedor Training-Distribution, de la clave CRON, y del árbol deporte (10 cats × 42 sub-cats).
2
Introduce la URL CSV
Ve a Parámetros, pega la URL proporcionada por Training-Distribution. Configura la categoría raíz bajo la cual se crea el árbol (Home por defecto).
3
Configura tus márgenes
Modo RRP por defecto. También puedes elegir Tramos (5 tramos) / Markup fijo / Wholesale. Plantillas SEO personalizables con {name}/{brand}.
4
Inicia la importación
Haz clic en "Iniciar importación". Modo test 20 productos primero para validar, luego importación completa 2 300 productos (~2h). Ves cada producto creado con su Color + Talla en el título ante tus ojos.
🔧 Compatibilidad técnica
| PrestaShop | 1.7.x → 9.x (probado en PS 9.0) |
| PHP | 7.4 mínimo, recomendado 8.1+ |
| MySQL / MariaDB | 5.7+ / 10.3+ |
| cURL | Activado (descarga CSV + imágenes) |
| Multi-shop | Compatible (fuerza CONTEXT_ALL para la eliminación) |
| Hooks utilizados | Ninguno (sin contaminación de la cadena de eventos) |
| Override de clase | Ninguno (preserva tus otros módulos) |
| AdminController | Ninguno |
| Pestaña sidebar BO | Ninguna (no contamina tu menú) |
| Cuenta Training-Distribution B2B | Cuenta requerida para la facturación y el acceso al CSV |
| URL CSV | A solicitar a tu comercial Training-Distribution |
❓ Preguntas frecuentes
P: ¿El Módulo Training-Distribution funciona en PrestaShop 9?
R: Sí, totalmente compatible PS 9.x. El módulo gestiona la migración específica PS9 donde meta_keywords ha sido retirado (cambio auto a ps_tag) así como el bug PS9 donde la imagen original no aparece en la página de edición de producto BO (fix por copia 1:1 del archivo <id>.jpg).
P: ¿Por qué 1 línea CSV = 1 producto (sin agrupación talla/color)?
R: Porque el CSV training-distribution no expone una referencia padre común entre las tallas de un mismo producto. Cada talla tiene una ref totalmente diferente (ej. `R_N_GEN_0535_XS`, `_S`, `_M`, `_L`, `_XL` — todas distintas), e incluso el truncado no funciona (línea L tiene `R-N_GEN_0535_L` con guión). Así que imposible agrupar. Solución: 1 línea = 1 producto, talla añadida al título.
P: Los títulos «— Color · Talla XL» pueden ser largos. ¿Cómo se gestiona?
R: El módulo trunca automáticamente el título original (con «…») si es necesario para mantenerse bajo el límite PS de 128 caracteres, manteniendo siempre el color + talla intactos. UTF-8 safe (nunca cortado en medio de un carácter multi-byte).
P: ¿Cómo se crea la jerarquía de categorías?
R: En la instalación, el módulo crea 10 categorías principales deporte + 42 sub-categorías bajo tu raíz PS (Home por defecto). En cada importación, la «Catégorie» CSV se mapea hacia la sub-categoría correcta vía una tabla interna. Si no coincide, cae en «Otro > Varios / Por clasificar» (nunca error). Pestaña Mapeos para fusionar o renombrar después de la importación.
P: El CSV está en ISO-8859-1 — ¿cómo lo gestiona el módulo?
R: El módulo convierte cada celda de ISO-8859-1 a UTF-8 vía mb_convert_encoding() (con auto-detección si la celda ya es UTF-8). Los caracteres franceses como «Genouillères», «Brassières», «Mapalé» se preservan. El símbolo «¤» al final de los precios (= € mal codificado Win-1252) se elimina automáticamente. Decimales coma convertidas a punto.
P: ¿Por qué mi descripción es auto-generada?
R: El proveedor Training-Distribution no proporciona ninguna columna de descripción en el CSV. Para no tener nunca una ficha de producto fantasma en el front (y dañina al SEO), el módulo genera un texto HTML estructurado a partir del nombre + marca + categoría + referencia. Puedes personalizar manualmente las fichas que te interesen — el modo ligero ya no las sobrescribirá.
P: ¿Puedo importar varias veces el mismo CSV?
R: Sí. Modo ligero automático: los productos existentes se detectan vía su Referencia CSV (= sku único por línea) y solo su precio + stock se refrescan. Tus descripciones, imágenes, categorías y tags no se reescriben — mantienes tus personalizaciones.
P: ¿Cómo eliminar todos los productos Training-Distribution?
R: Pestaña Importación → Eliminación selectiva → marcar «Productos importados» + «Marcas huérfanas» + «Proveedor Training-Distribution» + «Diarios» → ELIMINAR. Triple confirmación para evitar errores.
P: ¿Y si quiero detener una importación en curso?
R: Botón «Detener» disponible durante la importación (UI) y durante el CRON (flag file). Stop limpio al final del producto en curso, guardado del estado para reanudación en la línea exacta de parada.
P: ¿El módulo es compatible multi-shop?
R: Sí. Las categorías y productos se crean en todos los shops activos. La eliminación fuerza CONTEXT_ALL para evitar el quirk PS9 donde Product->delete() devuelve false en multi-shop.
P: ¿Ningún AdminController, ninguna Tab BO?
R: Confirmado. El módulo utiliza únicamente getContent() + AJAX. Sin contaminación del menú BO PrestaShop. Ningún override de clase core.
💪 ¿Listo para automatizar tu dropshipping deporte?
El Módulo Training-Distribution dropshipping deporte cross-training fitness es la herramienta más completa para vender las 2 300 referencias Training-Distribution (cross-training, fitness, musculación, nutrición deportiva) en PrestaShop. Una sola vez configurado, importa automáticamente el catálogo con color + talla en título, sus N fotos por producto, su jerarquía deporte lista para usar.
⚡ INSTALACIÓN 3 MIN · 📚 IMPORTACIÓN TIEMPO REAL · 🛡️ COMPATIBLE PS 1.7 → 9 · 🇫🇷 SOPORTE FRANCÉS
📋 Detalles técnicos para desarrolladores
Tablas BDD creadas (5): wp_trainingdist_history, wp_trainingdist_import_errors, wp_trainingdist_product_meta (sku único = Referencia CSV), wp_trainingdist_combination_meta (sku único), wp_trainingdist_category_mapping (csv_path único)
Configuraciones PS: WPTD_SETTINGS (JSON), WPTD_SUPPLIER_ID, WPTD_CRON_KEY, WPTD_LAST_IMPORT_AT, WPTD_LAST_IMPORT_COUNT, WPTD_LAST_UPLOADED_CSV, WPTD_CRON_LAST_*
CSV Training-Distribution (10 columnas ISO-8859-1, separador coma): Marque, Catégorie, Nom, Taille, Couleur, URL Images, Stock, Poids, Référence, Prix de vente (con ¤ stripped)
Arquitectura: 5 clases PHP limpias (TdCompat, TdCategoryTaxonomy, TdCategoryMapper, TdFeatureMapper [código muerto por diseño — sin Features en este CSV], TdCsvImporter) + módulo principal + router AJAX + CRON. Ningún override de clase core PrestaShop.
Aliases motor compartido: sku → Référence, name_fr → Nom, brand → Marque, category → Catégorie, price → Prix de vente, weight → Poids (en kg nativos, no gramos), qty → Stock, size → Taille, color → Couleur, image-url-1 → URL Images (celda única separada).
appendVariantToName(): helper que añade «— Color · Talla XX» al nombre producto con truncado 128 chars UTF-8 safe (mb_substr). Si el título concatenado supera, el título original se trunca con «…» para mantener color+talla intactos.
importMultiImages(): separa la celda URL Images por coma, valida cada URL (preg_match `^https?://`), 1ª URL = cover. Descarga con retry × 3 backoff, validación getimagesize JPEG/PNG/GIF/WebP, generación auto de todos los tamaños PS vía ImageManager::resize, fix BO PS9 por copia 1:1 del archivo original <id>.jpg.
ensureSupplierExists(): INSERT SQL directo (no new Supplier() + ->add() que falla silenciosamente en PS9). Detección dinámica de la columna meta_keywords en ps_supplier_lang (presente PS7, retirada PS9). Multi-shop vía ps_supplier_shop. Red de seguridad: también llamada antes de cada importación (no solo en la instalación).
Caché estático Db::getValue(): las 4 consultas de existencia en processRow() utilizan useCache=false para bypassear la caché estática PS que persiste entre workers PHP-FPM (si no las re-importaciones no encuentran los productos ya importados y crean duplicados).
Seguridad: pSQL() en todas partes, carpeta uploads/ protegida, validación formato imágenes, CSRF nativo PS en AJAX, escapes HTML sistemáticos, hash_equals() en clave CRON.
Compatibilidad PS9 específica: migración auto meta_keywords → ps_tag/ps_product_tag vía Tag::addTags(), gestión del quirk Product::delete() que devuelve false en multi-shop, fix BO PS9 imagen original.
Codificación: conversión ISO-8859-1 → UTF-8 celda por celda vía mb_convert_encoding() con detección previa si ya es UTF-8 válido. Stripping del símbolo ¤ + espacios no separables en los precios. Conversión coma decimal → punto.
📦 Módulo desarrollado por WebPoint · webpoint.fr · Actualizaciones regulares · Código limpio & comentado
