EmailGenerator is part of the Hula package developed by MahlenMorris. It generates the emails using the NotificationList page. See that page for instructions on what format the program expects.


Enhancements#

What should be different?
  • MahlenMorris: Add ability to override the name of the email sender (i.e., it appears to be sent by, say, "Your Wiki Admin").
  • MahlenMorris: Can still mess up timer if server is down through midnight.
  • MahlenMorris: Need default NotificationList.txt file in distribution.
  • MahlenMorris: If there are no changes, don't report the page. This can happen when the page gets changed back to the way it had been previously.

Problem#

I try to use the EmailGenerator and I resolved the XML parsing problem (described below). But now, when I start the EmailGenerator ./emailgenerator.sh there is no information if the EmailGenerator starts.
The emailgenerator.log is empty and there is no console entry (including error messages).
So I don't know what to do, because I don't receive any mail. --Leif 2007-07-18

Hmm..If I remove the logfilename-entry in the emailgenerator.properties I now get logmessages on the console. Maybe a bug in the logger? Now it works. --Leif 2007-17-18

FAQ#

I try using the Email Generator with either 2.0.52 or 2.1.86 and I run into all sorts of XML parsing problems. Errors range from
  1. Fatal error parsing XML: org.xml.sax.SAXParseException: end tag </HEAD> does not match begin tag <meta>
  2. Fatal error parsing XML: org.xml.sax.SAXParseException: invalid Character Entitiy
  3. Thu Jun 17 15:03:01 MST 2004: Unable to contact server. Exception was: java.io.IOException: String index out of range: 255

I manually fixed many of the XHTML type problems and was left with the last two problems. I suspect I am doing something fundamentally wrong. Suggestions please? Thanks! Sherman Mohler, sherman_mohler@yahoo.com

  • I am getting similar issues...except that they don't refer to tags that exist in the HTML document. I'm unclear as to where to look for the error --MikeCornell

I've solved the fatal error parsing XML problem, here's how.#

(Tomcat 5.5; JSPWiki 2.0.52)

  • Edit the JSPWiki web.xml file, uncommenting the section labelled "uncomment to enable RPC".
  • Make sure you don't have any security restrictions (I made the mistake of putting a login on all pages; this didn't work and I had to change this to just on editing).
  • Restart tomcat
  • Check the URL "http://yoursite/JSPWiki/RPC2/" - you should get "We do not support HTTP GET here. Sorry." which indicates it's running.
  • Edit the hula emailgenerator.properties file and update wiki.url to be "http://yoursite/JSPWiki/RPC2/" as above
  • Create your NotificationList page
  • Start with emailgenerator.sh (nb. on Java 5 on linux I had to recompile EmailGenerator adding a check to ignore blank command-line arguments - bizarre)
  • Check /tmp/emailgenerator.log
-- SteveS
  • I'm running JSPWiki on an internal system and would like to use the emailGenerator? Can I get the code for this? -- RossGardler
    • MahlenMorris You sure can, just got to Hula and pull down the latest, the source should be there. Can't say that I've really put much work into delivering a build system, though...

What happens if I edit RecentChanges? :-) --JanneJalkanen

It should be reported, same as usual. RecentChanges is a code word (set in the properties file) that means "all pages that have changed in the last 24 hours". It doesn't actually look at the RecentChanges page. So i guess that's one limitation in how I've set it up; you can't specifically track changes to just the RecentChanges page. Again, if one were to set the value in the property file differently, you could even do that. --MahlenMorris

Hm. Isn't that keyword redundant? If you just mark no page (i.e. have just your e-mail address on the line), wouldn't it make sense to interpret that as RecentChanges? --JanneJalkanen

I could certainly do that. However, i think we still need the phrase, since otherwise you couldn't say, "I want all pages, but I want special treatment for these others." Plus now you can say RecentChanges!.


DuncanMcGregor -- v 1.7.10 comes with whole heaps of javax.mail stuff. Is their anything we should know on this subject?

JanneJalkanen: Umm... No, not really. 1.7.10 comes accidentally with javax.mail. I happened to have the libraries around when building, so the got included there even though they're not really needed. But you'll need them if you want to use log4j's mailing capability, so it's not that much of a loss =).

DuncanMcGregor -- Except the 2 hours it took to FTP from home ;-). Never mind, they're there now.

ebu: Note that mime-multipart handling requires javax.mail.* and javax.activation.*, so the libraries will be necessary for attachments, too.


No documentation for this important plugin?

--Cosmin, 31-Aug-2006

It's in the package.

Add new attachment

Only authorized users are allowed to upload new attachments.
« This page (revision-58) was last changed on 03-Aug-2011 11:35 by 210.21.227.66