Dokumentacja WP Simple Pay

Materiały dokumentacyjne, referencyjne i samouczki dla WP Simple Pay

Jak rozwiązać problemy spowodowane przez wtyczki do pamięci podręcznej i optymalizacji

Czas czytania: 4 minuty | Poziom trudności: Początkujący

Przegląd

Wtyczki buforujące i pamięć podręczna hostingu przyspieszają Twoją witrynę, zapisując kopię każdej strony i udostępniając ją kolejnym odwiedzającym. Wtyczki optymalizujące idą dalej i minimalizują, łączą lub opóźniają JavaScript Twojej witryny. Oba są dobre dla wydajności, ale mogą zakłócać działanie formularzy płatności, jeśli są ustawione zbyt agresywnie.

Od wersji WP Simple Pay 4.17.5 formularze płatności działają na w pełni buforowanych stronach. Każdy formularz ładuje swoje ustawienia i świeży token bezpieczeństwa z Twojej witryny podczas otwierania strony, więc buforowana kopia strony nie zawiera już niczego, co mogłoby wygasnąć. Nie musisz już wykluczać stron formularzy płatności z buforowania.

Ten przewodnik obejmuje dwie rzeczy, które nadal wymagają uwagi: wykluczenie stron potwierdzenia płatności z pamięci podręcznej i wykluczenie skryptów WP Simple Pay z optymalizacji JavaScript.

Wymagania wstępne

  • WP Simple Pay 4.17.5 lub nowszy. W starszych wersjach strony formularzy płatności muszą być również wykluczone z buforowania lub buforowane przez nie dłużej niż 12 godzin.
  • Dostęp do ustawień wtyczki buforującej lub optymalizującej, lub do zespołu pomocy technicznej Twojego hostingu, jeśli pamięć podręczna działa na serwerze.

Buforowanie

Strony Formularzy Płatności

W WP Simple Pay 4.17.5 i nowszych wersjach strony zawierające formularz płatności mogą być buforowane jak każda inna strona. Kiedy odwiedzający otwiera stronę, każdy formularz pobiera własne dane z REST API Twojej witryny. Przycisk płatności pozostaje wyłączony, dopóki formularz nie będzie gotowy, więc wczesne kliknięcie nie może wysłać niekompletnego formularza.

Jeśli wykluczyłeś strony formularzy płatności z buforowania w starszej wersji, możesz pozostawić to wykluczenie lub je usunąć. Oba rozwiązania działają.

Właśnie zaktualizowałeś? Wyczyść pamięć podręczną swojej witryny raz po aktualizacji do wersji 4.17.5. Strony buforowane przed aktualizacją nadal zawierają stary kod formularza, dopóki nie zostaną odświeżone.

Strony potwierdzenia płatności

Zachowaj swoje strony sukcesu i porażki płatności wykluczone z buforowania. Te strony pokazują szczegóły konkretnej płatności, więc każdy klient musi otrzymać świeżo wygenerowaną stronę.

W przypadku niektórych hostingów pamięć podręczna działa na serwerze i nie można jej zmienić z poziomu WordPress. W takim przypadku skontaktuj się ze swoim hostingiem i poproś o wykluczenie adresów URL stron potwierdzenia z buforowania.

Konfiguracja konkretnych wtyczek

Optymalizacja JavaScript

Problemy z JavaScript spowodowane przez wtyczki optymalizujące zazwyczaj wynikają z następujących funkcji:

  • Minimalizacja
    Usuwa niepotrzebne znaki z kodu, takie jak białe znaki, aby uzyskać mniejszy plik.
  • Łączenie
    Scala oddzielne pliki JavaScript w jeden, aby zmniejszyć liczbę żądań wysyłanych do serwera.
  • Ładowanie odroczone/asynchroniczne
    Opóźnia ładowanie lub uruchamianie plików JavaScript, aby strona nie musiała na nie czekać.

Wyklucz następujące pliki z każdego ustawienia optymalizacji JavaScript, niezależnie od używanej wtyczki:

