/ 
Kwiki-Notify-Mail-0.02
River stage zero No dependents
/ Kwiki::Notify::Mail

NAME

Kwiki::Notify::Mail - send an email when a page is updated

VERSION

Version 0.02

SYNOPSIS

$ cd /path/to/kwiki
$ kwiki -add Kwiki::Notify::Mail
$ cat config/notify_mail.yaml >> config.yaml
$ edit config.yaml

REQUIRES

This module requires MIME::Lite to send email.

DESCRIPTION

This module allows you to notify yourself by email when some one updates a page. You can specify the To:, From: and Subject: headers, but the email message body is not currently configurable.

A sample email looks like:

Content-Disposition: inline
Content-Length: 52
Content-Transfer-Encoding: binary
Content-Type: text/plain
MIME-Version: 1.0
X-Mailer: MIME::Lite 3.01 (F2.72; B3.01; Q3.01)
Date: Sun, 29 Aug 2004 22:00:31 UT
To: geo_bush@casablanca.gov
From: nobody@countykerry.ir
Subject: Kwiki page update

Kwiki page LotsOfWikiWords edited by AnonymousGnome

Configuration Directives

  • notify_mail_to

    Specify the mail address you are sending to.

  • notify_mail_from

    Specify the address this is apparently from.

  • notify_mail_subject

    Specify a subject line for the mail message. You can make use of sprintf()-type formatting codes (%s is the only one that is relevant). If you put or more %s in the configuration directive it will print out the site title, page name and whom it was edited by. You can can't change the order, however.

    Examples:

    notify_mail_subject: Kwiki was updated

    gives you the Subject: line

    Subject: Kwiki was updated

    If your site title (defined in site_title in config.yaml) was 'ProjectDiscussion', then

    notify_mail_subject: My wiki %s was updated

    gives you the Subject: line

    Subject: My wiki ProjectDiscussion was updated

    Next you can add the page name with a second %s. If the updated page happened to be 'NextWeeksAgenda', the configuration directive

    notify_mail_subject: My wiki %s page %s was updated

    gives you the Subject: line

    Subject: My wiki ProjectDiscussion page NextWeeksAgenda was updated

    Finally, a third %s gives you the name of the person who edited the page:

    notify_mail_subject: My wiki %s page %s was updated by %s

Subject: My wiki ProjectDiscussion page NextWeeksAgenda was updated
by PointyHairedBoss

    The important thing to remember is that you can have either none or one or two or three %s, but you can't change the order. The default value is

    notify_mail_subject: %s wiki page %s updated by %s

    which should be fine for most people.

  • notify_mail_debug

    When set, saves the mail message to /tmp/kwiki_notify_mail.txt instead of sending it.

AUTHOR

James Peregrino, <jperegrino@post.harvard.edu>

ACKNOWLEDGMENTS

The folks at irc::/irc.freenode.net/kwiki, especially alevin and statico. The style of this module has been adapted from statico's Kwiki::Notify::IRC.

BUGS

The subject line configuration relies on sprintf() which doesn't allow you to change the order of what gets printed out.

The debug file is saved to /tmp and should be user configurable. This module was not tested under Windows and certainly /tmp doesn't exist there.

Please report any bugs or feature requests to bug-kwiki-notify-mail@rt.cpan.org, or through the web interface at http://rt.cpan.org. I will be notified, and then you'll automatically be notified of progress on your bug as I make changes.

COPYRIGHT & LICENSE

Copyright 2004 James Peregrino, All Rights Reserved.

This program is free software; you can redistribute it and/or modify it under the same terms as Perl itself.