HTML-Blöcke: Einrichtung und Hilfe

Laden Sie die HTML Blocks-ZIP unter Modul > "Module Manager" hoch und installieren Sie sie. Öffnen Sie HTML-Blöcke > Blöcke. "Configure" öffnet die Modulkonfiguration; die Seite Blöcke enthält den Inhaltseditor.

Erstellen Sie einen Block mit Interner Name, geben Sie Inhalt für Ihre Sprachen ein und speichern Sie. Ergänzen Sie einen Anzeigeort, damit er erscheint. Ein gespeicherter Block ohne aktive Platzierung hat keine Position im Shop.

Erstellen Sie Blöcke mit dem integrierten Editor; eine zusätzliche Modelldatei ist nicht erforderlich.

Für eine Fußzeilenmeldung können Sie Folgendes eingeben:

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

Setzen Sie Interner Name auf Footer - Payment message, lassen Sie Titel leer, verwenden Sie CSS-Klasse footer-trust-block und belassen Sie Cookie-Einwilligung erforderlich für eine gewöhnliche Textmeldung auf Keiner (immer anzeigen).

Wählen Sie im Platzierungsbereich des Blocks "Display Location" und "Layout" und fügen Sie die Position hinzu. Die visuelle Vorschau öffnet den Shop mit Hookmarkierungen, um unterstützte Positionen zu prüfen. Das Theme muss den Hook tatsächlich ausgeben, damit die Platzierung erscheint.

Sie können einen Block an mehreren Orten wiederverwenden. Derselbe Block lässt sich über die Platzierungsaktion nicht zweimal demselben nativen Hook hinzufügen.

Verfügbare Positionen umfassen:

Verwenden Sie für ein Startseitenbanner displayHomeIntro, "Layout" full-width und eine geeignete Klasse wie homepage-seasonal-banner. Für eine Fußzeilenmeldung verwenden Sie displayFooter und contained.

Erstellen Sie den übersetzten Block, setzen Sie Titel auf die Reiterbeschriftung und ergänzen Sie displayProductTabContent als Anzeigeort. Das Modul liefert Beschriftung und Inhalt über Produktreiterhooks. Ihr Theme muss diese unterstützen.

Verwenden Sie für einen Lieferreiter Interner Name Product - Delivery Tab und Titel Delivery. Ergänzen Sie Ihre Lieferinformationen und speichern Sie. Prüfen Sie den Reiter auf einer tatsächlichen Produktseite einschließlich Beschriftung und Inhalt in jeder Sprache.

Die Beschriftung und der Inhalt des Produktreiters folgen beide der Einwilligungsanforderung des Blocks.

Verwenden Sie HTML-Blöcke > Vorlagen, wenn das Theme an der gewünschten Stelle keinen passenden nativen Hook bietet. Sichern Sie zuerst das Theme. Der PHP-Prozess benötigt Schreibzugriff auf betroffene Themedateien oder den Child-Theme-Overridepfad sowie den PrestaShop-Cache.

1. Scannen Sie das aktive Theme. Unterstützte Seitentypen umfassen Produkt, Kategorie, Liste, Hersteller, Lieferant, alle Marken und CMS.
2. Prüfen Sie vorgeschlagene Datei, Position und Hookaufruf für den Seitentyp.
3. Akzeptieren oder injizieren Sie die gewählte Position. Der Manager kann das Template ändern oder, soweit unterstützt, ein extends-Override erstellen.
4. Weisen Sie dem Seitenprofil einen vorhandenen Block zu und wählen Sie Layout und Einfügeposition.
5. Lassen Sie das Profil aktiv und speichern Sie seine Einstellungen.
6. Öffnen Sie eine passende Shopseite und prüfen Sie die Position.

Der Manager fügt markierten Smarty-Inhalt mit dem Modulhook ein:

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

Generierte Aufrufe können seitenspezifische Parameter enthalten. Bewahren Sie diese beim vorgeschlagenen Aufruf des Managers. Ein Entwickler kann {hook h='displayMprHtmlBlock'} auch manuell platzieren, muss aber den vorgesehenen Seitenkontext und die Platzierungen berücksichtigen.

Das Profil ist standardmäßig aktiv. Verwenden Sie nach einem Themeupdate Status prüfen. Fehlen Markierungen oder ist die Position veraltet, scannen Sie vor dem erneuten Injizieren noch einmal. Alle entfernen entfernt erfasste Injektionen. Entfernen Sie erfasste Positionen über den Manager, statt Markierungsfragmente von Hand zu löschen.

Auch selektorbasierte Platzierung wird unterstützt. Verwenden Sie für die normale Einrichtung native Hooks oder Template Manager; Selektorplatzierungen benötigen stabiles Thememarkup.

