PromoWiki | Mail Benachrichtigung

noch zu übersetzen Versuch einer Übersetzung vom 2005-05-23

The mailposts.php script allows a site administrator to configure PmWiki to send email messages whenever pages are changed on the wiki site. MailPosts can be configured so that multiple page changes over a short period of time are combined into a single email message (to avoid flooding a mailbox).

DE
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.

The MailPosts feature is especially useful for sites that have infrequent updates, eliminating the need to frequently check RecentChanges pages just to see if anything has changed.

DE
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.

Full configuration details are available in scripts/mailposts.php, but here's the brief synopsis of what needs to go in config.php or a per-group customization script for MailPosts:

DE
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;                   # to enable mailposts
 $MailPostsTo="somebody@example.com";  # where to send mail 
 $MailPostsDelay=1800;                 # wait 30+ min after initial post
 $MailPostsSquelch=7200;               # require 2+ hours between mails


 $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.)

Note that $MailPostsTo may be a comma-separated list of addresses if multiple recipients are desired.

DE
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.

Since an initial post is often followed by several posts containing minor edits, it's useful to wait a short period of time before sending an email. $MailPostsDelay is the minimum amount of time that must elapse from an initial post before a message is sent. Any additional posts occuring during the delay period are included in the message when it is sent. The message is sent on the first execution of pmwiki.php after the delay period has expired (which for inactive sites could be much longer than the delay period). A delay of zero means to immediately send a message whenever an update is received.

 $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 specifies the minimum amount of time that must elapse before sending another notification message. This is useful to prevent large number of rapid-succession messages if $MailPostsDelay is set to a small value.

$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.

The defaults for $MailPostsDelay and $MailPostsSquelch are 0 and 7200. With these values, an email is sent as soon as a page is changed, and subsequent changes are "held" for at least two hours before being sent in another message.

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.

The variables used to control MailPosts are given below, and also described in the mailposts.php script.

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

Note for Windows installations

!!!Wichtig für Windowsinstallationen

Sites running PHP under Windows may not have PHP's mail function configured correctly. Such sites may need to add a line like

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

to config.php, where smtp.server.com is the name of your host's preferred outgoing mail server.

Oftmals sind die Mail-Funktionen von PHP-Engines aud 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 Mailservers.

MailPosts Variables

MailPosts Variablen

<< | Variablen ? | >>

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

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

$MailPostsTo: Eine durch Komme 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.

<< | PmWikiDe.DokumentationsIndex | >>