
/********************************************************
* Umfragenmodul
*
* Author      :     Alexander Hhn
* Copyright   :     art & weise medienproduktion
                    info@auw-media.de
* Created     :     16-09-2002
* Modified    :     04-07-2003
* Modified again & again until:   May. 12th 2004 by Lars D. Forseth <lars@forseth.de>
*********************************************************/




####################################################################################################################
##                                 INSTALLATIONSANWEISUNGEN & HINWEISE:                                           ##
####################################################################################################################


1.) PHP-Code aus "umfragenmodul-cookie-code.txt" im verwendeten Layout VOR den <html>-Tag
    UND DIREKT AN DEN ANFANG des Textfeldes reinkopieren.
    Es drfen also vor diesem Code keine Leerzeichen oder Leerzeilen sein,
    sonst knnen die Cookies nicht gesetzt werden und eine Teilnahme an der Umfrage wird stets verweigert!


####################################################################################################################


2.) Mit dem den beiden SQL-Befehlen in der Datei "umfragenmodul-sql.txt" die Tabellen fr die Umfragen und
    fr das Log der Umfragen anlegen.


####################################################################################################################


3.) Ein neues Modul im Modulbereich erstellen und skom_voring.xml importieren.

####################################################################################################################


4.) Um dem Button, Balken und den Tabellen der Umfrage noch einen kleinen Schliff zu verpassen,
    einfach die Zeilen aus der Datei "umfragenmodul-styles.txt" noch an das Ende der Datei "format.css"
    im Ordner "../cms/css/" anhngen und bei Bedarf entsprechend abndern, oder noch einfacher an ein includiertes CSS-File
    des Bereiches "Styleeditor" anhngen.


####################################################################################################################


5.) Nun noch das Umfragenmodul in einem Template einbinden und unter "Vorkonfiguration"
    eine neue Umfrage mit den mglichen Antworten (max. 6) in die Felder eingeben.
    Mit "Speichern" wird die Umfrage dann in der Umfragen-Tabelle gespeichert
    (wenn die Umfrage bereits besteht, wird sie ohne Aufforderung berschrieben!).
    Die Umfrage ist durch das Speichern aber noch nicht aktiv, sondern erst,
    wenn man sie in dem Drop-Down-Men auswhlt und dann auf "Aktivieren" klickt
    (dadurch wird der Wert von der Spalte "poll_active",
     in der Umfragen-Tabelle, aber nur bei dieser Umfrage, auf "1" gesetzt).
    Man kann auch die Zhler der aktiven Umfrage zurcksetzen, in dem man vor dem Speichern einfach
    die Option "Alle Zhler auf 0 setzen" aktiviert und auf "Speichern" klickt.
    
    Zur Sicherheit und Orientierung sind folgende Vorkehrungen
    unter der Konfiguration des Templates eingebaut:
     - Die Frage der aktiven Umfrage wird im 2. gelben Kasten ausgegeben.
     - Die Frage und die Antworten der aktiven Umfrage werden in die Textfelder automatisch eingetragen.
     - Die aktive Umfrage wird automatisch im Drop-Down-Men ausgewhlt.
     - Ganz unten wird die Statistik der aktiven Umfrage angezeigt, so dass man sich z.B.
       vor dem Zurcksetzen der Zhler einer Umfrage die Werte noch notieren kann.


####################################################################################################################


6.) H i n w e i s e :

    - Die Variablen "$poll_action" und "$given_answer" werden nur als POST-Variable akzeptiert.
      "$poll_stats" nur ber GET.
    - Wenn man in den Dateien "umfragenmodul-input.txt" und/oder "umfragenmodul-output.txt"
      die Zeile "$debugging = "no";" durch "$debugging = "yes";" ersetzt, bekommt man
      die Inhalte der wichtigsten Variablen mit ausgegeben. Dies ist nur ntzlich, wenn man
      das Modul weiterentwickeln oder einen Bug beheben mchte!
    - Beim ersten Aufruf der Seite, auch wenn man das cookie akzeptiert, wird erst einmal
      direkt die Statistik angezeigt. Erst beim zweiten Aufruf der Seite wird dann das Formular
      der Umfrage angezeigt, wenn das cookie akzeptiert wurde. Wird das cookie abgelehnt wird
      permanent nur die Statistik angezeigt.
    - Mit "$block_seconds = 0;", etc. wird festgelegt, dass erst nach Ablauf der Blockzeit,
      (diese Errechnet sich durch Block -sekunden, -minuten, -stunden, -tage, -monate),
      unter dieser IP wieder abgestimmt werden darf.
      Wenn jemand unter dieser IP dann in der Zwischenzeit dennoch versucht mitzustimmen,
      beginnt die Blockzeit wieder von vorne und ihm wird lediglich die Statistik angezeigt.
    - Der Link zur Statistik wird brigens mittlerweile nur noch in Zusammenhang mit dem Formular
      zum Abstimmen angezeigt.
    - NEIN, DIESES UND ALLE FOLGENDEN RELEASES SIND NICHT KOMPATIBEL MIT EINEM DER RELEASES VOR DIESEM.
      Das lsst sich leider nicht ndern, da sich einfach zu viel gendert hat.
      (Schon alleine weil sich die Tabellennamen und der Aufbau der Tabellen komplett gendert haben!).
      Also rate ich euch, jetzt nicht gleich drauf loszustrzen und dieses release gegen das alte, das
      ihr noch verwendet einzutauschen, und euch dann zu wundern, wieso ncihts geht oder ihr keinen
      Zugriff auf eure alten Umfragen habt, ES GEHT NICHT! Wartet am besten, bis ihr eh ne neue Umfrage
      machen wolltet und tauscht erst dann das alte release gegen dieses hier.
    - Was genau an nderungen immer stattfindet von einem release zum andern, hab ich im changelog
      (see: "umfragenmodul-changelog.txt") jeweils aufgelistet.
      Wenn ihr net so doll Englisch knnt, dann empfehle ich euch www.leo.org,
      ein sehr gutes Onlinewrterbuch, das es brigens mittlerweile auch in franzsisch gibt... ;)
    - Und bevor ich wieder im Forum berhuft werde mit Anfragen  la "Hilfe, nix geht!":
       * Lest euch SORGFLTIG und SCHRITT FR SCHRITT diese INSTALL, das CHANGELOG durch!
       * Schaut mal in eure error logs und zwar in alle!
         Also die von Contenido, aber auch die von eurem webserver und pasted evtl. errors,
         aus denen ihr nicht schlau werdet samt Version von Contenido,MySQL,PHP,Browser, etc.
         in eurer evtl. Anfrage.
       * Wenn ihr ne Anfrage stellt, weil es mit dem Modul net so klappt, dann schreibt auch dazu,
         wie ihr genau vorgegangen seid und lasst euch net alles aus der Nase ziehen, ihr wollt ja
         immerhin auch geholfen bekommen... ;)
    
    - Have fun!
      Fr Anregungen und Tips bitte an <lars@forseth.de> wenden
      oder im Contenido-Forum, am besten im entsprechenden thread,
      (see: www.contenido.de/forum/) melden.


####################################################################################################################

