Produkt-Personalisierung (Gravur, Text, Bild) — Komplettanleitung

Überblick

Das Modul Produkt-Personalisierung ermöglicht Ihren Kunden, einen Artikel direkt auf der Produktseite zu personalisieren: Eingabe von Text / einer Gravur (mit Schrift und Farbe) oder Upload eines Bildes. Die Personalisierung erscheint als Live-Vorschau auf dem Produktfoto — Positionierung per Drag-and-drop, anpassbare Größe und Drehung — und jede Option kann einen Aufpreis (Festbetrag oder Prozentsatz) hinzufügen, der automatisch im Warenkorb angewendet wird.

Das Modul ist mit PrestaShop 8.x und 9.x kompatibel. Es erstellt eigene Tabellen und überschreibt keine bestehenden Produktseiten: Die Personalisierung wird durch Optionen gesteuert, die Sie anlegen, nach Kategorie zugeordnet und produktweise verfeinerbar.

Installation

1. Zippen Sie den Ordner dfcustomizer (oder verwenden Sie direkt das mitgelieferte Archiv dfcustomizer.zip).
2. Öffnen Sie im Backoffice Module > Modul-Manager.
3. Klicken Sie auf Modul hochladen und legen Sie das ZIP-Archiv ab.
4. Klicken Sie nach der Installation auf Konfigurieren, um Ihre Optionen anzulegen.

Bei der Installation erstellt das Modul die erforderlichen Tabellen (dfc_option und die zugehörigen Tabellen, dfc_product_override, dfc_customization) und registriert die Anzeige-Hooks auf der Produktseite, im Warenkorb und in der Bestellung.

Konfiguration: eine Option anlegen

Gehen Sie zu Module > dfcustomizer > Konfigurieren, um Ihre Personalisierungsoptionen anzulegen und zu verwalten. Jede Option definiert einen Personalisierungstyp, seine Preisauswirkung und seinen Geltungsbereich.

Personalisierungstyp

• Text / Gravur: Der Kunde gibt einen Text ein. Sie können eine Auswahl an Schrift und Farbe anbieten (beide optional).
• Bild-Upload: Der Kunde lädt eine Datei im Format JPG, PNG oder WEBP hoch.

Preisauswirkung

Jede Option kann einen Aufpreis auf den Produktpreis hinzufügen:

• einen Festbetrag (netto), oder
• einen Prozentsatz des Produktpreises.

Der Aufpreis wird auf Kundenseite in Echtzeit angezeigt und in den Warenkorb übernommen (siehe Abschnitt Warenkorb & Preis).

Kategorie-Zuordnung

Haken Sie die Kategorien an, für die die Option gelten soll: Die Option erscheint nur bei Produkten dieser Kategorien. Ist keine Kategorie angehakt, gilt die Option für den gesamten Katalog.

Override pro Produkt

Auf der Produktseite (Tab Module) verfügt jedes Produkt über eine Override-Einstellung. Es kann:

• die durch Kategorien definierten Optionen erben (Standardverhalten);
• eigene Optionen wählen speziell für dieses Produkt;
• die Personalisierung für dieses Produkt vollständig deaktivieren.

Kundenseite (Frontoffice)

Auf der Produktseite gibt der Kunde seinen Text ein (Schrift, Farbe) oder lädt sein Bild hoch. Die Personalisierung erscheint sofort als Live-Vorschau auf dem Produktfoto:

• Positionierung per Drag-and-drop auf dem Bild;
• Schieberegler für Größe und Drehung zur Feinabstimmung des Ergebnisses.

Der Aufpreis der gewählten Optionen wird live angezeigt. Beim Hinzufügen zum Warenkorb werden die Personalisierung und eine zusammengeführte PNG-Vorschau gespeichert, um sie mit der Bestellung abzurufen.

Warenkorb & Preis

Der Aufpreis wird dem Artikelpreis im Warenkorb über eine warenkorbgebundene Preisregel (SpecificPrice an die id_cart gebunden) hinzugefügt. Er wird bei jedem Speichern des Warenkorbs neu berechnet und automatisch entfernt, wenn das Produkt aus dem Warenkorb genommen wird.

Bestellseite

Backoffice

Auf einer Bestellseite fasst ein Panel „Produkt-Personalisierungen“ jede Personalisierung zusammen: den eingegebenen Text, die herunterladbare Kundendatei und die generierte Vorschau. Sie haben alles, was Sie für die Produktion benötigen (Gravur, Druck usw.).

Frontoffice

Der Kunde findet eine Erinnerung an seine Personalisierungen in seiner Bestellansicht.

Technische Hinweise

• Erstellte Tabellen: dfc_option (+ dfc_option_lang und dfc_option_category), dfc_product_override, dfc_customization.
• Aufpreis: angewendet über SpecificPrice, an den Warenkorb gebunden (id_cart), bei jedem Speichern des Warenkorbs neu berechnet und entfernt, wenn das Produkt herausgenommen wird.
• Kundendateien: gespeichert in modules/dfcustomizer/uploads/, einem Ordner, in dem die PHP-Ausführung aus Sicherheitsgründen durch eine .htaccess-Datei blockiert ist.

Fehlerbehebung

Die Personalisierungsoption erscheint nicht auf der Produktseite

Prüfen Sie, ob die Option aktiv ist und ob ihre Kategorien die Kategorie des Produkts umfassen (oder ob keine Kategorie angehakt ist, um den gesamten Katalog anzusprechen). Prüfen Sie dann den Override pro Produkt (Tab Module der Seite): Die Personalisierung darf für dieses Produkt nicht deaktiviert sein. Leeren Sie zuletzt den PrestaShop-Cache.

Der Aufpreis erscheint nicht im Warenkorb

Der Aufpreis wird beim Speichern des Warenkorbs neu berechnet. Prüfen Sie, ob die Option eine Preisauswirkung hat (Festbetrag oder Prozentsatz), und laden Sie den Warenkorb neu. Wurde das Produkt entfernt und erneut hinzugefügt, muss die Personalisierung erneut vorgenommen werden.

Der Bild-Upload wird abgelehnt

Nur die Formate JPG, PNG und WEBP werden akzeptiert. Prüfen Sie das Dateiformat sowie die von Ihrem Hosting zugelassene maximale Upload-Größe (upload_max_filesize / post_max_size in PHP).

Deinstallation

Die Deinstallation entfernt die Hooks und die Konfiguration des Moduls. Sichern Sie vorab die Kundendateien in modules/dfcustomizer/uploads/ und die Personalisierungsdaten der Bestellungen, wenn Sie diese behalten möchten.

FAQ

Ist das Modul mit PrestaShop 9 kompatibel?

Ja, das Modul ist mit PrestaShop 8.x und 9.x kompatibel.

Kann ich die Personalisierung berechnen?

Ja. Jede Option kann einen Aufpreis anwenden, als Festbetrag (netto) oder Prozentsatz des Produktpreises, der automatisch dem Warenkorb hinzugefügt wird.

Kann ich eine Option auf bestimmte Produkte beschränken?

Ja, auf zwei Arten: über die Kategorie-Zuordnung der Option und über den Override pro Produkt, der jeder Seite erlaubt zu erben, eigene Optionen zu wählen oder die Personalisierung zu deaktivieren.

Kann der Kunde demselben Artikel mehrere Personalisierungen hinzufügen?

Pro Produkt-/Varianten-Paar und Warenkorb wird nur eine Personalisierung gespeichert.