+-------------------------------------------------------+
| tgcSimplePoll                                         |
|                                                       |
| small but powerful way to build a voting booth,       |
| easy to integrate into existing sites                 |
|                                                       |
| Version:      2.0.0                                   |
|                                                       |
| Author:       Carsten Lucke                           |
| Email:        luckec@tool-garage.de                   |
| Website:      http://www.tool-garage.de               |
+-------------------------------------------------------+

Copyright (c) 2002-2004 by Carsten Lucke <luckec@tool-garage.de>

This program and all associated files are released under the 
GNU Lesser Public License, see lgpl.txt for details! 




Einleitung:
===========

Diese kurze Einleitung zeigt Dir, wie Du das Skript installierst und schnellstmöglich starten kannst.


Installation:
-------------

(1) Erstelle eine Datenbank, in der die benötigten Tabellen installiert werden können.

(2) Passe in config/config.php die Daten für die Verbindung zur Datenbank an:

         define('SP_DB_DSN', 'mysql://tgc:tgc123@localhost/tgcSimplePoll');
     
    Das Muster ist in der Datei erklärt.

(3) Ebenfalls in der Datei config.php kannst Du ein Prefix angeben, dass bei der Installation allen Tabellen vorangestellt wird:
    
     define('SP_DB_TABLEPREFIX', '');
    
(4) Kopiere die Dateien auf Deinen Webserver.

(5) Rufe install.php im Browser auf, wenn alles geklappt hat, kannst Du Dich danach im Adminbereich einloggen.
    
        Password:               admin
        Username:               admin
        
    Ändere schnellstmöglich die Daten für den Admin-Login!
    
(6) Fertig installiert!

    
Benutzung:
----------

Es gibt zwei Arten der Poll-Benutzung. Einmal das Frontend für die Abstimmungen und den Adminbereich zur Verwaltung
von Umfragen. Die Dateien admin.php und index.php demonstrieren die Nutzung.


Erweiterte Möglichkeiten:
=========================

Sprachdateien:
--------------
Ab Version 2.0 ist es möglich, den Poll in einer beliebigen Sprache zu haben. 
Alles was es dazu braucht findest Du im data Verzeichnis. Wenn die gewünschte Sprachdatei noch nicht vorhanden ist,
dann kopiere die default.ini und benenne sie der neuen Sprache nbach entsprechend sinnvoll. Jetzt übersetze
alle Texte in dieser Datei und rufe den Poll beim Instanziieren mit den entsprechenden Settings auf (Name der Datei ohne .ini):

    $settings   = array(
        'language'      => 'dk'
    );
    $poll       = &new tgcSimplePoll('myPoll', $settings);
    $markup     = $poll->run();
    
Mehrere Polls auf einer Seite:
------------------------------
Ab sofort ist es auch möglich mehrere Umfragen auf einer Seite zu haben. Man muss dazu nur dementsprechend zwei Objekte erzeugen,
jeweils mit einer unterschiedlichen Id:

    $poll       = &new tgcSimplePoll('myPoll_1');
    $markup     = $poll->run();
    if (PEAR::isError($markup)) {
        echo 'Poll error: ' . $markup->getMessage();
    } else {
        echo $markup;
    }
    
    $poll       = &new tgcSimplePoll('myPoll_2');
    $markup2    = $poll->run();
    if (PEAR::isError($markup2)) {
        echo 'Poll error: ' . $markup2->getMessage();
    } else {
        echo $markup2;
    }
    
    
Bei weiteren Fragen schau bitte in die API-Dokumentation auf tool-garage.de.
    
Viel Spass bei den Umfragen!!!