Kennzeichnungen für Produktpakete: Einrichtung und Hilfe

Öffnen Sie im Backoffice Module > "Module Manager", wählen Sie "Upload a module" und laden Sie die ZIP-Datei des Moduls hoch. Installieren Sie es und klicken Sie anschließend auf "Configure". Verwenden Sie bei älteren PrestaShop-Versionen die entsprechende Modulseite.

Öffnen Sie Einstellungen für Pack-Produkte und lassen Sie Pack-Badges aktivieren eingeschaltet. Die Standardeinstellung ist Ja. Dies ist die einzige Einstellung für das Pack-Verhalten. Sie steuert die Kennzeichnung in Produktlisten, die Markierung vor dem Preis, die enthaltenen Produkte und die URL-Hilfe für Routen, die nur aus einem Rewrite bestehen.

Erfordert PrestaShop 1.7 oder neuer und PHP 7.1 oder neuer.

Ändern Sie die Artikelnummer jedes betreffenden Produkts so, dass sie mit mpr-pack- beginnt, zum Beispiel mpr-pack-starter, mpr-pack-seo-tools oder mpr-pack-bathroom-kit. Speichern Sie das Produkt und öffnen Sie eine Liste, die es enthält. Der native Pack-Status von PrestaShop allein entspricht nicht der Erkennungsregel dieses Moduls.

Die Beschriftung Paket wird, soweit verfügbar, über actionProductFlagsModifier bereitgestellt, damit das Theme sie mit seinen nativen Kennzeichnungen darstellen kann. Eine vorhandene native Pack-Kennzeichnung bleibt erhalten. JavaScript ergänzt bei Bedarf eine .product-flag.pack im nativen Stil in der Kennzeichnungsliste des Themes. Nur Karten ohne eine solche Liste verwenden das Fallback-Overlay .mpr-pack-badge des Moduls.

Der Hook displayProductListReviews gibt den Pack-Indikator mit dem Text "Bundle: Save Big" aus. Dieser Text ist eine Anzeigebeschriftung; das Modul berechnet keine Ersparnisse und erstellt keine Rabatte. Es fügt keine spezielle Klasse für Rahmen oder Schatten von Pack-Karten hinzu. Das Aussehen der Karten bestimmen weiterhin die Theme-Stile.

Die Modulkonfiguration enthält keinen Inhaltseditor. Lassen Sie Ihren Datenbankadministrator die Zuordnung vom Pack zum Produkt in die Tabelle mpr_pack_content mit Ihrem Tabellenpräfix eintragen. Ersetzen Sie ps_ durch Ihr tatsächliches Tabellenpräfix und verwenden Sie echte Produkt-IDs:

INSERT INTO ps_mpr_pack_content (id_pack, id_product, position) VALUES
(100, 12, 0),
(100, 34, 1),
(100, 56, 2);

Die installierte Tabelle enthält die vorzeichenlosen Spalten id_pack, id_product und position. Der Standardwert für die Position ist 0. Der Primärschlüssel ist (id_pack, id_product), mit einem Index auf id_pack.

Bei einem Produkt mit dem erforderlichen Artikelnummernpräfix ergänzt displayProductExtraContent "What's Included (N modules)", wenn passende aktive Produkte geladen werden können. Die Produkte werden nach position sortiert. Die Karten enthalten einen Link, einen Namen, ein Bild oder den Platzhalter Kein Bild sowie einen Preis oder "FREE" bei einem gespeicherten Preis von null oder darunter. Die Darstellung liest den Grundpreis aus der Produkttabelle und formatiert ihn in der aktuellen Währung. Verwenden Sie ihn nicht als Nachweis des endgültigen kundenspezifischen, steuerinklusiven oder umgerechneten Verkaufspreises.

Dies ist eine Zuordnung für die Anzeige. Sie erstellt kein natives PrestaShop-Pack, verwaltet keine Komponentenbestände und ändert nicht, was über die Kasse geliefert wird. Die Abfrage verwendet Produktsprachzeilen der aktuellen Sprache und des aktuellen Shops; sie setzt die Shop-Aktivierung enthaltener Produkte über product_shop nicht vollständig durch.

Ihre Produktliste sollte die Artikelnummer den Hooks zur Verfügung stellen. Eine kompatible Karte kann Folgendes enthalten:

