Versions Compared

Old Version 46

changes.mady.by.user Madzy Soetman

Saved on

compared with

New Version 47

changes.mady.by.user Madzy Soetman

Saved on

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

We’re here to help you make your migration as smooth as possible.

...

Refined Sites for Confluence Cloud combines key features from Refined for Server/Data Center (DC) with the convenience of the cloud. However, there are also some notable differences between the two products.

Creating and editing Confluence Content

The Refined Sites apps for Server/DC and Cloud operate differently from each other, which impacts the way you create and edit content.

On Server/DC, Refined Sites is added on top of Confluence: when enabled globally, Refined Sites acts as a skin applied to native Confluence. This means that users view, create and edit Confluence spaces, pages and blogs all through the sites you create.

...

Migrating to a new platform can be a great opportunity to rethink your Confluence and Refined Sites setup. We recommend to evaluate what was working well on the Server/DC instance - and what you can improve. You can opt to replicate your Server/DC setup on Cloud with improvements here and there, or see Cloud as a blank canvas to create a totally new setup. Whichever option you choose, ask yourself how you can leverage these key advantages of the Cloud infrastructure:

...

This table shows which Refined Sites for Confluence Server/DC macros you can keep using if you get Refined Toolkit on Cloud.

...

Refined Toolkit for Confluence Server/DC

Refined Toolkit for
Confluence Cloud

UI Button

Button

  • Supported settings: Title, URL, Tooltip, Size, and Color.

  • Unsupported settings: Icon, Display, Open in a new window

  • It’s not possible to set custom color profiles on Cloud.

  • URLs are static. If they link to local pages and blog posts in Server/DC, you need to manually change the link to the new URL in Cloud.

UI Children

Child Pages

  • Supported setting: Page

  • Unsupported settings: Display, Columns, Sort children by, Reverse sort

UI Children Cards

Turns into a Child Pages macro with the cards display mode.

UI Expand(s)

Expand (Container)

  • Supports the same settings as on Server/DC

UI Image

  • Images are migrated if you have Refined Toolkit Cloud, but they are not editable. To add images in Cloud, simply insert them in the Confluence Editor.

UI Step(s)

Step (Container)

  • Unsupported setting: Size

UI Tab(s)

Tab (Container)

  • Supports the same settings as on Server/DC

UI Text Box

Panel

  • Supported setting: Type

  • Unsupported settings: Text size, Show icon

  • It’s not possible to set custom color profiles on Cloud.

This table shows Refined Sites for Confluence Server/DC macros that aren’t supported in Cloud – neither by Refined Sites nor by Refined Toolkit. Where applicable, we suggest workarounds for your setup.

Refined Sites for Confluence Server/DC

Workaround for Cloud

Divbox

Although the Divbox macro doesn’t exist on Cloud, images and text within the Divbox macro are migrated if you have Refined Toolkit. Macros in the Divbox are not rendered due to technical limitations – read more about this in step 4d below.

Favorite Pages

Users can save Confluence pages on your Refined site for future reference, by clicking the Star icon in the top-right corner of a page. By clicking My favorite pages in the avatar menu, users see an overview of all pages they saved.

My Work

After you migrated to cloud, create a Layout Editor macro and place an Activity Stream macro in it. Set up the Activity Stream macro with CQL: type=page AND contributor = currentUser()

Note that this solution will only work in native Confluence, because Refined sites can’t show Layout Editor macros.

Search

Use Confluence’s Livesearch macro.

Space News

Use Refined Toolkit’s News macro instead.

Create Space Button

Spaces

User Details

User Network

Users

Users in Category

Users in Space

Due to differences between Server/DC and Cloud, these macros become irrelevant after migration. That’s why they aren’t supported and don’t have a workaround.

...

App

Description

Refined Sites for Confluence Cloud
Required

Required app.

Refined Toolkit for Confluence Cloud
Optional

Install if you assessed during preparation that you need it to keep using your macros on Cloud.

Refined Sites for Jira Service Management Cloud
Optional

Install if you want to integrate service desks into your Cloud sites.

Step 3. Upgrade Refined

...

for Confluence Server/DC

Upgrade Refined Sites for Confluence Server/DC to the latest available version. How to upgrade depends on which version you currently use. To check your current version, go to the Confluence Administration > Manage apps.

Your current version

How to upgrade

Version 1.0.0 - 5.1.19

  1. Install version 6.1.21 from Atlassian Marketplace.

  2. Navigate to Refined Administration and click the Upgrade button.

  3. Follow the steps below (for version 6.0.0 - 7.0.x).

Version 6.0.0 - 7.0.x

  1. Go to the Confluence Administration > Manage apps.

  2. Install the latest version of Refined Sites for Confluence.

  3. Make sure Refined Sites is compatible with your Confluence instance.

  4. Make sure that your Confluence instance is fully backed up.

  5. Go to the Confluence Administration > Refined Sites > Configuration.

  6. Click the Upgrade the theme data to Refined Sites 7.1.x data button.

  7. When you have upgraded Refined Sites for Confluence, advise your users to refresh their browser. Stylesheets and scripts have changed in new versions and need to be reloaded. 

Version 7.1.x or newer

  1. Go to the Confluence Administration > Manage apps.

  2. Install the latest version of Refined Sites for Confluence.

Step 4. Export a site with the migration assistant

...