WordPress: pattern sincronizzato non si aggiorna

In breve: se un pattern sincronizzato di WordPress non si aggiorna, verifica prima che l’istanza sia ancora realmente sincronizzata e non sia stata scollegata. Se la sincronizzazione è attiva, controlla poi il salvataggio del pattern nell’editor, le richieste REST, eventuali errori JavaScript e i conflitti con plugin o funzioni che modificano il Block Editor.

Pattern sincronizzato non si aggiorna: significato

Un pattern sincronizzato, precedentemente chiamato blocco riutilizzabile, mantiene contenuto e struttura sincronizzati nelle diverse posizioni del sito in cui viene utilizzato. Se il pattern originale viene modificato e salvato correttamente, le istanze che restano sincronizzate devono riflettere la modifica.

Quando ciò non accade, è importante distinguere un problema reale di salvataggio da un’istanza che è stata scollegata dal pattern. Un pattern scollegato diventa modificabile localmente e non riceve più automaticamente le modifiche apportate al pattern sincronizzato originale.

Sintomi e cause probabili

Sintomi da verificare

• La modifica viene salvata in un punto ma non compare nelle altre istanze del pattern.
• Una singola istanza può essere modificata senza influire sulle altre perché è stata scollegata dal pattern sincronizzato.
• L’editor segnala un errore durante il salvataggio oppure la modifica scompare dopo aver ricaricato la pagina.
• La richiesta utilizzata dall’editor per aggiornare il pattern restituisce un errore HTTP o una risposta non valida.
• La console del browser mostra un errore JavaScript durante la modifica o il salvataggio del pattern.

Cause probabili

• L’istanza è stata scollegata dal pattern sincronizzato e ora è un insieme di blocchi indipendenti.
• Il pattern viene modificato nell’editor ma il salvataggio dell’entità wp_block non viene completato.
• La richiesta REST verso l’endpoint dei blocchi viene rifiutata per sessione scaduta, autorizzazioni insufficienti o una regola di sicurezza.
• Un plugin, un’estensione del Block Editor o codice personalizzato genera un errore JavaScript o interferisce con il salvataggio.
• Una cache dell’editor o del browser mostra temporaneamente uno stato precedente anche dopo un salvataggio riuscito.

Diagnosi passo per passo

1. Verificare che il pattern sia ancora sincronizzato. Apri la gestione dei Pattern di WordPress e identifica il pattern originale. Se l’istanza problematica è stata scollegata, le modifiche locali non possono più propagarsi alle altre istanze.
2. Modificare direttamente il pattern originale. Applica una piccola modifica riconoscibile, salva e ricarica l’editor prima di verificare le altre pagine che utilizzano lo stesso pattern.
3. Controllare la richiesta di salvataggio nel browser. Negli strumenti di sviluppo apri la scheda Network e verifica la richiesta relativa a /wp-json/wp/v2/blocks/. Annota codice HTTP e risposta quando il salvataggio fallisce.
4. Controllare la console JavaScript. Errori JavaScript nell’editor possono interrompere il salvataggio o impedire l’aggiornamento dell’interfaccia anche quando l’editor resta visibile.
5. Confrontare l’orario con i log WordPress e PHP. Se la richiesta restituisce un errore lato server, cerca nello stesso intervallo temporale eventuali fatal error, eccezioni o blocchi di sicurezza.
6. Escludere un conflitto in ambiente di staging. Se il problema scompare disattivando selettivamente plugin che estendono Gutenberg o il Block Editor, identifica il componente responsabile senza modificare direttamente il sito di produzione.

Log e dati da controllare

• stato del pattern: sincronizzato oppure scollegato;
• ID del pattern e pagina in cui è presente l’istanza problematica;
• richiesta e risposta REST relativa a /wp/v2/blocks;
• codice HTTP restituito durante il salvataggio;
• console JavaScript del browser;
• WordPress debug.log ed error_log PHP nello stesso timestamp;
• eventuali log di WAF o plugin di sicurezza soltanto se la richiesta REST viene effettivamente bloccata.

Correzioni sicure

1. Modificare il pattern sincronizzato originale quando si vuole propagare la stessa modifica a tutte le istanze collegate.
2. Se un’istanza è stata scollegata e deve tornare sincronizzata, reinserire il pattern sincronizzato originale, verificando prima e copiando eventuali personalizzazioni locali che devono essere conservate.
3. Correggere l’errore REST o di autenticazione se il salvataggio del pattern viene rifiutato dal server.
4. Correggere il conflitto del Block Editor individuando plugin o codice che genera l’errore, preferibilmente tramite staging.
5. Pulire la cache pertinente soltanto dopo aver verificato che il salvataggio sia riuscito; la cache non sostituisce il controllo della risposta REST.
6. Evitare modifiche dirette alla tabella del database o al record wp_block quando il problema può essere risolto dall’interfaccia o correggendo la causa del mancato salvataggio.

Verifica finale

• Il pattern risulta ancora sincronizzato nella gestione dei Pattern.
• La modifica viene salvata senza errori nell’editor.
• La richiesta REST di aggiornamento termina con una risposta HTTP di successo.
• Dopo aver ricaricato l’editor, la modifica rimane presente.
• Le altre istanze sincronizzate mostrano la stessa modifica.
• Console JavaScript e log server non mostrano errori collegati al salvataggio.

Errori da evitare

• Non confondere un pattern scollegato con un errore di sincronizzazione.
• Non cancellare direttamente il record wp_block dal database per tentare di ricreare la sincronizzazione.
• Non disattivare globalmente firewall o protezioni del sito senza aver verificato che stiano realmente bloccando la richiesta di salvataggio.
• Non svuotare indiscriminatamente tutte le cache come primo tentativo: verifica prima se il pattern viene realmente salvato.
• Non modificare contemporaneamente più istanze durante la diagnosi, perché rende più difficile stabilire quale salvataggio abbia prodotto il risultato osservato.

Guide Xlogic correlate

• WordPress: template part duplicati nel Site Editor
• WordPress Gutenberg mostra una schermata bianca
• WordPress REST API rest_no_route: endpoint non trovato

Fonti tecniche

• WordPress.org — Synced Patterns (Reusable blocks)
• WordPress Theme Handbook — Introduction to Patterns
• WordPress REST API Handbook — Editor Blocks

Domande frequenti