=== APlug Gutschein- und Geschenkkartenmodul ===
Contributors: aplug
Tags: voucher, gift card, coupon, geschenkkarte, gutschein
Requires at least: 6.4
Requires PHP: 7.4
Stable tag: 1.0.0
License: GPLv2 or later
License URI: https://www.gnu.org/licenses/gpl-2.0.html

Verwaltet Wert- und Leistungsgutscheine, Aktionscodes und digitale Geschenkkarten mit Teil-Einlösung, QR-Code und Guthabenjournal.

== Description ==

APlug Gutschein- und Geschenkkartenmodul ist ein eigenständiges, verständliches Gutschein-Cockpit. Unternehmen können Gutscheinprodukte konfigurieren, Bestellungen erfassen, Zahlungen bestätigen, Codes ausstellen, Guthaben prüfen und Gutscheine sicher einlösen.

Funktionen:

* Wertgutscheine und digitale Geschenkkarten
* Leistungsgutscheine
* Aktionscodes und begrenzte Serien
* feste oder frei wählbare Beträge
* Teil-Einlösung und Restguthaben
* Mindestbestellwert und Nutzungskanäle
* Kundenzuordnung
* persönlicher Grußtext, Druckansicht und E-Mail-Zustellung
* lokal erzeugter QR-Code
* nachvollziehbarer Guthabenverlauf
* Stornierung, Erstattung, Verlängerung und Korrektur
* Konfiguration als Einzweck-, Mehrzweck- oder Rabattgutschein
* REST-API und dokumentierte Adapterpunkte

Das Plugin sendet ohne aktivierten Adapter keine Daten an externe Dienste. Die QR-Code-Bibliothek wird lokal ausgeliefert.

== Installation ==

1. Plugin-ZIP unter Plugins > Installieren > Plugin hochladen auswählen.
2. Plugin aktivieren.
3. APlug Gutscheine > Produkte öffnen und ein Gutscheinprodukt anlegen.
4. Steuerliche Einordnung durch fachkundige Stelle prüfen.
5. Für den eigenständigen Verkauf `[aplug_gutschein_shop]` auf einer Seite einfügen.
6. Zahlungsadapter verbinden oder Zahlungseingänge manuell bestätigen.

== Frequently Asked Questions ==

= Kann das Plugin ohne WooCommerce arbeiten? =

Ja. Es nimmt eigenständig Bestellungen entgegen. Ohne Zahlungsadapter wird der Gutschein nach manueller Zahlungsbestätigung ausgestellt.

= Werden Teil-Einlösungen unterstützt? =

Ja, sofern sie am Gutscheinprodukt aktiviert sind. Jede Buchung wird im Guthabenjournal protokolliert.

= Erzeugt das Plugin Rechnungen? =

Nein. Rechnungen gehören der Zahlungs- und RechnungsZentrale oder einem anderen Rechnungsadapter. Das Plugin speichert nur die zurückgegebene Rechnungsreferenz.

= Ist die Steuerlogik automatisch rechtssicher? =

Nein. Die Einordnung als Einzweck-, Mehrzweck- oder Rabattgutschein muss das ausstellende Unternehmen fachlich prüfen. Das Plugin stellt die gewählte Einordnung strukturiert für Ereignisse und Adapter bereit.

= Nutzt der QR-Code einen externen Dienst? =

Nein. QRCode.js wird lokal mitgeliefert.

== Privacy ==

Je nach Verkaufsweg verarbeitet das Plugin Namen, E-Mail-Adressen, persönliche Nachrichten, Benutzer-IDs, Lieferzeitpunkte, Zahlungs- und Rechnungsreferenzen sowie Gutschein- und Einlösungsdaten. Gutscheincodes werden verschlüsselt gespeichert. Ohne aktivierten Adapter werden keine Daten an externe Dienste übertragen.

== Screenshots ==

1. Gutschein-Cockpit
2. Gutscheinprodukt mit Wert- und Steuerkonfiguration
3. Bestellübersicht
4. Einlösungsoberfläche
5. Gutscheinurkunde mit QR-Code
6. Guthabenverlauf

== Changelog ==

= 1.0.0 =
* Erster installierbarer Prototyp.
* Gutscheinprodukte, Bestellungen, Ausstellung, Einlösung und Journal.
* QR-Code, E-Mail-Zustellung und Druckansicht.
* APlug-Dienste, Ereignisse, REST-API und Adapterpunkte.
* Datenschutz-, Sicherheits- und WordPress.org-Unterlagen.
