.. _create_theme_in_BAP:

Create a Theme in the Business Admin Portal
-------------------------------------------

The **Themes** interface can be used to create a theme that applies to the Business
Admin Portal as well as the VOSS-4-UC Administration GUI.


.. note::

   * A theme created in the Business Admin Portal will also show and can be edited from
     the VOSS-4-UC Administration GUI (see under "Themes" in the Core Feature Guide for details).
   * Since two themes are now compiled when saving a new theme on the Business Admin Portal,
     this takes slightly longer than theme compilation on the VOSS-4-UC Administration GUI.
   * Themes created in the Business Admin Portal:
    
     * cannot be exported in full from the Business Admin Portal, so that it can be imported
     * will show in the VOSS-4-UC Administration GUI, where they can be exported


Use the **Preview** button |new-bap-theme-preview-icon| to preview the saved theme before it is applied
to the user interface by assigning it to a user role.


Theme Details
.............

.. note::

    If the Business Admin Portal Theme interface is to be used for
    full Administration GUI theme configuration, a Custom Admin GUI File 
    should be uploaded.

* **Custom Admin GUI File**:

  * If a *theme file is added*:
  
    the theme file will apply the VOSS-4-UC Administration GUI,
    while the theme customization updates made in the **Branding** group
    of controls will *only* apply to the Business Admin Portal.
  * If *no theme file is added*:
  
    the theme updates made in the **Branding** group of controls
    are applied to VOSS-4-UC Administration GUI *and* the Business Admin Portal. 
    The **Custom Admin GUI File** upload control is then *not* available
    for theme modification.


Branding
........

* Color selection:

  * Select a color using either the color picker control or by typing in the color hex value.
    The color picker control is only available on the Business Admin Portal theme interface.

    Refer to:
   
   * :ref:`BAP_theme_color_reference`.
   * :ref:`reference-admin-gui-theme-customization-colors`

* Image upload:

  * Note the file size and *width x height* pixel dimension size restrictions (shown on the context sensitive help) for images.
    A warning message will also show if selected images are too large.

    The **Logo** image format must be PNG format. Other images can be PNG or JPEG. 
  * The **Menu Background** image does not apply to the VOSS-4-UC Administration GUI.
    

.. |new-bap-theme-preview-icon| image:: /src/images/new-bap-theme-preview-icon.png