Zusammenfassung: Dieses Plugin integriert Rocket.Chat mit Discourse.
Sie benötigen eine separate gehostete Instanz von Rocket.Chat, beispielsweise bei Communiteq, Digital Ocean oder einem anderen Anbieter. Dieses Plugin integriert diese Instanz mit Ihrem Forum.
Die Integration besteht aus zwei Teilen:
- Einbettung des Chats in die Benutzeroberfläche von Discourse
- Single Sign-On zwischen Discourse und Rocket.Chat, wobei Discourse als Authentifizierungsanbieter fungiert, um Benutzer in Rocket.Chat zu authentifizieren, zu erstellen und zu aktualisieren.
GitHub: GitHub - communiteq/discourse-rocketchat · GitHub
Installation: Befolgen Sie den Installationsleitfaden für Plugins.
Credits: @jrgong hatte die großartige Idee, Rocket.Chat mit Discourse zu integrieren, und entwickelte auch eine erste Version der Benutzeroberfläche.
Screenshots
Der Chat ist in der unteren rechten Ecke der Discourse-Oberfläche eingebettet. Er kann durch Klicken auf die Titelleiste ein- und ausgeklappt werden. Der Chat bleibt geöffnet, wenn Sie im Forum navigieren.
Auf Mobilgeräten ist der Chat in Vollbildanzeige und über das Rocket.Chat-Symbol in der oberen Leiste zugänglich:
Konfiguration
Die Integration muss auf beiden Systemen konfiguriert werden. Discourse muss wissen, wo der Chat zu finden ist, um ihn in seine Benutzeroberfläche einzubinden, und Rocket.Chat muss wissen, wo Discourse zu finden ist, um authentifizieren zu können.
Seite Discourse
Admin - Plugins - Discourse RocketChat - Einstellungen
discourse_rocketchat_enabled
Aktivieren oder deaktivieren Sie das Plugin.
discourse rocketchat title
Konfigurieren Sie hier den Titel des Chatfensters, z. B. Chat.
discourse rocketchat host
Konfigurieren Sie hier den Hostnamen Ihrer RocketChat-Instanz, z. B. chat.example.com.
Fügen Sie kein https:// oder Ähnliches voran.
discourse rocketchat default channel
Konfigurieren Sie hier den Standardkanal, z. B. General.
discourse rocketchat min trust level
Konfigurieren Sie das minimale Vertrauensniveau für Ihre Benutzer, damit sie Rocket.Chat nutzen können, z. B. 2: member.
discourse rocketchat click entire bar
Aktivieren Sie diese Option, wenn die gesamte Titelleiste anklickbar sein soll, um den Chat zu erweitern oder auszublenden. Deaktivieren Sie diese Option, wenn nur der Text „Öffnen" und „Schließen" anklickbar sein soll.
discourse rocketchat show menu for groups
Konfigurieren Sie die Gruppen, für die Rocket.Chat sein Menü anzeigen soll, z. B. staff.
Seite Rocket.Chat
Administration - Einstellungen - CAS
Die Integration verwendet das CAS 2.0-Protokoll für Authentifizierung und Autorisierung.
Ersetzen Sie forum.example.com durch den Namen Ihres Forums.
- SSO Base URL:
https://forum.example.com/rocketchat - SSO Login URL:
https://forum.example.com/rocketchat/login - CAS Version: 2.0
- CAS-Benutzernamen vertrauen: aktiviert
- Benutzererstellung zulassen: aktiviert
- Aktiviert: aktiviert
Administration - Einstellungen - CAS - Attributbehandlung
Um die E-Mail-Adresse und den vollständigen Namen synchronisieren zu können, müssen wir konfigurieren, wo diese Attribute zu finden sind.
- Benutzerdaten immer synchronisieren: aktiviert
- Attributzuordnung:
{\"email\":\"%email%\", \"name\":\"%name%\"}
Administration - Einstellungen - Allgemein
Wir müssen in der Lage sein, Rocket.Chat in einem iFrame auszuführen.
- Zugriff innerhalb eines Iframes einschränken: deaktiviert
Administration - Einstellungen - Konten
Um die beiden Plattformen zu integrieren, muss Discourse die Kontrolle über die Anmeldung und Registrierung sowie über den vollständigen Namen, den Namen und die E-Mail-Adresse des Kontos haben. Sie müssen auf der Seite von Rocket.Chat die folgenden Einstellungen deaktivieren:
- Änderung des Benutzer-Avatars zulassen: deaktiviert
- Namensänderung zulassen: deaktiviert
- Benutzernameänderung zulassen: deaktiviert
- E-Mail-Änderung zulassen: deaktiviert
- Standard-Anmeldeformular anzeigen: deaktiviert
Administration - Einstellungen - Konten - Registrierung
- Registrierungsformular: deaktiviert
- Geheime URL des Registrierungsformulars: (ein zufälliger String)
Administration - Einstellungen - Konten - Avatar
Rocket.Chat kann die Avatare von Discourse verwenden.
Stellen Sie sicher, dass Sie forum.example.com durch den Namen Ihres Forums ersetzen.
- Externe URL des Avatar-Anbieters:
https://forum.example.com/rocketchat/avatar/{username}.png
