====== Envoyer un courriel ======

Avec le module [[doku>plugin:bureaucracy|Bureaucracy]] il est possible de mettre en place un système d'envoi de courriel.

Le module fonctionne en 3 étapes :
   * Affichage d'un formulaire
   * Validation de la saisie de l'utilisateur
   * Transmission des informations et envoi du courriel.
   
===== Formulaire =====
<WRAP group>
<WRAP half column>
<form>
Fieldset "Envoi d'un courriel"
user "Destinataire"
Textbox "Sujet"
textarea "Message" x10
file "Fichier joint" !
submit "Envoyer"

Action mail @@Destinataire.mail@@
usemailtemplate .:courriel
subject "Les nouvelles en commun"
Thanks "Courriel accepté pour envoi" 
</form>
</WRAP>

<WRAP half column>
Dans ce formulaire
  * Il faut entrer un utilisateur du wiki comme destinataire\\ <wrap info>Il serait possible de saisir une liste d'utilisateur en modifiant le code du formulaire. </wrap>
  * Le sujet est un texte sur une ligne
  * Le message peut-être multi-lignes et comporter des balises HTML.\\ <wrap alert>Il n'est pas possible de faire une mise en forme dans ce champ. D'autre part le rendu dépend du modèle de courriel utilisé. </wrap> 

L'utilisation du bouton ''Envoyer'' valide les données et procède à l'envoi en utilisant le 
[[.:courriel]].
</WRAP>
</WRAP>



===== Code =====
<WRAP group>
<WRAP half column>
<code xml formulaire.txt>
<form>
Fieldset "Envoi d'un courriel"
user "Destinataire"
Textbox "Sujet"
textarea "Message" x10
file "Fichier joint" !
submit "Envoyer"

Action mail @@Destinataire.mail@@
usemailtemplate .:courriel
subject "Les nouvelles en commun"
Thanks "Courriel accepté pour envoi" 
</form>
</code>
</WRAP>

<WRAP half column>
Dans ce formulaire Le champ de type ''user'' pourrait être remplacé par ''users'' pour pouvoir envoyer le message à plusieurs utilisateurs.

Cette information est utilisée comme destination de l'''action mail''.

L'instruction ''useemailtemplate'' permet l'utilisation du [[.:courriel]].

<wrap important>
Le champ ''Sujet'' n'est pas utilisé avec l'instruction ''subject''.\\ Il faudrait corriger la ligne : ''subject @@Sujet@@''
</wrap>


</WRAP>
</WRAP>

===== Limitations =====
Voici une liste de limites qui ne permettent pas d'utiliser le module comme un outil d'envoi de courriel vers les utilisateurs enregistrés du wiki.
  - Il n'est pas possible d'envoyer un courriel à un groupe d'utilisateurs sans saisir ou définir l'ensemble des adresses courriel de ce groupe.
  - L'utilisation d'un modèle permet de formater le message en utilisant du HTML, mais celui-ci ne peut être ni créé facilement, ni rendu automatiquement en texte ou en page wiki. Autrement dit l'usage de ce module est limité à la création de modèles de service par exemple l'envoi d'un lien vers une page du wiki  







<WRAP center round box 95%>


++++ Voir la liste des pages de ce dossier |
<nspages -h1  -exclude -textPages="Pages dans ce dossier" -hideNoPages  -hideNoSubns -actualTitle=4 -nbCol=2>
++++

Retour [[.sommaire]]

</WRAP>