Shoplex Modul-Referenz

Shoplex buendelt die E-Commerce-Vorgaben der Europaeischen Union in 20 voneinander unabhaengigen Modulen. Jedes Modul deckt eine konkrete Richtlinie, Verordnung oder nationale Gesetzespflicht ab. Sie koennen jedes Modul einzeln unter WooCommerce > Shoplex aktivieren oder deaktivieren.

Zehn Module sind standardmaessig aktiv. Zehn sind deaktiviert, weil ihr Einsatz von den angebotenen Produkten und den Ablaeufen des Shops abhaengt.

┌────────────────────────────────────────────────────────────────────────┐
│                        Shoplex Modul-Architektur                       │
├───────────────────────────────┬────────────────────────────────────────┤
│ Preisblock im Frontend        │ Kasse (Checkout) & Bestellungen        │
│ • unit_price (98/6/EG)        │ • legal_checkboxes (2011/83/EU, DSGVO) │
│ • omnibus (2019/2161)         │ • country_compliance (Button-Loesung)  │
│ • tax_display (98/6/EG)       │ • vies (2006/112/EG B2B-USt)           │
│ • shipping_notice (PAngV)     │ • withdrawal (14 Tage Widerrufsrecht)  │
│ • from_price (98/6/EG)        ├────────────────────────────────────────┤
├───────────────────────────────┤ Endpunkte & Rechtsformulare            │
│ Produktdetails & Sicherheit   │ • complaint_template (Reklamation)     │
│ • delivery_time (2011/83/EU)  │ • cra_readiness (RFC 9116 security.txt)│
│ • consumer_information (771)  │ • dsa_toolkit (Art. 16 DSA-Meldungen)  │
│ • gpsr (2023/988 Sicherheit)  │ • business_info & dispute_resolution   │
└───────────────────────────────┴────────────────────────────────────────┘

---

Moduluebersicht

Modul-ID	Modulname	Standard	Rechtsgrundlage	Einstellungsreiter
unit_price	Grundpreis	Aktiviert	Richtlinie 98/6/EG	Preise (shoplex_prices)
omnibus	Tiefstpreis 30 Tage	Aktiviert	Richtlinie (EU) 2019/2161	Tiefstpreis (shoplex_omnibus)
tax_display	MwSt.-Hinweis	Aktiviert	Richtlinie 98/6/EG, 2011/83/EU Art. 6	MwSt. (shoplex_taxes)
shipping_notice	Versandkostenhinweis	Aktiviert	Richtlinie 2011/83/EU Art. 6 Abs. 1 lit. e	Preise (shoplex_prices)
from_price	Ab-Preis bei Varianten	Deaktiviert	Richtlinie 98/6/EG	Preise (shoplex_prices)
delivery_time	Lieferzeit	Deaktiviert	Richtlinie 2011/83/EU Art. 6 Abs. 1 lit. g	Lieferzeit (shoplex_delivery)
consumer_information	Gewaehrleistung & Haltbarkeit	Aktiviert	Richtlinien (EU) 2019/771 & 2019/770	Gewaehrleistung (shoplex_consumer_info)
country_compliance	Laenderspezifische Regeln	Aktiviert	§ 312j BGB, Art. L. 221-14, RDL 7/2021	Laender-Compliance (shoplex_country_compliance)
withdrawal	14-taegiges Widerrufsrecht	Deaktiviert	Richtlinie 2011/83/EU Anhang I(B)	Kassen-Einwilligung (shoplex_checkout)
gpsr	Produktsicherheit (GPSR)	Deaktiviert	Verordnung (EU) 2023/988	Produktsicherheit (shoplex_gpsr)
legal_checkboxes	Kassen-Einwilligungen	Aktiviert	Richtlinie 2011/83/EU Art. 8, DSGVO Art. 7	Kassen-Einwilligung (shoplex_checkout)
business_info	Anbieterkennzeichnung	Aktiviert	Richtlinie 2000/31/EG Art. 5	Anbieter (shoplex_general)
dispute_resolution	Hinweis zur Streitbeilegung	Aktiviert	Richtlinie 2013/11/EU, geaendert durch Richtlinie (EU) 2025/2647	Anbieter (shoplex_general)
vies	EU-USt-IdNr.-Pruefung	Deaktiviert	Richtlinie 2006/112/EG Art. 138	VIES MwSt. (shoplex_vies)
complaint_template	Reklamationsformular	Deaktiviert	Richtlinie (EU) 2019/771	Integrierte Vorlagenseite
cra_readiness	Cyber Resilience Act	Deaktiviert	Verordnung (EU) 2024/2847 / RFC 9116	CRA security.txt (shoplex_cra)
dsa_toolkit	DSA-Meldeverfahren	Deaktiviert	Verordnung (EU) 2022/2065 Art. 16	Shortcode-Formular
deposit	Verpackungspfand (Pfand)	Deaktiviert	VerpackG § 31; EU-PPWR	Pfand (shoplex_deposit)
food_information	Lebensmittelinformationen und Naehrwerte	Deaktiviert	Verordnung (EU) 1169/2011	Lebensmittel (shoplex_food)
consent_manager	Cookie-Einwilligung und Content-Blocker	Aktiviert	DSGVO Art. 7; ePrivacy; TDDDG § 25	Einwilligung (shoplex_consent)

