Thanks to all who attended the Carousel of Tools - Mailtool session on Thursday afternoon. I know it must have been tempting to nap after that great lunch we had.
As promised, I'm passing on the configuration instructions for the MailTool from Steve Githens' blog.
******************************************************************************************************************
This tool has a number of configuration parameters that show up when you are adding it to a page:
recipview = this must be "role", "user", "tree", "sidebyside", or "foothill". It dictates how recipients are chosen.
displayvalidemailaddrs = This should be "yes" or "no". Displays users in system with invalid emails on the confirmation page.
subjectprefix = Whatever text you enter here will be appended to the subject of every message sent. You can leave this blank to leave people's subjects the way they are.
Currently you can specify up to 10 roles to send mail to. If you don't need 10, leave the extra ones blank. The parameters look as follows:
role1realmid = The Actual ID for the realm that this role will be drawn from, usually something like "/site/chem101¿
role1id = The Actual Sakai ID for the role. Let's call it 'instructors'. You could also use 'access' and 'maintain' as those are usually created for every site realm.
role1singular = This is the singular version of how you would actually communicate the role. ex. 'Instructor'
role1plural = This is the plural version, ex 'Instructors'. These will be used for labeling the tool page.
emailarchive = This identifies where the emailarchive content is stored. It is in the format: "/mailarchive/channel/chem101/main" (where chem101 is your site id)
These follow for roles 2 thru 10.
Below is an example of an actual mailtool configuration from our Sakai implementation at Yale University:
Configuration:
role1id = student
role7plural = Auditors
role6plural = Librarians
displayinvalidemailaddrs = yes
role6singular = Librarian
role3id = grader
role3singular = Grader
recipview = foothill
role1singular = Student
role5id = instructor
role7realmid = /site/1111002984471-45
role2realmid = /site/1111002984471-45
role5realmid = /site/1111002984471-45
role3realmid = /site/1111002984471-45
role7id = auditor
role2plural = TFs
role1plural = Students
role2id = tf
role7singular = Auditor
role5singular = Instructor
role4id = shopper
role4singular = Shopper
role5plural = Instructors
role2singular = TF
emailarchive = /mailarchive/channel/1111002984471-45/main
role4plural = Shoppers
role1realmid = /site/1111002984471-45
role6realmid = /site/1111002984471-45
role3plural = Graders
role4realmid = /site/1111002984471-45
role6id = librarian
mail.newlock.siteid = /site/1111002984471-45
subjectprefix = From ABOUT101
Layout Hints: 0,0