PrestaShop Product SEO Subtitles — Dokumentation

Fügt auf Produkt-, Kategorie-, CMS-, Hersteller- und Lieferantenseiten eigene SEO-Untertitel direkt nach der Hauptüberschrift ein. Statt Ihren Produkt- oder Kategorienamen zu ändern, können Sie eine zweite Zeile ergänzen, zum Beispiel einen Vorteil, eine Long-Tail-Keyword-Phrase, Größenangaben, Material, Marke oder eine Kampagnenbotschaft.

Produkt-SEO-Untertitel

Jede wichtige Seite in Ihrem Shop hat einen Haupttitel, doch dieser eine Titel kann oft nicht alle Suchbegriffe enthalten, nach denen Kundinnen und Kunden suchen. SEO Subtitles gibt Ihnen einen separaten Untertitel-Datensatz, der direkt nach dem H1 der Seite angezeigt werden kann, mit einem echten HTML-Element wie h2, h3, p, span oder div.

Das Modul ist nicht auf ein einziges fest codiertes Produktfeld beschränkt. Es verwaltet Untertitel-Regeln in einem eigenen Bereich im Back Office, in dem jeder Untertitel eigenen Text, Zielauswahl, HTML-Tag, CSS-Klasse, Priorität und Aktivstatus haben kann.

Unterstützte Seiten-/Entitätstypen im Modulcode:

product
category
cms
manufacturer
supplier

Kompatibilität: PrestaShop 1.6 bis 9.0 (latest), PHP 7.1+. Wir unterstützen auch weiterhin kommende PrestaShop-Versionen.

So funktioniert es

Nach der Installation fügt das Modul im Back Office ein neues Menü SEO Subtitles hinzu. Dort können Sie Untertitel-Datensätze erstellen und festlegen, wo sie erscheinen sollen.

Ein Untertitel-Datensatz enthält:

Subtitle Text
Name
Target Entities
HTML Tag
CSS Class
Priority
Active

Der Untertitel wird über den Modul-Hook ausgegeben:

{hook h='displayMprSubtitle'}

Für Produktlisten oder eigene Platzierungen im Theme kann der Hook außerdem eine Produkt-ID und Anzeigeoptionen erhalten:

{hook h='displayMprSubtitle' id_product=$product.id}
{hook h='displayMprSubtitle' id_product=$product.id tag='h3'}
{hook h='displayMprSubtitle' tag='h3' css_class='category-subtitle'}

Die Ausgabe im Front Office ist ein echtes HTML-Element mit CSS-Klassen des Moduls:

<h2 class="mpr-subtitle mpr-subtitle-product mpr-seo-subtitle">
  Walk-in shower tray with anti-slip stone resin surface
</h2>

Wenn kein passender aktiver Untertitel vorhanden ist, wird nichts angezeigt und die Seite behält ihr normales Layout.

Installation

1. Gehen Sie in Ihrem Back Office zu Modules → Module Manager
2. Klicken Sie auf Upload a module und wählen Sie die ZIP-Datei aus
3. Installieren Sie das Modul
4. Öffnen Sie SEO Subtitles im Back-Office-Menü
5. Nutzen Sie Templates, um Ihr Theme zu scannen und den Untertitel-Hook bei Bedarf einzufügen
6. Erstellen Sie Ihren ersten Untertitel unter Subtitles

Konfiguration

Standardeinstellungen

Das Modul speichert seine Haupteinstellungen in seiner Konfigurationstabelle mit diesen Schlüsseln:

default_tag = h2
default_class = mpr-seo-subtitle
display_mode = single

Der Konfigurationsbildschirm enthält:

Default HTML Tag
Default CSS Class
Display Mode

HTML-Tag

Sie können festlegen, welcher Tag für einen Untertitel verwendet wird. Erlaubt sind:

h2
h3
h4
h5
h6
p
span
div

Für die meisten Produkt- und Kategorieseiten ist h2 ein guter Ausgangspunkt, da der Haupttitel der Seite in der Regel bereits das h1 ist.

Beispiel für einen Untertitel mit dem Standard-Heading-Tag:

Ultra-slim shower tray, stone resin finish, easy-clean surface

Beispiel, bei dem eine kleinere Überschrift besser passt:

HTML Tag: h3
Subtitle Text: Compatible with low-profile walk-in shower installation

Anzeigemodus

Das Modul kann entweder einen Untertitel oder mehrere passende Untertitel anzeigen.

single = show only the highest-priority matching subtitle
all = show all matching subtitles, sorted by priority

Die Priorität wird von hoch nach niedrig sortiert:

Priority 100 → shown before priority 10
Priority 10  → default priority

CSS-Klasse

Jeder Untertitel erhält immer die Basis-Klassen des Moduls:

mpr-subtitle
mpr-subtitle-product
mpr-subtitle-category
mpr-subtitle-cms
mpr-subtitle-manufacturer
mpr-subtitle-supplier

Ihre eigene Klasse wird nach diesen Klassen hinzugefügt. Beispiel:

CSS Class: homepage-product-subtitle

Ergebnis auf einer Produktseite:

<h2 class="mpr-subtitle mpr-subtitle-product homepage-product-subtitle">
  Made-to-measure shower screen in clear safety glass
</h2>

Template Manager

Das Modul enthält einen Template Manager, der die Templates Ihres aktiven Themes scannt, Überschriftenpositionen findet und den Untertitel-Hook nach der ausgewählten Überschrift einfügen kann.

