DF Glossary — SEO-Glossar für PrestaShop 8 & 9

Überblick

DF Glossary verwandelt Ihren Fachwortschatz in ein SEO-Asset. Sie erfassen Ihre Begriffe einmal — mit einer Kurz- und einer Langdefinition — und das Modul erledigt drei Dinge automatisch: Es fügt bei jedem Vorkommen des Begriffs in Ihren Produkt-, Kategorie- und CMS-Beschreibungen einen Link mit Tooltip ein; es veröffentlicht pro Begriff eine indexierbare Definitionsseite; und es verknüpft jede Definition mit den Produkten, die Sie ihr zuordnen.

Das Ergebnis ist eine bidirektionale interne Verlinkung, die ohne redaktionellen Aufwand entsteht: Ihre Seiten stärken Ihre Definitionen, Ihre Definitionen stärken Ihre Produkte, und Ihre Definitionen stärken sich gegenseitig.

Installation

Voraussetzungen

• PrestaShop 8.0, 8.1, 8.2 oder 9.x
• PHP 7.4 bis 8.3
• MySQL 5.7 / MariaDB 10.3 oder höher
• Suchmaschinenfreundliche URLs aktiviert (Shop-Parameter, Traffic und SEO) — zwingend erforderlich für die Glossarseiten

Vorgehen

1. Gehen Sie im Backoffice auf Module → Modul-Manager → Modul hochladen.
2. Laden Sie die Datei dfglossary-1.0.0.zip hoch.
3. Die Installation legt vier SQL-Tabellen, einen Backoffice-Tab und die Standard-Konfigurationsschlüssel an.
4. Im Menü erscheint ein neuer Tab Katalog → SEO-Glossar. Dort verwalten Sie Ihre Begriffe.
5. Klicken Sie im Modul-Manager auf Konfigurieren, um zu den globalen Einstellungen zu gelangen.

Modulkonfiguration

Das Konfigurationspanel gliedert sich in drei Bereiche.

Aktivierung und Injektionsmodus

• Injektion aktivieren — Hauptschalter. Deaktiviert reichert das Modul Ihre Inhalte nicht mehr an, die Glossarseiten bleiben aber online und indexiert.
• Modus — drei mögliche Werte:
  • Link + Tooltip (Standard): Der Begriff wird zu einem Link auf seine Definitionsseite und zeigt beim Hover den Tooltip. Dieser Modus verbindet SEO-Nutzen und Conversion-Nutzen.
  • Nur Link: Der Begriff wird zu einem Link, ohne Tooltip. Wählen Sie das, wenn es Ihnen nur um die interne Verlinkung geht.
  • Nur Tooltip: Der Begriff zeigt beim Hover die Definition, ohne zum Link zu werden. Wählen Sie das, wenn Sie Erklärung wollen, ohne ausgehende Links in Ihre Produktseiten einzufügen.

Limits (Schutz vor Überoptimierung)

• Maximale Vorkommen pro Begriff — standardmäßig 1. Selbst wenn ein Wort achtmal in einer Beschreibung vorkommt, wird nur das erste Vorkommen zum Link. Wir empfehlen dringend, diesen Wert beizubehalten: Ein Link pro Konzept reicht aus, um das semantische Signal zu senden, weitere verwässern den internen PageRank, ohne etwas beizutragen.
• Maximale Links pro Inhalt — standardmäßig 10, über alle Begriffe hinweg. Darüber hinaus stoppt der Motor, egal welche Begriffe noch offen sind.

Zielinhalte

Vier unabhängige Schalter bestimmen, wo die Injektion greift:

• Produktbeschreibungen — die Langbeschreibung.
• Kurzbeschreibung einbeziehen — separate Option. Achtung: Die Kurzbeschreibung erscheint oft oben auf der Seite und in Listings; Links dort können übertrieben wirken.
• Kategoriebeschreibungen — Beschreibung und zusätzliche Beschreibung.
• CMS-Seiten und CMS-Kategorien — Inhalt der CMS-Seiten.

URL-Basis

Das Feld URL-Basis legt das Segment fest, unter dem die Glossarseiten veröffentlicht werden. Standardwert: glossar, was /glossar für den Index und /glossar/beschichtetes-gewebe für eine Begriffsseite ergibt. Das Feld wird als Link-Rewrite validiert: nur Buchstaben, Ziffern und Bindestriche.

Begriffe verwalten

Gehen Sie auf Katalog → SEO-Glossar. Die Liste zeigt alle Ihre Begriffe mit Slug, Status der automatischen Verlinkung und Veröffentlichungsstatus. Sie können suchen, sortieren, filtern, per Klick aktivieren oder deaktivieren und in Massen löschen.

Einen Begriff anlegen

Klicken Sie auf Begriff hinzufügen. Das Formular ist vollständig mehrsprachig: Jedes Textfeld wird sprachweise erfasst.

