Info | ||
---|---|---|
| ||
This page documents the usage with the Common Theme, the pre-Common-Theme documentation is here: Visual Themes - How to |
Warning | ||
---|---|---|
| ||
The documentation below is deprecated since R17.12 branch. It's better to refer to themes/README.adoc in source |
The documentation bloc below is the HTML import of the conversion of README.MD into HTML by Pandoc using this command line locally in root folder.
Code Block |
---|
pandoc themes/README.md -s -o tools/wiki-files/themes/README.md.html |
...
Table of Contents |
---|
HTML | ||
---|---|---|
|
How to install a Visual Theme
A Visual Theme is distributed as a single .zip file like for example vt_chrome.zip or vt_multiflex.zip.
- Download the zip file from the Gallery
- Unzip it in the OFBiz hot-deploy folder
- Issue the "ant run-install" command in your OFBiz home folder
From this moment your added Visual Theme is installed and available in the OFBiz framework.
How to create a Visual Theme
An OFBiz Visual Theme consists of a simple OFBiz component installed, usually, in the hot-deploy folder. In the component, all the resources needed by the Visual Theme are defined.
The simplest way to create a Visual Theme is starting from one of the already available themes in the gallery.
Let's assume you want to create a new theme called vt_mytheme and have selected vt_multiflex as a starting template.
...
Panel |
---|
Please consider that all images references in your css file must be linked using the "/vt_mytheme" path. For example if you have a background.jpg image you should use the following address: url(/vt_multiflex/background.jpg) |
...
Your theme is now ready to be installed.
If you want to upload your theme to the Visual Theme Gallery, simply create a mytheme.zip file from the hot-deploy/vt_mytheme folder and upload to the gallery.
...