js.stripe.com/v3/
simpay-public-shared.js
simpay-public-upe.js
accounting.min.js
simpay-public-pro-upe.js

Co optymalizacja musi pozostawić w spokoju

Formularze płatności potrzebują niewielkiego zestawu ustawień witryny, zanim będą mogły się załadować: adres API REST Twojej witryny, format waluty i komunikat wyświetlany, gdy formularz nie może się załadować. WP Simple Pay drukuje te ustawienia w dwóch miejscach:

  • Wewnątrz kodu HTML każdego formularza płatności, w atrybucie data-simpay-general formularza. Ta kopia jest częścią samego formularza, więc jest buforowana wraz ze stroną.
  • W małym skrypcie na końcu strony, <script id="simpay-shared-js-extra">, który definiuje spGeneral.

Od wersji WP Simple Pay 4.17.6 formularz ładuje się, dopóki jedna z kopii znajduje się na stronie. Niektóre wtyczki optymalizujące usuwają lub opóźniają małe skrypty inline, takie jak drugi, a formularz używa teraz własnej kopii, gdy tak się dzieje.

Aby formularze płatności działały, upewnij się, że Twoja wtyczka optymalizująca nie:

  • Usuwa atrybutów HTML z tagu <form> formularza płatności, zwłaszcza data-simpay-form-id i data-simpay-general.
  • Usuwa zarówno atrybutu data-simpay-general, jak i skryptu simpay-shared-js-extra. Jeśli oba zostaną usunięte, formularz nie załaduje się.

Konfiguracja konkretnych wtyczek

Rozwiązywanie problemów

„Ten formularz płatności nie mógł zostać załadowany”

Jeśli odwiedzający widzą komunikat Ten formularz płatności nie mógł zostać załadowany. Odśwież stronę i spróbuj ponownie. poniżej przycisku płatności, formularz nie mógł pobrać danych z Twojej witryny. Zazwyczaj jest to spowodowane czymś blokującym API REST Twojej witryny:

Błędy tokena zabezpieczeń

Błędy takie jak Nie powiodło się sprawdzenie bezpieczeństwa kuponu lub Nonce pliku cookie jest nieprawidłowy były wcześniej spowodowane przez buforowane strony przechowujące nieprawidłowe tokeny zabezpieczeń. Od wersji 4.17.5 formularze pobierają nowy token za każdym razem, gdy się ładują, a nieprawidłowe tokeny w żądaniach gości są automatycznie odzyskiwane. Jeśli nadal widzisz te błędy po aktualizacji, wyczyść pamięć podręczną swojej witryny. Zobacz Jak rozwiązać błąd „Nie powiodło się sprawdzenie bezpieczeństwa kuponu”, aby uzyskać więcej informacji.

Często zadawane pytania

Czy nadal muszę wykluczać strony z formularzami płatności z buforowania?

Nie, nie w WP Simple Pay 4.17.5 lub nowszej. Nadal musisz wykluczyć swoje strony potwierdzenia płatności.

Mam niestandardowy kod, który odczytuje window.spGeneral. Czy nadal działa?

Tak. Gdy skrypt stopki jest obecny, window.spGeneral jest ustawiany przez niego, jak poprzednio. Kiedy wtyczka optymalizująca usunęła ten skrypt, WP Simple Pay ustawia window.spGeneral z atrybutu data-simpay-general formularza płatności, gdy tylko załadują się jej skrypty, więc Twój kod widzi te same wartości.

Mam niestandardowy kod, który odczytuje window.simplePayForms. Czy nadal działa?

Tak. Obiekt jest nadal dostępny, a wpis dla każdego formularza jest dodawany w miarę przybywania danych tego formularza. Jeśli Twój kod uruchamia się natychmiast po załadowaniu strony, może być konieczne poczekanie, aż formularz zakończy ładowanie.

Co dalej?

Nadal masz pytania? Jesteśmy tutaj, aby pomóc!

Ostatnio zmodyfikowano:

Zacznij akceptować płatności już dziś

Zacznij akceptować jednorazowe i cykliczne płatności lub darowizny na swojej stronie WordPress.