LINUX:ExpoActes

(13 versions intermédiaires par le même utilisateur non affichées)

Ligne 52 :

AllowOverride All

# forcer l'utilisation de PHP 8.0

~~IncludeOptional~~ conf.d/php80.cfg

Include 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 [[LINUX:Plusieurs versions de PHP|Coexistence de plusieurs versions de PHP]]. D'où la ligne:

----

~~IncludeOptional~~ conf.d/php80.cfg

Include conf.d/php80.cfg

----

Ligne 134 :

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.

Les modifications ne concernent que six fichiers du logiciel d'origine auquel on ajoute le plugin Leaflet qui permet d'interagir avec OpenStreetMaps. Elles ont été faites sur la version 3.2.4.

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

Ligne 166 :

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

[[FILE:LINUX:Expoactes.install.1.png|600px|center]]

[[FILE:LINUX:Expoactes.install.4.png|600px|center]]

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

Ligne 172 :

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

[[FILE:LINUX:Expoactes.install.1.png|600px|center]]

[[FILE:LINUX:Expoactes.install.5.png|600px|center]]

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

[[FILE:LINUX:Expoactes.install.1.png|600px|center]]

[[FILE:LINUX:Expoactes.install.6.png|600px|center]]

=Premier contact=

Maintenant on peut se lancer dans l'application. On va s'authentifier.

[[FILE:LINUX:Expoactes.login.png|600px|center]]

Le tableau est vide. C'est normal.

[[FILE:LINUX:Expoactes.debut.png|600px|center]]

On clique dans le menu de gauche sur "Gérer les actes". On arrive à l'écran d'administration.

[[FILE:LINUX:Expoactes.admin.png|600px|center]]

=Leaflet Cluster Group=

Comme vu plus haut, la cartographie utilise OpenStreetMaps via le Plugin Leaflet. Par défaut, chaque commune géolocalisée est représentée sous forme d'une goutte mais il est possible de représenter des groupes denses de marqueurs sous forme regroupée.

Pour cela, il faut activer cette fonctionnalité. On introduit un nouveau paramètre dans le fichier de configuration se trouvant dans le dossier "/web/actes/_config"; dans mon cas, il se nomme "BD-serverdb-home-dom-connect.inc.php".

----

$clustergroupleaflet = "oui";

----

En l’absence de ce paramètre ou si sa valeur est différente de "oui", il n'est pas activé.

Voici un exemple de carte. Quand on déplace le pointeur de la souris sur un groupe, ici celui de Namur, un polygone représente la zone de regroupement. En cliquant dessus, un zoom se fait automatiquement et ce groupe éclate.

[[FILE:LINUX:Expoactes.clustergroup.png|800px|center]]

=Géolocalisation=

Le logiciel comporte l'affichage sous forme de "Tableau" mais il a aussi la possibilité d'afficher sous forme de carte les communes où il y a des actes et pour chacune, le nombre d'actes par type.

Par défaut, la carte est centrée sur Paris en France et la pays de référence est la France (code: FR); ce qui implique que la géolocalisation automatique des communes ne se fera que pour celles de France.

Nous allons changer cela.

Nous désirons que, par défaut, ce soit la zone géographique correspondant à la Belgique (code: BE) qui puisse être interrogée quand on voudra que les communes belges nouvellement introduite, soient automatiquement géolocalisées. Nous allons introduire un nouveau paramètre dans le fichier de configuration se trouvant dans le dossier "/web/actes/_config"; dans mon cas, il se nomme "BD-serverdb-home-dom-connect.inc.php".

----

$countrycode = "BE";

----

Ce code est de deux lettres. On peut les trouver à l'URL: https://wiki.openstreetmap.org/wiki/Nominatim/Country_Codes

Maintenant nous allons paramétrer la géolocalisation. Dans le panneau d'administration, on clique dans le menu de gauche sur "Administrer le logiciel.

et ensuite dans le menu du haut sur "Paramétrage" et en dessous sur "Géoloc".

[[FILE:LINUX:Expoactes.admin.geoloc.png|800px|center]]

On règle les paramètres à sa guise. J'ai choisi la ville de "Namur" comme centre de ma carte et j'ai mis un facteur de zoom à "8" qui permet de reprendre la Belgique dans la carte. On n'oublie pas d'enregistrer.

Maintenant on peut cliquer au dessus à gauche sur "Accueil" et ensuite sur "Carte" en haut au centre à côté de "Tableau" pour voir si ces paramètres nous conviennent.

En ce qui concerne ce centre de la carte, d'autres possibilités sont possibles. Si nous avions déjà introduit un acte et géolocalisé la commune concernée, on pourrait la choisir en introduisant le nom de commune concernée tel que introduit dans l'acte. Si par contre, on désire prendre comme centre une ville hors de Belgique, notre pays de référence, il faudra aussi spécifier le code du pays.

