Open Source Document Management System | OpenKM

By default, mail notification is not enabled on OpenKM. It must be configured with parameters:

For versions older than OpenKM 3.0 you must create some properties file:

In $JBOSS_HOME/server/default/conf, there must be a file called emails.properties with user mail information like this:

user1=user1@mail.com
....
 
Setting the mail server on JBoss:

$JBOSS_HOME/server/default/deploy must have a file called mail-service.xml ( your SMTP mail server configuration goes here ). (Note: you have to change this sample values to meet your server settings.)

<!-- OpenKM -->
<mbean code="org.jboss.mail.MailService" name="jboss:service=mail/OpenKM">
<attribute name="JNDIName">java:/mail/OpenKM</attribute>
<attribute name="User">user</attribute>
<attribute name="Password">password</attribute>
<attribute name="Configuration">
<configuration>
<property name="mail.transport.protocol" value="smtp"/>
<property name="mail.smtp.host" value="host.com"/>
<property name="mail.smtp.auth" value="true"/>
<property name="mail.from" value="noreply@host.com"/>
<property name="mail.debug" value="false"/>
</configuration>
<depends>jboss:service=Naming</depends>
</attribute>
</mbean>

Enabling mailing service:

Your server URL must be inserted at OpenKM.cfg

application.url=http://your_host:8080/OpenKM/es.git.openkm.frontend.Main/index.jsp

YOU MUST RESTART THE OPENKM SERVICE AFTER CHANGING OPENKM.CFG

you can configure these text using two properties in the OpenKM.cfg file. Default values are shown below:

subscription.message.subject=OpenKM - {0} - {1};
subscription.message.body=<b>Document: </b><a href=\"{0}\">{1}</a><br/><b>User: </b>{3}<br/><b>Event: </b>{4}<br/>

And these are the substitution variables used:

SUBSCRIPTION SUBJECT
{0} - event type
{1} - document path
{2} - document name

SUBSCRIPTION BODY
{0} - document url
{1} - document path
{2} - document name
{3} - user id
{4} - event type
{5} - comment

notify.message.subject=OpenKM - NOTIFICATION - {0}
notify.message.body=<b>Document: </b><a href=\"{0}\">{1}</a><br/><b>User: </b>{3}<br/><b>Message: </b>{4}<br/>

And these are the substitution variables used:

NOTIFY SUBJECT
{0} - document path
{2} - document name
NOTIFY BODY
{0} - document url
{1} - document path
{2} - document name
{3} - user id
{4} - message

 # application.url=your host url