Hook e filtri disponibili in Custom Login per WooCommerce

Vuoi che i clienti atterrino su una pagina specifica dopo aver effettuato l'accesso, o hai bisogno di aggiungere un link o uno script alla pagina di login. Custom Login for WooCommerce ti fornisce hook per entrambi, così non dovrai modificare i file del plugin. Ha anche un endpoint REST API che legge e aggiorna le impostazioni del plugin dal codice.

Questo articolo copre il filtro clwc_login_redirect, le action clwc_after_login_form e clwc_login_footer, e l'endpoint REST API /settings. Elenca anche tre hook più piccoli in una breve tabella. La configurazione della pagina di login stessa è trattata in Introduzione a Custom Login for WooCommerce.

Questo è un riferimento per sviluppatori. Si presume che tu sia a tuo agio nell'aggiungere PHP tramite un plugin personalizzato o il file functions.php del tuo child theme. Se gli hook ti sono nuovi, inizia con il Manuale dei plugin di WordPress sugli hook.

Prerequisiti

Come gli hook si inseriscono nella pagina di login

Il plugin serve la tua pagina /login dal suo template standalone. Quel template non carica l'header o il footer del tuo tema, e non chiama wp_head() o wp_footer(). Quindi una callback aggiunta a wp_head o wp_footer non viene mai eseguita su questa pagina. Usa invece gli hook del plugin qui sotto.

Tieni presente che il filtro di reindirizzamento viene eseguito alla sottomissione del modulo, mentre le due action vengono eseguite quando la pagina di login viene visualizzata.

Filtro: clwc_login_redirect

Questo filtro cambia la destinazione di un cliente subito dopo un login riuscito. Non viene eseguito quando un login fallisce.

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

Restituisci l'URL desiderato. Il valore iniziale di $redirect_to è il valore redirect_to passato alla pagina di login, ad esempio tuonegozioweb.com/login/?redirect_to=.... Se non ce n'è uno, è l'URL della pagina Il mio account di WooCommerce.

Ecco cosa succede dopo che la tua callback restituisce:

1. Il filtro woocommerce_login_redirect di WooCommerce viene eseguito successivamente. Qualsiasi callback su quel filtro vede il tuo risultato e può modificarlo di nuovo.
2. Il plugin controlla l'URL finale. Se punta a un dominio diverso che WordPress non consente, il plugin invia il cliente a Il mio account invece.
3. Il plugin reindirizza il cliente.

Poiché woocommerce_login_redirect viene eseguito dopo clwc_login_redirect, un altro plugin su quel filtro può sovrascrivere il tuo reindirizzamento. Se il tuo reindirizzamento sembra essere ignorato, controlla altri plugin che si agganciano a woocommerce_login_redirect.

Esempio: invia i gestori del negozio alla dashboard

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 );

Il 10 è la priorità della callback e il 2 indica a WordPress che la tua callback accetta due parametri. Senza il 2, non ricevi $user.

Azioni: clwc_after_login_form e clwc_login_footer

Entrambe le azioni ti consentono di inserire il tuo HTML nella pagina di accesso. Nessuna delle due passa parametri, quindi la tua callback non necessita di argomenti. Esegui l'output del tuo contenuto con echo.

Esempio: aggiungi un link sotto il modulo di accesso

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>';
} );

Esempio: aggiungi una riga di testo al piè di pagina

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

clwc_login_footer viene attivata al di fuori del pannello del modulo, quindi il tuo CSS decide dove appare il contenuto. Per contenuti che appartengono al modulo, usa clwc_after_login_form.

Altri hook nella pagina di accesso

Questi hook sono più piccoli e meno comuni. Funzionano allo stesso modo delle azioni e dei filtri sopra.

Il modulo di accesso attiva anche gli hook di accesso standard di WooCommerce: woocommerce_login_form_start, woocommerce_login_form e woocommerce_login_form_end. Ecco perché la maggior parte dei plugin CAPTCHA e di sicurezza che funzionano sul modulo di accesso di WooCommerce funzionano anche qui.

REST API: endpoint delle impostazioni

Il plugin ha un endpoint REST API per le sue impostazioni. Ti consente di leggere le impostazioni correnti o di aggiornarle dal codice, ad esempio quando imposti molti negozi da un unico script.

/wp-json/clwc/v1/settings

Chi può usarlo

Entrambi i metodi richiedono un account connesso con la capacità manage_woocommerce. Ciò include amministratori e gestori del negozio. Chiunque altro riceve una risposta 401 o 403.

Per una richiesta dal browser mentre sei connesso, invia l'intestazione X-WP-Nonce con un nonce wp_rest. Per una richiesta da fuori WordPress, usa una password per applicazioni con autenticazione di base.

Leggi le impostazioni

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

La risposta è un oggetto JSON. Qualsiasi impostazione non ancora salvata viene restituita con il suo valore predefinito, eccetto logo_url, che viene omesso dalla risposta finché non salvi un URL del logo.

Aggiorna le impostazioni

Invia un corpo JSON con solo i campi che desideri modificare. I campi che ometti rimangono invariati.

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

Dal browser, puoi usare wp.apiFetch nello stesso modo:

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

Il plugin pulisce ogni valore prima di salvarlo. Un valore del tipo sbagliato viene saltato o salvato come vuoto, e la richiesta ha comunque successo.

I campi non presenti nella tabella vengono ignorati. Inoltre, rotation_items sostituisce l'intero elenco salvato ogni volta che lo invii, quindi includi ogni elemento che desideri conservare.

Risoluzione dei problemi

Domande frequenti

Serve aiuto?

Custom Login for WooCommerce è un plugin premium, quindi se hai bisogno di aiuto con una personalizzazione specifica, apri un ticket di supporto e il nostro team potrà indicarti l'hook giusto per il tuo caso d'uso.