0 Introduction

   0.1 Tryout Version
   0.2 Special Thanks

1 Installation

   1.1 Simple Installation
   1.2 Add the EOSP for Module4 Web Module product full version serial number
   1.3 Installation of the 'Collect Files' EJaP

2 Configuration and Usage of EOSP

3 Feedback & Support

4 Version History

The Email Order System Pro for Modula4 Web Module 3.1

The Email Order System Pro is an extension to the Modula4 Web Module and the Canto Cumulus Sites and Web Publisher Pro (WPP) or Internet Client Pro (ICP) Option.

With the help of this extension, the user of the WPP/ICP can order files from his service provider by email. An order form will be displayed which can be configured by the administrator of the website. The order form information will be sent to a given email address after mandatory fields evaluation. For the person who processes the order, the 'Email Order System Pro' comes with functions (implemented for the Cumulus Client as an EJaP) for Mac OS and Windows which helps to find the ordered files in the Cumulus catalog. The EJaP (Embedded Java Plugin) 'CollectFiles' also performs the specified Asset Actions(!) to convert the files. It will also inform about missing files in the catalog.

The 'Email Order System Pro' comes with two different order forms. The first form is used to send a list of the ordered file names (+ additional information) in the order email, the second form enables the user to also specify the number of ordered files, the format, the price or additional information. The second order form is used by print service providers.

The new version of Email Order System Pro supports multiple catalogs (Multi-Catalog Collections) and also supports multiple languages. The product supports German, English and Spanish out of the box, more languages can be added in localisation files easily! The order emails can be sent in text or html format.

The EOSP Admin pages allow easy configuration of the product.

The EOSP Admin pages help to configure the EOSP settings

Do you need additional functionality in the product? We develop additional functionality based on your needs. Send an email with your feature requests by clicking here.

0.1 Tryout Version

The tryout version of the 'Email Order System Pro' is a full version of the product, so you can test all the functionality available.

The tryout version info displayed in the email order form

The limitation: the order form will show a demo info and a link to our website. Also the order email shows the demo information. In the demo version the email order will also be sent to an internal Heymann Consulting email adress as a bcc email. There are no other limitations in the tryout version. The demo version is for testing purposes only and you are not allowed to use it in a working environment! To order the full version of the product, send an email to Heymann Consulting.

The full version comes with a serial number that unlocks your demo installation, so you do not have reinstall anything.

0.2 Special Thanks

A special thanks to all who have contributed to the development and improvement of this product. Thank you very much to our sales partners and all our current Email Order System Pro customer who helped us to develop this useful product. We are looking forward to even more feedback from you to make this product even better...

A very special thank you goes to Albert Riera and Ferran Sogas from Microgestió, Barcelona, who provided the Spanish translation files.

The System Requirements of the Email Order System Pro product follow the system requirements of your Cumulus Web Publisher Pro or Internet Client Pro installation (see Canto documentation for details).

Before you install the software, please read the license agreement carefully. You can find the license file 'License.txt' inside the product folder. By installing the software, you accept this license agreement.

1.1 Simple Installation

EOSP comes pre-installed in all Modula4 Web Module versions (version 3 and higher). You only have to switch EOSP on by setting a parameter in the WebModule web.xml configuration file (/myWebModule/WEB-INF/web.xml):

Modula4's WebModule configuration file

1. Set the parameter 'EOSPEnabled' to 'true' to use EOSP inside of the Web Module. The links that will bring up the Email Order Forms will automatically show up in the Collection Basket page:

- Order by Email
- Order by Email with Selection

2. Configure the EOSP for Modula4 Web Module attributes by opening the URL

http://myServer(:8080)/myWebModule/EmailOrderSystemPro/admin

Log into the web application as Cumulus Administrator to change the configuration to meet your needs as described in EOSP manual. Please make sure that your SMTP Server setup is correct to allow sending emails. The following parameters are necessary to let the system send emails:

- SMTP Server
- SMTP User
- SMTP Password
- Email Sender Address

When saving the settings through the Admin Pages for the first time, a configuration file (filename: 'eosp8WebModule.properties') is created in the /temp/ directory of Tomcat.