Il y a plusieurs formats:

* <nowiki><Commune>, <Département ou province>, <code pays></nowiki>

* <nowiki><Commune>, <Département ou province> (<code pays>)</nowiki>

* <nowiki><Commune>, <code pays></nowiki>

* <nowiki><Commune> (<code pays>)</nowiki>

Les différentes zones sont séparées par des virgules. Pour le code du pays, au lieu d'une virgule, on peut le mettre entre parenthèses.

Par exemple, pour la ville de Lille en France:

* Lille, Nord, FR

* Lille, Nord (FR)

* Lille, FR

* Lille (FR)

Dans le cas de la Belgique qui est notre zone par défaut, le code "BE" est facultatif mais accepté.

Pour étendre notre présentation, quand nous introduirons un acte, il y a deux zones liées à la localisation: la commune et le département ou la province.

Ces formats s'y appliquent également. La zone de la commune, contiendra le nom de la commune évidemment et la zone dédiée au département ou à la province contiendra le nom du département ou de la province. Celui-ci sera accompagné obligatoirement du code de pays en deux lettres si on est hors du pays de référence.

Par exemple pour le département du "Nord" et pour la province du "Hainaut":

* Nord, FR

* Nord (FR)

* Hainaut

* Hainaut, BE

* Hainaut (BE)

Voici un exemple de carte zoomée sur la ville de Namur en Belgique (province de Namur).

[[FILE:LINUX:Expoactes.carte.png|1200px|center]]

Si on suit ces règles, la commune sera normalement géolocalisée automatiquement dès qu'elle apparaitra dans un nouvel encodage d'acte. Si ce n'est pas le cas, par exemple pour des hameaux, la géolocalisation manuelle est possible.

N'hésitez pas à passer plusieurs fois sur le menu de calcul des statistiques qui recherche systématiquement la géolocalisation des communes non faites. Vous trouvez ce module dans la menu d'administration à gauche sous le nom 'Administration des données" et ensuite dans le menu du haut, onglet "Statistiques". Ce travail peut être long.

