Blog

I plugin creati per Pusher ora si collegano a WordPlus Cloud

· Andrij Tkachenko · 3 min di lettura

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 e con connessioni illimitate secondo un uso corretto.

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.

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:

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 pagina API in tempo reale del tuo account 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 e i canali di cache non sono ancora supportati, e 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 l’API per sviluppatori

L’API compatibile con Pusher è per i plugin che esistono già. L’API per sviluppatori, che stiamo costruendo ora, è per il codice nuovo: il nostro SDK in tempo reale per qualsiasi plugin, tema o codice personalizzato. Condividerà con i nostri plugin l’unica connessione di una pagina, si collegherà direttamente ai nostri server e passerà a un altro server senza interruzioni quando uno si riavvia. Ne parleremo qui quando sarà pronta.

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.