Nowy plugin dla Grav-a - Powiadomienia Web Push za pomocą serwisu OneSignal !

Powiadomienia Web Push to plugin dla Grav CMS oparty o technologię OneSignal. Powiadomienia Web Push to krótkie wiadomości, które przychodzą ze strony internetowej. Wyświetlają się one na pulpicie Twojego komputera, ekranie komórki i dostaniesz je nawet wtedy jeśli Twoje urządzenie jest wyłączone lub okno przeglądarki zamknięte. Wtedy wiadomość dojdzie jak tylko twoje urządzenie lub przeglądarka się uaktywni. To nowe narzędzie marketingowe, które pozwala zwiększyć zaangażowanie odwiedzających na Twojej stronie. Proces zachodzi bez pobierania jakichkolwiek informacji o użytkowniku jak email lub inne informacje kontaktowe. Dodatkowo, telefony z systemem Android, pozwalają wyświetlać powiadomienia na równi z powiadomieniami systemowymi !! Ta wtyczka pozwala wysyłać powiadomienia o nowych stronach dodanych do twojego serwisu opartego na Grav-ie.

Kilka wyjątkowych zalet powiadomień obsługiwanych przez OneSignal

• Wsparcie - Chrome (Komputer & Android), Safari (Mac OS X), Microsoft Edge (Komputer & Android), Opera (Komputer & Android) i Firefox (Komputer & Android) poprzez protokoły HTTP i HTTPS.
• Automatyczne Powiadomienia - wysyłaj powiadomienia swoim odwiedzającym jak tylko dodasz nową stronę do Grav-a.
• Selekcja segmentów - wysyłaj powiadomienia bazujące na języku odwiedzającego, liczbie odwiedzin Twojego bloga lub ustaw specjalne kryteria. (chwilowo dostępne tylko poprzez panel OneSignal)
• Różne sposoby zapisywania - zdecyduj jak i kiedy ma pojawiać się okienko zapraszające do włączenia powiadomień.
• Statystyki w czasie rzeczywistym - możesz śledzić w czasie rzeczywistym skuteczność powiadomień i rekacje użytkowników.
• Testowanie A/B - możesz sprawdzić które wiadomości są skuteczniejsze na małej grupie użytkowników zanim roześlesz wiadomość do całej społeczności.
• Zaplanuj powiadomienia - zaplanuj kiedy roześlesz powiadomienia. Możesz ustawić rozsyłanie bazujące na strefie czasowej subskrybenta lub nawet na czasie kiedy ostatnio odwiedził Twoją witrynę. (chwilowo dostępne tylko poprzez panel OneSignal)
• Wszystko za darmo. Brak opłat i ograniczeń.

Dlaczego powinieneś używać powiadomień Web Push - jakie są zalety ?

• Zasięg - Chrome, Firefox i Safari mają razem 75% rynku. To znaczy że implementując powiadomienia Web Push celujesz w potencjalną grupę biliona użytkowników.
• Nie potrzebujesz aplikacji na Androida - powiadomienia WebPush działają natywnie na telefonach z systemem Android. Nie ma potrzeby aby instalować dodatkowe aplikacje.
• Dostęp do użytkowników którzy nie są aktualnie obecni na Twojej stronie - powiadomienia działają podobnie jak poczta email. Nawet jak odbiorca nie jest online, to otrzyma powiadomienie jak włączy przeglądarkę.
• Budowanie zaangażowania bez prywatnych danych osobowych - powiadomienia Web Push nie wymagają żadnych danych prywatnych od Twoich użytkowników.
• Wysoki wskaźnik aktywacji powiadomień - o wiele łatwiej zapisać się na powiadomienia Web Push niż np. zasubskrybować newsletter.
• Niski wskaźnik deaktywacji powiadomień - badania pokazały że współczynnik deaktywacji powiadomień w ciągu roku wynosi mniej niż 10%.
• Gwarantowana pewność dostarczenia powiadomienia - poczta email czasami utknie w spamie, zaginie na serwerze. Przy okazji powiadomień Web Push gwarancja że odbiorca otrzyma powiadomienie jest prawie stuprocentowa.
• Wyższy współczynnik konwersji - badania pokazały że współczynnik konwersji jest aż o 30% lepszy niż w przypadku wiadomości e-mail.