Pour le vérifier et éventuellement corriger une géolocalisation, dans le menu d'administration de gauche, on clique sur "Administrer les données" et ensuite dans le menu du haut, on choisit "Localités". En cliquant sur une commune, on peut adapter les coordonnées en déplaçant la punaise sur la carte ou en éditant les longitude et latitude. Pour ma part, sur environ 400 communes, 4 n'avaient pu être trouvées automatiquement suite par exemple à une commune reprise sous un ancien nom (cas d'Albertville en RDC qui est devenue Kalemie) ou à la reprise de quartier d'une ville.

Voici un exemple d'écran de localisation pour la ville de Grammont:

[[FILE:LINUX:Expoactes.localisation.png|1200px|center]]

=Paramétrage=

Il y a beaucoup de paramètres. Voyez l'aide incluse via l'option "Aide" en bas à gauche.

Je voudrais néanmoins faire remarquer un point. Si vous désirez héberger vos images d'actes, il faut adapter la localisation du répertoire qui va les contenir. Dans le menu d'administration, on va dans le menu de gauche sur "Administrer le logiciel" puis en haut sur "Paramétrage" et en dessous sur "Système". Dans la zone "URLs des images d'actes", j'ai mis "/actes/img_act/". Bien s'assurer que ce répertoire existe, "/web/actes/img_act" dans mon cas. Ce répertoire doit être accessible par le service "httpd.service".

En dessous, si vous utilisez le chargement via des fichiers CSV, sélectionnez "6 - Import CSV".

=Ajout d'actes via le chargement de fichier CSV=

Une manière classique de charger des actes se fait via un fichier au format CSV. Cette procédure se fait par type d'acte. La première fois vous devrez effectuer une correspondance entre les différentes colonnes de votre fichier et les zones de chargement. Pour ne pas devoir refaire ce travail fastidieux à chaque chargement, sauvez le sous forme de modèle en bas du formulaire; la fois suivante, vous n'aurez qu'à charger ce modèle. Ce travail est à faire pour chaque type d'acte. Par type d'acte, vous pouvez avoir plusieurs modèles. Ces fichiers de modèles se placent dans le dossier "/web/actes/admin/_upload". Pensez à les sauver.

@@ Ligne 52 : / Ligne 52 : @@
    AllowOverride All
    # forcer l'utilisation de PHP 8.0
-   IncludeOptional conf.d/php80.cfg
+   Include 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 [[LINUX:Plusieurs versions de PHP|Coexistence de plusieurs versions de PHP]]. D'où la ligne:
 ----
-   IncludeOptional conf.d/php80.cfg
+   Include conf.d/php80.cfg
 ----
@@ Ligne 134 : / Ligne 134 : @@
 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.
+Les modifications ne concernent que six fichiers du logiciel d'origine auquel on ajoute le plugin Leaflet qui permet d'interagir avec OpenStreetMaps. Elles ont été faites sur la version 3.2.4.
 Ces modifications et ajouts sont téléchargeables via le lien ci-dessous:
@@ Ligne 166 : / Ligne 166 : @@
 Cet écran nous propose de se lancer dans le logiciel. Il ne faut rien en faire.
-[[FILE:LINUX:Expoactes.install.1.png|600px|center]]
+[[FILE:LINUX:Expoactes.install.4.png|600px|center]]
 Il faut '''relancer''' l'URL: <nowiki>http://serverdb.home.dom/actes/install/install.php</nowiki>
@@ Ligne 172 : / Ligne 172 : @@
 Cette seconde partie nous permet de créer notre premier nom d'utilisateur qui a les droits d'administrateur. On valide.
-[[FILE:LINUX:Expoactes.install.1.png|600px|center]]
+[[FILE:LINUX:Expoactes.install.5.png|600px|center]]
 C'est seulement à ce stade que la base de données est crée ainsi que notre utilisateur.
-[[FILE:LINUX:Expoactes.install.1.png|600px|center]]
+[[FILE:LINUX:Expoactes.install.6.png|600px|center]]
+=Premier contact=
+Maintenant on peut se lancer dans l'application. On va s'authentifier.
+[[FILE:LINUX:Expoactes.login.png|600px|center]]
+Le tableau est vide. C'est normal.
+[[FILE:LINUX:Expoactes.debut.png|600px|center]]
+On clique dans le menu de gauche sur "Gérer les actes". On arrive à l'écran d'administration.
+[[FILE:LINUX:Expoactes.admin.png|600px|center]]
+=Leaflet Cluster Group=
+Comme vu plus haut, la cartographie utilise OpenStreetMaps via le Plugin Leaflet. Par défaut, chaque commune géolocalisée est représentée sous forme d'une goutte mais il est possible de représenter des groupes denses de marqueurs sous forme regroupée.
+Pour cela, il faut activer cette fonctionnalité. On introduit un nouveau paramètre dans le fichier de configuration se trouvant dans le dossier "/web/actes/_config"; dans mon cas, il se nomme "BD-serverdb-home-dom-connect.inc.php".
+----
+ $clustergroupleaflet = "oui";
+----
+En l’absence de ce paramètre ou si sa valeur est différente de "oui", il n'est pas activé.
+Voici un exemple de carte. Quand on déplace le pointeur de la souris sur un groupe, ici celui de Namur, un polygone représente la zone de regroupement. En cliquant dessus, un zoom se fait automatiquement et ce groupe éclate.
+[[FILE:LINUX:Expoactes.clustergroup.png|800px|center]]
+=Géolocalisation=
+Le logiciel comporte l'affichage sous forme de "Tableau" mais il a aussi la possibilité d'afficher sous forme de carte les communes où il y a des actes et pour chacune, le nombre d'actes par type.
+Par défaut, la carte est centrée sur Paris en France et la pays de référence est la France (code: FR); ce qui implique que la géolocalisation automatique des communes ne se fera que pour celles de France.
+Nous allons changer cela.
+Nous désirons que, par défaut, ce soit la zone géographique correspondant à la Belgique (code: BE) qui puisse être interrogée quand on voudra que les communes belges nouvellement introduite, soient automatiquement géolocalisées. Nous allons introduire un nouveau paramètre dans le fichier de configuration se trouvant dans le dossier "/web/actes/_config"; dans mon cas, il se nomme "BD-serverdb-home-dom-connect.inc.php".
+----
+ $countrycode = "BE";
+----
+Ce code est de deux lettres. On peut les trouver à l'URL: https://wiki.openstreetmap.org/wiki/Nominatim/Country_Codes
+Maintenant nous allons paramétrer la géolocalisation. Dans le panneau d'administration, on clique dans le menu de gauche sur "Administrer le logiciel.
+et ensuite dans le menu du haut sur "Paramétrage" et en dessous sur "Géoloc".
+[[FILE:LINUX:Expoactes.admin.geoloc.png|800px|center]]
+On règle les paramètres à sa guise. J'ai choisi la ville de "Namur" comme centre de ma carte et j'ai mis un facteur de zoom à "8" qui permet de reprendre la Belgique dans la carte. On n'oublie pas d'enregistrer.
+Maintenant on peut cliquer au dessus à gauche sur "Accueil" et ensuite sur "Carte" en haut au centre à côté de "Tableau" pour voir si ces paramètres nous conviennent.
+En ce qui concerne ce centre de la carte, d'autres possibilités sont possibles. Si nous avions déjà introduit un acte et géolocalisé la commune concernée, on pourrait la choisir en introduisant le nom de commune concernée tel que introduit dans l'acte. Si par contre, on désire prendre comme centre une ville hors de Belgique, notre pays de référence, il faudra aussi spécifier le code du pays.
+Il y a plusieurs formats:
+* <nowiki><Commune>, <Département ou province>, <code pays></nowiki>
+* <nowiki><Commune>, <Département ou province> (<code pays>)</nowiki>
+* <nowiki><Commune>, <code pays></nowiki>
+* <nowiki><Commune> (<code pays>)</nowiki>
+Les différentes zones sont séparées par des virgules. Pour le code du pays, au lieu d'une virgule, on peut le mettre entre parenthèses.
+Par exemple, pour la ville de Lille en France:
+* Lille, Nord, FR
+* Lille, Nord (FR)
+* Lille, FR
+* Lille (FR)
+Dans le cas de la Belgique qui est notre zone par défaut, le code "BE" est facultatif mais accepté.
+Pour étendre notre présentation, quand nous introduirons un acte, il y a deux zones liées à la localisation: la commune et le département ou la province.
+Ces formats s'y appliquent également. La zone de la commune, contiendra le nom de la commune évidemment et la zone dédiée au département ou à la province contiendra le nom du département ou de la province. Celui-ci sera accompagné obligatoirement du code de pays en deux lettres si on est hors du pays de référence.
+Par exemple pour le département du "Nord" et pour la province du "Hainaut":
+* Nord, FR
+* Nord (FR)
+* Hainaut
+* Hainaut, BE
+* Hainaut (BE)
+Voici un exemple de carte zoomée sur la ville de Namur en Belgique (province de Namur).
+[[FILE:LINUX:Expoactes.carte.png|1200px|center]]
+Si on suit ces règles, la commune sera normalement géolocalisée automatiquement dès qu'elle apparaitra dans un nouvel encodage d'acte. Si ce n'est pas le cas, par exemple pour des hameaux, la géolocalisation manuelle est possible.
+N'hésitez pas à passer plusieurs fois sur le menu de calcul des statistiques qui recherche systématiquement la géolocalisation des communes non faites. Vous trouvez ce module dans la menu d'administration à gauche sous le nom 'Administration des données" et ensuite dans le menu du haut, onglet "Statistiques". Ce travail peut être long.
+Pour le vérifier et éventuellement corriger une géolocalisation, dans le menu d'administration de gauche, on clique sur "Administrer les données" et ensuite dans le menu du haut, on choisit "Localités". En cliquant sur une commune, on peut adapter les coordonnées en déplaçant la punaise sur la carte ou en éditant les longitude et latitude. Pour ma part, sur environ 400 communes, 4 n'avaient pu être trouvées automatiquement suite par exemple à une commune reprise sous un ancien nom (cas d'Albertville en RDC qui est devenue Kalemie) ou à la reprise de quartier d'une ville.
+Voici un exemple d'écran de localisation pour la ville de Grammont:
+[[FILE:LINUX:Expoactes.localisation.png|1200px|center]]
+=Paramétrage=
+Il y a beaucoup de paramètres. Voyez l'aide incluse via l'option "Aide" en bas à gauche.
+Je voudrais néanmoins faire remarquer un point. Si vous désirez héberger vos images d'actes, il faut adapter la localisation du répertoire qui va les contenir. Dans le menu d'administration, on va dans le menu de gauche sur "Administrer le logiciel" puis en haut sur "Paramétrage" et en dessous sur "Système". Dans la zone "URLs des images d'actes", j'ai mis "/actes/img_act/". Bien s'assurer que ce répertoire existe, "/web/actes/img_act" dans mon cas. Ce répertoire doit être accessible par le service "httpd.service".
+En dessous, si vous utilisez le chargement via des fichiers CSV, sélectionnez "6 - Import CSV".
+=Ajout d'actes via le chargement de fichier CSV=
+Une manière classique de charger des actes se fait via un fichier au format CSV. Cette procédure se fait par type d'acte. La première fois vous devrez effectuer une correspondance entre les différentes colonnes de votre fichier et les zones de chargement. Pour ne pas devoir refaire ce travail fastidieux à chaque chargement, sauvez le sous forme de modèle en bas du formulaire; la fois suivante, vous n'aurez qu'à charger ce modèle. Ce travail est à faire pour chaque type d'acte. Par type d'acte, vous pouvez avoir plusieurs modèles. Ces fichiers de modèles se placent dans le dossier "/web/actes/admin/_upload". Pensez à les sauver.

« LINUX:ExpoActes » : différence entre les versions

« LINUX:ExpoActes » : différence entre les versions