LogoWebVote

Version 1.1
Jun. 2005

Das System WebVote ist eine Applikation zum Betrieb einer Umfrage, Meinungserhebung o.ä. auf einem Webserver. Es ist auf allen Webservern einsetzbar, die PHP4-Scriptseiten erlauben.

Das Programm kann (so wie es in diesem Softwarearchiv vorgefunden wurde) auf den meisten Webservern zum Betrieb gebracht werden. Allerdings sind Anpassungen erwünscht und ausdrücklich empfohlen. Dazu sind Kenntnisse in HTML notwendig, nicht jedoch in der Programmiersprache PHP.

Inhalt:

  1. Konzept von WebVote
  2. Anlegen/Ändern der Frage-Datenbank frage.txt
  3. Detailschablone frage.htm für die Anzeige der Fragen
  4. Detailschablone ergebnis.htm für die Auswertung
  5. Anpassung des PHP-Scriptes webvote.php
  6. Installation des Programmes WebVote
  7. Aufruf des Programmes und Einbettung in Ihr Web
  8. Rechtliches

Konzept von WebVote

Die Webapplikation WebVote kann als Meinungsumfrage, Abstimmung, Wahl, Votum o.ä. verwendet und leicht in ein bestehendes Web integriert werden. Sie ist ein PHP-Script und verlangt serverseitig die Möglichkeit zum Ausführen von PHP-Seiten.

Inhalt, Layout und Funktion wurden voneinander getrennt, sodass

vorgenommen werden können. Programmierkenntnisse in der Sprache PHP sind zur Anpassung von WebVote ausdrücklich nicht erforderlich.

1. Anlegen/Ändern der Frage-Datenbank

Die Frage und Auswahlantworten für WebVote werden in einer Datei namens frage.txt gespeichert. Es handelt sich bei dieser Datenbasis um eine reine Textdatei, die mit jedem üblichen Textverarbeitungsprogramm (Texteditor) erstellt/geändert werden kann. Die alleinige Änderung dieser einen Datei ist ausreichend, damit der Sachinhalt von WebVote Ihrem Anliegen entspricht.

In der ersten Zeile der Datei frage.txt tragen Sie bitte Ihre Frage ein. Diese Fragezeile schließt mit einem Zeilenwechsel (Enter) ab. Sofern Ihre Frage mehrzeilig auf der Webseite ausgegeben werden soll, müssen Sie den Zeichenwechsel durch den HTML-Tag <br> erzwingen.

Alle folgenden Zeilen in der Datei frage.txt sind Auswahlantworten. Jede Zeile bildet eine komplette Antwort und schließt ebenfalls mit einem Zeilenwechsel (Enter) ab.

Ein Beispiel für die Datenbasis wäre:


Wie finden Sie diese Webseite?
Spitze!!!
sehr gut
gut
ausreichend
schlecht
katastrophal!

Wenn Sie die Anzahl der Auswahlantworten ändern, dann müssen Sie nachfolgend auch in den beiden Schablonen frage.htm und ergebnis.htm Änderungen an der Zahl der Platzhalter vornehmen.

Falls Sie sich gut mit HTML-Befehlen auskennen, können Sie in den Frage- und Antworttexten auch einzelne Formatierungen für besondere Textteile vornehmen. Soll beispielsweise ein Wort fett dargestellt werden, ist es in die HTML-Tags <b> und </b> einzuschließen.


 Wie finden Sie <b>diese</b> Webseite?

2. Detailschablone frage.htm für die Anzeige der Fragen und Antworten

Zur Anzeige der Umfrage des WebVote-Programmes wird die Detailschablonen frage.htm benötigt. Bei dieser handelt es sich im Wesentlichen um eine übliche HTML-Seite, die Sie mit jedem Ihnen vertrauten HTML-Werkzeug überarbeiten oder neu erstellen können. Zur Formatierung der Fragen und Auswahlantworten empfehle ich die Arbeit mit einer (blinden) Tabelle.

Die Seite frage.htm beinhaltet außer Ihren individuellen/persönlichen Gestaltungselementen Platzhalter für die Frage und für die Auswahlantworten. Die Auswahlmöglichkeiten über Radiobuttons sind in ein Formular integriert.

In den HTML-Code für frage.htm bauen Sie demnach an passenden Stellen folgende Phrasen eingeschlossen in geschweifte Klammern { } als Platzhalter ein:


 {Frage}
sowie für jede vorgesehene Auswahlantwort hinter dem Radiobutton einen Platzhalter der Form:

 {Antwort1}
 {Antwort2}
 {Antwort3}
  :

Diese Antwortplatzhalter {Antwort1}, {Antwort2}, {Antwort3}... müssen natürlich optisch den Radioschaltern zugeordnet sein, welche allesamt den Namen Antwort und als Wert eine fortlaufende Nummer 1, 2, 3... erhalten.


 <input type="radio" name="Antwort" value="1"> {Antwort1}
 <input type="radio" name="Antwort" value="2"> {Antwort2}
  :

Die Aktion für das Formular ist zu belassen auf:


 <form action="webvote.php" method="POST">

