Appboard/2.5/builder/system administration/themes

Revision as of 03:48, 21 February 2015 by imported>Mike.berman (add Replacing Logos and Background Image)

Overview

An AppBoard Theme is a collection of settings that manage the overall visual presentation of the application to the end-user in the web browser. Elements included in a Theme include colors, button styles, shadows, borders, backgrounds, and so on.

The theme engine is extremely flexible and capable of a wide variety of styles as shown through the default themes shipped with the product. Custom themes can be created by extending the base themes to match the style and look for your organization or group.

Base Themes

AppBoard Themes


AppBoard ships with a number of base themes as shown above (left-to-right): Dark, Flat, Frosted Glass, Light, Minimalist, and Smoked Glass. Please note the base themes are not editable and are shown with a lock icon in the Theme Manager. See the Managing Themes section for more information on how to build custom themes based on the base themes shipped with AppBoard.

Managing Themes

Theme Manager administration page


Perform the following to manage Themes:

  1. Log in to AppBoard Builder as an administrator.
  2. In the Builder Modes panel, select System Administration, then select Theme Manager. This will launch the Theme Manager panel.

To activate a theme, select a theme from the list of available themes, and click the "Activate Theme" option in the bottom toolbar. The checked theme indicates the currently active theme.

Template-note.png
After changing or modifying themes, a browser refresh should be performed to ensure all theme changes are applied.


Creating a New Custom Theme

Perform the following steps to create a new Theme:

  1. Click "Add" in the bottom toolbar. This will launch the "Theme Editor".
  2. Enter a name for the new Theme to be created.
  3. Click "Add Theme".
  4. The Theme is created with a set of default settings.
  5. Modify the Theme as desired, and then click "Save Changes" to save the changes to the Theme.
  6. Apply the theme to the system, if desired, by clicking "Activate Theme" in the bottom toolbar.
Template-note.png
If you manually set backgrounds to be dark while using the light theme, then some of the default dark text colors will become unreadable. The best practice is to switch to the "Dark" template if you want a dark look and feel. Doing so will ensure default text colors are readable.


Deleting a Theme

Perform the following steps to delete a Theme:

  1. Select the Theme from the list of available Themes.
  2. Click "Delete" in the bottom toolbar.
Template-note.png
You can only delete custom themes. You can not delete the base themes that ship with AppBoard. You also can not delete a Theme while it is the currently active Theme. In such case, activate another Theme first, and then delete the Theme.


Editing a Theme

Perform the following steps to edit the settings for a Theme:

  1. Select the Theme from the list of available Themes.
  2. Click "Edit" in the bottom toolbar. This will launch the "Theme Editor".
  3. Modify the Theme as desired, and then click "Save Changes" to save the changes to the Theme.
  4. Apply the Theme to the system, if desired, by clicking "Activate Theme" in the bottom toolbar.
Template-note.png
You can only edit custom themes. You can not edit the base themes that ship with AppBoard.


Using the Theme Editor

An AppBoard theme is a collection of overrides for a default set of attributes. Rather than build up a Theme from scratch, AppBoard Themes start with default values pre-populated from a template. AppBoard ships with a number of base themes to provide a range of starting points.

To get started, select a Theme Template using the pull-down selector at the top of Theme Editor. The base template is all that is required for a Theme. A new Theme without any overrides is basically just a copy of the Theme Template.

By selecting a different Theme Template, you will swap out the base values used by the current Theme. Any overrides configured as part of your new Theme will persist; however, the values used in your overrides may no longer make sense after you have switched from a "Dark" theme to a "Light" theme.

Refer to the Theme Editor Categories page to explain the grouping categories for configurable options. Also refer to the Theme Editor Controls to describe the types of controls available for theme options.


Theme Editor

Migrating Custom Themes

Themes consist of two parts:

  1. Theme Configuration
  2. Theme Assets: logo graphics, background images, etc..

By default any theme configuration is automatically backed up when performing a full backup. Further, any theme assets located in [INSTALL_HOME]/server/webapps/enportal/visualizer/assets/custom/ will also be included in any backup archive. Other theme assets existing elsewhere on the filesystem should be added to the custom export list to ensure the files are included in backup archives. See the Customizing the Export section of the Backup & Recovery page for more information.

To migrate a custom theme to another AppBoard instance altogether then the Import/Export tool can be used, but please note this only includes theme configuration and the theme assets will have to be copied separately. Refer to the Import/Export documentation for more information. It's also important to include any themes which the exported theme may be dependent on, if not directly dependent on a base theme.

Replacing Logos and Background Image

Appboard Banner

The default AppBoard logo location is: [INSTALL_HOME]/webapps/enportal/visualizer/assets/images/logo_banner.png


Perform the following steps to replace the default logo:

  1. Navigate to [INSTALL_HOME]/webapps/enportal/visualizer/assets/images
  2. Open logo_banner.png in an image editor.
    • The dimensions of the image are 128x48 pixels, but the logo itself is only 32 pixels high
    • Note: The image height is the same height as the banner, so any desired padding should be added into the image
  3. Paste desired logo into this file
  4. Adjust padding to taste
  5. Overwrite logo_banner.png with the new image


Perform the following steps to replace the background image:

  1. Create the new background image in an image editor
  2. Save the new image file to [INSTALL_HOME]/webapps/enportal/visualizer/assets/images/backgrounds
  3. Do the following to configure the Theme to reference the new background image:
    1. Log in to AppBoard as an administrator
    2. Launch the Theme Editor
    3. Make sure you have created a custom Theme, and are editing that Theme (system Themes are not editable)
    4. Under the "Global" section, check the "Background Image" box and edit the value to the location of your custom image, relative to [INSTALL_HOME]/server/webapps/enportal/visualizer/
      • Example: assets/images/backgrounds/myImage.gif
Retrieved from "http://ab.edge-technologies.com/docs/index.php?title=Appboard/2.5/builder/system_administration/themes&oldid=6576"