Skip to content

Latest commit

 

History

History
executable file
·
145 lines (95 loc) · 4.8 KB

README.md

File metadata and controls

executable file
·
145 lines (95 loc) · 4.8 KB
Raw

⇐COMMUNITY PLUGINS | Home

ZK_Themes

Description

AMERPSOFT ZK_Themes is a collection of themes from different sources and contributors. Joining on a single fragment plugin. Tested on idempiere versions 8.2. Using the new standard for Theme managent on Idempiere 8.2 as stablished with IDEMPIERE-4421

Based on IDEMPIERE-4421, Some Theme Migration Notes:

Theme resources reside at: src/web/theme/THEME_NAME instead of /theme/THEME_NAME

Within the theme folder, reference to other theme resources must use full path (with “~./” prefix) instead of relative path. For e.g, at: theme/default/zul/login/login-left.zul The macroURI value is change from vendor-logo.zul to: ~./theme/default/zul/login/vendor-logo.zul

Same goes for resource reference at *.css.dsp. For e.g, at theme/default/css/fragment/grid.css.dsp background-image: url(${c:encodeURL('/theme/default/images/EditRecord16.png')}) is replace with: background-image: url(${c:encodeURL('./theme/default/images/EditRecord16.png')}). Note the added “./” prefix.

*** YOU MAY USE this plugin for idempiere Version 8.2 or Newer ***

Features

  • Amtheme: Standard Theme similar to ferrythem. See FerryTheme from Hiep LQ on: http://wiki.idempiere.org/en/Plugin:_Theme_ferrytheme

  • Amthemeblu: Blue Theme, Bigger Icons.

  • Ksys Kbs: Maintainer: Ken_longnan - [[email protected]] Status: Beta, up to date with release 5.1 License: GPLv2 Sources: ksys-idempiere-theme

  • BusinessTeam and BusinessTeamBlue: Maintainer: User: PabloValdivia

  • Font Icons are supported and tested Developer: Heng Sin Low , Idempiere 6.2 New Features. Configuration is simply to set the System Configurator flag ZK_THEME_USE_FONT_ICON_FOR_IMAGE = Y, and then execute a Cache Reset.

  • optumTheme: Maintainer: Optum-OGS optumTheme

  • iceblue_c: Maintainer: Heng Sin iceblue_c

  • Updated for idempiere version 8.2

Documentation

See amerp_themes.docx or amerp_themes.pdf

AMERPSOFT Themes - amerp_themes.pdf

Installation Procedure

Install Jar Plugin 

Available on p2 site target plugins
org.amerpsoft.com.idempiere.zk_themes_11.0.0.XXXXXXXXXXXXXX.jar

Pack in AMERPSOFT ZK_Themes.zip

Once plugin is running, then Pack-In:

AMERPSOFT ZK_Themes.zip

It contains SysConfig Variables:

    - ZK_THEME 
    - ZK_LOGO_LARGE
    - ZK_LOGO_SMALL
    - ZK_BROWSER_TITLE
    - ZK_BROWSER_ICON
    - ZK_THEME_USE_FONT_ICON_FOR_IMAGE 
    
    SET ZK_THEME_USE_FONT_ICON_FOR_IMAGE to 'N'

Manually enter Configured values

If error on Pack-IN you may enter them manually.

(System Admin --> General Rules --> System Rules --> System Configurator)

Configured Values:

NAME VALUE DESCRIPTION AD_SYSCONFIG_UU
ZK_THEME iceblue_c Available choices amtheme amthemeblu businessteam businessTeamBlue ksys kbs iceblue optumTheme iceblue_c 054399ad-3705-411d-b79e-7ec7111888c5
ZK_THEME_USE_FONT_ICON_FOR_IMAGE N Use Font Icon Yes or No 29a0d95d-af05-477a-a047-241c350dc8e3
ZK_BROWSER_ICON ~./theme/ksys/images/icon-idempiere.png Browse Icon Path 4cf766fd-5982-49dd-82f2-e8347214dbf0
ZK_LOGO_LARGE ~./theme/ksys/images/login-logo-amerp2.png Login Logo Large bfe6284e-00a2-412f-be82-37ed38363768
ZK_LOGO_SMALL ~./theme/ksys/images/header-logo-amerp.png Login Logo Small 69007345-c36f-4b02-870a-c41d8fb9deea
ZK_BROWSER_TITLE iDempiere AMERP Browser Title c587f6f8-2910-4b27-913e-2e41e8581ea0

IF SOMETHING GO WRONG

REPLACE AD_Sysconfig Record (AD_SysConfig_ID=200021)

Name:ZK_THEME

Value: default

This will put default Idempiere Standard ZK Theme

SQL Commands: UPDATE ad_sysconfig SET value ='default' WHERE AD_SysConfig_ID=200021; COMMIT;

Contact

These plugins and tutorial is brought to you by Luis Amesty from: Amerpsoft Consulting.

For any question or improvement see me at: Idempiere WIKI

Release Notes:

  • Updated for Idempiere release 8.2 - March 2021
  • Updated for Idempiere release 11 - January 2024
  • Under Test - See release-11 branch.

(back to top)