xwolf.de|com

Menü

Inhalt dieser Site

Ansicht

Individuelle Benutzerkonfiguration für die Site.

Druckansicht Startseite Suchen

A A A A

XPoll - Umfragen für die Webseite

Dieses Skript realisiert eine automatische Umfrage, wie Sie sie hier auf den Seiten im rechten Teil der Seite sehen können. Die Umfrage läft, inkl. Auswertung fast vollständig automatisch nachdem man nur die Fragebögen vordefiniert hat.

Source Code

Perl Sourcecode
xpoll.pl V1.13 Das Skript xpoll.pl
web.pm Das Perlmodul web
Konfigurations- und Styledateien
xpoll.conf Die Konfigurationsdatei
poll.dat Beispiel Frageliste
allpolls.html Beispiel Layoutdatei für alle Umfrage-Ergebnisse
allresult-single.html Beispiel Layoutdatei für ein einzelnes Ergebnis
question.html Beispiel Layoutdatei für eine Umfrage
result.html Beispiel Layout für die Ergebnisse der aktuellen Umfrage
nopoll.html Beispiel Layout für den Fall, dass zu einer Zeit keine Umfrage statt findet.
Download als Archiv-Datei
xpoll.tgz Getartes und gezipptes Archiv aller obigen Dateien. (Zu Entpacken unter Unix/Linux mit tar -xzf xpoll.tgz)
Achtung: Sollte beim obigen Download-Link fehlerhafterweise als Dateiname "xload.cgi" angegeben sein, ignorieren Sie dies und benennen den Dateinamen um. Einige Browser ignorieren leider den Standard zur Übermittlung von Dateinamen...

Wirkungsweise

Aktuelle Umfrage


Derzeit findet keine Umfrage statt.


Aufruf und Einbau

Zum Aufruf der Umfrage sollten Sie diese in Ihr (s)HTML-Dokument mit Hilfe eines Server Side Include-Aufrufes einbinden. Dies funktioniert nur, wenn es Ihrem Webserver erlaubt ist, diese auszuführen. Fragen Sie im Zweifelsfalle Ihren Provider oder Webmaster.
Binden Sie in Ihrem Dokument folgenden HTML/SSI-Code an der Stelle ein, wo Sie den Counter aufrufen wollen:

<!--#exec cgi="/cgi-bin/xpoll.pl" -->
Bzw.:
<!--#include virtual="/cgi-bin/xpoll.pl" -->

Beachten Sie dabei, daß das Verzeichnis cgi-bin Ihr CGI-Verzeichnis ist, in dem Sie vorher das Skript kopiert haben. Sollte Ihr Verzeichnis einen anderen Namen haben, geben Sie diesen entsprechend an.

Abruf aller Ergebnisse

Die Ergebnisse-Ausgabe aller Umfragen kann sowohl über SSI-Aufruf, als auch über den direkten Aufruf des CGI-Skriptes, zusammen mit dem Paramter viewpolls, abgerufen werden.
Der Aufruf mittels URL schaut dann so aus:

http://www.example.org/cgi-bin/xpoll.pl?viewpolls=1

Möchten Sie stattdessen die Ausgabe als SSI einbinden, bauen Sie den folgenden SSI-Aufruf in Ihre Webseite ein:

<!--#include virtual="/cgi-bin/xpoll.pl?viewpolls=1" -->

Achten Sie hierbei darauf, daß der Server diesen Aufruf auch erlauben bzw. unterstützen muß.

Installation

Kopieren Sie die Datei xpoll.pl in Ihr CGI-BIN-Verzeichnis. Setzen Sie die Ausführungsrechte mittels CHMOD. Z.B.: chmod 755 xpoll.pl.
Ändern Sie im Programm folgende Zeilen:

Zeile 1: #!/local/bin/perl5
Geben Sie hier Ihren eigenen Pfad zu Perl ein, falls er von diesem abweicht.

Weiterhin müssen Sie Ihre Konfigurationsdatei xpoll.conf anpassen. Eine Beschreibung zu den einzelnen Parametern und Einstellungen wurde in der Datei angegeben. Wenn Sie sich an die dort angegebenen Regeln halten, sollten Sie keine Probleme mit der Installation haben.

Definition und Installation von Umfragen

In der beigefügten Datei poll.dat finden Sie die Definitionen von einigen Umfragen, wie Sie auf diesem Server durchgeführt wurden. Die Syntax der Datei ist an XML angelehnt, so daß man diese mit einem gebrächlichen HTML- bzw. XML-Editor bearbeiten kann.
Eine Umfrage hat immer folgendes Format:

<Poll id="abc1">
Beginn einer einzelnen Umfragedefinition
Eine Identifikationsnummer. Diese sollte für die Einträge in der Datei einmalig sein.
<time name="start" value="7.4.2000">
Wann beginnt diese Umfrage?
<time name="ende" value="11.4.2000">
Wann endet die Umfrage?
<question>
Hier steht meine Frage...
</question>
Die Fragestellung
<answer id="1">Antwort 1</answer>
<answer id="2">Antwort 2</answer>
<answer id="3">Antwort 3</answer>
Zwei oder mehr Antworten.
</Poll>
Ende einer einzelnen Umfragedefinition. Weitere können folgen, wobei diese aber dann eine andere ID haben sollten und keine überlappenden Termine.

Info

$Id: xpoll.shtml,v 1.3 2003/05/22 13:48:00 xwolf Exp $, Linkcount: 1
© 1996 - 2003 by xwolf