...
Für die Konfiguration gibt es eine Konfigurationstabelle namens unter Sprechende URLs. Hier kann die Funktion aktiviert bzw. deaktiviert werden.
Außerdem können weitere Einstellungen vorgenommen werden:
Bereich | Beschreibung |
|---|
aktiv | Aktiviert das Plugin bei gesetztem Haken |
SKU in URL aufnehmen | Gibt an, ob die Artikelnummer mit in die URL aufgenommen werden soll. |
ID in URL aufnehmen | Gibt an, ob die ID mit in die URL aufgenommen werden soll |
Canonical Links immer aktualisieren | Gibt an, ob Canonical Links immer aktuell gehalten werden sollen |
Für 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.
...
Die Canonical Links der sprechenden URLs werden stets anhand der Identifikationsfeldern aktualisiert, sofern das Häkchen alwaysUpdateCanonicalLink Canonical Links immer aktualisieren in der Konfiguration gesetzt ist. Ist dieses nicht gesetzt, wird der Canonical Link nach der ersten Anlage nicht mehr verändert. Dies ist gleichzeitig das Standardverhalten, da ein nachträgliches Verändern von URLs normalerweise nicht gewünscht ist, weil das negative Effekt aufgrund von negativen Effekten auf das Seitenranking von Suchmaschinen hatnormalerweise nicht gewünscht ist.
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.
Code-Beispiele
Einfacher Link mit Shortling (cmsPageShortLink)
| Codeblock | ||||
|---|---|---|---|---|
| ||||
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
...
| language | php |
|---|---|
| theme | RDark |
| title | Beispiel shopGroup mit verschaltelten Gruppen |
...
Anlegen und Auslesen der sprechenden URLs
Datensätze von Tabellen, die sprechende URLs unterstützen, zeigen in der Meta-Spalte der Detailansicht eines Datensatzes einen Link Sprechende URL: Anzeigen
Ein Klick darauf öffnet ein Modal, in dem für jede aktive Kollation die sprechende URL erzeugt und kopiert werden kann.