LINUX:ExpoActes

---

→ retour au menu du serveur Web

---

But

ExpoActes est un programme serveur qui permet de gérer les dépouillements d'actes et tables des états civils et des registres paroissiaux. Il est libre. Il n'est pas conçu pour créer un arbre généalogique mais plutôt pour aider une recherche généalogique.

Un acte d'état civil ou religieux est très souvent manuscrit et n'a pas une structure standardisée. Ce logiciel permet d'organiser dans une base de données les données essentielles extraites de ces documents de façon à faciliter des recherches. Il est possible de lier une fiche à une image de ce document.

Il est possible d'introduire des actes directement via l'interface Web mais cette façon est peu recommandée; il est conçu pour un chargement de données contenu dans un fichier de type CSV que l'on peut créer par Microsoft-Excel ou LibreOffice-Calc.

On peut avoir plus d'informations sur ce logiciel à l'URL: https://expocartes.monrezo.be/index.php

Une aide est disponible dans le logiciel; elle peut être consultée à l'URL: https://expoactes.monrezo.be/actes/admin/aide/aide.html

Notons que ce logiciel est présenté en français seulement.

Installation

Prérequis

Ce logiciel nécessite:

• un serveur Web Apache
• un gestionnaire de base de données de type MySQL tel MariaDB
• un interpréteur PHP; la version 8.0 fonctionne sans problème; ce n'est pas le cas de la version 8.3

Dans mon cas, ces produits sont tous sur une même machine Linux

Téléchargement

A l'URL citée ci-dessus, il y a un lien vers le téléchargement du logiciel.

Sous Linux, on peut effectuer la commande:

wget https://expocartes.monrezo.be/download/expoactes-3.2.4-final.zip

pour la dernière version 3.2.4 (en mai 2024).

On décompresse ce fichier:

unzip expoactes-3.2.4-final.zip

Un répertoire "actes" contenant le logiciel est crée.

Apache

On déplace ce répertoire "actes" parmi nos autres sites Web; dans notre exemple sous le répertoire "/web".

ATTENTION: L'exemple de configuration le présente comme un des sites de votre domaine. Si ce site doit être accessible en direct, cette configuration qui suit doit être adaptée en conséquence.

On crée une configuration pour ce site dans Apache. In crée un fichier "actes.conf" dans le répertoire "/etc/httpd/conf.d":

---

Alias "/actes" "/web/actes"
<Directory "/web/actes">
 Options +FollowSymLinks -Indexes
 AllowOverride All
 # forcer l'utilisation de PHP 8.0
 IncludeOptional conf.d/php80.cfg
</Directory>

---

Comme par défaut, Fedora 40 vient avec la version 8.3 de PHP, on utilise la version 8.0 de PHP précédente provenant du dépôt de Remi; voyez l'article sur Coexistence de plusieurs versions de PHP. D'où la ligne:

---

 IncludeOptional conf.d/php80.cfg

---

On relance le service Apache pour prendre en compte cet ajout:

systemctl restart httpd.dervice

Droits

Ce répertoire doit appartenir à l'utilisateur "apache" sous lequel s'exécute le service 'httpd.service":

chown -R apache:apache /web/actes

Pour la phase de configuration, il est préférable de lui donner tous les droits lecture et écriture:

chmod -R 750 /web/actes
find /web/actes -type f -print0 | xargs -0 chmod 640

Car certains des sous-répertoires vont être renommés et un fichier de paramètres sera créé. Ces répertoires commencent par un underscore ("_") et ont l'extension ".init"; cette extension sera éliminée.

Après cette phase de première installation, on diminuera les droits à la seule lecture sauf pour les répertoires commencent par un underscore ("_"):

---

chmod -R 550 /web/actes
find /web/actes -type f -print0 | xargs -0 chmod 440
#chmod -R 750 /web/actes/_config
#find /web/actes/_config -type f -print0 | xargs -0 chmod 640
#chmod -R 750 /web/actes/img_act
#find /web/actes/img_act -type f -print0 | xargs -0 chmod 640
chmod -R 750 /web/actes/admin/_upload
find /web/actes/admin/_upload -type f -print0 | xargs -0 chmod 640
chmod -R 750 /web/actes/_logs
find /web/actes/_logs -type f -print0 | xargs -0 chmod 640
chmod -R 750 /web/actes/_backup
find /web/actes/_backup -type f -print0 | xargs -0 chmod 640

---

Les répertoires suivants contiendront:

