Zweite Kategoriebeschreibung: Einrichtung und Hilfe

Laden Sie die ZIP-Datei unter Module > "Module Manager" > "Upload a module" hoch. Installieren Sie das Modul und klicken Sie auf "Configure". Öffnen Sie "Improve" > Zweite Kategoriebeschreibung, um auf das Dashboard, Vorlagen und Einstellungen zuzugreifen.

Erfordert PrestaShop 1.6 oder neuer und PHP 7.1 oder neuer.

Bei der Installation werden diese Tabellen mit Ihrem Datenbankpräfix angelegt:

mprscd_description
mprscd_description_lang
mprscd_injection
mprscd_profile

Wählen Sie den richtigen Shop-Kontext, öffnen Sie "Catalog" > Kategorien und bearbeiten Sie eine Kategorie. Füllen Sie Zweite Kategoriebeschreibung unterhalb der Standardbeschreibung aus. Geben Sie Inhalte für jede benötigte Sprache ein und speichern Sie.

Verwenden Sie bei PrestaShop-Versionen vor 1.7.7 das ältere Kategorieformular, um die Beschreibung einzugeben.

Beschreibungen werden je Kategorie und Shop mit getrennten Sprachdatensätzen gespeichert. Bei einer leeren Übersetzung wird nicht automatisch auf die Standardsprache zurückgegriffen. Eine Seite ohne gespeicherte Inhalte für ihre Kategorie, Sprache und ihren Shop gibt keinen Block aus.

Sie können Inhalte mit Überschriften, Absätzen, Listen und Links strukturieren. Zum Beispiel:

<h2>Buying guide for this category</h2>
<p>Explain how to choose between the products in this category.</p>
<h3>What to compare before ordering</h3>
<ul>
  <li>Size or dimensions</li>
  <li>Material or finish</li>
  <li>Compatibility with the rest of the order</li>
</ul>
<h3>Related categories</h3>
<p>Add relevant links to related categories.</p>

Öffnen Sie Zweite Kategoriebeschreibung > Einstellungen > Allgemein.

Speichern Sie Ihre Änderungen. Der Bereich Vorlagenplatzierung verlinkt auf Vorlagenmanager öffnen und zeigt an, ob eine erfasste Injektion aktiv ist.

Kategorie-Footer-Hook verwenden

"Default (inside column)" und "Full width (CSS breakout)" geben Inhalte über displayFooterCategory aus. Prüfen Sie Ihre Kategorievorlage, um sicherzustellen, dass dieser Hook an der gewünschten Blockposition steht.

Die volle Breite fügt mprscd-fullwidth hinzu. Es handelt sich um einen CSS-Ausbruch, der weiterhin durch das umgebende Theme-Layout eingeschränkt werden kann.

Vorlageninjektion verwenden

Öffnen Sie Vorlagen und scannen Sie das aktive Theme. Prüfen Sie die vorgeschlagene Datei und Position. Sichern Sie die Theme-Datei vor der Änderung und fügen Sie dann den erfassten Hook ein. Wählen Sie "Template injection" unter "Display Mode".

Die eingefügte Hook-Markierung lautet:

{* MPRSCD_INJECT *}{hook h='displayMprSecondCatDesc'}{* /MPRSCD_INJECT *}

Sie können {hook h='displayMprSecondCatDesc'} auch manuell platzieren. Dieser eigene Hook gibt nur Inhalte aus, wenn "Display Mode" auf "Template injection" steht. Er zeigt den Block in voller Breite an.

Im Injektionsmodus zeigt eine aktive erfasste Einfügung die Beschreibung an der eingefügten Position an und blendet sie im regulären Kategorie-Footer aus. Ohne aktive erfasste Einfügung kann die Beschreibung weiterhin im Kategorie-Footer erscheinen. Prüfen Sie auf doppelte Beschreibungen, wenn Sie eine manuelle Einfügung mit der regulären Footer-Position kombinieren.

