DataFirefly Größentabelle — Dokumentation

Überblick

DataFirefly Größentabelle ergänzt Ihren PrestaShop-Shop um ein vollständiges Größentabellen-System mit nach Kategorie, Hersteller oder Produkt zuweisbaren Tabellen, EU/US/UK/FR/JP-Umrechnungstabellen, einem interaktiven Rechner zur Größenempfehlung, einer indexierbaren SEO-Landingpage je Kategorie und einem Nachkauf-Feedback-Widget mit aggregiertem Bias-Score.

Das Modul richtet sich an Textil- und Schuh-Shops, in denen mehr als 20% der Retouren auf Größenprobleme zurückzuführen sind. Es verwandelt diese Reibung in ein vertrauensbildendes Kauferlebnis: Der Kunde sieht automatisch die richtige Tabelle, kann seine Maße eingeben und erhält eine personalisierte Empfehlung, und Sie sammeln qualifiziertes Feedback, um schlecht abgestufte Produkte zu erkennen.

Kompatibilität

• PrestaShop 8.0.x, 8.1.x, 8.2.x, 9.0.x
• PHP 8.1, 8.2, 8.3
• Multi-Shop (alle Zuweisungen sind nach id_shop gescoped)
• Polylang FR/EN/ES/DE einsatzbereit
• Themes classic, hummingbird und Custom-Themes (7 verschiedene Positionen verfügbar)

Installation

1. Laden Sie die ZIP-Datei dfsizeguide.zip unter Module → Module Manager → Modul hochladen hoch.
2. Klicken Sie auf Installieren. Die 4 vorinstallierten Tabellen (Damen-Textil, Herren-Textil, Damen-Schuhe, Herren-Schuhe) werden automatisch in 4 Sprachen erstellt, und eine Standardzuweisung wird auf der Damen-Textil-Tabelle angelegt.
3. Direkt nach der Installation erscheint der Tab „Größentabelle“ auf allen Ihren Produktseiten, ohne zusätzliche Konfiguration.
4. Gehen Sie zu Module → DataFirefly Größentabelle → Konfigurieren, um Positionen, Standardeinheit und aktivierte Funktionen anzupassen.

Kernkonzepte

Der 4-stufige Tabellen-Resolver

Wenn ein Kunde auf einer Produktseite landet, sucht das Modul in strikter Priorität, welche Tabelle anzuzeigen ist:

1. Produkt — Wenn Sie diesem konkreten Produkt explizit eine Tabelle zugewiesen haben, gewinnt sie.
2. Hersteller — Sonst die Tabelle, die der Marke des Produkts zugewiesen ist.
3. Kategorie — Sonst die erste Kategorie des Produkts, die eine Tabelle hat, beginnend mit der tiefsten (Spezifität gewinnt).
4. Standard — Sonst die als globaler Fallback markierte Tabelle.

Diese Hierarchie ermöglicht es, eine einzige Tabelle pro Marke oder Abteilung zu pflegen, ohne die einzelnen Produktseiten anzufassen, mit der Möglichkeit gezielter Overrides.

Spaltentypen

Jede Tabelle besteht aus typisierten Spalten:

• Spalte „Größe“ — Ein einziger Textwert pro Zeile (S, M, 38, XL). Für internationale Entsprechungen (EU, US, UK, FR, JP).
• Spalte „Maß“ — Ein numerischer Min/Max-Bereich pro Zeile (z. B. Brustumfang 88–92 cm). Zur Angabe der Körpermaße, die jeder Größe entsprechen.

Der interaktive Rechner stützt sich ausschließlich auf „Maß“-Spalten, um die empfohlene Größe zu bestimmen.

Konfiguration

Positionen auf der Produktseite

Das Modul stellt 7 individuell aktivierbare Positionen in Konfigurieren → Positionen Produktseite bereit:

