Kurze URLs in ePages 6 6.15.1
Created: 6.0.7; Updated: 6.14.2

Inhaltsverzeichnis

1 Was sind Kurz-URLs / ShortUrl (KU)?

Ab Version 6.0.6 ermöglicht ePages die Verwendung von KU als Alternative zu den bisherigen URLs. Kurz-URLs (KU) sind kurze, kompakte URLs, die auf bestimmte Objekte im Shop (Produkte, Seiten) verweisen.

Die KU wird wie folgt zusammengesetzt: [ShopDomain]/[ShortUrlId]

Der Händler kann die Kurz-URL-ID für alle Seite vergeben, welche auf Objekten der Klasse ContentObject basieren:

Die Kurzform der URL ist ab Aktivierung die primäre URL für die entsprechende Seite im Shop.

Die Verwendung der kurzen URLs ist für alle Shoptypen zulässig, wird also nicht durch Lizenz oder Shoptyp eingeschänkt.

Für bestimmte Seiten können keine KU vergeben werden:

2 Vorteile

In den Ergebnislisten von Suchmaschinen wird die URL des Treffers mit aufgeführt. Diese URL sollte daher kurz und aussagekräftig sein.

2.1 Funktionsweise

Wichtig: Die Verwendung der kurzen URLs ist nur für Shops mit eigener Domain möglich.

  1. Beim Request mit der URL http://www.meinshop.de/MyProduct wird diese an den Webserver übergeben.
  2. Im Webserver findet ein Rewrite statt auf http://www.meinshop.de/epages/.shorturl?URI=MyProduct
  3. Der RequestRouter erkennt anhand der Domain "www.meinshop.de" den Application-Server-Pool und leitet Anfrage dorthin weiter
  4. Ein neues Servlet übernimmt den Request und erkennt anhand der Domain die StoreDB und die ShopID
  5. Das Servlet startet eine Datenbankabfrage mit dem Parameter "MyProduct" für den identifizierten Shop.
  6. Die Antwort liefert StoreAlias, GUID oder ObjectID. Gibt es die aufgerufene ShortUrlId nicht, wird der Fehler 404 "Die angeforderte Seite existiert nicht. .....> Weiter zur Webseite" des Shops wird angezeigt.
  7. Die Daten werden an das Storefront-Servlet übergeben und dort weiterverarbeitet.
Intern werden die ursprünglichen, langen URLs verwendet.

2.2 Vermeidung von "Duplicate content"

Da mehrere URLs (von intern und extern) zur selben Seite führen, würden diese bei Suchmaschinen in Probleme aufgrund "duplicate content" (kopierter Inhalt) laufen. Beispiel-URLs für die gleiche Seite:

  http://www.meinshop.de/epages/DemoShop.sf/de_DE/?ObjectPath=/Shops/DemoShop/Products/lt_0401107001
  http://www.meinshop.de/MyProduct
  http://server/epages/DemoShop.sf/?ObjectPath=/Shops/DemoShop/Products/lt_0401107001&ViewAction=ViewProductViaPortal&Locale=de_DE&et_cid=1&et_lid=1

Um dies zu vermeiden, werden canonical Links verwendet. Im Quelltext wird das neue HTML-Tag <link rel="canonical" href="..."></link> eingefügt. Für alle Seiten, für die eine ShortUrlId in der entsprechenden Sprache angegeben ist, wird im HEAD-Bereich der Eintrag <link rel="http://[Domain]/[ShortUrlId]"></link> hinzugefügt.

Im Ergebnis ziehen Suchmaschinen das Ranking aller URLs der selben Seite auf diesen Link (also den "canonical") zusammen und zeigen ausschließlich diesen im Suchergebnis, dem natürlichen Index.

3 Änderungen und Funktionen

3.1 BBO

Für den Shop muss eine eigene Domain eingetragen werden.

3.2 MBO

3.3 Regeln für die ShortUrlId

Die zulässige Länge der ShortUrlId beträgt 255 Zeichen.

Zulässge Zeichen und Sequenzen:

4 Konfiguration bei Nichtstandard-Installationen

Sollten die KU nicht funktionieren, ist gegebenenfalls eine manuelle Konfiguration des Systems erforderlich:

