Step by step wiki skin customizations

12 May 2020 5 min read
Written by Andreea Chirica, Communications and Support Specialist

Did you know that you can customize the skin of your wiki? For example, if you'd like to remove a button from a wiki page, this would involve modifying the skin, which organizes visually the wiki pages content. It's different from Color Themes (and here's an article on how to update the color theme on your wiki) which are set of colors for the various elements of a skin.

In this article, we will get into detail on how to hide the More Actions menu1 (available at the click on this button more-actions-button.png), in order to help you reach a better understanding of skin customizations. We will work on the XWiki 12.3 version, which has the Flamingo Skin bundled by default.

Quick tip

A skin can be changed at different levels - for the whole wiki, for a given space or for a user. In order to change it, the user has to be an administrator for the current XWiki instance.

Let's go through the steps of one method to remove the "More Actions" menu:

Customize your wiki skin

In the steps below you will learn how to make use of the bundled Skin application to customize your wiki skin. As a user with Administration rights, follow the instructions below on your wiki:

Steps for adding an overridden template object

  1. Go to the Administration, in the "Look & Feel" section
  2. Enter the name of the skin to edit (by default: XWiki.DefaultSkin).
  3. Click on "Customize". You will get the skin editing page.
  4. Go to the "Overridden templates" section
  5. Enter the name of the template that you want to override: in this case layoutExtraVars.vm. By overriding this .vm file you can safely override layout variables that are in layoutvars.vm.
  6. Then write the new code in the dedicated content section. In this case, the code will add some restrictions regarding who will be able to see the "More Actions" menu:
## Hide More Action Menu if the user not an admin
#set($currentUserGroups = $services.user.group.getGroups($xcontext.user, 'xwiki', $true))
#set($userGroupReference = $services.model.createDocumentReference('xwiki', ['XWiki'], 'XWikiAdminGroup'))
#if (!($currentUserGroups.contains($userGroupReference) || $hasAdmin))
  #set($displayMoreActionsMenu = false) ## more actions menu
  #set($displayAdminMenu = false) ## the admin menu, related to the page
#end
Don't forget to Save and View the modifications.

Loading the video player...

More about XWiki Skins

Learn how to manage or develop new XWiki skins.

I hope you enjoyed this short tutorial and that you now feel more at ease with adding customizations to your wiki.

What would you customize on your wiki skin?

TRY XWIKI XWIKI FOR FREE


1 The steps of how to hide the More Actions menu have originally been described on our community FAQ.

You may also be interested in:

Best practices

How Santa's elves manage Christmas operations with XWiki

Santa may get all the glory, but it’s the elves, backed by XWiki, who ensure all operations run smoothly like butter biscuits and Christmas magic happens on time. Learn what features are of great help for the elves in supporting Santa Claus to deliver Christmas.

Best practices

Webinar overview: A hands-on guide to migrating from Confluence - Why it’s more than just a technical shift

On November 28th, XWiki SAS hosted a webinar on migrating from Confluence to XWiki. Led by Ștefana Nazare, Product Owner of Pro Apps and an experienced Confluence migration expert, the session offered participants actionable strategies and essential tools for a smooth transition.

Best practices

A hands-on guide to migrating from Confluence - why it’s more than just a technical shift

Discover how migrating from Confluence to XWiki can transform your team's collaboration. Learn about the benefits of open-source freedom, complete data ownership, and flexible customization. XWiki SAS's expert-built Confluence Migration Toolkit ensures a seamless transition with minimal disruptions, backed by continuous support and evolving tools. Ready to make the switch? Join XWiki SAS's webinar!