That's it! Now you can put some files into the Collection Basket and use the email order forms to send the order email.

1.2 Add the EOSP for Module4 Web Module product full version serial number

The full version serial number is a Cumulus Option serial number that must be added to Cumulus serials in the Remote Admin of the Cumulus Server Console! Add the serial number to the list of serials in the license dialog of the Remote Admin and get a new Activation Key from the Canto website for your Cumulus environment. This is what you have to do:

For Cumulus 8.5.x (or later) users

If you are using Cumulus 8.5 and later you have to use the Cumulus Remote Admin web pages to add the full license serial number to your current Cumulus Server serial numbers.

1. Open the following URL in a web browser on the Cumulus Server: http://localhost:8954/login.html

2. Login as Cumulus Administrator.

4. Click 'Edit License' and add your EOSP for Modula4 Web Module product serial number to the list of serial numbers.

5. Click 'Register with Canto via WWW' to get a new Cumulus Activation Key that also unlocks the EOSP product. The license dialog should indicate an unlimited number of Clients for the EOSP for Modula4 Web Module product after adding the new Activation Key.

For more information on how to add a serial number to the Cumulus Option serials using the Remote Admin web pages, please consult the Canto Cumulus manual (chapter Remote Admin via Web Browser).

For Cumulus 8.0.x and 8.1.x (or later) users

1. Open the Cumulus Client.

2. Select 'File>Administration>Server Console'.

3. Login as Cumulus Administrator and select 'Remote Admin>License'

4. Click 'Edit License' and add your EOSP for Modula4 Web Module product serial number.

5. Click 'Register via WWW' to get a new Cumulus Activation Key that also unlocks the EOSP product. The license dialog should indicate an unlimited number of Clients for the EOSP for Modula4 Web Module product.

For more information on how to add a serial number to the Cumulus Option serials, please consult the Canto Cumulus manual.

1.3 Installation of the 'Collect Files' EJaP

The 'Email Order System Pro' comes with an application called 'Collect Files' to find the ordered files in the Cumulus catalog. This application is a Cumulus EJaP (Embedded Java Plugin) based on Canto's EJaP technology.

In the product folder you will find a folder '/Installation/Collect Files EJaP'. In the folder, you will find a sub-folder 'CollectFiles'. Copy this sub-folder ('CollectFiles' and its contents) into the 'ejp' folder in the installation folder of your Cumulus Client application. Under Windows it is e.g. 'C:\Program Files\Canto\Cumulus Client\ejp', under Mac OS X it is 'Macintosh HD/Applications/Cumulus Client'. The 'ejp' folder of the Cumulus application can be found in the Cumulus package. You can reach this folder by clicking the mouse-button while holding down the CTRL-key on the Cumulus application. Click on 'Show Package Contents' in the context-menu. This will open a Finder window with a subfolder 'Contents'. In that folder you will find a 'MacOS' folder and there you will find the 'ejp' folder in which to copy the 'CollectFiles' folder.

Restart the Cumulus application to use the 'Collect Files' application, it will show a new menu item in your Cumulus application called 'Email Order System Pro'.

Important: if you already have an older version of the EJaP installed (filename 'CollectFiles.ejp'), please delete the old version before you restart your Cumulus Client! Only use this version if you have a Cumulus version 7.5 or higher installed!

This documentation is an ADDENDUM to the EOSP documentation for EOSP for Modula4 Web Module.

Please consult the EOSP for Sites documentation to learn more about the configuration and usage of EOSP.

Click on the following link to read the documentation online. If you have download a full version of EOSP for Web Module click on the following link to read the full EOSP documentation.

Your feedback is very much welcome!

Please send all your questions about the product to the email address support@heymann-consulting.de. We try hard to answer your questions quickly and improve our products by implementing functionality based on your feedback.

Remark: we do not offer a telephone hotline for this product. Please send in all your requests by email.

Version 8.1.1 - February 2012

The new version now supports the UTF-8 encoding in the template and localisation files. This allows to use special characters in these files. The new functions are used to support the Finnish language in the product files.

Version 8.1.0 - June 2011

The version has been improved to better integrate into Modula4's Web Module product. It is a release that integrates into Web Module 3.1 and higher.