• Produkt-Tab (standardmäßig aktiviert, empfohlen) — Hook displayProductExtraContent, fügt einen sauberen Tab neben „Beschreibung“ und „Details“ ein. Funktioniert bei nahezu allen PS 1.7+ Themes.
• Unter dem Preis — Hook displayProductPriceBlock (Typ after_price), rendert einen kompakten Link direkt unter dem Preis.
• Neben dem Warenkorb-Button — Hook displayProductActions, rendert einen kompakten Button.
• Unter den Produktinformationen — Hook displayProductAdditionalInfo, rendert einen prominenten Button.
• Im Vertrauensblock — Hook displayReassurance, integriert sich visuell mit Ihren anderen Verkaufsargumenten (Versand, Retouren).
• Nach den Produktbildern — Hook displayAfterProductThumbs, rendert einen kompakten Button direkt unter der Galerie.
• Am Fuß der Produktseite — Hook displayFooterProduct, rendert einen prominenten Button am Seitenende.

Sie können mehrere Positionen parallel aktivieren: Das Modal des Guides wird nur einmal im DOM instanziiert (Anti-Duplizierung), und die zusätzlichen Buttons öffnen das gleiche Modal.

Der Produkt-Tab ist die einzige Position, die die Tabelle inline rendert. Die anderen 6 Positionen rendern einen Button, der das Modal öffnet.

Allgemeine Einstellungen

• Standardeinheit — cm oder Zoll. Der Kunde kann jederzeit umschalten, die Präferenz wird bei der Berechnung berücksichtigt.
• Interaktiver Rechner — Aktiviert die Maßeingabe und Größenempfehlung (standardmäßig aktiviert).
• Nachkauf-Kundenfeedback — Aktiviert das Widget, das den Kunden fragt, ob die Größe gepasst hat (standardmäßig aktiviert).
• JSON-LD strukturierte Daten — Aktiviert die Einfügung des Schema.org-Markups für besseres SEO (standardmäßig aktiviert).
• SEO-Seiten-Slug — URL-Präfix der dedizierten SEO-Seiten (standardmäßig size-guide).

Tabelle erstellen und bearbeiten

Menü Module → Größentabellen → Tabellen. Klicken Sie auf „Hinzufügen“, um eine neue Tabelle zu erstellen, oder auf das Stift-Symbol, um eine bestehende zu bearbeiten.

Tabellenfelder

• Interner Code — Eindeutiger technischer Identifier (z. B. damen-kleider-2026). Wird in SEO-URLs und Logs verwendet.
• Typ — Textil-Oberteil, Textil-Unterteil, Kleid, Schuhe oder Custom.
• Name — Mehrsprachige Bezeichnung, die den Kunden angezeigt wird (Tab-Titel, Modal-Titel, h1 der SEO-Seite).
• Einführung (HTML) — Mehrsprachiger Inhalt, der über der Tabelle angezeigt wird.
• Messanleitung (HTML) — Zuklappbarer Abschnitt, der erklärt, wie jedes Maß genommen wird.
• Fuß (HTML) — Mehrsprachiger Inhalt unter der Tabelle (Hinweise, Link zur Rückgaberichtlinie usw.).
• Meta-Title / Meta-Description — Für die dedizierte SEO-Seite.
• Aktiv — Ein/Aus-Schalter. Eine inaktive Tabelle wird nie ausgeliefert, auch wenn sie zugewiesen ist.

Tabelle bearbeiten

Unter dem Tabellenformular ermöglicht ein visueller Editor den Tabellenaufbau:

1. Klicken Sie auf Größenspalte, um eine Textspalte hinzuzufügen. Tragen Sie den Code (z. B. eu, intl) und die mehrsprachige Bezeichnung ein.
2. Klicken Sie auf Maßspalte, um eine numerische Spalte hinzuzufügen. Tragen Sie den Code (z. B. chest_cm) und die Einheit (cm, inch, mm) ein.
3. Klicken Sie auf Zeile, um eine Zeile hinzuzufügen. Füllen Sie die Zellen: Klartext für „Größe“-Spalten, Min/Max-Werte für „Maß“-Spalten.
4. Klicken Sie auf Speichern. Die Speicherung erfolgt in einer atomaren SQL-Transaktion — entweder alles wird gespeichert, oder nichts.

Tabelle zuweisen

