Migration - Embed a toolbar into a theme by adding a dynamic content spot to an HTML template

1. Configure the site toolbar.

   To add the site toolbar theme modules to the theme profiles of the theme, choose one of the three different theme modules.

   wp_toolbar_host

   The first level module of the WebSphere Portal 8.5 site toolbar. It groups all of the resources required to run the toolbar in the theme. It supports view mode and edit mode.

   wp_toolbar_host_view

   Contains toolbar resources needed for view mode.

   wp_toolbar_host_edit

   Contains toolbar resources needed for edit mode.

2. Use wp_toolbar_host alone, or combine wp_toolbar_host_view with the wp_toolbar_host_edit module.

   • For theme profiles which do not have a deferred section, add the wp_toolbar_host theme module.

     { 
         "moduleIDs" : [ "getting_started_module", "wp_toolbar_host", ... ]
     ...
     }

   • If we have a theme profile with a non-deferred and a deferred section, IBM recommends to combine the wp_toolbar_host_view with the wp_toolbar_host_edit module. In that case add the wp_toolbar_host_view to the non-deferred section and wp_toolbar_host_edit to the deferred section.

     {
     "moduleIDs"         : [ "getting_started_module", "wp_toolbar_host_view", ...  ], 
     "deferredModuleIDs" : [ "wp_toolbar_host_edit", ...  ], 
     }

     The theme module wp_toolbar_host_edit will not be loaded until we enter edit mode.

3. Add the dynamic content spot of the v8.5 toolbar to the theme templates.

   To integrate the new toolbar to the theme, add a dynamic content spot to the theme HTML templates of your theme. The ID of the dynamic content spot is 85toolbar.

4. To add this dynamic content spot, create a HTML anchor element which references this dynamic content spot. Embed the dynamic content spot in the header of the page

   <div class="wpthemeFrame">
   <header role="that is">
   <a rel="dynamic-content" href="dyn-cs:id:85toolbar"></a>
   ...

5. Add this dynamic content spot to the locale-specific versions of the theme templates.

6. In the default version 8.0 theme, the names of the theme template files are theme.html and theme_sidenav.html.

   The localized versions of theme.html can be found in the locale subfolder, nls. For example theme_en.html.

7. After you embed a toolbar, we must either restart the portal server. Or, use the WAS console to invalidate the resource aggregator cache. To invalidate the cache, click...
   Theme Analyzer | Utilities | Control Center | Invalidate Cache

Parent Migration - Add the v8.5 site toolbar to a version 8.0 theme