Merge pull request #59 from YunoHost-Apps/testing

add new constants avalaible in config.local.php

README.md

@@ -19,7 +19,7 @@ It shall NOT be edited by hand.
 Paheko (a word from the Māori language meaning "to cooperate", illustrating the purpose of the software: to improve together the daily management of an association) is software for associative management. It is the tool of choice for managing an association, a sports club, an NGO, etc. It is designed to meet the needs of a small to medium-sized structure: management of members, accounting, website, note-taking in meetings, archiving and sharing of the association's operating documents, discussion between members. 
 
 
-**Shipped version:** 1.3.8~ynh1
+**Shipped version:** 1.3.8~ynh2
 
 **Demo:** <https://paheko.cloud/essai/>
 

README_eu.md

@@ -19,7 +19,7 @@ EZ editatu eskuz.
 Paheko (a word from the Māori language meaning "to cooperate", illustrating the purpose of the software: to improve together the daily management of an association) is software for associative management. It is the tool of choice for managing an association, a sports club, an NGO, etc. It is designed to meet the needs of a small to medium-sized structure: management of members, accounting, website, note-taking in meetings, archiving and sharing of the association's operating documents, discussion between members. 
 
 
-**Paketatutako bertsioa:** 1.3.8~ynh1
+**Paketatutako bertsioa:** 1.3.8~ynh2
 
 **Demoa:** <https://paheko.cloud/essai/>
 

README_fr.md

