Über dieses Plugin
IDF Woo Raffle ist ein Verlosungssystem für WooCommerce-Gutscheine. Besucher klicken auf ein animiertes Paket und erhalten per Zufall einen Gewinn- oder Trostpreis-Gutschein. Der Code wird im Browser angezeigt und per E-Mail zugesendet. Entwickelt von der Ideenfabrik GmbH, bietet das Plugin ein vollständiges Admin-Dashboard mit konfigurierbaren Gewinnen, Statistiken und Gewinner-Übersicht.
Features
- Shortcode:
[idf-woo-raffle]— rendert das animierte Verlosungs-Paket. Legacy-Shortcode[wc_raffle]wird ebenfalls unterstützt. - Konfigurierbare Gewinnwahrscheinlichkeit: Prozentsatz frei einstellbar im Admin.
- Gutschein-Limits: Jeder Gewinn-Gutschein hat eine maximale Vergabe-Anzahl mit automatischem Fallback auf den Trostpreis.
- Admin-Testmodus: Administratoren können unbegrenzt testen, ohne Statistiken oder Gutschein-Zähler zu beeinflussen.
- E-Mail-Versand: Gutscheincode wird automatisch per E-Mail an den Teilnehmer versendet. Absender konfigurierbar.
- Paket-Animation: Animiertes SVG-Paket mit Deckel-Öffnung und Confetti-Effekten (canvas-confetti).
- Eigene Grafiken: Deckel und Paket-Körper als SVG/PNG/JPG über die WordPress-Mediathek austauschbar.
- Gast-Formular: Nicht eingeloggte Nutzer geben Name und E-Mail an, bevor sie teilnehmen können.
- Teilnahme-Sperre: Eingeloggte Nutzer per User-Meta, Gäste per Cookie (30 Tage). Jeder kann nur einmal teilnehmen.
- Konfigurierbare Texte: Alle angezeigten Nachrichten (Gewinn, Trost, Fehler, Admin-Modus) im Admin editierbar.
- Statistik-Dashboard: Gesamt-Klicks, Preise, Trostpreise, Gewinner-Liste mit Fortschrittsbalken pro Gutschein.
- Master-Key-Anbindung: Dependency-Checker und automatische Registrierung bei IDF Master-Key für Lizenzprüfung und Updates.
- Hilfe-Seite: Shortcode-Referenz, Funktionsweise, Voraussetzungen und technische Details direkt im WordPress-Admin.
- Dependency-Check: Automatische Prüfung, ob WooCommerce aktiv ist. Klare Admin-Hinweise bei fehlender Abhängigkeit.
- Migration: Automatische Übernahme von Einstellungen und Statistiken aus v1.x.
Changelog
v2.1.0
Hinzugefügt
- Eigener Dependency-Checker in
includes/(prüft IDF Master Key >= 1.5.0). - Konstante
IDF_WOO_RAFFLE_FILE. - Master-Key-Registrierung für Lizenzprüfung und Auto-Updates.
Geändert
- Bootstrap auf
plugins_loaded:15verschoben. - Return-Type-Hints für alle Funktionen ergänzt.
- HTML-Entities durch
esc_html__()ersetzt.
v2.0.0
Geändert
- Kompletter Refactor auf IDF-Plugin-Standards.
- Monolith-Datei (~1450 Zeilen) in 7 Module aufgeteilt.
- Inline-CSS und -JS in externe Assets extrahiert.
- Dateiname
woocommerce-raffle.php→idf-woo-raffle.php. - Funktionen, Konstanten, Options, CSS-Klassen mit
idf_woo_raffle_-Prefix. - Eigenes Top-Level-Menü statt WooCommerce-Untermenü.
Hinzugefügt
- Dependency-Check für WooCommerce.
- Migration von v1.x-Options und User-Meta.
- Legacy-Shortcode
[wc_raffle]als Alias. wp_localize_scriptstatt Inline-PHP-in-JS.wp_rand()für bessere Zufallszahlen.
v1.0.0
Hinzugefügt
- Erstversion als Monolith-Datei. WooCommerce-Gutschein-Verlosung mit animiertem Paket, Confetti-Effekten, Admin-Testmodus, Gast-Formular, E-Mail-Versand und Statistik-Dashboard.