Lisez moi

Pre requis :
============
Vous devez avoir installer:
- un serveur apache et php
- une base de données : 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 packagée avec
easyphp ou wamp.

Depuis la version 1.11, il est possible de faire une installation simplifiée(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 à une base de données mysql ou pgsql)

L installation traditionnelle avec les dependances reste possible (2), elle est à
préferer si vous avez la maîtrise de votre serveur.

Avec la version 1.11, il y a de nombreux scripts d integration de données si
vous etes en phase de saisie de données en masse(3)
Vous pouvez parametrer votre recherche globale (4)
Comment sont stocker vos photos et vos documents ?(5)
Enfin, quelques liens sur des documentations fonctionnelles openCimetiere (6)

Lien sur les documentations (6)



1- Installation simplifiée [par defaut]
====================================

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

1.2 - Initialisation de la base en MySQL ou postgresql
creer la base opencimetiere sur mysql ou pgsql
Ensuite, il faut creer les tables de la base de données
puis executer les scripts SQL suivants :
- en mysql :
openmairie_cimetiere/data/mysql/init.sql
- en pgsql
openmairie_cimetiere/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.08 : ver1.08.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 => 'opencimetiere (mysql)',[parametrage opencimetiere]
'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 => 'opencimetiere', [parametrage opencimetiere]
format date par defaut =>'AAAA-MM-JJ' [[parametrage opencimetiere ne pas changer]

* collectivite 2 (sur mysql) : coll[1] est un tableau php qui contient les parametres
de connexion suivants
'titre => 'opencimetiere (pgsql)',[parametrage opencimetiere]
'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 => 'opencimetiere', [parametrage opencimetiere]
format date par defaut =>'AAAA-MM-JJ' [[parametrage opencimetiere ne pas changer]




ATTENTION :
Ne pas oublier de faire une sauvegarde du repertoire /trs ou sont stockées toutes
les donnees numerisees (photos, arretes, autorisation ...)

Sous linux mettre les droits d ecriture (voir 2.5)
Mise en place du logo (voir 2.6)



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

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

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

2.1 - installer les 3 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

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"
* exemple avec linux (version debian ou ubuntu : etc/php5/apache2/php.ini):
include_path = ".:/usr/share/php:/usr/share/php/openmairie:/usr/share/fpdf"

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


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

* dans dyn/var.inc mettre les variables suivante à 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






2.5- Sous linux : mettre les droits d ecriture pour apache (www-data)

* Repertoire trs : transfert de fichier
/var/www/openmairie_cimetiere$ sudo chown www-data:www-data trs
/var/www/openmairie_cimetiere$ sudo chmod 755 trs
* Repertoire tmp : ecriture des resultats de traitement
/var/www/openmairie_cimetiere$ sudo chown www-data:www-data tmp
* Repertoire sql/mysql/ ecriture modification des etats et sous etats
/var/www/openmairie_cimetiere$ sudo chown www-data:www-data mysql
/var/www/openmairie_cimetiere$ sudo chown www-data:www-data mysql
* Repertoire sql/pgsql/ ecriture modification des etats et sous etats
/var/www/openmairie_cimetiere$ sudo chown www-data:www-data pgsql
/var/www/openmairie_cimetiere$ sudo chown www-data:www-data pgsql

(distribution debian ou ubuntu)



2.6 logo par collectivité (version 1.10)

Lettre type et état :
Pour chaque collectivite mettre le logo dans le trs/coll correspondant
(coll= numero de la collectivité)
Attention le logo doit porte le meme nom qu en trs : ex : logopdf.png
trs/1 logopdf.png
trs/2 logopdf.png ...


3 - Integration de données (version 1.11)
======================

Dans var.inc possibilité ou non de faire apparaitre l integration dans le menu
dyn/var.inc -> variable $integration_temp

voir rec/methode_integration.pdf pour explication de la méthode

4 - recherche globale (version 1.11)
=================
Le recherche globale est parametrable dans dyn/var.inc pour optimiser les
temps de reponse long au demarrage de l appli
// 1 = calcul toutes occurences puis recherche possible sur saisie
// 0 = uniquement calcul sur saisie recherche
$global_flag=1; (par defaut)
Si vous avez de nombreuses concessions (plus de 5000) mettre à 0.

5 - stockage des photos, documents PDF (actes de concession, fichemanuelle ...)
==================================
Il est proposer une option pour classer les dossiers et photos par repertoire
d une centaine de concession pour que ce soit plus facile à gérer qu un stock
de milliers de photos et dossiers dans un même repertoire.
Cette option deconnecte la possibilité de modifier le fichier (eviter la complexité)
Le stockage de dossier par repertoire d une centaine de concession est un parametre
dans var.inc: $dossierparcentaine=1;
Par defaut le parametre est à 1.
Si vous avez moins de 300 concessions, vous pouvez mettre le parametre à 0
(cela fera moins de 1000 documents dans un repertoire)

Les documents sont identifiés de la maniere suivante dans le respertoire trs:
si le collectivite =1 et si $dossierparcentaine=1
Pour la concession numero 1512 :
la photo est stockée en : trs/1/15/p_1512.jpeg
le 1er dossier : trs/1/15/d_1512.pdf
le 2eme dossier : trs/1/15/d_1512_2.pdf


ATTENTION :
Ne pas oublier de faire une sauvegarde du repertoire /trs ou sont stockées toutes
les donnees numerisees (photos, arretes, autorisation ...)

6 Documentation fonctionnelle
===========================
Documentation de l association des maires 74
http://openmairie.org/demonstration/opencimetiere-1/documentation_1-05.pdf/view

Documentation proposée par la ville de Toulouse
http://openmairie.org/demonstration/opencimetiere-1/manuelutilisateuropencimetiere4sept2007.pdf/view



7 conseil aux developpeurs
========================

Avant de vous lancer dans le code pour modifier l application :
- vous pouvez modifier de nombreux parametres dans dyn/var.inc
- vous pouvez modifier tous les états, sous-etats, lettre type depuis le menu

Si malgre ces possibilités de paramétrage, vous souhaitez modifier le code, il a
été laissé obj/concession_toulouse.class.php comme exemple de possibilité de
modification de code en surchargeant les méthodes existantes:
concession_toulouse.class.php herite de concession.class.php et surcharge les
methodes de concession.class.php
En fait, vous limitez votre maintenance que sur la partie rajoutée.
Modifiez ensuite le menu : tab.php?obj=concession_toulouse au lieu de concession