---

1. Grundpreis (unit_price)

Rechtsgrundlage

Richtlinie 98/6/EG ueber den Verbraucherschutz bei der Angabe der Preise der Letztverbrauchern angebotenen Erzeugnisse sowie deutsche PAngV. Beim Verkauf von Waren nach Gewicht, Volumen, Laenge oder Flaeche muessen Endpreis und Grundpreis (z. B. pro 1 kg oder 1 Liter) unmissverstaendlich angegeben werden.

Funktionsweise

Berechnet den Grundpreis und gibt ihn direkt neben dem Endpreis auf Produktseiten und in Produktuebersichten aus. Wenn an einem Produkt keine Mengenangaben gepflegt sind, erfolgt keine Ausgabe.

Konfigurationsoptionen (shoplex_prices)

• unit_price_enabled (bool, Standard: true): Aktiviert die Grundpreisberechnung.
• unit_price_text (string, Standard: "{price} / {unit}"): Ausgabevorlage. Ersetzt {price} durch den formatierten Grundpreis und {unit} durch die lokalisierte Einheit.
• unit_price_show_loop (bool, Standard: true): Steuert die Anzeige in Produktarchiven und Katalogen.

Produktbezogene Felder

Im Reiter Produktdaten > Shoplex:

• _shoplex_unit_price_product_amount (float): Netto-Inhalt (z. B. 500 fuer ein 500-g-Glas).
• _shoplex_unit_price_base (float, Standard: 1 oder 1000): Referenzmenge (z. B. 1000 fuer 1 kg oder 100 fuer 100 ml).
• _shoplex_unit_price_unit (string select): Masseinheit (kg, g, l, ml, m, cm, m2, m3, piece).

---

2. Tiefstpreis der letzten 30 Tage (omnibus)

Rechtsgrundlage

Richtlinie (EU) 2019/2161 (Omnibus-Richtlinie), Aenderung von Richtlinie 98/6/EG Art. 6a. Bei jeder Bekanntgabe einer Preisreklamation muss der niedrigste Preis angegeben werden, den der Haendler innerhalb von mindestens 30 Tagen vor der Preissenkung angewandt hat.

Funktionsweise

Ueberwacht Preisaktualisierungen aller Produkte und dokumentiert Preisereignisse in einer gesonderten Datenbanktabelle. Bei rabattierten Artikeln wird der historische Tiefstpreis ermittelt und als Hinweistext ausgegeben.

[!NOTE] Die Erfassung beginnt ab Aktivierung des Moduls. Preisaenderungen vor Installation des Plugins koennen nicht nachtraeglich rekonstruiert werden.

Datenbankspeicherung

Tabelle: {wp_prefix}shoplex_price_history

Konfigurationsoptionen (shoplex_omnibus)