• Begriff — die genaue Schreibweise, die in Ihren Inhalten gesucht wird. Das Matching ignoriert Groß-/Kleinschreibung und respektiert Wortgrenzen.
• Slug — die Kennung in der URL. Leer lassen, damit sie automatisch aus dem Namen erzeugt wird.
• Synonyme — kommagetrennte Liste. Plurale, Abkürzungen und Schreibvarianten lösen denselben Link und denselben Tooltip aus.
• Kurzdefinition — das ist der Tooltip-Text. Reiner Text empfohlen. In der Blase wird sie auf 180 Zeichen gekürzt, auf der Definitionsseite aber vollständig oben angezeigt.
• Langdefinition — Rich-Editor. Das ist der Hauptteil der Definitionsseite und der Inhalt, der in Google ranken wird.
• Meta-Title / Meta-Description — optional. Fehlen sie, greift das Modul automatisch auf den Begriffsnamen und die Kurzdefinition zurück.
• Zugeordnete Produkte — kommagetrennte Liste von Produkt-IDs. Ihre Miniaturbilder erscheinen auf der Begriffsseite.
• Automatische Verlinkung — individueller Schalter. Deaktiviert behält der Begriff seine indexierte Definitionsseite, wird aber nie in Inhalte eingefügt.
• Aktiv — deaktiviert verschwindet der Begriff aus dem Glossar und seine Seite liefert einen sauberen 404.

Redaktionelle Best Practices

• Zielen Sie auf 20 bis 50 Begriffe. Nicht die Menge ist entscheidend, sondern die Relevanz: Ein Begriff verdient seinen Platz, wenn er wirklich in Ihren Beschreibungen vorkommt und einer Frage entspricht, die Ihre Kunden sich stellen.
• Schreiben Sie Langdefinitionen von 150 bis 400 Wörtern. Genug, um in Googles Augen eigenständiger Inhalt zu sein, kurz genug, um schnell erstellt zu werden.
• Ordnen Sie 2 bis 6 Produkte pro Begriff zu, nicht mehr. Eine Definitionsseite, die auf zwanzig Produkte verweist, verwässert ihre Autorität.
• Pflegen Sie die Synonyme. Sie sind der Hebel, der die Abdeckung vervielfacht: Ein über Jahre von mehreren Personen verfasster Katalog drückt dasselbe Konzept selten nur auf eine Weise aus.
• Übersetzen Sie Synonyme nicht wörtlich. Jede Sprache hat ihre eigenen Varianten; erfassen Sie sie unabhängig.

Wie die Injektion funktioniert

Die Anreicherung erfolgt serverseitig beim Rendern der Seite über die Content-Filter-Hooks von PrestaShop. Ihre Beschreibungen werden nie in der Datenbank verändert: Wenn Sie das Modul deaktivieren, kehren Ihre Inhalte sofort in ihren Originalzustand zurück.

Der Ersetzungsmotor

Der Inhalt wird in Tag-Segmente und Textsegmente zerlegt. Nur Textsegmente kommen für eine Ersetzung in Frage. Folgende Zonen werden konsequent übersprungen:

• bestehende Links (kein Risiko verschachtelter Links),
• Überschriften h1, h2 und h3,
• script-, style-, code-, pre-, svg- und noscript-Blöcke,
• Formularfelder: textarea, select, option, button,
• iframes.

In den erlaubten Segmenten nutzt die Suche Unicode-Wortgrenzen: Es ist unmöglich, ein Fragment innerhalb eines Wortes oder einer Kennung zu verlinken. Das Matching ignoriert Groß-/Kleinschreibung und toleriert Mehrfachleerzeichen oder Zeilenumbrüche. Schließlich wird jeder eingefügte Link während der Verarbeitung temporär durch einen eindeutigen Token ersetzt — ein Begriff kann also nie innerhalb eines Links erneut verlinkt werden, den das Modul selbst gerade erzeugt hat.

Prioritätsreihenfolge der Varianten

Alle Varianten eines Begriffs (Hauptname und Synonyme) werden zusammengeführt und absteigend nach Länge sortiert. Der längste Ausdruck gewinnt immer. Konkret: Stehen sowohl PVC-beschichtetes Gewebe als auch beschichtetes Gewebe in Ihren Synonymen, wird der erste verlinkt, sobald er vollständig auftaucht.

Die Glossarseiten

Indexseite

Erreichbar unter /glossar, listet sie alle aktiven Begriffe nach Buchstaben gruppiert auf, mit alphabetischer Navigation und einem Auszug pro Begriff. Sie gibt ein JSON-LD vom Typ DefinedTermSet aus.

Definitionsseite

Erreichbar unter /glossar/{slug}, enthält jede Seite:

