.. _add_a_theme:

Add a Theme on the Legacy Admin Portal
---------------------------------------

.. _12.5(1)|VOSSUC-20692:
.. _18.1-Patch-Bundle-3|VOSS-346:


1. Prepare the theme file:

   a. The recommended procedure is to use an export of an exiting theme as a baseline
      and update it with a new name, images and colours as required. Refer to 
      :ref:`download__edit_and_update_a_theme` for details.
   #. Create a folder with the required name of the theme and un-zip the exported theme
      in it, maintaining directory structure.

      The name of the folder must be the same as the intended theme name
      (only alphanumeric characters or underscore can be used, with no spaces or special characters).
   #. Add any CSS overrides to the file. Note that only the definitions as shown
      in the export of a provided CSS file ``skin.css`` can be modified.
   #. Add required image files in this folder (if any).

      .. important::

         If customization is done on MS Windows, check that no ``desktop.ini``
         files reside in the directory tree of the theme before compressing it.

   #. Create a .zip archive file with the same filename as the folder.

   
   
#. Add the theme to the system:

   a. Choose the hierarchy level at which the theme will be created.
   #. Choose **Role Management > Themes** to open the **Themes** list view.
   #. Click **Add** on the button bar to open the **Themes** input form. Note that
      themes can only be customized by a Provider Administrator (or higher).
   #. Enter the **Theme Name** (same as the file name created above).
   #. Enter **Navbar Text** if needed. This will show on the navigation bar next to
      the logo.
   #. Enter an appropriate **Site Title** if required. The site title entered here
      is the text displayed in the browser tab.
   #. Click the **Browse** button to import the created theme zip file. 
      Wait until the system displays the file chosen in the **Import File** field.
   #. If the theme must also apply to the login page, select the
      **Use this Theme to style Login page** check box. 
   #. To set login banner text and notices on the login page, refer to :ref:`set_the_login_page_theme`.
      The **Use this Theme to style Login page** check box does not have to be
      selected for banner text to show.
   #. If you want to hide the theme from lower level hierarchies, select the
      **Hide from Lower Hierarchies** check box. Users logged in at lower level
      hierarchies will not be able to see that particular theme on the **Themes**
      list view screen.  
   #. For details on the **Theme Customization** tab controls, refer to :ref:`create_theme_in_BAP`.

      .. note::
      
         If any details are added on this tab, *all* fields should be provided with input.

   #. Choose **Interface** to which the theme applies from the drop down.
      By default the theme applies to the Administration interface.
   #. Click **Save** on the button bar when complete.

      .. note::

         Do not leave the screen until the processing of the theme completes and theme list is refreshed.
         This can take a few minutes depending on details and complexity of theme uploaded.  

.. |VOSS-4-UC| replace:: VOSS-4-UC
.. |Unified CM| replace:: Unified CM