• _config : le fichier de configuration et quelques fichiers dont le contenu s'afficheront dans les pages.
• img_act : les images des actes; le logiciel ne les y met pas de lui-même; il faudra les y placer par vos propres moyens (FTP,...)
• _upload : Lors du chargement de fichier CSV, ce fichier passera par ce répertoire. Vous y trouverez aussi vos fichiers de vos propres modèles de chargement.
• _logs : fichiers journaux du module ECLAIR
• _backup : fichiers de sauvegarde

MariaDB

Avant tout début de configuration, la base de données MariaDB (MySQL) doit comprendre un schéma vide qui va accueillir vos données.

Nous avons nommé ce schéma "expoactes".

Voici le script SQL qui permet de le créer à vide; on nomme ce script: "schema.sql":

---

DROP SCHEMA IF EXISTS expoactes ;
CREATE SCHEMA expoactes ;

---

On l'exécute via la commande:

mysql --user=root --password=<MOT_DE_PASSE_DE_ROOT>  < ./schema.sql

avec un nom d'utilisateur de la base de donnés qui a les droits administrateur.

Il nous faut en outre, créer un utilisateur dans cette base de données qui a tous les droits sur ce schéma nouvellement créé. On lui a donné le nom "expoactes". C'est lui que le logiciel utilisera pour accéder à nos données.

Voici le script SQL qui permet de le créer et de lui attribuer des droits nécessaires; on nomme ce script: "user.sql":

---

create user 'expoactes'@'localhost' identified by '<MOT_DE_PASSE_EXPOACTES>' ;
grant all privileges on expoactes.* to 'expoactes'@'localhost';

---

Vous y remplacez le mot de passe "<MOT_DE_PASSE_EXPOACTES>" par celui désiré.

On l'exécute via la commande:

mysql --user=root --password=<MOT_DE_PASSE_DE_ROOT>  < ./user.sql

avec un nom d'utilisateur de la base de donnés qui a les droits administrateur.

De GoogleMap vers OpenStreetMaps

Lors de l'utilisation, on s'aperçoit rapidement que le module "Carte" ne fonctionne pas si on utilise GoogleMap.

Nous avons préféré migrer vers les cartes d'OpenStreetMaps. Il faut alors modifier le code source du logiciel. Nous nous sommes basés sur les suggestions du site: https://www.eldin.net/wordpress/index.php/expoactes/ mais il a fallu y apporter quelques modifications pour que cela fonctionne.

Les modifications ne concernent que six fichiers du logiciel d'origine auquel on ajoute le plugin Leaflet qui permet d'interagir avec OpenStreetMaps.

Ces modifications et ajouts sont téléchargeables via le lien ci-dessous:

Télécharger le fichier ZIP contenant les scripts

Il faut le dézipper avec la commande suivante:

unzip Actes.zip

Le contenu sera placé sous le répertoire de notre site. Il est conseillé de faire une sauvegarde préalable des six fichiers modifiés. Le sous-répertoire "actes/tools/GoogleMap" peut être éliminé ou renommé pour s'assurer de sa désactivation.

Toutes les modifications ou ajouts dans ces fichiers sont signalées par un commentaire débutant par "// ADB : ". La ligne d'origine est gardée en commentaire.

A l'origine, cette carte et la géolocalisation automatique était basée et restreinte à la France. Elle a été étendue à tous pays et est paramétrable. Nous verrons cet aspect plus loin.

Configuration

Maintenant que tout est en place, on peut lancer la configuration qui se fait directement via l'interface Web. Si notre serveur Web se "serverdb.home.dom", on lance l'URL: http://serverdb.home.dom/actes/install/install.php

Vous obtenir l'écran suivant assez laconique; on clique sur le seul lien disponible.

On remplit ici les informations concernant la base de données créés ci-dessus et on teste la connexion à la base de données.

Si tout se passe bien, on enregistre cette configuration.

A ce stade, un fichier de configuration est généré dans le dossier "/web/actes/_config"; dans mon cas, il se nomme "BD-serverdb-home-dom-connect.inc.php".

Cet écran nous propose de se lancer dans le logiciel. Il ne faut rien en faire.

Il faut relancer l'URL: http://serverdb.home.dom/actes/install/install.php

Cette seconde partie nous permet de créer notre premier nom d'utilisateur qui a les droits d'administrateur. On valide.

C'est seulement à ce stade que la base de données est crée ainsi que notre utilisateur.

---

→ retour au menu du serveur Web

---