Pobieranie

Aby pobrać powiadomienia Web Push dla Grav-a, udaj się do na stronę repozytorium:https://github.com/devlom/grav-plugin-webpush/releases/latest i pobierz ostatni pakiet z kodem źródłowym.

Instalacja

IInstalacja powiadomień Web Push dla Grav-a składa się z kilku prostych kroków. Przejrzyj dokładnie każdą część. Cała instalacja może trochę odbiegać od typowej instalacji wtyczki dla cms-a Grav, jednak jest typowa dla aplikacji opartych o service workers.

Rejestracja konta na stronie OneSignal.

Pierwszym kookier jest wykonanie rejestracji na portal OneSignal. Po rejestracji kliknij w przycisk "Add App" w panelu użytkownika. W kolejnym kroku wybierz “Web Push”.

Jako integracja wybierz "Custom Code" (ważne):

To wszystko. Dokończ konfigurację wszystkich wymaganych pól (adres www, ikona, wsparcie dla Safari i wciśnij “Save”.).

Pobierz wymagane pliki OneSignal SDK

To jest BARDZO WAŻNY krok. Musisz pobrać pliki OneSignal SDK umieścić je w katalogu głównym domeny.

Przykład. Twoja instalacja Grav-a jest umieszczona pod adresem https://twojadomena.com. Musisz rozpakować pliki i wgrać je na serwer tak żeby można było się do nich dostać wpisując:

https://twojadomena.com/OneSignalSDKWorker.js
https://twojadomena.com/OneSignalSDKUpdaterWorker.js

Prosimy o nie zgłaszanie żadnych błędów, jeśli wspomniane pliki nie znajdą się w domenie głównej Twojej witryny.

To samo dotyczy subdomen, np. https://subdomena.twojadomena.com. Pliki muszą być załadowane do katalogu głównego subdomeny, czyli:

https://subdomena.twojadomena.com/OneSignalSDKWorker.js
https://subdomena.twojadomena.com/OneSignalSDKUpdaterWorker.js

Podkatalogi ? Podobna zasada. Pliki muszą się znajdować w katalogu głównym twojej domeny (strony). Dlatego jeśli masz instalację Grav-a np. https://twojadomena.com/grav , wtedy pliki muszą być poziom wyżej czyli:

https://twojadomena.com/OneSignalSDKWorker.js
https://twojadomena.com/OneSignalSDKUpdaterWorker.js

Nie pytajcie czemu tak się dzieje :). Tak działa nowa technologia od Google :) Jeśli kiedykolwiek mieliście do czynienia z Progressive Web Apps to pewnie temat jest Ci znany. Następnie kontynuuj standardową instalację Grav.

Instalacja wtyczki w Grav-ie (Metoda 1 - Ręczna)

W celu zainstalowanie wtyczki, pobierz spakowaną wersję repozytorium i wypakuj ją do /twoja/strona/grav/user/plugins. Po wykonaniu tej operacji, zmień nazwę folderu na webpush. Wszystkie pliki możesz znaleźć w serwisie GitHub lub na stronie z wtyczkami GetGrav.org.

Powinieneś mieć teraz wszystkie pliki w takiej postaci:

/twoja/strona/grav/user/plugins/webpush

Adnotacja: Ta wtyczka jest częścią rdzenia Grav i wymaga wtyczek Error i Problems do działania.

Instalacja wtyczki w Grav-ie (Metoda 2 - Repozytorium Wtyczek)

Wtyczkę można zainstalować wtyczkę za pomocą narzędzia Grav Package Manager (GPM)

Używając terminala (w systemie Windows - command line), przejdź do katalogu głównego instalacji Grav i wykonaj następujące polecenie:

