=== credoox Connect für WooCommerce ===
Contributors: credoox
Tags: woocommerce, partnerprogramm, affiliate, provision, credoox
Requires at least: 6.0
Tested up to: 6.8
Requires PHP: 7.4
Stable tag: 1.1.0
License: GPLv2 or later

Verbindet WooCommerce mit dem Partnerprogramm in credoox.

== Beschreibung ==

Vertriebspartner, Gutscheincodes, Provisionen, Abrechnung und Auszahlung verwaltet credoox (https://credoox.one). Dieses Plugin erledigt im Shop drei Dinge:

1. Empfehlungslinks: Ruft jemand Ihren Shop mit ?ref=CODE auf, merkt sich das Plugin den Code (Cookie, Dauer aus credoox) und schreibt ihn bei der Bestellung in das Feld „credoox_ref“. credoox liest das Feld beim Bestellabruf und ordnet die Bestellung dem Partner zu. Ein eingegebener Gutscheincode eines Partners hat Vorrang.
2. „Partner werden“: Der Shortcode [credoox_partner_werden] zeigt einen Button zum Registrierungsformular in credoox. Ein gemerkter Empfehlungscode wird als werbender Partner (Sponsor) mitgegeben.
3. Zahlungsabgleich: Wird eine Bestellung bezahlt, storniert oder erstattet, meldet das Plugin das sofort an credoox (nur die Bestellnummer). credoox ruft die Bestellung dann selbst über die WooCommerce-REST-API ab, bucht die Zahlung, storniert die Rechnung bzw. bucht die Erstattung. Umgekehrt meldet credoox eine dort bezahlte Vorkasse an den Shop zurück.

Die Gutscheincodes der Partner legt credoox selbst über die WooCommerce-REST-API im Shop an (Einstellung in credoox: Vertriebspartner → „Partner-Codes automatisch in den Shop übertragen“). Dafür braucht es kein Plugin.

== Installation ==

1. In credoox unter Einstellungen → API einen API-Schlüssel mit Recht „Lesen“ anlegen.
2. Plugin unter Plugins → Installieren → Plugin hochladen installieren und aktivieren.
3. WooCommerce → credoox Connect: credoox-Adresse (Standard https://login.credoox.one) und API-Schlüssel eintragen, „Speichern und verbinden“.
4. Optional eine Seite „Partner werden“ mit dem Shortcode [credoox_partner_werden] anlegen.

Hinweise:
* Läuft mit der klassischen und der Block-Kasse sowie mit HPOS (Bestellungen in eigenen Tabellen).
* Seiten-Caches: Aufrufe mit ?ref=… dürfen nicht aus dem Cache kommen (bei den üblichen Cache-Plugins ist das für Adressen mit Parametern Standard).
* Einwilligung: Mit der WP Consent API setzt das Plugin den Cookie nur bei Einwilligung „Marketing“. Ob der Cookie eine Einwilligung braucht, klären Sie bitte mit Ihrer Datenschutzberatung.
* Der API-Schlüssel wird in den WordPress-Optionen gespeichert. Verwenden Sie einen eigenen Schlüssel nur mit „Lesen“.

== Changelog ==

= 1.1.0 =
* Zahlungsabgleich: bezahlte, stornierte und erstattete Bestellungen sofort an credoox melden (abschaltbar, Status „Letzte Meldung an credoox“).

= 1.0.0 =
* Erste Version: Empfehlungslink, Feld credoox_ref an der Bestellung, Shortcode „Partner werden“, Einstellungen aus credoox.
