Ensuring Theme Press Compatibility with Scroll Versions and Translations
Changing the Theme Press and Scroll apps settings so you can use both in the same space.
After installing Scroll Versions or Translations 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.
With the release of Theme Press version 3.1, you can now use both apps in your space. A System Administrator should perform the steps below to ensure compatibility.
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 edit your layout so that Page Title, Breadcrumbs, and Page Information are all visible.
We also recommend hiding the Navigator and Page Tree sections on your layout, as these reveal the special Scroll Version drafts of each page (these start with a period).
Enable 'editor.ajax.save' dark feature
Scroll Versions relies on the "editor.ajax.save" dark feature, which may be disabled by earlier versions of 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.
Site-wide (global)
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]]
