Wiki source code of Most Important Configurations

Version 3.3 by chrisby on 2023/10/02 10:30

version	line-number	content
1.5	1	Here is a summary of the steps I took to configure this XWiki website via GUI. The configurations required for your XWiki website may vary depending on your needs. Being logged in as the admin user, the Administration page can be found here: Triple bar icon (upper right corner) > Administer Wiki. Here you can find the different options like Look & Feel or Extensions.
1.1	2
3.1	3	### Measures
1.1	4
	5	* Delete non-required extensions:
3.1	6	* Extensions > Extensions > In the selection menu, select "Installed Extensions" > Search for "Tour Application", "Help Application" and "Sandbox Application" and uninstall them
1.1	7	* Upload Logo (displayed in the upper left corner of the website):
3.1	8	* Look & Feel > Themes > Color Theme > COLOR THEME > Customize > Logos > Choose an attachment > Browse > Upload and select > Safe & View
1.1	9	* Add a tab bar below the website header:
3.1	10	* Look & Feel > Menus > Add new entry > (create a menu, for example "Header Menu")
	11	* Add links to each bullet point so that users who click on the tab are directed to the appropriate page.
	12	* At the bottom of the Menu page: Menu Display Location = After the page header; Menu Visibility Scope = Global.
1.1	13	* Adapt navigation panel items to your needs (the boxes at the edges like "Navigation" or "Recently Created")
3.1	14	* Look & Feel > Panels > Panel List
1.1	15	* Adapt the footer - Hide XWiki version and add copyright information.
3.1	16	* Look & Feel > Presentation > Footer > Here you can find the fields "Copyright" and "Version".
3.3	17	* Since an empty "Version" field results in the current XWiki version being displayed, I left the "Copyright" field empty and entered the license in the "Version" field. Here are two examples when using Markdown syntax (see "Markdown" bullet point below):
1.1	18
3.2	19	```
	20	The contents of this website are available under the [CC0 1.0 Universal license](https://creativecommons.org/publicdomain/zero/1.0/deed.en); additional terms may apply.
	21	The contents of this website are available under the [Attribution 4.0 International](https://creativecommons.org/licenses/by/4.0/); additional terms may apply.
	22	```
1.4	23
1.1	24	* Change browser tab title:
3.1	25	* Look & Feel > Presentation > Header > Title > Remove the " - XWiki"
	26	* Change favicon: Look & Feel > Themes > Skin > Customize > Edit > Logo > Choose Attachment > Browse > Select the image you want to have as a favicon. Make sure that the name of the image matches the names mentioned in the [documentation](http://sandbox.xwiki.org/xwiki/bin/view/FAQ/How+do+I+add+a+favicon+for+my+wiki). For example, svg files must be named "icons.xwiki.favicon.svg". > Upload and select image > Save & View
1.1	27	* Enable justification in editor:
3.1	28	* Editing > WYSIWYG Editor >
	29	* Default WYSIWYG Editor > CKEditor > Save (Note: There are two "Save" buttons on this page.)
	30	* CKEditor > Disables Plugins > Open selection of disabled plugins > uncheck "justify" plugin > click on "Save" button below
1.1	31	* Disable registration of new accounts:
3.1	32	* Users & Rights > Rights > XWikiAdminGroup > Add a check at "Register". Implicitly all other groups (including unregistered users) lose their right to register new accounts. See the [docs](https://www.xwiki.org/xwiki/bin/view/Documentation/AdminGuide/Access%20Rights/) for further details.
1.3	33	* Allow comments feature for unregistered users:
3.1	34	* Users & Rights > Rights > Remove the "Comment" check for each group. This implicitly allows all groups (including unregistered users) to use the comments feature.
1.1	35	* Set up mailing:
3.1	36	* Mail > Mail Sending > Email address to send from > (enter the necessary fields to enable XWiki's mailing functionality)
	37	* Users & Rights > Registration > User Email verification > Yes
1.1	38	* Adapt the timezone:
3.1	39	* Content > Localization > Date/Time > Timezone
3.2	40	* Use Markdown as page editing syntax:
	41	* Extensions > Extensions > Install CommonMark Markdown Syntax 1.2.
	42	* Edit > Syntax > Disabled syntaxes
	43	* Enable "CommonMark Markdown 1.2
	44	* Uncheck "XWiki 2.1
	45	* Saving
	46	* Newly created articles automatically use Markdown syntax by default. When editing, simply click the "Source" button to open the Markdown source editor.
	47	* Old articles will still use the previous default syntax, such as "XWiki 2.1" syntax. However, you can migrate old pages from the old syntax to the new syntax:
	48	* Go to the page to edit > Information > SYNTAX > click the "Edit" icon > select "CommonMark Markdown 1.2". > A "Syntax Conversion" popup appears - click "Yes" > click the "Confirm" icon. You should now be able to edit the page in Markdown.
	49	* Sometimes manual adjustments are required after conversion, as it does not always work as desired.