Customize iDempiere Look and Feel Theme

The purpose of this page is to help you customize the look and feel of iDempiere.

Areas to Customize

Landing Page
Login Page (Add your own logo)
Desktop theme (main window layout)
Reports and Print Outs

YouTube Demonstration

There is a great tutorial by Jan Thielemann (link)

The Landing Page

The code that controls the iDempiere landing pages is located in:

org.adempiere.server/src/main/home/org/bmlaurus/home/home.properties

The actual images and layouts come from:

org.adempiere.server/resources/templates/white

If you do not want to modify the core code, you will need to create a fragment (similar to this process) to replace the above files and/or folders.

Feature to Prevent Creating New Theme

This feature allows you to change the default theme without needing to create a whole new theme. Uses fragment plugin.

Simple Plugin to Change Existing Theme

Link to Ticket - note that ticket has an attached example to change font
Link to documentation coming when available

Login Page and Desktop Theme

The login page and desktop theme are managed by iDempiere's theme. This link does a good job of walking you through how to copy the current iDempiere theme into an iDempiere Plugin/Fragment to customize and create your own theme. This link is similar. The default theme files are located in:

org.adempiere.ui.zk/theme/default

Reports and Print Outs

You can change the report logo by modifying the Client window -> Client Info tab -> Logo Report field. Please note that report is slightly different than a print format. Reports are launched from the Report toolbar button. Print formats (sometimes referred to as forms) are launched from the Print toolbar button. You can add a logo to any print format. The Purchase Order is a good example. Perform the following to see how the Purchase Order adds a logo. See "2014-06-05 AM Open Discussion section at 0:07:00" for reference.

Open a Purchase Order record
Click the Print toolbar button
In the Purchase Order Print Viewer window, click on the Customize Report toolbar.
In the Print Format -> Format Item subtab, you will find a logo record. It should be the first record. You can update the URL to point to any logo. For example, you can point it to your website logo "www.YourURL.com/images/wslogo.png".