Embedding a toolbar into a theme by adding a dynamic content spot to an HTML template | HCL Digital Experience
Embedding a toolbar into a theme with a dynamic content spot provides an optimized user experience when compared to embedding it dynamically.
Procedure
- Configure the site toolbar. To add the site toolbar theme
modules to the theme profiles of your theme, choose one of the three
different theme modules.
- wp_toolbar_host
- The first level module of the HCL Portal 8.5 site toolbar. It groups all of the resources that are required to run the toolbar in your theme. It supports view mode and edit mode.
- wp_toolbar_host_view
- Contains all toolbar resources that are needed for view mode.
- wp_toolbar_host_edit
- Contains all toolbar resources that are needed for edit mode.
-
Use
wp_toolbar_host
alone, or combinewp_toolbar_host_view
with thewp_toolbar_host_edit
module.- If you have a theme profile which does not have a deferred section, you need to add the
wp_toolbar_host
theme module.{ "moduleIDs" : [ "getting_started_module", "wp_toolbar_host", ... ] ... }
- If you have a theme profile with a non-deferred and a deferred section, it is recommended to
combine the
wp_toolbar_host_view
with thewp_toolbar_host_edit
module. In that case you must add thewp_toolbar_host_view
to the non-deferred section andwp_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 you enter edit mode.
- If you have a theme profile which does not have a deferred section, you need to add the
-
Add the dynamic content spot of the version 8.5 toolbar to the theme templates. To integrate
the new toolbar to your theme, you must add a dynamic content spot to the theme HTML templates of
your theme. The ID of the dynamic content spot is
85toolbar
. - 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 your page
<div class="wpthemeFrame"> <header role="banner"> <a rel="dynamic-content" href="dyn-cs:id:85toolbar"></a> ...
- Add this dynamic content spot to the locale-specific versions of your theme templates.
- 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.
- After you embed a toolbar, you must either restart your portal server. Or, you must use the WebSphere® Integrated Solutions Console to invalidate the resource aggregator cache. To invalidate your cache, click . Auto invalidation recognizes your changes automatically for WebDAV based themes. No further action is required. For more information, see Utilities.