Blocchi HTML: configurazione e aiuto
Avvio rapido
- Carica e installa lo ZIP HTML Blocks in Moduli > "Module Manager".
- Apri Blocchi HTML > Blocchi e crea un blocco con Nome interno e Contenuto tradotto.
- Lascia Titolo vuoto per il solo contenuto e Consenso cookie richiesto su Nessuno (mostra sempre) per un normale blocco di testo.
- Mantieni Attivo attivo e salva il blocco.
- Aggiungi "Display Location" displayFooter con "Layout" contained, oppure scegli un altro hook usato dal tema.
- Apri la pagina corrispondente del negozio in ogni lingua e conferma che il blocco appaia.
- Usa Blocchi HTML > Modelli solo se devi creare una posizione in un template del tema, poi controllala con Controlla stato.
Richiede PrestaShop 1.6.1 o successivo e PHP 7.1 o successivo.
Manuale di configurazione
Installare e creare un blocco
Carica e installa lo ZIP HTML Blocks in Moduli > "Module Manager". Apri Blocchi HTML > Blocchi. "Configure" apre la configurazione del modulo; la pagina Blocchi contiene l'editor dei contenuti.
Crea un blocco con Nome interno, inserisci Contenuto per le tue lingue e salva. Aggiungi una posizione di visualizzazione per farlo apparire. Un blocco salvato senza collocazione attiva non ha una posizione nel negozio.
Crea i blocchi con l’editor integrato; non è necessario un file di modello aggiuntivo.
Modificare il contenuto del blocco
| Campo | Predefinito | Come usarlo |
|---|---|---|
| Nome interno | Vuoto | Identificativo amministrativo obbligatorio. Non appare nel negozio. |
| Titolo | Vuoto | Testo tradotto opzionale sopra il contenuto. Lascialo vuoto per il solo contenuto. |
| Tag titolo | Nessun titolo / vuoto | Le scelte sono Nessun titolo, h2, h3, h4, h5, span e p. Un Titolo non vuoto con tag vuoto appare comunque in un div. Svuota Titolo per nasconderlo. |
| Consenso cookie richiesto | Nessuno (mostra sempre) | Scegli Funzionale, Analitica o "Marketing" solo per contenuti opzionali che devono attendere quella categoria di consenso. |
| Contenuto | Vuoto | HTML tradotto, modificato con l'editor di testo avanzato PrestaShop. |
| Classe CSS | Vuoto | Classe o classi del contenitore esterno. Il renderer mantiene lettere, numeri, spazi, trattini bassi e trattini. |
| Attivo | Attivo | Disattiva l'intero blocco senza eliminarlo. |
Per un messaggio nel footer puoi inserire:
<div class="footer-trust">
<strong>Secure payment</strong>
<span>Pay using a payment method enabled in this shop.</span>
</div>
Imposta Nome interno su Footer - Payment message, lascia Titolo vuoto, usa Classe CSS footer-trust-block e mantieni Consenso cookie richiesto su Nessuno (mostra sempre) per un normale messaggio di testo.

