This article applies to:

• Trustwave MailMarshal (SEG) 6.4 and above
• Trustwave ECM/MailMarshal Exchange 7.X

Question:

• How can I customize the look of the MailMarshal end-user management site (SQM or QM)?
• How can I create language-specific versions of the MailMarshal Spam Quarantine Management site?

Information:

The Spam Quarantine Management website in MailMarshal SMTP 6.4 and above, and Quarantine Management in MailMarshal Exchange 7.X, supports customization with Themes and Language Packs.

Trustwave provides

• Language packs in several languages (Help files in English only).
• Themes: "Clean" (default theme) and in some older versions "Purple."

All site functionality is supported in each of these languages and themes.

You can create new language packs and themes. This article provides general guidance.

• Best practice is not to change the default items. Always make a copy and work on the copy. Be sure to test any changes carefully.
• You can set up a test environment by installing an additional copy of the website on another computer.
• When you add a language or Theme, you will see the new item the next time you open your browser and log in to the site. 

Note: Trustwave does not provide detailed support for new languages and themes. You will need to have an appropriate level of technical skill to make changes to web pages, Cascading Style Sheets, and resource files.

Creating New Language Packs:

To create a Language Pack:

1. On the computer where the SQM or QM website is installed, navigate to the language resource (App_GlobalResources) folder in the website installation folder. By default (MailMarshal (SEG) 10.X) this is C:\Program Files (x86)\Trustwave\SEG Web Components\Spam Quarantine Management\App_GlobalResources
   • Note: For details of the install locations for each MailMarshal version, see the following Knowledge Base articles:
     • Q10832 (MailMarshal SMTP)
     • Q14003 (MailMarshal Exchange)
2. Make a copy of the file Language.resx in the same folder
3. Name the copy where Language.xx.resx where xx is the ISO language code of the language you want to support.
   • For instance, use Language.sv.resx for Swedish.
4. Edit the new file using a Resource Editor.
   • You can also use an XML editor, or a text editor, but ensure that all text you enter is XML-safe (for instance, & must be encoded as &).
5. For each Data Name, change the Value to an appropriate translation. For instance, here is the same item from the English and French files:
   

     <data name="AddNewEmailAddress" xml:space="preserve">
   <value>Add New Email Address</value>
   </data><
   
     <data name="AddNewEmailAddress" xml:space="preserve">
   <value>Ajouter une nouvelle adresse e-mail</value>
   </data>
   

6. Save the translated file.
7. You may find that you need to create a custom theme for some languages, especially if the text of button items is longer than the English text.

To create Help in a language:

1. On the computer where SQM is installed, navigate to the Help folder in the SQM installation folder. By default this is C:\Program Files\Marshal\MailMarshal Web Components\Spam Quarantine Management\Help
2. Make a copy of the subfolder \en.
3. Name the copy xx where xx is the ISO language code of the language you want to support.
4. Edit each ASPX and HTML file, and provide a translation of the page text.
   • Changing the content of HTML or ASP tags on these pages is not supported. In many cases, these tags provide automation functionality.

Creating New Themes:

To create a Theme:

1. On the computer where SQM is installed, navigate to the language resource folder in the SQM installation folder. By default this is C:\Program Files\Marshal\MailMarshal Web Components\Spam Quarantine Management\App_Themes
2. Select a theme to use as a model. Make a copy of the folder for this theme, including all files and subfolders.
3. Give the copy a name.
4. Each page generally uses two files:
   • A .css file that defines the stylesheet used to control the look of the page. Most look and feel changes only require changes to these files.
   • A .skin file that defines the controls used on the page and the order in which they appear. Some CSS settings are directly set on the controls.
5. You can remove functionality, in most cases, by setting the "visible" attribute of a control to "false". Test any changes carefully.
6. You can change or add images in the images subfolder.

Upgrade Behavior:

When you upgrade the Web Components, the default language packs and themes will be overwritten. Any additional language packs or themes that you have created will not be changed.

Notes:

• For MailMarshal SPE 2.3 and above, see the following article: Q12237: Creating Themes and Language Packs for the SQM website in MailMarshal SPE