• enabled (bool, Standard: true): Aktiviert Preiserfassung und Hinweisausgabe.
• days (int, Standard: 30): Pruefzeitraum (mindestens 30 Tage).
• display_text (string, Standard: "Niedrigster Preis der letzten {days} Tage: {price}"): Vorlagentext.
• display_on_sale_only (bool, Standard: true): Anzeige ausschliesslich bei aktiver Reduzierung.
• prune_after_days (int, Standard: 90): Automatische Bereinigung aelterer Datensaetze.
• price_count_from (string select: sale_start | today, Standard: sale_start):
  • sale_start: Zeitraum vor Start der Rabattaktion (verhindert Umgehung durch Stufenrabatte).
  • today: Fortlaufendes 30-Tage-Fenster.

---

3. MwSt.-Hinweis (tax_display)

Rechtsgrundlage

Richtlinie 98/6/EG, Richtlinie 2011/83/EU Art. 6 und § 19 UStG (Kleinunternehmerregelung). Verbraucherpreise muessen klarstellen, ob die gesetzliche Mehrwertsteuer enthalten ist.

Konfigurationsoptionen (shoplex_taxes & shoplex_prices)

• tax_display_mode (string select: gross | net, Standard: gross): Preisdarstellung brutto oder netto.
• vat_notice_text (string, Standard: "inkl. {rate}% MwSt."): Brutto-Hinweis mit dynamischem Steuersatz {rate}.
• vat_notice_net_text (string, Standard: "exkl. {rate}% MwSt."): Netto-Hinweis.
• vat_exempt_notice (string, Standard: "Umsatzsteuerfrei gemaess Kleinunternehmerregelung"): Ausgabe bei aktiviertem Kleinunternehmerstatus.

---

4. Versandkostenhinweis (shipping_notice)

Rechtsgrundlage

Richtlinie 2011/83/EU Art. 6 Abs. 1 lit. e und deutsche PAngV § 6. Fallen zusaetzliche Lieferkosten an, muss unmittelbar beim Preis darauf hingewiesen werden.

Konfigurationsoptionen (shoplex_prices)

• shipping_costs_notice_enabled (bool, Standard: true): Aktiviert den Hinweis.
• shipping_costs_text (string, Standard: "zzgl. Versandkosten"): Verlinkter Text zur Versandkostenseite.

---

5. Ab-Preis bei variablen Produkten (from_price)

Rechtsgrundlage

Richtlinie 98/6/EG. Transparenzgebot zur Vermeidung irrefuehrender Preisspannen.

Funktionsweise

Ersetzt die Standard-Preisspanne von WooCommerce (z. B. 10,00 € - 50,00 €) durch einen eindeutigen Startpreis (ab 10,00 €).

Konfigurationsoptionen (shoplex_prices)

• from_price_enabled (bool, Standard: false): Aktiviert den Ab-Preis.
• from_price_text (string, Standard: "ab {price}"): Vorlagentext.

---

6. Lieferzeit (delivery_time)

Rechtsgrundlage

Richtlinie 2011/83/EU Art. 6 Abs. 1 lit. g. Klare Angabe des Zeitraums, innerhalb dessen die Ware geliefert wird.

Konfigurationsoptionen (shoplex_delivery)

• default_delivery_time (Term-ID, Standard: 0): Shopweiter Standardwert.
• display_format (string, Standard: "Lieferzeit: {time}"): Vorlage fuer Produktdetails.
• show_in_loop (bool, Standard: false): Anzeige auch in Produktlisten.

---

7. Gesetzliche Gewaehrleistung (consumer_information)

Rechtsgrundlage

Richtlinien (EU) 2019/771 und 2019/770. Gesetzliche Konformitaetsgarantie fuer Waren und digitale Gueter.

Konfigurationsoptionen (shoplex_consumer_info)

• show_legal_guarantee (bool, Standard: true): Aktiviert den gesetzlichen Gewaehrleistungshinweis.
• legal_guarantee_text (string): Standardtext (wird fuer Kaeufer in Spanien automatisch auf 3 Jahre angepasst).

Produktbezogene Felder