Assegnare posizioni di hook nativi
Nel pannello di collocazione del blocco, scegli "Display Location" e "Layout", poi aggiungi la posizione. L'anteprima visiva apre il negozio con marcatori degli hook per esaminare le posizioni supportate. Il tema deve effettivamente renderizzare l'hook affinché la collocazione appaia.
| Opzione di collocazione | Predefinito | Effetto |
|---|---|---|
| "Display Location" | Devi scegliere un hook | Scegli dove appare il blocco. Il modello di collocazione sottostante usa di default displayMprHtmlBlock; non sostituisce la scelta di una posizione nativa reale. |
| "Layout" | contained |
Usa il contenitore del tema, oppure scegli full-width per contenuti larghi quanto la finestra. |
| Attivo | Attivo | Nasconde una collocazione mantenendo attive le altre. |
| "Sort Order" | Prossima posizione disponibile per una nuova collocazione hook | Ordina i blocchi nella stessa posizione. Il valore predefinito memorizzato è 0. |
Puoi riusare un blocco in più posizioni. L'azione di collocazione non consente di aggiungere due volte lo stesso blocco allo stesso hook nativo.
Le posizioni disponibili includono:
| Area | Hook |
|---|---|
| Homepage | displayHomeIntro, displayHome |
| Prodotto | displayProductAdditionalInfo, displayAfterProductThumbs, displayFooterProduct, displayReassurance, displayProductTabContent, displayLeftColumnProduct, displayRightColumnProduct |
| Liste | displayHeaderCategory, displayFooterCategory |
| Layout | displayWrapperTop, displayContentWrapperTop, displayContentWrapperBottom, displayWrapperBottom, displayLeftColumn, displayRightColumn |
| Header | displayBanner, displayNav1, displayNav2, displayTop, displayNavFullWidth |
| Footer | displayFooterBefore, displayFooter, displayFooterAfter |
| Carrello e checkout | displayShoppingCart, displayShoppingCartFooter, displayExpressCheckout |
| Altro | displayOrderConfirmation1, displayOrderConfirmation2, displayCustomerAccount |
Per un banner homepage, usa displayHomeIntro, "Layout" full-width e una classe adatta come homepage-seasonal-banner. Per un messaggio footer, usa displayFooter e contained.
Aggiungere una scheda prodotto
Crea il blocco tradotto, imposta Titolo come etichetta della scheda e aggiungi displayProductTabContent come posizione. Il modulo fornisce etichetta e contenuto tramite hook delle schede prodotto. Il tema deve supportarli.
Per una scheda Consegna, usa Nome interno Product - Delivery Tab e Titolo Delivery. Aggiungi le informazioni di consegna e salva. Controlla la scheda su una vera pagina prodotto, compresi etichetta e contenuto in ogni lingua.
L’etichetta e il contenuto della scheda prodotto seguono entrambi il requisito di consenso del blocco.
Aggiungere posizioni con Template Manager
Usa Blocchi HTML > Modelli quando il tema non ha un hook nativo adatto nella posizione richiesta. Salva prima una copia del tema. Il processo PHP deve poter scrivere nei file del tema interessati o nel percorso override del tema figlio, oltre che nella cache PrestaShop.
- Scansiona il tema attivo. I tipi di pagina supportati includono Prodotto, Categoria, Lista, Produttore, Fornitore, Tutti i marchi e CMS.
- Esamina file, posizione e chiamata hook proposti per il tipo di pagina.
- Accetta o inietta la posizione selezionata. Il gestore può modificare il template o creare un override extends dove supportato.
- Assegna un blocco esistente al profilo pagina e scegli layout e posizione d'inserimento.
- Mantieni il profilo attivo e salva le impostazioni.
- Apri una pagina corrispondente del negozio e controlla la posizione.
Il gestore inserisce contenuto Smarty contrassegnato usando l'hook del modulo:
{* MPR_HTMLBLOCK_INJECT *}
{hook h='displayMprHtmlBlock'}
{* /MPR_HTMLBLOCK_INJECT *}
Le chiamate generate possono includere parametri specifici della pagina. Mantienili quando usi la chiamata suggerita dal gestore. Uno sviluppatore può anche inserire manualmente {hook h='displayMprHtmlBlock'}, ma deve considerare contesto pagina e collocazioni previsti.
Il profilo è attivo per impostazione predefinita. Dopo un aggiornamento del tema, usa Controlla stato. Se mancano marcatori o la posizione è obsoleta, scansiona di nuovo prima di reiniettare. Rimuovi tutto rimuove le iniezioni tracciate. Usa il gestore per rimuovere una posizione tracciata anziché eliminare frammenti dei marcatori a mano.
Esiste anche il supporto alle collocazioni tramite selettore. Usa hook nativi o Template Manager per la configurazione ordinaria; le collocazioni tramite selettore dipendono da markup stabile del tema.
Configurare contenuti dipendenti dal consenso
Per incorporamenti o script opzionali, scegli una categoria in Consenso cookie richiesto. Il modulo emette contenuto codificato inerte e lo inserisce nel browser solo quando il client MPR Cookies Revolution espone un consenso per quella categoria. Senza decisione, con rifiuto o senza client MPRCR utilizzabile, il contenuto vincolato resta assente. Ritirare il consenso rimuove il contenuto inserito.
Questo ciclo vale per hook nativi, collocazioni nei template, tramite selettore e schede prodotto. La categoria del blocco può anche essere insufficiente per uno script incorporato che richiede un'altra categoria.
Non vincolare al consenso il testo essenziale della pagina. I contenuti dipendenti dal consenso possono apparire dopo il caricamento, spostare il layout e restare assenti per crawler senza consenso. Usa Nessuno (mostra sempre) per contenuti che devono essere sempre presenti.
Non falsificare manualmente i cookie di consenso. I nomi delle categorie usati dall'integrazione sono functional, analytics e marketing; il modulo consenso gestisce la decisione del visitatore.
Adattare al tema
Apri Blocchi HTML > Impostazioni > Configurazione > Stili del tema. L'editor stili condiviso parte dai valori rilevati del tema e permette di sovrascriverli. Usa "Refresh shop styles" dopo un cambio tema. Usa "Clear custom styles" per tornare ai valori rilevati.
Il modulo mappa sfondo, sfondo secondario, bordo, testo, testo attenuato, raggio, ombra e transizione sui token di stile mpr-card. Nell'editor condiviso corrispondono a "Primary surface", "Secondary", bordo "Normal", testo "Body" e "Muted", "Default radius", "Default shadow" e "Transition". Gli override esistenti del negozio possono modificare i valori.
Per il CSS locale, usa la tua Classe CSS e il contenitore stabile dei contenuti:
.mpr-html-block-content img { max-width: 100%; height: auto; }
.mpr-html-block-content table { width: 100%; border-collapse: collapse; }
.footer-trust-block .mpr-html-block-content {
display: flex;
gap: 1rem;
align-items: center;
}
.homepage-seasonal-banner.mpr-html-block-full-width {
padding-top: 2rem;
padding-bottom: 2rem;
}
L'editor standard non ha campi di pianificazione inizio/fine, targeting per gruppi clienti o per ID di prodotto/categoria. Usa gli interruttori di attivazione di blocco, collocazione e profilo pagina secondo necessità.
Verificare e risolvere problemi
Controlla il blocco in ogni lingua, in ogni posizione assegnata e a larghezze telefono e desktop. Disattiva una collocazione per confermare che le altre restino disponibili. Disattiva l'intero blocco per nascondere tutte le collocazioni.
Per un blocco vincolato, prova gli stati indeciso, consenso, rifiuto e ritiro in un browser con il modulo consenso attivo. Se usi schede, controlla sia etichetta sia pannello della scheda prodotto.
Se non appare nulla, controlla Attivo del blocco, Attivo della collocazione, contenuto linguistico, Attivo del profilo e rendering dell'hook nel tema. Per contenuti vincolati, controlla decisione del consenso ed errori JavaScript nel browser. Per una posizione iniettata, esegui Controlla stato ed esamina il file template proposto.
Se un titolo resta visibile dopo aver scelto Nessun titolo, svuota il campo Titolo. Il template attuale renderizza un titolo non vuoto con tag vuoto in un div.
Usa Impostazioni > Integrità per controllare e riparare le tabelle richieste del modulo. Se stili o contenuti restano obsoleti, svuota le cache PrestaShop e pagina/CDN pertinenti e controlla gli override dei template del tema.
Disinstallare
Salva blocchi, collocazioni e tema prima di disinstallare. Il modulo rimuove le iniezioni tracciate nei template prima di eliminare le voci di menu e chiamare la pulizia dello schema. Se non riesce a rimuoverle, la disinstallazione segnala un errore per consentirti di correggere l'accesso ai file e riprovare. Le tabelle del modulo vengono rimosse dalla pulizia dello schema; esporta prima i contenuti da conservare.
Compatibilità
Richiede PrestaShop 1.6.1 o successivo e PHP 7.1 o successivo.
Domande
1
Il contenuto dei miei blocchi può influire sul caricamento delle pagine?
Problemi noti
14
I posizionamenti dei blocchi salvati venivano mostrati male
Il consenso per un singolo servizio veniva ignorato
I controlli del tema si ripetevano su ogni pagina
L'aggiornamento del modulo si fermava ai controlli di installazione
Le traduzioni dell'amministrazione venivano visualizzate male
L'amministrazione e il posizionamento dei blocchi fallivano
Errori di compatibilità nel rilevamento del tema
Le risorse del tema fallivano con i fogli di stile combinati
Le pagine pubbliche del modulo fallivano su alcune installazioni
Sicurezza rafforzata
Una nuova installazione poteva fallire
La modifica del posizionamento dei blocchi falliva
Gli elenchi dei blocchi non recuperavano i contenuti tradotti
I filtri degli elenchi dei blocchi restituivano risultati errati
Richieste funzionalità
8
Implementato
Controlli di stile del tema per i blocchi HTML
Posizionamento visivo dei blocchi
Stili dei blocchi configurabili
Layout dei blocchi nel contenitore di pagina
Amministrazione multilingue dei blocchi
Aggiornamenti con un clic
Blocchi soggetti al consenso
Variabili di contenuto dinamiche
Registro modifiche
v1.6.72026-06-18
- AddedAdd configurable theme styles
- Addedcomplete FR/DE/ES/IT/PL translations
- FixedRepair install schema and release packaging
Versioni precedenti
v1.3.02026-02-02
- AddedUse Bootstrap container for contained blocks, bump to v1.6.0
- Addedself-healing integrity checks for automatic diagnostics and repair
- Addedautomatic theme detection for Classic and Hummingbird style compatibility
- AddedLicense management tab with key management and renewal options
- Addedcomplete FR/DE/ES/IT/PL translations
- FixedSelect title/content from block_lang table, not block
- FixedAdd missing HtmlBlockPlacement ObjectModel class
- Fixedadmin list filters — sorting, searching, and filtering now work correctly on all columns
v1.2.02025-10-28
- Addedfull compatibility with PrestaShop 9.x and Hummingbird theme
- Addedconditional display rules: show/hide blocks by customer group, device type, or date range
- ImprovedWYSIWYG editor integration — TinyMCE 6 with custom toolbar configuration
- Fixedblock not rendering when hook name contained uppercase characters
- Addedshortcode support: {customer_name}, {shop_name}, {current_date} auto-replaced at render
v1.1.02025-09-01
- Addedblock scheduling: set start and end datetimes for seasonal campaigns
- Improvedmulti-shop support — blocks can be scoped to specific shops or shared globally
- FixedXSS sanitization incorrectly stripping valid <iframe> embed codes
- Addedblock preview button in admin list without needing to visit the front-office
v1.0.02025-03-31
- Initialrelease: custom HTML block manager for any PrestaShop hook
- InitialUnlimited blocks per hook with drag-and-drop position ordering
- InitialFull WYSIWYG editor with raw HTML fallback mode
- InitialMulti-language block content with per-language enable/disable toggle
Demo
Prova il modulo completo prima di acquistare
Acquista la licenza in seguito e mantieni le tue impostazioni.
- La tua demo di 30 giorni Provalo sul tuo negozio per 30 giorni dalla prima installazione.
- Negozio demo pronto Esplora un negozio demo pronto nel tuo browser.
- Senza registrazione Nessun account, e-mail o dominio del negozio richiesto.
Scaricando, accetti le condizioni della demo e l’informativa sulla privacy.
Aprendo questa demo accetti i termini della demo e la politica sulla privacy.