bin/gpm install webpush

Ta komenda zainstaluje Powiadomienia Web Push dla Grav-a w katalogu /user/plugins. Wszystkie pliki znajdziesz w katalogu /twoja/strona/grav/user/plugins/webpush.

Instalacja wtyczki w Grav-ie (Metoda 3 - Panel Administracyjny)

Wtyczkę można zainstalować za pomocą Panelu Administracyjnego w Grav-ie przechodząc do sekcji “Wtyczki” i klikając “Dodaj”.

Konfiguracja

Zanim skonfigurujesz wtyczkę, najlepiej będzie jak skopiujesz user/plugins/webpush/webpush.yaml do user/config/plugins/webpush.yaml i będziesz edytować tylko tą kopię. Plugin posiada ponad 50 różnych opcji konfiguracyjnych. Nie starczyłoby internetu aby wszystko dokładnie opisać :)

Pamiętaj że jeśli zmienisz opcje w panelu administracyjnym, wszystkie parametry zapiszą się w katalogu user/config/plugins/ ,w pliku webpush.yaml.

Jak używać ?

Pamiętaj, że zawsze możesz użyć rozbudowanego panelu na stronie onesignal.com, ale mamy trochę lepszy pomysł. Jeśli otworzysz stronę do edycji, to zauważysz że pojawiła się tam nowa zakładka Web Push:

W tej zakładce masz już wstępnie wypełnione dane do Twojego powiadomienia. Wystarczy że je ewentualnie dopracujesz, zaznaczysz pole wyboru “Send Notification” i wciśniesz “Zapisz”. Powiadomienie Web Push zostanie wysłane. Czyż nie jest to proste ? :)

Podziękowania

OneSignal - Wtyczka na Wordpressa https://wordpress.org/plugins/onesignal-free-web-push-notifications/

Do zrobienia

• [ ] Dodanie wsparcia dla wielojęzycznycj powiadomień

Licencja

Licencja (MIT)

Niniejszym gwarantuje się, bez opłat, że każda osoba która wejdzie w posiadanie kopii tego oprogramowania i związanych z nim plików dokumentacji (dalej „Oprogramowanie”) może wprowadzać do obrotu Oprogramowanie bez żadnych ograniczeń, w tym bez ograniczeń prawa do użytkowania, kopiowania, modyfikowania, łączenia, publikowania, dystrybuowania, sublicencjonowania i/lub sprzedaży kopii Oprogramowania a także zezwalania osobie, której Oprogramowanie zostało dostarczone czynienia tego samego, z zastrzeŜeniem następujących warunków:

Powyższa nota zastrzegająca prawa autorskie oraz niniejsza nota zezwalająca muszą zostać włączone do wszystkich kopii lub istotnych części Oprogramowania. OPROGRAMOWANIE JEST DOSTARCZONE TAKIM, JAKIE JEST, BEZ JAKIEJKOLWIEK GWARANCJI, WYRAŹNEJ LUB DOROZUMIANEJ, NIE WYŁĄCZAJĄC GWARANCJI PRZYDATNOŚCI HANDLOWEJ LUB PRZYDATNOŚCI DO OKREŚLONYCH CELÓW A TAKŻE BRAKU WAD PRAWNYCH. W ŻADNYM PRZYPADKU TWÓRCA LUB POSIADACZ PRAW AUTORSKICH NIE MOŻE PONOSIĆ ODPOWIEDZIALNOŚCI Z TYTUŁU ROSZCZEŃ LUB WYRZĄDZONEJ SZKODY A TAKŻE ŻADNEJ INNEJ ODPOWIEDZIALNOŚCI CZY TO WYNIKAJĄCEJ Z UMOWY, DELIKTU, CZY JAKIEJKOLWIEK INNEJ PODSTAWY POWSTAŁEJ W ZWIĄZKU Z OPROGRAMOWANIEM LUB UśYTKOWANIEM GO LUB WPROWADZANIEM GO DO OBROTU.