Come usare il blocco Modulo di Pagamento

Tempo di lettura: 4 minuti | Difficoltà: Principiante

Panoramica

Il blocco WP Simple Pay – Modulo di Pagamento è il modo consigliato per inserire un modulo di pagamento in un post o pagina di Gutenberg. Fornisce un'anteprima dal vivo del modulo all'interno dell'editor, espone le opzioni di visualizzazione nella barra laterale del blocco e renderizza lo stesso modulo sulla pagina che vedrebbe un cliente, senza che tu debba mai copiare uno shortcode.

Il blocco è funzionalmente equivalente allo shortcode ma è più facile da trovare e fornisce anteprime nell'editor che riflettono le impostazioni correnti dello Stile del Modulo.

Prerequisiti

• WP Simple Pay (qualsiasi piano: il blocco è incluso nel plugin gratuito)
• Un sito WordPress che esegue l'editor a blocchi (Gutenberg)
• Almeno un modulo di pagamento pubblicato

Passaggio 1: Inserisci il Blocco

1. Modifica il post o la pagina in cui desideri che appaia il modulo.
2. Fai clic sull'inseritore di blocchi +.
3. Cerca WP Simple Pay o Modulo di Pagamento.
4. Fai clic sul blocco WP Simple Pay – Modulo di Pagamento.

Appare un segnaposto che ti chiede di selezionare un modulo.

Passaggio 2: Scegli un modulo

Usa il menu a discesa nel segnaposto del blocco per scegliere quale modulo di pagamento pubblicato visualizzare. Una volta selezionato, il blocco sostituisce il segnaposto con un'anteprima dal vivo del modulo, inclusi titolo, descrizione, campi e pulsante di invio, stilizzato con le impostazioni correnti dello Stile del Modulo.

Se modifichi lo Stile del Modulo dopo aver inserito il blocco, l'anteprima si aggiorna la prossima volta che ricarichi l'editor.

Passaggio 3: Configura le opzioni di visualizzazione

Con il blocco selezionato, la barra laterale delle impostazioni del blocco a destra espone due interruttori:

• Mostra Titolo — Se abilitato (impostazione predefinita), visualizza il titolo del modulo sopra i campi. Disabilita per nascondere il titolo, utile quando la pagina circostante ha già un'intestazione.
• Mostra Descrizione — Se abilitato (impostazione predefinita), visualizza il testo della descrizione del modulo sopra i campi. Disabilita per layout compatti.

Se disabiliti entrambi, il contenitore del titolo/descrizione viene soppresso del tutto, in modo che non rimanga spazio vuoto.

Il blocco supporta anche l'Allineamento al Centro tramite la barra degli strumenti standard del blocco. Se centrato, il modulo, l'intestazione incorporata e il pulsante di invio sono allineati orizzontalmente all'interno della larghezza del contenuto della pagina e l'area dell'intestazione è limitata a una larghezza massima di 400px.

Passaggio 4: Pubblica e visualizza l'anteprima

Salva o pubblica la pagina. Visualizzala sul frontend per vedere il modulo nel suo stato renderizzato. Il blocco utilizza la stessa pipeline di rendering dello shortcode, quindi il comportamento sul frontend è identico.

Blocco vs Shortcode

	Blocco	Shortcode
Anteprima editor	Live, stilizzato	Nessuno — solo segnaposto
Toggle di visualizzazione	Checkbox UI	Modifica manualmente gli attributi dello shortcode
Allineamento	Barra degli strumenti del blocco	Includi in HTML/CSS
Funziona nell'editor classico	No	Sì
Funziona nei widget	Sì (widget a blocchi)	Sì
Funziona nei page builder	Dipende dal builder	Sì (universale)

Quando usare il blocco: Post e pagine Gutenberg moderni, template FSE, widget basati su blocchi.

Quando usare lo shortcode: Editor classico, page builder senza supporto nativo per blocchi, template tema personalizzati dove chiami do_shortcode() direttamente.

Domande frequenti

L'anteprima del modulo viene visualizzata ma i clienti non possono pagare — perché?

Il blocco renderizza lo stesso modulo per l'anteprima dell'editor come fa per i visitatori. Se l'anteprima mostra il modulo ma le invii falliscono, il problema è nella configurazione del modulo stesso (metodo di pagamento mancante, chiavi Stripe non valide, campo obbligatorio mancante) piuttosto che nel blocco. Controlla WP Simple Pay > Moduli di Pagamento e le schede Generali/Pagamento del modulo.

Posso usare più blocchi Modulo di Pagamento nella stessa pagina?

Sì — ogni blocco può renderizzare un modulo diverso. Le risorse frontend del plugin sono abbastanza intelligenti da gestire più moduli sulla stessa pagina senza conflitti.

Perché l'anteprima dell'editor non corrisponde a ciò che vedo sul frontend?

L'anteprima dell'editor riflette lo stato salvato del modulo al momento del caricamento dell'editor. Se hai apportato modifiche al modulo in un'altra scheda, salva/aggiorna l'editor per vederle. Il frontend renderizza sempre l'ultima versione salvata.

Il blocco funziona nei template di Full Site Editing (FSE)?

Sì. Il blocco può essere inserito in qualsiasi contesto consapevole dei blocchi, inclusi template FSE, parti di template e blocchi/pattern riutilizzabili.

Posso stilizzare il modulo incorporato in modo indipendente per ogni pagina?

Lo stile del modulo è per modulo, non per blocco. Per utilizzare stili diversi in pagine diverse, crea moduli multipli e inserisci il blocco appropriato in ogni pagina.

Qual è la differenza tra questo e il blocco Pulsante WP Simple Pay?

Il blocco Modulo di Pagamento incorpora l'intero modulo inline. Il blocco Pulsante visualizza solo un pulsante che apre il modulo in una sovrapposizione (modale) quando viene cliccato — utile per le landing page in cui si desidera una call-to-action pulita anziché un modulo visibile. Vedi Come Usare il Blocco Pulsante di Pagamento.

Cosa fare dopo?

• Come Stilizzare i Tuoi Moduli di Pagamento con lo Stile del Modulo – Personalizza l'aspetto del modulo incorporato
• Come Usare il Blocco Gestione Abbonamenti – Lascia che gli abbonati gestiscano i loro piani
• Come Configurare le Impostazioni Generali di un Modulo di Pagamento – Configura il modulo stesso