WP Ingame Shop Pro

Ein leistungsstarker, vollständig eigenständiger Ingame-Shop für WordPress, entwickelt für Minecraft-Server (Spigot/Paper).
Er bietet ein komfortables Warenkorb-System, Gutscheine, Daily Deals und eine benutzerdefinierte Währung – komplett ohne RCON.

Dieses Plugin nutzt eine eigene Datenbankstruktur für maximale Performance und vollständige Unabhängigkeit von WordPress-Beiträgen.

---

✨ Highlights

• 🛒 Warenkorb-System
  Mehrere Items pro Bestellung.
  Eine Bestellung = eine saubere Datenbankzeile mit JSON-Details.

• ⚡ Mehrfachbearbeitung (Bulk Edit)
  Hunderte Items gleichzeitig bearbeiten (Preis, Server, Kategorie, Status).

• 💰 Eigene Währung
  „Coins“, „Tokens“ oder beliebige virtuelle Währungen.

• 🖼️ Automatische Bildzuweisung
  minecraft:diamond → minecraft_diamond.png
  Ideal für große Bildsammlungen (1500+ Dateien).

• 🔥 Daily Deal & Sale-System

• 🎫 Smart Coupons
  Prozent- oder Festbetrag, optional nicht kombinierbar mit Angeboten.

• 🌐 REST API ohne RCON

• 📊 Top-Spender & Umsatzstatistik

---

🚀 Installation

1. Ordner wp-ingame-shop-pro nach:

wp-content/plugins/

2. Plugin im WordPress Backend aktivieren.
3. Fertig.

Bei Aktivierung werden automatisch erstellt:

• Datenbanktabellen (wp_wis_*)
• Cron-Jobs für Daily Deals

---

🖼️ Bilder-Konfiguration (Gitea Raw)

📂 Basis-URL für alle Item-Bilder

https://git.viper.ipv64.net/M_Viper/WP-Ingame-Shop-Pro/raw/branch/main/images/

🔧 Eintragen im Plugin

Ingame Shop → Einstellungen → Bilder Basis-URL

Eintragen:

https://git.viper.ipv64.net/M_Viper/WP-Ingame-Shop-Pro/raw/branch/main/images/

---

📌 Automatische Bildlogik

Item-ID im Shop:

minecraft:diamond

Automatisch geladen wird:

https://git.viper.ipv64.net/M_Viper/WP-Ingame-Shop-Pro/raw/branch/main/images/minecraft_diamond.png

Regeln:

• : wird zu _
• Dateiendung = .png
• Keine manuelle Bildzuweisung notwendig

---

📥 Quick JSON Import (Direkt von Gitea)

🔗 Import-URL

https://git.viper.ipv64.net/M_Viper/WP-Ingame-Shop-Pro/raw/branch/main/items.json

---

🛠️ Import durchführen

1. Ingame Shop → JSON Tools
2. Import
3. URL einfügen
4. Import starten

Ideal für:

• Kompletten Shop-Aufbau in Sekunden
• Regelmäßige Synchronisation
• Kombination mit Bulk Edit

---

🛠️ Admin-Bereich

1️⃣ Einstellungen

• Shop Header Text
• Währungsname (z.B. Coins)
• Bilder Basis-URL
• Daily Deal (% Rabatt)
• Gutscheine auf Sale-Items erlauben / verbieten

---

2️⃣ Items Verwaltung

Einzelbearbeitung

• Item ID (minecraft:diamond)
• Preis
• Angebotspreis
• Server-Zuweisung
• Kategorie
• Status (publish / draft)

---

🔄 Bulk Edit (Mehrfachbearbeitung)

Beispiel: 100 Items einem Server zuweisen.

1. Items anhaken
2. „Massenaktionen“ wählen:
   • Server zuweisen
   • Preis ändern
   • Kategorie setzen
   • Status ändern
3. Anwenden
4. Änderungen speichern

Überschreibt bestehende Server-/Kategorie-Zuweisungen.

---

3️⃣ Weitere Bereiche

📦 Bestellungen

• Bestellungen anzeigen
• Manuell abschließen
• Stornieren

Status:

pending
processing
completed
cancelled

---

🌐 Server

Beispiel:

lobby
survival
skyblock

Frontend-Filter werden automatisch generiert.

---

📂 Kategorien

Beispiel:

Blöcke
Waffen
Rüstung
Ranks

---

🎫 Gutscheine

• fixed (Festbetrag)
• percent (Prozent)
• Ablaufdatum
• Nutzungslimit
• Ausschluss bei Angeboten

---

📊 Top Spender

Automatische Auswertung der Bestellungen.

---

🎮 Frontend Nutzung

Shortcode:

[ingame_shop_form]

---

Spieler-Funktionen

• Suche
• Server-Filter
• Kategorie-Tabs
• Warenkorb
• Gutschein-Eingabe
• Server-Validierung beim Checkout

---

📡 REST API

Basis:

/wp-json/wis/v1/

---

Bestellung erstellen

POST /wis/v1/order

{
  "player": "Name",
  "server": "survival",
  "cart": [
    { "id": "item_id", "quantity": 1 }
  ],
  "coupon_code": "CODE"
}

---

Offene Bestellungen abrufen

GET /wis/v1/pending_orders?player=Name

---

Status ändern

POST /wis/v1/execute_order
POST /wis/v1/complete_order
POST /wis/v1/cancel_order

---

Gutschein validieren

POST /wis/v1/validate_coupon

---

💾 Datenbank-Struktur

wp_wis_items

Feld	Beschreibung
item_id	minecraft:diamond
name	Anzeigename
price	Standardpreis
offer_price	Angebotspreis
is_offer	0 / 1
servers	JSON Array
categories	JSON Array
status	publish / draft

---

wp_wis_orders

Feld	Beschreibung
player_name	Minecraft Name
server	Zielserver
item_title	Zusammenfassung
price	Gesamtpreis
response	JSON
status	pending / processing / completed / cancelled

---

wp_wis_coupons

Feld	Beschreibung
code	Gutschein
type	fixed / percent
value	Rabattwert
usage_limit	Limit
used_count	Nutzung

---

wp_wis_servers

Serverdefinitionen

---

wp_wis_categories

Kategoriedefinitionen

---

⚡ Performance Empfehlung

Bei 1500+ PNG-Dateien:

• CDN empfohlen
• PNG verlustfrei komprimieren
• Gitea Caching aktivieren
• Optional WebP-Versionen erstellen

---

🔐 Sicherheitshinweis

Aktuell sind API-Endpunkte öffentlich (__return_true).

Für Produktion empfohlen:

• API-Key Header
• Bearer Token
• IP Whitelisting
• Nonce/Signature System

---

📦 Meta

Version: 2.1.0
Autor: M_Viper
Lizenz: GPL-2.0-or-later