﻿/**
 * Projet : gestassophp_sa [GestAssoPhp+Pg]
 * ---------------------------
 * Licence Creative Commons selon les termes du présent contrat appelé Contrat Public Creative Commons 
 * Auteur original : Jean-Claude Etiemble
 * @link :  http://creativecommons.org/licenses/by-sa/2.0/fr/  - Paternité - Partage à l'Identique 2.0 France (CC BY-SA 2.0)
 * ---------------------------
 *	
 * @author : JC Etiemble - http://jc.etiemble.free.fr
 * @version :  2024
 * @copyright 2007-2023  (c) JC Etiemble
 * @package   GestAssoPhp+Pg  - http://gestassophp.free.fr
 * @ ATTENTION GestAssoPhp+Pg utlise un dossier /lib avec
 * @ Smarty 3.x  GNU LESSER GENERAL PUBLIC LICENSE : https://github.com/smarty-php/smarty/blob/master/LICENSE
 * @ ADOdb Library for PHP  GNU LESSER GENERAL PUBLIC LICENSE https://github.com/ADOdb/ADOdb/blob/master/LICENSE.md#gnu-lesser-general-public-license
 */

 !! BIEN LIRE TOUT LE TEXTE AVANT DE LANCER L’INSTALLATION !!

Conditions requises pour installer et gérer
*******************************************
L'ensemble de ces connaissances et savoirs-faire 
------------------------------------------------
hébergement WEB (nom de domaine, gestion hébergement, ....) 
serveurs web (logs, URLs...) 
administration à distance (FTP, chmod, ...) 
bases de données (création, sauvegarde, restauration...)
Éventuellement
-------------
contenus web (xHTML, CSS, images, ...) 
Connaître PHP, Smarty et adodb

Pour information lire :
http://gestassophp.free.fr/cms/index.php/home/installation-du-systeme.html
Installation détaillée en images
http://gestassophp.free.fr/cms/index.php/home/questions-installation.html


Configuration nécessaire
************************
Vous devez au minimum disposer d'un espace sur un serveur Web avec : 
 - un accès FTP pour l'installation des fichiers, 