<article class="product-miniature js-product-miniature">
  <div class="thumbnail-container">
    {* product image here *}
  </div>
  {hook h='displayProductPriceBlock' product=$product type='before_price'}
  {hook h='displayProductListReviews' product=$product}
</article>

Die ausgeblendete Markierung vor dem Preis ist für sich genommen kein sichtbares Badge. Fallback-Overlays suchen nach .product-miniature__top, .thumbnail-container oder .product-image-container. JavaScript beobachtet eingefügte Inhalte unter #js-product-list und ergänzt neue Pack-Indikatoren nach AJAX-Aktualisierungen der Produktliste. Testen Sie Ihr Theme, wenn es den gesamten beobachteten Container ersetzt.

Passen Sie das Fallback-Overlay bei Bedarf im Stylesheet Ihres Themes an:

.mpr-pack-badge {
  top: .5rem;
  right: .5rem;
  background-color: #3BAF5C;
}

Sie können die Variablen für das Fallback-Badge, den Ersparnisindikator und die Karten enthaltener Produkte im Stylesheet Ihres Themes überschreiben:

:root {
  --mprpackproducts-success: #3BAF5C;
  --mprpackproducts-bg: #fff;
  --mprpackproducts-bg-secondary: #D8F0E0;
  --mprpackproducts-border: rgba(59, 175, 92, 0.2);
  --mprpackproducts-radius: 0.375rem;
  --mprpackproducts-shadow-hover: 0 8px 24px rgba(0, 0, 0, 0.1);
}

Das Modul integriert ThemeDetector-Variablen unter --mprpackproducts-*. Bearbeiten Sie nur Variablen, die Ihre installierten Stylesheets verwenden. Die native Gestaltung von .product-flag.pack stammt vom Theme. Im Backoffice gibt es keine Steuerelemente für Beschriftung, Form, Farbe oder individuelle Pack-Designs.

Das aktivierte Modul enthält außerdem eine Hilfe zum Auflösen mehrdeutiger Produkt-/Kategorie-/CMS-/Hersteller-Routen, die nur aus einem Rewrite bestehen. Dies ist keine allgemeine Konfigurationsseite für suchmaschinenfreundliche URLs. Testen Sie bestehende bereinigte URLs nach dem Ändern des Hauptschalters.

1. Prüfen Sie, ob eine Artikelnummer mit dem exakten Präfix mpr-pack- beginnt.
2. Öffnen Sie eine Kategorie- und eine Suchergebnisliste mit diesem aktiven Produkt. Prüfen Sie die Kennzeichnung Paket bzw. die native Pack-Kennzeichnung und den Listenindikator.
3. Ändern Sie einen Facettenfilter oder lösen Sie eine AJAX-Aktualisierung aus und prüfen Sie, ob die neue Karte weiterhin ihre Kennzeichnung hat.
4. Fehlt die Kennzeichnung, prüfen Sie Pack-Badges aktivieren, die Artikelnummerndaten, die Hook-Platzierung und das Karten-Markup. Eine vorhandene native Pack-Kennzeichnung kann die Beschriftung Paket des Moduls ersetzen.
5. Fehlt der Tab, prüfen Sie die Zuordnungszeilen, die Aktivierungs-/Sprachdaten der enthaltenen Produkte und die Theme-Unterstützung für zusätzliche Produktinhalte.
6. Verwenden Sie "Integrity", wenn erforderliche Tabellen oder Hooks fehlen. Prüfen Sie bei älteren PrestaShop-Versionen die Verfügbarkeit der Locale-API, falls der Inhalts-Tab einen Fehler verursacht.

Schalten Sie Pack-Badges aktivieren aus, um die Funktion vorübergehend anzuhalten. Deinstallieren Sie das Modul über "Module Manager", um die Konfiguration und die Tabelle mpr_pack_content zu entfernen. Sichern Sie die Zuordnungen vorher. Die Deinstallation bereinigt auch die ThemeDetector-Registrierung; schlägt diese Bereinigung fehl, wird die Deinstallation angehalten, damit Sie den Fehler korrigieren und es erneut versuchen können. Artikelnummern werden nicht zurückgesetzt.

Erfordert PrestaShop 1.7 oder neuer und PHP 7.1 oder neuer.