Bluesky für phpBB 3.3.x

Bluesky für phpBB ist eine kostenlose Erweiterung für phpBB 3.3.x von ButtonPusher, die neue Forenthemen über die offizielle AT-Protocol-API automatisch auf Bluesky veröffentlicht.

Mit dieser Erweiterung können Forenadministratoren neue Diskussionen auf Bluesky teilen, ohne Thementitel, Beschreibungen und Links manuell kopieren zu müssen. Unterstützt werden die Freigabe durch Moderatoren, die Auswahl von Foren, konfigurierbare Textauszüge, eigene Themen-URLs und automatische Zustellversuche.

Bluesky für phpBB funktioniert als reguläre phpBB-Erweiterung und erfordert keine Änderungen an den Kerndateien oder Templates von phpBB.

Funktionen

• Automatische Veröffentlichung neu freigegebener phpBB-Themen auf Bluesky.
• Optionale Veröffentlichung nach der Freigabe durch einen Moderator.
• Auswahl der Foren, aus denen Themen automatisch veröffentlicht werden dürfen.
• Automatisches Einfügen des Thementitels und der URL.
• Optionaler Textauszug aus dem ersten Beitrag.
• Konfigurierbare Länge des Textauszugs und Mindestlänge des ersten Beitrags.
• Anklickbare Themenlinks mithilfe von Bluesky-Rich-Text-Facets.
• Externe Website-Vorschaukarten mit Thementitel und Beschreibung.
• Unterstützung für standardmässige phpBB-URLs sowie eigene, suchmaschinenfreundliche URLs.
• Optionale Sprachkennzeichnungen nach BCP 47 für veröffentlichte Beiträge.
• Zustellwarteschlange mit Schutz vor doppelten Veröffentlichungen.
• Sofortige Veröffentlichungsversuche und automatische Wiederholungen über phpBB-Cron.
• Konfigurierbare maximale Anzahl von Zustellversuchen.
• Manuelle Veröffentlichung bestehender, freigegebener Themen über den Administrationsbereich (ACP).
• Sichere erneute Veröffentlichung, wenn ein zuvor veröffentlichter Bluesky-Beitrag gelöscht wurde.
• Zustellstatistiken, letzte Warteschlangenaktivitäten und Fehlerinformationen im ACP.
• Unterstützung für den regulären Bluesky-Dienst und kompatible eigene AT-Protocol-PDS-Server.
• Übersetzungen des Administrationsbereichs auf Englisch, Deutsch und Ukrainisch.

Funktionsweise

Wenn ein neues phpBB-Thema erstellt und freigegeben wird, fügt Bluesky für phpBB es einer Zustellwarteschlange hinzu. Anschliessend versucht die Erweiterung, einen entsprechenden Beitrag auf dem konfigurierten Bluesky-Konto zu veröffentlichen.

Wenn im Forum eine Beitragsmoderation aktiviert ist, kann die Erweiterung warten, bis das neue Thema von einem Moderator freigegeben wurde. Themen aus ausgeschlossenen Foren oder Themen, die die konfigurierte Mindesttextlänge nicht erreichen, werden nicht automatisch veröffentlicht.

Jeder Bluesky-Beitrag enthält den Titel des Forenthemas und einen Link zur ursprünglichen Diskussion. Optional kann auch ein Textauszug aus dem ersten Beitrag eingefügt werden.

Der veröffentlichte Beitrag führt Besucher zurück zum phpBB-Forum. Dort können sie die vollständige Diskussion lesen und entsprechend den Zugriffsberechtigungen des Forums daran teilnehmen.

Inhalt der Bluesky-Beiträge

Die Erweiterung erstellt Beiträge aus den vorhandenen Informationen eines phpBB-Themas. Der Thementitel wird als Haupttext verwendet, gefolgt von einem optionalen Textauszug und der Themen-URL.

BBCode- und HTML-Formatierungen werden aus dem Textauszug entfernt, sodass ein für Bluesky geeigneter Klartext entsteht. Der fertige Beitrag wird bei Bedarf gekürzt, um die Beschränkung der Plattform auf 300 Zeichen einzuhalten.

Die Themen-URL wird als anklickbarer Rich-Text-Link eingefügt. Ausserdem erstellt die Erweiterung eine Website-Vorschaukarte vom Typ app.bsky.embed.external, die die Themen-URL, den Titel und die Beschreibung enthält.

Textauszüge können unabhängig aktiviert oder deaktiviert werden. Die maximale Länge des Textauszugs lässt sich zwischen 40 und 220 Zeichen einstellen. Der tatsächlich veröffentlichte Auszug kann jedoch kürzer sein, damit genügend Platz für den Titel und die URL bleibt.

