Difference between revisions of "Customizing Themes and Adding Zimbra Inside Logo - Open Source Edition"

(opensource Inside Zimbra)
(Creating redirect)
 
(One intermediate revision by one other user not shown)
Line 1: Line 1:
The appearance of the Zimbra Web Client user interface can be customized. Changing the appearance of the interface can be as easy as selecting which Zimbra themes are available to the users or you can customize one of the themes provided.
+
#REDIRECT [[Customizing_Themes_and_Adding_Zimbra_Powered_Logo_-_Open_Source_Edition]]
 
 
If you are using the Zimbra Collaboration Suite Open Source edition license, and have modified the software, you are required to use the Zimbra Inside logo on the web client interface. This document explains how to
 
 
 
<ul>
 
  <li>
 
    <div class=bullet10><span style='font-family:Symbol'><span style='font:7.0pt "Times New Roman"'>&nbsp;&nbsp;</span></span>Modify
 
      a Class of Service to limit the choice of themes available.</div>
 
  </li>
 
  <li>
 
    <div class=bullet10>Create customized themes from the sample themes provided
 
      and add the Zimbra Inside logo.</div>
 
  </li>
 
  <li>
 
    <div class=bullet10>Add the Zimbra Inside logo to display in a specific Zimbra
 
      theme .</div>
 
  </li>
 
  <li>
 
    <div class=bullet10>Add the Zimbra Inside logo to display in all Zimbra themes.</div>
 
  </li>
 
</ul>
 
<div class=Section1>
 
  <p class=Body>If you have questions about themes or have designed themes you
 
    want to share, post them to the Zimbra Forums.</p>
 
 
 
== License Policy ==
 
 
 
If the Zimbra Collaboration Suite open source editon software code is modified, the “Zimbra Inside” logo must be placed in the Zimbra Web Client user interface. If a Zimbra theme is modified or Zimlets are added to ZCS, the original Zimbra logo must be displayed.
 
 
 
