Rotate Content Macro
Rotate Content Macro
This macro creates a visual rotation of content from blocks on another page. The rotated content can be text or graphics or a combination of both.
In Theme Press, we've simplified the process of rotating content. No need for custom code. To create this type of content, you need:
- two Confluence pages
- the page that will display the content
- the page that will hold the content to be displayed
- the Rotate Content macro
- content
Separate Pages
The Rotate Content macro displays content that lives on another page. As an example, look at the simple example below; it holds the macro. The content itself lives on this page. A screenshot of the content page is to the right. Notice how each piece of rotating content lives within its own block.
Macro
The macro provides several options for configuring how to display and rotate content. Most important of these parameters is Page Title where you define the location of content. Other options include time delays, transition types and navigation controls. For details on each parameter, see the Macro Parameters block below.
Content
The Simple Example displays text-only content. You can also display (1) images or (2) text and images. Additionally, you can design blocks that contain the macro and/or content. Review the Best Practices block for tips on design and usage.
Use Case
In addition to the Simple Example below, you can see this macro in use on the Theme Press Demo Space home page.
| Parameter | Description | Value(s) | Example(s) |
|---|---|---|---|
| Page Title | defines a page from which to display block content |
|
|
| Initial Delay | defines the number of seconds to wait before the first transition |
|
|
| Rotation Delay | defines the number of seconds to wait between transitions |
|
|
| Transition Type | defines the type of animation to use between transitions |
|
|
| Display Sequentially | toggles between showing content in order or randomly; select this option to show the navigation controls |
| |
| Extract Content from Blocks | toggles between showing (1) the block and its content or (2) the content only |
| |
| Vertical Position for Controls | defines the position of the navigational controls relative to the top or bottom of the block |
|
|
| Vertical Margin for Controls* | creates space at the top or bottom of the navigational controls; relates to the Vertical Position setting |
|
|
| Horizontal Position for Controls | defines the position of the navigational controls relative to the left or right of the block |
|
|
| Horizontal Margin for Controls* | creates space to the left or right of the navigational controls; relates to the Horizontal Position setting |
|
|
| Use Images for Controls | toggles between using colors or images for the navigational controls; attach your images to the source page and name each image with the same name as its related block; uour designer styles these controls in the Theme Designer |
| |
| Image Height | defines the height of each control image |
|
|
| Image Width | defines the width of each control image |
|
|
* Required when defining a vertical/horizontal position.
rotate-content
SIMPLE EXAMPLE
This example is rotating content from the Content for Rotate Content Macro Simple Example page.
Warning: Rotating only one item
This macro is designed to rotate between multiple blocks of content from a source page. There is a known issue (PRESS-2060) when this macro is pointed to only ONE block of content. The workaround for this is to add a second block to the source page.
Still need help?
