What is a XWiki Skin used for?

An XWiki Skin is used to customize the interface of a XWiki Enterprise instance.
A Skin is composed of:

The default XWiki Skins

An XWiki Enterprise instance contains several skins by default, such as: 

  • The Albatross Skin
  • The Toucan Skin
  • The Colibri Skin
    The full list of XWiki Skins that are included in your XWiki Enterprise instance can be found on the server filesystem, inside the webapps/xwiki/skins folder.

The usage level for a XWiki Skin

A Skin can be used at different levels:

  • For the entire XWiki Enterprise instance. If no Skin is set at other levels, the pages will use the global instance Skin
  • For a space inside the XWiki Enterprise instance. It has a higher priority than the instance level Skin
  • For a specific user. It has a higher priority than the space level Skin. Click here for more details
  • For other custom levels that can be created by modifying the Velocity templates inside the Skin (for example, a Skin can be set for a specific page, for a specific group of users and so on)

Changing the Skin

To change the Skin, the user must have administrating rights. In the case that you have these rights, make sure that you switch to the Advanced mode in your profile, to enable the advanced options on the top main menu.

How to preview a Skin  applied on a page

To check how a page looks on changing the Skin, you can add a parameter named skin to the page URL. For example, to preview the wiki main page with the Toucan Skin, use the following URL: http://localhost:8080/xwiki/bin/view/Main/WebHome/?skin=toucan. If you want to preview the page using a Skin document named MySpace.MySkinDoc, use the following URL: http://localhost:8080/xwiki/bin/view/Main/WebHome/?skin=MySpace.MySkinDoc.

Changing the Skin at instance level

Each XWiki Enterprise instance contains a Skin Document that stores the Skin for the instance. In order to find out which document is used to store the current Skin, the user has to follow these steps:

  • Go to Wiki Administration page
  • Click on Presentation on the left tab

    skin1.png

  • Check the Skin property that stores the full name of the document
  • Click on the Customize button from the Skin section

    skin2.png

  • Click on the Edit this skin button or edit the page in Object mode

    skin3

  • You have multiple text areas where you can override the default behavior of your skin
  • Click on Save and View
  • Your settings will be applied and the skin should change accordingly.

Changing the Skin at space level

An XWiki space can have its own Skin. For example, if you want to set the Albatross Skin for the Main space you should follow these steps:

  • Go on any page inside the Main space
  • From the top Space  menu, click Administer space to open the Administration interface for the Main space
  • Click on Presentation on the left tab

    skin5.png

  • For example, to use the Toucan Skin you can write "toucan" in the Skin field. If you have defined another Skin, you should fill in directory name which contains the skin. Note that the names are case-sensitive.
  • Click Save
  • If you open any page inside the Main space you will notice the layout difference.

Changing the Skin for a user

For example, if you want to use the Toucan Skin for a specific user, follow these steps:

  • Go to the user's profile page
  • Edit the user's objects. Use the top-left menu: Edit -> Objects
  • Set the value of the skin property (under 'Objects of type XWiki.XWikiUsers') to toucan. You must use lowercase letters, remember that skin names are case-sensitive.

    skin6.png

  • Click on Save and View
  • Now, all the pages inside the wiki will have the toucan Skin applied for that user. 

More about XWiki Skins

In order to find out more about the XWiki Skins, check the Skins Tutorial in the Developer Guide and the Skins Tutorial in the User Guide.

    

Tags:
Created by Vincent Massol on 2006/12/12
   

Get Connected