Page Layout Application

Last modified by Thomas Mortagne on 2023/10/16 00:00

cogSpecifies page-level display of right and left sidebars, inline comment/attachment blocks, and allows one type of editor to be forced
TypeXAR
Category
Developed by

xwiki:XWiki.ebullient

Active Installs14
Rating
0 Votes
LicenseGNU Lesser General Public License 2.1

Installable with the Extension Manager

Description

Usage

When most pages in an XWiki are used for status, documentation, project information, etc., it can be nice to have a primary (narrow) sidebar always visible for navigation while having the other sidebar only available on some pages, e.g. Space.WebHome.

When PageLayout is present, you can enable display of the primary/navigation sidebar and disable display of the ancillary sidebar in the global/space preferences so that it applies to all pages. Then add a PageLayout object to Space.WebHome, and enable the display of the ancillary sidebar on only that page.

The converse could be true as well: if you want both sidebars displayed on all pages except a few, enable display of both in the global/space preferences, and use a PageLayout object to suppress rendering of one or the other or both sidebars on certain pages. 

How to use

First download the XAR and import it on your XWiki.

The templates/skin must be updated to use these settings when rendering the page.

Information about the template modifications required to support the PageLayout class are described in the document itself, which can be found in the XWiki space after import: http://server/xwiki/bin/view/XWiki/PageLayout.

The class definition is fairly straight-forward, and does not provide "application-level" function in the true sense, so there are no sheets or templates defined.

Prerequisites & Installation Instructions

We recommend using the Extension Manager to install this extension (Make sure that the text "Installable with the Extension Manager" is displayed at the top right location on this page to know if this extension can be installed with the Extension Manager). Note that installing Extensions when being offline is currently not supported and you'd need to use some complex manual method.

You can also use the following manual method, which is useful if this extension cannot be installed with the Extension Manager or if you're using an old version of XWiki that doesn't have the Extension Manager:

  1. Log in the wiki with a user having Administration rights
  2. Go to the Administration page and select the Import category
  3. Follow the on-screen instructions to upload the downloaded XAR
  4. Click on the uploaded XAR and follow the instructions
  5. You'll also need to install all dependent Extensions that are not already installed in your wiki
Tags: page layout
    

Get Connected