Skip to end of banner
Go to start of banner

Future macro - Interoperability - 7.x

Skip to end of metadata
Go to start of metadata

You are viewing an old version of this page. View the current version.

Compare with Current View Page History

« Previous Version 16 Next »

Summary

The Future macro works well with many macros, however, there are numerous cases where the interactions of the Future macro with other macros does not produce the expected result. The background rendering of the content can prevent more advanced macros from behaving as expected. Similarly, some advanced macros can interfere with the communications needed by the Future macro to display the content that is rendered in the background. Fixes have been provided for some of the most prevalent use cases and more can be considered in the future based on user need. Even though there are a number of interoperability issues, the benefits for some of the most common scenarios warranted delivery. Plus interoperability is significantly better than the old future plugin provided.

This page is intended to document interoperability with other advanced macros. In some cases, there are restrictions or work-arounds for using the macros together. In other case, improvements are needed in the implementations to work better together. Feedback from users with experience with other macros not listed here will help everyone be able to use the support more effectively. Please vote and open new issues if necessary.

Outer Macro

MacrosStatusTested

Restrictions & Workarounds

Discussion
futurefuture(warning)(tick)

Since 6.4, many scenarios are now covered. The most significant restriction is Future within an Include within a Future macro.

Confluence 5.4.3 or above provides the most scenario coverage.

CACHE-104 - Getting issue details... STATUS

CACHE-60 - Getting issue details... STATUS

futurecache(tick)(tick)

Since 6.2. Prior to 6.2, Cache refresh link does not work inside a Future macro.

future

table-plus, sql, csv, excel

(tick)(tick)

futurerun, run-now(tick)(tick)

futurecloak(error)(tick)

futuremetadata macros(tick)(tick)
CACHE-83 - Getting issue details... STATUS
futurescaffolding macros(tick)(tick)(warning) Does not work in edit contents mode
CACHE-83 - Getting issue details... STATUS CACHE-132 - Getting issue details... STATUS
future

report-table, report-variable

(error)(tick)
CACHE-146 - Getting issue details... STATUS
futureother reporting macros(tick)(tick)
There is a user report CACHE-64 - Getting issue details... STATUS
futureexpand(tick)(tick)

Requires release 6.1 and at least Confluence 5.0

For Confluence 7.0 and later versions, when you use the future macro embedded with an expand macro multiple times in a page, it does not expand and collapse as expected. This is because of a known issue - CONFSERVER-40562.

CACHE-74 - Getting issue details... STATUS
tocfuture on same page(tick)(tick)
CACHE-59 - Getting issue details... STATUS

expand

future(tick)(tick)

CACHE-62 - Getting issue details... STATUS

Similar results for other Expand like macros that selectively show data

cloakfuture(tick)(tick)

deck/card

future(tick)(tick)

Requires 6.1.1. Use Future macro for one or more cards. This is the most typical situation.

CACHE-62 - Getting issue details... STATUS , CACHE-87 - Getting issue details... STATUS

localtabgroup/localtab

future(tick)(tick)Requires 6.4.

CACHE-62 - Getting issue details... STATUS

cachefuture(warning)(tick)

It works, but is of little value as Cache captures the rendered body without the rendered data from the Future macro. Each rendering of the page will result in the Future macro getting the data in the background again.

macros requiring web resources

Examples:

  • show-if, hide-if and similar
future(warning)(tick)

(tick) Confluence 4.x - 5.1

(warning) Confluence 5.2 - 5.4.2

(tick) Confluence 5.4.3+ with Cache for Confluence 6.3 or above.

CACHE-63 - Getting issue details... STATUS A workaround is to have the macro requiring resources be on the page outside of the Future macro. Perhaps in a Hide macro with rendering.
Refined Wikifuture

(warning)




CACHE-69 - Getting issue details... STATUS
future

OfficeConnector

  • viewxls
  • viewdoc
  • viewppt
  • viewpdf


  • (tick)
  • (tick)
  • (error)
  • (error)
(tick)

Requires release 6.1

Resolved with Confluence 5.4.3 and above together with Cache for Confluence 6.3 or above.

  • viewppt (tick)
  • viewpdf (tick)

CACHE-78 - Getting issue details... STATUS

The Cache macro used with the Office Connector macros has a compatibility issue in Confluence version 7.9.0. Refer and watch  CACHE-346 - Getting issue details... STATUS  for updates.

futureJIRA macro(tick)(tick)

futurepagetree(warning)(tick)

(tick) Confluence 4.x - 5.1

(tick) Confluence 5.2 - 5.4.2: Requires 6.4

(tick) Confluence 5.4.3 or above: Requires 6.4 and an Atlassian pagetree plugin fix. See Tracked Atlassian issues.

CACHE-92 - Getting issue details... STATUS

CONF-33388

futurepage-gadget(warning)(tick)

(tick) Confluence 4.x - 5.1

(tick) Confluence 5.2 or above: Requires Cache for Confluence 6.4 or above

CACHE-92 - Getting issue details... STATUS
future

code

code-pro

(tick)(tick)

Fixed in Confluence 5.8.5.

Workaround: Make sure the page has a Code or Code Pro macro outside of a Future macro. This brings in the necessary web resources correctly.

Or install the patched version of the Code macro plugin.

CONF-35014 - provides a fix for the Code macro for future versions of Confluence

newcode-macro-plugin-2.1.5.1.jar - a patched version of the code macro for Confluence 5.3 and above

CACHE-114 - Getting issue details... STATUS

futureConfluence table sorting(tick)(tick)

Some Confluence release level restrictions.

Workaround: Use Table Plus macro.

CONF-35452

CACHE-105 - Getting issue details... STATUS

future

excerpt-include

excerpt

(error)
Avoid putting the Excerpt macro within a Future macro if you need to access the data using excerpt-include.
CACHE-183 - Getting issue details... STATUS
chartfuture(error)
The Chart macro excepts all data to be available immediately, so a delayed rendering via Future is not going to work.
LegendStatus
(tick)Works
(warning)Works with some restrictions or workarounds
(error)Does not work in most cases
(question)Unknown

Issues related to Future macro

key summary type created updated due assignee reporter priority status resolution
Loading...
Refresh

  • No labels