jwma Documentation [Configuration]

*jwma Configuration - jwma.properties Specification*

Main \| Deployment \| Configuration \| Architecture \| Development \| Screenshots \| SF Project Site
Index \| jwma.properties Specs \| textproc.properties Specs \| Preferences Template

General Remarks

Below you can find tables describing the properties of the jwma.properties file. jwma comes with an annotated properties file which you can find here:

jwma.properties (standard HEAD version from CVS)

Administration settings

Property	Description	Default
jwma.admin.enabled	True if the admin part should be enabled, false otherwise.	`true`
jwma.admin.username	Username of the administrator login.	`admin`

Accounts related settings

Property	Description	Default
jwma.account.creation.enabled	True if jwma should create a jwma user account automatically, false otherwise. This does not affect in any form the existance of an account of the IMAPD.	`true`
jwma.account.creation.view	The view that will be presented to the user, when there is no account.	`firsttime`

i18n settings

Property	Description	Default
jwma.i18n.systemlanguage	The language that will be used by the system (logs for example)	`en`
jwma.i18n.languages	A comma seperated list of available translations.*	`en,es,de`

* Note: the first language in the list will be used as default, in this case en (respectively English).

Postoffice settings

Property	Description	Default
jwma.postoffice.protocol	Protocol of the post office host.Only IMAP is supported.	`imap`
jwma.postoffice.host	Name of the postoffice service host. (localhost is translated to the primary dns name)	`localhost`
jwma.postoffice.port	Port the postoffice service is listening to.	`143`
jwma.postoffice.allowoverride	True if the postoffice host can be given when logging in, false otherwise.	`false`
jwma.postoffice.type	The type of postoffice you are using, i.e. defines if mixed mode folders exist in the store. Mixed folders are folders that can hold messages and subfolders at once. If this value is set to anything else but the case insensitive mixed, then jwma assumes that your postoffice is UW style (folders and mailboxes). For more information, see the IMAP related document.	`mixed`
jwma.postoffice.secure	Use a secure connection to the postoffice service.	`false`
jwma.postoffice.securesocketfactory	The factory to be used for the secure connection.

Mail transport settings

Property	Description	Default
jwma.mailtransport.protocol	Protocol of the mail transport host. Only SMTP is supported at the moment.	`smtp`
jwma.mailtransport.host	Name of the mail transport service host. (localhost is translated to the primary dns name)	`localhost`
jwma.mailtransport.port	Port of the mail transport agent service.	`25`
jwma.mailtransport.authenticated	Determines if the mail transport service will be used authenticated or not. When set to true, jwma will authenticate the user with the same credentials as used for the postoffice host.	`false`
jwma.mailtransport.maxsize	Maximum size of mail's send via jwma (in kB).	`1024`

Logging configuration

Property	Description	Default
jwma.log4j.properties	Name of the log4j properties to be used for log4j based logging.	`log4j.properties`

Processing configuration

Property	Description	Default
jwma.processing.properties	The properties file that holds the configuration for the jtextproc Kernel and framework.	`textproc.properties`
jwma.processing.defaultpipe	The standard pipe (`Processor`) used for processing `plain/text` messages.	`cleanmessage`

Plugin configuration

Property	Description	Default
jwma.plugin.preferencespersistence	The fully qualified name of the class file that implements the `PerferencePersistencePlugin` interface.	`dtw.webmail.plugin.std.CastorXMLPreferences`
jwma.plugin.contactmanagement	The fully qualified name of the class file that implements the `ContactManagementPlugin` interface.	`dtw.webmail.plugin.std.CastorXMLContactManagement`
jwma.plugin.randomappend	The fully qualified name of the class file that implements the `RandomAppendPlugin` interface.

Controller aliases

Property	Description	Default
jwma.controller.main	Name of the main controller.	`jwma`
jwma.controller.mailing	Name of the controller for sending mail.	`jwmasm`
jwma.controller.contacts	Name of the controller for jwma contacts.	`jwmacts`
jwma.controller.admin	Name of the controller for jwma administration. (Not available yet)	`jwmaadm`

View aliases

Property	Description	Default
jwma.view.login	Name of the login view template.	`login.jsp`
jwma.view.logout	Name of the logout view template.	`logout.jsp`
jwma.view.error	Name of the error view template.	`error.jsp`
jwma.view.folder	Name of the folder view template.	`folder.jsp`
jwma.view.mailbox	Name of the mailbox view template.	`mailbox.jsp`
jwma.view.message	Name of the message view template.	`message.jsp`
jwma.view.compose	Name of the compose view template.	`compose.jsp`
jwma.view.preferences	Name of the preferences view server template.	`settings.jsp`
jwma.view.firsttime	Name of the first time view server template.	`firsttime.jsp`
jwma.view.contacts	Name of the contacts view template.	`contacts.jsp`
jwma.view.contact	Name of the contact view template.	`contact.jsp`
jwma.view.contactedit	Name of the contact edit view template.	`contact_edit.jsp`
jwma.view.contactgroup	Name of the contact group view template.	`contactgroup.jsp`
jwma.view.contactgroupedit	Name of the contact group edit view template.	`contactgroup_edit.jsp`