Last edited 2 months ago
by Richard Heigl

Setup:Installation Guide and Manual:Extension/BlueSpiceDiscovery/Main navigation: Difference between pages

(Difference between pages)
No edit summary
 
No edit summary
 
Line 1: Line 1:
{{Messagebox|boxtype=note|icon=|Note text=For general questions regarding the installation, maintenance, and usage of BlueSpice free, go to our [https://sourceforge.net/p/bluespice/discussion/1249668/ SourceForge help forum] .|bgcolor=}}
<bookshelf src="Book:Admin manual" />
==Introduction==
==How does the main navigation work?==
By default, some links are provided as entry points to the wiki. Wiki administrators can deactivate these links in the [[Manual:Extension/BlueSpiceConfigManager|configuration manager]] if needed. In addition, custom links can be added here. Please note that no hierarchical links can be created. Therefore, it makes sense to mainly set up links to the most important topics and to portal pages that contain additional links or page lists.
[[File:Manual:skin-discovery-hauptnavigation-EN.png|alt=Main navigation|center|thumb|402x402px|Main navigation]]


We are happy that you decided to install the latest version of BlueSpice 4. 
==Adding links==


Please follow these steps:


# [[Setup:Installation Guide#Check the system requirements|Check the system requirements]]
'''To add new links:'''
# [[Setup:Installation Guide#Prepare the server environment|Prepare the server environment]]
# [[Setup:Installation Guide#Install the BlueSpice application|Install the BlueSpice application]]
# [[Setup:Installation Guide#Optimizing the configuration|Optimize the configuration]]


==Check the system requirements==
#'''Open''' the page ''MediaWiki:Sidebar'' from the browser's address bar.
#'''Change''' to edit mode.
#'''Create''' one or more navigation links (with or without section heading).  The following example shows a link to the page "Company" with the label "Our company" and an external link to the BlueSpice website with the label "Website". The links are grouped together under the section heading "Quicklinks":<syntaxhighlight lang="text">
*Quicklinks
**Company|Our company
**https//www.bluespice.com/de|Website
</syntaxhighlight>
#'''Save''' the page. The links are now shown in the main navigation.


*[[Setup:System requirements|System requirements]]
{{Messagebox|boxtype=note|icon=|Note text=As soon as you have created at least one additional link, a direct edit link to the ''MediaWiki:Sidebar'' page is displayed when you move the mouse over such a link (see screenshot above).|bgcolor=}}
<span style="color: rgb(51, 51, 51)">Link labels may collide with system messages. If this is the case, simply append the HTML-code for an empty space to the description:</span><syntaxhighlight lang="text">
**Portal|Portal&#160;
</syntaxhighlight>
==Deacivating standard links==
The standard links can be deactivated in the  [[Manual:Extension/BlueSpiceConfigManager|configuration manager]]. The following settings are available under ''Feature > Skinning'':


== Prepare the server environment ==


* [[Setup:Installation Guide/System Preparation/Linux|Linux server environment]]
BlueSpiceBookshelf:
* [[Setup:Installation Guide/System Preparation/Windows|Windows server environment]]


==Install the BlueSpice application==
* Show entrypoint "Bookshelf"
Please select which installation type you need:


*[[Setup:Installation Guide/With Installer|Full BlueSpice installation]]
BlueSpiceDiscovery:
**Extended Functions: [[Setup:Installation Guide/Advanced/VisualEditor Configuration|VisualEditor]], [[Setup:Installation Guide/Advanced/ExtendedSearch Configuration|ExtendedSearch]]
*[[Setup:Installation Guide/Installation BlueSpice WikiFarm|BlueSpice WikiFarm installation]]
*[[Setup:Installation Guide/Docker/Docker Hub|Docker image]]


==Upgrade and patch updates==
*Show entrypoint "Mainpage"
*Show entrypoint "All pages"
*Show entrypoint "Recent changes"


*[[Setup:Installation Guide/Patch Update|Patch update from BlueSpice 4.1.x to a higher version 4.x]]
BlueSpiceSocial:
*[[Setup:Installation Guide/Upgrade free to pro|Upgrade from BlueSpice free 3.2.x to BlueSpice pro 4.1.x]]
*Upgrade from Bluespice free 4.1.x to pro 4.1.x


==Migration from MediaWiki to BlueSpice==
*Show entrypoint "Timeline"


*[[Setup:Installation Guide/Migration from MediaWiki to BlueSpice|Migration from MediaWiki to BlueSpice]]
BlueSpiceSocialBlog:


==Optimize the configuration==
*Show entrypoint "Blog"
If you don't need to set up a server environment "from scratch", you can directly refer to the setup instructions for individual system components. Just make sure that you really have everything configured as needed:


===Webservices for Apache Tomcat===
==Group-specific navigation==
<span style="color: rgb(51, 51, 51)">It is possible to show navigation elements for specific user groups only. Please note that the pipe symbol (|) between the page name and its label has to be escaped as</span> <code><nowiki>{{!}}</nowiki></code> <span style="color: rgb(51, 51, 51)">within this function.</span>


*[[Setup:Installation Guide/Webservices/PDF-Export|PDF-Export]]
This syntax is defined in the extension [[Reference:UserFunctions|UserFunctions]].<syntaxhighlight lang="text">
{{#ifingroup:sysop,widgeteditor |
*Test2                     
**somepage{{!}}Some page
|}}
</syntaxhighlight>


===Additional settings and optimizations===
==Additional customizations==


*[[Setup:Installation Guide/Optimization/Caching|Caching]]
*[[Manual:Extension/BlueSpiceDiscovery/Main navigation/Icons|Display icons with navigation links]]
*[[Setup:Installation Guide/Optimization/Cronjobs|Cronjobs]]
*[[Manual:Extension/BlueSpiceDiscovery/Main navigation/Language support|Multi-language navigation]]
*[[Setup:Installation Guide/Optimization/Time Zone|Time Zone]]
 
===Security settings===
 
*[[Setup:Installation Guide/Security Settings/File System Permissions|File System Permissions]]
*[[Setup:Installation Guide/Security Settings/Deactivating installcheck file|Deactivating installcheck file]]
*[[Setup:Installation Guide/Security Settings/Save Directories|Save Directories]]<br />
 
===Compendium===
 
{{Special:PrefixIndex/Setup:Installation Guide/Advanced/ |hideredirects=1 |stripprefix=1}}


<br />
[[Category:Administration]]
[[Category:Customization]]


[[en:{{FULLPAGENAME}}]]
[[en:{{FULLPAGENAME}}]]
[[de:Setup:Installationsanleitung]]
[[de:Handbuch:Erweiterung/BlueSpiceDiscovery/Hauptnavigation anpassen]]
[[Category:Setup]]

Revision as of 14:52, 21 March 2022

How does the main navigation work?

By default, some links are provided as entry points to the wiki. Wiki administrators can deactivate these links in the configuration manager if needed. In addition, custom links can be added here. Please note that no hierarchical links can be created. Therefore, it makes sense to mainly set up links to the most important topics and to portal pages that contain additional links or page lists.

Main navigation
Main navigation

Adding links

To add new links:

  1. Open the page MediaWiki:Sidebar from the browser's address bar.
  2. Change to edit mode.
  3. Create one or more navigation links (with or without section heading). The following example shows a link to the page "Company" with the label "Our company" and an external link to the BlueSpice website with the label "Website". The links are grouped together under the section heading "Quicklinks":
    *Quicklinks
    **Company|Our company
    **https//www.bluespice.com/de|Website
    
  4. Save the page. The links are now shown in the main navigation.
Note:As soon as you have created at least one additional link, a direct edit link to the MediaWiki:Sidebar page is displayed when you move the mouse over such a link (see screenshot above).

Link labels may collide with system messages. If this is the case, simply append the HTML-code for an empty space to the description:

**Portal|Portal&#160;

Deacivating standard links

The standard links can be deactivated in the configuration manager. The following settings are available under Feature > Skinning:


BlueSpiceBookshelf:

  • Show entrypoint "Bookshelf"

BlueSpiceDiscovery:

  • Show entrypoint "Mainpage"
  • Show entrypoint "All pages"
  • Show entrypoint "Recent changes"

BlueSpiceSocial:

  • Show entrypoint "Timeline"

BlueSpiceSocialBlog:

  • Show entrypoint "Blog"

Group-specific navigation

It is possible to show navigation elements for specific user groups only. Please note that the pipe symbol (|) between the page name and its label has to be escaped as {{!}} within this function.

This syntax is defined in the extension UserFunctions.

{{#ifingroup:sysop,widgeteditor |
*Test2                       
**somepage{{!}}Some page
|}}

Additional customizations




To submit feedback about this documentation, visit our community forum.

Discussions