Blog

Plugins für Pusher verbinden sich jetzt mit WordPlus Cloud

· Andrij Tkachenko · 3 Min. Lesezeit · Aktualisiert am

Drei App-Fenster, per Kabel mit einer blauen Cloud verbunden

Einige WordPress-Plugins bringen ihre Live-Funktionen über das Pusher-Channels-Protokoll: Benachrichtigungen, die ohne Neuladen erscheinen, Dashboards und Bestelllisten, die sich von selbst aktualisieren, Live-Kommentare und Chats. Ab heute spricht WordPlus Cloud dieses Protokoll ebenfalls. Diese Plugins können also auf derselben Cloud laufen wie unsere, über Ihr WordPlus-Cloud-Abonnement.

Was die Pusher-kompatible API ist

Die Pusher-kompatible API spricht Version 7 des Pusher-Channels-Protokolls, die aktuelle. Plugins für Pusher und die Client- und Server-Bibliotheken, die sie verwenden, verbinden sich unverändert mit der Cloud, ohne dass an ihrem Code etwas geändert wird. Sie tragen unsere Hosts und die Schlüssel Ihrer Website in ihre Einstellungen ein, und ihre Kanäle, Presence und Ereignisse laufen über die Cloud.

Jede Website in einem WordPlus-Cloud-Abonnement hat ihre eigene App-ID, ihren eigenen Schlüssel und ihr eigenes Secret, in Ihrem Konto unter Websites → Echtzeit-API-Schlüssel. Eine Website braucht dafür keines unserer Plugins: Fügen Sie sie unter Websites → Website hinzufügen hinzu.

Ein Plugin verbinden

Ein Plugin für Pusher kann sich verbinden, wenn Sie in seinen Einstellungen einen Host eintragen können. Füllen Sie sie so aus:

Einstellung Wert
WebSocket-Host ws.wordplus.cloud
HTTP-API-Host rest.wordplus.cloud
Port 443, mit TLS
App-ID, Schlüssel und Secret Die Ihrer Website, unter Websites → Echtzeit-API-Schlüssel
Cluster Ein beliebiger Wert, etwa mt1, falls das Plugin danach fragt

Der Cluster spielt keine Rolle, denn verwendet wird der Host. Ein Plugin, das nur nach einem Cluster fragt und kein Feld für einen Host hat, kann sich noch nicht verbinden: Bitten Sie die Entwickler des Plugins, eines hinzuzufügen. Für sie ist das eine kleine Änderung.

Ein Plugin mit nur einem Host-Feld bekommt ws.wordplus.cloud für beides, denn dieser Host beantwortet auch die HTTP-API.

Bewahren Sie das Secret auf Ihrem Server auf. Es signiert die Ereignisse, die Ihre Website sendet, und gehört deshalb nie in eine Seite.

In Ihrem eigenen Code

Ein Theme oder Ihr eigener Code verbindet sich genauso. Im Browser:

JavaScript
const pusher = new Pusher('YOUR_KEY', {
  cluster: 'mt1',
  wsHost: 'ws.wordplus.cloud',
  wsPort: 443,
  wssPort: 443,
  forceTLS: true,
  enabledTransports: ['ws', 'wss'],
});

pusher.subscribe('orders').bind('new-order', (order) => {
  showOrder(order);
});

Ihr Server sendet Ereignisse über den HTTP-API-Host rest.wordplus.cloud, mit der App-ID, dem Schlüssel und dem Secret der Website. Die Dokumentation der Pusher-kompatiblen API enthält diese Einstellungen, mit Beispielen für Laravel, Laravel Echo, PHP und Node.js.

Was unterstützt wird

  • Öffentliche, private, Presence- und verschlüsselte Kanäle
  • Client-Ereignisse in privaten und Presence-Kanälen, bis zu 10 pro Sekunde und Verbindung
  • Benutzeranmeldung und Ereignisse an einen Benutzer
  • Die HTTP-API: ein Ereignis an bis zu 100 Kanäle zugleich, Stapel von bis zu 10 Ereignissen, Kanäle und ihre Benutzer sowie das Schließen der Verbindungen eines Benutzers
  • Ereignisse bis 10 KB

Webhooks werden noch nicht unterstützt, und ein Cache-Kanal sendet sein letztes Ereignis noch nicht erneut: Er meldet immer, dass nichts zwischengespeichert ist. Verbindungen laufen nur über WebSocket, ohne HTTP-Ausweichweg.

Neben unseren eigenen Plugins

WordPlus-Plugins verwenden diese API nicht. Sie sprechen mit der Cloud über unsere eigenen Protokolle, gemacht für das, was sie tun, etwa Nachrichten, Anrufe und Livestreams, und teilen sich eine Verbindung pro Seite. Ein Plugin für Pusher öffnet seine eigene Verbindung daneben, und beide laufen über dasselbe Abonnement.

Und unsere Echtzeit-SDKs

Die Pusher-kompatible API ist für Plugins, die es schon gibt. Für neuen Code gibt es unsere Echtzeit-SDKs: Räume, Präsenz, Anrufe und Gruppenanrufe für jedes Plugin, jedes Theme und eigenen Code auf WordPress, und für Ihre eigenen Apps auf anderen Stacks. Sie teilen sich die eine Verbindung einer Seite mit unseren Plugins, verbinden sich direkt mit unseren Servern und wechseln ohne Unterbrechung zu einem anderen Server, wenn einer neu startet. WordPlus Cloud for WordPress und WordPlus Cloud for Apps zeigen, was sie können. Unsere Seite zur WebSocket-API zeigt Räume, Präsenz und Ereignisse in jedem Stack.

So legen Sie los

  1. Abonnieren Sie WordPlus Cloud für Ihre Website auf der Seite Preise.
  2. Öffnen Sie in Ihrem Konto Websites → Echtzeit-API-Schlüssel und kopieren Sie App-ID, Schlüssel und Secret der Website.
  3. Tragen Sie sie zusammen mit unseren Hosts in die Einstellungen des Plugins ein.

Wenn sich ein Plugin nicht verbindet oder wir uns eines ansehen sollen, bevor Sie abonnieren, schreiben Sie uns an support@wordplus.cloud.