...
The folder (not zipped) should be defined locally in the installation root under the folder [drive]:/[webapp_path]/Themes/ThemeName
In this case no Theme base URL needs to be defined.
This option is not available on Meridix hosted installations
...
As a uploaded theme package (zipped archive)
The zipped theme file should be available uploaded to the Meridix server on a public accessible URLsystem on the page Administration->Settings->Theme settings inside Meridix Studio. When a theme is set in and the package type is Theme package Meridix Studio the system downloads loads and extracts the custom theme to an internal temporary folder and loads the resources from that folder location for future requests.
When uploading a new version of an existing theme append an incremented version number in the theme name to bypass the internal theme cache that caches a loaded theme for a minimum of three hours. Ex: ThemeName_V1.zipthe package mechanism creates a checksum based on the content of the package and compares it to any existing extracted packages with the same name, if the content has changes (i.e. the checksum) the new package replaces the existing one.
The name of the zip file should be the theme name. (Do not add the .zip extension to your theme name setting in Meridix Studio this is added automatically if the package type is set to Zip fileTheme package).
On external server as folder structure (development only)
The theme folder (not zipped) should be available to the Meridix server on a public accessible URL where each individual resouce can be accessed with the url [ThemeBaseUrl]/[ThemeName]/[ThemeResourceRelativePath] ex: http://mycompany.com/Themes/CustomTheme/css/base.css where the http://mycompany.com/Themes is the Theme base URL part and CustomTheme is Theme name and css/base.css is the ThemeResourceRelativePath.
In this case each time a resource is requested (and not found in the server cache) the system loads the resource from the external resource url internally and the caches the resource for future requests.
This method is only recommended during developent of new themes because it requiers the Meridix installation to make several HTTP requests to get the theme content. But its the easiest way to design new themes since you can change the content on a server controlled by you and it will be used by the Meridix installation.
| Note |
|---|
| Should not be used in a production environment since it forces the server to make several HTTP requests to get the resources. So when you have used this method during the design phase compress the folder to a zip file with the name [ThemeName].zip and upload it as a theme package inside Meridix Studio. (Remember to change the Theme package type setting from Remote folder to Zip file. Theme package) |
Configure Meridix Studio to use a custom theme
...
| Info |
|---|
| The default theme can be downloaded here inside Meridix Studio (at the bottom of Administration->Settings->Theme Settings) and be used as a template. (download and unzip to a local folder and make your changes). All the folders below should be on the root level of a Theme package. |
- config
- ui_colors.json
- css
- base.css
- help_popup.css
- login_page.css
- images
- favicon_default.ico
- flag_eng.png
- flag_swe.png
- icon_{description}_{size}.png (multiple)
- ....
- load_animation_{description}.gif (multiple)
- ....
- scripts
- login_page.js
- telerik
- common
- grid
- css
- Calendar.Metro.css
- ComboBox.Metro.css
- Grid.Metro.css
- Input.Metro.css
- Menu.Metro.css
- TabStrip.Metro.css
- TreeView.Metro.css
- metro
- Calendar
- sprite.gif
- ComboBox
- rcbSprite.png
- Grid
- AddRecord.gif
- Cancel.gif
- Delete.gif
- Edit.gif
- export.gif
- Filter.gif
- loading_small.gif
- MoveDown.gif
- MoveUp.gif
- PagingFirst.gif
- PagingLast.gif
- PagingNext.gif
- PagingPrev.gif
- Refresh.gif
- rgDrag.gif
- SingeMinus.gif
- SinglePlus.gif
- SortAsc.gif
- SortDesc.gif
- sprite.gif
- Update.gif
- Input
- sprite.gif
- Menu
- rmExpandArrows.png
- TabStrip
- TabStripStates.png
- TreeView
- LoadingIcon.gif
- PlusMinus.png
- TriState.png
- Calendar
- common
...