Under fair use practice, you can describe your service as being based on Zimbra, such as "Acme hosted email using the Zimbra Collaboration Suite," but you generally cannot use the Zimbra name within your own branding such as "Acme Zimbra hosted email." Moreover, unless you are an accredited partner within the [http://www.zimbra.com/partners/become_a_zimbra_partner.html Zimbra Partner Program], you are not permitted to use any of the Zimbra logos other than their appropriate occurrence within the Zimbra software itself.
 
 
 
If you are producing a '''<font face="Arial">derivative work</font>''' (that is, making changes to the source code) of ZCS, Open Source Edition, you are bound by the terms of the Zimbra open source licenses (see the [http://www.zimbra.com/license/collaboration_suite_collective_license.html Zimbra Collective License] and the [http://www.zimbra.com/license/zimbra_public_license.html Zimbra Public License]). Under the Zimbra Public License (ZPL), all derivative works of the ZCS Ajax/Javascript client must carry the [http://www.zimbra.com/license/zimbra_inside_logo.html "Zimbra Inside" logo] in place of the original Zimbra logo. When users click on the “Zimbra Inside” logo, it must direct them to the Zimbra website.
 
 
 
Additional information about the license usage can be found at http:/[../../www.zimbra.com/license/index.html www.zimbra.com/license/index.html].
 
 
 
See http://www.zimbra.com/partners/trademark_branding_faq.html for more FAQs about proper use of Zimbra logo.==Customizing ZWC Using Class of Service==
 
 
 
ZCS offers a selection of themes for the Zimbra Web Client (ZWC). The theme that displays as the default on the ZWC and the themes that users can select in the ZWC Options General tab can be configured in Classes of Service from the administration console. The following theme usage options can be configured:
 
 
 
* Limit users to one theme. On the COS Themes tab, select the theme to use from the Current UI theme drop-down list. On the Features tab, remove the checkmark from Change UI themes.
 
* Let users access any of the installed Zimbra themes. On the COS Themes tab, check Do not limit Themes available to users in this COS. Users can access any of the themes that are listed in the Themes tab. Note: Change UI themes must be checked on the COS Features tab.
 
* Select specific themes that users can use. On the COS Themes tab, select Limit Themes available to users in this COS to: and then check the themes users can use. Note: Change UI themes must be checked on the COS Features tab.<br />
 
<h2>Creating Customized Theme from Sample Themes</h2>
 
  <p class=body0>To customize the ZWC user interface&#8217;s color scheme, you
 
    can modify one of the sample themes. Two sample themes are provided with generic
 
    color variants of either light or white. You can customize the theme colors
 
    using the Theme Color Picker which lets you quickly set the colors and their
 
    variants. </p>
 
</div>
 
<ul>
 
  <li>
 
    <div class=bullet10>
 
      <p><span style='font-family:Symbol'><span style='font:7.0pt "Times New Roman"'>
 
        </span></span>Light – The color scheme is light, with black text. An example
 
        of this is the Zimbra Sand theme.</p>
 
    </div>
 
  </li>
 
</ul>
 
<div class=Section1>
 
  <p class=body0>[[Image:image004.jpg]]</p>
 
</div>
 
<ul>
 
  <li>
 
    <div class=bullet10>
 
      <p>White – The color scheme is white, with black text. An example of this
 
        is the Zimbra Vanilla theme.</p>
 
    </div>
 
  </li>
 
</ul>
 
<div class=Section1>
 
  <p class=body0>[[Image:image005.jpg]]</p>
 
  <p class=body0>You can view these examples from the Zimbra Web Client, go to
 
    the Options, General tab, UI Theme and select to view the theme.</p>
 
  <h3>Creating a theme from Zimbra samples</h3>
 
  <p class=body0>When you install Zimbra Collaboration Suite, theme files are
 
    installed in the /opt/zimbra/tomcat/webapps/zimbra/skins directory. You will
 
    add your customized theme directory to the /skins directory.</p>
 
  <p class=body0>Each theme directory has one .xml file and one .txt file. The
 
    .xml file is the manifest file, which is a central list of all other files
 
    that make up the theme. The subs.txt file is where colors are defined and
 
    the Zimbra Inside logo configured.</p>
 
  <p class=body0><b>Note</b>: You can modify any of the themes. If you customize
 
    a Zimbra theme that is in the <b>/skins</b> directory, we recommend that you
 
    copy and rename the theme, following the same directions as for changing sample
 
    themes.  You will need to change any occurrence of the Zimbra theme name to
 
    the changed name. </p>
 
  <p class=body0><b>How to change a sample theme</b></p>
 
  <p class=number10>1.<span style='font:7.0pt "Times New Roman"'>&nbsp;&nbsp;&nbsp;&nbsp;
 
    </span>Go to the following Zimbra directory, /opt/zimbra/tomcat/webapps/zimbra/skins/_sample</p>
 
  <p class=body20>The _sample directory includes the sample folders, light and
 
    white.</p>
 
  <p class=number10>2.<span style='font:7.0pt "Times New Roman"'>&nbsp;&nbsp;&nbsp;&nbsp;
 
    </span>Copy the sample theme directory you have chosen from the /_samples
 
    directory to the /skins directory. When you copy it, change the sample theme
 
    name to your theme name.</p>
 
  <table class=screen border=0 cellspacing=0 cellpadding=0 width=661
 
style='width:396.7pt;margin-left:.5 in;border-collapse:collapse'>
 
    <tr style='height:9.3pt'>
 
      <td width=661 style='width:396.7pt;background:#E6E6E6;padding:0in 5.4pt 0in 5.4pt;
 
  height:9.3pt'> <p class=codenew>cp –r &lt;sampletheme&gt; /opt/zimbra/tomcat/webapps/zimbra/skins/&lt;mytheme&gt;</p></td>
 
    </tr>
 
  </table>
 
  <p class=number10>3.<span style='font:7.0pt "Times New Roman"'>&nbsp;&nbsp;&nbsp;&nbsp;
 
    </span>Change the name of the files in the &lt;mytheme&gt; directory to your
 
    theme name. Make sure you do not change the extensions. </p>
 
  <table class=screen border=0 cellspacing=0 cellpadding=0 style='margin-left:
 
.5 in;border-collapse:collapse'>
 
    <tr>
 
      <td style='background:#E6E6E6;padding:0in 5.4pt 0in 5.4pt'> <p class=codenew>mv
 
          &lt;sampletheme.xml&gt; &lt;mytheme&gt;.xml</p>
 
        <p class=codenew>mv &lt;sampletheme_subs.text &lt;mytheme&gt;_subs.txt</p></td>
 
    </tr>
 
  </table>
 
  <p class=body20>Your theme directory should look like this:</p>
 
  <table class=screen border=0 cellspacing=0 cellpadding=0 style='margin-left:
 
.5 in;border-collapse:collapse'>
 
    <tr style='height:33.8pt'>
 
      <td width=235 style='width:141.25pt;background:#E6E6E6;padding:0in 5.4pt 0in 5.4pt;
 
  height:33.8pt'> <p class=codenew><font face="Courier New, Courier, mono">/skin/mytheme/</font></p>
 
        <p class=codenew><font face="Courier New, Courier, mono">mytheme.xml   
 
          </font></p>
 
        <p class=codenew><font face="Courier New, Courier, mono">mytheme_subs.txt</font></p>
 
        <p class=body0>&nbsp;</p></td>
 
    </tr>
 
  </table>
 
  <p class=number10>4.<span style='font:7.0pt "Times New Roman"'>&nbsp;&nbsp;&nbsp;&nbsp;
 
    </span>Edit mytheme.xml. Change any occurrence of [skin] to your theme name.</p>
 
  <table class=screen border=0 cellspacing=0 cellpadding=0 style='margin-left:
 
.5 in;border-collapse:collapse'>
 
    <tr>
 
      <td width=798 style='width:4.0in;background:#E6E6E6;padding:0in 5.4pt 0in 5.4pt'>
 
        <p class=codenew><font face="Courier New, Courier, mono">$ vi mytheme.xml</font></p>
 
        <p class=codenew><font face="Courier New, Courier, mono">&lt;skin&gt;</font></p>
 
        <p class=codenew><font face="Courier New, Courier, mono">    &lt;substitutions&gt;</font></p>
 
        <p class=codenew><font face="Courier New, Courier, mono">        &lt;file&gt;../_base/base/base_subs.txt&lt;/file&gt;</font></p>
 
        <p class=codenew><font face="Courier New, Courier, mono">        &lt;file&gt;../_base/light/light_subs.txt&lt;/file&gt;</font></p>
 
        <p class=codenew><font face="Courier New, Courier, mono">        &lt;file&gt;mytheme_subs.txt&lt;/file&gt;</font></p>
 
        <p class=codenew><font face="Courier New, Courier, mono">    &lt;/substitutions&gt;</font></p>
 
        <p class=codenew><font face="Courier New, Courier, mono">    &lt;css&gt;</font></p>
 
        <p class=codenew><font face="Courier New, Courier, mono">        &lt;file&gt;../_base/base/base.css&lt;/file&gt;</font></p>
 
        <p class=codenew><font face="Courier New, Courier, mono">    &lt;/css&gt;</font></p>
 
        <p class=codenew><font face="Courier New, Courier, mono">    &lt;html&gt;</font></p>
 
        <p class=codenew><font face="Courier New, Courier, mono">        &lt;file&gt;../_base/base/base.html&lt;/file&gt;</font></p>
 
        <p class=codenew><font face="Courier New, Courier, mono">    &lt;/html&gt;</font></p>
 
        <p class=codenew><font face="Courier New, Courier, mono">&lt;/skin&gt;</font></p></td>
 
    </tr>
 
  </table>
 
  <p class=number10>5.<span style='font:7.0pt "Times New Roman"'>&nbsp;&nbsp;&nbsp;&nbsp;
 
    </span>Edit &lt;mytheme&gt;_subs.txt </p>
 
  <p class=Body style='margin-left:.5in;text-indent:-.25in'>a.<span
 
style='font:7.0pt "Times New Roman"'>&nbsp;&nbsp;&nbsp;&nbsp; </span>Where you
 
    see <b>SkinName =  [skin]</b>, change [skin] to your theme file name, for
 
    example, SkinName = mytheme. </p>
 
  <p class=Body style='margin-left:.5in;text-indent:-.25in'>b.<span style='font:7.0pt "Times New Roman"'>&nbsp;&nbsp;&nbsp;&nbsp;
 
    </span>If you modified the Zimbra software, you must configure the <b>Zimbra
 
    Inside</b> logo. In the section that says “If you are using ZCS under the
 
    open source license, and you have modified the software, then you are required
 
    to use the Zimbra Inside logo. To have the logo display, uncomment the lines
 
    that starts with <b>LogoImgDir</b> and <b>LogoURL</b>. </p>
 
  <p class=Body style='margin-left:.5in;text-indent:-.25in'>c.<span
 
style='font:7.0pt "Times New Roman"'>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; </span>Optionally,
 
    you can customize the skin colors. </p>
 
  <p class=Body style='margin-left:.5in'>The themes _subs.txt file defines a
 
    single _BaseColor_ and variances that is used to give the theme a consistent
 
    color theme. If you want to modify the colors of the theme, use the Theme
 
    Color Picker to pick the colors interactively and then copy and paste the
 
    list of color variants over the list in your mytheme_subs.txt file. See <span
 
style='color:navy'>Using the Theme Color Picker</span> section.</p>
 
  <table class=screen border=0 cellspacing=0 cellpadding=0 width=660
 
style='width:396.1pt;margin-left:.5 in;border-collapse:collapse'>
 
    <tr>
 
      <td width=660 style='width:4.0in;background:#E6E6E6;padding:0in 5.4pt 0in 5.4pt'>
 
        <p class=codenew><font face="Courier New, Courier, mono">#############################################################</font></p>
 
        <p class=codenew><font face="Courier New, Courier, mono">#                           
 
          Skin Substitutions                          </font></p>
 
        <p class=codenew><font face="Courier New, Courier, mono">#------------------------------------------------------------#</font></p>
 
        <p class=codenew><font face="Courier New, Courier, mono">#</font></p>
 
        <p class=codenew><font face="Courier New, Courier, mono"># Add or change
 
          entries below to customize this skin.</font></p>
 
        <p class=codenew><font face="Courier New, Courier, mono">#    See:  http://wiki.zimbra.com/?title=Themes</font></p>
 
        <p class=codenew><font face="Courier New, Courier, mono">#</font></p>
 
        <p class=codenew><font face="Courier New, Courier, mono">#  NOTE: Substitutions
 
          that begin and end with &quot;_&quot; (eg: <br>
 
          # &quot;_BaseColor_&quot;)should only be used within this file -- never
 
          in # a CSS or HTML file</font></p>
 
        <p class=codenew><font face="Courier New, Courier, mono">#</font></p>
 
        <p class=codenew><font face="Courier New, Courier, mono"># ===========================================================#</font></p>
 
        <p class=codenew>&nbsp;</p>
 
        <p class=codenew><font face="Courier New, Courier, mono">SkinName           
 
          = mytheme</font></p>
 
        <p class=codenew>&nbsp;</p>
 
        <p class=codenew><font face="Courier New, Courier, mono">###############################################################</font></p>
 
        <p class=codenew><font face="Courier New, Courier, mono">#                         
 
          Logo Licensing Rules                        #</font></p>
 
        <p class=codenew><font face="Courier New, Courier, mono">#-----------------------------------------------------------#</font></p>
 
        <p class=codenew><font face="Courier New, Courier, mono">#</font></p>
 
        <p class=codenew><font face="Courier New, Courier, mono"><b><span style='color:#999999'># 
 
          If you are using the Zimbra Collaboration Suite (ZCS) under the</span></b></font></p>
 
        <p class=codenew><font face="Courier New, Courier, mono"><b><span style='color:#999999'># 
 
          open source license, and you have not modified the software,</span></b></font></p>
 
        <p class=codenew><font face="Courier New, Courier, mono"><b><span style='color:#999999'># 
 
          then you are required to use the Zimbra logo (the default).</span></b></font></p>
 
        <p class=codenew><font face="Courier New, Courier, mono"><b><span style='color:#999999'>#</span></b></font></p>
 
        <p class=codenew><font face="Courier New, Courier, mono"><b><span style='color:#999999'># 
 
          LogoImgDir      = /zimbra/skins/_base/logos</span></b></font></p>
 
        <p class=codenew><font face="Courier New, Courier, mono"><b><span style='color:#999999'># 
 
          LogoURL        = http: //www.zimbra.com</span></b></font></p>
 
        <p class=codenew><font face="Courier New, Courier, mono"><b>#</b></font></p>
 
        <p class=codenew><font face="Courier New, Courier, mono">#-----------------------------------------------------------</font></p>
 
        <p class=codenew><font face="Courier New, Courier, mono"><span style='color:silver'><strong><font color="#000000"># 
 
          If you are using ZCS under the open source license,</font></strong></span></font></p>
 
        <p class=codenew><font color="#000000" face="Courier New, Courier, mono"><strong><span style='color:black'># 
 
          and you have modified the software,</span></strong></font></p>
 
        <p class=codenew><font color="#000000" face="Courier New, Courier, mono"><strong><span style='color:black'># 
 
          then you are required to use the Zimbra Inside logo.</span></strong></font></p>
 
        <p class=codenew><font color="#000000" face="Courier New, Courier, mono"><strong><span style='color:black'>#</span></strong></font></p>
 
        <p class=codenew><font color="#000000" face="Courier New, Courier, mono"><strong><span style='color:black'># 
 
          LogoImgDir      = /zimbra/skins/_base/logos/ZimbraInside</span></strong></font></p>
 
        <p class=codenew><font color="#000000" face="Courier New, Courier, mono"><strong><span style='color:black'># 
 
          LogoURL        = http:// www.zimbra.com</span></strong></font></p>
 
        <p class=codenew><font color="#000000" face="Courier New, Courier, mono"><strong>#</strong></font></p>
 
        <p class=codenew><font face="Courier New, Courier, mono">#------------------------------------------------------------</font></p>
 
        <p class=codenew><font face="Courier New, Courier, mono">#</font></p>
 
        <p class=codenew><font face="Courier New, Courier, mono">#============================================================#</font></p>
 
        <p class=codenew>&nbsp;</p>
 
        <p class=codenew><font face="Courier New, Courier, mono">#                             
 
          Skin Colors                              #</font></p>
 
        <p class=codenew><font face="Courier New, Courier, mono">#-------------------------------------------------------------#</font></p>
 
        <p class=codenew><font face="Courier New, Courier, mono">#### Base color
 
          and variants ####</font></p>
 
        <p class=codenew><font face="Courier New, Courier, mono">        _BaseColor_                 
 
            =      #ff7373</font></p>
 
        <p class=codenew><font face="Courier New, Courier, mono">        _BaseColorD95_         
 
          =      #0d0606</font></p>
 
        <p class=codenew><font face="Courier New, Courier, mono">        _BaseColorD90_         
 
          =      #1a0c0c</font></p>
 
        <p class=codenew><font face="Courier New, Courier, mono">.</font></p></td>
 
    </tr>
 
  </table>
 
  <p class=number10>6.<span style='font:7.0pt "Times New Roman"'>&nbsp;&nbsp;&nbsp;&nbsp;
 
    </span>Now modify the Zimbra configuration to add your customized theme and
 
    stop and start the server. </p>
 
  <p class=body20>To modify the configuration, type </p>
 
  <table class=screen border=0 cellspacing=0 cellpadding=0 width=495
 
style='width:297.0pt;margin-left:.5 in;border-collapse:collapse'>
 
    <tr>
 
      <td width=495 style='width:297.0pt;background:#E6E6E6;padding:0in 5.4pt 0in 5.4pt'>
 
        <p class=codenew>zmprov mcf +zimbraInstalledSkin &lt;mytheme&gt;.</p></td>
 
    </tr>
 
  </table>
 
  <p class=number10>7.<span style='font:7.0pt "Times New Roman"'>&nbsp;&nbsp;&nbsp;&nbsp;
 
    </span>Stop the server, type </p>
 
  <table class=screen border=0 cellspacing=0 cellpadding=0 width=495
 
style='width:297.0pt;margin-left:.5 in;border-collapse:collapse'>
 
    <tr>
 
      <td width=495 style='width:297.0pt;background:#E6E6E6;padding:0in 5.4pt 0in 5.4pt'>
 
        <p class=codenew><font size="2" face="Courier New, Courier, mono">zmcontrol stop</font></p></td>
 
    </tr>
 
  </table>
 
  <p class=number10>8.<span style='font:7.0pt "Times New Roman"'>&nbsp;&nbsp;&nbsp;&nbsp;
 
    </span>When the services are stopped, restart the server, type</p>
 
  <table class=screen border=0 cellspacing=0 cellpadding=0 width=495
 
style='width:297.0pt;margin-left:.5 in;border-collapse:collapse'>
 
    <tr>
 
      <td width=495 style='width:297.0pt;background:#E6E6E6;padding:0in 5.4pt 0in 5.4pt'>
 
        <p class=codenew><font size="2" face="Courier New, Courier, mono">zmcontrol
 
          start</font></p></td>
 
    </tr>
 
  </table>
 
  <p class=body20>The customized theme is now listed in the administration console’s
 
    COS and Accounts UI Theme list.</p>
 
</div>
 
<div class=body20>If you want users to access only this theme, modify Classes of Service to make this theme the Current UI theme and disable the Change UI themes feature.</div>
 
  <div class=Section1>
 
  <p class=body0><b>IMPORTANT</b>:  If users have been using Zimbra Collaboration
 
    Suite, they may need to clear their browser’s cache before the new logos are
 
    displayed.</p>
 
  <h3>Using the Theme Color Picker</h3>
 
  <p class=body0>To change the colors of a theme use the ZCS Theme Color Picker
 
    to create different color variants. As you select different colors, the Theme
 
    Color Picker automatically updates the color variants RGB value in the Theme
 
    Color Picker list. This list is then copied and pasted to the subs.txt file.
 
  </p>
 
  <p class=body0>A theme defines a single <b>_BaseColor_</b> that is used to give
 
    the UI a consistent color theme. The HTML, CSS, and substitution files are
 
    crafted to use subtle light and dark variants of this color to achieve effects
 
    like buttons that look like they rise and lower, without the use of images.
 
    To change a _BaseColor_, use the ZCS Theme Color Picker to pick the color
 
    interactively. Copy and paste the list of color variants into the _BaseColor_
 
    [theme]_subs.txt file.</p>
 
  <p class=body0>Themes also define a <b>_SelColor_</b> which is the color used
 
    to show selected rows in lists, default buttons, etc. To define a _SelColor_,
 
    use the Theme Color Picker to pick the color interactively. Copy and past
 
    the list of color variants into the _SelColor_section of the [theme]_subs.txt
 
    file.</p>
 
  <p class=body0>The ZCS Theme Color Picker file is installed on the following
 
    directory on the Zimbra server <b>/opt/zimbra/tomcat/webapps/zimbra/skins/_sample</b>.
 
    To open this file from your browser, type <b>http://YOUR SERVER/zimbra/skins/_sample/ZCSThemeColorPicker.html</b>. 
 
  </p>
 
  <h2>Adding Zimbra Inside Logo to a Zimbra theme</h2>
 
  <p class=Body>You can add <b>Zimbra Inside</b> to any of the Zimbra themes in
 
    the skins directory.</p>
 
  <p class=number10>1.<span style='font:7.0pt "Times New Roman"'>&nbsp;&nbsp;&nbsp;&nbsp;
 
    </span>Go to the following Zimbra directory, /opt/zimbra/tomcat/webapps/zimbra/skins/</p>
 
  <p class=body20>The skins directory includes all the available Zimbra themes.</p>
 
  <p class=number10>2.<span style='font:7.0pt "Times New Roman"'>&nbsp;&nbsp;&nbsp;&nbsp;
 
    </span>Select a theme and go to that theme’s directory.</p>
 
  <p class=number10>3.<span style='font:7.0pt "Times New Roman"'>&nbsp;&nbsp;&nbsp;&nbsp;
 
    </span>Edit the theme’s _subs.txt. </p>
 
  <p class=body20>In the section that says “If you are using ZCS under the open
 
    source license, and you have modified the software, then you are required
 
    to use the Zimbra Inside logo, uncomment the lines that starts with <b>LogoImgDir</b>
 
    and <b>LogoURL</b>. </p>
 
  <table class=screen border=0 cellspacing=0 cellpadding=0 width=603
 
style='width:361.8pt;margin-left:.5 in;border-collapse:collapse'>
 
    <tr>
 
      <td width=603 style='width:361.8pt;background:#E6E6E6;padding:0in 5.4pt 0in 5.4pt'>
 
        <p class=codenew><font face="Courier New, Courier, mono">#-------------------------------------------------------</font></p>
 
        <p class=codenew><font face="Courier New, Courier, mono"><span style='color:silver'><strong><font color="#000000"># 
 
          If you are using ZCS under the open source license,</font></strong></span></font></p>
 
        <p class=codenew><font color="#000000" face="Courier New, Courier, mono"><strong><span style='color:black'># 
 
          and you have modified the software,</span></strong></font></p>
 
        <p class=codenew><font color="#000000" face="Courier New, Courier, mono"><strong><span style='color:black'># 
 
          then you are required to use the Zimbra Inside logo.</span></strong></font></p>
 
        <p class=codenew><font color="#000000" face="Courier New, Courier, mono"><strong><span style='color:black'>#</span></strong></font></p>
 
        <p class=codenew><font color="#000000" face="Courier New, Courier, mono"><strong><span style='color:black'># 
 
          LogoImgDir      = /zimbra/skins/_base/logos/ZimbraInside</span></strong></font></p>
 
        <p class=codenew><font color="#000000" face="Courier New, Courier, mono"><strong><span style='color:black'># 
 
          LogoURL        = http:// www.zimbra.com</span></strong></font></p>
 
        <p class=codenew><font face="Courier New, Courier, mono">#-------------------------------------------------------</font></p>
 
        <p class=codenew>&nbsp;</p>
 
        <p class=MsoNormal><font face="Courier New, Courier, mono"><b><span style='font-size:9.0pt;font-family:"Courier New";
 
  color:silver'>#  If you are using ZCS under the network (commercial) license,</span></b></font></p>
 
        <p class=screencode><font face="Courier New, Courier, mono"><b><span style='color:silver'># 
 
          then you are welcome to use your own logo in place of the </span></b></font></p></td>
 
    </tr>
 
  </table>
 
  <p class=number10>4.<span style='font:7.0pt "Times New Roman"'>&nbsp;&nbsp;&nbsp;&nbsp;
 
    </span>Save your changes. Now you will need to deploy your changes.</p>
 
  <p class=number10>5.<span style='font:7.0pt "Times New Roman"'>&nbsp;&nbsp;&nbsp;&nbsp;
 
    </span>Stop the server, type </p>
 
  <table class=screen border=0 cellspacing=0 cellpadding=0 style='margin-left:
 
.5 in;border-collapse:collapse'>
 
    <tr>
 
      <td width=798 style='width:6.65in;background:#E6E6E6;padding:0in 5.4pt 0in 5.4pt'>
 
        <p class=Body style='margin-left:0in'><span style='font-size:9.0pt;
 
  font-family:"Courier New"'><font face="Courier New, Courier, mono">zmcontrol
 
          stop</font></span></p></td>
 
    </tr>
 
  </table>
 
  <p class=number10>6.<span style='font:7.0pt "Times New Roman"'>&nbsp;&nbsp;&nbsp;&nbsp;
 
    </span>Start the server, type</p>
 
  <table class=screen border=0 cellspacing=0 cellpadding=0 style='margin-left:
 
.5 in;border-collapse:collapse'>
 
    <tr>
 
      <td width=798 style='width:6.65in;background:#E6E6E6;padding:0in 5.4pt 0in 5.4pt'>
 
        <p class=Body style='margin-left:0in'><span style='font-size:9.0pt;
 
  font-family:"Courier New"'><font face="Courier New, Courier, mono">zmcontrol
 
          start</font></span></p></td>
 
    </tr>
 
  </table>
 
  <h1><b><span style='font-size:14.0pt'>Adding Zimbra Inside Logo to All Zimbra
 
    Themes</span></b></h1>
 
  <p class=Body>To display Zimbra inside in all Zimbra themes, you modify the
 
    base_subs.txt file.</p>
 
  <p class=number10>1.<span style='font:7.0pt "Times New Roman"'>&nbsp;&nbsp;&nbsp;&nbsp;
 
    </span>Go to /opt/zimbra/tomcat/webapps/zimbra/skins/_base/base</p>
 
  <p class=number10>2.<span style='font:7.0pt "Times New Roman"'>&nbsp;&nbsp;&nbsp;&nbsp;
 
    </span>Edit the base_subs.txt file. In the file where it reads “If you are
 
    using ZCS under the open source license, and you have modified the software,
 
    then you are required to use the Zimbra Inside logo.”:</p>
 
  <p class=Body style='margin-left:.75in;text-indent:-.25in'>a.<span
 
style='font:7.0pt "Times New Roman"'>&nbsp;&nbsp;&nbsp;&nbsp; </span>Uncomment
 
    the line that starts with <b>LogoImgDir</b></p>
 
  <p class=Body style='margin-left:.75in;text-indent:-.25in'>b.<span
 
style='font:7.0pt "Times New Roman"'>&nbsp;&nbsp;&nbsp;&nbsp; </span>Uncomment
 
    the line with <b>LogoURL</b>.</p>
 
  <table class=screen border=0 cellspacing=0 cellpadding=0 width=645
 
style='width:387.0pt;margin-left:.5 in;border-collapse:collapse'>
 
    <tr>
 
      <td width=645 style='width:387.0pt;background:#E6E6E6;padding:0in 5.4pt 0in 5.4pt'>
 
        <p class=screencode>#========================================================================#</p>
 
        <p class=screencode>&nbsp;</p>
 
        <p class=screencode>&nbsp;</p>
 
        <p class=screencode>SkinName            = base</p>
 
        <p class=screencode>&nbsp;</p>
 
        <p class=screencode>&nbsp;</p>
 
        <p class=screencode>##########################################################################</p>
 
        <p class=screencode>#                          Logo Licensing Rules                       
 
          #</p>
 
        <p class=screencode>#------------------------------------------------------------------------#</p>
 
        <p class=screencode>#</p>
 
        <p class=screencode><span style='color:silver'>#  If you are using the
 
          Zimbra Collaboration Suite (ZCS) under the open <br>
 
          # source license, and you have not modifed the software,</span></p>
 
        <p class=screencode><span style='color:silver'>#  then you are required
 
          to use the Zimbra logo (the default).</span></p>
 
        <p class=screencode><span style='color:silver'>#</span></p>
 
        <p class=screencode><span style='color:silver'>#  LogoImgDir      = /zimbra/skins/_base/logos</span></p>
 
        <p class=screencode><span style='color:silver'>#  LogoURL        = http:// www.zimbra.com</span></p>
 
        <p class=screencode><span style='color:silver'>#-------------------------------------------------------------------------</span></p>
 
        <p class=screencode><span style='color:silver'>#  </span><b>If you are
 
          using ZCS under the open source license,</b></p>
 
        <p class=screencode><b>#  and you have modified the software,</b></p>
 
        <p class=screencode><b>#  then you are required to use the Zimbra Inside
 
          logo.</b></p>
 
        <p class=screencode><b>#</b></p>
 
        <p class=screencode><b>  LogoImgDir      = /zimbra/skins/_base/logos/ZimbraInside</b></p>
 
        <p class=screencode><b>  LogoURL        = http:/ /www.zimbra.com</b></p>
 
        <p class=screencode>#</p>
 
        <p class=screencode><b>#-------------------------------------------------------------------------</b></p>
 
        <p class=screencode>&nbsp;</p></td>
 
    </tr>
 
  </table>
 
  <p class=number10>3.<span style='font:7.0pt "Times New Roman"'>&nbsp;&nbsp;&nbsp;&nbsp;
 
    </span>Save your changes. </p>
 
  <p class=number10>4.<span style='font:7.0pt "Times New Roman"'>&nbsp;&nbsp;&nbsp;&nbsp;
 
    </span>Stop and start the Zimbra server to display the Zimbra Inside logo.
 
  </p>
 
  <p class=numberedskin>a.<span style='font:7.0pt "Times New Roman"'>&nbsp;&nbsp;&nbsp;&nbsp;
 
    </span>Stop the server, type </p>
 
  <table class=screen border=0 cellspacing=0 cellpadding=0 style='margin-left:
 
1 in;border-collapse:collapse'>
 
    <tr>
 
      <td width=798 style='width:6.65in;background:#E6E6E6;padding:0in 5.4pt 0in 5.4pt'>
 
        <p class=codenew><font face="Courier New, Courier, mono">zmcontrol stop</font></p></td>
 
    </tr>
 
  </table>
 
  <p class=numberedskin>b.<span style='font:7.0pt "Times New Roman"'>&nbsp;&nbsp;&nbsp;&nbsp;
 
    </span>When the services are stopped, restart the server, type</p>
 
  <table class=screen border=0 cellspacing=0 cellpadding=0 style='margin-left:
 
1 in;border-collapse:collapse'>
 
    <tr>
 
      <td width=798 style='width:6.65in;background:#E6E6E6;padding:0in 5.4pt 0in 5.4pt'>
 
        <p class=codenew><font face="Courier New, Courier, mono">zmcontrol start</font></p></td>
 
    </tr>
 
  </table>
 
  <p class=Body>&nbsp;</p>
 
</div>
 

Latest revision as of 19:51, 13 August 2007

Jump to: navigation, search