• _shoplex_durability_guarantee_months (int): Freiwillige Haltbarkeitsgarantie des Herstellers in Monaten.
• _shoplex_update_period_months (int): Zeitraum garantierter Software-Aktualisierungen.
• _shoplex_repair_info (textarea): Ersatzteilverfuegbarkeit und Reparaturanleitungen.

---

8. Laenderspezifische Regeln (country_compliance)

Rechtsgrundlage

§ 312j BGB (Button-Loesung), franzoesisches Art. L. 221-14, spanisches RDL 7/2021 sowie Registerpflichten (LUCID, EPR, BDO).

Details finden Sie im Laender-Compliance-Leitfaden.

---

9. 14-taegiges Widerrufsrecht (withdrawal)

Rechtsgrundlage

Richtlinie 2011/83/EU Anhang I(B). Gesetzliches Widerrufsrecht innerhalb von 14 Kalendertagen ohne Angabe von Gruenden.

Funktionsweise

1. Oeffentliches Formular ueber Shortcode [shoplex_withdrawal_form].
2. Knoepfe fuer Kunden im Kundenkonto unter Mein Konto > Bestellungen.
3. Gastbestellungs-Pruefung mit einmaligen Magic Links (30 Minuten Gueltigkeit).
4. Sicherheitsbeschraenkungen gegen automatisiertes Durchprobieren von Bestelldaten.
5. Bestaetigungs-E-Mails an Kaeufer und Shop-Administrator.

---

10. Produktsicherheits-Informationen (gpsr)

Rechtsgrundlage

Verordnung (EU) 2023/988 (GPSR). Pflichtangaben zu Hersteller, EU-Verantwortlichem (bei Nicht-EU-Herstellern), Typenkennzeichnung und Warnhinweisen fuer Non-Food-Verbraucherprodukte.

Produktbezogene Felder

• _shoplex_gpsr_manufacturer_name: Name des Herstellers.
• _shoplex_gpsr_manufacturer_address: Anschrift des Herstellers.
• _shoplex_gpsr_manufacturer_contact: Elektronischer Kontakt (E-Mail oder Webformular).
• _shoplex_gpsr_responsible_person: Name des EU-Wirtschaftsakteurs.
• _shoplex_gpsr_responsible_address: Postanschrift des EU-Wirtschaftsakteurs.
• _shoplex_gpsr_responsible_contact: E-Mail des EU-Wirtschaftsakteurs.
• _shoplex_gpsr_product_identifier: Modell-, Serien- oder Chargennummer.
• _shoplex_gpsr_safety_warnings: Sicherheits- und Warnhinweise in der Landessprache.
• _shoplex_gpsr_instructions: Montage- und Bedienungsanleitungen.

---

11. Kassen-Einwilligungen (legal_checkboxes)

Rechtsgrundlage

Richtlinie 2011/83/EU Art. 8, DSGVO Art. 7 und Art. 16 lit. m (Widerrufsverzicht bei digitalen Inhalten).

Unterstuetzt Checkboxen fuer AGB, Datenschutz, Verzicht auf Widerruf bei digitalem Download, Newsletter und Weitergabe an Versanddienstleister im klassischen und Block-Checkout. Einwilligungsnachweise werden direkt an der Bestellung protokolliert.

---

12. Anbieterkennzeichnung (business_info)

Rechtsgrundlage

Richtlinie 2000/31/EG Art. 5 und deutsches § 5 DDG (ehemals TMG). Leicht zugaengliche Pflichtangaben zu Unternehmensname, Anschrift, E-Mail, Telefon, Registergericht und USt-IdNr.

---

13. Streitbeilegung (dispute_resolution)

Rechtsgrundlage

Die Online-Streitbeilegungsplattform der EU wurde eingestellt. Die Verordnung (EU) 524/2013 wurde durch die Verordnung (EU) 2024/3228 mit Wirkung vom 20. Juli 2025 aufgehoben. Die Richtlinie 2013/11/EU, geaendert durch die Richtlinie (EU) 2025/2647, bildet den EU-Rahmen fuer alternative Streitbeilegung. Dieses Modul stellt nur einen anpassbaren Hinweis bereit. Pruefen Sie den Text anhand der fuer Ihren Shop geltenden nationalen Vorschriften und verlinken Sie auf die zustaendige ADR-Stelle, falls dies erforderlich ist.

