Sidebar

Using iTop

Creating your iTop

iTop Customization

"How to" examples
DataModel

User Interface

Automation & Ticket management

Portal Customization

Changing iTop logos

learning:
Change the iTop logos
level:
Beginner
domains:
XML
min version:
3.0.0

Goal

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: iTop 3 with expanded menu

And when collapsed: iTop 3 with collapsed menu

Those logos can be customized with the following procedure.


with the Designer

Prerequisite: You must be a Combodo's customer

Upload logos

  1. Open the “Branding” tab

with an iTop Extension

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

Add files

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

Define logos

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>

Summary

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

latest/customization/change-itop-logos.txt · Last modified: 2024/06/20 17:28 (external edit)
Back to top
Contact us