Je näher ein Plugin an Bestellungen, Gutscheinen und Partnerdaten arbeitet, desto wichtiger ist eine klare technische Grenze. Der CROPS WooCommerce Referral Coupon Manager soll WooCommerce gezielt erweitern, ohne zentrale Shopfunktionen nachzubauen. Diese Haltung prägt die Architektur: vorhandene WordPress- und WooCommerce-APIs werden genutzt, neue Module bleiben auf ihren tatsächlichen Zweck begrenzt.

WooCommerce bleibt das führende Shopsystem

Produkte, Bestellungen, Gutscheine und Erstattungen liegen bereits in WooCommerce. Das Referral-Plugin speichert deshalb keine zweite Kopie des gesamten Shops. Es ergänzt die notwendigen Beziehungen zwischen Kampagne, Partner, Code, Bestellung, Provision und Auszahlung. Die eigentliche Bestellung bleibt dort, wo auch Versand, Kundenservice und Zahlungsstatus bearbeitet werden.

Diese klare Zuständigkeit verhindert widersprüchliche Datenbestände. Ändert sich der WooCommerce-Bestellstatus, kann die Referral-Logik auf die bestehende Bestellung reagieren. Ein paralleles Bestellsystem müsste dagegen regelmäßig synchronisiert werden und könnte bei Fehlern einen anderen Stand anzeigen.

Shortcodes als flexible Frontend-Bausteine

Der Generator und das Partner-Dashboard werden über eigene Shortcodes eingebunden. Für den Shopbetreiber bedeutet das: Eine normale WordPress-Seite kann als Partnerbereich gestaltet werden, ohne dass das Plugin ein fremdes Seitensystem erzwingt. Inhalte, Erläuterungen und Navigation bleiben mit dem vorhandenen Editor steuerbar.

Der Generator verwendet den Shortcode [crops_woo_referral_generator]. Das persönliche Dashboard wird mit [crops_woo_referral_dashboard] bereitgestellt. Beide Bausteine haben unterschiedliche Aufgaben, können aber im selben Design und innerhalb der bestehenden Website-Struktur eingesetzt werden.

Keine eigene Mail-Infrastruktur

Für Nachrichten nutzt das Plugin die globale WordPress-Mailfunktion. Ein bereits eingerichteter SMTP-Versand oder eine serverseitige Konfiguration bleibt damit zentral für die gesamte Website zuständig. Das Referral-Modul benötigt keine separaten Zugangsdaten und keine zusätzliche Versandbibliothek.

Diese Entscheidung reduziert Wartungsaufwand, verlangt aber eine saubere Statusprüfung. Ein erfolgreich gestarteter Vorgang ist nicht automatisch eine zugestellte E-Mail. Das System muss erkennen, ob wp_mail() den Versand angenommen hat, und Fehler protokollieren, wenn WordPress einen Mailfehler meldet.

Vorhandene Rechte statt eigener Rollenflut

Administrative Seiten enthalten sensible Daten und finanzielle Status. Sie werden deshalb an passende WooCommerce-Berechtigungen gebunden. Das Projekt verwendet unter anderem die Fähigkeit manage_woocommerce, statt ohne Not zahlreiche neue Rollen und Rechte zu erzeugen.

Eine spätere feinere Rollentrennung kann modular vorbereitet werden, sollte aber nur eingeführt werden, wenn sie einen klaren betrieblichen Nutzen hat. Für die aktuelle Architektur ist entscheidend, dass normale Besucher, Partner und Administratoren sauber voneinander getrennte Zugriffe erhalten.

Schlanke Datenbanknutzung

Partner, Kampagnen, Referrals, Provisionen und Protokolle benötigen strukturierte Daten. Trotzdem soll nicht für jede kleine Funktion eine neue Tabelle entstehen. Bestehende CROPS-Datenstrukturen werden wiederverwendet, wo dies fachlich sinnvoll ist. Die neue Partnerverwaltung greift beispielsweise auf vorhandene Tabellen zurück, statt einen parallelen Partnerbestand anzulegen.

