Grammiweb PHPTopBar Version 1.0 ____________________________________________________________________ Inhalt dieser Datei 1. Was ist PHPTopBar 2. Systemvoraussetzungen 3. Installation 4. Einbinden in Webdokumente 5. Anmerkungen ____________________________________________________________________ 1. Was ist PHPTopBar PHPTopBar hilft Ihnen bei der Erfolgskontrolle Ihrer Verlinkungen. Dazu können Sie durch eine kleine Veränderung der Hyperlinks auf Ihrer Site Informationen dazu erhalten, wie häufig diese angeklickt werden. Zusätzlich kann PHPTopBar Verweise innerhalb von Framesets laden, so dass Ihre Besucher z. B. jederzeit wieder zurück auf Ihre Seiten gelangen können. Ein zusätzliches Anwendungsgebiet ist auch die Kontrolle des Klick- verhaltens innerhalb Ihrer Webpräsenz, indem Sie einfach auch die internen Klicks zählen lassen. ____________________________________________________________________ 2. Systemvoraussetzungen PHP (http://www.php.net/) MySQL (http://www.mysql.com/) Ob Ihr Webserver PHP und MySQL unterstützt, erfahren Sie bei Ihrem Provider. ____________________________________________________________________ 3. Installation Entpacken Sie die ZIP-Datei in ein Verzeichnis Ihrer Wahl. In diesem Verzeichnis wird ein Unterverzeichnis mit dem Namen "topbar" angelegt. Im Unterverzeichnis "topbar" finden Sie nach dem Entpacken folgende Dateien: - topbar.php - topbar_admin.php - topbar_install.php - topbar.gif - topbar_test.html - topbar_frame.html Topbar speichert die an das Script übergebenen Daten in einer MySQL-Datenbank. Um diese anbinden zu können, benötigen Sie folgende Informationen von Ihrem Provider: - Name der Datenbank - Host der Datenbank - Ihr Nutzername für die Datenbank - Ihr Passwort für die Datenbank Ergänzen Sie diese Daten nun in folgenden Dateien: - topbar.php In den Zeilen 12 bis 15 ergänzen Sie die Vorgaben einfach durch Ihre Daten. Zusätzlich können Sie hier noch folgende Angaben machen: Zeile 6: $topbar = "..."; Den Dateinamen der Webseite, die in den oberen Frame geladen werden soll, wenn Sie die Anzeige der TopBar wünschen. Bitte achten Sie hierbei auch auf die korrekten Pfadangaben. Zeile 7: $hoehe = "..."; Die Höhe der TopBar (in Pixeln) Zeile 8: $anzeigeform = "..."; Standardmässig wird die TopBar oberhalb der Seite angezeigt, die durch den Link aufgerufen wird (0). Sie können alternativ auch eine Anzeige am linken Fensterrand bewirken, indem Sie Sie den Wert auf 1 ändern. Dann bezieht sich der Wert in Zeile 7 nicht auf die Höhe, sondern die Breite der Leiste Zeile 9: $fenstertitel = "..."; Titel des Fensters - topbar_admin.php Hier ergänzen Sie einfach die Zeilen 7-10. Wählen Sie zusätzlich in den Zeilen 13 und 14 ein Passwort und einen Nutzernamen für den Administratoren-Login, die idealerweise nicht mit den Datenbankdaten übereinstimmen sollten. Diese Daten werden für das Einloggen in die Admin-Oberfläche benötigt. Nachdem Sie die Angaben geändert haben, können Sie die Dateien auf Ihren Webserver heraufladen. Hierbei empfehlen wir, die Datei "topbar.php" in das Hauptverzeichnis Ihrer Webpräsenz zu speichern (/). Bitte beachten Sie auch die Einhaltung der Pfadangabe zur Datei "topbar_frame.html", die Sie weiter oben vorgenommen haben. Anschließend rufen Sie die Datei "topbar_install.php" auf, die die notwendigen Einstellungen der Datenbank vornimmt. Nach dem Aufruf dieser Datei werden die von oben bekannten Informationen zur Datenbank nochmals abgefragt. Nach einem Klick auf die Schaltfläche "Tabelle anlegen" wird auf Grundlage dieser Werte die Tabelle "topbar" angelegt. Sollte diese Aktion erfolgreich durchgeführt worden sein, erscheint eine entsprechende Meldung. Im Gegenzug erscheint ein Warnhinweis, wenn die Tabelle nicht hatte angelegt werden können. Wechseln Sie dann zurück zur Eingabemaske und überprüfen Sie die Angaben. Sollte die Installationsroutine auf Ihrem System nicht ausgeführt werden können, können Sie alternativ mit einem Administrationsprogramm wie z. B. phpMyAdmin folgenden Dump ausführen: CREATE TABLE topbar ( id int(11) NOT NULL auto_increment, clicks int(11) NOT NULL default '0', ziel text NOT NULL, datum text NOT NULL, KEY id (id) ) TYPE=MyISAM; Nach erfolgter Installation sollten Sie die Datei "topbar_install.php" löschen. Mit diesem letzten Schritt ist die Installation von PHPTopBar durchgeführt. ____________________________________________________________________ 4. Einbinden in Webdokumente Im Regelfall werden Links auf Ihrer Website in folgender Form notiert: Text (wobei "LINK" dem Ziel entspricht) Ergänzen Sie die Zielvorgabe einfach durch den Zusatz "/topbar.php?ziel=", so dass, dem Beispiellink oben folgend, der Quelltext wie folgt lauten würde: Text Dabei wird davon ausgegangen, dass die Datei "topbar.php" im Hauptverzeichnis des Servers ("/") liegt. Wäre die Datei z. B. im Unterverzeichnis "topbar" (könnte sie also über http://www.domain.tld/topbar/topbar.php aufgerufen werden), sollte der Link dementsprechend lauten: Text In der Grundeinstellung ruft PHPTopBar die verlinkte Seite innerhalb eines Framesets auf. Sollten Sie dies nicht wünschen, können Sie die Statistikfunktion trotzdem nutzen, indem Sie den Link wie folgt notieren: Text Achten Sie dabei bitte auf die richtige Reihenfolge (zuerst "ziel=", dann "&frame=") sowie die richtige Schreibweise (das Ziel wird mit "?ziel=" angehangen, das Frameattribut mit "&frame=". Auf der Beispielseite "topbar_test.html" können Sie einige Beispiele hierzu finden. Die Statistiken können Sie abrufen, indem Sie die Datei "topbar_admin.php" aufrufen. Innerhalb dieses Webinterfaces werden Ihnen verschiedene Auswertungskriterien sowie einige administrative Funktionen angeboten. So können Sie hier die Klickrate von Links zurücksetzen oder diese ganz löschen, oder auch einen Zieleintrag selbst ändern (wenn z. B. die Seite "seite.htm" in "seite1.htm" geändert wurde, die Klickrate aber auch für die neue Seite weitergezählt werden soll). Um das Administrationsmenü aufrufen und nutzen zu können, muss Ihr Browser Cookies akzeptieren. Das war's schon. Sollten Sie weitere Fragen haben, stehen wir Ihnen unter http://produkte.grammiweb.de/ gerne zur Verfügung. ____________________________________________________________________ 5. Anmerkungen Dieses Script wurde von uns "auf Herz und Nieren" geprüft und ohne uns bekannte Fehler zum Download bereit gestellt. Trotzdem wollen wir Sie darauf hinweisen, dass wir keine Haftung für dessen Funktion und eventuelle Datenverluste übernehmen. Die Anwendung des Scripts erfolgt unter eigener Haftung. Die in dieser Anleitung und in dem Script verwendeten Marken- und Firmenbezeichnungen stehen unter Markenschutz des jeweiligen Rechteinhabers. Dieses Script sowie die damit verbundenen Scriptteile stehen, sofern nicht anders angegeben, unter Copyright von Grammiweb.de (http://www.grammiweb.de/). Jegliche Änderung, Modifikation oder Weitergabe ist untersagt, sofern dies nicht anders angegeben wurde. Grammiweb.de - Die Webmacher Inhaltlich Verantwortlicher: Frank Gramatzki Adresse: Pfr.-H.-Fuchs-Str. 14 50997 Köln Deutschland Umsatzsteuer-Identifikationsnummer gem. § 27a UStG: DE205484657