Tags:
email4Add my vote for this tag publish2Add my vote for this tag create new tag
, view all tags

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: http://www.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

ALERT! 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

Topic attachments
I Attachment History Action Size Date Who Comment
Unknown file formatmd5 MailPageAddOn.md5 r4 r3 r2 r1 manage 0.2 K 2007-05-21 - 11:48 WillNorris  
Compressed Zip archivetgz MailPageAddOn.tgz r4 r3 r2 r1 manage 25.9 K 2007-05-21 - 11:47 WillNorris  
Compressed Zip archivezip MailPageAddOn.zip r5 r4 r3 r2 r1 manage 40.6 K 2007-05-21 - 11:47 WillNorris  
Unknown file formatEXT MailPageAddOn_installer r1 manage 30.1 K 2007-05-21 - 11:47 WillNorris  
Edit | Attach | Watch | Print version | History: r13 < r12 < r11 < r10 < r9 | Backlinks | Raw View | Raw edit | More topic actions
Topic revision: r13 - 2007-07-14 - CrawfordCurrie
 
  • Learn about TWiki  
  • Download TWiki
This site is powered by the TWiki collaboration platform Powered by Perl Hosted by OICcam.com Ideas, requests, problems regarding TWiki? Send feedback. Ask community in the support forum.
Copyright © 1999-2016 by the contributing authors. All material on this collaboration platform is the property of the contributing authors.