Dokumentation des URL-Shorteners

Installation

Die Installation des URL-Shortener ist recht einfach.

1. Laden Sie den URL-Shortener hier runter: Download
2. Entpacken Sie das Archiv und legen Sie den Inhalt des Archivs im Document-Root Ihres Webservers oder Ihres V-Hosts ab, sodass die Datei index.php direkt im Document-Root liegt.
   
   
   
   
3. Geben Sie den Dateien die erforderlichen Berechtigungen für den User unter dem der Webserver läuft.
   
   Beispiel (im Document-Root):
   

   chow -R www-data: *
   chmod -R 775 *

4. Legen Sie eine Datenbank und einen Datenbankbenutzer mit den nötigen Rechten auf dem MySQL Server an und importieren Sie den im Archiv enthaltenen Datenbankdump (mysql_dump.sql).
5. Löschen Sie den Datenbankdump aus dem Dateisystem.
   

   rm mysql_dump.sql

6. Öffnen Sie die Datei config.xml im Verzeichnis config und ändern Sie folgende Einstellungen Ihrem System entsprechend.
   

   <host>IPoderHostnameDesDatenbankservers</host>
   <user>UsernameDesDatenbankbenutzers</user>
   <password>PasswortDesDatenbankbenutzers</password>
   <dbname>NameDerDatenbank</dbname>

Umgestaltung

Sie haben unter Beachtung der GPL die Möglichkeit, den URL-Shortener beliebig an Ihre eigenen Bedürfnisse anzupassen. Das Programm ist in allen Klassen und Dateien dokumentiert und kann somit leicht geändert werden. Sie können so Ihr eigenes Brand integrieren und Funktion und Erscheinungsbild anpassen.

Statistiken

In einer künftigen Version des URL-Shorteners ist eine umfangreiche Statistik geplant. Um aber vorzeitig ausführliche Statistiken bekommen zu können haben Sie die Möglichkeit Google-Analytics zu integrieren. Öffnen Sie dazu die Datei index.php und fügen Sie an die Stelle

<!-- Google-Analytics-Code -->

in Zeile 47 den von Google vorhandenen Code ein (siehe Anleitung Google Analytics).

Da die durch den Shortener erzeugte URL nicht sehr einfach zu merken ist, ist es schwer nachzuvollziehen, welche Seite aufgerufen wurde. Um dieses Problem zu umgehen, haben Sie die Möglichkeit die aufgerufene Seite leserlich bei Google Analytics zu tracken. 

Der Google Analytics Code sieht für gewöhnlich so aus:

<script type="text/javascript">
    var _gaq = _gaq || [];
    _gaq.push(['_setAccount', 'UA-YOUR_ACCOUNT_NUMBER']);
    _gaq.push(['_trackPageview']);
        
    (function() {
        var ga = document.createElement('script'); ga.type = 'text/javascript'; ga.async = true;
        ga.src = ('https:' == document.location.protocol ? 'https://ssl' : 'http://www') + '.google-analytics.com/ga.js';
    var s = document.getElementsByTagName('script')[0]; s.parentNode.insertBefore(ga, s);
})();
</script>

Die aufgerufene Seite wird mit dem folgenden Code getrackt:

_gaq.push(['_trackPageview']);

Durch eine kleine Änderung in dem Code können Sie eine leserliche URL tracken:

_gaq.push(['_trackPageview', '<?php echo urlencode($newLocation); ?>']);

Somit wird die URL in der folgenden Form getrackt:

http%3A%2F%2Fwww.bitprofessional.com%2F

Gerne können Sie diese Form auch noch weiter abwandeln, damit die URL noch besser zu lesen ist.

zurück zur Übersicht des URL-Shorteners