Datenbankabfragen werden mit vorbereiteten Anweisungen ausgeführt. Eingaben werden bereinigt, Ausgaben kontextgerecht maskiert und Aktionen mit Nonces geschützt. Diese Grundlagen gehören zur Architektur und dürfen nicht erst nach der Gestaltung ergänzt werden.

Performance durch begrenzte Ansichten

Eine Administrationsseite muss nicht sämtliche Partner oder Logs auf einmal laden. Pagination, Filter und begrenzte Standardansichten reduzieren Datenmenge und verbessern die Bedienbarkeit. Bei der Partnerübersicht sind beispielsweise 25 aktive Einträge pro Seite als sinnvoller Startwert vorgesehen.

Auch Exporte und Importe sollten kontrolliert verarbeitet werden. Große Datenmengen benötigen klare Grenzen, Validierung und verständliche Rückmeldungen. Das Projekt verfolgt keine Strategie, jede Aufgabe in einen dauerhaften Hintergrundprozess auszulagern. Automatisierung wird nur dort eingesetzt, wo sie einen echten operativen Vorteil bietet.

Keine unnötigen externen Verbindungen

Der WooCommerce Referral Coupon Manager ist eine eigenständige Shoplösung. Er benötigt keine Stripe-Anbindung, keine fremden Gutscheinsysteme und keine externen Referral-Plattformen. Dadurch bleiben die entscheidenden Partner- und Bestelldaten innerhalb der WordPress-Installation.

Das bedeutet nicht, dass ein Shop vollständig ohne externe Dienste arbeitet. Zahlungsanbieter, Mailserver oder Hosting bleiben Teil der Website-Infrastruktur. Das Plugin selbst fügt jedoch keine zusätzliche Remote-Abhängigkeit hinzu, die für die Kernfunktion des Referral-Programms erforderlich wäre.

Modularer Ausbau statt Funktionsballast

Die Architektur ist auf Erweiterungen vorbereitet: Partnerverwaltung, Kampagnen, E-Mail-Vorlagen, CSV-Werkzeuge, Protokolle, Cron-Hilfe und Systembericht können als klar getrennte Module zusammenarbeiten. Neue Funktionen sollen bestehende WordPress-Mechanismen nutzen und nicht dieselbe Logik mehrfach implementieren.

Dieser Ansatz schützt das Projekt vor unnötigem Ballast. Ein Premium-Plugin wird nicht durch möglichst viele Bibliotheken hochwertig, sondern durch einen durchdachten Arbeitsablauf, verständliche Oberflächen und verlässliche technische Grundlagen. Genau daran orientiert sich die weitere Entwicklung.

Updates dürfen bestehende Zuordnungen nicht verlieren

Ein Referral-System enthält historische Beziehungen, die auch nach einer neuen Plugin-Version erhalten bleiben müssen. Datenbankänderungen benötigen deshalb versionierte, kontrollierte Aktualisierungen. Der modulare Aufbau soll neue Funktionen ergänzen, ohne bestehende Partner, Codes oder Bestellreferenzen neu anzulegen.

Integration als bewusste Begrenzung

Die Stärke des Projekts liegt in seiner klaren Zuständigkeit. Es verwaltet Empfehlungen auf Basis von WooCommerce-Bestellungen und echten Gutscheinen. Es ersetzt weder WooCommerce noch die Buchhaltung, den Mailserver oder das komplette Benutzerverwaltungssystem.

Diese Begrenzung schafft Stabilität und Wartbarkeit. Der Shop erhält einen spezialisierten Referral-Prozess, der sich in WordPress einfügt, statt eine zweite Plattform im Backend zu simulieren. So bleibt das System auch bei späteren Erweiterungen nachvollziehbar.