Forenauswahl und Veröffentlichungsregeln

Administratoren können festlegen, aus welchen phpBB-Foren neue Themen automatisch auf Bluesky veröffentlicht werden dürfen.

Wenn keine Foren ausgewählt sind, ist die automatische Veröffentlichung für alle Foren möglich, in denen Themen erstellt werden können. Aus Datenschutzgründen sollten Administratoren ausdrücklich nur diejenigen Foren auswählen, deren Themen öffentlich verbreitet werden dürfen. Dies ist besonders wichtig, wenn das Board private oder zugriffsbeschränkte Bereiche enthält.

Auch die Mindestlänge des ersten Beitrags kann konfiguriert werden. Dadurch lässt sich verhindern, dass Themen mit nur wenigen Wörtern automatisch geteilt werden. Mit dem Wert 0 wird diese Einschränkung deaktiviert.

Die Erweiterung veröffentlicht neue Themen, jedoch nicht automatisch jede Antwort oder spätere Aktualisierung eines Themas.

Themen-URLs und Clean URLs

Standardmässig erzeugt Bluesky für phpBB reguläre phpBB-Themenlinks wie:

https://example.com/forum/viewtopic.php?t=123

Administratoren, die eine alternative URL-Struktur verwenden, können eine eigene Vorlage für Themen-URLs konfigurieren. Folgende Platzhalter stehen zur Verfügung:

• {board_url} – die URL des phpBB-Boards.
• {topic_id} – die ID des Themas.
• {post_id} – die ID des ersten Beitrags.

Foren, die beispielsweise ButtonPusher Clean URLs verwenden, können folgende Vorlage konfigurieren:

t{topic_id}

Dadurch entsteht beispielsweise eine URL wie:

https://example.com/forum/t123

Relative URL-Vorlagen werden automatisch anhand der phpBB-Board-URL aufgelöst. Die Unterstützung eigener URLs ermöglicht auch die Verwendung der Erweiterung mit anderen Implementierungen suchmaschinenfreundlicher URLs.

Zustellwarteschlange und automatische Wiederholungsversuche

Bluesky für phpBB verwendet eine datenbankgestützte Zustellwarteschlange, um Veröffentlichungsversuche und deren Ergebnisse zu verfolgen.

Wenn ein Thema in die Warteschlange aufgenommen wird, versucht die Erweiterung bei konfiguriertem Bluesky-Konto eine sofortige Zustellung. Schlägt die API-Anfrage fehl, bleibt das Thema ausstehend und kann über phpBB-Cron automatisch erneut zugestellt werden.

Die Wartezeiten zwischen den Wiederholungsversuchen werden schrittweise erhöht. Dadurch werden wiederholte Anfragen bei vorübergehenden Verbindungsproblemen oder Unterbrechungen des Bluesky-Dienstes vermieden.

Die maximale Anzahl der Versuche ist konfigurierbar. Sobald dieses Limit erreicht ist, wird die Zustellung als fehlgeschlagen markiert. Administratoren können fehlgeschlagene Einträge im ACP zurücksetzen, um einen erneuten Versuch zu ermöglichen.

Die Administrationsoberfläche zeigt die Anzahl der ausstehenden, gesendeten, übersprungenen und fehlgeschlagenen Einträge sowie die letzten Warteschlangeneinträge und verfügbare Fehlermeldungen an.

Schutz vor Duplikaten und manuelle Veröffentlichung

Jedes veröffentlichte Thema wird anhand seiner phpBB-Themen-ID erfasst. Dadurch wird verhindert, dass dasselbe Thema mehrfach automatisch veröffentlicht wird.

Administratoren können ausserdem ein bestehendes, freigegebenes Thema manuell veröffentlichen, indem sie dessen Themen-ID im Administrationsbereich eingeben. Die manuelle Veröffentlichung kann unabhängig von den Regeln zur automatischen Forenauswahl und Mindesttextlänge verwendet werden.

Wenn das Thema bereits veröffentlicht wurde, überprüft die Erweiterung, ob der entsprechende Bluesky-Eintrag noch vorhanden ist.

Ist der ursprüngliche Bluesky-Beitrag weiterhin verfügbar, wird kein Duplikat erstellt. Wurde der Bluesky-Beitrag gelöscht, kann das Thema erneut veröffentlicht werden.

Bluesky-Authentifizierung

Die Erweiterung verwendet die offiziellen AT-Protocol-XRPC-Endpunkte für die Authentifizierung und Veröffentlichung.