• eine H1-Überschrift und die hervorgehobene Kurzdefinition,
• die Langdefinition im Rich-Format, in der die anderen Glossarbegriffe ihrerseits automatisch verlinkt werden (der aktuelle Begriff ist ausgeschlossen, kein Selbstlink),
• die Miniaturbilder der zugeordneten Produkte,
• eine Wolke verwandter Begriffe,
• eigenen Meta-Title und eigene Meta-Description, Canonical-URL, Breadcrumb,
• ein JSON-LD vom Typ DefinedTerm.

Existiert ein Slug nicht oder ist der Begriff deaktiviert, liefert die Seite einen sauberen 404.

Mehrsprachigkeit und Multishop

Alle Textfelder des Glossars sind mehrsprachig: Name, Synonyme, Definitionen, Slug, Meta-Title und Meta-Description können je Sprache abweichen. Das Matching erfolgt immer in der Sprache des aktuellen Kontexts: Eine deutsche Beschreibung wird nie mit englischen Begriffen angereichert.

Im Multishop-Betrieb werden Begriffe über die Standard-Zuordnungstabelle von PrestaShop mit den Shops verknüpft. Sie können also ein dichtes Fachglossar in einem B2B-Shop und ein vereinfachtes in einem B2C-Shop betreiben, in derselben Installation.

Verhalten auf Mobilgeräten

Auf einem Touchscreen gibt es kein Hover. Das Modul lädt ein Mini-Skript, das den Tap steuert: Der erste Tap auf einen Begriff zeigt den Tooltip und blockiert die Navigation, der zweite Tap öffnet die Definitionsseite. Andere geöffnete Tooltips schließen sich automatisch, und ein Tap außerhalb des Begriffs schließt die Blase.

Performance

Das Begriffswörterbuch wird einmal pro Anfrage geladen und statisch zwischengespeichert: Selbst eine Kategorieseite mit dreißig Produkten löst nur eine einzige SQL-Abfrage für das Glossar aus. Die Ersetzung selbst ist eine String-Operation in PHP im Millisekundenbereich. Es wird kein blockierendes JavaScript geladen, kein Netzwerkaufruf getätigt, und das Ergebnis ist vollständig mit dem Full-Page-Cache kompatibel.

Fehlerbehebung

Auf meinen Produktseiten erscheinen keine Links

• Prüfen Sie, ob der Hauptschalter Injektion aktivieren auf Ja steht.
• Prüfen Sie, ob Produktbeschreibungen bei den Zielinhalten aktiviert ist.
• Prüfen Sie, ob der Begriff aktiv ist und seine automatische Verlinkung eingeschaltet ist.
• Prüfen Sie, ob der Begriff in der Sprache der aufgerufenen Seite erfasst ist — ein nur auf Französisch erfasster Begriff wird nie in eine deutsche Beschreibung eingefügt.
• Leeren Sie den PrestaShop-Cache (Erweiterte Parameter → Leistung).

Der Begriff steht im Text, ist aber nicht verlinkt

Drei mögliche Ursachen. Entweder steht der Begriff bereits in einem Link, einer Überschrift h1–h3 oder einer geschützten Zone — das ist gewolltes Verhalten. Oder das Limit für Vorkommen pro Begriff (standardmäßig 1) ist für diesen Inhalt bereits erreicht: Die weiteren Vorkommen bleiben reiner Text, das ist normal. Oder das globale Limit von 10 Links pro Inhalt ist erreicht.

Die Glossarseiten liefern einen 404

• Prüfen Sie, ob suchmaschinenfreundliche URLs aktiviert sind.
• Erzeugen Sie die .htaccess-Datei neu (Shop-Parameter → Traffic und SEO → .htaccess-Datei generieren).
• Prüfen Sie, ob der Begriff aktiv ist und sein Slug in der aufgerufenen Sprache gefüllt ist.

Die Tooltips erscheinen nicht

Prüfen Sie, ob der Modus auf Nur Link steht. Ist der Modus korrekt, leeren Sie den Cache und prüfen Sie, ob das Stylesheet des Moduls geladen wird (es wird automatisch auf allen Storefront-Seiten eingebunden).

Deinstallation

Die Deinstallation entfernt die vier SQL-Tabellen des Moduls, den Backoffice-Tab und sämtliche Konfigurationsschlüssel. Ihre Begriffe gehen damit endgültig verloren — exportieren Sie sie, falls Sie später neu installieren wollen. Dagegen wurde nie eine Produkt-, Kategorie- oder CMS-Beschreibung in der Datenbank verändert: Ihre Inhalte kehren einfach in ihren Originalzustand zurück, ohne dass eine Bereinigung nötig wäre.

Bekannte Einschränkungen

• Die Eindeutigkeit der Slugs wird pro Sprache nicht erzwungen. Teilen sich zwei Begriffe denselben Slug in derselben Sprache, gewinnt der zuerst gefundene. Prüfen Sie Ihre Slugs bei der Eingabe.
• Geschützte Zonen (Links, Überschriften h1–h3, Code, Formularfelder) werden nie angereichert. Das ist eine Designentscheidung, keine umgehbare Einschränkung.