Incolli un codice di incorporamento, premi Aggiorna e il flipbook sparisce. Questo articolo spiega esattamente perché WordPress elimina gli iframe, quali ruoli, editor e plugin ne sono la causa, e quali soluzioni sicure, passo dopo passo, fanno tornare il flipbook a funzionare in modo affidabile.
Incolli il codice di incorporamento di Flipbooks AI nella tua pagina WordPress, premi Aggiorna e il flipbook semplicemente scompare. L’editor mostra uno spazio vuoto, oppure il codice incollato è diventato testo normale, oppure una parte è sparita. Nel flipbook non c’è nulla di rotto. WordPress sta facendo ciò per cui è stato progettato: filtrare l’HTML di cui non si fida. Una volta capito quale filtro interviene, la soluzione di solito richiede cinque minuti.
Questo articolo esamina ogni causa comune, dai ruoli utente ai plugin di sicurezza, e ti propone un ordine chiaro in cui verificarle. Vedrai anche come scegliere un metodo di incorporamento che resista alle modifiche future, oltre a una checklist da riutilizzare su ogni sito di un cliente.
WordPress tratta ogni contenuto di un articolo come potenzialmente pericoloso. Un iframe carica un’intera altra pagina web dentro la tua, quindi è uno dei tag più rischiosi che un autore possa inserire. Per proteggere il sito, WordPress passa il contenuto attraverso un sanitizzatore chiamato KSES prima di salvarlo nel database. KSES mantiene un elenco di tag e attributi consentiti. Tutto ciò che non è nell’elenco viene cancellato in silenzio, senza avvisi né messaggi di errore.
Il dettaglio importante è che KSES non si applica a tutti allo stesso modo. Dipende da chi salva l’articolo. Ecco perché lo stesso codice di incorporamento funziona su un sito e fallisce su un altro, oppure funziona per te ma non per il tuo collega.
WordPress concede la capacità unfiltered_html agli Amministratori e agli Editor di una normale installazione su sito singolo. Gli utenti con quella capacità saltano KSES, quindi i loro iframe vengono salvati intatti. Autori e Collaboratori non ce l’hanno, quindi i loro iframe vengono eliminati.
Su WordPress Multisite, solo i Super Amministratori hanno unfiltered_html. Un normale Amministratore di sito all’interno di una rete non ce l’ha. Questo singolo fatto spiega una grande parte delle discussioni di supporto del tipo "il mio iframe sparisce".
Quando il filtro interviene, fa una di tre cose:
allowfullscreen, style o sandbox, quindi il flipbook si carica ma appare difettoso.💡 Controlla il risultato salvato passando l’editor alla vista codice. Quello che vedi lì è ciò che il database ha conservato, non ciò che hai incollato.
Prima di cambiare qualcosa, associa il sintomo alla causa più probabile. Così eviti di cliccare a caso.
| Sintomo | Causa più probabile | Prima soluzione da provare |
|---|---|---|
| L’iframe sparisce dopo il salvataggio | Il tuo ruolo non ha unfiltered_html | Accedi come Amministratore |
| Funziona per l’admin, non per l’autore | Filtro KSES per i ruoli inferiori | Usa uno shortcode o un blocco |
| L’iframe appare come testo normale | Incollato in un Paragrafo o nella scheda visuale | Usa un blocco HTML personalizzato |
| Il flipbook si carica ma non va a schermo intero | Attributi rimossi | Riaggiungi allowfullscreen nella vista codice |
| Riquadro vuoto solo sulla pagina pubblicata | Plugin di sicurezza o header CSP | Controlla plugin e impostazioni dell’header |
| Non funziona solo su Multisite | Non sei un Super Amministratore | Chiedi all’amministratore di rete |
L’errore più comune è incollare un iframe in un normale blocco Paragrafo. Gutenberg tratta allora il codice come testo da formattare. Il contenitore giusto è il blocco HTML personalizzato.
⚠️ Se dopo il salvataggio la pagina continua a non mostrare nulla, probabilmente il tuo ruolo viene filtrato. Passa alla Soluzione 2.
Se il tuo sito usa l’Editor classico, passa dalla scheda Visuale alla scheda Testo prima di incollare. La scheda Visuale usa TinyMCE, che riscrive o elimina i tag che non riconosce. Incolla nella scheda Testo, salva ed evita di tornare alla Visuale in seguito, perché questo passaggio può eliminare di nuovo il codice.
Se l’iframe sparisce per alcune persone e per altre no, confronta i loro ruoli. Ecco cosa può fare ciascun ruolo predefinito.
| Ruolo | Ha unfiltered_html (sito singolo) | Ha unfiltered_html (Multisite) | L’iframe sopravvive? |
|---|---|---|---|
| Amministratore | Sì | No | Sito singolo: sì |
| Editor | Sì | No | Sito singolo: sì |
| Autore | No | No | Di solito eliminato |
| Collaboratore | No | No | Eliminato |
| Super Amministratore | Non applicabile | Sì | Sì |
La soluzione più semplice è far inserire l’incorporamento una volta a un Amministratore, poi lasciare che gli Autori modifichino il testo che lo circonda. L’iframe salvato resta intatto finché nessuno modifica quello specifico blocco con un account filtrato.
💡 Non dare mai l’accesso da Amministratore solo per risolvere un incorporamento. Usa un’opzione più sicura tra quelle delle prossime sezioni.
Gli shortcode sono la soluzione più pulita per i team. Uno shortcode è un breve testo come [flipbook id="123"] che WordPress trasforma in HTML completo quando la pagina si carica. Poiché l’HTML viene generato sul server, KSES non vede mai il tag iframe nel contenuto salvato.
Aggiungi questo al file functions.php del tuo tema figlio oppure, meglio ancora, a un piccolo plugin personalizzato:
add_shortcode( 'flipbook', function ( $atts ) {
$atts = shortcode_atts( array(
'url' => '',
'height' => '600',
), $atts );
if ( empty( $atts['url'] ) ) {
return '';
}
$url = esc_url( $atts['url'] );
$height = intval( $atts['height'] );
return '<iframe src="' . $url . '" width="100%" height="' . $height . '" frameborder="0" allowfullscreen loading="lazy"></iframe>';
} );
Ora qualsiasi autore può scrivere [flipbook url="https://your-flipbook-link" height="650"] e l’iframe appare sulla pagina pubblicata. Il codice esegue l’escape dell’URL, quindi conservi la sicurezza che WordPress aveva previsto.
Se devi mantenere iframe grezzi nel contenuto degli articoli anche per i ruoli inferiori, puoi estendere l’elenco dei tag consentiti. È un’eccezione mirata, non una rimozione completa del filtro.
add_filter( 'wp_kses_allowed_html', function ( $tags, $context ) {
if ( 'post' === $context ) {
$tags['iframe'] = array(
'src' => true,
'width' => true,
'height' => true,
'frameborder' => true,
'allowfullscreen' => true,
'loading' => true,
'title' => true,
);
}
return $tags;
}, 10, 2 );
⚠️ Questo permette a ogni ruolo con diritti di modifica degli articoli di inserire qualsiasi iframe da qualsiasi dominio. Su un sito con molti autori, limitalo controllando l’host
srcoppure preferisci lo shortcode.
Se non puoi modificare il codice, un plugin che offre un blocco o uno shortcode iframe con una lista di domini consentiti fa lo stesso lavoro tramite una schermata di impostazioni.
A volte l’iframe viene salvato perfettamente e comunque non si vede. Questo indica il browser, non l’editor.
I plugin di firewall e di protezione possono eliminare o bloccare gli iframe da soli. Le cause più comuni sono:
Disattiva un plugin alla volta, svuota la cache e verifica di nuovo. Se il flipbook ricompare, apri le impostazioni di quel plugin e inserisci il dominio del flipbook nella lista consentita.
Un header Content-Security-Policy con una regola frame-src o default-src indica ai browser quali domini possono comparire nei frame. Se il dominio del tuo flipbook non è nell’elenco, il browser mostra un riquadro vuoto anche se l’HTML è corretto. Apri la console per sviluppatori del browser e cerca un messaggio che contenga "Refused to frame". Aggiungi il dominio del flipbook alla regola frame-src sul tuo server o nel plugin di sicurezza.
| Dove avviene il blocco | Come riconoscerlo | Dove intervenire |
|---|---|---|
| KSES di WordPress | Tag mancante nella vista codice | Ruolo, shortcode o filtro |
| Editor (TinyMCE) | Il codice cambia dopo il passaggio di scheda | Usa la scheda Testo o l’HTML personalizzato |
| Plugin di sicurezza | Tag salvato ma vuoto sulla pagina | Lista consentita del plugin |
| Header CSP | La console dice Refused to frame | Header del server o del plugin |
| Livello di cache | Pagina vecchia dopo la modifica | Svuota la cache |
Non tutti i casi richiedono un iframe. Elementor, Divi, Beaver Builder e altri builder simili includono un widget HTML o Incorpora che gestisce il codice grezzo senza KSES, perché il builder salva il contenuto nel proprio formato. Se il tuo sito usa già uno di questi, inserisci il flipbook in quel widget.
Come alternativa rapida, collega un pulsante o un’immagine di copertina accattivante direttamente all’URL pubblico del flipbook. I lettori ottengono l’esperienza completa della pagina e tu eviti tutti i filtri descritti sopra.
Ecco il processo completo, dal PDF alla pagina pubblicata. La prima volta richiede circa dieci minuti.
I flipbook non hanno filigrane, sono adattivi per i dispositivi mobili e supportano il marchio personalizzato in ogni piano. Analisi, generazione di contatti e download offline fanno parte del piano Professional, quindi controlla i prezzi se ti servono.
| Metodo | Competenza richiesta | Sopravvive ai cambi di ruolo | Ideale per |
|---|---|---|---|
| Blocco HTML personalizzato | Bassa | No | Singole pagine create dagli amministratori |
| Shortcode | Media | Sì | Team e molte pagine |
| Filtro KSES | Media | Sì | Siti con autori di fiducia |
| Widget del page builder | Bassa | Di solito | Siti Elementor o Divi |
| Pulsante con link diretto | Nessuna | Sì | Opzione rapida e a prova di filtro |
Un ristorante pubblica il suo menù come flipbook con il Creatore di flipbook per menù di ristoranti. Il titolare è un Editor, quindi un blocco HTML personalizzato funziona. L’assistente di marketing part-time è un Autore, quindi usa lo shortcode quando aggiorna le pagine stagionali.
Un’agenzia immobiliare pubblica gli immobili con il Creatore di brochure immobiliari. Gli agenti sono Autori sul sito aziendale e i loro iframe continuavano a sparire. Passare a un unico shortcode condiviso ha risolto il problema per tutto il team.
Un team di marketing su Multisite ha scoperto che anche gli Amministratori di sito perdevano i propri incorporamenti. L’amministratore di rete ha aggiunto un’autorizzazione filtrata per gli iframe, limitata al dominio del flipbook, e il problema è scomparso.
Una volta che l’iframe resta al suo posto, dedica due minuti alla presentazione.
✅ Prova su un telefono vero. La maggior parte dei lettori aprirà il tuo flipbook da dispositivo mobile, e una larghezza fissa in pixel può causare lo scorrimento laterale.
Conserva una versione in testo semplice del tuo codice di incorporamento in un posto sicuro. Se un filtro danneggia la versione salvata, puoi incollarla di nuovo in pochi secondi.
Controlla questo elenco ogni volta:
Un iframe che sparisce è quasi sempre un problema di permessi, non un problema del flipbook. Controlla il tipo di blocco, poi il ruolo utente, poi plugin e header, in questo ordine.
Pronto a trasformare il tuo prossimo PDF in una pubblicazione pulita e incorporabile? Inizia gratis su Flipbooks AI, sfoglia tutti gli strumenti per flipbook per trovare il modello giusto, oppure confronta i piani e prezzi per scegliere le funzioni di cui ha bisogno il tuo sito.
Scegli la tua lingua
