Blog

Wtyczki stworzone dla Pusher łączą się teraz z WordPlus Cloud

· Andrij Tkachenko · 3 min czytania

Trzy okna aplikacji podłączone kablami do niebieskiej chmury

Niektóre wtyczki WordPress dodają swoje funkcje na żywo przez protokół Pusher Channels: powiadomienia, które pojawiają się bez przeładowania strony, panele i listy zamówień, które aktualizują się same, komentarze i czaty na żywo. Od dziś WordPlus Cloud również obsługuje ten protokół, więc te wtyczki mogą działać w tej samej chmurze co nasze, w ramach Twojej subskrypcji WordPlus Cloud i z nieograniczoną liczbą połączeń w ramach uczciwego korzystania.

Czym jest API zgodne z Pusher

API zgodne z Pusher obsługuje wersję 7 protokołu Pusher Channels, czyli obecną. Wtyczki stworzone dla Pusher oraz biblioteki klienckie i serwerowe, z których korzystają, łączą się z chmurą bez zmian, bez poprawiania ich kodu. Wpisujesz nasze hosty i klucze swojej witryny w ich ustawieniach, a ich kanały, obecność i zdarzenia działają w chmurze.

Każda witryna w subskrypcji WordPlus Cloud ma własne ID aplikacji, klucz i sekret, na Twoim koncie w Witryny → Klucze API czasu rzeczywistego. Witryna nie potrzebuje do tego żadnej z naszych wtyczek: dodaj ją w Witryny → Dodaj witrynę.

Podłączanie wtyczki

Wtyczka stworzona dla Pusher może się połączyć, gdy jej ustawienia pozwalają wpisać host. Wypełnij je tak:

Ustawienie Wartość
Host WebSocket ws.wordplus.cloud
Host HTTP API rest.wordplus.cloud
Port 443, z włączonym TLS
ID aplikacji, klucz i sekret Te Twojej witryny, z Witryny → Klucze API czasu rzeczywistego
Klaster Dowolna wartość, np. mt1, jeśli wtyczka o nią prosi

Klaster nie ma znaczenia, bo używany jest host. Wtyczka, która prosi tylko o klaster i nie ma pola na host, nie może się jeszcze połączyć: poproś jej twórców o dodanie takiego pola, to dla nich niewielka zmiana.

Trzymaj sekret na swoim serwerze. Podpisuje on zdarzenia wysyłane przez Twoją witrynę, więc nigdy nie powinien trafić na stronę.

We własnym kodzie

Motyw lub Twój własny kod łączy się w ten sam sposób. W przeglądarce:

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);
});

Twój serwer wysyła zdarzenia przez host HTTP API, rest.wordplus.cloud, z ID aplikacji, kluczem i sekretem witryny. Strona API czasu rzeczywistego na Twoim koncie zawiera te ustawienia oraz przykłady dla Laravel, Laravel Echo, PHP i Node.js.

Co jest obsługiwane

  • Kanały publiczne, prywatne, obecności i szyfrowane
  • Zdarzenia klienta na kanałach prywatnych i obecności, do 10 na sekundę na połączenie
  • Logowanie użytkowników i zdarzenia wysyłane do użytkownika
  • HTTP API: zdarzenie do maksymalnie 100 kanałów naraz, paczki do 10 zdarzeń, kanały i ich użytkownicy oraz zamykanie połączeń użytkownika
  • Zdarzenia do 10 KB

Webhooki i kanały z pamięcią podręczną nie są jeszcze obsługiwane, a połączenia działają tylko przez WebSocket, bez zapasowego HTTP.

Obok naszych wtyczek

Wtyczki WordPlus nie korzystają z tego API. Rozmawiają z chmurą przez nasze własne protokoły, stworzone do tego, co robią, takie jak wiadomości, połączenia i transmisje na żywo, i dzielą jedno połączenie na stronę. Wtyczka stworzona dla Pusher otwiera własne połączenie obok nich, a wszystkie działają w ramach tej samej subskrypcji.

A API dla deweloperów

API zgodne z Pusher jest dla wtyczek, które już istnieją. API dla deweloperów, nad którym teraz pracujemy, jest dla nowego kodu: to nasze SDK czasu rzeczywistego dla każdej wtyczki, motywu i własnego kodu. Będzie dzielić z naszymi wtyczkami jedno połączenie strony, łączyć się bezpośrednio z naszymi serwerami i bez przerwy przechodzić na inny serwer, gdy któryś się restartuje. Napiszemy o nim tutaj, gdy będzie gotowe.

Jak zacząć

  1. Wykup subskrypcję WordPlus Cloud dla swojej witryny na stronie Cennik.
  2. Na swoim koncie otwórz Witryny → Klucze API czasu rzeczywistego i skopiuj ID aplikacji, klucz i sekret witryny.
  3. Wpisz je, razem z naszymi hostami, w ustawieniach wtyczki.

Jeśli wtyczka się nie łączy albo chcesz, żebyśmy obejrzeli jakąś przed wykupieniem subskrypcji, napisz do nas na support@wordplus.cloud.