Blocs HTML : installation et aide

Téléversez et installez le ZIP HTML Blocks dans Modules > "Module Manager". Ouvrez Blocs HTML > Blocs. "Configure" ouvre la configuration du module ; la page Blocs contient l'éditeur de contenu.

Créez un bloc avec Nom interne, saisissez le Contenu dans vos langues et enregistrez. Ajoutez un emplacement pour l'afficher. Un bloc enregistré sans placement actif n'a pas de position dans la boutique.

Créez les blocs avec l’éditeur intégré; aucun fichier de modèle supplémentaire n’est nécessaire.

Pour un message de pied de page, vous pouvez saisir :

<div class="footer-trust">
  <strong>Secure payment</strong>
  <span>Pay using a payment method enabled in this shop.</span>
</div>

Définissez Nom interne sur Footer - Payment message, laissez Titre vide, utilisez Classe CSS footer-trust-block et gardez Consentement aux cookies requis sur Aucun (toujours afficher) pour un message textuel ordinaire.

Dans le panneau de placement du bloc, choisissez "Display Location" et Mise en page, puis ajoutez l'emplacement. L'aperçu visuel ouvre la boutique avec des marqueurs de hooks pour examiner les positions prises en charge. Le thème doit réellement afficher le hook pour que le placement apparaisse.

Vous pouvez réutiliser un bloc à plusieurs emplacements. L'action de placement ne permet pas d'ajouter deux fois le même bloc au même hook natif.

Les emplacements disponibles comprennent :

Pour une bannière d'accueil, utilisez displayHomeIntro, Mise en page full-width et une classe adaptée comme homepage-seasonal-banner. Pour un message de pied de page, utilisez displayFooter et contained.

Créez le bloc traduit, définissez Titre comme libellé d'onglet et ajoutez displayProductTabContent comme emplacement. Le module fournit le libellé et le contenu via les hooks d'onglets produit. Votre thème doit prendre ces hooks en charge.

Pour un onglet Livraison, utilisez Nom interne Product - Delivery Tab et Titre Delivery. Ajoutez vos informations de livraison et enregistrez. Vérifiez l'onglet sur une véritable page produit, avec son libellé et son contenu dans chaque langue.

Le libellé et le contenu de l’onglet produit suivent tous deux l’exigence de consentement du bloc.

Utilisez Blocs HTML > Modèles lorsque le thème n'a pas de hook natif adapté à la position souhaitée. Sauvegardez d'abord le thème. Le processus PHP doit pouvoir écrire dans les fichiers du thème concernés ou le chemin d'override du thème enfant, ainsi que dans le cache PrestaShop.

1. Analysez le thème actif. Les types de pages pris en charge incluent Produit, Catégorie, Liste, Fabricant, Fournisseur, Toutes les marques et CMS.
2. Examinez le fichier, la position et l'appel de hook proposés pour ce type de page.
3. Acceptez ou injectez la position choisie. Le gestionnaire peut modifier le template ou créer un override extends lorsque c'est pris en charge.
4. Affectez un bloc existant au profil de page et choisissez sa mise en page et sa position d'insertion.
5. Gardez le profil actif et enregistrez ses paramètres.
6. Ouvrez une page correspondante de la boutique et vérifiez l'emplacement.

Le gestionnaire insère du contenu Smarty balisé avec le hook du module :

{* MPR_HTMLBLOCK_INJECT *}
{hook h='displayMprHtmlBlock'}
{* /MPR_HTMLBLOCK_INJECT *}

Les appels générés peuvent inclure des paramètres propres à la page. Conservez-les avec l'appel suggéré par le gestionnaire. Un développeur peut aussi placer {hook h='displayMprHtmlBlock'} manuellement, en tenant compte du contexte de page et des placements prévus.

Le profil est actif par défaut. Après une mise à jour du thème, utilisez Vérifier le statut. Si les marqueurs manquent ou si la position est périmée, relancez l'analyse avant de réinjecter. Tout supprimer retire les injections suivies. Utilisez le gestionnaire pour retirer une position suivie plutôt que supprimer des fragments de marqueurs à la main.

