PulseCast

⚠️ Wichtig: PulseCast erfordert die StatusAPI Version 4.0.5 oder höher!
Ohne die StatusAPI funktioniert das Plugin nicht.
Download & Releases: StatusAPI Git Repository

PulseCast ist ein WordPress-Plugin, das Broadcast-Nachrichten direkt aus dem WordPress-Backend an deine StatusAPI sendet. Nachrichten können sofort oder zeitgesteuert verschickt werden. Der Plugin-Scheduler unterstützt serverseitige Planung für maximale Zuverlässigkeit.

---

Features

• Sofortige Broadcasts aus dem WordPress-Backend
• Geplante Broadcasts mit wiederkehrenden Intervallen (stündlich, täglich, wöchentlich)
• Globale Einstellungen: Prefix, Prefix-Farbe, Klammerfarbe und Nachrichtenfarbe
• Serverseitige Synchronisation geplanter Broadcasts
• Kompatibel mit jeder StatusAPI-Version ≥ 4.0.5, optional mit API-Key
• Logs der letzten 50 gesendeten Broadcasts
• Einfache Verwaltung über das WordPress-Admin-Menü

---

Installation

1. Lade das Plugin-Verzeichnis pulsecast in dein WordPress wp-content/plugins Verzeichnis hoch.
2. Aktiviere das Plugin über das WordPress-Admin-Plugin-Menü.
3. Installiere die StatusAPI (≥ 4.0.5) auf deinem Server.
   Download & Releases: StatusAPI Git Repository
4. Gehe zu PulseCast im Admin-Menü, um die API-Einstellungen zu konfigurieren.

---

Konfiguration

1. StatusAPI URL: Gib die Adresse deines StatusAPI-Servers an (Port und Pfad werden automatisch ergänzt).
   Beispiel: http://example.net
2. API-Key (optional): Falls dein StatusAPI-Key erforderlich ist.
3. Broadcast Prefix: Text, der vor jeder Nachricht angezeigt wird (z.B. [Broadcast]).
4. Prefix-Farbe, Klammerfarbe, Nachrichtenfarbe: Minecraft-Farbcodes (&c Rot, &8 Dunkelgrau, etc.).
5. Speichere die Einstellungen.

---

Verwendung

Sofortiger Broadcast

1. Gehe zu PulseCast → Broadcast.
2. Gib die Nachricht ein.
3. Klicke auf Senden, um die Nachricht sofort zu verschicken.

Geplante Broadcasts

1. Gehe zu PulseCast → Broadcast.
2. Gib Nachricht, Zeit (Server-Zeitzone) und optional Wiederholungsintervall ein.
3. Klicke auf Planen (serverseitig).
4. Geplante Broadcasts werden automatisch an die StatusAPI gesendet.

Synchronisation

• Mit der Synchronisationsfunktion können alle gespeicherten Zeitpläne erneut an die API gesendet werden.
• Fehlerhafte Schedules werden protokolliert.

---

Cron & Wiederholungen

• Wiederholung möglich: hourly (stündlich), daily (täglich), weekly (wöchentlich)
• Serverseitige Cron-Jobs werden automatisch über WordPress wp_cron verwaltet.

---

Sicherheit & Berechtigungen

• Nur Administratoren (manage_options) können Broadcasts senden oder Einstellungen ändern.
• API-Key kann optional gesetzt werden.
• Alle Eingaben werden sanitisiert und validiert.

---

Logs

• Die letzten 50 gesendeten Broadcasts werden gespeichert.
• Jede Nachricht enthält Meta-Daten (Zeit, Quelle, Zeitzone).

---

Kompatibilität

• WordPress 5.0+
• PHP 7.4+
• StatusAPI ≥ 4.0.5

---

Beispiel Payload an die API

{
  "message": "Hello World!",
  "type": "global",
  "prefix": "[Broadcast]",
  "prefixColor": "&c",
  "bracketColor": "&8",
  "messageColor": "&f",
  "meta": {
    "source": "PulseCast-WordPress",
    "time": "2026-01-17T12:00:00Z"
  }
}

Lizenz

Dieses Plugin hat keine Lizenz. Es darf nicht verändert oder weiterverbreitet werden.

Autor

M_Viper