# 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…

- Seite: <https://www.datafirefly.com/de/documentation/dfcustomizer/>
- Sprache: de
- Aktualisiert am: 2026-07-10
- Weitere Sprachen: [fr](https://www.datafirefly.com/documentation/dfcustomizer/index.md), [en](https://www.datafirefly.com/en/documentation/dfcustomizer/index.md), [es](https://www.datafirefly.com/es/documentation/dfcustomizer/index.md), [it](https://www.datafirefly.com/it/documentation/dfcustomizer/index.md), [pl](https://www.datafirefly.com/pl/documentation/dfcustomizer/index.md), [pt](https://www.datafirefly.com/pt/documentation/dfcustomizer/index.md), [nl](https://www.datafirefly.com/nl/documentation/dfcustomizer/index.md)
- Index: <https://www.datafirefly.com/de/documentation/llms.txt>

## Ü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.

**Hinweis:** Pro _Produkt-/Varianten_-Paar und Warenkorb ist nur eine Personalisierung möglich.

## 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.

**Einschränkung:** eine Personalisierung pro Produkt-/Varianten-Paar und Warenkorb.

## 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.