LDAPAccountManager/lam/docs/manual-sources/appendix-design.xml

99 lines
3.0 KiB
XML

<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE book PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN"
"http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd">
<appendix>
<title>Adapt LAM to your corporate design</title>
<para>There are cases where you might want to change LAM's default
look'n'feel to better integrate it in your company network. Changes can be
done like this:</para>
<para><emphasis role="bold">Change colors, fonts and other parts with
custom CSS</emphasis></para>
<para>You can integrate custom CSS files in LAM. It is recommended to
write a separate CSS file instead of modifying LAM's default files.</para>
<para>The CSS files are located in</para>
<literallayout> DEB/RPM: /usr/share/ldap-account-manager/style
tar.bz2: style
</literallayout>
<para>LAM will automatically integrate all CSS files in alphabetical
order. E.g. you can create a file called "900_myCompany.css" which will be
added as last file.</para>
<para>Example:</para>
<para>This will change the background color of all pages to turquoise. See
500_layout.css for LAM's default settings.</para>
<programlisting>body {
background-color: #b6eeff;
}
</programlisting>
<para>You can use the same way to change fonts, sizes and more.</para>
<para>E.g. this will reduce the default font size to 80%:</para>
<programlisting>body {
font-size: 80%;
}
.ui-button-text-only {
font-size: 100%;
}
.ui-button-text-icon-primary {
font-size: 100%;
}
</programlisting>
<para><emphasis role="bold">Custom logo</emphasis><programlisting>/* image in login box */
td.loginLogo {
background-image: url(/logos/mylogo.png);
}
/* image (24x24) in header line */
a.lamLogo {
background-image: url(/logos/mylogo.png);
}</programlisting></para>
<para><emphasis role="bold">Other images</emphasis></para>
<para>All images are located in</para>
<literallayout> DEB/RPM: /usr/share/ldap-account-manager/graphics
tar.bz2: graphics</literallayout>
<para>Please note that if you replace images then you need to reapply your
changes every time you upgrade LAM.</para>
<para><emphasis role="bold">Special changes with custom
JavaScript</emphasis></para>
<para>In rare cases it might not be sufficient to write custom CSS or
replace some image files. E.g. you might want to add custom content to all
pages.</para>
<para>For these cases you can add a custom JavaScript file that contains
your code.</para>
<para>The JavaScript files are located in</para>
<literallayout> DEB/RPM: /usr/share/ldap-account-manager/templates/lib
tar.bz2: templates/lib</literallayout>
<para>LAM will automatically integrate all .js files in alphabetical
order. E.g. you can create a file called "900_myCompany.js" which will be
added as last file.</para>
<para><emphasis role="bold">Self service</emphasis></para>
<para>See <link linkend="selfServiceBasicSettings">here</link> for self
service customisations.</para>
</appendix>