Die optionale Konfiguration für sprechende URLs schafft die Möglichkeit, das Navigieren im Shop transparenter zu machen. So werden kryptische URLs wie z.B. "shop.brandbox.de/article~de?articleID=10" zu "shop.brandbox.de/artikelname".
Des Weiteren werden auch Suchergebnisse von Suchmaschinen positiv vom Einsatz sprechender URLs beeinflusst.
Aufbau
Für die Konfiguration gibt es eine Konfigurationstabelle namens unter Sprechende URLs. Hier kann die Funktion aktiviert bzw. deaktiviert werden.
Für die Verarbeitung der Geschäftslogik wird eine zweite Tabelle Canonical Links benutzt, welche für jede sprechende URL Informationen enthält, sodass diese der entsprechenden Seite zugewiesen werden können.
Verwendung
Um das Plugin zu verwenden ist kein zusätzlicher Aufwand des Nutzers notwendig, sofern das Plugin aktiv ist. Durch die Methode linkTo
wird ein Eintrag in der "real Urls"-Tabelle erstellt, sofern eine entsprechend gemappte Entität bereitgestellt wird. Wird beispielsweise der Link für die Artikel-Entität "Schrauber" mit der ID "10" in der deutschen Sprache beantragt, so wird ein Eintrag in der Tabelle erstellt, der die URL ".../schrauber" auf die Artikeldetailseite mit der ID "10" und der Sprache "1" mappt.
Konfiguration
Bereich | Beschreibung |
---|---|
isActive | Aktiviert das Plugin bei gesetztem Haken. |
withSku | Gibt an, ob die Artikelnummer mit in die URL aufgenommen werden soll. |
withID | Gibt an, ob die ID mit in die URL aufgenommen werden soll. |
alwaysUpdateCanonicalLink | Gibt an ob Canonical Links immer aktuell gehalten werden sollen |
Aktualisieren der sprechenden URLs
Die Zuweisungstabelle der sprechenden URLs wird stets anhand der Identifikationsfeldern aktualisiert. Wird eine URL aufgerufen, die auf den shortlink "article" verweist, wird die realurl mit den Inhalten der Identifikationsfeldern des angefragten Artikels verglichen. Gibt es hier eine Diskrepanz, wird der entsprechende Eintrag in der Zuweisungstabelle invalidiert und ein neuer erstellt, sodass die Links im Shop korrekt generiert werden. So werden auch alte URLs auf die aktuellsten URLs weitergeleitet.
Code-Beispiele
Einfacher Link mit Shortling (cmsPageShortLink)
use brandbox\cms\realurl; private function linkTo($shortLink = 'basket') { return $this ->getEngineRealUrl() ->linkTo($shortLink) ; } private function getEngineRealUrl() { return $this->staticController(realurl\engine::class); }
Links zu Datenmodels
use brandbox\cms\realurl; /** * @param int[] $groupIDs * * @return string */ public function get($groupIDs = []) { $groups = $this->getGroups($groupIDs); $contentType = $this ->getRepositoryShopGroup() ->getIdentifier() ; $realUrlModels = $this ->map() ->from($groups, true) // true = multiple ->withPropertyMap('contentID', 'id') ->withStaticMap('contentType', $contentType) ->to(group\lib\map\realUrlModel::class) ; return $this ->getEngineRealUrl() ->linkTo(self::SHORT_LINK, $realUrlModels) ; } private function getEngineRealUrl() { return $this->staticController(realurl\engine::class); } // group\lib\map\realUrl namespace brandbox\shop\group\lib\map { use brandbox\cms\realurl; /** * @author Christopher Holden <holden@konmedia.com> */ class realUrlModel extends realurl\lib\map\realurlModel { /** * @var string */ public $shopGroupName = ''; } }