WordPress

Dwa podejścia do integracji

Ten tutorial przedstawia dwa różne podejścia do integracji WordPress z Easytools:

1. Część 1: Podejście z automatyzacjami - Wykorzystuje automatyzacje Easytools do tworzenia użytkowników WordPress oraz wtyczkę Simple Restrict do podstawowej kontroli dostępu.
2. Część 2: Podejście z webhookami - Wykorzystuje dedykowaną wtyczkę WordPress, która odbiera webhooki z Easytools do zaawansowanego zarządzania subskrypcjami.

Wybierz podejście, które najlepiej odpowiada Twoim potrzebom. Oba filmy pokazują kompletne przepływy pracy od konfiguracji do testowania.

Część 1: Podejście z automatyzacjami i wtyczką Simple Restrict

W tym pierwszym podejściu używamy automatyzacji Easytools do automatycznego tworzenia kont użytkowników WordPress, gdy klienci kupują Twój produkt. Następnie używamy wtyczki Simple Restrict do kontroli, które strony wymagają aktywnej subskrypcji.

[fs-toc-omit]Wymagania wstępne

Zanim zaczniesz, upewnij się, że Twoja strona WordPress spełnia następujące wymagania:‍

• ‍Certyfikat SSL: Twoja strona WordPress musi mieć aktywny certyfikat SSL (URL zaczyna się od https://).
• ‍Permalinki: Przejdź do Ustawienia → Bezpośrednie odnośniki w WordPress. Struktura nie może być ustawiona na "Prosty". Użyj "Nazwa wpisu" lub dowolnej niestandardowej struktury.‍
• Dostęp administratora: Potrzebujesz dostępu na poziomie administratora, aby generować hasła aplikacji i instalować wtyczki.

[fs-toc-omit]Krok 1: Wygeneruj hasło aplikacji WordPress

Hasła aplikacji pozwalają zewnętrznym usługom, takim jak Easytools, bezpiecznie łączyć się z Twoją stroną WordPress bez używania głównego hasła logowania.

1. Zaloguj się do panelu administratora WordPress
2. Przejdź do Użytkownicy → Profil (lub edytuj swoje konto Administratora)
3. Przewiń w dół do sekcji Hasła aplikacji
4. W polu "Nazwa nowego hasła aplikacji" wpisz nazwę, np. Easytools
5. Kliknij Dodaj nowe hasło aplikacji
6. Ważne: Natychmiast skopiuj wygenerowane hasło. Będzie wyglądać jak qClx 1QWm wGVY IeKC GRSE PVWo. Nie będziesz mógł go ponownie zobaczyć.

[fs-toc-omit]Krok 2: Połącz aplikację WordPress w Easytools

Teraz ustanowisz połączenie między Easytools a Twoją stroną WordPress.

1. Zaloguj się do swojego konta Easytools
2. Z lewego paska bocznego kliknij Store, aby go rozwinąć, następnie wybierz Automatyzacje
3. Jeśli nie masz jeszcze żadnych scenariuszy, zobaczysz komunikat "Nie masz jeszcze scenariuszy" z przyciskiem + Nowy scenariusz
4. Kliknij zakładkę Aplikacje w górnym menu
5. Kliknij przycisk + Nowa aplikacja w prawym górnym rogu
6. Zobaczysz formularz połączenia z następującymi polami:
   • Nazwa: Wprowadź opisową nazwę, np. "WordPress Store" lub "Moja strona WordPress"
   • Aplikacja: Wybierz Wordpress z listy rozwijanej
   • Adres platformy: Wprowadź URL swojej strony WordPress (np. https://twojastrona.com) - musi zawierać https://
   • Nazwa użytkownika: Twoja nazwa użytkownika administratora WordPress (login, którego używasz do dostępu do panelu WP)
   • Hasło aplikacji: Wklej hasło aplikacji skopiowane w kroku 1
7. Kliknij przycisk Sprawdź połączenie, aby zweryfikować połączenie
8. Jeśli połączenie się powiedzie, zobaczysz potwierdzenie. Kliknij Zapisz, aby zapisać połączenie

[fs-toc-omit]Krok 3: Utwórz scenariusz automatyzacji

Skonfiguruj automatyzację, która tworzy konto użytkownika WordPress, gdy ktoś kupuje Twój produkt.

1. W zakładce Sklep ➔ Automatyzacje przejdź do zakładki Scenariusze
2. Kliknij + Nowy scenariusz
3. Zobaczysz formularz z kilkoma opcjami konfiguracji:
   • Nazwa: Nadaj mu opisową nazwę, np. "Utwórz użytkownika WP po zakupie"
   • Zdarzenie: Wybierz z listy zdarzenie, które ma wywołać automatyzację, np. Zrealizowano zamówienie
   • W momencie zdarzenia: Zaznacz tą opcję jeśli chcesz, żeby automatyzacja była wykonywana od razu po zdarzeniu, albo nie zaznaczaj jej i określ kiedy chcesz, żebyśmy uruchomili automatyzację.
   • Wyślij email o niepowodzeniu automatyzacji: Włącz tą opcję, aby otrzymywać powiadomienia, jeśli automatyzacja się nie powiedzie
   • Przypisz produkt: Wybierz produkt Easytools, który uruchomi tę automatyzację (np. "Sendby Access Test")
   • Przypisz wariant: Wybierz "All variants" lub wybierz konkretne warianty
   • Połączenie: Wybierz połączenie WordPress utworzone w kroku 2 z listy rozwijanej (np. "Wordpress Store")
   • Wybierz akcję: Z listy rozwijanej wybierz Stwórz użytkownika
4. Kliknij Zapisz

[fs-toc-omit]Krok 4: Przetestuj przepływ zakupu

Teraz przetestuj kompletny przepływ, aby upewnić się, że użytkownicy są prawidłowo tworzeni w WordPress.

1. Przejdź do strony produktu Easytools
2. Kliknij przycisk Podgląd aby wyświetlić podgląd strony kasy
3. Dokończ testowy zakup, wypełniając wszystkie niezbędne dane
4. Po pomyślnym zakupie sprawdź swoją skrzynkę e-mail w poszukiwaniu e-maila z potwierdzeniem zakupu od Easytools

[fs-toc-omit]Krok 5: Sprawdź utworzenie użytkownika w WordPress

Sprawdź, czy automatyzacja pomyślnie utworzyła konto użytkownika.

1. W Easytools przejdź do Automations → zakładka Executions, aby zobaczyć statystyki wykonań
2. Kliknij na najnowsze wykonanie, aby zweryfikować, że zakończyło się pomyślnie
3. Zaloguj się do panelu administracyjnego WordPress
4. Przejdź do Użytkownicy → Wszyscy użytkownicy
5. Powinieneś zobaczyć nowe konto użytkownika z rolą Subscriber i adresem e-mail użytym podczas zakupu

[fs-toc-omit]Krok 6: Zainstaluj wtyczkę Simple Restrict

Teraz zainstaluj wtyczkę do kontrolowania, które strony wymagają logowania użytkownika. Sugerujemy Simple Restrict jako lekką opcję do podstawowej kontroli dostępu. Jeśli potrzebujesz bardziej zaawansowanych funkcji, w repozytorium WordPress dostępne są inne wtyczki do członkostwa i kontroli dostępu, takie jak "Paid Membership Subscriptions", "Members" lub "Content Control".

1. W panelu administracyjnym WordPress przejdź do Wtyczki → Dodaj nową
2. Wyszukaj Simple Restrict (lub preferowaną wtyczkę kontroli dostępu)
3. Kliknij Zainstaluj, a następnie Aktywuj

[fs-toc-omit]Krok 7: Przyznaj użytkownikowi uprawnienie dostępu

Przyznaj utworzonemu użytkownikowi uprawnienie do dostępu do chronionych stron.

1. W panelu administracyjnym WordPress przejdź do Użytkownicy → Wszyscy użytkownicy
2. Kliknij na użytkownika, który został utworzony przez automatyzację
3. Przewiń w dół do sekcji Permissions
4. Zaznacz checkbox dla only-logged - "Allow this user to see pages marked as only-logged"
5. Kliknij Aktualizuj użytkownika, aby zapisać

[fs-toc-omit]Krok 8: Skonfiguruj uprawnienia strony

Skonfiguruj, które strony powinny być ograniczone tylko do zalogowanych użytkowników.

1. W panelu administracyjnym WordPress przejdź do Strony → Wszystkie strony
2. Wybierz stronę, którą chcesz chronić i kliknij Edytuj
3. W prawym pasku bocznym znajdź panel Permissions
4. Zaznacz pole only-logged, aby ograniczyć tę stronę tylko do zalogowanych użytkowników
5. Kliknij Aktualizuj, aby zapisać

[fs-toc-omit]Krok 9: Przetestuj kontrolę dostępu

To jest kluczowy ostatni krok - sprawdź, czy kontrola dostępu działa poprawnie zarówno dla zalogowanych, jak i niezalogowanych użytkowników.

[fs-toc-omit]Scenariusz 1: Test jako niezalogowany użytkownik (powinien być zablokowany)

1. Otwórz nowe okno incognito/tryb prywatny
2. Przejdź do URL chronionej strony
3. Powinieneś zostać:
   • Przekierowany do strony logowania, LUB
   • Zobaczyć komunikat taki jak "Brak dostępu" lub "Ta treść jest ograniczona", LUB
   • Zobaczyć pustą stronę lub błąd 403 (w zależności od ustawień wtyczki)
4. To potwierdza, że ograniczenie działa

[fs-toc-omit]Scenariusz 2: Test jako zalogowany subskrybent (powinien zobaczyć treść)

1. W tym samym oknie incognito przejdź do https://twojastrona.com/wp-login.php
2. Zaloguj się przy użyciu danych użytkownika utworzonego przez automatyzację:
   • Username: Utworzona nazwa użytkownika (np. test123 lub oparta na e-mailu)
   • Password: Użytkownik będzie musiał użyć resetowania hasła WordPress, jeśli go nie ma
3. Po zalogowaniu ponownie przejdź do chronionej strony
4. Powinieneś teraz zobaczyć pełną treść strony bez ograniczeń
5. U góry strony zobaczysz pasek administratora WordPress pokazujący Howdy, [nazwa użytkownika]

[fs-toc-omit]Scenariusz 3: Test jako administrator (pełny dostęp)

1. Zaloguj się jako swoje konto administratora WordPress
2. Przejdź do chronionej strony
3. Powinieneś zobaczyć pełną treść plus pasek narzędzi administratora
4. To potwierdza, że różne role użytkowników mają odpowiedni dostęp

Sukces! Ukończyłeś część 1. Użytkownicy, którzy kupią Twój produkt, automatycznie otrzymają konta WordPress i będą mogli uzyskać dostęp do chronionej treści. Gdy ich subskrypcja wygaśnie, możesz skonfigurować automatyzację, aby usunąć ich konto WordPress.

Część 2: Podejście z webhookami i dedykowaną wtyczką

To drugie podejście wykorzystuje webhooki do komunikacji w czasie rzeczywistym między Easytools a WordPress. Dedykowana wtyczka obsługuje zdarzenia subskrypcji, zarządza kontami użytkowników, wysyła e-maile powitalne i zapewnia stronę bouncer dla osób nieposiadających subskrypcji.

[fs-toc-omit] Krok 1: Skonfiguruj webhooki w Easytools

Najpierw musisz skonfigurować powiadomienia webhook w swoim koncie Easytools.

1. Zaloguj się do Easytools
2. W głownym menu przejdź do Sklep ➔ Ustawienia sklepu
3. W górnym menu zakładek kliknij API i Webhooki
4. Zobaczysz dwie główne sekcje:
   Sekcja Webhooki:
   • Adres webhooka: Pole tekstowe, w którym wkleisz punkt końcowy webhook WordPress (otrzymasz to po zainstalowaniu wtyczki)
   • Przykładowy format: https://twojastrona.com/wp-json/easytools/v1/webhook?api_token=IgCWvRX
   • Klucz do podpisu webhooka: Pokazuje, kiedy klucz został utworzony (np. "Created 16.11.2025, 11:37:04")
   • Przyciski: Usuń i Zmień klucz(z ikoną odświeżania)
   • Jeśli nie masz jeszcze klucza podpisującego, zobaczysz przycisk do jego utworzenia
   Sekcja Klucze API:
   • Przycisk + Nowy klucz API w prawym górnym rogu
     ‍
5. Ważne: Nie wypełniaj jeszcze pola Webhook URL - musisz najpierw zainstalować wtyczkę
6. Jeśli nie masz klucza podpisującego webhook, kliknij przycisk, aby go wygenerować i natychmiast go skopiuj.  

[fs-toc-omit]Krok 2: Zainstaluj wtyczkę Easytools Subscription Manager

Zainstaluj wtyczkę Easytools Subscription Manager, która obsługuje zdarzenia webhook.

1. Pobierz plik wtyczki
2. W panelu administracyjnym WordPress przejdź do Wtyczki → Dodaj nową‍
3. Kliknij Wyślij wtyczkę i wybierz plik ZIP
4. Kliknij Zainstaluj teraz‍
5. Kliknij Aktywuj wtyczkę‍
6. Po aktywacji "Easytools" pojawi się w lewym pasku bocznym administratora WordPress

[fs-toc-omit]Krok 3: Skonfiguruj ustawienia wtyczki

Skonfiguruj wtyczkę za pomocą swoich danych uwierzytelniających Easytools i preferencji.

1. W pasku bocznym administratora WordPress kliknij Easytools
2. Kliknij Settings z podmenu
3. Skonfiguruj następujące sekcje:Basic Settings:
   • Easytools Checkout URL: Wprowadź URL kasy swojego produktu Easytools
   • Webhook Signing Key: Wklej klucz podpisujący z Easytools
   • API Token (Optional): Opcjonalny dodatkowy token bezpieczeństwa
   • Webhook URL: Ten adres wyświetla punkt końcowy webhook WordPress - skopiujesz go później do Easytools
   Ustawienia strony Bouncer:
   • Enable Bouncer Page: Zaznacz to, aby włączyć
   • Bouncer Page: Wybierz, której strony użyć jako strony bouncer
   • Product URL: URL kasy Easytools
   • Icon Color: Dostosuj kolory przycisków, jeśli chcesz
   Kontrola dostępu:
   • Protect Entire Site: Opcjonalnie chroń wszystkie strony z wyjątkiem wybranych
   • Exclude Pages: Wybierz, które strony powinny pozostać publiczne
4. Kliknij Save Settings

[fs-toc-omit]Krok 4: Skonfiguruj e-mail powitalny

Dostosuj e-mail, który nowi subskrybenci otrzymują z linkiem do ustawienia hasła.

1. W ustawieniach wtyczki Easytools (przewiń w dół) znajdź sekcję Email Configuration
2. Zobaczysz opis: "Customize the content of welcome emails sent to new users. Available placeholders: {username}, {site_name}, {login_url}"
3. Skonfiguruj następujące pola:
   • Email Subject: Domyślnie to [{site_name}] Welcome! Set Your Password
   • Email Heading: Domyślnie pokazuje emoji przyjęcia i Welcome to {site_name}!
   • Email Message: Wielowierszowe pole tekstowe z preferowaną treścią
   • Button Text: Domyślnie to Set Your Password
4. Poniżej konfiguracji zobaczysz sekcję Test Email:
   • Nagłówek: "Test your email configuration"
   • Opis: "Send a test welcome email to verify your email settings, sender information, and template"
   • Wprowadź testowy adres e-mail w polu
   • Kliknij przycisk Send Test Email
5. Sprawdź swoją skrzynkę e-mail, aby zweryfikować, czy e-mail powitalny wygląda poprawnie

[fs-toc-omit]Krok 5: Uzupełnij połączenie webhook

Teraz połącz Easytools z punktem końcowym webhook WordPress.

1. W ustawieniach wtyczki WordPress znajdź pole Webhook URL w Basic Settings
2. Kliknij zielony przycisk Show, aby ujawnić pełny URL
3. Kliknij różowy przycisk Copy URL, aby go skopiować
4. Wróć do Easytools → Store settings → API & Webhooks
5. Wklej skopiowany URL w pole Webhook URL
6. URL będzie zawierał parametr tokena API (np. ?api_token=IgCWvRXUx1o45kJfbcem0SbodmQmmT1)
7. Kliknij Save w Easytools

[fs-toc-omit]Krok 6: Przetestuj integrację webhook

Użyj wbudowanego narzędzia testowego, aby zweryfikować, czy webhooki działają poprawnie.

1. W panelu administracyjnym WordPress przejdź do Easytools → Webhook Testing
2. Zobaczysz stronę Easytools Webhook Testing z opisem: "Test and debug webhook integrations with Easytools payment platform"
3. Strona pokazuje główne sekcje:
   Webhook Endpoint:
   • Webhook URL (with API Token): Wyświetla punkt końcowy z zamaskowanym tokenem
   • Opis: "Use this URL in Easytools → API & Webhooks. The API token provides additional security."
   • Signing Key: Zamaskowane kropkami (••••••••••••••••••)
   • API Token: Zamaskowane kropkami
   • Każde ma zielony przycisk Show i różowy Copy
   Example Payloads:
   • Custom Test Email: Pole do wprowadzenia testowego adresu e-mail
   • Product Assigned: Sekcja pokazująca przycisk "Send test webhook"
   • Pokazuje podgląd przykładowego ładunku JSON
   • Podobne sekcje dla innych typów zdarzeń
4. Wprowadź testowy adres e-mail w polu Custom Test Email
5. W sekcji Product Assigned kliknij Send test webhook
6. Sprawdź komunikat sukcesu i zweryfikuj, czy test zadziałał

[fs-toc-omit]Krok 7: Monitoruj logi webhook

Zobacz wszystkie zdarzenia webhook otrzymane przez Twoją stronę WordPress.

1. W panelu administracyjnym WordPress przejdź do Easytools → Webhook Logs
2. Zobaczysz stronę zatytułowaną "Monitor and debug webhook communications from Easytools"
3. U góry znajduje się Date Range Filter:
   • Dwa pola daty: format dd.mm.rrrr
   • Tekst "to" między nimi
   • Niebieski przycisk Filter (z ikoną filtra)
   • Różowy przycisk Clear (z ikoną X)
4. Po prawej stronie znajduje się sekcja Export::
   • Zielony przycisk Export to CSV (z ikoną pobierania)
   • Zielony przycisk Export to MD (z ikoną dokumentu)
5. Główna tabela pokazuje zdarzenia webhook z zielonymi nagłówkami:
   • Date: Znacznik czasu (np. "2025-11-16 22:16:18")
   • Event Type: Pokazuje nazwy zdarzeń takie jak:
     • product_assigned
     • subscription_created
     • product_access_expired
     • subscription_deleted
   • Customer Email: Adres e-mail klienta
   • User ID: Numer ID użytkownika WordPress (np. "46", "45", "44")
   • Status: Wszystkie pokazują zielone odznaki success
6. Kliknij Details w dowolnym wierszu, aby zobaczyć pełny ładunek webhook i odpowiedź

[fs-toc-omit]Krok 8: Zobacz zarządzanie subskrybentami

Sprawdź aktywne i nieaktywne subskrypcje w pulpicie subskrybentów.

1. W panelu administracyjnym WordPress przejdź do Easytools → Subscribers
2. Zobaczysz opis: "View and manage all users with active and inactive subscriptions"
3. Strona jest podzielona na dwie sekcje z zielonymi nagłówkami:
   Active Subscriptions:
   • Zielona ikona znacznika z nagłówkiem Active Subscriptions
   • Tabela z kolumnami:
     • User: Nazwa użytkownika WordPress
     • Email: E-mail użytkownika
     • Subscription Type: Typ subskrypcji
     • Renewal Date: Data kolejnego odnowienia
     • Status: Odznaka statusu
   • Jeśli pusta: "No active subscriptions found."
   Inactive Accounts:
   • Czerwona ikona X z nagłówkiem Inactive Accounts
   • Opis: "Users who previously had a subscription that was cancelled, expired, or is no longer active."
   • Tabela z kolumnami:
     • User: Nazwa użytkownika
     • Email: E-mail użytkownika
     • Last Subscription Type: Typ (np. "monthly")
     • Last Renewal Date: Data (np. "2025-11-28 16:14:03")
     • Status: Czerwona odznaka pokazująca Inactive

[fs-toc-omit]Krok 9: Przetestuj kompletny przepływ zakupu

Przeprowadź test end-to-end, aby zweryfikować całą integrację.

1. Odwiedź stronę koszyka swojego produktu Easytools
2. Dokonaj testowego zakupu z prawdziwym adresem e-mail
3. Po zakupie sprawdź swój e-mail w poszukiwaniu e-maila powitalnego z tematem takim jak "Welcome! Set Your Password"
4. E-mail powinien pokazywać:
   • Fioletowy/niebieski przycisk z tekstem "Set Your Password"
   • Nagłówek e-maila pokazujący emoji przyjęcia i wiadomość powitalną
   • Twoją nazwę użytkownika
5. Kliknij przycisk, aby ustawić swoje hasło
6. Przejdź do Easytools → Subscribers w WordPress
7. Zweryfikuj, że użytkownik pojawia się w Active Subscriptions
8. Przejdź do Webhook Logs i zweryfikuj, że zdarzenia zostały zarejestrowane:
   • Zdarzenie product_assigned
   • Zdarzenie subscription_created

[fs-toc-omit]Krok 10: Przetestuj stronę logowania i kontrolę dostępu

Zweryfikuj, że osoby nieposiadające subskrypcji są przekierowywane na stronę logowania.

1. Otwórz okno incognito/tryb prywatny
2. Przejdź do chronionej strony na Twojej stronie WordPress
3. Powinieneś zostać przekierowany na stronę logowania
4. Strona logowania powinna wyświetlać:
   • Branding/logo Twojej strony (na podstawie szablonu)
   • Komunikat wyjaśniający, że wymagana jest subskrypcja
   • Przycisk do zakupu/subskrypcji (linkujący do koszyka Easytools)
5. Teraz zaloguj się jako użytkownik subskrybent
6. Przejdź do tej samej chronionej strony
7. Powinieneś zobaczyć pełną treść strony - bez strony logowania
8. U góry zobaczysz, że jesteś zalogowany jako użytkownik subskrybent

Gratulacje! Pomyślnie skonfigurowałeś integrację WordPress opartą na webhookach z dedykowaną wtyczką. To podejście zapewnia zarządzanie subskrypcjami w czasie rzeczywistym, automatyczne tworzenie użytkowników, e-maile powitalne, kontrolę dostępu i kompleksowe logowanie.