Dokumentation

Der ShortURL-Service macht aus langen Links kurze.

Vorteile

  • Anstelle des langen Links https://meine_fakultaet.fau.de/hauptmenue/untermenue/ein_langer_titel brauchen Ihre Studierenden nur den kurzen Link https://go.fau.de/1abc in der Vorlesung zu notieren.
  • Dank des QR-Codes, den Sie entweder ausdrucken oder auf Ihrer Website verwenden können, ist es bequem, diesen einfach mit der Kamera zu scannen und Ihre Seite im Browser auf dem Smartphone oder Tablet zu besuchen.

Muss ich etwas tun?

Nein. Sobald Sie einen Link verkürzt haben, übernimmt go.fau.de automatisch die Weiterleitung.
Der Link unbegrenzt lange gültig. Sie können auch ein Gültigkeitsdatum angeben. Täglich werden die Links geprüft und bei Rückgabe eines HTTP Fehlers im Bereich von 4xx werden die Links gelöscht.

Datenschutz

Die Weiterleitung geschieht unter Berücksichtigung der Datenschutz-Bestimmungen. Bekannte Anbieter (z.B. bit.ly, TinyURL, goo.gl, t.co) speichern Informationen Ihrer Website-BesucherInnen wie beispielsweise die IP-Adresse, das Gerät und den Browser. Unser Service speichert hingegen nichts.

QR-Code

Zusätzlich zum verkürzten Link wird ein QR-Code zum Download bereitgestellt. Sie können diesen zum Beispiel für Print-Produkte wie Plakate oder für Marketing-Strategien verwenden.

Vorschau

Eine Voransicht (Preview) wird angezeigt, wenn an einen verkürzten Link das Plus-Zeichen angehängt wird. Beispiel: https://go.fau.de/1abc+ zeigt eine Website mit der Information, dass https://go.fau.de/1abc auf https//meine_fakultaet.fau.de/hauptmenue/untermenue/ein_langer_titel weitergeleitet wird.

SEO

Unser Service hat keinerlei Einfluss darauf, wie Google oder andere Suchmaschinen Ihre Website bewerten.

Technische Erklärung:
Wir liefern die Short-URLs mit HTTP Statuscode 303 aus. Der HTTP-Statuscode 303 steht für „See Other“ und weist den Client an, eine andere URL zu einer neuen Ressource mittels einer GET-Anfrage abzurufen. Einfluss auf das Ranking in Suchmaschinen hätten hingegen diese Statuscodes: 301 „Moved Permanently“ und 308 „Permanent Redirect“. Wir verwenden im System bewusst nicht den Status Code 302, weil wir auch GET-Parameter und Sprungmarken unterstützten, die mit 303 beibehalten werden.
Ein GET-Parameter ist alles das, was nach einem Fragezeichen in einem Link zu sehen ist. Darin werden Werte von Variablen an den Server übermittelt. Beim Parsen einer URL ist dies die Komponente „query“. Sprungmarken werden mit dem Gatter-Symbol (Hash „#“) gekennzeichnet und sind ein Befehl an den Browser zu einer bestimmten Stelle einer Webseite zu scrollen. Beim Paresen der URL ist dies die Komponente „fragment“.

Berechnung

Die Kodierung erfolgt mithilfe aller kleingeschriebener Buchstaben, sowie 0 bis 9 und das Minus-Zeichen.
Das Ergebnis ist eine auf Basis 37 umgerechnete Zeichenfolge einer eingebenen Dezimalzahl.

Beispiel:
https://www.helpdesk.rrze.fau.de/otrs/index.pl?Action=AgentTicketZoom;TicketID=1166915
Hier wird die TicketID „1166915“ verwendet, um daraus den Code „asdf“ zu generieren.
Diese Code wird mit dem Prefix (9) vom Service „Helpdesk“ an die Basis von unserem Server, der die Weiterleitungen durchführt angehängt.
Der Kurz-Link ist somit https://go.fau.de/9asdf

Die Links zu anderen Services werden in gleicher Art berechnet. Manche haben mehr als einen Parameter, dessen numerischer Wert mit der gleichen Formel berechnet wird. Die Unterteilung der einzelnen Parameter im Short-URL erfolgt mit Punkt.


Gibt es eine Schnittstelle? Kann ich das Plugin auf meiner eigenen WordPress-Installation verwenden? Kann ich den Code ansehen und verändern?

Für Betreiber von eigenen WordPress-Installationen verweisen wir auf die Readme zum WordPress Plugin RRZE-ShortURL, das diesen Service im Zusammenspiel mit SSO mithilfe eines unserer nicht-öffentlichen Plugins ermöglicht.

Kurz:

  • Ja, es gibt eine REST-API Schnittstelle. Einige Endpoints sind jedoch durch SSO oder die IP-Adress-Bereiche unseres Uni-Netzwerks geschützt.
  • Ja, Sie können das Plugin grundsätzlich sowohl auf Ihrer eigenen Installation von WordPress als auch für Multi-Site nutzen, aber müssen dazu Anpassungen vornehmen, weil es für unseren Bedarf an der FAU optimiert ist: in den Settings des Plugins im Admin-Bereich muss Ihre Domain eingetragen werden und sofern Sie auf zwei verschiedenen Servern, wie wir es tun, den Service betreiben möchten, müssen Sie in make_htaccess.php (Ordner „Server“) Ihre Domain eintragen. Sie benötigen zudem eine SSO-Anbindung oder passen Rights.php so an, dass der Schutz der REST-API-Endpoints (API.php) Ihren Wünschen entsprechend erfolgt, sowie die geschützten Pages, die die Shortcodes oder den Block nutzen, ggf. öffentlich sind, wodurch Sie keinen SSO benötigen. Beachten Sie hierzu insbesondere Rights.php (Ordner „includes“). Näheres finden Sie detailliert erklärt im Readme. Bei Fragen wenden Sie sich gerne an uns. Wir versuchen in der Open-Source-Community mitzuwirken, bitten jedoch um Verständnis, dass unsere Kunden stets Vorrang haben und wir nur ein sehr kleines Team sind, das viele Kunden (>120) mit knappen Ressourcen betreut.
  • Ja. Der Code ist open-source. Über fachlich qualifizierte Mitarbeit freuen wir uns! Nutzen Sie dazu ausschließlich die dafür vorgesehenen Prozesse von Github, um eigenen Code ins Plugin zu überführen. Wir werden Ihren Code zeitnah prüfen und uns ggf. über Github mit Ihnen dazu austauschen, falls wir Ihren Code nicht unmittelbar mit dem des Plugins mergen und Sie damit automatisiert informiert werden. Haben Sie einen Fehler entdeckt? Bitte zögern Sie nicht, ihn uns unmittelbar mitzuteilen.

Wünsche, Anregungen, Fehler, Lob und Kritik

Wir freuen uns sehr auf Ihre Nachricht! Sei es Lob, Kritik, eine Anregung oder ein Wunsch. Denn wir entwickeln mit einem Ziel: Ihnen die bestmöglichen Werkzeuge bereitzustellen, um Ihre Webseiten-BesucherInnen mit Ihren Informationen optimal zu versorgen. Sie helfen uns dabei mit Ihrem Feedback.