ThemeBuilder for Confluence Server and DC

Hmenu Legacy Plugin

Free Hmenu Plugin

We have been reviewing deprecated menus against client use cases where these macros had become an integral part of the theme, and concluded that the simplest solution is to migrate the old menu macros into a separate standalone menu plugin.

If you would like to try the Hmenu plugin you can download it here along with the latest versions of ThemeBuilder and the Exporter plugin. Note that the plugins are Beta versions and should not be installed on live production systems without suitable testing on a development server. If the beta status is a problem for you, but you find that the plugins solve your menu issues, please check back on this page for an update when release versions are available.

This free plugin is provided on condition that it will simply reproduce the Theme Builder menu code as seen in Confluence versions prior to 5. Any issues reported for the plugin used on Confluence 5 will not be considered if they cover conditions where the conflict is with the new Confluence user interface, any Confluence macro or function, or in page content. In these cases the user will be expected to use ThemeBuilder to remedy the issue by adapting the markup or CSS that produces the menu. The exception to this is code bugs which will be resolved as and when developer time allows.

link:[Download] the free Hmenu plugin.

How to Use the Exporter and Hmenu Plugin

The Hmenu plugin is designed to work with a Confluence 3 or 4 Theme Builder backup that has not been migrated to Confluence 5.

If your Confluence 5 server:

  • HAS NOT been used for a ThemeBuilder migration

  • DOES have ThemeBuilder or the Exporter installed

You should follow all steps from 4 onwards to uninstall the existing ThemeBuilder and Exporter plugins and import the original ThemeBuilder backup from the old Confluence server.


If your Confluence 5 server:

  • HAS NOT been used for a ThemeBuilder migration

  • DOES NOT have ThemeBuilder or the Exporter installed

You should follow all steps from 5 onwards to import the original ThemeBuilder backup from the old Confluence server.


If your Confluence 5 server:

  • HAS BEEN used for a ThemeBuilder migration

  • DOES HAVE ThemeBuilder or the Exporter installed

You should follow all the steps to reset the ThemeBuilder data and then import the original ThemeBuilder backup from the old Confluence server.

Instructions

  1. Go to ThemeBuilder Backup > Create Backup > Backup all layouts > Check all boxes > Download the zip backup to a safe place. (You will only need this backup if the Hmenu migration fails and you want to return to this state.)

    hmenu 01
  2. Stay on the ThemeBuilder Backup screen and go to the Reset Layout Data section. (If this is greyed out run the backup action again – the lower areas on the Backup screen only become active when a backup has been saved.)

    1. Enter the Server Base Url (you can copy this from the General Configuration screen) and check the box for ‘Delete layout data before resetting’.

    2. Click 'Delete All'.
      This will clear all ThemeBuilder layout data from your server so only do this if you have the backup from step 1.

      hmenu 02
  3. Go to ‘Manage Add-On’s’ and delete the ThemeBuilder and Exporter plugins. Also delete the Hmenu plugin if this has been installed. This is to ensure that all ThemeBuilder data is reset and ready for a fresh migration.

  4. Install the latest ThemeBuilder and Exporter plugins from: adaptavist-themebuilder-migration-plugins.zip.

  5. Go to ThemeBuilder > Backup > Restore Backup > Upload the unmigrated ThemeBuilder backup from your old Confluence installation.

    1. Check the relevant boxes if you have templates or user macros to import.

    2. Do not check ‘Merge uploaded layout data with existing layouts'.

    3. Check ‘Select builder as the theme based on the data in the backup file’ if you want to carry over previous Confluence to ThemeBuilder relationships eg global theme.

    4. Check ‘Set the skin selection based on the data in the backup file’ if you want to carry over previous Space to Skin relationships.

      hmenu 03
  6. Go to ThemeBuilder > Export Layouts to Skins

    1. Select ‘Export All’ in the dropdown

    2. Check ‘Prevent menulinks and compound-menuitems from being converted to web-items

    3. Check ‘Prevent menubar macros being converted into new single-level format

    4. Click ‘Export’ and save the zip file

      hmenu 04
  7. Install the Hmenu plugin from adaptavist-themebuilder-migration-plugins.zip.

  8. Go to ThemeBuilder > Backup > Restore Backup > Upload the migrated ThemeBuilder backup you saved in step 6.

    1. Check the relevant boxes if you have templates or user macros to import.

    2. Do not check ‘Merge uploaded layout data with existing layouts'.

    3. Check ‘Select builder as the theme based on the data in the backup file’ if you want to carry over previous Confluence to ThemeBuilder relationships eg global theme.

    4. Check ‘Set the skin selection based on the data in the backup file' if you want to carry over previous Space to Skin relationships.

  9. Go to ThemeBuilder > Edit Skins to view your imported skins.

  10. View a space or page with a ThemeBuilder skin applied and check your menus.

There will still be edits needed for menu items that no longer exist in Confluence, or for %name% functions like %Watch%. Note that in our trials we have seen %User% continue to work.