Dostępne haki i filtry w Custom Login for WooCommerce

Chcesz, aby klienci trafiali na konkretną stronę po zalogowaniu, lub potrzebujesz dodać link lub skrypt do strony logowania. Custom Login for WooCommerce zapewnia haki do obu tych celów, dzięki czemu nie musisz edytować plików wtyczki. Posiada również punkt końcowy REST API, który odczytuje i aktualizuje ustawienia wtyczki z kodu.

Ten artykuł obejmuje filtr clwc_login_redirect, akcje clwc_after_login_form i clwc_login_footer oraz punkt końcowy REST API /settings. W krótkiej tabeli wymieniono również trzy mniejsze haki. Konfiguracja samej strony logowania jest opisana w Pierwsze kroki z Custom Login for WooCommerce.

Jest to odniesienie dla deweloperów. Zakłada się, że czujesz się komfortowo z dodawaniem kodu PHP za pomocą niestandardowej wtyczki lub pliku functions.php motywu potomnego. Jeśli haki są dla Ciebie nowe, zacznij od Podręcznika wtyczek WordPress na temat haków.

Wymagania wstępne

Jak haki pasują do strony logowania

Wtyczka obsługuje Twoją stronę /login z własnego, samodzielnego szablonu. Ten szablon nie ładuje nagłówka ani stopki Twojego motywu i nie wywołuje wp_head() ani wp_footer(). Dlatego wywołanie zwrotne dodane do wp_head lub wp_footer nigdy nie działa na tej stronie. Zamiast tego użyj poniższych haków wtyczki.

Pamiętaj, że filtr przekierowania działa podczas wysyłania formularza, podczas gdy dwie akcje działają podczas wyświetlania strony logowania.

Filtr: clwc_login_redirect

Ten filtr zmienia miejsce, do którego klient trafia bezpośrednio po pomyślnym zalogowaniu. Nie działa, gdy logowanie się nie powiedzie.

apply_filters( 'clwc_login_redirect', $redirect_to, $user );

Zwróć adres URL, który chcesz. Początkową wartością $redirect_to jest wartość redirect_to przekazana do strony logowania, na przykład twojsklep.com/login/?redirect_to=.... Jeśli jej nie ma, jest to adres URL strony Moje konto WooCommerce.

Oto, co dzieje się po zwróceniu przez Twoje wywołanie zwrotne:

1. Następnie działa własny filtr WooCommerce woocommerce_login_redirect. Każde wywołanie zwrotne w tym filtrze widzi Twój wynik i może go ponownie zmienić.
2. Wtyczka sprawdza ostateczny adres URL. Jeśli wskazuje na inny domenę, której WordPress nie zezwala, wtyczka wysyła klienta na stronę Moje konto.
3. Wtyczka przekierowuje klienta.

Ponieważ woocommerce_login_redirect działa po clwc_login_redirect, inna wtyczka w tym filtrze może nadpisać Twoje przekierowanie. Jeśli Twoje przekierowanie wydaje się być ignorowane, sprawdź inne wtyczki, które podłączają się do woocommerce_login_redirect.

Przykład: wyślij menedżerów sklepu do panelu

add_filter( 'clwc_login_redirect', function ( $redirect_to, $user ) {
	if ( in_array( 'shop_manager', (array) $user->roles, true ) ) {
		return admin_url();
	}

	return $redirect_to;
}, 10, 2 );

10 to priorytet wywołania zwrotnego, a 2 informuje WordPress, że Twoje wywołanie zwrotne akceptuje dwa parametry. Bez 2 nie otrzymasz $user.

Akcje: clwc_after_login_form i clwc_login_footer

Obie akcje pozwalają na umieszczenie własnego kodu HTML na stronie logowania. Żadna z nich nie przekazuje parametrów, więc Twoje wywołanie zwrotne nie wymaga argumentów. Wyświetl swoją zawartość za pomocą echo.

Przykład: dodaj link pod formularzem logowania

add_action( 'clwc_after_login_form', function () {
	echo '<p><a href="' . esc_url( home_url( '/become-a-customer/' ) ) . '">Need an account? Apply here.</a></p>';
} );

Przykład: dodaj linię tekstu do stopki strony

add_action( 'clwc_login_footer', function () {
	echo '<p style="text-align:center;">Need help? Call us on 1300 000 000.</p>';
} );

clwc_login_footer uruchamia się poza panelem formularza, więc Twój własny CSS decyduje o tym, gdzie pojawi się treść. W przypadku treści należącej do formularza, użyj clwc_after_login_form.

Inne haki na stronie logowania

Te haki są mniejsze i rzadziej używane. Działają tak samo jak powyższe akcje i filtry.

Formularz logowania uruchamia również standardowe haki logowania WooCommerce: woocommerce_login_form_start, woocommerce_login_form i woocommerce_login_form_end. Dlatego większość wtyczek CAPTCHA i zabezpieczeń, które działają na formularzu logowania WooCommerce, działa również tutaj.

REST API: punkt końcowy ustawień

Wtyczka posiada jeden punkt końcowy REST API dla swoich ustawień. Pozwala on na odczytanie bieżących ustawień lub ich aktualizację z kodu, na przykład podczas konfigurowania wielu sklepów z jednego skryptu.

/wp-json/clwc/v1/settings

Kto może z niego korzystać

Obie metody wymagają zalogowanego konta z uprawnieniem manage_woocommerce. Obejmuje to administratorów i menedżerów sklepów. Każdy inny otrzyma odpowiedź 401 lub 403.

Dla żądania z przeglądarki podczas logowania, wyślij nagłówek X-WP-Nonce z nonce wp_rest. Dla żądania spoza WordPress, użyj hasła aplikacji z uwierzytelnianiem podstawowym.

Odczytaj ustawienia

curl -u "admin:APPLICATION_PASSWORD" https://yourstore.com/wp-json/clwc/v1/settings

Odpowiedź jest obiektem JSON. Każde ustawienie, którego jeszcze nie zapisałeś, wraca z wartością domyślną, z wyjątkiem logo_url, które jest pomijane w odpowiedzi, dopóki nie zapiszesz adresu URL logo.

Zaktualizuj ustawienia

Wyślij treść JSON tylko z polami, które chcesz zmienić. Pominięte pola pozostają bez zmian.

curl -X POST -u "admin:APPLICATION_PASSWORD" \
  -H "Content-Type: application/json" \
  -d '{"template":"template-2","button_bg":"#e11d48","login_heading":"Welcome back"}' \
  https://yourstore.com/wp-json/clwc/v1/settings

Z poziomu przeglądarki możesz używać wp.apiFetch w ten sam sposób:

wp.apiFetch( {
	path: '/clwc/v1/settings',
	method: 'POST',
	data: { login_button_text: 'Sign in' },
} );

Wtyczka czyści każdą wartość przed jej zapisaniem. Wartość niewłaściwego typu jest pomijana lub zapisywana jako pusta, a żądanie nadal jest realizowane.

Pola, których nie ma w tabeli, są ignorowane. Ponadto rotation_items zastępuje całą zapisaną listę za każdym razem, gdy ją wysyłasz, więc uwzględnij wszystkie elementy, które chcesz zachować.

Rozwiązywanie problemów

Często zadawane pytania

Potrzebujesz pomocy?

Custom Login for WooCommerce to wtyczka premium, więc jeśli potrzebujesz pomocy z konkretną personalizacją, otwórz zgłoszenie wsparcia, a nasz zespół wskaże Ci odpowiedni hook dla Twojego przypadku użycia.