1. Was ist GrammiwebAdOpen?

AdOpen ist ein nahezu universell einsetzbarer Anzeigenrotator, der 
beliebige Text- und Banneranzeigen sowie Texteinblendungen in 
zufälliger Reihenfolge in eine bestehende Internetseite einbindet und 
diese Einbindungen sowie die Klicks auf Anzeigen statistisch auswertet.

Durch die strikte Umsetzung in der Scriptsprache PHP und die 
Verwendung der weit verbreiteten Datenbank MySQL ist AdOpen innerhalb 
aller Webpräsenzen, die diese Vorgaben erfüllen, unkompliziert 
einsetzbar.

AdOpen ist für den nichtkommerziellen Gebrauch frei verwendbar. Bei 
kommerzieller Nutzung bieten wir Ihnen AdOpen zu einem geringen 
Betrag an, der uns bei der Entwicklung von Programmerweiterungen sowie 
bei der Konstruktion neuer Produkte unterstützt. Nähere Informationen 
hierzu finden Sie auf der AdOpen-Homepage unter 
http://www.grammiweb.de/php/produkte/adopen.shtml



2. Installation

Systemvoraussetzungen: PHP, MySQL, Cookie-fähiger Browser

Entpacken Sie die ZIP-Datei in ein Verzeichnis Ihrer Wahl. Alle 
Einstellungen nehmen Sie in der Datei "config.php" vor, die sich 
im Unterverzeichnis /adopen befindet. Die Angaben erhalten Sie von bei
Bedarf von Ihrem Provider:

"$db_host" - Host der MySQL-Datenbank

"$db_name" - Name der bestehenden Datenbank
"$db_user" - Ihr Nutzername für die Datenbank
"$db_pass" - Ihr Passwort für die Datenbank
"$pfad" - Der Pfad zum Counter, 
	  beginnend mit / (Hauptverzeichnis) und abschließendem /
"$target" - Ziel bei Klicks auf die Anzeige
"$adminname" - Beliebiger Administratorenname
"$adminpass" - Beliebiges Administratorenpasswort
"$textstart" - Formatierungsanweisungen für Textanzeigen
"$textend" - Ende der mit $textstart angewiesenen Formatierungen

Die restlichen Einstellungen in der Datei "config.php" müssen nicht 
geändert werden.

Geben Sie in der zweiten Zeile der Datei "count.php" den Pfad zum 
Administrationsprogramm ein, beginnend mit dem Verzeichnis, in dem 
sich die Datei "count.php" befindet. Haben Sie alle 
Administrationsdateien im Unterverzeichnis "sub2" des 
Unterverzeichnisses "sub1" abgelegt, welches wiederum direkt unter 
dem Hauptverzeichnis liegt, lautet der korrekte Eintrag also 
"sub1/sub2/config.php".



3. Upload der Dateien

Legen Sie nun die Dateien auf Ihrem Webserver ab. Denken Sie daran, 
die Datei "count.php" in dem Verzeichnis abzulegen, das Sie unter 
"$pfad" gewählt haben.



4. Anlegen der Datenbankstruktur

Starten Sie nun die Datei "setup.php". Diese Datei erstellt auf 
Grundlage der bisher gemachten Angaben eine Tabelle innerhalb der 
oben angegebenen Datenbank und kann nach erfolgreicher Installation 
gelöscht werden.



5. Einbinden in Webdokumente

Unterstützt Ihr Webserver Server Side Includes, können Sie folgenden Code verwenden, um AdOpen in Ihre Webseiten einzubinden:

<!--#include virtual="/pfad_zu/anzeige.php" -->

Sie haben optional die Möglichkeit, den Anzeigentyp auszuwählen:

Für Textanzeigen: <!--#include virtual="/pfad_zu/anzeige.php?type=t" --> 
Für Banneranzeigen: <!--#include virtual="/pfad_zu/anzeige.php?type=b" --> 
Für Texteinblendungen: <!--#include virtual="/pfad_zu/anzeige.php?type=m" --> 

Dieser Code muß an der Stelle im Quelltext der Seite eingefügt werden, 
an der die Anzeige erscheinen soll. Bitte achten Sie dabei darauf, den 
Pfad zum Script richtig einzugeben (beginnend mit dem 
Hauptverzeichnis). Liegt das Script im Unterverzeichnis "adopen", 
welches wiederum im Unterverzeichnis "scripte" angelegt wurde, lautet 
der Pfad folgerichtig "/scripte/adopen/".

Haben Sie Seiten im PHP-Format vorliegen, fügen Sie an der Stelle, an 
der die Anzeige erscheinen soll, folgenden Code ein:

<? include("/pfad_zu/anzeige.php"); ?>

Sie haben optional die Möglichkeit, den Anzeigentyp auszuwählen:

	Für Textanzeigen:
	<?
	$type = t;
	include ("/pfad_zu/anzeige.php");
	?>

	Für Banneranzeigen:
	<?
	$type = b;
	include ("/pfad_zu/anzeige.php");
	?>

	Für Texteinblendungen:
	<?
	$type = m;
	include ("/pfad_zu/anzeige.php");
	?>

Wird dieser Code innerhalb einer PHP-Sequenz aufgerufen (innerhalb 
der Markierungen <? und ?>), geben Sie einfach diesen Code ein:

include ("/pfad_zu/anzeige.php");

Sie haben optional die Möglichkeit, den Anzeigentyp auszuwählen:

	Für Textanzeigen:
	$type = t;
	include ("/pfad_zu/anzeige.php"); 

	Für Banneranzeigen:
	$type = b;
	include ("/pfad_zu/anzeige.php"); 

	Für Texteinblendungen:
	$type = m;
	include ("/pfad_zu/anzeige.php"); 

Bitte achten Sie dabei darauf, den Pfad zum Script richtig einzugeben 
(beginnend mit dem Hauptverzeichnis). Liegt das Script im 
Unterverzeichnis "adopen", welches wiederum im Unterverzeichnis 
"scripte" abgelegt wurde, lautet der Pfad folgerichtig 
"/scripte/adopen/".


Das war's schon. Sollten Sie weitere Fragen haben, finden Sie im
Verzeichnis /adopen die Datei "admin_help.htm", mit der eine 
ausführliche Onlinehilfe zur Verfügung steht.