$Id: readme.txt,v 1.12 2009-03-17 11:13:44 fraynaud Exp $
=========================================
Toute la documentation d'openMairie sur: 
[All the documentation of openMairie on:]
http://www.openmairie.org
=========================================


Pre requis :
============
Vous devez avoir installer:
- un serveur apache et php
- une base de donnees : mysql ou postgresql

En fait, reportez vous aux installations de :
- sous windows : wamp (http://www.wampserver.com/) ou easyphp(http://easyphp.fr/)
- sous linux : lamp

Dans le cas de postgresql, vous devez aussi installer postgresql
(http://www.postgresqlfr.org/)

Si vous debutez, il est plus simple de garder mysql qui est packagee avec
easyphp ou wamp.

Depuis la version 1.08, il est possible de faire une installation simplifiee(1)

Cette installation est interressante :
- si vous voulez faire un essai rapide
- si vous n avez pas d autres applications openMairie
- si vous souhaitez mettre en place openCimetiere chez votre fournisseur d acces
   (attention il faut avoir un acces e une base de donnees mysql ou pgsql)

L installation traditionnelle avec les dependances reste possible (2), elle est e
preferer si vous avez la maetrise de votre serveur.

Lien sur les documentations (6)



1- Installation simplifiee [par defaut]
   ====================================

1.1 - Installation de openmairie_resultat
   copier le repertoire openmairie_resultat sur votre serveur
   exemples
        wamp/www/openmairie_resultat
        sous linux (debian) : var/www/openmairie_resultat

1.2 - Initialisation de la base en MySQL ou postgresql
    creer la base openresultat sur mysql ou pgsql
    Ensuite, il faut creer les tables de la base de donnees
    puis executer les scripts SQL suivants :
    - en mysql :
    openmairie_resultat/data/mysql/init.sql
    - en pgsql
    openmairie_resultat/data/pgsql/init.sql

la premiere initialisation se fait avec init.sql
les modifications de version se font avec ver numero-de-version
exemple: pour passer a la version 1.07 : ver1.07.sql

1.3 parametrer la connexion dans /dyn/base.php
parametrage par defaut :

* collectivite 1 (sur mysql) : coll[1] est un tableau php qui contient les parametres
de connexion suivants
    'titre => 'openresultat (mysql)',[parametrage openresultat]
    'phptype'  => 'mysql', [ne pas changer parametrage dbpear]
    'dbsyntax' => '',[ne pas changer parametrage dbpear]
    'username' => 'root', [par defaut sur wamp easyphp ou lamp /
                           a voir avec le fournisseur d acces le cas echeant]
    'password' => '' [par defaut sur wamp easyphp ou lamp /
                        a voir avec le fournisseur d acces le cas echeant]
    'protocol' => '',
    'hostspec' => 'localhost', [nom de serveur par defaut wamp ou easyphp]
    'port'     => '',  [ne pas changer parametrage dbpear]
    'socket'   => '',  [ne pas changer parametrage dbpear]
    nom de la base => 'openresultat', [parametrage openresultat]
    format date par defaut =>'AAAA-MM-JJ' [[parametrage openresultat ne pas changer]

* collectivite 2 (sur mysql) : coll[1] est un tableau php qui contient les parametres
de connexion suivants
    'titre => 'openresultat (pgsql)',[parametrage openresultat]
    'phptype'  => 'pgsql', [ne pas changer parametrage dbpear]
    'dbsyntax' => 'pgsql',[ne pas changer parametrage dbpear]
    'username' => 'postgres', [par defaut install postgres /
                           a voir avec le fournisseur d acces le cas echeant]
    'password' => 'postgres' [par defaut install postgres/
                        a voir avec le fournisseur d acces le cas echeant]
    'protocol' => 'tcp',
    'hostspec' => 'localhost', [nom de serveur par defaut wamp ou easyphp]
    'port'     => '5432',  [ne pas changer parametrage dbpear]
    'socket'   => '',  [ne pas changer parametrage dbpear]
    nom de la base => 'openresultat', [parametrage openresultat]
    format date par defaut =>'AAAA-MM-JJ' [[parametrage openresultat ne pas changer]




ATTENTION :
Ne pas oublier de faire une sauvegarde du repertoire /aff /web ou sont stockees toutes
les donnees et resultats pour l affichage animation, web et bornes

Sous linux mettre les droits d ecriture (voir 2.5))


2. Installation d'openresultat avec les dependances
   =================================================

Cette installation est plus complexe e mettre en oeuvre par contre elle est plus
coherente par rapport a un serveur apache si plusieurs applications utilisent
les memes composants.

Vous pouvez vous reporter sur le document plus complet de l adullact e l adresse suivante
http://openmairie.org/demonstration/openresultat-1/installation_openresultat.pdf/view

2.1 -  installer les 4 librairies (obligatoires)
exemple avec wamp ou linux (ubuntu ou debian)
  pear : wamp/php/pear usr/share/php/PEAR
           PEAR Base System PHP : http://pear.php.net/package/PEAR
           pear db  :  http://www.pear.php.net/package/DB
  fpdf  : wamp/php/fpdf   usr/share/fpdf 
           http://www.fpdf.org
  openmairie : wamp/php/openmairie ou usr/share/php/openmairie 
    http://www.openmairie.org 
    version >= 2.01
  artichow : wamp/php/artichow
    http://www.artichow.org (telecharger version 1.1.0 pour php 4 et 5) 
    ATTENTION MODIFICATIONS A EFFECTUER Voir /php/artichow/readme.txt


2.2 - modifier le chemin dans php.ini

* exemple sous windows avec wamp5
   include_path= ".;c:\wamp\php\includes;c:\wamp\php\pear;c:\wamp\php\fpdf;c:\wamp\php\openmairie;c:\wamp\php\artichow"
* exemple avec linux (version debian ou ubuntu : etc/php5/apache2/php.ini):
include_path = ".:/usr/share/php:/usr/share/php/openmairie:/usr/share/fpdf:/usr/share/artichow"

2.3 - Installation de openmairie_resultat
* copier le repertoire openmairie_resultat sur votre serveur
   exemples
        wamp/www/openmairie_resultat
        sous linux (debian) : var/www/openmairie_resultat


2.4 - Initialisation de la base en MySQL
    creer la base openresultat
    puis executer les scripts SQL suivants :
    * avec mysql
    openmairie_resultat/data/mysql/init.sql = creation des tables (obligatoire)
    * ou avec postgre
    openmairie_resultat/data/pgsql/init.sql = creation des tables (obligatoire)
    parametrer la connexion dans /dyn/base.php

    * dans dyn/var.inc mettre les variables suivante e vide
    $path_fpdf, $path_om, $path_pear


    la premiere initialisation se fait avec init.sql
    les modifications de version se font avec ver numero-de-version
    exemple: pour passer a la version 1.08 : ver1.08.sql    

ATTENTION :
Ne pas oublier de faire une sauvegarde du repertoire /aff /web ou sont stockees toutes
les donnees et resultats pour l affichage animation, web et bornes




2.5- Sous linux : mettre les droits d ecriture pour apache (www-data)
            
Sous linux : mettre les droits d ecriture pour apache (www-data) sur les repertoires
            /var/www/openmairie_resultat$ sudo chown www-data:www-data aff
            /var/www/openmairie_resultat$ sudo chmod 755 aff
            /var/www/openmairie_resultat$ sudo chown www-data:www-data trs
            /var/www/openmairie_resultat$ sudo chmod 755 trs
            /var/www/openmairie_resultat$ sudo chown www-data:www-data web
            /var/www/openmairie_resultat$ sudo chmod 755 web
            /var/www/openmairie_resultat$ sudo chown www-data:www-data trs
            /var/www/openmairie_resultat$ sudo chmod 755 trs   
            /var/www/openmairie_resultat$ sudo chown www-data:www-data pdf
            /var/www/openmairie_resultat$ sudo chmod 755 pdf
            
            (distribution debian ou ubuntu)



    ACCES ************************************
    utilisateur : admin
    motdepasse  : admin
    ------------------------------------------

***********************************************************************
ATTENTION : pour les villes ayant plus de 33 bureaux de votes
Il faut rajouter des bureaux dans  la table participation (b34,b35 ...)
La table candidat est limitee à 30 candidats
***********************************************************************