In this tutorial, we will learn how to change the iTop logos

By default the admin console will have an iTop logo in its menu :

When fully opened:

And when collapsed:

Those logos can be customized with the following procedure.

Prerequisite: You must be a Combodo's customer

1. Open the “Branding” tab

Prerequisite: You must be familiar with the Syntax used in Tutorials and have already created an extension.

You will need to :

• create a new extension
• add the new files in the extension
• declare logo overwrite in the extension's XML

To add the logo image files, you can either :

• Add the files directly in your module. To use them, you'll need to specify a relative path (module code + file name)
• Add the image data in the XML (see the XML reference on logos). To use them, specify the fileref id

The logos can be redefined in the XML branding node. In the example below :

• main_logo_compact (logo with menu collapsed - for the one displayed in the expanded menu you should customize main_logo) : use an image file contained in a module
• login_logo (displayed on the login page) : use a fileref

<?xml version="1.0" encoding="UTF-8"?>
<itop_design xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" version="1.0">
  <branding>
    <main_logo_compact _delta="define">sample-itop-logos/custom-logo-compact.png</main_logo_compact>
    <login_logo _delta="define">
      <fileref ref="custom-logo"/>
    </login_logo>
  </branding>
</itop_design>

A working example can be found in this repository : Combodo/sample-itop-logos