Prüfen Sie nach dem Aktualisieren oder Ersetzen eines Themes den Injektionsstatus und scannen Sie erneut. Der Manager kann erfasste Einfügungen entfernen.

Öffnen Sie eine Kategorie mit gespeicherten Inhalten. Prüfen Sie, ob diese an der erwarteten Footer- oder Injektionsposition erscheinen. Prüfen Sie eine andere Sprache und bei Multishop einen anderen Shop-Kontext. Öffnen Sie eine Kategorie ohne gespeicherte Beschreibung und stellen Sie sicher, dass kein leerer Block erscheint.

Öffnen Sie bei aktivierter Option "First Page Only" Seite 2 und prüfen Sie, ob der Block ausgeblendet ist. Die Einstellung verwendet die Seitennummer page in der Kategorie-URL. Prüfen Sie bei einem anderen Paginierungsformat Ihres Themes, ob der Block auf späteren Seiten ausgeblendet bleibt.

Der normale Container lautet:

<div class="mprscd-description">
  <div class="mprscd-content">
    <!-- your saved description -->
  </div>
</div>

Der Modus für volle Breite fügt der Klassenliste des äußeren Containers mprscd-fullwidth hinzu. Passen Sie bei Bedarf die Stile in Ihrem Theme an:

.mprscd-description {
  margin-top: 2rem;
  background: #fff;
}
.mprscd-description .mprscd-content {
  line-height: 1.7;
}
.mprscd-description.mprscd-fullwidth .mprscd-content {
  max-width: 1170px;
  margin-left: auto;
  margin-right: auto;
}

Wenn Sie "CSS Class" ersetzen, aktualisieren Sie Ihre CSS-Selektoren entsprechend.

Stellen Sie sicher, dass "Enable Module" auf Ja steht, die Kategorie korrekt ist und für den aktuellen Shop und die Sprache Inhalte gespeichert sind. Prüfen Sie "First Page Only", bevor Sie eine spätere Paginierungsseite untersuchen.

Fehlen Inhalte im Modus "Default", prüfen Sie, ob das Theme displayFooterCategory ausgibt. Fehlen sie im Modus "Template injection", prüfen Sie, ob der eingefügte eigene Hook in der aktiven Vorlage vorhanden ist. In anderen Anzeigemodi oder außerhalb von Kategorieseiten gibt dieser Hook nichts zurück.

Erscheinen Inhalte zweimal, prüfen Sie, ob sowohl ein manueller Hook als auch eine aktive Footer-Position vorhanden sind. Verwenden Sie eine erfasste Platzierung und prüfen Sie den Injektionsstatus des Moduls nach Theme-Änderungen.

Leeren Sie nach Änderungen den betreffenden Seiten- oder Vorlagencache. Verwenden Sie die Modulseite "Integrity" zur Prüfung der erforderlichen Modulinfrastruktur. Das Dashboard zeigt, wie viele Kategorien Beschreibungen haben.

Beschreibungen bleiben im Modul und werden nicht in das integrierte Feld für die zusätzliche Kategoriebeschreibung kopiert. Die Einstellungen enthalten kein Migrationstool.

Verwenden Sie "Enable Module" = Nein, um Beschreibungen auszublenden, ohne sie zu löschen.

Exportieren Sie vor der Deinstallation alle Beschreibungen, die Sie behalten möchten. Die Deinstallation entfernt die Modultabellen einschließlich gespeicherter Beschreibungen, Injektionsdatensätze und Profile. Beim Löschen einer Kategorie werden auch die zugehörigen Beschreibungsdatensätze des Moduls entfernt.

Die Deinstallation versucht zunächst, erfasste Vorlageninjektionen zu entfernen. Schlägt die Bereinigung fehl, kann die Deinstallation fortgesetzt und der Fehler protokolliert werden. Prüfen Sie anschließend die geänderten Theme-Vorlagen und entfernen Sie bei Bedarf verbleibende manuelle oder erfasste Hook-Aufrufe.