com.atlassian.confluence.themes
Class DefaultTheme

java.lang.Object
  extended by com.atlassian.confluence.themes.DefaultTheme
All Implemented Interfaces:
Theme

public class DefaultTheme
extends Object
implements Theme

Represents the default Confluence theme with stylesheets.


Field Summary
static String MODULE_KEY
           
static String PLUGIN_KEY
           
static String STYLESHEET_MODULE_KEY
           
static String STYLESHEET_NAME
           
static String TOP_NAV_LOCATION
           
 
Method Summary
 String getBodyClass()
          Returns the class for the body element specified by the theme.
 ColourScheme getColourScheme()
          Returns null because this object doesn't represent a colour scheme.
 ThemedDecorator getDecorator(String path)
          Returns null because this object doesn't attempt to list the default decorators, which are still loaded directly from the classpath.
static Theme getInstance()
           
 Collection<? extends ThemeResource> getJavascript()
          Return the JavaScript resources for the theme.
 String getModuleKey()
          Returns the module key of the theme plugin module, or null if this theme doesn't come from a plugin.
 String getPluginKey()
          Return the key of the plugin which includes this theme.
 Collection<? extends ThemeResource> getStylesheets()
          Return the stylesheets for the theme.
 String getTopNavLocation()
          Returns the location of the Velocity file which renders the top navigation.
 String getXworkVelocityPath(String packageName, String actionName, String result, String template)
          If this theme defines any specific overrides for Velocity XWork results, process them through here.
 boolean hasSpaceSideBar()
          Tells whether this theme requires rendering of the Space IA sidebar.
 void init(ThemeModuleDescriptor moduleDescriptor)
          Initialise the theme details from the given theme module descriptor.
 boolean isDisableSitemesh()
          If this flag returns true, all requests for sitemesh templates w.r.t this theme will return NoDecorator, leading to a total bypassing of the sitemesh-based theme system.
 boolean isIncludeClassicStyles()
          Controls whether Confluence's 2.5 default styles will be included when rendering a theme stylesheet.
 
Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait
 

Field Detail

STYLESHEET_NAME

public static final String STYLESHEET_NAME
See Also:
Constant Field Values

PLUGIN_KEY

public static final String PLUGIN_KEY
See Also:
Constant Field Values

MODULE_KEY

public static final String MODULE_KEY
See Also:
Constant Field Values

STYLESHEET_MODULE_KEY

public static final String STYLESHEET_MODULE_KEY
See Also:
Constant Field Values

TOP_NAV_LOCATION

public static final String TOP_NAV_LOCATION
See Also:
Constant Field Values
Method Detail

getColourScheme

public ColourScheme getColourScheme()
Returns null because this object doesn't represent a colour scheme. All callers assume a null colour scheme means use the custom colour scheme for a particular space, which is the correct behaviour.

Specified by:
getColourScheme in interface Theme

getDecorator

public ThemedDecorator getDecorator(String path)
Returns null because this object doesn't attempt to list the default decorators, which are still loaded directly from the classpath.

Specified by:
getDecorator in interface Theme

getStylesheets

public Collection<? extends ThemeResource> getStylesheets()
Description copied from interface: Theme
Return the stylesheets for the theme.

Specified by:
getStylesheets in interface Theme
Returns:
a Collection of ThemeResources representing custom stylesheets for this theme, or an empty list if none exist.

getJavascript

public Collection<? extends ThemeResource> getJavascript()
Description copied from interface: Theme
Return the JavaScript resources for the theme.

Specified by:
getJavascript in interface Theme
Returns:
a Collection of ThemeResources representing custom JavaScript for this theme, or an empty list if none exist.

init

public void init(ThemeModuleDescriptor moduleDescriptor)
Description copied from interface: Theme
Initialise the theme details from the given theme module descriptor.

Specified by:
init in interface Theme

getPluginKey

public String getPluginKey()
Description copied from interface: Theme
Return the key of the plugin which includes this theme. May return null if the theme doesn't come from a plugin.

Specified by:
getPluginKey in interface Theme

getModuleKey

public String getModuleKey()
Description copied from interface: Theme
Returns the module key of the theme plugin module, or null if this theme doesn't come from a plugin.

Specified by:
getModuleKey in interface Theme

isIncludeClassicStyles

public boolean isIncludeClassicStyles()
Description copied from interface: Theme
Controls whether Confluence's 2.5 default styles will be included when rendering a theme stylesheet.

Old themes (prior to 2.6) provided stylesheets to be used in conjuction with the default stylesheet in Confluence 2.5. To facilitate this, the com.atlassian.confluence.core.actions.StylesheetAction continues to include this "classic" stylesheet above theme stylesheets when this method returns true.

For new themes, it is recommended that stylesheets be independent of Confluence's styles. In this case, this method returns false, and the StylesheetAction will only render the theme's stylesheet.

Specified by:
isIncludeClassicStyles in interface Theme
Returns:
true if the theme should include Confluence's classic styles when rendering, or false if the theme should not include any Confluence styles.

getInstance

public static Theme getInstance()

isDisableSitemesh

public boolean isDisableSitemesh()
Description copied from interface: Theme
If this flag returns true, all requests for sitemesh templates w.r.t this theme will return NoDecorator, leading to a total bypassing of the sitemesh-based theme system.

Specified by:
isDisableSitemesh in interface Theme
Returns:
true if this theme wants to turn off sitemesh

getXworkVelocityPath

public String getXworkVelocityPath(String packageName,
                                   String actionName,
                                   String result,
                                   String template)
Description copied from interface: Theme
If this theme defines any specific overrides for Velocity XWork results, process them through here.

Specified by:
getXworkVelocityPath in interface Theme
Parameters:
packageName - the package name of the action being run
actionName - the name of the action being run
result - the result string of the action being run
template - the Velocity template path the action wants to process
Returns:
the Velocity template path the action should process, with any overrides applied

getBodyClass

public String getBodyClass()
Description copied from interface: Theme
Returns the class for the body element specified by the theme.

Specified by:
getBodyClass in interface Theme

getTopNavLocation

public String getTopNavLocation()
Description copied from interface: Theme
Returns the location of the Velocity file which renders the top navigation.

Specified by:
getTopNavLocation in interface Theme

hasSpaceSideBar

public boolean hasSpaceSideBar()
Description copied from interface: Theme
Tells whether this theme requires rendering of the Space IA sidebar. The Space IA side bar is the one on the left, which contains a tree view of pages, a chronological view of the blogs, and so on.

Recommended value: false for themes that don't require rendering of the Space IA sidebar, true otherwise. This value is true for the default theme starting from Confluence 5.0.

Specified by:
hasSpaceSideBar in interface Theme
Returns:
whether this theme needs rendering of the Space IA side bar.


Copyright © 2003–2015 Atlassian. All rights reserved.