.png)
Overview:
The {composition-setup} macro is used in conjunction with the other composition macros and sets up data that they will need to function correctly...
The {composition-setup} macro may be included on its own, may contain the list of parameters, or may refer to an attachment on a page that contains the list of parameters.
Parameters:
The {composition-setup} macro itself has only one parameter which allows it to take a set of properties from a file attached to another page.
{composition-setup:defaults=Page^composition.properties}
cloak.toggle.type = default
{composition-setup}
| Parameter | Required | Default | Notes |
|---|---|---|---|
| defaults |  |
Refers to an attachment on a page that contains the list of overides to the default internal settings |
Properties
The {composition-setup} however is used to define parameters that are used by the other composition macros, these properties are listed below
| Property | Default | Notes |
|---|---|---|
| import.css | Allows a Cascading Style Sheet to be imported into the page. The value may be an attachment link (e.g. 'Foo^bar.css'), an absolute link (e.g. 'http://foo.com/bar.css') or a server-relative link (e.g. '/bar.css'). |
|
| cloak.memory.duration | 7 | The number of days the cloak status should be remembered for. |
| cloak.toggle.type | default | The type of toggle to display. Options are:
|
| cloak.toggle.open | The value to use for the icon when the cloak can be opened. | |
| cloak.toggle.close | The value to use for the icon when the cloak can be closed. | |
| cloak.toggle.exclusive | false | If 'true', all the toggles on the page will be exclusive. That is, at each level, only one cloak is open at a time. |
| cloak.toggle.zone | true | If 'true', the heading or paragraph the toggle is in will be clickable. |
| deck.memory.duration | 7 | The number of days the deck status should be remembered for. |
| deck.tab.location | top | The location of the tab bar. ('top', 'bottom' or 'none') |
| deck.tab.active.border | The border for the active tab (CSS - eg. '1px dashed black') | |
| deck.tab.active.background | The background for the active tab (CSS - eg. '#ff0055') | |
| deck.tab.inactive.border | The border for inactive tabs (CSS) | |
| deck.tab.inactive.background | The background for inactive tabs (CSS) | |
| deck.tab.spacer | The distance between tabs (eg '5px') | |
| deck.card.border | The border for the active card. | |
| deck.card.background | The background for the active card. |
Comments (15)
May 20, 2009
John Bowersox says:
Is is possible to do the following with the composition-setup macro - change...Is is possible to do the following with the composition-setup macro -
May 20, 2009
Guy Fraser says:
You'll need to use CSS to do that - Confluence 2.10 and above has a CSS option i...You'll need to use CSS to do that - Confluence 2.10 and above has a CSS option in Space admin so simply apply the desired styles to the tab elements.
You can find more about CSS here: http://www.w3schools.com/css/
And an excellent Firefox plugin for examining HTML DOM here: http://getfirebug.com
May 20, 2009
John Bowersox says:
Thanks Guy. Do you have any idea what the CSS elements are that need to be modif...Thanks Guy. Do you have any idea what the CSS elements are that need to be modified to make this happen?
May 20, 2009
Guy Fraser says:
Nope, not used those macros for a long time and they've changed a fair bit since...Nope, not used those macros for a long time and they've changed a fair bit since I last tried customising them. If you use the "Inspect" feature of Firebug you'll be able to find out what HTML elements are in use and their associated classes, etc. Then just use things like "color" (for text, or "background-color" for background) and "font-weight" to make the desired changes.
Jul 24, 2009
tofu fighter says:
pls remove this postpls remove this post
Oct 22, 2009
Peter Milakovich says:
I've been attempting to use the deck background functionality in a deck I'm buil...I've been attempting to use the deck background functionality in a deck I'm building, and the background remains white. Here's what it looks like:
composition-setup
deck.tab.active.background=#323872
deck.tab.active.border=#9d9db7
deck.tab.inactive.background=#323872
deck.tab.inactive.border=#9d9db7
deck.card.background=#f0f0e3
composition-setup
(symbolics around comp-setup left out so code is visible...)
The everything works except for deck.tab.active.background and deck.card.background. Both remain white no matter what I've tried.
Is there some sort of master functionality somewhere that would block my attempts to change the color?
Jul 20, 2010
Klaus Feldmann says:
To get this longterm question answered – I checked this out today and it works a...To get this longterm question answered – I checked this out today and it works as expected on confluence 3.3
Jul 20, 2010
Peter Milakovich says:
Yes, since we upgraded this functionality is working as expected.Yes, since we upgraded this functionality is working as expected.
Jul 29, 2010
Rupert Shanks says:
I am using the comp-setup and toggle-cloak macros to allow users to hide or show...I am using the comp-setup and toggle-cloak macros to allow users to hide or show a page-tree navigator in the left hand panel. My panel background colour is light grey. Is it possible to use the comp-setup macro to override this colour setting when the content is hidden? So that the small section of panel that remains is white?
Thanks
Nov 30, 2010
Daniel Schmidt says:
We are using the composition-setup macro with a custom css to style our tabs in ...We are using the composition-setup macro with a custom css to style our tabs in confluence (3.4.2) - in the sandbox everything worked fine, after deploying the css, the border of the card doesn't work. the element .deck .cards.tabbed is used to style this. the parameter border-color is overwritten by some default value. if i set it as a property within the macro (deck.card.border=#dddddd), the border around the card dissappears completely. do you have any explanation / solution to this?
thx, daniel
Dec 20, 2010
Brett Ryan says:
All the styles I apply seem to get overridden by the style of the deck macro its...All the styles I apply seem to get overridden by the style of the deck macro itself, I'm trying to do the following:
div.tabBar { border-bottom: 1px solid rgb(68, 68, 68); } div.tabBar>table { margin-bottom: -1px; } .cards.tabbed { border: none; }Looks fine if I apply manually after page load using firebug, but if I include in themes stylesheet or in an attached file.css they all get overridden by the composition style itself main-action.css?pluginCompleteKey=net.customware.confluence.plugin.composition:composition-setup&stylesheetName=deck&spaceKey=intranet
Dec 20, 2010
Brett Ryan says:
After a fair bit of trial and error I've managed to solve this with the followin...After a fair bit of trial and error I've managed to solve this with the following style. It looks the way I want it but I think it could be refined a little.
div.deck .tabBar { border-bottom: 1px solid rgb(68, 68, 68); } div.deck .tabBar > table { margin-bottom: -1px; } div.deck .cards.tabbed { border: none; } div.deck .tabBar div.tab { margin-left: 8px; padding-left: 0px; } div.deck .tabBar .tab a:hover { background-color: #999; border-color: #999; } div.deck .tabBar .tab a { background-color: #555; border: solid 1px #555; border-bottom: none; } div.deck .tabBar #current.tab a { border: solid 1px #555; border-bottom: none; padding-top: 1px; padding-bottom: 1px; }Feb 25, 2011
marco polo says:
Could someone offer an example of how the custom icons are configured? I'm not g...Could someone offer an example of how the custom icons are configured? I'm not getting the paths to work.
Adaptavist Theme Builder (4.2.0) Powered by Atlassian Confluence 3.3
The error message:
composition-setup: Invalid wiki link for the custom close icon: https://www.domain.com
The following is what I'm trying to use:
{composition-setup} cloak.toggle.type=custom cloak.toggle.close=https://www.domain.com/path/close.gif cloak.toggle.open=https://www.domain.com/path/open.gif {composition-setup}Follow-up:
I settled for including custom images as icons by attaching the images to a page in confluence - linking to remote image files on a different domain I could not get to work.
Feb 25, 2011
Marcin Kaczmarek says:
Is there any way to make toggled content visible in the pdf export?Is there any way to make toggled content visible in the pdf export?
May 10, 2011
Paul Watts says:
Use the parameterUse the parameter