FWW Social Publisher

WordPress-Plugin für Feuerwehr Wolfurt – automatisches Veröffentlichen von Beiträgen auf Facebook, Instagram, Telegram und eine WhatsApp-Kopierhilfe.

Funktionen

Beitragstext & WP-Claude-Optimizer Integration

Das Plugin ist nativ mit WP-Claude-Optimizer integriert. Ist der dort generierte Social-Media-Text vorhanden (_claude_social_media_text), wird dieser automatisch verwendet. Für den WhatsApp-Text wird entsprechend _claude_whatsapp_text bevorzugt. Fehlen diese Felder, greift das Plugin auf Auszug bzw. Beitragsinhalt zurück.

WhatsApp-Text zusätzlich:

Hinweis: WP-Claude-Optimizer speichert Werte base64-kodiert mit B64:-Prefix. FWW Social Publisher erkennt und dekodiert dieses Format automatisch.

Voraussetzungen

• WordPress 6.0 oder höher
• PHP 8.0 oder höher
• Facebook-Seite mit gültigem Page Access Token
• Instagram Business Account (verbunden mit der Facebook-Seite)
• Meta Graph API Version: v19.0
• Telegram Bot (via @BotFather) mit Admin-Rechten im Kanal

Installation

Option A – ZIP hochladen (empfohlen)

1. Die Datei fww-social-publisher.zip herunterladen
2. Im WordPress-Backend: Plugins → Neu hinzufügen → Plugin hochladen
3. ZIP auswählen und installieren
4. Plugin aktivieren

Option B – FTP / direkt auf Server

1. Den Ordner fww-social-publisher nach wp-content/plugins/ kopieren
2. Im WordPress-Backend das Plugin aktivieren

Bei der Aktivierung wird automatisch die Datenbanktabelle wp_fww_social_log erstellt.

Einrichtung

1. Facebook Page Access Token erstellen

1. Meta for Developers öffnen
2. App erstellen (Typ: Business)
3. Produkt Facebook Login hinzufügen
4. Unter Graph API Explorer: Token für die Seite mit folgenden Berechtigungen generieren:
   • pages_manage_posts
   • pages_read_engagement
   • publish_to_groups (optional)
5. Token in den Plugin-Einstellungen eintragen

2. Instagram Business Account einrichten

1. Instagram-Konto muss als Business Account konfiguriert sein
2. Instagram-Konto mit der Facebook-Seite verknüpfen
3. Im Graph API Explorer die Instagram Business Account ID abrufen:

   GET /{facebook-page-id}?fields=instagram_business_account

4. ID und Token (derselbe wie Facebook oder separater) in den Einstellungen eintragen

3. Telegram Bot einrichten

1. @BotFather in Telegram öffnen und /newbot senden
2. Bot-Namen und Username vergeben → Token kopieren
3. Den Bot als Admin in den Telegram-Kanal einladen (Berechtigung: „Nachrichten posten")
4. Channel-ID ermitteln:
   • Öffentlicher Kanal: @kanalname (z. B. @fww_wolfurt)
   • Privater Kanal: numerische ID, z. B. -1001234567890 (über @username_to_id_bot oder Telegram API abrufbar)
5. Token und Channel-ID in den Plugin-Einstellungen eintragen
6. Test Connection klicken – bei Erfolg wird @botname → Kanalname angezeigt

4. Plugin konfigurieren

Unter Einstellungen → FWW Social Publisher:

Verwendung

Automatisches Posten

Sobald ein Beitrag veröffentlicht wird (status → publish), postet das Plugin automatisch auf den konfigurierten Plattformen – vorausgesetzt, die Auto-Post-Optionen sind aktiviert und die Kategorie stimmt überein.

Manuelles Posten

In der Seitenleiste des Beitragseditors (FWW Social Publisher):

• Post to Facebook now – sofort auf Facebook posten (auch erneut möglich)
• Post to Instagram now – sofort auf Instagram posten (nur wenn Beitragsbild vorhanden)
• Post to Telegram now – sofort auf Telegram posten (auch erneut möglich)
• Copy to Clipboard – WhatsApp-Text in die Zwischenablage kopieren
• Open WhatsApp – WhatsApp direkt öffnen

Telegram-Nachrichtenformat

Posts werden HTML-formatiert übermittelt:

<b>Beitragstitel</b>

Social-Media-Text / Auszug

https://permalink

Ist ein Beitragsbild vorhanden, wird sendPhoto mit Caption verwendet; sonst sendMessage.
Caption-Limit: 1.024 Zeichen · Nachrichten-Limit: 4.096 Zeichen (wird automatisch abgeschnitten).

WhatsApp-Text

Das Format des kopierten Textes:

[Beitragstitel]

[Social-Media-Text / Auszug]

[Permalink]

Aktivitätsprotokoll

Alle Post-Versuche werden in der Datenbanktabelle wp_fww_social_log gespeichert. Die letzten 50 Einträge sind auf der Einstellungsseite einsehbar.

Statuswerte:

• success – erfolgreich gepostet
• error – Fehler beim Posten (Fehlermeldung sichtbar)
• skipped – übersprungen (z. B. kein Beitragsbild für Instagram)

Doppelpost-Schutz

Nach einem erfolgreichen Post wird das entsprechende Post-Meta mit Zeitstempel gesetzt:

Solange dieses Meta vorhanden ist, wird ein erneutes automatisches Posten verhindert. Über die manuellen Buttons kann trotzdem erneut gepostet werden.

Dateistruktur

fww-social-publisher/
├── fww-social-publisher.php              Plugin-Header & Bootstrap
├── includes/
│   ├── class-fww-social-publisher.php   Hauptklasse (Hooks, AJAX, Logik)
│   ├── class-fww-facebook-api.php       Facebook Graph API Wrapper
│   ├── class-fww-instagram-api.php      Instagram Graph API Wrapper
│   └── class-fww-telegram-api.php       Telegram Bot API Wrapper
├── admin/
│   ├── settings-page.php                Einstellungsseite (Template)
│   └── meta-box.php                     Meta Box im Beitragseditor (Template)
└── assets/
    └── admin.js                         AJAX-Handler, Clipboard, Spinner

Technische Details

• Meta Graph API: Version v19.0
• Facebook-Endpunkte: /{page-id}/photos (mit Bild) · /{page-id}/feed (ohne Bild)
• Instagram-Flow: /{ig-id}/media (Container erstellen) → /{ig-id}/media_publish (veröffentlichen)
• Telegram-Endpunkte: /sendPhoto (mit Bild) · /sendMessage (ohne Bild) · /getMe + /getChat (Test)
• WordPress-Hook: transition_post_status – feuert nur bei neu → publish
• Sicherheit: Nonces für alle AJAX-Aktionen · sanitize_* / esc_* überall · Capability Checks
• Keine externen Abhängigkeiten – kein Composer, keine NPM-Pakete

Lizenz

GPL-2.0-or-later – siehe GNU General Public License