Mail Page Add-On

MailPageAddOn provides users several options for emailing TWiki topics to a friend including:

• Including the actual html topic text in the body of the email. (Actually sends the "print" view of the page.)
• Including the html topic as an attachment.
• Simply sending a link to the page.

This feature request was discussed in TWiki:Codev.EmailThisPageLink. The add on is based on a OS, free script called Mailpage. This is the best script of it's kind that I've found because it offers the option to send page in body of email (in html), as attachment, or simply a link.

Oddly enough, the home page for the script (http://mtvwebdesign.hypermart.net/) has been defunct for some time. However, the original script package can be downloaded from http://www.evidence.info/general/mailpage.html.

Usage

• After installing the MailPageAddOn as described below, the following link will invoke the Mail page dialog: https://twiki.org/cgi-bin/oops/Plugins/MailPageAddOn?template=mailpage .
• When a users clicks on the Email this Page!, they get a form that allows them to enter the name and email address of the receipient and sender, along with a note.
• If you want this feature available to all topics, you can add it to the "view" template of your favorite skin.

Add-On Installation Instructions

Note: You do not need to install anything on the browser to use this add-on. The following instructions are for the administrator who installs the add-on on the server where TWiki is running.

• Download the ZIP file from the Add-on Home (see below)
• Unzip MailPageAddOn.zip in your twiki installation directory. Content:

  File:	Description:
  data/TWiki/MailPageAddOn.txt	Add-on topic
  bin/mailpage/mailpage.cgi	Add-on script (Modified - see note)
  bin/mailpage/mailpage.conf	Add-on script
  bin/mailpage/mtvwebdesign.lib	Script library
  bin/mailpage/privacy.txt	Privacy statement
  bin/mailpage/readme.html	Mailpage readme file
  bin/mailpage/tokenfile.html	Custom template for mailpage (unused)
  templates/mailpage.pattern.tmpl	TWiki mailpage template for PatternSkin (default)
  templates/mailpage.tmpl	TWiki mailpage fallback template for other skins

• Edit the mailpage.conf file to match your site, as described in the readme file.
• Test if the installation was successful:
  • Click on Email this Page! and you will be presented with a mailpage form. Fill in the form and click the "Send" button - and then check if the email was sent and were properly formatted.

Add-On Info

Note: This distribution includes a slightly modified version of the Mailpage.cgi script so that when you send the topic in the body of the email message, the "print" view of the topic is sent. Line 206 or mailpage.cgi has been edited to read as follows:

• $req = new HTTP::Request 'GET' => $FORM{'url'}."?template=viewprint"; (Shipped default, TWiki:Codev.TWikiRelease04x00x02 and later)
• $req = new HTTP::Request 'GET' => $FORM{'url'}."?skin=print.pattern"; (Manually change the line into this for earlier releases)

Add-on Author:	TWiki:Main/LynnwoodBrown
Add-on Version:	21 May 2007 (v1.11)
Change History:
21 May 2007	Bugs:Item3969 - 8bit email fix (TWiki:Main.WillNorris)
2 Aug 2006	(v1.10): Templates never added to distribution archive correctly (TWiki:Main.SteffenPoulsen)
8 Apr 2006	Minor update for TWiki:Codev.TWikiRelease04x00x02, TWiki oops templates added (TWiki:Main.SteffenPoulsen)
18 Jan 2005	Initial version
CPAN Dependencies:	CPAN:LWP::UserAgent
Other Dependencies:	none
Perl Version:	5.005
License:	GPL
Add-on Home:	http://TWiki.org/cgi-bin/view/Plugins/MailPageAddOn
Feedback:	http://TWiki.org/cgi-bin/view/Plugins/MailPageAddOnDev
Appraisal:	http://TWiki.org/cgi-bin/view/Plugins/MailPageAddOnAppraisal

Related Topics: TWikiPreferences, TWikiPlugins

-- TWiki:Main/LynnwoodBrown - 18 Jan 2005