Blocchi HTML: configurazione e aiuto

Avvio rapido

  1. Carica e installa lo ZIP HTML Blocks in Moduli > "Module Manager".
  2. Apri Blocchi HTML > Blocchi e crea un blocco con Nome interno e Contenuto tradotto.
  3. Lascia Titolo vuoto per il solo contenuto e Consenso cookie richiesto su Nessuno (mostra sempre) per un normale blocco di testo.
  4. Mantieni Attivo attivo e salva il blocco.
  5. Aggiungi "Display Location" displayFooter con "Layout" contained, oppure scegli un altro hook usato dal tema.
  6. Apri la pagina corrispondente del negozio in ogni lingua e conferma che il blocco appaia.
  7. 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.

Editor del blocco

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.

  1. Scansiona il tema attivo. I tipi di pagina supportati includono Prodotto, Categoria, Lista, Produttore, Fornitore, Tutti i marchi e CMS.
  2. Esamina file, posizione e chiamata hook proposti per il tipo di pagina.
  3. Accetta o inietta la posizione selezionata. Il gestore può modificare il template o creare un override extends dove supportato.
  4. Assegna un blocco esistente al profilo pagina e scegli layout e posizione d'inserimento.
  5. Mantieni il profilo attivo e salva le impostazioni.
  6. 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.

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?

HTML Blocks mostra l’HTML che salvi. Immagini grandi, video incorporati e script di terze parti possono aggiungere download o lavoro di esecuzione, quindi le prestazioni dipendono dai blocchi e dai media usati in ogni pagina. Mantieni ridotte le dimensioni dei media e controlla le pagine interessate dopo aver modificato un blocco.

Problemi noti

14

I posizionamenti dei blocchi salvati venivano mostrati male

RisoltoAggiornato:
Risolto nella versione: 1.12.12
I posizionamenti esistenti nei modelli potevano smettere di essere visualizzati, mentre i blocchi inseriti potevano perdere l'ordine o eseguire script più volte.

Il consenso per un singolo servizio veniva ignorato

RisoltoAggiornato:
Risolto nella versione: 1.12.12
I blocchi soggetti a consenso non rispettavano sempre l'autorizzazione del visitatore per un singolo servizio.

I controlli del tema si ripetevano su ogni pagina

RisoltoAggiornato:
Risolto nella versione: 1.12.12
Un tema già confermato poteva comunque generare una richiesta aggiuntiva di risorse del tema a ogni visualizzazione di pagina.

L'aggiornamento del modulo si fermava ai controlli di installazione

RisoltoAggiornato:
Risolto nella versione: 1.12.12
L'aggiornamento del modulo poteva interrompersi ed essere annullato durante i controlli del database.

Le traduzioni dell'amministrazione venivano visualizzate male

RisoltoAggiornato:
Risolto nella versione: 1.12.12
I testi di amministrazione del modulo potevano restare in inglese o mostrare escape danneggiati nelle lingue tradotte.

L'amministrazione e il posizionamento dei blocchi fallivano

RisoltoAggiornato:
Risolto nella versione: 1.11.1
L'apertura dell'amministrazione dei blocchi o la visualizzazione dei blocchi inseriti poteva fallire perché mancava il supporto richiesto per i blocchi.

Errori di compatibilità nel rilevamento del tema

RisoltoAggiornato:
Risolto nella versione: 1.11.0
Le pagine dei blocchi potevano fallire quando un altro modulo installato forniva un componente di rilevamento del tema precedente.

Le risorse del tema fallivano con i fogli di stile combinati

RisoltoAggiornato:
Risolto nella versione: 1.9.2
Le risorse di rilevamento del tema non funzionavano sempre quando PrestaShop combinava le risorse del negozio.

Le pagine pubbliche del modulo fallivano su alcune installazioni

RisoltoAggiornato:
Risolto nella versione: 1.9.2
Le richieste alle pagine pubbliche del modulo potevano fallire per via di una denominazione delle pagine incoerente.

Sicurezza rafforzata

RisoltoAggiornato:
Risolto nella versione: 1.9.2
Sicurezza rafforzata.

Una nuova installazione poteva fallire

RisoltoAggiornato:
Risolto nella versione: 1.6.7
Il modulo poteva non installarsi perché i requisiti di installazione erano incompleti.

La modifica del posizionamento dei blocchi falliva

RisoltoAggiornato:
Risolto nella versione: 1.6.5
La gestione del posizionamento dei blocchi poteva fallire perché mancava il supporto necessario per il posizionamento.

Gli elenchi dei blocchi non recuperavano i contenuti tradotti

RisoltoAggiornato:
Risolto nella versione: 1.6.5
L'amministrazione dei blocchi poteva non recuperare titoli e contenuti salvati dai record tradotti dei blocchi.

I filtri degli elenchi dei blocchi restituivano risultati errati

RisoltoAggiornato:
Risolto nella versione: 1.6.5
Il filtraggio degli elenchi di amministrazione non applicava sistematicamente i valori dei filtri selezionati.

Richieste funzionalità

8

Implementato

Controlli di stile del tema per i blocchi HTML

Implementato
Nella scheda degli stili del tema puoi regolare colori, bordi, angoli arrotondati e ombre dei blocchi HTML. Queste impostazioni del modulo ti permettono di adattare i blocchi all’aspetto del negozio.

Posizionamento visivo dei blocchi

Implementato
Scegli le posizioni dei blocchi con un selettore visivo e gestiscile nei modelli del tema o nelle schede prodotto.

Stili dei blocchi configurabili

Implementato
Configura lo stile dei blocchi per adattarlo al tema del negozio.

Layout dei blocchi nel contenitore di pagina

Implementato
Mostra i blocchi contenuti usando il contenitore di pagina del tema.

Amministrazione multilingue dei blocchi

Implementato
Usa i testi di amministrazione del modulo in tedesco, spagnolo, francese, italiano e polacco.

Aggiornamenti con un clic

Implementato
Aggiorna il modulo dalla sua pagina di amministrazione.

Blocchi soggetti al consenso

Implementato
Assegna i blocchi alle categorie di cookie e attivali nel browser dopo il consenso richiesto, anche sulle pagine nella cache.

Variabili di contenuto dinamiche

Implementato
Sostituisci le variabili di contenuto configurate con i loro valori nei titoli e nei contenuti dei blocchi scritti dal personale nelle posizioni supportate.

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.
Avvia il negozio demo

Scaricando, accetti le condizioni della demo e l’informativa sulla privacy.

Aprendo questa demo accetti i termini della demo e la politica sulla privacy.

Caricamento...
Torna su