E-Mail Nachricht bei ge�nderten Seiten

noch zu �bersetzen
Versuch einer �bersetzung vom 2005-05-23

Die Scripteinstellungen in der Datei mailposts.php macht es dem Administrator m�glich PmWiki so zu konfigurieren, das es per E-Mail �ber �nderungen der Seite informiert. Dabei kann MailPosts so eingestellt werden, dass es mehere Seiten�nderungen innerhalb k�rzester Zeit in einer Mail zusammenfasst, damit das Zielpostfach nicht �berl�uft.

Durch die E-Mail-Benachrichtigung ist es (besonders bei unregelm��ig aktualisierten Seiten) nicht mehr notwendig regelm��ig die RecentChanges auf �nderungen auf der Seite zu �berpr�fen.

Alle Einstellungsparameter stehen in scripts/mailposts.php.
Folgende Einstellungen m�ssen jedoch in der config.php bzw. in dem jeweiligen Script der Gruppe eingetragen werden:

 $EnableMailPosts=1;                   # aktivieren von mailposts
 $MailPostsTo="mail@example.com";      # Zieladresse der Benachrichtigung 
 $MailPostsDelay=1800;                 # 30+ min Sendeverz�gerung (in Sek.)
 $MailPostsSquelch=7200;               # mindestens 2+ Stunden zw. den Mails (in Sek.)

ERKL�RUNGEN:

 $MailPostsTo

F�r den Fall, dass die Benachrichtigung an mehrere Empf�nger gesendet werden soll, m�ssen die Adressen mit Komma getrennt werden.

 $MailPostsDelay

Nach einem Posting ist es h�ufig der Fall, dass der Autor noch kleinere Korrekturen an seinem Text vornimmt. Deswegen ist es sinnvoll eine gewisse Zeit nach der letzten �nderung verstreichen zu lassen, bevor die Benachrichtigung gesendet wird.
Die variable $MailPostsDelay gibt also an, welche Zeit (in Sekunden) mindestens verstreichen muss, damit die Mail gesendet wird. Eine weitere �nderung in dieser Zeitspanne wird dieser Benachrichtigungsmail angeh�ngt.
Dabei ist zu beachten, dass die Mail erst mit dem n�chsten Aufruf der pmwiki.php nach verstreichen der Zeit versendet werden kann (bei selten besuchten Seiten kann demnach der Versand stark verz�gert sein).
Eine Zeiteinstellung von Null(0) hat das sofortige versenden der Mail nach einer �nderung zur Folge.

$MailPostsSquelch Beschreibt die Mindestzeitspanne zwischen zwei Benachrichtigungsmails. Diese Variablen kann eingesetzt werden, damit bei geringer Wartezeit durch $MailPostsDelay und einer hohen �nderungsfrequenz, nicht unn�tig viele Mails verschickt werden.

Die Standarteinstellungen f�r $MailPostsDelay und $MailPostsSquelch sind 0 und 7200. mit diesen Einstellungen wird �ber eine Seiten�nderung sofort informiert, jedoch die zu erwartenden kleineren �nderungen werden gesammelt und nach 2h versendet.

Die einsetzbaren Variablen zur Beieinflussung von MailPosts stehen unten und in mailposts.php auf Englisch.

Wichtig f�r MS Windows Installationen

Oftmals sind die Mail-Funktionen von PHP-Engines auf Windowssystemen nicht korrekt konfiguriert. In diesen F�llen muss in die config.php folgende Zeile eingef�gt werden:

    ini_set('SMTP','smtp.server.com');

Dabei ist smtp.server.com die Adresse des versendenden Mailservers.

MailPosts Variablen

<< Sonstige Variablen ? | Variables | Funktionen in PmWiki ? >>

$EnableMailPosts: Ruft stdconfig.php auf, um das MailPosts Script abzuarbeiten.

        $EnableMailPosts = 1;          # aktiviert mailposts
        $EnableMailPosts = 0;          # daktiviert mailposts