Den Formular-Schaltknopf zum Absenden der Antwort können Sie völlig beliebig gestalten. Es kann auch ein grafischer Schalter vom Typ Image sein. Allerdings muß er mit dem Namen Abstimmen benannt werden.

3. Detailschablone ergebnis.htm für die Auswertung

Nach Beantwortung der Fragen sieht der Benutzer die Bewertung. Unter dem Dateinamen ergebnis.htm existiert dafür eine HTML-Seite mit dem entsprechenden Layout. Auch diese Schablone muß einige Platzhalter in geschweiften Klammern { } enthalten

Wiederum ist der Platzhalter {Frage} vorzusehen.

Zusätzlich wird an der Stelle des Platzhalters {Total} die Gesamtanzahl der bisherigen Abstimmvorgänge angezeigt.

Für die einzelnen Antwortbewertungen sind Platzhalter der Form {Antwort1}, {Zahl1}, {Prozent1}, {Balken1} sowie {Antwort2}, {Zahl2}, {Prozent2}, {Balken2} usw. in die Seite einzubauen. Bei {Antwort1} wird die erste Auswahlantwort eingefügt. Bei {Zahl1} erscheint die Zahl der Abstimmungen zur ersten Antwort. {Prozent1} gibt den Prozentsatz der Wertung zur ersten Antwort wider. {Balken1} bestimmt die Größe des Anzeigebalkens für das Abstimmergebnis 1. Dazu ist der Platzhalter {Balken1} jeweils in das Breitenattribut (oder Höhenattribut) des Grafik-Tags einzubauen:


 <img src="bar.png" alt="Balken" border="0" height="16" width="{Balken1}">
 <img src="bar.png" alt="Balken" border="0" height="16" width="{Balken2}">

4. Anpassung des PHP-Scriptes webvote.php

Unter typischen Umständen ist eine Veränderung des PHP-Scriptes nicht notwendig. Es gibt in den Zeilen 1...3 der Scriptdatei webvote.php allerdings folgende Parameter zur individuellen Anpassung.


 $BalkenMaximum=250;
 $FrageDatei='frage.txt';
 $ErgebnisListe='ergebnis.txt';

Damit können Sie den Namen Ihrer Fragendatenbasis sowie den Namen der Resultateliste ändern, sofern Sie etwa mehrere Instanzen des Programmes WebVote in ein und dem selben Ordner betreiben wollen. Mittels des ersten Parameters $BalkenMaximum bestimmen Sie, wieviel Pixel der größte Balken im Maximum breit werden darf.

Achten Sie bitte bei allen Parameterzeilen auf das Semikolon am Zeilenende und auf die Hochkommas vor und nach dem Wert.

5. Installation des Programmes WebVote

Transferieren Sie die WebVote-Dateien nach individueller Anpassung in Ihr Web, sinnvollerweise in ein eigenes Verzeichnis. In das Verzeichnis des Programmes sind mindestens die Programmdatei webvote.php, die Schablonen frage.htm und ergebnis.htm, die Datenbank frage.txt, die leere Ergebnisliste ergebnis.txt sowie die Grafik bar.png zu speichern. Für mein Musterlayout ist ausserdem die Grafik logo.gif notwendig.

Die noch leere Ergebnisliste ergebnis.txt benötigt Schreibrechte auf dem Webserver, damit PHP die Abstimmungsergebnisse eintragen kann. Sofern das auf Ihrem Server gesondert eingerichtet werden muss, ist die Einstellung "rw-rw-rw-" (cmod 666) unter Unix/Linux meist geeignet.

6. Aufruf des Programmes WebVote und Einbettung in Ihr Web

Der Standardeinstieg in das Programm WebVote ist der Aufruf von webvote.php. Diesen Aufruf von webvote.php sollten Sie Ihren Besuchern als Hyperlink anbieten. Der Aufruf einer Schablonen frage.htm oder ergebnis.htm hingegen ist sinnlos.

Das Programm WebVote selbst verwendet keine Frame-Befehle. Es kann aber in andere Webseiten eingebunden werden und dort innerhalb von Frames laufen.

7. Rechtliches

WebVote ist Freeware. Sie dürfen das Programm uneingeschränkt installieren und benutzen sowie im Originalzustand kopieren und verteilen, nicht aber kommerziell vermarkten.

Veränderungen an der Programmdatei webvote.php sowie das Entfernen des dortigen Copyright-Vermerkes sind gemäß dem Charakter als Freeware nicht zulässig. Ebensowenig der Einbau in andere Programme. Ausdrücklich erlaubt hingegen ist die inhaltliche und optische Anpassung des Programmes über die Datenbasis und die HTML-Schablonen.

Es wird KEINERLEI  Haftung für die Folgen der Verwendung oder Nichtverwendung dieser Software übernommen!


Werbung: Bitte beachten Sie gegebenenfalls mein mit WebVote verwandtes Programm Multiple-Choice für Umfragen, Gewinnspiele, Wissenstests etc.


© 2004-2005 Jürgen Hummel