PrestaShop Dropshipping-Modul TRAINING-DISTRIBUTION
🌐 Quellkatalog verfügbar in: 
🇫🇷 100% französischer nativer Katalog. Keine automatische Übersetzung: Texte direkt vom Lieferanten in FR verfasst, ideal für Shops 🇫🇷 FR / 🇧🇪 BE / 🇨🇭 CH / 🇨🇦 CA.
💪 🏋️ 🔥
Training-Distribution Sport Dropshipping-Modul
Das Modul, das von A bis Z Ihr Cross-Training-, Fitness- und Sportnahrung-Dropshipping auf PrestaShop automatisiert
PrestaShop 1.7 → 9.x · 2 300 Produkte · 32 Marken · 10 Sport-Kategorien · CRON 24/7
Starten Sie ein Krafttraining-Equipment-Geschäft, eine Cross-Training-Website, einen Sportnahrung-E-Commerce oder einen Sportbekleidung-Shop? Sie arbeiten mit Training-Distribution (französischer Großhändler spezialisiert auf Cross Training und Fitness) und verbringen Ihre Tage damit, 2 300 Produktblätter abzutippen, mehrere Fotos pro Produkt manuell hochzuladen, jede Größe/Farbe als separates Produkt neu zu erstellen (weil sich die Lieferantenreferenzen zwischen den Größen ändern), jede Kategorie den richtigen Bereichen Ihrer Baumstruktur zuzuordnen?
Mit dem Training-Distribution Dropshipping-Modul Sport Cross-Training Fitness wird alles automatisch. Sie geben die Training-Distribution CSV-URL ein, klicken auf "Import starten", und das Modul erstellt Ihre 2 300 PrestaShop-Produkte auf Französisch mit Größe + Farbe im Titel, ihren N Fotos aus der einzelnen CSV-Zelle, ihrer nativen Referenz, in einem Baum von 10 sofort einsatzbereiten Sport-Kategorien (Damenbekleidung, Sportbekleidung, Schuhe, Socken, Hände & Griffe, Körperschutz, Seile & Lasten, Ernährung & Nahrungsergänzung, Sport-Zubehör, Sonstiges).
⚡ Vorher vs Nachher mit dem Training-Distribution-Modul
| Aufgabe |
❌ Ohne das Modul |
✅ Mit dem Modul |
| Import 2 300 Sport-Referenzen | 80h+ manuell, Kopie aus Training-Distribution-Portal | 1 Klick, ~2h im Hintergrund |
| Farbe + Größe im Titel | Manuelle Eingabe „Kniebandagen Schwarz Größe XL" am Ende des Titels | Auto-Append „— Farbe · Größe XX" + 128-Zeichen-Trunkierung |
| Multi-Bilder aus einzelner Zelle | Manuelles Parsen der durch Kommas verketteten URLs | Auto-Split + Validierung, 1. = Cover |
| Leere CSV-Beschreibung (keine geliefert) | Geisterblätter, schlechtes SEO, Absprungrate | Auto-Generierung strukturiertes HTML Name + Marke + Kat |
| Einzige CSV-Kategorie (1 Ebene) | Manuelle Erstellung eines kohärenten Sport-Baums | 10 Hauptkat + 42 Unter-Kat bei Installation erstellt |
| ISO-8859-1-Codierung (nicht UTF-8) | Defekte französische Zeichen („Mapalé", „Genouillères") | Automatische Konvertierung Zelle für Zelle |
| €-Symbol falsch codiert (¤ in ISO) | Preise mit „¤" oder Importfehlern | ¤ automatisch entfernt, saubere Preise |
| Originalbild BO PrestaShop 9 | Defektes Bild BO PS9 (offizieller Bug) | Fix BO PS9 enthalten: 1:1 Kopie der Originaldatei |
| Preise/Bestand aktualisieren | Jeden Tag alles von Grund auf neu machen | Automatischer Light-Modus: Update nur Preise+Bestand |
👤 An wen richtet sich dieses Modul?
🏋️
E-Commerce Cross Training & Fitness
Sie verkaufen Cross-Training-Equipment (Kniebandagen, Gürtel, Griffe, Springseile, Bumper-Plates, Riemen), Trainingsbekleidung, Gewichtheber-Schuhe. Training-Distribution ist FR-Referenz in diesen Nischen mit ROKFIT, REHBAND, PICSIL, VELITES als Flaggschiff-Marken.
💪
Krafttraining-Geschäft
Sie bieten Kraft- und Bodybuilding-Zubehör an: Hebegürtel, Handgelenkbandagen, Kniebandagen, Gewichtswesten, Gewichtheben. ~150 spezifisch Krafttraining-Referenzen im Katalog.
🥤
Sportnahrung-E-Commerce
Proteine, BCAA, Pre-Workout, Protein-Snacks (BAREBELLS, NOCCO), Energy-Drinks, Omega 3 und Sport-Nahrungsergänzungsmittel. ~150 Ernährungsreferenzen für ein vollständiges französischsprachiges Angebot.
🎯 Vollständige Funktionen des Training-Distribution-Moduls
🎨 Farbe + Größe an Titel angehängt — Training-Distribution-Innovation
Besonderheit der Training-Distribution-CSV. Im Gegensatz zu anderen Lieferanten ändert sich die „Referenz" für jede Größe (z. B. `R_N_GEN_0535_XS`, `_S`, `_M`, `_L`, `_XL` — alle unterschiedlich). Schlimmer noch: Konsistenz ist nicht einmal bei der Trunkierung garantiert (Zeile L hat `R-N_GEN_0535_L` mit Bindestrich anstelle von Unterstrich). Folge: unmöglich, mehrere Zeilen in 1 Produkt mit seinen PS-Combinations zu gruppieren.
Vom Modul angewandte Lösung: 1 CSV-Zeile = 1 distinktes PS-Produkt, und Farbe + Größe werden automatisch an den Produkttitel mit einem sauberen grafischen Format angehängt.
Beispiel:
"Paar Kniebandagen Schwarz 5 mm | REHBAND" + Farbe "Schwarz" + Größe "XL"
→ "Paar Kniebandagen Schwarz 5 mm | REHBAND — Schwarz · Größe XL"
- Automatische Trunkierung auf max 128 Zeichen (PS-Limit
Product::name): wenn der verkettete Titel überschreitet, wird der Originaltitel mit „…" trunkiert, um Platz für Farbe + Größe intakt zu lassen
- UTF-8 safe: die Trunkierung verwendet
mb_substr(), niemals in der Mitte eines Multi-Byte-Zeichens geschnitten
- Grafisches Format: em-dash (—) + middot (·) für gute visuelle Lesbarkeit
- Native Referenz pro Produkt: die „Referenz" der CSV wird als
Product::reference verwendet (natives PS-Feld)
🌳 Sport-Baum — 10 Hauptkategorien × 42 Unterkategorien
Die Training-Distribution-CSV exponiert nur EINE EINZIGE Kategorieebene pro Produkt („Catégorie"). Das Modul kompensiert dies, indem es bei der Installation einen Sport-Baum mit 10 sofort einsatzbereiten Hauptkategorien anbietet, mit 42 Unterkategorien, die identisch die durch die CSV exponierten Namen reproduzieren.
| Hauptkategorie | Gruppierte CSV-Unterkategorien |
|---|
| Damenbekleidung | Sport-BHs · T-Shirts - Crop Tops · Damen-Sport-Textil |
| Sportbekleidung | T-Shirts - Tank Tops · Sweatshirts - Hoodies · Shorts - Leggings · Shorts - Jogger · Badeanzug |
| Schuhe | Cross Training · Gewichtheben & Powerlifting |
| Socken | Training · Kindersport · Atmungsaktive & leichte Trainings-Knöchelsocken |
| Hände & Griffe | Griffe mit/ohne Magnesia · Cross Training Griffe · Tape & Schutz · Magnesia · Velcro-Patches |
| Körperschutz | Hebegürtel · Kniebandagen · Handgelenkbandagen · Gewichtsweste |
| Seile & Lasten | Springseile · Ersatzkabel · Bumper-Plates · Zugriemen |
| Ernährung & Nahrungsergänzung | Protein/BCAA/Pre Workout · Snacks · Energy-Drinks · Vitamine · Omega 3 · Sport-Ernährung |
| Sport-Zubehör | Stirnbänder · Kappen/Mützen · Brillen · Trinkflaschen · Sporttasche · Geschenkkarte |
| Sonstiges | Verschiedenes / Zu klassifizieren (Fallback: Startseite, leer, „Catalogue Sport…", unbekannt) |
- Mehrsprachige Erstellung bei Installation: 10 Hauptkat + 42 Unter-Kat idempotent unter Ihrer PS-Wurzelkategorie erstellt
- DB-Cache des Mappings: die aufgelöste CSV-Kat wird in
wp_trainingdist_category_mapping für nachfolgende Importe gespeichert
- Tab Kategorien-Mappings im BO: automatisch geladene Tabelle mit Auswahl der 42 Unter-Kat + Schaltfläche Re-mappen zum Zusammenführen oder Umbenennen nach Import
- Intelligenter Fallback: wenn die CSV-Kat leer ist, „Startseite", „Kategorie" oder „Catalogue Sport…", wird das Produkt nach Sonstiges > Verschiedenes / Zu klassifizieren geleitet
- Sicherheitsnetz: bei jedem Öffnen des BO-Moduls wird der Baum erneut überprüft. Eine manuell gelöschte Kat wird automatisch neu erstellt
📸 Multi-Bilder aus einzelner Zelle „URL Images"
Die Spalte „URL Images" der CSV enthält N durch Kommas getrennte URLs in einer Zelle in Anführungszeichen (z. B. „url1.jpg,url2.jpg,url3.jpg"). Das Modul splittet nach Komma, validiert jede URL (http(s)-Präfix) und importiert alle Bilder.
- 1. URL = Cover automatisch
- Format-Validierung via
getimagesize(): JPEG/PNG/GIF/WebP, beschädigte Dateien werden ohne Crash des Imports abgelehnt
- Auto-Generierung aller PS-Größen (small, medium, large, home_default…)
- Fix BO PrestaShop 9 enthalten: 1:1 Kopie der Originaldatei
<id>.jpg zusätzlich zu den Varianten
- Resilienter Download: Retry × 3 mit Backoff bei 503/Timeout, Fehlerprotokoll bei Totalausfall (Import läuft weiter)
📝 Auto-generierte Beschreibung (CSV ohne Lieferantenbeschreibung)
Training-Distribution liefert KEINE Beschreibungsspalte in der CSV. Das Modul generiert systematisch eine strukturierte HTML-Beschreibung aus Bezeichnung, Marke, Kategorie und Referenz — um nie ein Geister-Produktblatt im Frontend zu haben (Anti-Bounce + gutes SEO).
🔤 ISO-8859-1-Codierung + Komma-Trennzeichen
Die training-distribution-CSV ist in ISO-8859-1 mit Komma-Trennzeichen (im Gegensatz zu anderen Modulen, die UTF-8 + ";" verwenden). Das Modul handhabt dies:
- ISO-8859-1 → UTF-8 Konvertierung Zelle für Zelle via
mb_convert_encoding() mit Auto-Erkennung, wenn bereits in UTF-8
- Währungssymbol ¤ (= € falsch codiert Win-1252) automatisch am Ende der Preise entfernt
- Komma-Dezimalstellen in Punkte umgewandelt für Preis- und Gewichtsspalten
- Zelle URL Images in Anführungszeichen: interne Kommas durch standardmäßiges
fgetcsv erhalten, Splitting in importMultiImages() durchgeführt
⚡ Echtzeit-Import-Architektur
Das Szenario, das alles ändert:
- 📥 Vorbereitung: das Modul lädt die CSV von der Training-Distribution-URL herunter und cached die 2 300 Zeilen als JSON
- 🚀 Import "1 CSV-Zeile = 1 AJAX-Aufruf": kein 2-Stunden-Freeze, Sie sehen jedes Produkt einzeln erstellt
- 📊 Rote & goldene Fortschrittsbalken: Live-Prozentsatz + Zähler X/Y
- 📋 Live-Protokoll: farbiges Badge (Erstellt / Aktualisiert / Übersprungen / Fehler) + Referenz + Titel + PS-ID#
- ⏸️ Stopp-Schaltfläche jederzeit, Wiederaufnahme möglich
- 📈 Live-Statistiken: Bearbeitete Zeilen · Erstellt · Aktualisiert · Übersprungen · Fehler
→ Schluss mit der hängenden Seite. Schluss mit der Sorge. Sie sehen alles, was passiert.
💰 Konfigurierbare Margen & SEO
4 Preisberechnungsmodi
| Modus | Beschreibung |
|---|
| RRP ⭐ (Standard) | CSV-Verkaufspreis wie er ist — der einfachste Einstieg. |
| Stufen | % unterschiedlich je nach Nettopreis-Klasse (5 konfigurierbare Stufen: 0-15€/15-30€/30-60€/60-120€/120€+ — angepasst an Proteine zu 30€ wie Bumper-Plates zu 200€+). |
| Fester Markup | Ein einziger % angewendet (50% standardmäßig → Nettopreis × 1.5). |
| Wholesale | Netto-Einkaufspreis wie er ist (B2B-Verkauf an Fitnessstudios, Coaches usw.). |
Anpassbare SEO-Vorlagen
- Meta title / Meta description mit Variablen:
{name}, {brand}
- Französische PS-Tags automatisch generiert aus brand + category + Farbe (falls vorhanden)
- Light-Modus (Light Update): 2. Import = nur Preis+Bestand-Update, Ihre BO-Anpassungen bleiben erhalten
- Auto-Deaktivierung bei Lagerbestand 0 (Option) oder „für SEO sichtbar halten"
- Bild in Beschreibung: Einfügung des 1. Bildes in die lange Beschreibung (On-Page-SEO-Boost)
⏰ CRON 24/7 — 3 automatisierte Aktionen
| CRON-Aktion |
Rolle |
Empfohlene Häufigkeit |
full_import | Vollständiger Import (Erstellungen + Light Updates) | 1×/Tag |
light_sync | Update Preis + Bestand + Verfügbarkeit der bereits importierten Produkte (Light-Modus) | alle 2-4h |
cleanup_logs | Bereinigung Logs > N Tage (konfigurierbare Aufbewahrung) | 1×/Woche |
- 32-Zeichen-Hex-Geheimschlüssel bei Installation generiert — Ihre CRON-URLs können nicht erraten werden
- 1-Klick-Regenerierung des Schlüssels bei Leck
- Asynchrone Auto-Wiederaufnahme: Selbstaufruf im Hintergrund, wenn das Time-Budget erreicht ist (60s standardmäßig)
- Präzise Wiederaufnahme: setzt genau dort fort, wo es gestoppt wurde
- Anti-Konkurrenz-Lock via flock: keine parallelen Ausführungen
- CSV-Download-Retry 3× mit Backoff 2s/4s/6s
- Stopp-Schaltfläche auf BO-Seite zum sauberen Stoppen eines laufenden CRON
- Test-Modus mit konfigurierbarem Produktlimit (10-100 zur schnellen Validierung)
🏷️ Der Training-Distribution-Katalog in Zahlen
32
unterschiedliche Marken
Flaggschiff-Marken des Training-Distribution-Katalogs (Auszug nach Volumen):
ROKFIT
REHBAND
PICSIL
BAREBELLS
NOCCO
TYR
NORTHERN SPIRIT
VELITES
CELLUCOR C4
VERY BAD WOD
HEXXEE SOCKS
BARBELL REGIMENT
+ 20 weitere Marken
🛠️ Wartung — Selektive Löschung
- ☐ Importierte Produkte: 4-Quellen-Erkennung (meta, supplier, product_supplier, Kategorien-Mapping), PS9 multi-shop kompatibel mit SQL-Wipe-Fallback auf zugehörige Tabellen
- ☐ Verwaiste Attribute: dieses Modul erstellt KEIN PS-Attribut (Farbe+Größe an Titel angehängt, keine Combinations). Dieses Kästchen hat nur Auswirkung, wenn Sie manuell Attribute im BO erstellt haben
- ☐ Verwaiste Marken: löscht die Training-Distribution-Hersteller (ROKFIT, REHBAND, PICSIL, BAREBELLS, NOCCO, TYR, NORTHERN SPIRIT, VELITES, …), die keine Produkte mehr haben
- ☐ Lieferant Training-Distribution: löscht den Lieferanten nur, wenn keine Produkte mehr verknüpft sind
- ☐ Interne Protokolle: Truncate der Tabellen history und import_errors
Dreifache Bestätigung (Dialogbox + Eingabe LÖSCHEN + Schaltfläche). Der Kategorienbaum wird nicht gelöscht — vom Modul verwaltet, beim nächsten Öffnen neu erstellt, wenn Sie ihn manuell gelöscht haben.
⭐ 12 Gründe, sich für das Training-Distribution-Modul zu entscheiden
- 🚀 Installation 3 Minuten: CSV-URL + Import starten
- 🎨 Farbe + Größe an Titel angehängt mit 128-Zeichen-Trunkierung UTF-8 safe — saubere Lösung gegen inkonsistente CSV-Refs
- 🇫🇷 Native einsprachige französisch — FR-Beschreibungen menschlich von Training-Distribution verfasst
- 🔤 Automatische ISO-8859-1 → UTF-8 Konvertierung (französische Zeichen erhalten)
- 📝 Systematische SDE-Auto-Generierung (CSV ohne Lieferantenbeschreibung)
- 🌳 10 Sport-Kategorien bereit bei Installation + 42 mit der CSV ausgerichtete Unterkategorien
- 📸 Multi-Bilder N URLs aus einzelner Zelle + BO PS9 Fix enthalten
- 💰 4 Preismodi (RRP / Stufen / Fester Markup / Wholesale) — angepasst an Preisunterschiede Proteine/Bumper-Plates
- ⚡ Echtzeit-Import Produkt-für-Produkt: Live-Balken, Konsolenprotokoll, Stopp-Schaltfläche
- ♻️ Automatischer Light-Modus bei Re-Import: nur Preise+Bestand-Update
- ⏰ CRON 24/7 mit Time-Budget, asynchroner Auto-Wiederaufnahme, Retry, Lock
- 💎 Kein AdminController, keine BO-Tab, kein Override: verschmutzt nicht Ihr Menü, bricht nicht Ihre anderen Module
🎬 So funktioniert es in 4 Schritten
1
Modul installieren
ZIP herunterladen, über das BO installieren. Auto-Erstellung von 5 Tabellen, dem Lieferanten Training-Distribution, dem CRON-Schlüssel und dem Sport-Baum (10 Kat × 42 Unter-Kat).
2
CSV-URL eingeben
Gehen Sie zu Einstellungen, fügen Sie die von Training-Distribution bereitgestellte URL ein. Konfigurieren Sie die Wurzelkategorie, unter der der Baum erstellt wird (Startseite standardmäßig).
3
Margen konfigurieren
RRP-Modus standardmäßig. Sie können auch Stufen (5 Klassen) / Festen Markup / Wholesale wählen. Anpassbare SEO-Vorlagen mit {name}/{brand}.
4
Import starten
Klicken Sie auf "Import starten". Test-Modus 20 Produkte zuerst zur Validierung, dann vollständiger Import 2 300 Produkte (~2h). Sie sehen jedes Produkt mit seiner Farbe + Größe im Titel vor Ihren Augen erstellt.
🔧 Technische Kompatibilität
| PrestaShop | 1.7.x → 9.x (getestet auf PS 9.0) |
| PHP | 7.4 minimum, empfohlen 8.1+ |
| MySQL / MariaDB | 5.7+ / 10.3+ |
| cURL | Aktiviert (CSV- + Bilder-Download) |
| Multi-shop | Kompatibel (erzwingt CONTEXT_ALL für Löschung) |
| Verwendete Hooks | Keine (keine Verschmutzung der Ereigniskette) |
| Klassen-Override | Keine (bewahrt Ihre anderen Module) |
| AdminController | Keiner |
| Sidebar-Tab BO | Keine (verschmutzt nicht Ihr Menü) |
| Konto Training-Distribution B2B | Konto erforderlich für Abrechnung und CSV-Zugriff |
| CSV-URL | Bei Ihrem Training-Distribution-Vertrieb anzufordern |
❓ Häufig gestellte Fragen
F: Funktioniert das Training-Distribution-Modul auf PrestaShop 9?
A: Ja, vollständig PS 9.x kompatibel. Das Modul handhabt die spezifische PS9-Migration, bei der meta_keywords entfernt wurde (Auto-Umschaltung auf ps_tag) sowie den PS9-Bug, bei dem das Originalbild auf der BO-Produktbearbeitungsseite nicht erscheint (Fix durch 1:1-Kopie der Datei <id>.jpg).
F: Warum 1 CSV-Zeile = 1 Produkt (keine Größen-/Farbgruppierung)?
A: Weil die training-distribution-CSV keine gemeinsame Eltern-Referenz zwischen den Größen desselben Produkts exponiert. Jede Größe hat eine völlig andere Ref (z. B. `R_N_GEN_0535_XS`, `_S`, `_M`, `_L`, `_XL` — alle distinkt), und sogar die Trunkierung funktioniert nicht (Zeile L hat `R-N_GEN_0535_L` mit Bindestrich). Daher unmöglich zu gruppieren. Lösung: 1 Zeile = 1 Produkt, Größe an Titel angehängt.
F: Die Titel „— Farbe · Größe XL" könnten lang sein. Wie wird das gehandhabt?
A: Das Modul trunkiert automatisch den Originaltitel (mit „…"), falls erforderlich, um unter dem PS-Limit von 128 Zeichen zu bleiben, wobei Farbe + Größe immer intakt bleiben. UTF-8 safe (nie in der Mitte eines Multi-Byte-Zeichens geschnitten).
F: Wie wird die Kategoriehierarchie erstellt?
A: Bei Installation erstellt das Modul 10 Sport-Hauptkategorien + 42 Unterkategorien unter Ihrer PS-Wurzel (Startseite standardmäßig). Bei jedem Import wird die CSV-„Catégorie" über eine interne Tabelle der richtigen Unterkategorie zugeordnet. Wenn keine Übereinstimmung, fällt es in „Sonstiges > Verschiedenes / Zu klassifizieren" (nie ein Fehler). Mappings-Tab zum Zusammenführen oder Umbenennen nach Import.
F: Die CSV ist in ISO-8859-1 — wie handhabt das Modul das?
A: Das Modul konvertiert jede Zelle von ISO-8859-1 nach UTF-8 via mb_convert_encoding() (mit Auto-Erkennung, wenn die Zelle bereits UTF-8 ist). Französische Zeichen wie „Genouillères", „Brassières", „Mapalé" bleiben erhalten. Das „¤"-Symbol am Ende der Preise (= € falsch codiert Win-1252) wird automatisch entfernt. Komma-Dezimalstellen in Punkte umgewandelt.
F: Warum ist meine Beschreibung auto-generiert?
A: Der Lieferant Training-Distribution liefert keine Beschreibungsspalte in der CSV. Um nie ein Geister-Produktblatt im Frontend zu haben (und schädlich für SEO), generiert das Modul einen strukturierten HTML-Text aus Name + Marke + Kategorie + Referenz. Sie können die für Sie interessanten Blätter manuell anpassen — der Light-Modus überschreibt sie nicht mehr.
F: Kann ich dieselbe CSV mehrmals importieren?
A: Ja. Automatischer Light-Modus: bestehende Produkte werden über ihre CSV-Referenz erkannt (= eindeutige sku pro Zeile), und nur ihr Preis + Bestand werden aktualisiert. Ihre Beschreibungen, Bilder, Kategorien und Tags werden nicht überschrieben — Sie behalten Ihre Anpassungen.
F: Wie lösche ich alle Training-Distribution-Produkte?
A: Tab Import → Selektive Löschung → „Importierte Produkte" + „Verwaiste Marken" + „Lieferant Training-Distribution" + „Protokolle" ankreuzen → LÖSCHEN. Dreifache Bestätigung zur Vermeidung von Fehlern.
F: Und wenn ich einen laufenden Import stoppen möchte?
A: Schaltfläche „Stopp" verfügbar während des Imports (UI) und während des CRON (Flag-Datei). Sauberer Stopp am Ende des aktuellen Produkts, Statusspeicherung zur Wiederaufnahme an der genauen Stopp-Zeile.
F: Ist das Modul multi-shop kompatibel?
A: Ja. Kategorien und Produkte werden auf allen aktiven Shops erstellt. Die Löschung erzwingt CONTEXT_ALL, um den PS9-Quirk zu vermeiden, bei dem Product->delete() in multi-shop false zurückgibt.
F: Kein AdminController, keine BO-Tab?
A: Bestätigt. Das Modul verwendet nur getContent() + AJAX. Keine Verschmutzung des BO-PrestaShop-Menüs. Kein Override einer Core-Klasse.
💪 Bereit, Ihr Sport-Dropshipping zu automatisieren?
Das Training-Distribution Dropshipping-Modul Sport Cross-Training Fitness ist das umfassendste Tool zum Verkauf der 2 300 Training-Distribution-Referenzen (Cross-Training, Fitness, Krafttraining, Sportnahrung) auf PrestaShop. Einmal konfiguriert, importiert es automatisch den Katalog mit Farbe + Größe im Titel, seinen N Fotos pro Produkt, seiner sofort einsatzbereiten Sport-Hierarchie.
⚡ INSTALLATION 3 MIN · 📚 ECHTZEIT-IMPORT · 🛡️ KOMPATIBEL PS 1.7 → 9 · 🇫🇷 FRANZÖSISCHER SUPPORT
📋 Technische Details für Entwickler
DB-Tabellen erstellt (5): wp_trainingdist_history, wp_trainingdist_import_errors, wp_trainingdist_product_meta (sku eindeutig = CSV-Referenz), wp_trainingdist_combination_meta (sku eindeutig), wp_trainingdist_category_mapping (csv_path eindeutig)
PS-Konfigurationen: WPTD_SETTINGS (JSON), WPTD_SUPPLIER_ID, WPTD_CRON_KEY, WPTD_LAST_IMPORT_AT, WPTD_LAST_IMPORT_COUNT, WPTD_LAST_UPLOADED_CSV, WPTD_CRON_LAST_*
Training-Distribution-CSV (10 Spalten ISO-8859-1, Komma-Trennzeichen): Marque, Catégorie, Nom, Taille, Couleur, URL Images, Stock, Poids, Référence, Prix de vente (mit ¤ stripped)
Architektur: 5 saubere PHP-Klassen (TdCompat, TdCategoryTaxonomy, TdCategoryMapper, TdFeatureMapper [toter Code by Design — keine Features auf dieser CSV], TdCsvImporter) + Hauptmodul + AJAX-Router + CRON. Kein Override einer PrestaShop-Core-Klasse.
Aliases gemeinsame Engine: sku → Référence, name_fr → Nom, brand → Marque, category → Catégorie, price → Prix de vente, weight → Poids (in nativen kg, nicht Gramm), qty → Stock, size → Taille, color → Couleur, image-url-1 → URL Images (einzelne Zelle gesplittet).
appendVariantToName(): Helper, der „— Farbe · Größe XX" an den Produktnamen mit 128-Zeichen-Trunkierung UTF-8 safe (mb_substr) anhängt. Wenn der verkettete Titel überschreitet, wird der Originaltitel mit „…" trunkiert, um Farbe+Größe intakt zu halten.
importMultiImages(): splittet die URL-Images-Zelle nach Komma, validiert jede URL (preg_match `^https?://`), 1. URL = Cover. Download mit Retry × 3 Backoff, getimagesize JPEG/PNG/GIF/WebP-Validierung, Auto-Generierung aller PS-Größen via ImageManager::resize, BO PS9-Fix durch 1:1-Kopie der Originaldatei <id>.jpg.
ensureSupplierExists(): direktes SQL INSERT (nicht new Supplier() + ->add(), das in PS9 stillschweigend fehlschlägt). Dynamische Erkennung der Spalte meta_keywords in ps_supplier_lang (vorhanden PS7, entfernt PS9). Multi-shop via ps_supplier_shop. Sicherheitsnetz: auch vor jedem Import aufgerufen (nicht nur bei Installation).
Statischer Cache Db::getValue(): die 4 Existenzabfragen in processRow() verwenden useCache=false, um den statischen PS-Cache zu umgehen, der zwischen PHP-FPM-Workern persistiert (sonst finden Re-Importe die bereits importierten Produkte nicht und erstellen Duplikate).
Sicherheit: pSQL() überall, Ordner uploads/ geschützt, Bild-Format-Validierung, natives PS-CSRF auf AJAX, systematische HTML-Escapes, hash_equals() auf CRON-Schlüssel.
Spezifische PS9-Kompatibilität: Auto-Migration meta_keywords → ps_tag/ps_product_tag via Tag::addTags(), Handhabung des Product::delete()-Quirks, der in multi-shop false zurückgibt, BO PS9-Fix Originalbild.
Codierung: ISO-8859-1 → UTF-8 Zelle-für-Zelle-Konvertierung via mb_convert_encoding() mit vorheriger Erkennung, falls bereits gültiges UTF-8. Stripping des ¤-Symbols + geschützte Leerzeichen auf Preisen. Konvertierung Komma-Dezimal → Punkt.
📦 Modul entwickelt von WebPoint · webpoint.fr · Regelmäßige Updates · Sauberer & kommentierter Code