$MailPostsTo: Eine durch Komma getrennte Liste der Mail-Empf�nger.

        $MailPostsTo = 'admin@example.com, joe@somewhere.org';

$MailPostsFrom: Die Antwortadresse, welche in der Mail eingetragen wird.

        $MailPostsFrom = 'wiki@example.com';
        $MailPostsFrom = 'Wiki server <wiki@example.com>';

$MailPostsDelay: Die Zeitspanne (in Sekunden), welche gewartet wird, bis die Benachrichtungsmail gesendet wird. Dabei werden alle bis dahin vorgenommenen �nderungen angeh�ngt. Voreinstellung ist Null(0)
Die Nachricht wird jedoch erst versendet, wenn $MailPostsSquelch ebenfalls abegelaufen ist.

        $MailPostsDelay = 360;    # sendet 6+ min nach dem ersten Posting

$MailPostsSquelch: Die Mindestzeitspanne (in Sekunden), welche vergehen muss, bevor die N�chste Benachrichtigung versendet wird. Dies kann eingesetzt werden um bei �nderung schnell informiert zu werden, ohne jedoch bei jeder darauffolgenden unbedeutenden �nderung ebenfalls informiert zu werden. Die Anfallenden �nderungen werden mit der N�chsten Mail versendet. Voreinstellung ist 7200 (2h).

        $MailPostsDelay = 43200;  # wartet 12+h zwischen zwei Mails

$MailPostsItemFmt: Der zu jeder �nderung geh�rende, zu sendende Text. Die Variable "$PostTime" wird mit dem Datum und der Zeit des Postings ersetzt. (gesteuert von $MailPostsTimeFmt (unten)).

        # Voreinstellung:
        $MailPostsItemFmt = ' * $PageName . . . $PostTime by $Author';
        # Einf�gen der URL (Adresse) in die Benachrichtigung:
        $MailPostsItemFmt = '$PageName . . . $PostTime von $Author $PageUrl';

$MailPostsTimeFmt: Das Datums- und Uhrzeitformat f�r $PostTime von oben. Die Voreinstellung ist die Formatierung von $TimeFmt.

        $MailPostsTimeFmt = 'm-H:%M';  # 2004-03-20 17:44

$MailPostsMessage: Der zu sendende Textk�rper. Die Variable "$MailPostsList" wird ersetzt durch die Liste der Postings (welche durch $MailPostsItemFmt (oben) formatiert ist).
$MailPostsSubject: Die Betreffzeile der Mail.
$MailPostsHeaders: String f�r die extra einzuf�gende E-Mail-Header Zeilen f�r die mail()-Funktion von PHP.
$MailPostsFunction: Name der Funktion, die Aufgerufen werden soll um die Mail zu versenden. Als Voreinstellung wird die Standart-mail()-Funtion von PHP genutzt, jedoch ist diese nicht auf allen Systemen korrekt implementiert. Diese Variable kann auf 'MailPostsSendmail' gestellt werden. Diese Funktion liegt in: /usr/lib/sendmail. Der Aufruf lautet:

        # call /usr/lib/sendmail directly instead of using mail()
        $MailPostsFunction = 'MailPostsSendmail';

$MailPostsFile: Die Datei, in der MailPosts die Liste der erfolgten �nderungen ablegt. Standart ist: "$WikiDir/.mailposts".
Beachte, dass die Datei �nderbar f�r Webserver-Prozesse sein muss.

Der Seitenaufbau ist noch nicht ganz gl�cklich und sollte evtl. nocheinmal �berdacht werden. Die Seite ist auch nicht mit aktuellen Version der englischen Seite abgeglichen. Stephan Schwarzbold ? 08.11.2005 09:17 Uhr

<< Problembehebung ? | Dokumentationsindex | Auffinden von vereinsamten und fehlenden Seiten >>