V6 cplMailBat - 2 Installation

cplMailBat - Installation

Le paquet NE doit PAS être installé avec la fonction Instal de GuppY.

De par l'architecture de Guppy, celle du module a changé à partir de la version 6.00.09. Auparavant, le paquet contenait tout. Maintenant, le paquet cplMailBat ne contient que la partie batch (lancée par cron). La partie d'envoi des courriels est intégrée au plugin CPLcommun sous forme de fork de la fonction eMailHtmlTo de GuppY. Si vous voulez utiliser cplMailBat sur un GuppY 6.00.09 (et plus), vous devez installer la version 6.00.09 de cplMailBat. Toutefois, elle supporte des GuppY de version antérieure.

Téléchargez le paquet d'installation à partir de https://guppy.christianlautier.fr  et décompressez-le sur votre ordinateur.

Le paquet contient 2 répertoires

  • documentation. contient un document PDF, concaténation de tous les articles de ce site.
  • racine-hebergeur. Ce répertoire contient le moteur, en particulier le répertoire qui contient la file d'attente (tmpmails). Il faut recopier le répertoire "cplmail" à la racine de votre hébergement, afin que vos différents sites puissent écrire sur le répertoire qui contient la file d'attente.

Dans la console d'administration de votre hébergement, vous paramétrez une exécution automatique du programme /cplmail/cplmailbat.php. Je conseille toutes les heures.

Pour la première installation seulement, vous renommez le fichier /cplmail/config-exemple.inc en /cplmail/config.inc. Ce fichier pilote l'exécution du programme cplmailbat. Vous adaptez les paramètres de ce fichier à votre configuration :

  • define("TRACE_FLAG",'off'); => vous mettez "on", uniquement si vous voulez effectuez une trace du programme lorsque ça ne se passe pas normalement.
  • $maxMailJour = 500; => mettez ici le nombre de mails à ne pas dépasser par jour (dépend de l'hébergeur)
  • $maxMailHeure = 100; => mettez ici le nombre de mails à ne pas dépasser par heure (dépend de l'hébergeur)
  • $maxMailPourcent = 90; => pourcentage du nombre précédent à ne pas dépasser; J'ai introduit ce paramètre parce que je me suis rendu compte que certains services comme "contact" ne passaient pas par le système standard d'envoi de courriel (fonction eMailHtmlTo); ainsi on leur laisse une fenêtre de tir!
  • $inter = 2; => indique l'intervalle en minutes entre chaque boucle de scan de la file d'attente; le programme scanne la file d'attente, s'il trouve des courriels il les envoie, sinon il se met en pause durant ce temps, jusqu'à la fin de la période indiquée ci-après

  • $periode = 'heure'; => il faut mettre la valeur correspondant à la programmation de la tâche planifiée; heure est conseillé, mais ça peut être "jour" ou "semaine"
  • $cptRet = '90'; => nombre de jours de rétention des fichiers compteurs: le programme cplmailbat enregistre un compteur par heure et jour dans le répertoire compteurs pour cumuler le nombre de courriels envoyés. Au début de chaque appel, il purge les fichiers vieux de plus de ce nombre de jours
  • Les 5 paramètres suivants servent à envoyer les courriels via phpMailer:
    • $smtp[0] = stripslashes('ssl0.ovh.net'); => adresse du serveur SMTP
    • $smtp[1] = stripslashes('on'); => de préférence laisser "on"
    • $smtp[2] = stripslashes('ssl'); => '' ou ssl ou tls à tester suivant votre serveur SMTP
    • $smtp[3] = stripslashes('465'); => N° de port SMTP, dépend du paramètre précédent
    • $smtp[4] = stripslashes('moi@mondomaine.fr'); => Votre adresse mail pour vérifier l'authentification
    • $smtp[5] = stripslashes('xxxxxxxx'); => Votre mot de passe 

Attention : le fichier config.inc doit respecter la syntaxe PHP

Si vous avez déjà utlisé cplMailBat V6.00.02, Vous devez modifier votre fichier /cplmail/config.inc et rajouter les lignes pour phpMailer.

Sur un GuppY V6.00.03, vous devez installer les dernières versions des plugins pour qu'ils fonctionnent. Voir sur "Télécharger", la catégorie "Compatible CPL V6.00.03", la date du paquet est contenue dans son nom.

Sur un GuppY V6.00.09, Vous devez installer CPLcommun V6.00.09a. Vous allez dans la configuration du plugin installez le fork cplMailBatch et dans configuration générale,

  • vous cochez la case "Utiliser le fork cplmailbatch"
  • vous remplissez le champ "Répertoire contenant le fork cplMailBat" ; vous mettez la valeur absolue du chemin du répertoire "cplmail", vous pouvez vous aider de votre utilitaire de FTP pour le connaître, quelque chose comme /home/monidentité/cplmail/

Note de jargon pour s'y retrouver (!?) : cplmailbatch = fork de GuppY; cplMailBat = module qui contrôle les quotas (installé à la racine de l'hébergeur).


Date de création : 21/09/2021 - 18:29
Dernière modification : 07/07/2022 - 11:27
Catégorie : - cplMailBat
Page lue 592 fois