MoEYS Gluu Custom Theme

This is a custom Gluu theme for MoEYS Identity Service https://auth.moeys.gov.kh

see https://gluu.org/docs/ce/4.1/operation/custom-design/ for more information

Folder structures:

• base: the base folder is the default un-modified page copied from Gluu's jetty war use for references
• src: the fully customized pages based on the content from base folder
• bin: this folder contain cli tools for copying default template and installing template

Getting Started

To getting started with installing this custom theme login to the Gluu chroot environment:

sudo /sbin/gluu-serverd login

Then clone this repo to your Gluu chroot env:

$ cd ~ # Change directory to the home directory
$ git clone https://github.com/socheatsok78/moeys-gluu-theme.git

System Requirement

Please check you server system requirement below: The make and stow command are required to be installed on your system before continue:

$ sudo apt install make stow

Install theme

To install this theme simply run the following comman:

$ sudo make

This will create a symbolic link with src folder and Gluu themplate foler.

Please note that installed template will create symbolic link from src to your Gluu installation.

Un-Install theme

To un-install this theme simply run the following comman:

$ sudo make uninstall

This will remove the template from your current Gluu installation.

Post-Install

After successfully install the theme, run the following command:

$ chown -R jetty:jetty /opt/gluu/jetty/*/custom/pages/
$ chmod -R a-x+rX /opt/gluu/jetty/*/custom/pages/

i18n

Customized i18n should be placed in the following directories:

/opt/gluu/jetty/identity/custom/i18n
/opt/gluu/jetty/oxauth/custom/i18n

Resources from this folder will be loaded at the next service restart.

see https://gluu.org/docs/ce/4.1/developer-guide/localization/ for more informations

⚠️ Warning

Upgrade will not apply any changes to the applied theme folder. After installing an upgrade package, the administrator should reapply changes manually. This theme may or may not compatible with your current installation of Gluu.

see https://gluu.org/docs/ce/4.1/operation/custom-design/#full-customization warning section

License