1. Lizenzbedingungen
2. Vorraussetzungen
3. Installation / Setup
4. Einbinden auf der Homepage
5. Anpassung ans eigene Design
6. Administration
7. Support
8. Versionshistorie

• Powie's Software ist für private Anwender mit nichtkommerzieller Nutzung Freeware. 

• Für Firmen / kommerzielle Nutzung ist der Einsatz nur nach vorheriger Rücksprache mit mir zulässig. Ich behalte mir vor je nach Einsatzzweck eine Lizenzgebühr zu erheben. Bei Rückfragen: lizenz@pscript.de .

• Auf die Software übernehme ich keinerlei Haftung / Gewährleistung.

• Ich verbiete ausdrücklich Änderungen an den zur Verfügung gestellten Programmen , sofern diese nicht zur Anpassung des Design notwendig sind (PHP Scripte).

• Die zur Verfügung gestellte Software / Scripte sind geistiges Eigentum des Autor's. Ich verbiete jegliche Entfernung/Veränderung des Copyright Vermerks an den Scripten. Im Falle eines Verstoßes gegen geltende Urheberrechte behalte ich mir weitere Schritte vor.

• Ich verbiete jegliche Weiterverbreitung von geänderten Versionen meiner Scripte , über welche Wege auch immer !

• Mit dem Download der Software/Scripte erkennen Sie diese Lizenzbedingungen ausnahmslos an !

Um das Script betreiben zu können sind folgende Mindestanforderungen zu erfüllen:

• Webserver : Apache mit Unterstützung von PHP4
• PHP: ab Version 4.1.x
• mySQL: ab Version 3.21.33
• genügend freier Speicherplatz auf dem Webserver als auch in der Datenbank !

Leider ist es momentan nicht möglich das Script auf einen IIS einzusetzen, da dieser einen Fehler bei der gleichzeitigen Verarbeitung von Cookies und Header Informationen hat.

Erstellen sie auf ihren Webserver ein beliebiges Verzeichnis in den sie das Poll Script betreiben wollen.
Entpacken sie alle Dateien aus der .zip Datei und übertragen diese mit ihrem FTP Programm in dieses Verzeichnis auf den Webserver. Stellen Sie sicher das die Bilder (.gif) im Binärmodus übertragen werden. Bei Webservern auf Linux Basis achten sie auf die korrekte GROSS/kleinschreibung der Files.

In der Datei config.inc.php finden sie alle relevanten Parameter um das Script an ihre mySQL Datenbank anzubinden und einzustellen. Beachten sie das alle Werte in "" eingeschlossen sind und am Ende der der Zeile ein Semikolon steht: ;

$notifyemail ermöglich es bei Einsatz von Usern als "Writer" eine Email auszulösen wenn eine Poll gepostet wird der freigeschalten werden muss. Hier können auch mehrere Adressen durch Komma getrennt angegeben werden ! Diese Notification kann auch an ICQ gesendet werden wenn man als Adresse "ICQ#@pager.icq.com" angibt ! Möchten sie keine Notification bekommen stellen sie $notify="", ein !

Windows / IIS : Da der Internet Information Server einen Bug hat welcher verhindert das man nicht gleichzeitig einen Header senden kann und ein Cookie speichern, gibt es am Ende der Datei "vote.php"  zwei unterschiedliche Abschnitte. Abschnitt 1 für Apache , Abschnitt 2 für IIS. Standardmäßig ist der Abschnitt für Apache aktiv. Der Bereich zwischen /* und */ ist auskommentiert und wird nicht genutzt. Wenn sie als Server einen IIS benutzen kommentieren sie den Apache Abschnitt aus und entfernen die /* und */ Zeichen aus dem Windows IIS Abschnitt.

Um einen Poll auf der Homepage einzubinden gibt es das File poll.php. Dieses File arbeitet selbsttändig, und bindet immer den neusten offenen Poll ein. Hat ein User noch nicht gevoted wird die Auswahl zum Voten angezeigt. Sobald der User gevotet hat zeigt dieses Script die Ergebnisse an. In der Datei poll.php ist mit Angabe des Serverpfades auf die config.inc.php zu verweisen, damit auf die Datenbank zugegriffen werden kann.

Das File kann in eine PHP Page mittels require oder include eingebunden werden: require("/pfad/zu/poll.php");
Immer den vollen Server-Pfad verwenden ! Ein Include in der Art include("http://...."); funktioniert zwar, aber erlaubt keine Speicherung/Auslesen von Cookie's. Somit werden keine Ergebnisse angezeigt !

Ebenfalls ist es möglich das File in eine SHTML Datei zu includen oder in einen IFRAME zu setzen.

Für einen richtigen HTML Kopf mit den üblichen Angaben im <body> für Hintergrundfarben, Hintergrundbild etc. steht ihnen die Datei kopf.php zur Verfügung. Diese Datei enthält übliches HTML und ist hauptverantwortlich für das Design. Sie befindet sich immer am Anfang ihrer Gästebuchseiten.

Dort können sie einen Link zu einer CSS Datei setzen 
Beispiel: <link rel="stylesheet" type="text/css" href="/pfad/zur/default.css">

In dieser CSS Datei lassen sich neben den üblichen Werten folgende Sonderklassen definieren:

th.head / td.head - Kopfzeilen
td.info - Infofelder
td.left - Linke Spalten
td.right - Rechte Spalten
td.header - Kopf und Fusszeilen
td.odd - Zebramuster Zellenfarbe 1
td.even - Zebramuster Zellenfarbe 2

Adminuser haben die Möglichkeit Benutzer anzulegen die dann als Moderator alle Polls betreuen können oder als Autor eigene posten können und nur diese eigenen bearbeiten / löschen dürfen. 
User mit Level "Writer" haben die Möglichkeit Polls zu posten, diese werden aber nicht sofort in den öffentlichen Polls angezeigt. Diese Plolls können von einen Admin oder Moderator freigegeben werden. Erst dann erscheinen sie öffentlich. Alle nicht freigegebenen Polls werden im Adminbereich solange mit NEW gekennzeichnet bis sie freigegeben sind.
User mit Status gesperrt haben keinen Zugang mehr zu den Posting Funktionen.

Administratoren und Moderatoren haben ebenso die Möglichkeit Polls zu sperren und zu entsperren. Diese Polls werden dann öffentlich nicht angezeigt.

Support für das Script erhalten sie nur im Forum auf http://www.powie.de . Bitte stellen sie keine Anfragen via Email, da ich bei der Menge an Anfragen nicht garantieren kann diese schnell zu beantworten.

So hat sich Powie's PHP Poll über die Zeit hinweg entwickelt: