Blog

Plugins für Pusher verbinden sich jetzt mit WordPlus Cloud

· Andrij Tkachenko · 3 Min. Lesezeit

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 und mit unbegrenzten Verbindungen im Rahmen der fairen Nutzung.

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.

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:

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 Seite Echtzeit-API in Ihrem Konto 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 und Cache-Kanäle werden noch nicht unterstützt, und 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 die Entwickler-API

Die Pusher-kompatible API ist für Plugins, die es schon gibt. Die Entwickler-API, an der wir gerade arbeiten, ist für neuen Code: unser Echtzeit-SDK für jedes Plugin, jedes Theme und eigenen Code. Es wird sich die eine Verbindung einer Seite mit unseren Plugins teilen, sich direkt mit unseren Servern verbinden und ohne Unterbrechung zu einem anderen Server wechseln, wenn einer neu startet. Wir berichten hier darüber, sobald es so weit ist.

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.