Menü Module → Größentabellen → Zuweisungen.

1. Wählen Sie die zuzuweisende Tabelle aus der Liste.
2. Wählen Sie den Zieltyp: Standard (globaler Fallback), Kategorie, Hersteller oder Produkt.
3. Je nach Typ erscheint ein zweites Feld zur Auswahl der Kategorie (im eingerückten Baum), der Marke (Dropdown) oder der Produkt-ID (Direkteingabe).
4. Klicken Sie auf Hinzufügen / Aktualisieren. Existiert bereits eine Zuweisung für dieses Ziel, wird sie überschrieben (upsert).

Alle Zuweisungen sind im Multi-Shop-Modus nach Shop gescoped. Sie können also Tabelle A für die Kategorie „Schuhe“ im französischen Shop und Tabelle B für die gleiche Kategorie im deutschen Shop anzeigen.

Der Größenrechner

Der Rechner erscheint unter der Tabelle, nur wenn die Tabelle mindestens eine „Maß“-Spalte enthält.

Bewertungsalgorithmus

Der Kunde gibt seine Maße in die Felder ein (ein Feld pro „Maß“-Spalte). Beim Absenden:

1. Die Werte werden auf Zentimeter normalisiert (automatische Umrechnung, wenn Zoll gewählt wurde: ×2,54).
2. Für jede Zeile berechnet das Modul einen Score: +2 Punkte, wenn das Maß exakt in den Min/Max-Bereich der Zelle fällt, +1 Punkt, wenn es nahe (innerhalb ±5% des Bereichs) liegt, sonst 0 Punkte.
3. Die Zeile mit dem höchsten Score gewinnt.
4. Gleichstände werden durch Auswahl der Zeile aufgelöst, deren Bereiche am nächsten an den Werten des Kunden zentriert sind.
5. Die empfohlene Größe wird prioritär aus der Spalte eu, dann fr, intl, uk, us, jp entnommen.

Benutzer-Rückmeldung

Der Rechner zeigt die empfohlene Größe mit einem Vertrauens-Score in Prozent, die Top-3-Kandidaten je mit ihrem Score, die Hervorhebung der empfohlenen Zeile in der Tabelle darüber, und die Liste der Maße, die zu keiner Zeile passen (mit Warnung).

Nachkauf-Kundenfeedback

Ein Widget „Hat die Größe gepasst?“ erscheint am Fuß der Produktseite mit 5 Optionen: zu klein, etwas zu klein, perfekt, etwas zu groß, zu groß. Es wird nur gerendert, wenn:

• Der Kunde angemeldet ist (aktive Session).
• Der Kunde dieses Produkt tatsächlich gekauft hat (Join mit orders und order_detail, gültiger Status).
• Der Kunde noch keine Bewertung zu diesem Produkt abgegeben hat.

Das Gating erfolgt vollständig serverseitig, ohne Umgehungsrisiko.

Feedback-Dashboard

Menü Module → Größentabellen → Kundenfeedback. Eine Übersicht über der Tabelle zeigt die Antwortzahl pro Kategorie über die 5 Stufen. Darunter die vollständige Liste des Feedbacks pro Produkt mit Kunden-ID, gekaufter Größe und Datum.

Bias-Score

Für jedes Produkt mit mindestens 3 Feedbacks wird ein Bias-Score berechnet:

Score = ((too_large × 2 + slightly_large) − (too_small × 2 + slightly_small)) / total

Ein positiver Score bedeutet, dass das Produkt systematisch groß ausfällt (eine Stufe kleiner gradieren). Ein negativer Score bedeutet, dass es klein ausfällt (eine Stufe größer gradieren). Ein Score nahe Null zeigt eine gute Abstufung an.

Dedizierte SEO-Seite

Das Modul stellt eine öffentliche Route pro Kategorie bereit: /{slug}/{category-link-rewrite}, wobei {slug} das konfigurierte Präfix ist (standardmäßig size-guide).

Beispiel: https://ihrshop.com/size-guide/damen-kleider