Administratoren müssen ihren Bluesky-Handle und ein separates Bluesky-App-Passwort konfigurieren. Das reguläre Passwort des Bluesky-Kontos sollte niemals in der Erweiterung eingegeben werden.

Die standardmässige Dienst-URL lautet https://bsky.social. Alternativ kann ein eigener HTTPS-Personal-Data-Server (PDS) konfiguriert werden, sofern dieser die erforderlichen AT-Protocol-Endpunkte unterstützt.

Das App-Passwort wird in der phpBB-Konfigurationsdatenbank gespeichert. Administratoren sollten deshalb den Zugriff auf die Datenbank und den Administrationsbereich einschränken und ein separates App-Passwort verwenden, das unabhängig vom Hauptpasswort widerrufen werden kann.

Voraussetzungen

• phpBB 3.3.0 oder neuer innerhalb der phpBB-3.x-Reihe.
• PHP 7.2 oder neuer.
• Ein Bluesky-Konto mit einem App-Passwort.
• Ausgehender HTTPS-Zugriff auf den konfigurierten Bluesky-Dienst oder AT-Protocol-PDS-Server.
• Aktive phpBB-Cron-Verarbeitung für automatische Zustellwiederholungen.

Enthaltene Sprachen

Die Erweiterung enthält Sprachdateien für den Administrationsbereich auf Englisch, Deutsch und Ukrainisch.

Installation

1. Laden Sie das Archiv der Erweiterung herunter.
2. Entpacken Sie das Archiv in Ihre phpBB-Installation, sodass sich die Dateien der Erweiterung im folgenden Verzeichnis befinden:
   ext/buttonpusher/bluesky/
3. Öffnen Sie den phpBB-Administrationsbereich (ACP).
4. Navigieren Sie zu Anpassen → Erweiterungen verwalten.
5. Suchen Sie nach ButtonPusher Bluesky for phpBB und klicken Sie auf Aktivieren.
6. Öffnen Sie Erweiterungen → Bluesky für phpBB → Bluesky-Einstellungen.
7. Geben Sie Ihren Bluesky-Handle und Ihr App-Passwort ein.
8. Klicken Sie auf Speichern und Verbindung testen, um die Authentifizierung zu überprüfen.
9. Aktivieren Sie die automatische Veröffentlichung und konfigurieren Sie die gewünschten Veröffentlichungsregeln.

Es sind keine Änderungen an den Kerndateien oder Templates von phpBB erforderlich. Während der Installation erstellt die Erweiterung eine eigene Datenbanktabelle für die Zustellwarteschlange.

Einstellungen im Administrationsbereich

Der Administrationsbereich bietet Konfigurationsmöglichkeiten für das Bluesky-Konto, die automatische Veröffentlichung, zugelassene Foren, die Moderatorenfreigabe, die Länge von Textauszügen, die Mindestlänge des ersten Beitrags, Zustellversuche, Vorlagen für Themen-URLs und Sprachkennzeichnungen der veröffentlichten Beiträge.

Administratoren können die Bluesky-Verbindung testen, freigegebene Themen manuell veröffentlichen, fehlgeschlagene Warteschlangeneinträge erneut zustellen und die letzten Zustellaktivitäten überprüfen, ohne Konfigurationsdateien bearbeiten zu müssen.

Version 1.0.0

• Erste öffentliche Veröffentlichung.
• Automatische Veröffentlichung neu freigegebener phpBB-Themen auf Bluesky hinzugefügt.
• Unterstützung für die Veröffentlichung nach Moderatorenfreigabe hinzugefügt.
• Konfigurierbare Forenauswahl und Mindestlänge des ersten Beitrags hinzugefügt.
• Optionale Textauszüge aus dem ersten Beitrag und automatische Textkürzung hinzugefügt.
• Anklickbare URL-Facets und externe Website-Vorschaukarten hinzugefügt.
• Eigene Vorlagen für Clean URLs und suchmaschinenfreundliche Themen-URLs hinzugefügt.
• Optionale Sprachkennzeichnungen nach BCP 47 hinzugefügt.
• Zustellwarteschlange mit Duplikatschutz und automatischen Wiederholungsversuchen hinzugefügt.
• Manuelle Veröffentlichung und sichere erneute Veröffentlichung gelöschter Bluesky-Beiträge hinzugefügt.
• Warteschlangenstatistiken, Zustellstatus und Wiederholungsfunktionen im ACP hinzugefügt.
• Sprachdateien für Englisch, Deutsch und Ukrainisch hinzugefügt.

Download

Bluesky für phpBB 1.0.0 herunterladen

Aktuelle Version: 1.0.0

Lizenz: GNU General Public License v2.0 only (GPL-2.0-only).