version=pmwiki-2.1.11 ordered=1 urlencoded=1
agent=Mozilla/5.0 (Windows; U; Windows NT 5.1; fr; rv:1.8.0.4) Gecko/20060508 Firefox/1.5.0.4
author=PRZ
csum=
ctime=1149869003
host=89.83.231.153
name=PmWikiFr.Notify
rev=9
targets=PmWikiFr.LocalCustomizations,PmWikiFr.WikiTrails,PmWikiFr.Variables,PmWikiFr.IndexDocAdmin
text=(:nolinkwikiwords:)%0a(:title Notification par courriel:)%0a%25audience%25 administrateurs (basique)%0a%0aLe script ''notify.php'' permet à un administrateur de site d'envoyer des messages e-mail lorsque des changements se produisent sur les pages d'un site wiki.%0aLes notifications par e-mail peuvent être configurées de manière à ce que de multiples changements de page sur une courte période soient regroupés en un unique message e-mail (pour éviter de saturer les boîtes à mail).%0a%0aCette fonctionnalité est utile pour les sites et les pages qui sont mis à jour peu fréquemment, ceci évite d'avoir à consulter fréquemment les pages de "changements récents" (`ModifsDuGroupe `ToutesLesModifs `RecentChanges `AllRecentChanges) juste pour voir si quelque chose a changé.%0a%0aPour faire fonctionner les notifications, le script ''notify.php'' doit être activé dans la [[LocalCustomizations|+]]. Habituellement, cela se résume simplement à placer dans ''local/config.php'' la ligne suivante :%0a%0a    $EnableNotify = 1;%0a%0aUne fois activé, le système de notification se configure depuis la page Site.NotifyList. Cette page contient des entrées de la forme suivante:%0a%0a    notify=alice@example.com%0a%0aCeci signifie que l'information des changements de page doit être envoyée périodiquement par e-mail à ''alice@example.com''. La page Site.NotifyList peut contenir plusieurs lignes "notify=" causant l'envoi des notifications à de multiples adresses.%0a%0aUn certain nombre d'options existent pour limiter les pages prises en compte lors d'une notification. Les paramètres [@group=@] et [@name=@] peuvent être utilisés pour restreindre les notifications à certains groupes ou certaines pages.%0a%0a    # Envoie les notifications du groupe Main à  alice@example.com%0a    notify=alice@example.com group=Main%0a%0a    # Avertit bob@example.com de tous les changements de la page Home%0a    notify=bob@example.com name=Main.HomePage%0a%0a    # Avertit charles@example.com de tous les changements de page%0a    # sauf celles de groupe Main%0a    notify=charles@example.com group=-Main%0a%0aPour maintenir des listes arbitraires de pages, c'est à dire des "listes de surveillance" ("watchlists"), il est généralement plus facile de créer un [[trail -> WikiTrails]] des pages à surveiller. L'entrée suivante dans la page Site.NotifyList provoquera l'envoi d'un email contenant tous les changements des  pages listées dans le trail situé sur la  page Profiles.ALice:%0a   %0a    # Informe Alice des changements des pages listées dans Profiles.Alice%0a    notify=alice@example.com trail=Profiles.Alice %0a%0aNotez qu'une fois cette entrée ajoutée dans Site.NotifyList, Alice peut facilement changer sa liste de surveillance en éditant la page Profiles.Alice sans avoir besoin d'éditer la page Site.NotifyList. Et plus particulièrement cela signifie  qu'un administrateur peut restreindre l'édition de  Site.NotifyList, et néanmoins autorise des individus à maintenir des listes de surveillance personnalisées dans d'autres pages.%0a%0aC'est probablement le bon endroit pour signaler que l'accés en éditon à la page  Site.NotifyList devrait être vérouillée, autrement des personnes mal intentionnées pourraient utiliser la capacité des notifications pour saturer les boîtes de courrier électronique d'autres personnes. Par défaut,  Site.Notify est bloqué en édition excepté pour l'administrateur (admin) ( aussi est-ce le cas pour la plus part des pages du groupe Site). Il peut être utile également de mettre en place en mot de passe en lecture afin d'empêcher les spammeurs de récolter les adresses e-mail.%0a%0a!! Contrôler la fréquence des notifications%0a%0aPour prévenir la saturation des boîtes à mail des destinataires, le scripte de notification utilise un paramètre "squelch" indiquant la durée minimum d'intervalle entre deux envois d'e-mail à une adresse donnée. La valeur par défaut du paramètre "squelch" est 10800 (trois heures), ce qui signifie qu'une fois qu'un message est envoyé à l'adresse d'un destinataire, aucun autre message ne lui sera envoyé avant au moins trois heures. Toutes les éditions qui se produisent durant l'intervalle de temps spécifié par "squelch", sont mises en attente pour le prochain message de notification.%0a%0aL'administrateur peut changer l'intervalle "squelch" par défaut  via le paramètre $NotifySquelch%0a%0a    # active les notifications%0a    $EnableNotify = 1;%0a    $NotifySquelch = 86400;  # attendre au moins un jour entre notifications%0a%0aDe plus, chaque adresse peut individuellement spécifier un paramètre squelch personnalisé dans la page Site.NotifyList:%0a%0a    # Alice reçoit au plus un mail par jour%0a    notify=alice@example.com squelch=86400%0a%0a    # Bob peut être averti des changements toutes les heures%0a    notify=bob@example.com trail=Profiles.Bob squelch=3600%0a%0a    # Charles utilise l'intervalle squelch du site par défaut%0a    notify=charles@example.com %0a%0aParcequ'une page reçoit successivement souvent plusieurs modifications rapides (par ex, une long envoi suivi de plusieurs ré-éditions mineures), un administrateur de site peut également paramètrer la valeur de $NotifyDelay qui spécifie le temps d'attente entre l'édition initiale et l'envoi de la notification:%0a %0a    # active les notifications%0a    $EnableNotify = 1;%0a    $NotifySquelch = 86400; # attendre au moins un jour entre notifications%0a    $NotifyDelay = 300;     # attendre 5 minutes après l'édition initiale%0a%0aNotez que les valeurs de $NotifySquelch et $NotifyDelay indique des minimums. Les notifications sont envoyées à la première exécution de PmWiki après que la période de délais soit expirée. Pour les sites inactifs, cette période peut être beaucoup plus longue que la durée du délais minimum.%0aCeci n'est pas vraiment un problème car les notifications opportunes sont moins importantes sur des sites relativement inactifs. (Les sites à forte activité reçoivent généralement les notifications au bon moment).%0a%0a!!Note pour les installations Windows.%0a%0aLes sites dont PHP fonctionne sous Windows peuvent ne pas avoir leur fontion PHP [[http://www.php.net/mail | mail]] correctement configurée. De tels sites devront ajouter une ligne comme :%0a%0a    ini_set('SMTP','smtp.server.com');%0a%0aà leur fichier ''config.php'', où ''smtp.server.com'' est le nom de votre serveur de courrier sortant préféré de votre hébergement.%0a%0a!![[#variables]] Variables pour les notifications%0a%0a%3c%3c|[[Variables]]|>>%0a%0a:$EnableNotify:indique à ''stdconfig.php'' d'activer le scripte de notification.%0a     $EnableNotify = 1;     # active les notifications%0a     $EnableNotify = 0;     # désactive les notifications%0a%0a:$NotifyFrom:Adresse e-mail de retour utilisée dans le message envoyé.%0a     $NotifyFrom = 'wiki@example.com';%0a     $NotifyFrom = 'Wiki server %3cwiki@example.com>';%0a%0a:$NotifyDelay: La durée (en secondes) d'attente avant l'envoi après le premier changement détecté. Par défaut à 0, les modifications du site sont signalées dès que la période du délais "squelch" est expirée.%0a     $NotifyDelay = 300;    # send mail 5+ min after first post%0a%0a:$NotifySquelch:La durée minimum (en secondes) entre l'envoi de chaque message. Utile lorsque $NotifyDelay est configuré avec une valeur faible pour conserver un nombre bas de messages de notifications. Par défaut à 10800 (trois heures). Chaque destinataire peut écrasée cette valeur dans la page Site.NotifyList.%0a%0a     $NotifySquelch = 43200; # attendre 12+ heures entre chaque message%0a%0a:$NotifyItemFmt:Le text à envoyer pour chaque modification du site. La chaîne "$PostTime" est remplacée par la date du changement (contrôlé par $NotifyTimeFmt ci-dessous).%0a     # Par défaut%0a     $NotifyItemFmt = ' * $FullName ... $PostTime by $Author';%0a     # inclure l'URL de la page dans le messsage%0a     $NotifyItemFmt = " * \$FullName ... \$PostTime by \$Author\n \$PageUrl";%0a%0a:$NotifyTimeFmt:Le format pour les dates/heures de $PostTime ci-dessus. Par défaut  est égal à la valeur de $TimeFmt.%0a     $NotifyTimeFmt = '%25Y-%25m-%25d %25H:%25M';  # 2004-03-20 17:44%0a%0a:$NotifyBodyFmt:Le corps du message à envoyer. La chaîne "$NotifyItems" est remplacé avec la liste des modifications (mises au format par $NotifyItemFmt ci-dessus).%0a%0a:$NotifySubjectFmt:La ligne de sujet du mail à envoyer. %0a%0a:$NotifyHeaders:Chaîne pour des en-têtes (hearders) de mail supplémentaires à passer à la fonction mail().%0a%0a:$NotifyParameters:Chaîne de paramètres additionnels à passer à la fonction PHP mail() [[http://www.php.net/mail|#]].%0a%0a:$NotifyFile:Le fichier tampon où est conservée la trace des récentes modifications. Par défaut à @@[="$WikiDir/.notifylist"=]@@. Notez que généralement ce fichier doit être accessible en écriture par le processus du serveur web.  %0a%0a:$NotifyListPageFmt:Le nom de la page contenant  les lignes [@notify=@] utilisées par ''notify.php''. Par défaut à [@{$SiteGroup}.NotifyList@].%0a%0a:$NotifyList:Un tableau de paramètres [@notify=@] qui peut être spécifié à partir d'un fichier local de configuration personnelle (utilisé en plus des entrées de Site.NotifyList).%0a     # Avertir alice@example.com%0a     $NotifyList[] = 'notify=alice@example.com'%0a%0a%25trail%25 %3c%3c|[[IndexDocAdmin]]|>>%0a%0a
time=1150315039
title=Notification par courriel