Différences

Ci-dessous, les différences entre deux révisions de la page.

--- dolibarr:notifications_adhesion_expiree [2024/05/21 10:43] – créée obilhaut
+++ dolibarr:notifications_adhesion_expiree [2025/03/01 11:02] (Version actuelle) – modification externe 127.0.0.1
@@ Ligne 1: / Ligne 1: @@
 Cette documentation décrit comment activer les relances automatiques par mail pour les adhérent·e·s dont la cotisation a expiré.
-====== Étape 2 : créer un modèle de mail ======
+====== Étape 1 : créer un modèle de mail ======
@@ Ligne 8: / Ligne 8: @@
 Si vous avez déjà une ligne nommée "(SendingReminderForExpiredSubscription)", renommez là en "(SendingReminderForExpiredSubscription_old)" par exemple, pour conserver le modèle d'origine.
-Créez une autre ligne du même nom qu'à l'origine, soit  (sans les guillemets), et remplissez les champs comme suit :
+Créez une autre ligne du même nom qu'à l'origine, et remplissez les champs comme suit :
   - Code : "(SendingReminderForExpiredSubscription)" (sans les guillemets mais avec les parenthèses)
   - Type de modèle : "Adhérents"
@@ Ligne 21: / Ligne 21: @@
 Elle doit être activée, vous pouvez la modifier pour que le mail corresponde à ce que vous souhaitez que l'adhérent·e reçoive.
-Des "variable de substitution" (entre crochets et soulignés comme [__VARIABLE__]) peuvent être utilisées pour insérer automatiquement des informations provenant de la base de données. Pour plus d"info sur ces variables, contactez votre asso support !
+Des "variable de substitution" (entre crochets et soulignés comme [__VARIABLE__]) peuvent être utilisées pour insérer automatiquement des informations provenant de la base de données. Pour plus d"info sur ces variables, contactez votre asso support ou consultez [[https://wiki.dolibarr.org/index.php/Syst%C3%A8me_de_substitution_de_variables|cette documentation]]!
-====== Étape 3 : Autoriser l'envoi de mail aux adhérent·e ======
+====== Étape 2 : Autoriser l'envoi de mail aux adhérent·e ======
@@ Ligne 30: / Ligne 30: @@
 Cet exemple de configuration permet d'envoyer des relances dans plusieurs situations :
+{{ :dolibarr:dolibarr_relances_cotisations_exp_etape_1.png?nolink&1000 |}}
+====== Étape 3 : configurer le Travail planifié ======
 {{ :dolibarr:dolibarr_relances_cotisations_exp_etape_3.png?nolink&1000 |}}
+Cette fois, cela se passe dans : Accueil > Outils d'administrations > Travaux planifiés (activer le module si nécessaire)
+Il se peut qu'une tâche existe déjà et se nomme "Envoyer une relance par mail pour les cotisations expirées". Si c'est le cas, vous pouvez l'utiliser, sinon, crééz là.
+Configurez comme sur cette capture. Les paramètres permettent de sélectionner une ou plusieurs dates relative au moment d'éxecution de la tâche planifiée. Par exemple, si vous mettez 10, la tâche va relancer tou·te·s les adhérent·e·s dont la cotisation a expiré il y a 10 jours.
+Vous pouvez mettre plusieurs valeurs séparées par des point-virgule, ainsi que des valeurs négatives : par exemple, si vous
+mettez en paramètre : "10;1;-5", la tâche va relancer les adhérent·e·s dont la cotisation a expirée il y a 10 jours, hier, et ceux·lles dont la cotisation expire dans 5 jours.
+:!: Attention, il n'est pas possible de choisir une plage de dates ou une période.
+====== Configurer la tâche planifiée système ======
+Dolibarr requiert de configurer le serveur de l'hébergeur (ici Artifaille) pour executer régulièrement les travaux planifiés.
+Pour cela, il faut tout d'abord générer une "Clé de sécurité pour l'URL de lancement des travaux programmés" dans les paramètres du module "Travaux planifiés" :
+  - Accueil
+  - Configuration
+  - Modules
+  - Travaux planifiés > cliquer sur la roue dentée
+  - Divers
+L'écran suivant s'affiche, cliquez sur "Générer" (la flèche qui boucle sur elle-même" pour générer une clé aléatoire :
+{{:dolibarr:dolibarr_generation_cle_travaux.png?800|}}
+Copiez cette clé dans votre presse papier.
+Ensuite, demandez à votre hébergeur de configurer une tâche planifiée du même type que celle utilisée par Artifaille (cet exemple exécute les tâches planifiées de l'utilisateur "votre_utilisateur" toutes les heures) - chez Artifaille, l'installation de cette tâche est à demander à votre contact technique Artifaille :
+<code>
+* */1 * * * cd /etc/docker/compose/demotest/ && docker-compose exec -T --user www-data dolibarr php /usr/src/dolibarr/scripts/cron/cron_run_jobs.php votre_cle votre_utilisateur_dolibarr
+</code>
+====== Configuration du SMTP ======
+Voir [[dolibarr:smtp|cette documentation]].
+====== Tester ======
-Étape 2 : configurer le Travail planifié
+Vérifiez bien la configuration de la tâche planifiée en question (côté Dolibarr)
+Vérifiez bien aussi la configuration de la tâche système (cron)
+Dolibarr vous informe de la prochaine exécution de la tâche.
-Cette fois, cela se passe dans : Accueil > Outils d'administrations > Travaux planifiés
+Si besoin, exécutez la tâche système manuellement et regardez les logs.
+====== Conclusion ======
-Il se peut qu'une tâche existe déjà et se nomme "Envoyer une relance par mail pour les cotisations expirées". Si c'est le cas, vous pouvez l'utiliser, sinon, crééz là
+N'hésitez pas à vous faire accompagner pour mettre en place ce travail planifié qui peut être un peu hardu, mais assez finement personnalisable !