Jeśli z jakiegoś powodu chcesz aby WordPress wysyłał wiadomości email za pośrednictwem poczty Gmail (w tym także gdy masz płatną usługę dla poczty w ramach Google Workspace), najlepszym rozwiązaniem jest integracja za pośrednictwem interfejsu Gmail API w Google Cloud.

Do tego celu wykorzystamy wtyczkę Fluent SMTP dla WordPressa, o której już pisaliśmy w kontekście konfiguracji wysyłki poczty na protokole SMTP z wykorzystaniem konta pocztowego utworzonego na DiDHost. Zerknij na tekst: „Jak skonfigurować wysyłkę poczty na protokole SMTP„.

Konfiguracja wysyłki poczty przez Gmail lub Google Workspace #

Niestety w przypadku Gmaila konfiguracja wysyłki emaili z WordPressa jest bardziej złożona. Wiele osób ma duże trudności z poprawną integracją, ale dobra wiadomość jest taka, że jeśli wykonasz poniżej opisane czynności krok po kroku, zrobisz to i będziesz z siebie dumny 🙂 Zaczynamy!

Zakładam, że masz już zainstalowaną wtyczkę Fluent SMTP, jeśli nie zrób to.

Po instalacji wtyczki przejdź do jej konfiguracji (Ustawienia > FluentSMTP > Settings), co poskutkuje wyświetleniem się ekranu z widokiem jak poniżej i wybierz kafelek Google Workspace:

Powinieneś zobaczyć formularz konfiguracji połączenia, który wygląda jak ten poniżej:

W pierwszej sekcji Sender Settings wpisz swój adres Gmail za pośrednictwem którego będzie wysyłana poczta, a w polu obok dowolną nazwę. Tak będziesz przedstawiany jako nadawca, może to być Twoje imię, nazwisko, nazwa firmy… co uznasz za stosowne.

Musimy jednak wypełnić także drugą sekcję o nazwie Gmail/Google Wordkspace API Settings. Trzeba tu wprowadzić identyfikator klienta i tajny klucz klienta, ale skąd wziąć te dane? Tu zaczynają się schody, które jednak za chwilę pokonasz 🙂

Generujemy ID klienta i Tajny klucz klienta w Aplikacji Google Cloud #

Te dane są niezbędne do tego aby przejść do kolejnego kroku konfiguracji wysyłki! Zrób więc pierwszy krok i otwórz stronę Google Cloud.

Jeśli jesteś w tym miejscu po raz pierwszy prawdopodobnie pojawi się popup z prośbą o wyrażenie zgody na warunki usługi i opcjonalnie na powiadomienia email. Tego drugiego nie musisz zaznaczać jeśli nie chcesz. Ostatecznie kliknij w przycisk u dołu: Zgadzam się i chcę przejść dalej.

Tworzymy nowy Projekt #

Gdy już zaakceptujesz warunki korzystania z usług, kolejnym krokiem jest utworzenie projektu. Zakładam, że nie masz jeszcze żadnego, dlatego aby utworzyć pierwszy kliknij na górnym pasku tuż obok logo Google Cloud w rozwijaną listę „Wybierz projekt„. Spowoduje to wywołanie okna modalnego z listą projektów. Jako, że tworzymy nowy kliknij w przycisk NOWY PROJEKT widoczny poniżej po prawej stronie.

Następnie wpisz nazwę projektu (jaką chcesz) i kliknij w przycisk UTWÓRZ.

Aktywujemy Gmail API #

Po utworzeniu projektu zostaniemy automatycznie przekierowani na stronę z informacjami na jego temat. Teraz musimy aktywować Gmail API. Aby to zrobić kliknij w ikonkę hamburgera po lewej stronie logo Google Cloud, następnie przejdź do Interfejsów API i kliknij w link Włączone interfejsy API i usługi. Całość zaprezentowana jest na poniższym obrazku:

Jeśli pojawi się prośba o wybór projektu, kliknij na nim. Ważne jest to abyśmy pracowali w ramach utworzonego wcześniej projektu.

Kolejnym krokiem będzie kliknięcie w przycisk WŁĄCZ INTERFEJSY API I USŁUGI widoczny z prawej strony. Zauważ także, że informacja po prawej stronie logotypu informuje Cię w ramach którego projektu aktywujemy interfejs API.

Odszukaj Gmail API korzystając np. w wyszukiwarki u góry i kliknij na znalezionej ikonie interfejsu:

Na kolejnej stronie kliknij w przycisk WŁĄCZ aby aktywować interfejs:

Zostaniesz automatycznie przekierowany na stronę interfejsu Gmail API. Ufff sporo już za nami, ale to jeszcze nie koniec. Kliknij w przycisk znajdujący się z prawej strony UTWÓRZ DANE LOGOWANIA.

Uruchomisz w ten sposób proces tworzenia danych niezbędnych do logowania składający się z 5 kroków.

Krok 1 – Typ danych logowania #

W tym kroku powinien być wybrany z listy rozwijanej Gmail API, a poniżej zaznacz opcję Dane użytkownika i kliknij w przycisk DALEJ.

Krok 2 – Ekran zgody OAuth #