4.1 WebInterface.conf

Hier werden die Ausnahmen festgelegt, für die keine KU gebildet wird.

Beispiel:

  ...
  [URLRewite]
  WebRoot=/WebRoot/
  epages=/epages/
  BaseURI=/
  ExceptionRegex=/robots.txt /favicon.ico
  ExceptionPrefix=/epages/ /WebRoot/
  ExceptionHost=shop.strato.de shop.strato.com
  ...

Die Zeile "ExceptionPrefix=/epages/ /WebRoot/" würde z. B. einstellen, dass alle "normalen" ePages URLs wie bisher behandelt werden, außerdem würde für Bilder die RewriteRule nicht angewendet.

4.2 Servlet.conf

Hier muss eine Sektion für die Verarbeitung der KU eingetragen sein:

  ...
  20=Diagnostics
  25=ShortURL
  29=RSS
  ...

  [ShortURL]
  expression=$hServerVariables->{SCRIPT_NAME} =~ /\.shorturl/
  package=DE_EPAGES::Content::Servlet::ShortURL
  DomainName=$hServerVariables->{HTTP_HOST}
  ...

4.3 IIS Konfiguration für Windows

Die Einstellungen in einer Windowsumgebung müssen im Webserver (IIS) vorgenommen werden.

  IIS >> Standardwebseite >> Eigenschaften >> ISAPI-Filter

  Filtername:        ShortURL
  Priorität:         Niedrig
  Status:            Geladen
  Ausführbare Datei: D:\epages\WebAdapter\ShortUrlFilter.dll

  IIS >> Standardwebseite >> epages >> Eigenschaften >>
         Virtuelles Verzeichnis >> Konfiguration >> Zuordnungen

  Erweiterung:                .shorturl
  Pfad für ausführbare Datei: D:\epages\WebAdapter\ISAPIAdapter.dll
  Vererben:                   Alle
  Bearbeiten >> "Prüfen, ob Datei existiert": Darf nicht markiert sein

  IIS >> Standardwebseite >> Eigenschaften >> Basisverzeichnis >>
         Anwendungsschutz,
  IIS >> Standardwebseite >> epages >> Eigenschaften >>
         Virtuelles Verzeichnis >> Anwendungsschutz

  IIS >> Standardwebseite >> Eigenschaften >> Basisverzeichnis >>
         Anwendungspool,
  IIS >> Standardwebseite >> epages >> Eigenschaften >>
         Virtuelles Verzeicnis >> Anwendungspool

  IIS >> Standardwebseite >> Webseite verwalten >>
         Erweiterte Einstellungen >> Anwendungspool,
  IIS >> Standardwebseite >> epages >> Anwendung verwalten >>
         Erweiterte Einstellungen >> Anwendungspool

4.4 Apache Konfiguration für Linux

  <IfModule rewrite_module>
    RewriteEngine on
    RewriteCond %{HTTP_HOST} !^\[2001:4bd8:2:2:213:d3ff:fe62:f1f0\]$ [NC]
    RewriteCond %{HTTP_HOST} !^x64lime$ [NC]
    RewriteCond %{HTTP_HOST} !^x64lime\.intern\.epages\.de$ [NC]
    RewriteCond %{REQUEST_URI} !^/epages/
    RewriteCond %{REQUEST_URI} !^/WebRoot/
    RewriteCond %{REQUEST_URI} !^/robots.txt
    RewriteCond %{REQUEST_URI} !^/favicon.ico
    RewriteRule ^/(.+)$ /epages/.shorturl/?URI=$1 [PT,QSA]
  </IfModule>

  LoadModule rewrite_module modules/mod_rewrite.so
  Include conf/extra/zzz-epages-rewrite.conf

  AddHandler fcgiadapter .shorturl

  RewriteEngine:  On
  RewriteOptions: Inherit

Das Skript "update-rewrite-conf.sh", welches Kurz-URLs unter Linux erzeugt, ist in http://helpcenter.epages.com/Doc/ver_6_15_1/epages/Manual/en/Shell_Scripts_for_ePages_on_Linux.html#updaterewriteconfsh update-rewrite-conf.sh beschrieben.


Copyright ePages Software GmbH 2013