Customize the Customer Portal

The customization process described here applies to the “Enhanced Customer Portal”. This enhanced portal is available since iTop 2.3.0

Prior to iTop 2.3.0, adjustments to the (legacy) customer portal used to rely on:

• Adjusting PHP constants by the mean of XML definitions. The customization capabilities are very limited.
• Modifying the code of portal/index.php. Everything is possible but each upgrade requires a manual merge of your changes with the changes in the page portal/index.php.

With the enhanced customer portal, most of your customizations will rely on XML deltas, which are likely to remain compatible with future iTop upgrades. Still, it is possible to code additional behaviors, and benefit from the delta mechanism.

You are a developper, consultant. You are already familiar with the fundamentals of iTop XML design.

You can do what you want to: the limit is defined by your creativity, coding skills, and time available for that.

Depending on your need, the customization process will range from writing a few lines of XML, to writing XML, CSS, TWIG and PHP.

Examples:

• Discard a feature in the existing customer portal: XML
• Define a brand new type of portal (e.g. Level 1 support agent portal): XML
• Revamp the portal to your company branding (position of the menus, colors, fonts, images): XML + CSS
• Add a very specific feature: XML + PHP

See the customer portal XML reference guide