CmsBreadcrumbs — CMS Breadcrumbs¶

Extension for Magento 2¶

Bedienungsanleitung¶

CopeX GmbH
Web: https://copex.io
Email: office@copex.io

Inhaltsverzeichnis¶

Abschnitt	Seite
1 Voraussetzungen	2
2 Installation	2
3 Konfiguration	2
4 Funktionsweise	3
5 Fehlerbehandlung	3

1 Voraussetzungen¶

Magento 2.4 oder höher
PHP 8.1 oder höher
Kompatibel mit Luma- und Hyvä-Themes

2 Installation¶

Via Composer¶

composer require copex/module-cms-breadcrumbs
php bin/magento module:enable CopeX_CmsBreadcrumbs
php bin/magento setup:upgrade
php bin/magento cache:flush

Nach der Installation ist das Modul standardmäßig aktiviert.

3 Konfiguration¶

Die Konfiguration des Moduls finden Sie im Magento 2 Backend unter Shops > Konfiguration > Allgemein > Web > Standardseiten.

3.1 Breadcrumbs aktivieren¶

Navigieren Sie zu Shops > Konfiguration > Allgemein > Web > Standardseiten.

Zusätzliche CMS Breadcrumbs anzeigen — Aktiviert oder deaktiviert die erweiterte Breadcrumb-Kette für CMS-Seiten. Bei Aktivierung werden für verschachtelte CMS-Seiten-URLs die Zwischenpfade als klickbare Breadcrumbs angezeigt.

4 Funktionsweise¶

Wenn ein Besucher eine CMS-Seite mit einem mehrstufigen URL-Pfad aufruft (z. B. /services/shipping/express), erstellt das Modul automatisch eine vollständige Breadcrumb-Kette:

Beispiel:

URL: https://myshop.at/services/shipping/express

Breadcrumb-Anzeige:

Startseite > Services > Versand > Express

Dabei gelten folgende Regeln:

Das Modul analysiert den URL-Pfad der aktuellen Seite und zerlegt ihn in einzelne Segmente.
Für jedes Zwischensegment wird in der Magento-Datenbank nach einer CMS-Seite mit diesem URL-Schlüssel gesucht.
Wird eine passende CMS-Seite gefunden, wird deren Seitentitel als verlinktes Breadcrumb-Element eingefügt.
Das letzte Element (aktuelle Seite) wird als nicht verlinktes Breadcrumb-Element durch Magento selbst hinzugefügt.

4.2 Einschränkungen¶

Das Modul funktioniert ausschließlich auf CMS-Seiten (nicht auf Kategorieseiten oder Produktseiten).
Die Startseite (home) und die 404-Seite (no-route) werden nicht mit zusätzlichen Breadcrumbs versehen.
Wenn für ein Zwischensegment keine passende CMS-Seite existiert, wird dieses Segment ohne Link dargestellt oder übersprungen.

5 Fehlerbehandlung¶

Breadcrumbs werden nicht angezeigt — Stellen Sie sicher, dass die Option Zusätzliche CMS Breadcrumbs anzeigen unter Shops > Konfiguration > Allgemein > Web > Standardseiten auf "Ja" gesetzt ist. Leeren Sie anschließend den Cache.
Falsche Breadcrumb-Titel — Der Breadcrumb-Text stammt aus dem Seitentitel der jeweiligen CMS-Seite. Überprüfen Sie unter Inhalt > Seiten, ob die CMS-Seiten mit den korrekten Titeln hinterlegt sind.
Links in Breadcrumbs führen auf die falsche Seite — Die Verlinkung basiert auf dem URL-Schlüssel der CMS-Seite. Stellen Sie sicher, dass die URL-Schlüssel der Zwischenseiten korrekt konfiguriert sind und mit den URL-Segmenten der untergeordneten Seiten übereinstimmen.
Breadcrumbs nur auf bestimmten Seiten defekt — Überprüfen Sie, ob für alle Zwischenpfade CMS-Seiten angelegt sind. Das Modul versucht, CMS-Seiten nach URL-Schlüssel zu finden; fehlt eine Seite für ein Segment, bricht die Kette ab.

Lizenz¶

Proprietär — CopeX GmbH. Eine Lizenz pro produktiver Magento-Instanz.