Wählen Sie für optionale Einbettungen oder Skripte eine Kategorie unter Cookie-Einwilligung erforderlich. Das Modul gibt inerten kodierten Inhalt aus und fügt ihn erst im Browser ein, wenn der MPR Cookies Revolution-Client eine Einwilligung für diese Kategorie bereitstellt. Ohne Entscheidung, bei Ablehnung oder ohne nutzbaren MPRCR-Client bleibt der gesperrte Inhalt aus. Widerruf entfernt eingefügten Inhalt.

Dieser Lebenszyklus gilt für native Hooks, Templateplatzierungen, Selektorplatzierungen und Produktreiter. Die eigene Kategorie eines Blocks kann für ein eingebettetes Skript, das eine andere Kategorie benötigt, ebenfalls unzureichend sein.

Lassen Sie wesentlichen Seitentext ohne Einwilligungssperre. Einwilligungsabhängiger Inhalt kann nach dem Laden erscheinen, das Layout verschieben und für Crawler ohne Einwilligung fehlen. Verwenden Sie Keiner (immer anzeigen) für Inhalte, die immer vorhanden sein sollen.

Fälschen Sie keine Einwilligungscookies manuell. Die Integration verwendet die Kategorienamen functional, analytics und marketing; das Einwilligungsmodul verwaltet die Besucherentscheidung.

Öffnen Sie HTML-Blöcke > Einstellungen > Konfiguration > Theme-Stile. Der gemeinsame Stileditor beginnt mit erkannten Themewerten und erlaubt eigene Werte. Verwenden Sie nach einem Themewechsel "Refresh shop styles". Mit "Clear custom styles" kehren Sie zu erkannten Werten zurück.

Das Modul ordnet Hintergrund, sekundären Hintergrund, Rahmen, Text, gedämpften Text, Radius, Schatten und Übergang seinen mpr-card-Stiltokens zu. Im gemeinsamen Editor entsprechen sie "Primary surface", "Secondary", Rahmen "Normal", Text "Body" und "Muted", "Default radius", "Default shadow" und "Transition". Bestehende Shop-Overrides können die Werte ändern.

Verwenden Sie für lokales CSS Ihre CSS-Klasse und den stabilen Inhaltswrapper:

.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;
}

Der Standardblockeditor enthält keine Zeitplanfelder für Beginn/Ende, Kundengruppenauswahl oder Zielauswahl nach Produkt-/Kategorie-ID. Verwenden Sie je nach Bedarf die Aktivschalter für Block, Platzierung und Seitenprofil.

Prüfen Sie den Block in jeder Sprache, an jedem zugewiesenen Ort und bei Telefon- und Desktopbreiten. Deaktivieren Sie eine Platzierung, um zu bestätigen, dass die anderen verfügbar bleiben. Deaktivieren Sie den gesamten Block, um alle Platzierungen auszublenden.

Testen Sie bei einem gesperrten Block unentschiedene, erteilte, verweigerte und widerrufene Einwilligung im Browser mit laufendem Einwilligungsmodul. Prüfen Sie bei Reitern sowohl Produktreiterbeschriftung als auch Inhalt.

Erscheint nichts, prüfen Sie Aktiv des Blocks, Aktiv der Platzierung, Sprachinhalt, Aktiv des Profils und die Hookausgabe des Themes. Bei gesperrtem Inhalt prüfen Sie die Einwilligungsentscheidung und JavaScript-Fehler im Browser. Führen Sie bei injizierten Positionen Status prüfen aus und prüfen Sie die vorgeschlagene Templatedatei.

Bleibt ein Titel nach Auswahl von Kein Titel sichtbar, leeren Sie Titel. Das aktuelle Template gibt nicht leere Titel mit leerem Tag in einem div aus.

Verwenden Sie Einstellungen > Integrität, um erforderliche Modultabellen zu prüfen und zu reparieren. Bleiben Stile oder Inhalte veraltet, leeren Sie betroffene PrestaShop- und Seiten-/CDN-Caches und prüfen Sie Themetemplate-Overrides.

Sichern Sie Blöcke, Platzierungen und Theme vor der Deinstallation. Das Modul entfernt erfasste Templateinjektionen, bevor es Menüeinträge entfernt und die Schemabereinigung aufruft. Lassen sich Injektionen nicht entfernen, meldet die Deinstallation einen Fehler, damit Sie Dateizugriffe korrigieren und erneut versuchen können. Moduleigene Tabellen werden durch die Schemabereinigung entfernt; exportieren Sie vorher benötigte Inhalte.

Erfordert PrestaShop 1.6.1 oder höher und PHP 7.1 oder höher.