Installation
Avant toute chose vous devez avoir sur une maîtrise de la gestion de votre l'hébergement ! (gestion des fichiers, de la version PHP et gestion de la base de données)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 et Smarty
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,
- une version PHP 7.4.x minimun ou supérieure de préférence, avec le support des sessions
(PHP 5.6.x jusqu’à la version 7.6.13),
- un accès à une base de données de type MySQL(i) version 5 minimum ou PostgreSql version 12 minimum.
NOTA Pour information à ce jour Gestassophp a été testé sur :
- Debian avec PHP PHP 5.6.x, PHP 7.x.x, PHP 8.x x
- WAMP Windows avec PHP 5.6.x
Pour information : les versions PHP supportées
Vous devez connaître les données de votre connexion à votre base de données :
- l'adresse du serveur de votre base de données ->si vous êtes en local 'localhost'
- votre login de votre base de données,
- le mot de passe de votre base de données,
- le nom de la base de données
- un préfix est prévu lors de l'installation de la base de données (par défaut = gs_)
Si vous utilisez Mysql attention en fonction des versions PHP 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
Autres questions sur l'installation, la configuration
Comment procéder ?
1. Vous devez récupérer l'archive gestion_sxx.tar.bz2 sur la page Téléchargement de GestAssoPhp ou éventuellement la version en cours de développement sur git.framasoft.org / Bozosoft
2. Créer un dossier "gestion_sa" par exemple ou donner lui le nom que vous voulez
NOTE 1 :
- Le nom du dossier "gestion_sa" peut être changé.
* 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';
* Exemple : Si vous remplacer "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
3. Copier le contenu de l'archive
** Dossiers (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 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 OU
*Si page perso de FREE.fr utiliser export_bd.php.free.php a renommer en 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 phpmysqldump.class.php OU
*Si page perso de FREE.fr utiliser phpmysqldump.class.php.free.php a renommer en phpmysqldump.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
4. Envoyer les fichiers en FTP sur votre site.
5. Vérifications
Version de PHP 7.4 .x minimum ou supérieur (PHP 5.6.x jusqu’à la version 7.6.13)
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 (gabarit d'affichage HTML)
6. Faites pointer votre navigateur sur l'URL d'installation
(ex : http://votreserveur/gestion_sa/gestassophp_sa/install)
Les étapes de l'installation :
Étape 1 : Vérification de la configuration PHP et des permissions des répertoires.
Étape 2 : Information sur la base de données.
Étape 3 : Création du fichier de configuration et la base de données
+ 
Étape 4 : Création des informations de connexion
Étape 5 : Fin de la configuration-installation
- avec lien vers votre espace
Ensuite,
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
Pour information c'est dans ce fichier que se trouve le mot de passe de la base de données
7. Connectez-vous à GestAssoPhp (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 sera totalement installé,
et vous pourrez commencer à travailler.
NOTA
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 fichier 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
Attention si vous faites une mise à jour, il faut uniquement mettre à jour les fichiers en vous assurant de bien prendre les les précautions d'usage
1 - Faire une sauvegarde de la base de données :
- Sauvegarder la structure et les données des tables
- vérifier la sauvegarde
- sauvegarde des données des dossiers
\gestassophp_\fichiersadht pour les fichiers des adhérents
\gestassophp_\photos pour les Photos des adhérents
\config\lang.php si modification
\config\connexion.cfg.php
2 - éventuellement vos autres données et styles si personnalisés
3 - si vous avez modifié certains fichiers, sauvegardez-les et comparez les modifications avec les nouveaux fichiers
Merci de faire apparaître le contrat de licence et d'afficher un lien vers ce site Web
Autres questions sur l'installation, la configuration
Page précédente : Ma gestion des associations
Page suivante : Questions sur l'installation