ERP/2.50/Developers Guide/How to customize the Openbravo look and feel

Introduction

This how-to explains how to create a module that contains a skin. We will create an example module called Example Skin, with the Java package name org.openbravo.examples.skinexample.

For more extensive documentation about Openbravo ERP skins, consult Skins look and feel article.

For more extensive documentation about Openbravo ERP UI artifacts, consult the Look and feel article.

Prerequisites

Creating module and files structure

Create the following folder structure

#openbravo#/modules/org.openbravo.examples.skinexample/web/org.openbravo.examples.skinexample/skins/ExampleSkin

Copy the Default skin

#openbravo#/web/skins/Default/*

to this file location

#openbravo#/modules/org.openbravo.examples.skinexample/web/org.openbravo.examples.skinexample/skins/ExampleSkin/*

Edit Openbravo_ERP_250.css which is inside "ExampleSkin" and replace all paths containing

../../../images/????????

to

../../../../images/????????

This is due to once the skin be installed, it will be inside a folder which the package name, needing to go up one level more that "Default" skin to access static "images" folder.

Now you can change everything you want/you need to customize your new skin (Remember that you should make changes only in the files inside "ExampleSkin" folder).

Inside Openbravo ERP

1. Log into Openbravo ERP as System Administrator.
2. From the Application dictionary, select Application Dictionary > Module.
3. Click New
4. Select the Module tab and fill in the following essential fields:
   • Name = Skin Module Example
   • Version = 1.0.0
   • Java Package = org.openbravo.examples.skinexample
   • Type = Module
   • In Development = checked
   • Description = Example module to demonstrate how to include a skin within a module
5. You can also fill in the following additional information:
   • Help/Comment = When you install this module a new skin called 'Example Skin' is added. To enable it go to "Session Preferences" window.
   • License Type = Openbravo Public License
   • License text = The Openbravo Public License Version 1.1 ("OBPL") consists of the Mozilla Public License Version 1.1, modified to be specific to Openbravo, with the Additional Terms in Exhibit B. The original Mozilla Public License 1.1 can be found at: http://www.mozilla.org/MPL/MPL-1.1.html
   • Author = Openbravo S.L.U. (John Doe)
   • URL = http://www.openbravo.com
6. Click Save.
7. Select the Dependency tab.
8. Click New
9. Fill at least the following essential fields as follows:
   • Select the Active checkbox.
   • Dependent Module = core
   • First Version = 2.50.10440
10. Click Save
11. From the Application menu, select "Application Dictionary > Reference".
12. In grid view, select the Skin List record.
13. Select the List Reference tab.
14. Click New.
15. Complete at least the following essential fields:
    • Select the Active checkbox.
    • Module = Skin Module Example - 1.0.0 - English (USA).
    • Search Key = org.openbravo.examples.skinexample/ExampleSkin
    • Name = Example Skin
16. You can also complete other optional fields, such as:
    • Description = Example skin within a module
17. Click Save.

Customizing the logos

Introduction

This how-to explains how to customize the logos that your installation of Openbravo ERP displays. We will customize the "yourcompany" and "yourit-service" logos which are in the login screen and in the top of the Application menu.

For more extensive documentation about this topic, consult the skins look and feel article.

Changing the logos

You can find how to change the logos that appear in the login window and in the Openbravo application itself by following this link.

Right To Left languages

Introduction

In this "How to" we are going to put the application in RTL mode.

For more extensive documentation about RTL mode, consult Skins look and feel article.

Setting the language as RTL

1. Log into Openbravo ERP as System Administrator.
2. From the Application menu, select General Setup > Application > Language.
3. Select the language you require (en_US English (USA) by default).
4. Select the RTL Language checkbox.
5. Click Save.

Your changes will be visible the next time you log into Openbravo ERP.

Customizing the application menu

Introduction

In this "How to" we are going to change the disposition of the application menu items.

If you want an extensive documentation about this topic, go to Skins look and feel article.

Changing application menu tree

1. Login as System Administrator
2. Go to window "General Setup > Application > Menu".
3. Click the "Tree" icon of the toolbar (No matter in which register are you staying)
4. The "drag and drop" pop-up appears
5. Now in this pop-up, just drag the menu item you want to move, and drop it anywhere. You will see instantly the new position of the menu in that window.

Close the pop-up, logout and then login again. The changes have been applied.

Create an Induvidual Menu tree for a specific Role

1. Login as System Administrator
2. Create a new Role
3. check the manual check box when creating a role.
4. Add access manually or using the insert access process to add those forms, processes, etc you want to have shown to this role users.
5. The elements added this way will be shown in the menun even if later on you set them as inactive. In this case you will get the message "With your current role and settings, you cannot view this information" when trying to access it. If you want to hide a specific element you must completly remove it from the role access

 How To Create and Package a Module |  How To Create a Table