Die eigene YOURLS (v1.5)-Installation und TweetDeck Desktop (v0.36.2).

Wenn man eine eigene YOURLS-Installation betreibt, kann man einfach und bequem, Shortlinks erstellen. Ich persönlich bevorzuge dazu Plugins (z.B. in WordPress) die einem die Arbeit abnehmen oder implementierte Funktionen in der (Desktop-)Software, die ich benutze. Da Shortlinks für Twitter unerlässlich sind, benutze ich unseren privaten Shortener twty.de hauptsächlich für die Verbreitung von Links über Twitter.

Meine Desktop-Software der Wahl, im Fall Twitter, ist TweetDeck (aktuell in Version 0.36.2). Seit einiger Zeit kann man direkt durch Tweetdeck einen Secure passwordless API call veranlassen. TweetDeck verkürzt dabei die Links schon während der Eingabe automatisch.

Zur Vorbereitung muss man sich den “secret signature token” seiner YOURLS-Installation kopieren. Diesen findet man im YOURLS Adminbereich unter Tools im Abschnitt “Secure passwordless API call”.

Jetzt nimmt man sich folgende API-Abfrage und passt sie sich, seinen Bedürfnissen entsprechend, an. Man ersetzt also domain.tdl durch den Pfad zur eigenen yourls-api.php und erstezt APIKEY durch seinen secret signature token:

http://domain.tdl/yourls-api.php?signature=APIKEY&action=shorturl&format=simple&url=%@

Wichtiger Hinweis: Hier bitte ein “www” vor der Domain weglassen, sonst generiert YOURLS defekte Links!!

Jetzt hat man alle Vorbereitungen getroffen und kann nun zur Konfiguration von TweetDeck kommen.

Die Einrichtung von TweetDeck ist denkbar einfach und in nur 5 Schritten erledigt:

1. die TweetDeck Settings aufrufen
2. links im Menü Services anwählen
3. bei “Select the service you wish to use to shorten URLs” “Other” auswählen
4. bei “Other URL Shortening Endpoint” die vorbereitete API-Abfrage eintragen
5. mit einem Klick auf Save Settings werden alle Eingaben gespeichert und TweetDeck ist in der Lage, sollte alles korrekt erledigt worden sein, mit der eigenen YOURLS-Installation zu kommunizieren

Damit TweetDeck auch wirklich automatisch alle Links verkürzt, muss sicher gestellt werden, dass “Auto URL Shortening ” auf “ON” steht. Diesen kleinen Schalter findet man links, direkt unter dem Eingabefeld für neue Tweets.

Um die eigene YOURL-Installation optimal betreiben zu können, sollte die .htaccess Datei im YOURLS-Verzeichnis auf dem Server wie folgt aussehen:

Fall 1: Wenn die YOURLS Root-URL ist, dann sollte die .htaccess Datei so aussehen:

RewriteEngine on
RewriteCond %{HTTP_HOST} ^www.domain.tdl$ [NC]
RewriteRule ^(.*)$ http://domain.tdl/$1 [R=301,L]
<IfModule mod_rewrite.c>
RewriteEngine On
RewriteBase /
RewriteCond %{REQUEST_FILENAME} !-f
RewriteCond %{REQUEST_FILENAME} !-d
RewriteRule ^(.*)$ /yourls-loader.php [L]
</IfModule>

Fall 2: Wenn  YOURLS in einem Unterverzeichnis installiert ist (), dann sollte die .htaccess Datei so aussehen:

RewriteEngine on
RewriteCond %{HTTP_HOST} ^www.domain.tdl$ [NC]
RewriteRule ^(.*)$ http://domain.tdl/$1 [R=301,L]
<IfModule mod_rewrite.c>
RewriteEngine On
RewriteBase /somedir/
RewriteCond %{REQUEST_FILENAME} !-f
RewriteCond %{REQUEST_FILENAME} !-d
RewriteRule ^(.*)$ /subdir/yourls-loader.php [L]
</IfModule>

Wenn man diese Anleitung befolgt, dann sollte nichts schief gehen. Bitte auch den wichtigen Hinweis zur API-Abfrage befolgen, damit YOURLS keine defekten Links generiert.

Hier ein Beispiel:

Diese URL zu Möbelhaus sollte verkürzt werden: http://www.moebelhaus.de/
YOURLS machte daraus:

Es lag nur daran, dass die API-Abfrage das “www” vor der Domain enthielt.

Viel Spaß mit TweetDeck und der eigenen YOURLS-Installation.

Links:

• YOURLS
• YOURLS Wiki: What your .htaccess file should look like
• TweetDeck Desktop