Icon

Partager Envoyer

(Document)

Communiquer

chora facilite vos communications

  • avec les administrateurs de l'application, grâce au formulaire de contact,
  • entre utilisateurs enregistrés de l'application, grâce à la fonction chat,
  • avec le reste du monde
    • à l'aide de l'interface webmail qui permet d'utiliser un compte de messagerie SMTP/IMAP directement dans l'application
    • par la création et la diffusion d'événements publics, avec une gestion des participants (organisation de réunion)
    • par la création de groupes d'abonnements et l'utilisation de modèles de messages email (lettres d'informations)
    • grâce à une file d'envoi de messages unique qui autorise l'expédition, la réexpédition et le suivi des envois d'email (texte ou html) et de messages SMS.

Vous pouvez également consulter la documentation disponible pour partager les données enregistrées dans l'application.
 

Événements publics

A écrire
 

Groupes d'abonnés

Une gestion sommaire des groupes d'abonnés est accessible dans la rubrique Gestion » Application du menu haut, puis dans le menu gauche, Communications » Abonnements.

Un groupe d'abonnés est un identifiant (un nombre entier unique), qu'il faut ensuite associer à un libellé spécial dans l'interface d''internationalisation (Accueil » Gérer » Interface utilisateurs » Internationalisation) ou directement dans les fichiers de langue de l'application.

Voici un exemple de la définition du libellé d'un groupe d'abonnés, pris dans un des fichiers de langue :
$lang['signup_opt2']='offres commerciales ';

signup_opt<identifiant entier du groupe> est la clé qui identifie le libellé du groupe (ici Offres commerciales est le libellé associé au groupe 2).

Si votre site est disponible dans plusieurs langues, cette clé devra être associée à une traduction pour chaque langue.

La création d'une telle clé suffit à créer un groupe d'abonnés.

Elle sera transmise à la méthode translate() de la bibliothèque des formats pour pouvoir afficher le libellé dans la langue de l'utilisateur :
echo $this->formats->translate('signup_opt2'); ).

Une fois créé, un groupe d'abonnés peut accueillir de nouvelles adresses email, soit à partir de l'interface de gestion (Communications » Abonnements), soit à partir du composant Recevez nos informations, présent dans le cas d'une installation par défaut sur la page d'accueil de votre site, juste avant le pied-de-page.

Notez qu'à l'heure actuelle, seules des adresses email peuvent être ajoutées aux groupes d'abonnés.
 

Envoi d'une lettre d'informations

Pour créer une lettre d'informations, il faut commencer par préparer un modèle de message email (Gérer » Communications » Modèles de messages). Pour chaque modèle de message créé, il est possible de sélectionner un groupe d'abonnés destinataire (ou d'ajouter une liste d'adresses email destinataires).

Si un message doit être envoyé à plusieurs groupes, il suffit de cloner le modèle du message, puis de changer le groupe destinataire de la copie ainsi créée.

L'ajout d'un modèle de message à la file d'envoi (pour programmer son envoi) se fait en cliquant sur le bouton Envoyer qui lui est associé dans l'interface.
 

File d'envoi de messages

La file d'envoi de messages est accessible à partir de la rubrique Gestion » Application dans le menu haut, puis dans le menu gauche, Communications » File d'envoi.

Celle-ci accueille en principe tous les messages email ou SMS qui sont générés ou envoyés à partir de l'application (y compris les messages générés automatiquement, tels que ceux concernant un changement de mot de passe), à l'exception notable des messages envoyés depuis un compte de messagerie privé (pour des raisons de confidentialité).

Notez qu'un même message envoyé à plusieurs destinataires sera dupliqué dans la file autant de fois qu'il y a de destinataires différents dans la file, ce qui permet le suivi de chaque expédition.
 

Traitement des envois

L'exécution des envois de manière automatique se fait par l'ajout de la commande d'expédition à un planificateur de taches (par exemple, en crontab sous Un*x/Linux) :
 

#minute (0-59)
#|   hour (0-23)
#|   |    day of the month (1-31)
#|   |    |   month of the year (1-12)
#|   |    |   |   day of the week (0-6 with 0=Sun)
#|   |    |   |   |   commands
#|   |    |   |   |   |
#                     Send pending emails each 2 minutes.
*/2  *    *   *   *   php /usr/local/www/webapp/index.php EmailQueue/send_queue
#                     Resend failed emails each 5 minutes.
*/5  *    *   *   *   php /usr/local/www/webapp/index.php EmailQueue/retry_queue

