API Newsletter

$subscribe = charger_fonction("subscribe","newsletter");
$subscribe($email, $options);

 * @param $email
 *   champ obligatoire
 * @param array $options
 *   nom : string
 *   listes : array (si non fourni, inscrit a la liste generale 'newsletter')
 *   lang : string
 *   force : bool permet de forcer une inscription sans doubleoptin (passe direct en valide)
 *   graceful : bool permet a contrario de ne pas inscrire quelqu'un qui s'est desabonne (utilise lors de l'import en nombre, l'utilisateur est ignore dans ce cas)
 * @return bool
 *   true si inscrit comme demande, false sinon
 *
 *

$unsubscribe = charger_fonction("unsubscribe","newsletter");
$unsubscribe($email, $options);

 *
 * @param $email
 *   champ obligatoire
 * @param array $options
 *   listes : array
 * @return bool
 *   true si inscrit, false sinon

$subscriber = charger_fonction("subscriber","newsletter");
$subscriber($email);

 *
 * @param $email
 *   champ obligatoire
 * @return bool|array
 *   false si n'existe pas
 *   array :
 *     string email
 *     string nom
 *     array listes
 *     string lang
 *     string status : on|pending|off
 *     string url_unsubscribe : url de desabonnement
 */

$subscribers = charger_fonction("subscribers","newsletter");
$inscrits = $subscribers($listes,$options);

 *
 * @param array $listes
 *   listes de diffusion. 'newsletter' si non precise
 * @param array $options
 *   count : si true renvoyer le nombre de resultats au lieu de la liste (perf issue, permet de tronconner)
 *   limit : ne recuperer qu'un sous ensemble des inscrits "10,20" pour recuperer 20 resultats a partir du 10e (idem SQL)
 * @return int|array
 *   liste d'utilisateurs, chacun decrit par un array dans le meme format que newsletter/subscriber

$lists = charger_fonction("lists","newsletter");
$inscrits = $lists($options);

 *
 * @param array $options
 *   status : filtrer les listes sur le status
 * @return array
 *   listes
 *   chaque liste est decrite par :
 *   id => array(titre=>'','status'=>'')

#FORMULAIRE_NEWSLETTER_SUBSCRIBE

#FORMULAIRE_NEWSLETTER_SUBSCRIBE{nouveautes}

#FORMULAIRE_NEWSLETTER_SUBSCRIBE{newsletter,nouveautes}

#FORMULAIRE_NEWSLETTER_UNSUBSCRIBE

#FORMULAIRE_NEWSLETTER_UNSUBSCRIBE{nouveautes}

#FORMULAIRE_NEWSLETTER_UNSUBSCRIBE{newsletter,nouveautes}

$content = charger_fonction("content","newsletter");
$lettre = $content($id);

 *
 * @param int|string $id
 * @return array|bool
 *   string sujet
 *   string html
 *   string texte

$contextualize = charger_fonction("contextualize","newsletter");
$content2 = $contextualize($content, $context);

 * @param $content
 *   le contenu (html ou texte) de la newsletter
 * @param $context
 *   le contexte des variables
 * @return string
 */

$send = charger_fonction("send","newsletter");
$res = $send($destinataire, $corps, $options);

 *
 * @param array $destinataire
 *   description du destinataire
 *     string email
 *     string nom
 *     array listes
 *     string lang
 *     string status : on|pending|off
 *     string url_unsubscribe : url de desabonnement
 *
 * @param array|string $corps
 *   string id de la newsletter
 *ou array contenu de la newsletter
 *     string sujet
 *     string html
 *     string texte
 *     string from : email de l'envoyeur
 *     string nom_envoyeur : un nom d'envoyeur pour compléter l'email from
 *     string cc : destinataires en copie conforme
 *     string bcc : destinataires en copie conforme cachee
 *     string|array repondre_a : une ou plusieurs adresses a qui repondre
 *
 * @param array $options
 *   options d'envoi
 *     bool test : mode test (ajoute un [TEST] dans le sujet
 *     string tracking_id
 *
 * @return string|int
 *   vide si ok, ou message d'erreur sinon

$bulkstart = charger_fonction("bulkstart","newsletter");
$res = $bulkstart($corps, $listes, $options);

 * 
 * @param string|array $corps
 *   string id de la newsletter a envoyer en lot
 *ou array contenu a envoyer
 *     string sujet
 *     string html
 *     string texte
 * @param array $listes
 *   listes a qui on envoie (1 ou ++)
 * @param array $options
 *   string statut : statut par defaut
 * @return int
 *   0 si echec ou id de l'envoi sinon

$feedback = charger_fonction("feedback","newsletter");
$feedback($quoi, $email, $tracking_id);

 * 
 * @param string $quoi
 *   open : l'email a ete ouvert
 *   clic : un lien a ete clique
 *   soft_bounce : refus temporaire pour cause de boite mail pleine ou autre
 *   hard_bounce : adresse foireuse, refus definitif
 *   reject : email rejete
 *   spam : email taggue en spam
 * @param $email
 * @param $tracking_id

#FORMULAIRE_NEWSLETTER_SEND{#ID_NEWSLETTER}

[(#REM) En mode test : ]
#FORMULAIRE_NEWSLETTER_SEND{#ID_NEWSLETTER,' '}