Changing the Theme Press and Scroll apps Settings so you can use both in the same space.

After installing Scroll Versions on a Theme Press-enabled space, you may encounter one or both of the following error messages:

  • The theme of this space is not compatible with the theme integration of Scroll Versions and Scroll Translations.
  • Scroll Content Management apps are not compatible with your current configuration. The Confluence default behaviour for the following dark feature 'atlassian.darkfeature.editor.ajax.save' was overwritten via System properties. Please revert to the defaults.

The steps below describe how to ensure that Theme Press is compatible with Scroll Versions and Scroll Translations. You must be a System Administrator to perform these tasks.

Edit your Page Design to show Page Title, Breadcrumbs, and Page Information

The Scroll Version and Scroll Translation apps insert elements onto the page that some Theme Press layouts may have hidden. Be sure to update your layout so that Page Title, Breadcrumbs, and Page Information are all visible.

Enable 'editor.ajax.save' dark feature

Scroll Versions relies on the "editor.ajax.save" dark feature, which may be disabled by Theme Press or other Brikit Apps. To re-enable it, visit the dark features page, scroll to the "Site Dark Features" section, locate "editor.ajax.save.disable", and click the "remove" button next to it.

Navigate to Space or Site Scroll Settings

Space

Enter the following URL in your browser's window, replace the parts specific to your environment, and hit enter.

<Confluence Base URL>/plugins/servlet/scroll-settings/?key=<space key>

Site-wide (global)

Confluence Gear Icon > General Configuration > Scroll Runtime > Advanced Plugin Settings

Update the 'theme-integration.json' settings

Find the item called "theme-integration.json" and click "Edit".

Paste the following into the code area, then click save.

{
   "isThemeCompatible": true,
   "contentManagementToolbarSelector" : ".brikit-toolbar #navigation"
}

This tells the Scroll apps that Theme Press is indeed a compatible theme, and updates the display of the Scroll Management Toolbar to the corresponding Theme Press HTML element.

Check for Compatibility

Navigate back to your space where both Theme Press and Scroll Versions (and/or Translations) are enabled. You should now be able to see all the Scroll components (e.g. Version Toolbar selector, version information, page key, and so on).

[[SCREENSHOT HERE of COMPATIBLE PAGE]]

If using:

  1. Replace me with something to note about this how-to entry that falls outside the scope of all other sections; and
  2. Add the tight-bottom class to the Steps block above to narrow the gap between the two blocks.

If using:

  1. Replace me with something to note about this how-to entry that falls outside the scope of all other sections; and
  2. Add the tight-bottom class to the next visible/non-collapsed block above this one to narrow the gap between the two blocks.

If using:

  1. Replace me with something to note about this how-to entry that falls outside the scope of all other sections; and
  2. Add the tight-bottom class to the next visible/non-collapsed block above this one to narrow the gap between the two blocks.

If using:

  1. Replace me with something to note about this how-to entry that falls outside the scope of all other sections; and
  2. Add the tight-bottom class to the next visible/non-collapsed block above this one to narrow the gap between the two blocks.