---

14. B2B USt-IdNr.-Pruefung (vies)

Rechtsgrundlage

Richtlinie 2006/112/EG Art. 138 (Steuerfreie innergemeinschaftliche Lieferungen).

Prueft USt-IdNr. von Geschaeftskunden in Echtzeit ueber die VIES-Schnittstelle der EU-Kommission und speichert die offizielle Konsultationsnummer als Nachweis fuer das Finanzamt.

---

15. Gesetzliches Reklamationsformular (complaint_template)

Rechtsgrundlage

Richtlinie (EU) 2019/771. Formularvorlage bei Sachmaengeln.

Einsatz ueber Shortcode:

[shoplex_complaint_template]

oder als druckoptimierter HTML-Export im WooCommerce-Backend.

---

16. Cyber Resilience Act (cra_readiness)

Rechtsgrundlage

Verordnung (EU) 2024/2847 (CRA) und RFC 9116. Stellt eine standardisierte Sicherheitsrichtlinie unter /.well-known/security.txt bereit.

---

17. Digital Services Act (dsa_toolkit)

Rechtsgrundlage

Verordnung (EU) 2022/2065 (DSA) Art. 16. Oeffentliches Melde- und Abhilfeverfahren fuer rechtswidrige Inhalte oder illegale Produkte.

Einsatz ueber Shortcode:

[shoplex_dsa_report]

---

18. Verpackungspfand (deposit)

Fuegt dem WooCommerce-Warenkorb eine konfigurierbare, nicht steuerpflichtige Pfandgebuehr hinzu und zeigt einen Pfandhinweis auf Produktseiten. Das Modul ist standardmaessig deaktiviert. Die Produktfelder _shoplex_deposit_type und _shoplex_deposit_units legen Pfandart und Anzahl der Verpackungen fest. Varianten koennen diese Werte vom uebergeordneten Produkt uebernehmen.

Die Standardbetraege sind 0,25 EUR fuer Einwegverpackungen, 0,08 EUR fuer Mehrweg-Bierflaschen, 0,15 EUR fuer Mehrweg-Mineralwasserflaschen und 0,25 EUR fuer Dosen. Die Betraege koennen in den Einstellungen shoplex_deposit angepasst werden. Das Modul berechnet die Gebuehr und zeigt den Hinweis an, erfasst aber keine physischen Rueckgaben und erstattet keine Pfandbetraege.

---

19. Lebensmittelinformationen (food_information)

Zeigt Produktangaben aus Produktdaten > Shoplex an, darunter Zutaten, Allergene, Naehrwerte, Nutri-Score, Alkoholgehalt, Nettofuellmenge, Herkunftsort und Angaben zum Lebensmittelunternehmer. Das Modul ist standardmaessig deaktiviert und betrifft Lebensmittelinformationen nach Verordnung (EU) 1169/2011.

Naehrwerte werden als durch senkrechte Striche getrennte Schluessel:Wert-Paare eingegeben, zum Beispiel energy_kcal:250|fat:12|salt:0.9. Unterstuetzte Schluessel sind unter anderem energy_kj, energy_kcal, fat, saturated_fat, carbohydrates, sugars, fibre, protein und salt. Angezeigt werden nur ausgefuellte Angaben.

---

20. Cookie-Einwilligung und Content-Blocker (consent_manager)

Zeigt ein Cookie-Banner mit den Kategorien Notwendig, Analyse, Marketing und Einstellungen. Das Modul integriert Google Consent Mode v2 und kann eingebettete Medien von YouTube, Vimeo, Google Maps, OpenStreetMap und SoundCloud bis zur Einwilligung zurueckhalten. Besucher koennen ihre Einstellungen erneut oeffnen. Das Modul ist standardmaessig aktiviert und wird unter shoplex_consent konfiguriert.

Die Sperre gilt fuer unterstuetzte eingebettete Medien in Inhalten und Kurzbeschreibungen. Beliebige Skripte von Drittanbietern werden nicht allgemein blockiert.