Konfigurationsanleitung

Einleitung

Vielen Dank für Ihr Interesse an unserem Voting Script. Wir empfehlen Ihnen, sich Zeit für die Lektüre dieser Anleitung zu nehmen.

Das Script ist für den sofortigen Einsatz konfiguriert und eingerichtet. Nachdem Sie das Script auf den Server kopiert haben, können Sie es sofort verwenden. Wenn Sie Änderungen vornehmen möchten, sollten Sie diese schrittweise durchführen und nach jeder Änderung die Auswirkung auf das Script zu testen. Sie behalten dadurch den Überblick, welche Änderung einen eventuell auftretenden Fehler verursacht hat.

Beachten Sie bitte auch, dass das Verzeichnis "logfiles" Schreibrechte besitzen muss (chmod 777). Dasselbe gilt für alle darin befindlichen Dateien.

Das HTML-Template wurde nach den Spezifikationen für XHTML 1.0 erstellt. Deshalb enthalten alle einfachen Tags (<br> oder <input>) einen abschließenden Slash (<br /> oder <input type="text" name="feld" />).

Funktionsweise des Scripts

Mit diesem Script können Sie Umfragen und Abstimmungen auf Ihrer Website einrichten. Die Besucher können eine der Optionen auswählen und durch einen Klick auf den Submit-Button abstimmen. Die Umfrageergebnisse werden in einem Balkendiagramm angezeigt. Sie können die Optionen als Radio-Button mit Text oder Bildern und als Select-Menü anzeigen lassen.

Zum Einschränken und Vermeiden von Manipulationen arbeitet das Script mit der IP-Adresse des Besuchers und/ oder mit Cookies. Damit soll sicher gestellt werden, dass der Besucher nur einmal abstimmen kann. Beachten Sie aber, dass dies keine 100%-igen Lösungen sind. Mit entsprechendem Aufwand lassen sich diese Sicherheitsvorkehrungen umgehen.

Funktionen auf einen Blick

  • Anzeige der Abstimmungsergebnisse mit Hilfe von Balkengrafiken

  • Verschiedene Grafiken mit verschiedenen Farben und Größen für die Balken möglich

  • Anpassung des Layouts durch HTML-Templates

  • Vermeidung von Manipulationen durch Prüfung der IP-Adresse und/oder Setzen eines Cookies

  • Text- oder Grafik-Option für Radio-Buttons

 

Konfiguration des Scripts

Die Datei "index.php" stellt die Konfigurationsdatei für das Script dar. Sie haben dadurch die Möglichkeit, die Datei zu duplizieren und mit anderen Konfigurationen aufzurufen und zu betreiben, trotzdem aber den selben Script-Kern zu nutzen. Dadurch brauchen Sie das Script nur einmal zu installieren und bei Bedarf nur einmal zu lizenzieren.

Zusätzlich zu der Datei "index.php" wurde zu Demonstrationszwecken die Datei "voting_image_options.php" eingerichtet. Bei dieser Abstimmung wurden anstatt von Text-Optionen Bild-Pfade angegeben. Anstatt zwischen verschiedenen Text-Optionen können die Besucher zwischen verschiedenen Bildern auswählen. Außerdem wurde ein anderer eindeutiger Name ($intern_vote_name) für die Abstimmung angegeben und als Feld-Typ ($form_field_type) wurde "radio_image".

Folgende Variablen können editiert werden:

$vote_title

Sie können für jede Abstimmung einen eigenen Titel angeben. Der wird im <title> Tag und als Überschrift angezeigt. Beispiel:

 

$vote_title = 'Lieblingsfarbe';

 

$vote_text

Analog zum Titel einer Abstimmung können Sie einen Text (z.B. eine Frage oder Beschreibung) eintragen. Beispiel:

 

$vote_text = 'Was ist Ihre Lieblingsfarbe?';

 

$vote_option[]

In dieser Variable können Sie die Auswahlpunkte (Optionen) eintragen, zwischen denen der Benutzer auswählen können soll. Dabei wird für jede Auswahlmöglichkeit eine eigene Variable festgelegt. Beispiel:

 

$vote_option[] = 'Rot';

$vote_option[] = 'Grün';

$vote_option[] = 'Blau';

 

Anstatt von Text können Sie Grafiken als Optionen einrichten. Beispiel:

 

$vote_option[] = './templates/smilies/1.gif';

$vote_option[] = './templates/smilies/2.gif';

$vote_option[] = './templates/smilies/3.gif';

 

Zusätzlich zu den Pfaden müssen Sie als Feld-Typ ($form_field_type) "radio_image" angeben.

 

$intern_vote_name

Hier muss ein Name für die Abstimmung eingetragen werden, der intern durch das Script verwendet wird. Vermeiden Sie bitte Leer- und Sonderzeichen. Der interne Name für die Abstimmung muss angegeben werden, weil das Script für alle Abstimmungen mit einer einzigen Log-Datei arbeitet. Um die einzelnen Abstimmungen von einander unterscheiden zu können, muss der interne Abstimmungsname einzigartig sein. Beispiel:

 

$intern_vote_name = 'lieblings_farbe';

 

$form_field_type

Sie haben die Möglichkeit, zwei verschiedene Arten von Auswahlmenüs anzeigen zu lassen. Um eine Liste von Radio-Buttons zu erhalten, geben Sie bitte "radio" in die Variable ein. Beispiel:

$form_field_type = 'radio';

Ergebnis: Text

Anstatt von Text neben den Radio-Buttons können Sie auch Grafiken anzeigen lassen. Tragen Sie dazu "radio_image" als Feld-Typ ein. Beispiel:

$form_field_type = 'radio_image';

Ergebnis:

Sie können auch ein Select-Menü anzeigen lassen. Geben Sie dazu bitte "select" an. Beispiel:

$form_field_type = 'select';

 

$bar_image_name

 

$max_bar_width

 

$check_ip_address

 

$check_cookie

 

$language

 

$path['templates']