Du bist hier: PmWikiDe >> E-Mail Nachricht bei geÃ¤nderten Seiten

E-Mail Nachricht bei geÃ¤nderten Seiten

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

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 MailPosts 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 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 >>

$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';  # Samstag, 20 März 2004 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.

<< | Dokumentationsindex | >>