Vous pouvez également exécuter sur le serveur (en ligne de commandes) :
 

php <chemin vers la racine de votre installation>/index.php EmailQueue/send_queue <domaine HTTP>
php <chemin vers la racine de votre installation>/index.php EmailQueue/retry_queue <domaine HTTP>

Ces commandes ont pour effet d'envoyer respectivement les message dont le statut est égal à pending/en attente et ceux dont le statut est égal à error/en erreur. Notez que cela n'a de sens que si le traitement des envois n'a pas été automatisé ou bien s'il est désactivé (par exemple pour des tests).

Important : dans le cas d'une installation multisites, vous devez transmettre ainsi le nom du domaine pour lequel il faut effectuer l'opération en second paramètre.

Alternativement, il est aussi possible d'effectuer ces actions directement à partir de l'interface de gestion de la file d'envoi, en cliquant sur Envoyer les messages en attente ou sur Renvoyer les messages en erreur.

Deux scripts à exécuter sur le serveur en ligne de commandes pour effectuer la première de ces opérations sont fournis à titre d'exemple dans /application/ :


email_queue.bat <domaine http>

email_queue.sh <domaine http>

Statut des messages

Les status disponibles pour les messages enregistrés dans la file sont :
pending : en attente d'expédition
sending : en cours d'envoi
sent : envoyé
error : en erreur
delivered : arrivé à destination (seulement lorsqu'un accusé ou suivi est disponible, comme dans le cas des envois de SMS)

Pour effectuer à nouveau l'envoi d'un message, il suffit de modifier son statut vers pending/en attente.

Accès à un compte de messagerie IMAP/SMTP

Veuillez noter que cette fonction est expérimentale et ne devrait pas être activée sur un site en accès public pour des raisons de sécurité. Dans la version actuelle, un utilisateur ne peut avoir accès qu'à un seul compte IMAP.

Optionnellement, il est possible de configurer un compte de messagerie IMAP/SMTP pour les utilisateurs de l'application : chaque compte de messagerie doit être configuré séparément et ensuite associé à un ou plusieurs comptes d'utilisateurs de l'application. Ces opérations requièrent des droits de superutilisateur et s'effectuent à partir de l'interface de gestion des comptes d'utilisateurs (Gérer » Comptes d'utilisateurs).

Les paramètres suivants doivent être définis pour chaque compte :

Boîtes de messagerie (protocole IMAP uniquement)
—Serveur hôte IMAP (généralement, mail.domaine.tld)
—Port (généralement, 143 ou 993)
—Type de cryptage (TLS ou SSL : TLS est fortement recommandé)
—login IMAP (généralement, une adresse email)
—mot de passe IMAP

Envoi de messages email (protocole SMTP uniquement)

—Serveur hôte SMTP (généralement, mail.domaine.tld)
—Port (généralement, 25 ou 587)
—Type de cryptage (TLS ou SSL : TLS est fortement recommandé)
—login SMTP(généralement, une adresse email)
—mot de passe SMTP
—signature email (un texte ou code HTML qui sera ajouté comme signature à la fin des messages que vous expédiez)

Les utilisateurs qui ont accès à un compte IMAP peuvent en parcourir les dossiers, effectuer une recherche dans le texte des messages d'un dossier, afficher un message, afficher le fil de discussion d'un message, télécharger les pièces jointes, déplacer des messages dans la corbeille, vider la corbeille et enfin, importer un message dans l'application.

Les fonctions suivantes sont prévues mais ne sont pas encore disponibles dans l'interface : créer un dossier, supprimer un dossier, déplacer un message vers un autre dossier, la sélection multiple de messages et la recherche multicritères dans les messages.

L'import d'un message se fait en choisissant le type de contenu (datatype) et la collection cible.
Les messages importés deviennent des contenus à part entière de la collection cible. Les pièces jointes sont automatiquement converties en fichiers attachés.

Les utilisateurs qui ont accès à un compte SMTP peuvent rédiger et envoyer un message, répondre à un message ou transférer un message existant. Dans tous les cas, le message envoyé est copié dans le dossier des messages envoyés de leur messagerie (normalement Sent).


Ce document a été publié le 2018-12-28 18:01:40. (Dernière mise à jour : 2019-07-27 09:41:15.)




This website uses 'cookies' to enhance user experience and provide authentification. You may change which cookies are set at any time by clicking on more info. Accept
x