Binding your theme to the context root of the web application | HCL Digital Experience
You must bind your theme to the context root of the web application for your theme.
About this task
You can bind your theme by using XMLAccess in two ways: on the command line or in the Portal Administration pages. Use the steps in this procedure to bind your theme by using XMLAccess on the command line.
To bind your theme by using XMLAccess in the Portal Administration pages, click the Administration menu icon. Then, click . Click Browse and select the input.xml file. Then, click Import and copy the results from the View Details window.
Procedure
-
In PortalServer_root\bin, create
the file input.xml with the following contents:
<?xml version="1.0" encoding="UTF-8"?> <request xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:noNamespaceSchemaLocation="PortalConfig_8.5.0.xsd" type="export" > <portal action="locate"> <skin action="export" objectid="*" /> <theme action="export" objectid="*" /> </portal> </request>
-
From a command line, change to the PortalServer_root\bin directory and run the following xmlaccess command to export all skin and theme definitions to a file called
output.xml:
xmlaccess -user admin userid -password admin password -url hostname:10039/wps/config -in input.xml -out output.xml
-
Edit the output.xml file. Search for the title of your theme, such
asĀ Custom Theme. Scroll up to the line with the surrounding
<theme>
tag. It is likely the last<theme>
tag in the file. Modify it from:
to:<theme action="update" active="true" context-root="/wps/themeModules" default="false" domain="rel" objectid="ZJ_MLSU3F54089F00IP6G7P3F10S5" resourceroot="dynamicSpots">
Set the correct context-root and uniquename for your theme.<theme action="update" active="true" context-root="/customTheme" default="false" domain="rel" objectid="ZJ_MLSU3F54089F00IP6G7P3F10S5" resourceroot="dynamicSpots" uniquename="customTheme">
-
Search for the title of your skin. Scroll up to the line with the surrounding
<skin>
tag; it is likely the last<skin>
tag in the file. Modify it from:
to:<skin action="update" active="true" context-root="/wps/themeModules" default="false" domain="rel" objectid="ZK_73OKBB1A088IE0I5O7IP2J0G77" resourceroot="Hidden" type="default">
Set the correct context-root, resourceroot, and uniquename for your skin.<skin action="update" active="true" context-root="/customTheme" default="false" domain="rel" objectid="ZK_73OKBB1A088IE0I5O7IP2J0G77" resourceroot="customSkin" type="default" uniquename="customSkin">
Note: resourceroot was used in previous versions of Portal when multiple themes were deployed in the same WAR file. It indicates which folder in the WAR file to find the specific theme. For the skin, this parameter should be set to the folder name where the skin is located. -
Find the
<theme>
tag for the Portal 8.5 theme. It is likely the first<theme>
tag in the file. Find and copy one of the<allowed-skin>
tag lines, such as:
Find the<allowed-skin skin="ZK_CGAH47L00GJJ40IDC03MS13OS2" update="set"/>
<theme>
tag for your customTheme theme; it is likely the last<theme>
tag in the file. Paste the<allowed-skin>
tag line in just before the<parameter>
tags. Modify the skin parameter value identifier to be the unique name of your customSkin skin, which can be found in the uniquename parameter of the<skin>
tag of your customSkin skin. It is likely the last<skin>
tag in the file, such as:<allowed-skin skin="customSkin" update="set"/>
-
From the command line, run the following xmlaccess
command to update the skin and theme definitions according to your change:
xmlaccess -user admin userid -password admin password -url hostname:10039/wps/config -in output.xml -out output2.xml
-
From the command line, run the following xmlaccess
command to export all skin and theme definitions again to a file called
output3.xml.
xmlaccess -user admin userid -password admin password -url hostname:10039/wps/config -in input.xml -out output3.xml
- Edit the output3.xml file to verify that the result works, and then delete the input.xml, output.xml, output2.xml, and output3.xml files.