Difference between revisions of "Themes"
(Imported from Wikispaces)
Revision as of 14:32, 25 March 2008
- 1 Themes
- 2 HTML Theme Components
- 2.1 WikiPageMenuStar
- 2.2 WikiPageMenuTitle
- 2.3 WikiPageMenuEntries
- 2.4 WikiPageMenuEditButton
- 2.5 WikiContent
- 2.6 WikiUserSpaceList
- 2.7 WikiNotices
- 2.8 WikiHeaderNav
- 2.9 WikiSearch
- 2.10 WikiBreadcrumb
- 2.11 WikiFooterNav
- 2.12 WikiLicense
- 2.13 WikiLogo
- 2.14 WikiLogoOrSpaceName
- 2.15 WikiCustomNav
- 2.16 WikiActions
- 3 Text and Data Elements
- 4 Conditional Tags
- 4.1 WikiIsLoggedIn
- 4.2 WikiIsNotLoggedIn
- 4.3 WikiIsSpaceMember
- 4.4 WikiIsNotSpaceMember
- 4.5 WikiIsSpaceOrganizer
- 4.6 WikiIsNotSpaceOrganizer
- 4.7 WikiIsEditor
- 4.8 WikiIsNotEditor
- 4.9 WikiUserCanView
- 4.10 WikiUserCannotView
- 4.11 WikiIsPageObject
- 4.12 WikiIsNotPageObject
- 4.13 WikiIsSpaceObject
- 4.14 WikiIsNotSpaceObject
- 4.15 WikiIsUserObject
- 4.16 WikiIsNotUserObject
- 4.17 WikiIsPageContext
- 4.18 WikiIsNotPageContext
- 4.19 WikiIsHttps
- 4.20 WikiIsNotHttps
- 5 Modifiers
You can customize nearly all aspects of your Wikispaces theme using a template language based on HTML. The theme is displayed as an HTML page, with certain pieces of Wikispaces functionality inserted.
You can find common theme customizations on the Theme Customizations page.
HTML Theme Components
Components are added to a theme using the <$ComponentName$> syntax. No spaces are allowed in the tag and the component name must match one of the following, and is case sensitive.
Component shows a a clickable star that users can use to mark favorite pages. Only visible on Wiki pages. WikiPageMenuStar CSS class.
Component displays the name of the wiki page, or the title of the page. WikiPageMenuTitle CSS class.
Component provides a list of submenus for the particular page, along with the currently active menu. WikiPageMenuEntries CSS class. Current submenu uses the WikiPageMenuEntryOn CSS class, and other submenus use the WikiPageMenuEntryOff CSS class.
Component provides a context sensitive edit link for the content of Wiki pages. On non-Wiki pages, the output is empty. On pages that the current user can edit, the CSS class is WikiPageMenuEditButton. On locked (read only) pages, the CSS class is WikiPageMenuEditButtonLocked and on pages that the user lacks permission for editing, the CSS class is WikiPageMenuEditButtonNoPermission. Once the button is pushed, and on the edit page, the class is changed to WikiPageMenuEditButtonDisabled. This tag is optional, if it is not included in the theme, a default button will be provided inside the content area.
The main content section of the page. Includes the Wiki page text, or any Wikispaces content, along with ad text. No CSS class is provided, styles should avoid making changes to this component.
Component provides a list of the spaces the currently logged in user is a member of. WikiUserSpaceList CSS class.
Component provides the action notices that alert users to changes or problems. These are wrapped in the WikiNotice CSS class. It also provides persistent banners that alert users of actions they need to perform. These are wrapped in the WikiBanner CSS class.
Component provides the username, settings, help, sign-in/sign-out links along with an image link back to the main "www" Wikispaces. 2 elements, the outer uses the WikiHeaderNav CSS class, the inner uses the WikiHeaderNavInner CSS class.
Component provides the search form and input box. Wrapped in the WikiSearch CSS class, the individual components use the WikiSearchInput and WikiSearchSubmit CSS classes.
Component provides a context sensitive, clickable, heirarchy of pages leading to the current page, similar to the page title. Uses the WikiBreadcrumb CSS class.
Component provides the help, about, blog, terms, privacy, invite, and upgrade links. Uses the WikiFooterNav CSS class.
Component provides the space content license information. Uses the WikiLicense CSS class.
Component provides the custom space logo image. WikiLogo CSS class.
Component provides the custom space logo, or falls back on a default logo with the current space name. If the logo is available, the output is the same as WikiLogo. Otherwise, WikiLogoTable wraps a table with the image and space name.
Component provides the content of the editable space.menu Wiki page, used to create custom navigation elements. WikiCustomNav CSS class.
Component provides the actions the user can take in the current space (make a new page, recent changes, invite people, manage space). WikiActions CSS class.
Text and Data Elements
The URL to the main wiki site. (e.g., | http:www.wikispaces.com)
The custom background color selected by the current space, as 6 hex digits starting with the # sign (e.g., #F0F0F0). Used to make the theme customizable by individual Wikispaces.
The custom highlight color selected by the current space, as 6 hex digits starting with the # sign (e.g., #F0F0F0). Used to make the theme customizable by individual Wikispaces.
The custom text color selected by the current space, as 6 hex digits starting with the # sign (e.g., #F0F0F0). Used to make the theme customizable by individual Wikispaces. The color should only apply to the text outside the content area.
The custom link text color selected by the current space, as 6 hex digits starting with the # sign (e.g., #F0F0F0). Used to make the theme customizable by individual Wikispaces. The color should only apply to the link text outside the content area.
The context sensitive page title, to be used in the HTML <title> tag.
The currently submitted search term, used for building a custom search form.
The short name of the current space, used in the URL.
The user specified name of the current space.
The user specified description of the current space.
The URL of the current space.
The name of the current content page, useful only when in a /page or /message section. See also WikiIsPageContext.
//Conditionals are wrapped around text, HTML and components that are to be displayed only when the condition is met. They are used with the following sytnax: <ConditionalName> ...conditional text, HTML, and components go here... </ConditionalName> No spaces can exist in the tag, and the conditional name must match one of the following, and are case sensitive. All conditionals must be closed.//
Applies when the current user is logged in and not a guest user.
Applies when the current user is not logged in and is the guest user.
Applies when the current user is logged in and the user is a member of the current space.
Applies when the user is not logged in, or when the logged in user is not a member of the current space.
Applies when the current user is logged in and the user is the organizer of the current space.
Applies when the user is not logged in, or when the logged in user is not the organizer of the current space.
Applies when the current user is allowed to edit the current page.
Applies when the current user is not allowed to edit the current page.
Applies when the user has access to the current page.
Applies when the user does not have access to the current page, as in a private space.
Applies when the URL is in the form of /page/
Applies when the URL is not in the form of /page/
Applies when the URL is in the form of /space/
Applies when the URL is not in the form of /space/
Applies when the URL is in the form of /user/
Applies when the URL is not in the form of /user/
Applies when the URL is in the form of /page/ or /message/ and has a page name
Applies when the URL is not in the form of /page/ or /message/ and does not have a page name
Applies when the URL uses the https secure protocol
Applies when the URL does not use the https secure protocol
Tag output can be modified from the original form through various filtering mechanisms. These are useful for escaping the information to be used in HTML code or URLs.
|url||url$>||"this page <here>" becomes "this+page+%3Chere%3E"|
|html||html$>||"this page <here>" becomes "this page <here>"|