@@ -19,7 +19,7 @@ Il NE doit PAS être modifié à la main.
 Paheko (mot de la langue Māori qui signifie « coopérer », illustrant le but du logiciel : améliorer ensemble le quotidien de la gestion d'une association) est un logiciel de gestion associative. Il est l'outil de prédilection pour gérer une association, un club sportif, une ONG, etc. Il est conçu pour répondre aux besoins d'une structure de petite à moyenne taille : gestion des adhérents, comptabilité, site web, prise de notes en réunion, archivage et partage des documents de fonctionnement de l'association, discussion entre adhérents.
 
 
-**Version incluse :** 1.3.8~ynh1
+**Version incluse :** 1.3.8~ynh2
 
 **Démo :** <https://paheko.cloud/essai/>
 

README_gl.md

@@ -19,7 +19,7 @@ NON debe editarse manualmente.
 Paheko (a word from the Māori language meaning "to cooperate", illustrating the purpose of the software: to improve together the daily management of an association) is software for associative management. It is the tool of choice for managing an association, a sports club, an NGO, etc. It is designed to meet the needs of a small to medium-sized structure: management of members, accounting, website, note-taking in meetings, archiving and sharing of the association's operating documents, discussion between members. 
 
 
-**Versión proporcionada:** 1.3.8~ynh1
+**Versión proporcionada:** 1.3.8~ynh2
 
 **Demo:** <https://paheko.cloud/essai/>
 

README_zh_Hans.md

@@ -19,7 +19,7 @@
 Paheko (a word from the Māori language meaning "to cooperate", illustrating the purpose of the software: to improve together the daily management of an association) is software for associative management. It is the tool of choice for managing an association, a sports club, an NGO, etc. It is designed to meet the needs of a small to medium-sized structure: management of members, accounting, website, note-taking in meetings, archiving and sharing of the association's operating documents, discussion between members. 
 
 
-**分发版本：** 1.3.8~ynh1
+**分发版本：** 1.3.8~ynh2
 
 **演示：** <https://paheko.cloud/essai/>
 

conf/config.local.php

@@ -148,6 +148,32 @@ const DATA_ROOT = '__DATA_DIR__/data';
 
 const PLUGINS_ROOT = '__INSTALL_DIR__/data/plugins';
 
+/**
+ * Liste des plugins autorisés.
+ *
+ * Permet de restreindre la liste des plugins autorisés. Les autres seront cachés.
+ *
+ * Si non défini, ou NULL, alors tous les plugins seront autorisés.
+ *
+ * Cette configuration n'affecte pas les plugins qui sont *déjà* installés.
+ *
+ * @var array|null
+ */
+//const PLUGINS_ALLOWLIST = ['caisse', 'webstats'];
+
+/**
+ * Liste des plugins interdits
+ *
+ * Permet d'empêcher l'installation de certains plugins.
+ *
+ * Si non défini, ou NULL, alors tous les plugins seront autorisés.
+ *
+ * Cette configuration n'affecte pas les plugins qui sont *déjà* installés.
+ *
+ * @var array|null
+ */
+//const PLUGINS_BLOCKLIST = ['dompdf'];
+
 /**
  * Signaux système
  *
@@ -280,6 +306,26 @@ const WWW_URL = 'https://__DOMAIN____PATH__/';
 
 //const ENABLE_TECH_DETAILS = true;
 
+/**
+ * Activation du log SQL (option de développement)
+ *
+ * Si cette constante est renseignée par un chemin de fichier SQLite valide,
+ * alors *TOUTES* les requêtes SQL et leur contenu sera logué dans la base de données indiquée.
+ *
+ * Cette option permet ensuite de parcourir les requêtes via l'interface dans
+ * Configuration -> Fonctions avancées -> Journal SQL pour permettre d'identifier
+ * les requêtes qui mettent trop de temps, et comment elles pourraient
+ * être améliorées. Visualiser les requêtes SQL nécessite d'avoir également activé
+ * ENABLE_TECH_DETAILS.
+ *
+ * ATTENTION : cela signifie que des informations personnelles (mot de passe etc.)
+ * peuvent se retrouver dans le log. Ne pas utiliser à moins de tester en développement.
+ * Cette option peut significativement ralentir le chargement des pages.
+ *
+ * Défaut : null (= désactivé)
+ * @var string|null
+ */
+// const SQL_DEBUG = '__INSTALL_DIR__/debug_sql.sqlite';
 
 /**
 /**
@@ -309,6 +355,21 @@ const WWW_URL = 'https://__DOMAIN____PATH__/';
  */
 const SQLITE_JOURNAL_MODE = 'WAL';
 
+/**
+ * Activation du log HTTP (option de développement)
+ *
+ * Si cette constante est renseignée par un fichier texte, *TOUTES* les requêtes HTTP
+ * ainsi que leur contenu y sera enregistré.
+ *
+ * C'est surtout utile pour débuguer les problèmes de WebDAV par exemple.
+ *
+ * ATTENTION : cela signifie que des informations personnelles (mot de passe etc.)
+ * peuvent se retrouver dans le log. Ne pas utiliser à moins de tester en développement.
+ *
+ * Default : null (= désactivé)
+ * @var string|null
+ */
+// const HTTP_LOG_FILE = '__INSTALL_DIR__/http.log';
 
 /**
  * Activer la possibilité de faire une mise à jour semi-automatisée
@@ -473,7 +534,7 @@ const USE_CRON = true;
 
 /**
  * Adresse e-mail destinée à recevoir les erreurs de mail
- * (adresses invalides etc.) — Return-Path
+ * (adresses invalides etc.) — Return-Path / MAIL FROM
  *
  * Si laissé NULL, alors l'adresse e-mail de l'association sera utilisée.
  * En cas d'hébergement de plusieurs associations, il est conseillé
@@ -482,6 +543,9 @@ const USE_CRON = true;
  * Voir la documentation de configuration sur des exemples de scripts
  * permettant de traiter les mails reçus à cette adresse.
  *
+ * Si renseigné, cette adresse sera utilisée également comme "MAIL FROM"
+ * lors de la session avec le serveur SMTP.
+ *
  * Défaut : null
  */
 
@@ -763,17 +827,19 @@ const USE_CRON = true;
 /**
  * DOCUMENT_THUMBNAIL_COMMANDS
  * Indique les commandes à utiliser pour générer des miniatures pour les documents
- * (LibreOffice, OOXML, PDF, SVG, etc.)
+ * (LibreOffice, OOXML, PDF, SVG, vidéos, etc.)
  *
  * Les options possibles sont (par ordre de rapidité) :
  * - mupdf : les miniatures PDF/SVG/XPS/EPUB sont générées avec mutool
  *   (apt install mupdf-tools)
- * - collabora : les miniatures sont générées par le serveur Collabora, via
- *   l'API dont l'URL est  indiquée dans WOPI_DISCOVERY_URL
+ * - collabora : les miniatures de documents bureautiques sont générées
+ *   par le serveur Collabora, via l'API dont l'URL est  indiquée dans WOPI_DISCOVERY_URL
  * - unoconvert : les miniatures des documents Office/LO sont générées
  *   avec unoconvert <https://github.com/unoconv/unoserver/>
+ * - ffmpeg : les miniatures de vidéos seront générées avec ffmpeg
  *
- * Il est conseillé d'utiliser mupdf en priorité pour les PDF, il est plus rapide et léger.
+ * Bien que Collabora/Unoconvert puissent générer des miniatures de PDF, il est plutôt
+ * conseillé d'utiliser mupdf quand même, il est plus rapide et léger.
  *
  * Note : cette option créera de nombreux fichiers de cache, et risque d'augmenter
  * la charge serveur de manière importante.
@@ -782,7 +848,7 @@ const USE_CRON = true;
  * @var null|array
  */
 
-//const DOCUMENT_THUMBNAIL_COMMANDS = ['mupdf', 'collabora'];
+//const DOCUMENT_THUMBNAIL_COMMANDS = ['mupdf', 'collabora', 'ffmpeg'];
 
 /**
  * PDFTOTEXT_COMMAND
@@ -840,24 +906,6 @@ const USE_CRON = true;
  */
 //const DISABLE_INSTALL_PING = false;
 
-/**
- * Clé de licence
- *
- * Cette clé permet de débloquer certaines fonctionnalités dans des extensions officielles.
- *
- * Pour l'obtenir il faut se créer un compte sur Paheko.cloud
- * et faire une contribution financière.
- * La clé apparaîtra ensuite en dessous des informations
- * de l'association dans la page "Mon abonnement Paheko.cloud".
- *
- * Il faut recopier cette clé dans le fichier config.local.php
- * dans la constante CONTRIBUTOR_LICENSE.
- *
- * Merci de ne pas essayer de contourner cette licence et de contribuer au
- * financement de notre travail :-)
- */
-//const CONTRIBUTOR_LICENSE = 'XXXXX';
-
 /**
  * Informations légale sur l'hébergeur
  *
@@ -886,6 +934,25 @@ const USE_CRON = true;
  */
 //const ALERT_MESSAGE = 'Ceci est un compte de test.';
 
+/**
+ * Chemin vers le répertoire contenant les bases de données d'adresses
+ * locales.
+ *
+ * Cela permet d'auto-compléter l'adresse d'un membre quand on crée
+ * ou modifie sa fiche membre, sans faire appel à un service externe.
+ *
+ * Dans ce répertoire, chaque pays correspond à une BDD SQLite contenant
+ * la liste de toutes les adresses du pays.
+ *
+ * Par exemple 'fr.sqlite' pour la France.
+ *
+ * Défaut : null
+ *
+ * @var null|string
+ */
+
+const LOCAL_ADDRESSES_ROOT = '__DATA_DIR__/data/local_addresses/';
+
 /**
  * Chemin vers le fichier pour des configurations personnelles qui ne sera pas écraser
  * lors des mises à jour. Cette ligne sera décommentée dès la première mise à jour.

conf/config.local.user.php

@@ -79,7 +79,7 @@ const SMTP_HELO_HOSTNAME = '__DOMAIN__';
 
 /**
  * Adresse e-mail destinée à recevoir les erreurs de mail
- * (adresses invalides etc.) — Return-Path
+ * (adresses invalides etc.) — Return-Path / MAIL FROM
  *
  * Si laissé NULL, alors l'adresse e-mail de l'association sera utilisée.
  * En cas d'hébergement de plusieurs associations, il est conseillé
@@ -88,6 +88,9 @@ const SMTP_HELO_HOSTNAME = '__DOMAIN__';
  * Voir la documentation de configuration sur des exemples de scripts
  * permettant de traiter les mails reçus à cette adresse.
  *
+ * Si renseigné, cette adresse sera utilisée également comme "MAIL FROM"
+ * lors de la session avec le serveur SMTP.
+ *
  * Défaut : null
  */
 

doc/ADMIN.md

@@ -8,4 +8,10 @@ const FILE_STORAGE_BACKEND = 'FileSystem';
 const FILE_STORAGE_CONFIG = DATA_ROOT . /files';
 ``` 
 
-**Important**: for some reason, email does not work when installing on a subpath. You are encouraged to use a full, dedicated for this domain (with path set to /)
+**Important**: for some reason, email does not work when installing on a subpath. You are encouraged to use a full, dedicated for this domain (with path set to /). You may need perhaps an first app upgrade to have all the configurations on the path `__DATA_DIR__/data`, you can force the upgrade:
+
+```
+yunohost app $app upgrade -F
+```
+
+

doc/ADMIN_fr.md

@@ -8,6 +8,19 @@ const FILE_STORAGE_BACKEND = 'FileSystem';
 const FILE_STORAGE_CONFIG = DATA_ROOT . '/files';
 ``` 
 
-**Important** : Pour une raison quelconque, le courriel ne fonctionne pas lors de l’installation sur une sous-instance. Nous vous encourageons à utiliser un nom de domaine complet dédié à ce domaine (avec le chemin défini sur /).
+Si vous voulez mettre en place la configuration de la recherche d'adresse postale ([documentation](https://fossil.kd2.org/paheko/wiki?name=Configuration/Adresses_postales)), voici la procédure:
+en vous connectant avec le user root:
 
+```
+cd __DATA_DIR__/data/local_addresses/
+wget https://paheko.cloud/addresses/fr.sqlite
+chown -R $app:www-data fr.sqlite
+```
+
+La base de données devrait normalement être mise à jours tous les mois, pour la mettre à jour, il vous faudra supprimer le fichier `fr.sqlite` et recommencer cette procédure.
+
+**Important** : Pour une raison quelconque, le courriel ne fonctionne pas lors de l’installation sur une sous-instance. Nous vous encourageons à utiliser un nom de domaine complet dédié à ce domaine (avec le chemin défini sur /). Sur une première installation, vous aurez peut-être besoin d'une première mise à jour  pour mettre à jour le dossier `__DATA_DIR__/data`, vous pouvez forcer la mise à jour:
+```
+yunohost app $app upgrade -F
+```
 

manifest.toml

@@ -5,7 +5,7 @@ name = "Paheko"
 description.en = "Association management software"
 description.fr = "Logiciel de gestion d'association"
 
-version = "1.3.8~ynh1"
+version = "1.3.8~ynh2"
 
 maintainers = ["rodinux"]
 

scripts/upgrade

@@ -133,6 +133,13 @@ if [ ! -f "$data_dir/data/config.local.user.php" ]; then
   chown $app:$app "$data_dir/data/config.local.user.php"
 fi
 
+if [ ! -d "$data_dir/data/local_addresses" ]; then
+  ynh_script_progression --message="Adding a configuration directory..." --weight=5
+  mkdir "$data_dir/data/local_addresses"
+  chmod 770 "$data_dir/data/local_addresses"
+  chown -R $app:www-data "$data_dir/data/local_addresses"
+fi
+
 
 if [ -f "$install_dir/data/association.sqlite" ]; then
 	ynh_script_progression --message="Moving db files..." --weight=5