le support de PHP 7.4.x minimum ou supérieur avec le support des sessions,
 - compatible version PHP 7.4 et PHP 8.x avec le support des sessions, 
 - un accès à une base de données type MySQL version 5 minimum (utiliser l'extension mysqli).
ou
 - un accès à une base de données PostgreSQL version 12 ou plus.
Attention aux fichiers .htaccess fournis, il faudra vérifier la compatibilité avec votre hébergement.


Vous devez connaître les données de votre connexion MySQL ou PostgreSQL : 
- l'adresse du serveur MySQL ou PostgreSQL ->si vous êtes en local 'localhost'  
- votre login MySQL ou PostgreSQL,
- votre mot de passe MySQL ou PostgreSQL,
- le nom de la base de données crée ou a créer
- un préfixe est prévu lors de l'installation de la base de données (par défaut = gs_)
Si vous utilisez une base de données type MySQL, attention, il faut sélectionner en étape 2 Mysqli. 
Si vous utilisez postgresql sélectionner en étape 2 PostgreSQL.

NOTE : Depuis PHP 5.5, l'extension MySQL originale est obsolète, il faut donc vérifier dans le fichier connexion.cfg.php l’extension : define("TYPE_BD", "mysqli");
- Attention 'magic_quotes_gpc' Cette fonctionnalité est devenue OBSOLÈTE depuis PHP 5.3.0 et a été SUPPRIMÉE depuis PHP 5.4.0.
Vérifier sur votre serveur que les fonctionnalité 'magic_quotes_...' sont bien à OFF

NOTA installation en local sous WAMP ou EsayPhp ou ...
Vérifier ou modifier la configuration dans le php.ini
; Error handling and logging ;
; Production Value: E_ALL & ~E_DEPRECATED & ~E_STRICT
error_reporting = E_ALL & ~E_DEPRECATED & ~E_STRICT

[Date]
date.timezone = Europe/Paris

***Cette version ne fonctionne pas pour une installation sur les pagesperso de Free.fr en PHP 5.6.x***
Voir le lien http://gestassophp.free.fr/cms/index.php/home/questions-installation.html


A - INSTALLATION NOUVELLE
-------------------------
Voir aussi sur http://gestassophp.free.fr/cms/index.php/home/installation-du-systeme.html

1. Vous avez récupéré l'archive gestion_saxx.tar.bz2

2. Créer un dossier "gestion_sa" ou donner lui le nom que vous voulez 

3. Copier dans le dossier "gestion_sa" le contenu de l'archive
Vous devez avoir :
- un dossier /gestassophp_sa (les fichiers du système [GestAssoPhp+Pg]) (voir note 1 plus bas)
- un dossier /lib 
	- smarty (système de template (gabarit d'affichage HTML)
	- adodb (système de bibliothèque d'abstraction destinée à communiquer avec différents systèmes de gestion de base de données, ici Mysql ou PostgreSQL)
- un fichier fileloc_gestasso_sa.php (Définira le chemin initial)
- un fichier index.html avec lien vers gestassophp_sa/index.php (pour information à modifier ou supprimer)


NOTE :
-----
- Le nom du dossier "gestion_sa" peut être changé.

Note 1 - IMPORTANT
- Le nom du dossier "gestassophp_sa" peut être changé à condition de changer 
   - la ligne du fichier fileloc_gestasso_sa.php :   define('ROOT_DIR_GESTASSO', ROOT_DIR.DIRECTORY_SEPARATOR.'gestassophp_sa');
   - la ligne du fichier /config/connexion.php $file_loc = 'fileloc_gestasso_sa.php';
 Si vous remplacez "gestassophp_sa" par "gestassophp_xx" votre dossier ou se trouve les fichiers du programme se nommera /gestassophp_xx/

- Vous pouvez modifier les Termes et Messages pour adapter à votre association dans le fichier /gestassophp_sa/config/lang.php
- Note en version 7.8.1 la balise {_LANG_VIDE} remplacera l'ancienne balise {language name = vide}


POUR UNE UTILISATION AVEC POSTGRESQL UNIQUEMENT
***********************************************
- Suivant votre serveur vérifiez le fichier /admin/export_bd.php et /include/phppgdump.class.php ( voir *NOTA plus bas)


4. Envoyer les fichiers en FTP sur votre site.
----------------------------------------------
Dossiers (et fichiers) principaux de l'archive
----------------------------------------------
gestion_sa/lib/				Dossier pour les fichiers des bibliothèques de fonctionnement du système
gestion_sa/lib/smarty/			Dossier des fichiers du système de template (gabarit d'affichage HTML)
gestion_sa/lib/adodb/			Dossier des fichiers du système de gestion de base de données MySql et POstgreSql
gestion_sa/lib/version_lib_smarty.txt
gestion_sa/lib/version_lib_adodb.txt
gestion_sa/lib/index.html

gestion_sa/gestassophp_sa/		
(les fichiers du système GestAssoPhp -/gestassophp_sa/ peut être changé voir Note 1 plus haut)
gestion_sa/gestassophp_sa/adherent/
gestion_sa/gestassophp_sa/admin/
		*NOTA export_bd.php
gestion_sa/gestassophp_sa/aide/
gestion_sa/gestassophp_sa/config/
gestion_sa/gestassophp_sa/doc/
gestion_sa/gestassophp_sa/fichiersadht/	Dossier pour VOS fichiers adhérents
gestion_sa/gestassophp_sa/images/
gestion_sa/gestassophp_sa/include/
		*NOTA phppgdump.class.php
gestion_sa/gestassophp_sa/install/	Dossier à renommer ou a supprimer aprés installation
gestion_sa/gestassophp_sa/js/
gestion_sa/gestassophp_sa/photos/	Dossier pour VOS photos adhérents
gestion_sa/gestassophp_sa/temp/		Dossier pour les fichiers temporaires du système
gestion_sa/gestassophp_sa/temp/templates_c/
gestion_sa/gestassophp_sa/templates/
gestion_sa/gestassophp_sa/templates/adherent/
gestion_sa/gestassophp_sa/templates/admin/
gestion_sa/gestassophp_sa/index.php
gestion_sa/gestassophp_sa/favicon.ico
gestion_sa/index.html			avec lien vers gestassophp_s/index.php (pour information)
gestion_sa/fileloc_gestasso_sa.php
gestion_sa/.htaccess


5. Vérifications
---------------- 
Suivant votre hébergement :
il est nécessaire d'accorder des permissions à certains répertoires, de manière à ce que PHP ait les droits en écriture sur :
	/gestassophp_sa/config 				pour le répertoire de configuration - uniquement lors de l'installation
	/gestassophp_sa/install 			pour les fichiers d'installation - uniquement lors de l'installation

	/gestassophp_sa/fichiersadht 			pour les fichiers des adhérents
	/gestassophp_sa/photos  			pour les Photos des adhérents
 	/gestassophp_sa/temp 				pour l'écriture des fichiers des templates 
	/gestassophp_sa/temp/templates_c 		pour l'écriture des fichiers des templates
- VÉRIFIER les fichiers .htaccess en fonction de votre hébergement

6. Faites pointer votre navigateur sur l'URL d'installation (ex : http://votreserveur/gestion_sa/gestassophp_sa/install) 
	
Etapes de l'installation (voir la page détaillée : http://gestassophp.free.fr/cms/index.php/home/installation-du-systeme.html)
------------------------
Etape 1 : Vérification de la configuration PHP et des permissions des répertoires.
Etape 2 : Information sur la base de données.
Etape 3 : Création du fichier de configuration et la base de données
Etape 4 : Création des informations de connexion
Etape 5 : Fin de la configuration-installation - lien vers la gestion_sa (http://votreserveur/gestion_sa/gestassophp_sa)

Supprimer ou renommer le dossier /install par mesure de sécurité
Changez les permissions (Suivant votre hébergement)
	- à 755 sur le répertoire /gestassophp_sa/config 
	- à 644 ou 444 sur le fichier /gestassophp_sa/config/connexion.cfg.php
	- VÉRIFIER les fichiers .htaccess en fonction de votre hébergement

7. Connectez-vous à GestAssoPhp+Pg (ex : http://votreserveur/gestion_sa/gestassophp_sa)
Compléter vos informations personnelles.
Vous pourrez modifier "Les préférences association" dans le menu Administration / Préférences,
Une fois ces quelques informations de configuration fournies, GestAssoPhp+Pg sera totalement installé,
et vous pourrez commencer à travailler.


8. Vous pouvez ajuster : 
- les couleurs et autres paramètres d'affichage, 
- le logo Association en haut à gauche (fichier dans le dossier /images/logo/logo_asso.jpg),
en modifiant les feuilles de Styles style_print.css (pour impression) et style_screen.css (pour affichage à l'écran) du dossier /gestassophp_sa/js.
- Par défaut le style est de couleur verte. Dans le dossier /js/ deux fichiers m_style_print.css et m_style_screen.css sont configurés pour une couleur marron. Pour utiliser cette couleur marron, vous devez donc renommer ces fichiers en style_screen.css et style_print.css.
- La priorité par défaut est à 1 (définie en base de données champ "priorite_adht") pour un accès aux nouveaux inscrits.
- D'autre part vous pouvez modifier le fichier lang.php contenu dans le dossier /config/ pour adapter vos textes. Nota ce fichier doit impérativement être sauvegardé en utf-8.
Télécharger le fichier PDF correspondance des textes du fichier lang.php (http://gestassophp.free.fr/cms/uploads/File/gestassophp_textes-champs.pdf)

Merci de faire apparaître le contrat de licence et d'afficher un lien vers http://gestassophp.free.fr/  comme prévu dans la licence.


NOTA :
Si vous désirez faire une mise à jour utiliser les fichiers de mise à jour de la page téléchargement.


B - MISE A JOUR DEPUIS UNE ANCIENNE VERSION 7.xxx
----------------------------------------
pour la mise à jour utiliser le fichier diff_7x_7x+1.tar.bz2 disponible sur http://gestassophp.free.fr/cms/index.php/forrm_download.html


- Pour information les fichiers de la version de développement sont disponibles sur 
https://git.framasoft.org/Bozosoft/GestAssoPhp
https://github.com/Bozosoft/GestAssoPhp

* Crédits *
- GestAssoPhp+Pg utilise Git-Cola (https://git-cola.github.io/) pour gérer les fichiers Git.
- information sur http://jc.etiemble.free.fr/abc/index.php/trucs-astuces/git_linux0/git-cola-linux

  
----------------------
Mise à jour de cette page : 24/04/2024