Die Seite enthält einen Breadcrumb, den h1-Titel der Tabelle, die Einführung, die Messanleitung und die vollständige Tabelle, den Rechner (falls aktiviert), den HTML-Fuß der Tabelle und ein Schema.org-JSON-LD-WebPage-Markup, das Google hilft zu verstehen, dass die Seite ein praktischer Leitfaden ist.

Meta-Title und Meta-Description stammen aus den SEO-Feldern der Tabelle. Konfigurieren Sie sie sorgfältig, um Long-Tail-Suchen wie „Damen Kleider Größentabelle“ abzufangen.

Mehrsprachig und Multi-Shop

Das Modul ist mehrsprachig auf Tabellenebene (Name, Intro, Anweisungen, Fuß, Meta), auf Spalten-Label-Ebene und auf Polylang-Label-Ebene für URLs.

Im Multi-Shop-Modus ist jede Zuweisung (Guide → Ziel) nach id_shop gescoped. Sie können somit Tabelle A für die Kategorie „Schuhe“ im französischen Shop und Tabelle B für die gleiche Kategorie im deutschen Shop anzeigen.

Technische Struktur

Datenbank

7 Tabellen mit Präfix dfsg_: dfsg_guide, dfsg_guide_lang, dfsg_column, dfsg_column_lang, dfsg_row, dfsg_cell, dfsg_assignment, dfsg_feedback. Alle Tabellen werden bei der Deinstallation sauber entfernt.

Verwendete Hooks

• actionFrontControllerSetMedia — Front CSS/JS-Einfügung
• displayBackOfficeHeader — Backend CSS/JS-Einfügung
• displayProductExtraContent — Produkt-Tab (empfohlen)
• displayProductPriceBlock, displayProductActions, displayProductAdditionalInfo, displayReassurance, displayAfterProductThumbs, displayFooterProduct — Alternative Positionen
• displayHeader — JSON-LD-Einfügung auf Produktseiten
• actionValidateOrder — Trigger für zukünftige Erinnerungen (v2)
• moduleRoutes — Dedizierte SEO-Seite

FAQ

Der Guide erscheint nicht auf meiner Produktseite, was tun?

Prüfen Sie zunächst in Konfigurieren → Positionen Produktseite, dass mindestens eine Position aktiviert ist (standardmäßig Produkt-Tab). Wenn Ihr Custom-Theme die nativen PrestaShop-Hooks nicht rendert, aktivieren Sie mehrere Positionen parallel: Mindestens eine der 7 sollte funktionieren. Prüfen Sie ebenfalls, dass mindestens eine aktive Tabelle und eine Standardzuweisung in Größentabellen → Zuweisungen existieren.

Kann ich Tabellen aus CSV importieren?

Nicht in Version 1.0. Der visuelle Editor erlaubt es, Tabellen im laufenden Betrieb aufzubauen. Der CSV-Import ist für Version 1.1 geplant.

Funktioniert der Rechner ohne JavaScript?

Nein, der Rechner ist interaktiv und benötigt JavaScript für den AJAX-Aufruf an den Server. Die statische Tabelle wird jedoch problemlos ohne JS angezeigt, was Barrierefreiheit und SEO gewährleistet.

Besteht Duplikationsgefahr beim JSON-LD-Markup?

Nein. Der Hook displayHeader gibt ein einziges JSON-LD-Skript pro Produktseite aus, und die dedizierte SEO-Seite hat ihr eigenes distinktes WebPage-Markup. Der Schema.org-Validator von Google meldet keine Duplikate.

Kompatibel mit der Migration PrestaShop 8 auf 9?

Ja. Das Modul deklariert ps_versions_compliancy von 8.0.0 bis 9.99.99, nutzt die in PS 9 weiterhin unterstützten ObjectModel- und HelperForm-Klassen und verwendet keine veraltete API.

Wie werden alle Moduldaten gelöscht?

Die Deinstallation über den Module Manager entfernt alle dfsg_*-Tabellen und alle DFSG_*-Konfigurationen. Es bleiben keine Rückstände in der Datenbank.

Support

E-Mail: support@datafirefly.com. Antwort innerhalb von 5 Werktagen auf Französisch oder Englisch.