Wiki source code of Skins
Last modified by Lucas Charpentier (Sereza7) on 2024/11/28
Show last authors
| author | version | line-number | content |
|---|---|---|---|
| 1 | {{box cssClass="floatinginfobox" title="**Contents**"}} | ||
| 2 | {{toc/}} | ||
| 3 | {{/box}} | ||
| 4 | |||
| 5 | A skin is a visual organization of content for wiki pages. It's different from a [[Color Theme>>extensions:Extension.Flamingo Theme Application]] which is a set of colors for the various elements of a skin. Note that a given skin must support Color Themes to use them. | ||
| 6 | |||
| 7 | = Skins in XWiki = | ||
| 8 | |||
| 9 | The latest version of XWiki Standard bundles the [[Flamingo Skin>>extensions:Extension.Flamingo Skin]]. | ||
| 10 | {{comment}} | ||
| 11 | This code block was used to display all the bundled skins by default. | ||
| 12 | Lately it's not been displaying anything, and even returned an error after the latest edit on the 28-11-2024. | ||
| 13 | {{velocity}} | ||
| 14 | #set ($xwql = "from doc.object(ExtensionCode.ExtensionClass) as extension, doc.object(EXOExtensionCode.ExtensionClass) as exoextension where extension.type = 'skin' and exoextension.bundledWith like '%enterprise%'") | ||
| 15 | #set ($currentDb = $context.database) | ||
| 16 | #set ($dummy = $context.setDatabase("extensions")) | ||
| 17 | #set ($extensions = $services.query.xwql($xwql).execute()) | ||
| 18 | #foreach ($extension in $extensions) | ||
| 19 | * [[${context.database}:$extension]] | ||
| 20 | #end | ||
| 21 | #set ($dummy = $context.setDatabase($currentDb)) | ||
| 22 | {{/velocity}} | ||
| 23 | {{/comment}} | ||
| 24 | |||
| 25 | You can find the full list of existing skins on the [[Extensions wiki>>extensions:Extension.WebHome]]. | ||
| 26 | |||
| 27 | |||
| 28 | = Changing the Skin = | ||
| 29 | |||
| 30 | A skin can be changed at different levels: | ||
| 31 | |||
| 32 | * For the whole wiki | ||
| 33 | * For a given space | ||
| 34 | * For a given user | ||
| 35 | |||
| 36 | In order to change the skin at wiki and space level, the user has to be an administrator for the current XWiki instance. To find more about how to change a skin, check the [[Changing the Skin>>Documentation.AdminGuide.Skins#HChangingtheSkin]] section in the Admin Guide. | ||
| 37 | |||
| 38 | = More about XWiki Skins = | ||
| 39 | |||
| 40 | * Learn how to [[manage XWiki skins>>Documentation.AdminGuide.Skins]] | ||
| 41 | * Learn how to [[develop new skins>>Documentation.DevGuide.Tutorials.Skins]] | ||
| 42 | |||
| 43 | = Skins Extensions = | ||
| 44 | |||
| 45 | **Skins extensions** (or, abbreviated **SX**) are an alternative for developers who want to modify the layout and behavior of certain or all documents in their wiki without the need of changing its skin templates and/or stylesheets. The Skin extensions mechanism, available in all versions of XWiki superior to 1.5, provide the developers with the possibility of pulling extra stylesheets and Javascript files that are not bundled with the skin. You can find out more about Skin Extensions by reading the [[Skin Extensions Tutorial>>Documentation.DevGuide.Tutorials.SkinExtensionsTutorial]] in the Developer Guide. | ||
| 46 | |||
| 47 | = Examples = | ||
| 48 | |||
| 49 | Some Skins developed by the XWiki dev team (see [[more>>http://extensions.xwiki.org/xwiki/bin/view/ExtensionCode/AllExtensions/#|t=extensions&p=1&l=30&s=doc.creationDate&d=desc&category=skin]]): | ||
| 50 | |||
| 51 | [[[[image:extensions:Extension.Flamingo Skin@flamingo.png||width="100" style="width: 100px; height: 100px; border: 1px; border-color: #000000; border-style: solid;"]]>>extensions:Extension.Flamingo Skin]] [[[[image:Colibri.png||width="100" style="width: 100px; height: 100px; border: 1px; border-color: #000000; border-style: solid;"]]>>extensions:Extension.Colibri Skin]] [[[[image:Toucan.png||width="100" style="width: 100px; height: 100px; border: 1px; border-color: #000000; border-style: solid;"]]>>extensions:Extension.Toucan Skin]] | ||
| 52 | |||
| 53 | Some Custom skins developed by XWiki users: | ||
| 54 | |||
| 55 | {{cache}} | ||
| 56 | {{velocity}} | ||
| 57 | #set ($sql = ", BaseObject as obj where obj.name=doc.fullName and obj.className='XWiki.ReferenceClass' and obj.name<>'XWiki.ReferenceClassTemplate' order by doc.name asc") | ||
| 58 | #set ($references= $xwiki.searchDocuments($sql)) | ||
| 59 | ## | ||
| 60 | #foreach ($reference in $references) | ||
| 61 | #set ($refDoc = $xwiki.getDocument($reference)) | ||
| 62 | #if ($refDoc.attachmentList.size() > 0) | ||
| 63 | #set ($attach = $refDoc.attachmentList.get(0)) | ||
| 64 | [[[[image:${refDoc.prefixedFullName}@${attach.filename}||width='100' style='width: 100px; height: 100px; border: 1px; border-color: #000000; border-style: solid;']]>>$refDoc.prefixedFullName]] #end | ||
| 65 | ## The end of the 'if' is located on the same line as the last statement because it would otherwise trigger a newline and the parser would output an unwanted <br/> element, resulting in one image per line. | ||
| 66 | #end | ||
| 67 | {{/velocity}} | ||
| 68 | {{/cache}} |
