Packaged demo of how to setup and decorate XWiki to use for a public website, as presented at FOSDEM 2021. Attention: it includes configuration changes including access rights changes, to be used only in a contained testing environment.

Description

This extension is a packaged version of the demo from the From 0 to public website in 20 minutes with XWiki presentation at FOSDEM 2021.

It was tested on XWiki version 12.6.7, but it should work fine on other versions of the 12.x cycle (at least).

It uses the Blog extension version 9.10.5 and the XCarousel extension version 1.3 as dependencies and adds the following additional changes:

• setup of panels configuration and configuration of extra tabs of the wiki (comments, attachments, history, information)
• setup of a new color theme, Iceberg-Reverse, that uses the same colors as standard Iceberg, but the other way around (background is foreground and reverse);
• setup of a menu with links to demo content;
• setup of a carousel with demo content and inclusion in the header - image from unsplash.com via Lorem picsum
• adds a new data structure for storing Tutorials;
• demo blog post;
• setup of access rights;
• setup of demo homepage content and layout The demo homepage in this package will only be properly setup on wikis which have their default language set to English, as it replaces the English translation homepage. For all other languages, you'd need to set it up yourself or copy the content from the English translation.

Installation notes

Upon instaling this extension with Extension manager from your wiki, extension manager will detect some "conflicts" on the Main.WebHome page and XWiki.XWikiPreferences page. This is because these pages already exist on your wiki because they are part of the standard distribution and this extension needs to update them in order to prepare the configurations explained above.
If you wish to obtain the _exact_ result from the mentioned demo, you should choose to install the New version of the page (not to keep the current one) when asked by the Extension Manager upon install. If you choose to keep the current version of those pages, some features that were part of the demo will not be done on your wiki: the homepage setup, the panels configuration and extra tabs configuration, the activation of the Iceberg-Reverse color theme and the access rights updates. Of course, you can make these settings one by one afterwards, by making the appropriate changes in the wiki administration yourself.

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

Dependencies

Dependencies for this extension (lucaa:xwikipublicwebsitedemo-fosdem2021 1.0):

• org.xwiki.contrib.blog:application-blog-ui [9.10.5,)
• org.xwiki.contrib:application-xcarousel [1.3,)