Chapter 9. Customizing

If you are just looking for a few "quick fixes" to change the look and feel of openCRX, this is your chapter. If you are envisioning bigger changes, please refer to the openCRX Customization Guide for advanced customization features of openCRX. Furthermore, please note that customizing openCRX is one of those tasks not suitable for end-users - have your openCRX system administrator take care of your change requests.

Many of the customizing changes discussed below require access to the files contained in the EARs (unless you want to change the sources and rebuild openCRX). You can open the file opencrx-core-CRX-web.ear with a ZIP utility and extract the content to get access to the file opencrx-core-CRX.war. This archive file can also be opened with a ZIP utility so that you can extract its content. This will give you access to the various configuration files, style sheets, image files, etc.

the logo file is located at opencrx-core-CRX-web.ear\opencrx-core-CRX.war\images\logo.gif
colors, fonts (type, size, etc.), and basic layout are defined in the various style sheets provided with openCRX - they are located in the directory opencrx-core-CRX-web.ear\opencrx-core-CRX.war\_style
all the image files, icons, etc. are located in the directory opencrx-core-CRX-web.ear\opencrx-core-CRX.war\images
you can customize the openCRX headers and footers by changing the files edit-footer.html, edit-header.html, show-footer.html, and show-header.html located in the folder opencrx-core-CRX-web.ear\opencrx-core-CRX.war
every openCRX object features various user-defined fields - they are already present in the UML model (please refer to the openCRX UML models and look for LogicalView/org/opencrx/kernel/generic/CrxObject) and in the database, but disabled/hidden in the user interface due to settings in the ui-config file common.xml; to make a user-defined field visible in the user interface, create a ui ElementDefinition for that particular attribute and set it to active (you will have to consult the openCRX Customization Guide for details)
you can hide unused fields/attributes by setting the <active>-tag of the corresponding ui ElementDefinition to false (please refer the openCRX Customization Guide for details and examples)
by editing the appropriate xml-files located in the directory opencrx-core-CRX-web.ear\opencrx-core-CRX.war\WEB-INF\config\ui\en_US you can change the layout of any openCRX object (please refer the openCRX Customization Guide for details and examples)
you can change openCRX code tables to your liking if the predefined ones do not suit you - please note that by default code tables are loaded by the Root-provider, i.e. any changes to code tables must be implemented by changing the appropriate files located in opencrx-core-CRX-Root-web.ear\opencrx-core-CRX.war\WEB-INF\config\code\en_US (please refer the openCRX Customization Guide for details and examples)
openCRX is distributed with many predefined filters - you can define your own user-defined filters and add them to the directory opencrx-core-CRX-web.ear\opencrx-core-CRX.war\WEB-INF\config\filters (please note that filters are loaded in the startup phase, i.e. you need to restart your application server to load new filters)