Wpisz nazwę aplikacji (jaką chcesz), wybierz adres email dla użytkowników potrzebujących wsparcia, logo możesz sobie odpuścić, chyba że chcesz je dodać, a na końcu wpisz swój email do kontaktów ze strony Google Cloud. Na koniec kliknij w przycisk ZAPISZ I KONTYNUUJ.

Krok 3 – Zakresy #

Możesz je pominąć, ponieważ Fluent SMTP ich nie wykorzystuje. Po prostu przejdź do kolejnego kroku.

Krok 4 – Identyfikator Klienta OAuth #

Wybierz z listy rozwijanej typ aplikacji jako: Aplikacja internetowa
Wpisz nazwę klienta (dowolna, służy do identyfikacji), ja jak widzisz poniżej wpisałem nazwę wtyczki 🙂
Następnie przewiń stronę nieco w dół i kliknij w przycisk DODAJ URI w sekcji Autoryzowane identyfikatory URI przekierowania.

W polu jakie się pojawi wprowadź adres URL widoczny na stronie konfiguracji połączenia wtyczki. Gdzie to jest dokładnie? Przełącz się do zakładki swojej przeglądarki z ustawieniami wtyczki Fluent SMTP i odszukaj jak poniżej:

Standardowo jest to https://fluentsmtp.com/gapi/
Wprowadź ten adres, a na koniec kliknij w przycisk UTWÓRZ.

Krok 5 – Twoje dane logowania #

W tym kroku nie musisz w zasadzie niczego robić, nie jest nawet konieczne pobranie pliku z danymi ani ich kopiowanie. To co potrzebne do konfiguracji wtyczki znajdziemy w kolejnym etapie. Kliknij więc w przycisk GOTOWE.

Publikacja Aplikacji #

Teraz musimy opublikować naszą aplikację ponieważ bez tego nie uda nam się niczego wysłać z WordPressa. Ay to zrobić kliknij w lewym bocznym menu na link Ekran Zgody OAuth, a następnie kliknij w przycisk OPUBLIKUJ APLIKACJĘ.

Pojawi się okienko z pytaniem czy na pewno chcemy przenieść aplikację do środowiska produkcyjnego. Oczywiście potwierdzamy 🙂

Dane uwierzytelniające #

W końcu dotarliśmy do momentu kiedy będziemy mogli skopiować i wkleić dane uwierzytelniające w ustawieniach wtyczki Fluent SMTP 🙂 Z lewego menu wybierz opcję Dane logowania. Następnie kliknij w ikonkę ołówka jak zaznaczono poniżej:

Zobaczysz szczegóły, a z prawej strony dane jakie należy wprowadzić w ustawieniach wtyczki Fluent SMTP. Zaznaczone są w ramkach poniżej:

Mamy więc Identyfikator klienta i Tajny klucz klienta.

Kontynuujemy konfigurację po stronie wtyczki Fluent SMTP #

Skopiuj Identyfikator klienta i wklej go do pola Application Client ID
Skopiuj Tajny klucz klienta i wklej go do pola Application Client Secret

Kliknij teraz w duży czerwony przycisk Authenticate wita Google & GetAccess Token, aby finalnie wygenerować token potrzebny do zakończenia konfiguracji.

Generujemy token #

Po kliknięciu w opisany powyżej przycisk pojawi się strona Google z prośbą o wybranie konta dla którego będziemy generowali token. Wybierz konto przez które ma być wysyłana poczta. Następnie pojawi się monit z prośbą zezwolenie aplikacji na dostęp do Gmaila. Kliknij w przycisk Dalej.

Zostaniesz przekierowany na stronę Fluent SMTP skąd skopiuj swój token. Wystarczy, że klikniesz w przycisk Copy jak poniżej.

Ostateczna aktywacja #

Teraz przełącz się na kartę w swojej przeglądarce gdzie otwarta jest strona z ustawieniami wtyczki Fluent SMTP. Zwróć uwagę, że pojawiło się dodatkowe pole, w którym musisz teraz wkleić skopiowany token.

Zapisz zmiany! Ufffff udało się! Powinieneś zobaczyć swoje połączenie w karcie Settings:

Test wysyłki #

Konfiguracja została przeprowadzona, ale czy nie popełniliśmy żadnego błędu? Czy poczta faktycznie będzie wysyłana przez konto na Gmail? Żeby się upewnić musimy wykonać test. W tym celu kliknij w górnym menu wtyczki w zakładkę Email Test. Jest widoczna jako druga na obrazku powyżej.

Następnie wpisz w polu odbiorcy (Sent To) dowolny adres email odbiorcy na który chcesz wysłać test. Potem kliknij w przycisk Send Test Email.

Jeśli pojawi się komunikat o tym, że wysyłka się powiodła masz pewność, że nie popełniłeś żadnego błędu i od teraz możesz wysyłać maile z WordPressa przez swoje konto na Gmailu 🙂 Dobra robota !

Oczywiście pod komunikatem nie musisz wpisywać swojego imienia ani maila 🙂 To tylko formularz zapisu na listę subskrybentów wtyczki Fluent SMTP.