Blog

I plugin creati per Pusher ora si collegano a WordPlus Cloud

· Andrij Tkachenko · 3 min di lettura · Aggiornato:

Tre finestre di app collegate con dei cavi a una nuvola blu

Alcuni plugin per WordPress aggiungono le loro funzioni dal vivo tramite il protocollo Pusher Channels: notifiche che compaiono senza ricaricare, dashboard ed elenchi di ordini che si aggiornano da soli, commenti e chat dal vivo. Da oggi anche WordPlus Cloud parla questo protocollo, quindi quei plugin possono girare sullo stesso cloud dei nostri, con il tuo abbonamento a WordPlus Cloud.

Che cos’è l’API compatibile con Pusher

L’API compatibile con Pusher parla la versione 7 del protocollo Pusher Channels, quella attuale. I plugin creati per Pusher, e le librerie client e server che usano, si collegano al cloud così come sono, senza cambiare nulla nel loro codice. Inserisci i nostri host e le chiavi del tuo sito nelle loro impostazioni, e i loro canali, la presenza e gli eventi girano sul cloud.

Ogni sito di un abbonamento a WordPlus Cloud ha il suo ID app, la sua chiave e la sua chiave segreta, nel tuo account in Siti → Chiavi API in tempo reale. Un sito non ha bisogno di nessuno dei nostri plugin per averle: aggiungilo in Siti → Aggiungi sito.

Collegare un plugin

Un plugin creato per Pusher può collegarsi quando le sue impostazioni ti lasciano inserire un host. Compilale così:

Impostazione Valore
Host WebSocket ws.wordplus.cloud
Host API HTTP rest.wordplus.cloud
Porta 443, con TLS attivo
ID app, chiave e chiave segreta Quelli del tuo sito, in Siti → Chiavi API in tempo reale
Cluster Un valore qualsiasi, come mt1, se il plugin lo chiede

Il cluster non cambia nulla, perché si usa l’host. Un plugin che chiede solo un cluster, senza un campo per l’host, non può ancora collegarsi: chiedi ai suoi sviluppatori di aggiungerne uno, una piccola modifica da parte loro.

Un plugin con un solo campo per l’host usa ws.wordplus.cloud per entrambi, perché risponde anche all’API HTTP.

Tieni la chiave segreta sul tuo server. Firma gli eventi che il tuo sito invia, quindi non va mai messa in una pagina.

Nel tuo codice

Un tema o il tuo codice si collegano allo stesso modo. Nel 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);
});

Il tuo server invia gli eventi tramite l’host API HTTP, rest.wordplus.cloud, con l’ID app, la chiave e la chiave segreta del sito. La documentazione dell’API compatibile con Pusher riporta queste impostazioni, con esempi per Laravel, Laravel Echo, PHP e Node.js.

Cosa è supportato

  • Canali pubblici, privati, di presenza e cifrati
  • Eventi client sui canali privati e di presenza, fino a 10 al secondo per connessione
  • Accesso degli utenti ed eventi inviati a un utente
  • L’API HTTP: un evento fino a 100 canali alla volta, gruppi fino a 10 eventi, i canali e i loro utenti, e la chiusura delle connessioni di un utente
  • Eventi fino a 10 KB

I webhook non sono ancora supportati, e un canale di cache non reinvia ancora il suo ultimo evento: segnala sempre che non c’è nulla in cache. Le connessioni usano solo WebSocket, senza ripiego HTTP.

Accanto ai nostri plugin

I plugin WordPlus non usano questa API. Parlano con il cloud tramite i nostri protocolli, pensati per quello che fanno, come messaggi, chiamate e dirette, e condividono una sola connessione per pagina. Un plugin creato per Pusher apre la sua connessione accanto alla loro, e tutti girano sullo stesso abbonamento.

E i nostri SDK in tempo reale

L’API compatibile con Pusher è per i plugin che esistono già. Per il codice nuovo ci sono i nostri SDK in tempo reale: stanze, presenza, chiamate e chiamate di gruppo per qualsiasi plugin, tema o codice personalizzato su WordPress, e per le tue app su altri stack. Condividono con i nostri plugin l’unica connessione di una pagina, si collegano direttamente ai nostri server e passano a un altro server senza interruzioni quando uno si riavvia. WordPlus Cloud for WordPress e WordPlus Cloud for Apps mostrano cosa fanno. La nostra pagina sull’API WebSocket mostra stanze, presenza ed eventi in ogni stack.

Per iniziare

  1. Abbonati a WordPlus Cloud per il tuo sito dalla pagina Prezzi.
  2. Nel tuo account, apri Siti → Chiavi API in tempo reale e copia l’ID app, la chiave e la chiave segreta del sito.
  3. Inseriscili, insieme ai nostri host, nelle impostazioni del plugin.

Se un plugin non si collega, o vuoi che ne guardiamo uno prima di abbonarti, scrivici a support@wordplus.cloud.