Convergence Customization

Question

I need to customize Convergence.
I have a laundry list of things to do.
I thought I would start with something simple. I need to remove "Reply-to Address" from the "Options->Mail->Account Settings". I don't want users to see that option.
I have read the http://wikis.sun.com/display/CommSuite/Convergence+1.0+Documentation but some things are over my head.

Answer 1

karl.rossing wrote:
I thought I would start with something simple. I need to remove "Reply-to Address" from the "Options->Mail->Account Settings". I don't want users to see that option.
I have read the http://wikis.sun.com/display/CommSuite/Convergence+1.0+Documentation but some things are over my head.
The documentation does require a few read-throughs to get an idea on what's going on. It also helps to look at the c11n_sample code. After a bit of trial-error I was able to customise convergence to get rid of the reply-to option (never looked at it before this morning).
In this case I used "approach 1" as discussed in the following document as I couldn't think of a good way to change the html using js dom calls:
http://wikis.sun.com/display/CommSuite/Customizing+Convergence+-TechnicalOverview
To get started you need to enable customisations as per the documentation:
./iwcadmin -u <admin uid> -w <admin password> -o client.enablecustomization -v true
I created the following under the <appserver domain root>/docroot/iwc_static/
c11n/
c11n/allDomain
c11n/allDomain/js
c11n/allDomain/js/widget
c11n/allDomain/js/widget/templates
c11n/allDomain/js/widget/templates/OptionsViewerMailPersonalNewTemplate.html
c11n/allDomain/js/widget/OptionsViewerMailPersonalNewTemplate.js
c11n/allDomain/js/customize.js
c11n/config.jsc11n/config.js contains the following:
dojo.provide("c11n.config");
c11n.config = {
        // allDomain configuration
        allDomain: {
                module: "allDomain",           // module name
                themeEnabled: false,           // true if theme is customized
                i18nEnabled: false,            // true if i18n is customized
                jsEnabled: true                // true if js is customized
                // the last entry must not end with comma
}c11n/allDomain/js/customize.js contains the following:
dojo.provide("c11n.allDomain.js.customize");
// The widget OptionsViewerMailPersonalNewTemplate shows how to change the Options UI to remove
// the reply-to option  by using the dojo template. However, this can have
// problems if the base OptionsViewerMailPersonal template is changed.
dojo.require("c11n.allDomain.js.widget.OptionsViewerMailPersonalNewTemplate");c11n/allDomain/js/widget/OptionsViewerMailPersonalNewTemplate.js
dojo.provide("c11n.allDomain.js.widget.OptionsViewerMailPersonalNewTemplate");
dojo.require("iwc.widget.OptionsViewerMailPersonal");
// redeclare the OptionsViewerMailPersonal using dojo.declare, any other way will have problems
// because the this.inherited is looking for a signature
// variable nom is created for each dojo.declare function. It will throw an
// exception if the derived method doesn't have nom.
dojo.declare("iwc.widget.OptionsViewerMailPersonal", iwc.widget.OptionsViewerMailPersonal, {
        // templatePath is merged as templateString iwc.widget.OptionsViewerMailPersonal, reset it to empty string
        templateString: "",
        templatePath: dojo.moduleUrl("c11n.allDomain.js.widget", "templates/OptionsViewerMailPersonalNewTemplate.html"),
        postCreate: function() {
                // invoke the original postCreate()
                this.inherited(arguments);
        last: ""
});c11n/allDomain/js/widget/templates/OptionsViewerMailPersonalNewTemplate.html is a copy of the original OptionsViewerMailPersonal.html file from <appserver domain root>/docroot/iwc_static/js/iwc/widget/templates but with the following changes to remove the reply-to option:
*** OptionsViewerMailPersonal.html      Fri Jul  4 23:37:57 2008
--- OptionsViewerMailPersonalNewTemplate.html  Sat Jul  5 01:31:08 2008
*** 52,70 ****
                                                                                        <div dojoAttachPoint="senderEmail"><//div>
                                                                                </td>
                                                                        </tr>
!                                                                       <tr>
!                                                                               <td style='vertical-align:top; padding-right:5px'>
!                                                                                       <label class="optionLabel" for="replyTo" style="margin-right:5px">${l10n.options_reply}</label>
!                                                                               </td>
!                                                                               <td>
!                                                                                       <input  type="text"
                                                                                                dojoAttachPoint="replyTo"
                                                                                                class="optionInputText"
                                                                                                id="replyTo"
                                                                                                dojoAttachEvent="onkeyup: checkChanges"
                                                                                        />
-                                                                               </td>
-                                                                       </tr>
                                                                        <tr>
                                                                                <td style='vertical-align:top; padding-right:5px'>
                                                                                        <label class="optionLabel">${l10n.options_signature_label}</label>
--- 52,63 ----
                                                                                        <div dojoAttachPoint="senderEmail"><//div>
                                                                                </td>
                                                                        </tr>
!                                                                                       <input  type="hidden"
                                                                                                dojoAttachPoint="replyTo"
                                                                                                class="optionInputText"
                                                                                                id="replyTo"
                                                                                                dojoAttachEvent="onkeyup: checkChanges"
                                                                                        />
                                                                        <tr>
                                                                                <td style='vertical-align:top; padding-right:5px'>
                                                                                        <label class="optionLabel">${l10n.options_signature_label}</label>Hopefully this will help with the rest of your "laundry list".
Regards,
Shane.