Le placement par sélecteur est également pris en charge. Utilisez les hooks natifs ou Template Manager pour une configuration ordinaire ; le placement par sélecteur dépend d'un balisage stable du thème.

Pour les intégrations ou scripts optionnels, choisissez une catégorie dans Consentement aux cookies requis. Le module émet du contenu encodé inerte et l'insère dans le navigateur uniquement lorsque le client MPR Cookies Revolution expose une autorisation pour cette catégorie. Sans décision, en cas de refus ou sans client MPRCR utilisable, le contenu conditionné reste absent. Le retrait du consentement supprime le contenu inséré.

Ce cycle s'applique aux hooks natifs, placements dans les templates, placements par sélecteur et onglets produit. La catégorie propre à un bloc peut également être insuffisante pour un script intégré qui exige une autre catégorie.

Ne conditionnez pas le texte essentiel de la page au consentement. Un contenu conditionné peut apparaître après le chargement, déplacer la mise en page et rester absent pour les robots sans consentement. Utilisez Aucun (toujours afficher) pour le contenu qui doit toujours être présent.

Ne fabriquez pas manuellement de cookies de consentement. Les noms de catégories de l'intégration sont functional, analytics et marketing ; le module de consentement gère la décision du visiteur.

Ouvrez Blocs HTML > Paramètres > Configuration > Styles du thème. L'éditeur de styles partagé part des valeurs détectées du thème et permet de les remplacer. Utilisez "Refresh shop styles" après un changement de thème. Utilisez "Clear custom styles" pour revenir aux valeurs détectées.

Le module associe arrière-plan, arrière-plan secondaire, bordure, texte, texte atténué, rayon, ombre et transition à ses tokens de style mpr-card. Dans l'éditeur partagé, ils correspondent à "Primary surface", "Secondary", bordure "Normal", texte "Body" et "Muted", "Default radius", "Default shadow" et "Transition". Les overrides existants de la boutique peuvent modifier les valeurs.

Pour du CSS local, utilisez votre Classe CSS et l'enveloppe stable du contenu :

.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'éditeur standard n'a pas de champs de planification début/fin, de ciblage par groupe client ni par ID de produit/catégorie. Utilisez selon le cas les interrupteurs d'activation du bloc, du placement et du profil de page.

Vérifiez le bloc dans chaque langue, à chaque emplacement affecté et aux largeurs téléphone et bureau. Désactivez un placement pour confirmer que les autres restent disponibles. Désactivez tout le bloc pour masquer tous ses placements.

Pour un bloc conditionné, testez les états indécis, accordé, refusé et retiré dans un navigateur où le module de consentement fonctionne. Vérifiez le libellé et le panneau de l'onglet produit si vous utilisez des onglets.

Si rien n'apparaît, vérifiez Actif du bloc, Actif du placement, contenu de langue, Actif du profil et affichage du hook par le thème. Pour un contenu conditionné, vérifiez la décision de consentement et les erreurs JavaScript du navigateur. Pour une position injectée, lancez Vérifier le statut et examinez le fichier template proposé.

Si un titre reste visible après avoir choisi Pas de titre, effacez le champ Titre. Le template actuel affiche un titre non vide avec une balise vide dans un div.

Utilisez Paramètres > Intégrité pour vérifier et réparer les tables requises du module. Si styles ou contenus restent périmés, videz les caches PrestaShop et page/CDN concernés et vérifiez les overrides des templates du thème.

Sauvegardez blocs, placements et thème avant de désinstaller. Le module retire les injections de templates suivies avant de supprimer les entrées de menu et d'appeler le nettoyage du schéma. S'il ne peut pas retirer les injections, la désinstallation signale un échec pour permettre de corriger l'accès aux fichiers et réessayer. Les tables du module sont supprimées par le nettoyage du schéma ; exportez d'abord les contenus à conserver.

Nécessite PrestaShop 1.6.1 ou une version ultérieure et PHP 7.1 ou une version ultérieure.