Create a custom Page Builder theme


Overview

To create a custom Page Builder theme, copy and edit an existing Page Builder theme. Do not modify the Page Builder theme directly, as this theme can be updated by service fix packs and override changes.

Note that we do have to create a Page Builder-type theme. We can create a theme based on Portal v6.1.* themes.


Create new Page Builder type theme

  1. Mount the /themelist WebDAV entry point with WebDAV client:

      /WpsContextRoot/mycontenthandler/dav/themelist/

    Replace WpsContextRoot with the value of WpsContextRoot if you have changed it.

  2. Copy and rename the folder of the theme on which you want to base new theme.

    The /themelist WebDAV entry point does not support the copy action directly. If you encounter an error when you copy and paste theme folders within /themelist, do the following:

    1. Copy the theme folder to local file system.

    2. Give the theme a new title by editing the appropriate localized_locale.properties file under the metadata folder. If you do not change the theme title, the portal will show multiple themes with the same titles in selection lists.

    3. Copy the new folder to the /themelist folder.

    After you have completed these steps, new theme is defined in the portal database. If you do not see new theme in the Themes and Skins or Page Properties portal administration portlets, edit a theme that you find listed, then press OK without making any updates. This refreshes the theme model list; new theme should now show. As an alternative, you can also restart the portal.

You can now assign the theme to pages as required. To customize theme, edit the theme files in WebDAV.

To perform administrative customization, for example to the title, description, or metadata of the theme, continue to use the /themelist/ entry point. To customize the templates and static resources, use the /fs-type1/ entry point. At this point theme still points to the same Default.jsp and dynamic content spots as the portal Page Builder theme.

If you have problems using the /themelist/ entry point, try /themelist/all , as some WebDAV clients have issues listening without the all .

Change the theme template location

The theme contains a metadata parameter that stores the location of the theme template theme.html . This parameter is named com.ibm.portal.theme.template.ref . Its value can point to an external location if required, for example to a POC URI or an external server. Therefore the theme template does not need to be stored on WebDAV. In a default portal installation the metadata parameter for the Page Builder theme looks like this:

<parameter name="com.ibm.portal.theme.template.ref" type="string" update="set">
           <! [CDATA [dav:fs-type1/themes/PageBuilder2/]]&gt;</parameter>


Parent

Develop custom themes


Related

  1. Use WebDAV to manage themes and skins
  2. Location of theme resources


+

Search Tips   |   Advanced Search