Budo-Lexikon | PmWikiDe / E-Mail Nachricht bei geänderten Seiten

Autoren (Fortgeschrittene) (deutsche Übersetzung der Seite PmWiki.MailPosts ?, Stand 2006-10-17)

Hinweis

Nach Aussagen der aktuellen englishen Seite wurde mailposts ab der Version 2.1.7 durch notify ersetzt, welches eine bessere und umfangreichere Funktionalität hat. Dieses Script ist jedoch in allen aktuellen Versionen (bis 2.2.0) noch enthalten und kann weiterhin eingesetzt werden. --Stephan Schwarzbold ? 17.10.2006 21:55 Uhr
auch in 2.2.0-beta63 kann man Mail Posts aus einer früheren Version reinkopieren, es braucht dann aber noch den entsprechenden Eintrag in stdconfig.php. Wer Notify in 2.2.0-beta63 nicht zum Laufen bekommt, nimm eins aus einer anderen Version

Die Scripteinstellungen in der Datei mailposts.php macht es dem Administrator möglich Pm Wiki so zu konfigurieren, das es per E-Mail über Änderungen der Seite informiert. Dabei kann Mail Posts 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 Recent Changes ? 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 Mail Posts 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.

Mail Posts Variablen

<< Sonstige Variablen ? | Variables | Funktionen >>

%apply=item id=Enable Mail Posts ?%$EnableMailPosts: Ruft stdconfig.php auf, um das Mail Posts Script abzuarbeiten.

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

%apply=item id=Mail Posts To ?%$MailPostsTo: Eine durch Komma getrennte Liste der Mail-Empfänger.

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

%apply=item id=Mail Posts From ?%$MailPostsFrom: Die Antwortadresse, welche in der Mail eingetragen wird.

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

%apply=item id=Mail Posts Delay ?%$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

%apply=item id=Mail Posts Squelch ?%$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

%apply=item id=Mail Posts Item Fmt ?%$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';

%apply=item id=Mail Posts Time Fmt ?%$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

%apply=item id=Mail Posts Message ?%$MailPostsMessage: Der zu sendende Textkörper. Die Variable "$MailPostsList" wird ersetzt durch die Liste der Postings (welche durch $MailPostsItemFmt (oben) formatiert ist).
%apply=item id=Mail Posts Subject ?%$MailPostsSubject: Die Betreffzeile der Mail.
%apply=item id=Mail Posts Headers ?%$MailPostsHeaders: String für die extra einzufügende E-Mail-Header Zeilen für die mail()-Funktion von PHP.
%apply=item id=Mail Posts Function ?%$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';

%apply=item id=Mail Posts File ?%$MailPostsFile: Die Datei, in der Mail Posts die Liste der erfolgten Änderungen ablegt. Standart ist: "$WikiDir/.mailposts".
Beachte, dass die Datei änderbar für Webserver-Prozesse sein muss.

<< | Dokumentationsindex | >>