Eingefügte Hooks werden mit Markern umschlossen, damit sie später verfolgt und entfernt werden können:

{* MPR_SUBTITLE_INJECT *}{hook h='displayMprSubtitle'}{* /MPR_SUBTITLE_INJECT *}

Der Manager prüft Theme-Template-Dateien im themes-Verzeichnis des Shops und arbeitet ausschließlich mit .tpl-Dateien. Wenn er in derselben Datei bereits einen vorhandenen, nicht markierten displayMprSubtitle-Hook findet, meldet er diesen, statt ein Duplikat hinzuzufügen.

Smart Tags

Untertiteltexte unterstützen Platzhalter. Diese sind nützlich, wenn eine Untertitel-Regel sich automatisch an jedes Produkt anpassen soll.

Häufige Produkt-Platzhalter:

{name}
{reference}
{ean13}
{price}
{manufacturer}
{category}
{feature:Feature name}
{attribute:Attribute group name}

Beispiele:

{name} from {manufacturer} — available from {price}

{category} product with reference {reference}

{feature:Material} shower tray with {attribute:Color} finish

Für Kategorie-, CMS-, Hersteller- und Lieferantenseiten wird {name} zum Namen der aktuellen Entität aufgelöst:

{name} — selected products and practical buying information

Untertitel gezielt ausgeben

Beim Erstellen eines Untertitels nutzen Sie Target Entities, um festzulegen, wo er erscheint. Das Modul unterstützt gezieltes Targeting einzelner Entitäten und breitere Auswahlregeln.

Ein einzelner Produktuntertitel kann für ein bestimmtes Produkt verwendet werden:

Target: specific product
Subtitle Text: Low-profile shower tray with stone resin surface
HTML Tag: h2
Priority: 10
Active: Yes

Eine breitere Produktregel kann auf Produkte nach Kategorie, Hersteller oder Lieferant angewendet werden, wenn die Selector-Daten diese Bedingungen verwenden. Der Resolver unterstützt außerdem Ausschlüsse, sodass eine Regel breit greifen und ausgewählte Produkte dennoch überspringen kann.

Unterstützte Produkt-Targeting-Methoden im Resolver:

all
specific
by_category
by_manufacturer
by_supplier

Unterstützte Ausschlüsse:

specific
by_category

Praxisbeispiele

Produktuntertitel

Product name:
Shower Tray 90x90

Subtitle:
Ultra-slim stone resin tray with easy-clean anti-slip surface

Kategorieuntertitel

Category name:
Walk-in Shower Screens

Subtitle:
Frameless glass panels for modern wetroom and walk-in shower layouts

CMS-Seitenuntertitel

CMS page:
Delivery Information

Subtitle:
Shipping times, carrier options and delivery notes for bathroom products

Dynamischer Produktuntertitel

{name} by {manufacturer} — {feature:Material}, available from {price}

Tipps

• Nutzen Sie den Untertitel für Informationen, die nicht natürlich in den Seitentitel passen: Material, Größe, Montageart, Oberfläche, Kompatibilität oder eine Long-Tail-Suchphrase.
• Vermeiden Sie es, den Produkt- oder Kategorienamen wortgleich zu wiederholen. Der Untertitel sollte nützlichen Kontext ergänzen.
• Halten Sie Produktuntertitel kurz genug, damit sie auch auf mobilen Bildschirmen gut lesbar bleiben.
• Verwenden Sie Platzhalter für wiederholbare Muster über viele Produkte hinweg.
• Nutzen Sie die Priorität, wenn mehrere Untertitel-Regeln auf dieselbe Seite passen können.
• Beginnen Sie mit Ihren wichtigsten Produkt- und Kategorieseiten und erweitern Sie danach auf breitere Regeln.

Häufig gestellte Fragen

Ändert der Untertitel meinen Produktnamen?
Nein. Der Untertitel wird separat angezeigt. Er benennt weder das Produkt noch die Kategorie, CMS-Seite, den Hersteller oder den Lieferanten um.

Ändert der Untertitel meinen Meta Title?
Nein. Das Modul gibt Untertitelinhalte auf der Seite aus. Es schreibt den Meta Title der Seite nicht um.

Kann ich Untertitel für manche Seiten leer lassen?
Ja. Wenn kein aktiver Untertitel zu einer Seite passt, gibt das Modul nichts aus.

Kann ich unterschiedliche Untertitel in verschiedenen Sprachen verwenden?
Ja. Der Untertiteltext ist mehrsprachig, sodass Sie für jede Sprache in Ihrem Shop einen eigenen Text eingeben können.

Kann ich mehr als einen Untertitel auf derselben Seite anzeigen?
Ja. Setzen Sie den Anzeigemodus auf all. Im Standardmodus single wird nur der passende Untertitel mit der höchsten Priorität angezeigt.

Funktioniert das mit meinem aktuellen Theme?
Das Modul nutzt einen Smarty-Hook und enthält einen Template Manager, um diesen Hook nach der Seitenüberschrift zu platzieren. Standard-PrestaShop-Themes sollten normal funktionieren. Individuelle Themes benötigen möglicherweise den Template Manager oder eine manuelle Hook-Platzierung.

Welchen Hook verwendet das Modul?
Der Haupt-Hook ist:

{hook h='displayMprSubtitle'}

Es gibt außerdem einen Kompatibilitätsalias für Themes, die Folgendes verwenden:

{hook h='displayProductSubtitle'}