6 Config manager

No edit summary
Tag: 2017 source edit
No edit summary
 
(10 intermediate revisions by the same user not shown)
Line 15: Line 15:
[[File:Manual:ConfigManager2a.png|alt=config manager filters|center|thumb|401x401px|config manager filter]]
[[File:Manual:ConfigManager2a.png|alt=config manager filters|center|thumb|401x401px|config manager filter]]


 
All settings are available in any type of grouping. Changing the grouping type does not add or remove setting options. It just groups them differently. After settings are adjusted, they can be saved by clicking''Save'', or cancelled by clicking ''Reset''.
All settings are available in any type of grouping. Changing the grouping type does not add or remove setting options. It just groups them differently. After settings are adjusted, they can be saved by clicking ''Save'', or cancelled by clicking ''Reset''.


{{Messagebox|boxtype=note|Note text=If a server administrator has configured a setting to no longer be writable, it will be shown as greyed-out in the config manager. You will have to talk to your server administrator about changing such a setting.}}
{{Messagebox|boxtype=note|Note text=If a server administrator has configured a setting to no longer be writable, it will be shown as greyed-out in the config manager. You will have to talk to your server administrator about changing such a setting.}}
Line 33: Line 32:


[[File:Manual:ext enhancedupload en.png|alt=Screenshot of the "Enhanced Upload" configuration|center|thumb|450x450px|Configuration settings for the Enhanced upload]]
[[File:Manual:ext enhancedupload en.png|alt=Screenshot of the "Enhanced Upload" configuration|center|thumb|450x450px|Configuration settings for the Enhanced upload]]
*'''Allow mismatched MIME types (potential security risk):'''  If the file extension of a file does not match the actual file type, it will still be uploaded if it is listed as an allowed file extension in the wiki.
===BlueSpiceDistributionConnector {{Bsvs|bsvFrom=4.5|bsvFeature=BlueSpiceDistributionConnector}}===
*'''BlueSpice subscription key:''' Sets the number of users as specified in the subscription contract. If this entry is missing, the number of users is limited to 25.
*'''OAuth2 public key, OAuth private key:''' Required if user authentication is configured via [[Referenz:OAuth|OAuth]].
=== ContentStabilization {{Bsvs|bsvFrom=4.3|bsvTo=|bsvFeature=}}===
==== Book ====
* '''Export: List approved pages contained in the book'''<br>Displays a list of the approved versions of each page at the beginning of the PDF.<br /> [[File:Manual:configmanager-bookshelf-revisionslog.png|350x350px|List of approved pages]] <br />
* '''Export: List unapproved pages contained in the book:'''<br> Displays a list of the pages at the beginning of the PDF that only exist as a first draft and that do not have an approved version.<br />[[File:configmanager-book-nichtfreigegebeneseiten-EN.png|250x250px|Pages in the first draft]]<br />
* '''Export: List approved pages contained in the book that do not have stabilization enabled'''<br> Displays a list of the pages at the beginning of the PDF that do not use the approval mechanism .<br />[[File:Manual:configmanager-book-listnoflaggedrev.png|250x250px|Pages without approval mechanism]]
====Export====
*'''Show stabilization information in PDF export''':<br>Prints the timestamp for the last approved version below the page headings in the PDF (date of approval and date of last edit before approval).<br />[[File:Manual:configmanager-bookshelf-flaggedrevsinfo.png|centered|mini|400x400px|FlaggedRevs info under the heading]]
====Quality assurance ====
*'''Include handling:''' If resources are embedded in a page '''and these resource namespace itself has approval enabled''', the following settings can be selected:
{| class="wikitable" style="width:100%;" "
! style="width:220px;" |
!Behavior
|-
| style="width:220px;" |Versions that were current at the time of release
|Displays the version of the resource that was current at the time of the approval of the page on which the resource is embedded (only applies if the resource is in a namespace with approval function. If an approved page contains a template for example, the page does not exist in another draft version. The approval works directly on the embedded resource.) If the approval function is not activated in the namespace of the resource, the resource has to be approved on all wiki pages where it is embedded.
|-
| style="width:220px;" |Approved versions of included pages
|Always displays the currently approved version of the resource, even if this version was created after the page was approved (this setting only applies if the resource is in a namespace with approval function. If an approved page contains a template, the page does not exist in another draft version. Sharing works directly via the embedded resource.)  If the approval function is not activated in the namespace of the resource, the resource has to be approved on all wiki pages where it is embedded.
|-
| style="width:220px;" |Current versions of included pages
|Always shows the most current version of a resource.
|}
*'''Show not approved pages for following groups:''' If the <code>user</code> group has been removed from the configuration, users in this group cannot see draft versions. This also applies if they are added as reviewers in a namespace. In this case, only users with the <code>sysop</code> and <code>reviewer</code> permissions can access drafts, unless other groups are specified. These system groups can then only access drafts via the page's version history. All groups that can see page drafts anywhere in the wiki must be explicitly specified here. This setting applies to the entire wiki and cannot be restricted to namespaces.
*'''Allow viewing of first draft version for users who can normally not see drafts:''' If this setting is enabled, all users with read permissions can see the first draft. If disabled, only groups from the setting "The following groups can see draft versions" can see first drafts.
*'''Update semantic properties from approved versions only:''' The attribute value of the page is set from the stable version of the page and not from the draft version.
====Search and navigation====
*'''Index approved versions of pages only:''' Page names and contents of draft pages are not taken into account by the search.
===AI Editing Assistant{{bsvs|bsvFrom=4.5|bsvTo=|bsvFeature=}}===
*'''Provider type:''' One of the supported providers is selected here (OpenAI or Ollama). OpenAI requires its own account, which provides an API key.
* '''Connection params:''' The API key of the provider is entered here (OpenAI) or the endpoint URL (Ollama)
===NumberHeadings {{bsvs|bsvFrom=4.5|bsvTo=|bsvFeature=}} ===
* '''Enable heading numbering:''' Displays the numbering from the table of contents before the section headings on a page.[[File:ConfigManager NumberHeadings.png|alt=Selected checkbox for the extension NumberHeadings|center|thumb|550x550px|Number headings]][[File:ConfigManager numbered headings on page.png|alt=Headings of an example page|center|thumb|550x550px|Activated heading numbers]]


===BlueSpiceFoundation===
===BlueSpiceFoundation===


====Updating logo and favicon====
==== Updating logo and favicon====
{{Messagebox|boxtype=note|icon=|Note text=Since BlueSpice 4.2, the logo and favicon can also be managed via the page [[Manual:Extension/FlexiSkin|Special:Flexiskin]]  together with further skin customizations.|bgcolor=}}
{{Messagebox|boxtype=note|icon=|Note text=Since BlueSpice 4.2, the logo and favicon can also be managed via the page [[Manual:Extension/FlexiSkin|Special:Flexiskin]]  together with further skin customizations.|bgcolor=}}
*'''Logo path:''' The logo image should be stored in the /images folder of your installation. If you store it in the /skins folder of your BlueSpice installation, it could be overwritten with an upgrade.
*'''Logo path:''' The logo image should be stored in the /images folder of your installation. If you store it in the /skins folder of your BlueSpice installation, it could be overwritten with an upgrade.
Line 42: Line 90:
'''To upload the logo directly in the wiki:'''
'''To upload the logo directly in the wiki:'''


#'''Upload''' the logo on the page from the menu ''Global actions'' > ''File list'' (''Special:ExtendedFilelist'').  
#'''Upload''' the logo on the page from the menu ''Global actions'' > ''File list'' (''Special:ExtendedFilelist'').
#'''Click''' on the thumbnail image of the logo. This opens the logo on a separate page.<br />[[File:Manual:config-logo1.png|link=https://en.wiki.bluespice.com/wiki/File:Manual:config-logo1.png|alt=logo thumbnail image|center|thumb|280x280px|logo thumbnail image]]
#'''Click''' on the thumbnail image of the logo. This opens the logo on a separate page.<br />[[File:Manual:config-logo1.png|alt=logo thumbnail image|center|thumb|280x280px|logo thumbnail image]]
#'''Copy''' the relative logo path from the address bar. In a typical Wiki configuration, this path starts with ''/w/....'' .<br />[[File:Manual:config-logo2.png|alt=relative image path|center|thumb|450x450px|relative image path]]
# '''Copy''' the relative logo path from the address bar. In a typical Wiki configuration, this path starts with ''/w/....'' .<br />[[File:Manual:config-logo2.png|alt=relative image path|center|thumb|450x450px|relative image path]]  
#'''Paste''' the logo path into the text field for the logo.<br />[[File:Manual:config-logo3.png|link=https://en.wiki.bluespice.com/wiki/File:Manual:config-logo3.png|alt=logo path|center|thumb|450x450px|logo path]]
#'''Paste''' the logo path into the text field for the logo.<br />[[File:Manual:config-logo3.png|alt=logo path|center|thumb|450x450px|logo path]]
#'''Click''' ''Save''.
#'''Click''' ''Save''.
#'''Refresh''' the page (Strg+F5). <br />If the uploaded logo is too large, you can add the following code snippet to the page ''MediaWiki:Common.css''. This automatically adjusts the image to the height of the main toolbar:<syntaxhighlight lang="css">
#'''Refresh''' the page (Strg+F5). <br />If the uploaded logo is too large, you can add the following code snippet to the page ''MediaWiki:Common.css''. This automatically adjusts the image to the height of the main toolbar:<syntaxhighlight lang="css">
Line 63: Line 111:
''BlueSpiceArticleInfo'', together with ''[[Manual:Extension/BlueSpiceAuthors|BlueSpiceAuthors]], [[Manual:Extension/BlueSpiceReaders|BlueSpiceReaders]], and [[Manual:Extension/BlueSpiceExtendedSearch|BlueSpiceExtendedSearch]]'' is part of the ''Page information'' in the quality management tools.
''BlueSpiceArticleInfo'', together with ''[[Manual:Extension/BlueSpiceAuthors|BlueSpiceAuthors]], [[Manual:Extension/BlueSpiceReaders|BlueSpiceReaders]], and [[Manual:Extension/BlueSpiceExtendedSearch|BlueSpiceExtendedSearch]]'' is part of the ''Page information'' in the quality management tools.


*'''Update interval in seconds:''' Sets the refresh rate for the "Last edit" value. By default, this date is updated every 10 seconds via JavaScript.
* '''Update interval in seconds:''' Sets the refresh rate for the "Last edit" value. By default, this date is updated every 10 seconds via JavaScript.
[[File:Manual:ArticleInfo.png|link=link=Special:FilePath/ArticleInfo3.jpg|alt=|center|thumb|374x374px|article info]]
[[File:Manual:ArticleInfo.png|link=link=Special:FilePath/ArticleInfo3.jpg|alt=|center|thumb|374x374px|article info]]


===BlueSpiceAuthors===
=== BlueSpiceAuthors===
''BlueSpiceAuthors,'' together with ''[[Manual:Extension/BlueSpiceArticleInfo|BlueSpiceArticleInfo]]'' and ''BlueSpiceReaders'', is part of the ''Page information'' in the quality management tools.
''BlueSpiceAuthors,'' together with ''[[Manual:Extension/BlueSpiceArticleInfo|BlueSpiceArticleInfo]]'' and ''BlueSpiceReaders'', is part of the ''Page information'' in the quality management tools.


*'''Display authors:''' Show or hide authors on the page information page.
*'''Display authors:''' Show or hide authors on the page information page. This setting has no effect on the version history of a page.
[[File:Manual:PageInformation Authors.png|alt=|center|page=authors in page information|thumb|332x332px|Authors of page]]
[[File:Manual:PageInformation Authors.png|alt=|center|page=authors in page information|thumb|332x332px|Authors of page]]


Line 80: Line 128:
**'''[[wikipedia:Identicon|Identicon:]]''' Generates an avatar image based on parts of the user's IP address.<br />[[File:Manual:configmanager-identicon.png|alt=Identicon|center|thumb|500x500px|Identicon]]
**'''[[wikipedia:Identicon|Identicon:]]''' Generates an avatar image based on parts of the user's IP address.<br />[[File:Manual:configmanager-identicon.png|alt=Identicon|center|thumb|500x500px|Identicon]]


===BlueSpiceBookshelf===
===BlueSpiceBookshelf ===


==== Book ====
*'''Show book chapter pager after content:''' Displays previous/next book page navigation at the end of each book page. (1)
*'''Show book chapter pager after content:''' Displays previous/next book page navigation at the end of each book page. (1)
*'''Show book chapter pager before content:'''  Displays previous/next book page navigation at the beginning of each book page. (2) <br />[[File:Manual:book-pagenav.png|alt=Book navigation|center|thumb|450x450px|Book navigation ]]<br />
*'''Show book chapter pager before content:'''  Displays previous/next book page navigation at the beginning of each book page. (2) <br />[[File:Manual:book-pagenav.png|alt=Book navigation|center|thumb|450x450px|Book navigation ]]<br />
*'''Use the display title from book source on article:''' Shows the title from the book navigation as page title instead of the page name. <br />
*'''Use display title from book source on article:''' Shows the title from the book navigation as page title instead of the page name. <br />  
[[File:Manual:bookdisplaytitle.png|alt=book display title|center|thumb|450x450px|book display title]]
[[File:Manual:bookdisplaytitle.png|alt=book display title|center|thumb|450x450px|book display title]]
{{Messagebox|boxtype=note|Note text=If the page additionally contains a <nowiki>{{DISPLAYTITLE}}</nowiki> tag, the display title of the page is shown instead of the book title.}}
{{Messagebox|boxtype=note|Note text=If the page additionally contains a <nowiki>{{DISPLAYTITLE}}</nowiki> tag, the display title of the page is shown on the page and in the book navigation instead of the page label provided in the book page.}}


*'''Prepend article table of contents and headlines with book numberation:''' The page TOC does not start with the main heading 1, but with the actual number from the book chapter (see screenshot). If users have activated in their [[Manual:Preferences#Advanced options|user preferences]] to "auto-number headings", the numbering system is matched accordingly. [[File:prepand TOC with book chapter.png|alt=Prepended chapter numbers|center|thumb|650x650px|Prepended chapter numbers]]
==== Content structuring ====
'''Prepend article table of contents and headlines with book numberation:''' The page TOC does not start with the main heading 1, but with the actual number from the book chapter (see screenshot). If users have activated in their [[Manual:Preferences#Advanced options|user preferences]] to "auto-number headings", the numbering system is matched accordingly.[[File:prepand TOC with book chapter.png|alt=Prepended chapter numbers|center|thumb|650x650px|Prepended chapter numbers]]
 
==== Export ====
*'''Supress namespace prefix of book articles in output:''' The namespace prefix of an article is not shown in PDFs.
*'''Supress namespace prefix of book articles in output:''' The namespace prefix of an article is not shown in PDFs.
==== Skinning ====
* '''Show entrypoint "Books":''' Adds a link to the page Special:Books to the main navigation entrypoints.


===BlueSpiceChecklist===
===BlueSpiceChecklist===
Line 98: Line 154:


*'''External file paths''': External locations to scan for and index files from. These locations are entered in key/value pairs of Physical path and URL prefix.
*'''External file paths''': External locations to scan for and index files from. These locations are entered in key/value pairs of Physical path and URL prefix.
**''Physical path: S''torage path. For mounted drives, for example: ''X:\Documents''
**''Physical path: S''torage path. For mounted drives, for example: ''X:\Documents''  
**''URL prefix:'' All files indexed from the indexed physical location are prefixed in the search results. It should be used if files are available from a web server. By default, the URL prefix is set to the same value as ''Physical path''.
**''URL prefix:'' All files indexed from the indexed physical location are prefixed in the search results. It should be used if files are available from a web server. By default, the URL prefix is set to the same value as ''Physical path''.


Line 105: Line 161:
|+Examples for external file paths
|+Examples for external file paths
!Example file
!Example file
!Phys. Path
! Phys. Path
!URL Prefix
! URL Prefix  
!Link in results list
!Link in results list  
|-
|-
| rowspan="3" |S:\Sales\Info\glossaryy.pdf
| rowspan="3" |S:\Sales\Info\glossaryy.pdf
Line 117: Line 173:
documents/
documents/
|<span class="mw-lingo-term" data-lingo-term-id="5e056c500a1c4b6a7110b50d807bade5" data-hasqtip="9">https</span>://sharepoint/Sales/
|<span class="mw-lingo-term" data-lingo-term-id="5e056c500a1c4b6a7110b50d807bade5" data-hasqtip="9">https</span>://sharepoint/Sales/
documents/Sales/Info/glossary.pdf
documents/Sales/Info/glossary.pdf  
|-
|-
|<span class="mw-lingo-term" data-lingo-term-id="5e056c500a1c4b6a7110b50d807bade5" data-hasqtip="10">https</span>://intranet/showdocs
|<span class="mw-lingo-term" data-lingo-term-id="5e056c500a1c4b6a7110b50d807bade5" data-hasqtip="10">https</span>://intranet/showdocs
Line 136: Line 192:


*'''Use simple autocomplete:''' forces a more compact autocomplete (1-column Sales thumbnail preview).<br />[[File:Manual:configuration-autocomplete-simple.1575886540740.png|alt=compact autocomplete|center|thumb|450x450px|compact autocomplete]][[File:Manual:configuration-autocomplete-regular.1575886496796.png|alt=regular autocomplete|center|thumb|450x450px|Salesautocompletey]]<br />
*'''Use simple autocomplete:''' forces a more compact autocomplete (1-column Sales thumbnail preview).<br />[[File:Manual:configuration-autocomplete-simple.1575886540740.png|alt=compact autocomplete|center|thumb|450x450px|compact autocomplete]][[File:Manual:configuration-autocomplete-regular.1575886496796.png|alt=regular autocomplete|center|thumb|450x450px|Salesautocompletey]]<br />
*'''Automatically set language filter''': This setting applies to multi-languages. It returns search results for a user only in the user's language. Users can set their language in their [[Manual:Preferences|preferences]].
*'''Automatically set language filter''': The search only returns pages whose language (PageLanguage) is identical to the user language (Language). Users can set their language in their [[Manual:Preferences|preferences]]. By default, the language of content pages is the same as the installation language  (ContentLanguage) of the wiki. Some extensions can set the language of individual pages independently of the content language of the wiki.. (See: https://www.mediawiki.org/wiki/Manual:Language#Page_content_language). In many wikis,  activating this filter has little effect.<br />
*'''Exclude patterns:''' Files at external file locations can be exluded from search based on regular expression patterns.
*'''Exclude patterns:''' Files at external file locations can be exluded from search based on regular expression patterns.


Line 146: Line 202:
===BlueSpiceInsertCategory===
===BlueSpiceInsertCategory===


*Insert category with its parent categories
*'''Insert category with its parents:''' When a category is inserted on a page, its parent categories are automatically inserted as well.
*Preset categories of a page in the upload dialog
* '''Set page categories as default in upload dialog:''' When a file is uploaded to the wiki via the visual editor, the categories of the paged are automatically inserted on the file page.


===BlueSpiceInsertLink===
===BlueSpiceInsertLink===
Line 157: Line 213:
!Filesystem prefix
!Filesystem prefix
!Web accessible Prefix
!Web accessible Prefix
!Link output
!Link output  
|-
|-
| rowspan="3" |S:\Sales\Info\glossaryy.pdf
| rowspan="3" |S:\Sales\Info\glossaryy.pdf
| rowspan="3" |S:\
| rowspan="3" | S:\
|<nowiki>file:///S:/</nowiki>
|<nowiki>file:///S:/</nowiki>  
|<nowiki>file:///S:/Sales/Info/glossary.pdf</nowiki>
|<nowiki>file:///S:/Sales/Info/glossary.pdf</nowiki>
|-
|-
|<span class="mw-lingo-term" data-lingo-term-id="5e056c500a1c4b6a7110b50d807bade5" data-hasqtip="8">https</span>://sharepoint/Sales/
| <span class="mw-lingo-term" data-lingo-term-id="5e056c500a1c4b6a7110b50d807bade5" data-hasqtip="8">https</span>://sharepoint/Sales/
documents/
documents/
|<span class="mw-lingo-term" data-lingo-term-id="5e056c500a1c4b6a7110b50d807bade5" data-hasqtip="9">https</span>://sharepoint/Sales/
|<span class="mw-lingo-term" data-lingo-term-id="5e056c500a1c4b6a7110b50d807bade5" data-hasqtip="9">https</span>://sharepoint/Sales/
Line 170: Line 226:
|-
|-
|<span class="mw-lingo-term" data-lingo-term-id="5e056c500a1c4b6a7110b50d807bade5" data-hasqtip="10">https</span>://intranet/showdocs
|<span class="mw-lingo-term" data-lingo-term-id="5e056c500a1c4b6a7110b50d807bade5" data-hasqtip="10">https</span>://intranet/showdocs
inline.aspx?path=
inline.aspx?path=  
|<span class="mw-lingo-term" data-lingo-term-id="5e056c500a1c4b6a7110b50d807bade5" data-hasqtip="11">https</span>://intranet/showdocsinline.aspx?
|<span class="mw-lingo-term" data-lingo-term-id="5e056c500a1c4b6a7110b50d807bade5" data-hasqtip="11">https</span>://intranet/showdocsinline.aspx?
path=/Sales/Info/glossary.pdf
path=/Sales/Info/glossary.pdf
Line 179: Line 235:
mounted_share/
mounted_share/
|
|
|<span class="mw-lingo-term" data-lingo-term-id="5e056c500a1c4b6a7110b50d807bade5" data-hasqtip="12">https</span>://wiki.company.local/w/mounted_
| <span class="mw-lingo-term" data-lingo-term-id="5e056c500a1c4b6a7110b50d807bade5" data-hasqtip="12">https</span>://wiki.company.local/w/mounted_
share/Sales/Info/glossary.pdf
share/Sales/Info/glossary.pdf
|}
|}
Line 185: Line 241:
When a new entry is added, it has to be confirmed by clicking the checkmark next to it before saving the page.
When a new entry is added, it has to be confirmed by clicking the checkmark next to it before saving the page.
[[File:ext BlueSpiceInsertLink config.png|thumb|center|alt=Screenshot of the InsertLink configuration options|450px|InsertLink configuration options]]
[[File:ext BlueSpiceInsertLink config.png|thumb|center|alt=Screenshot of the InsertLink configuration options|450px|InsertLink configuration options]]




===BlueSpicePageTemplates===
===BlueSpicePageTemplates===


*'''Force target namespace:''' The page is always created in the target namespace that is associated with the template, even if the user provided a different namespace prefix. In the screenshot below, the user wants to create the page "NewPage" and then selects a template for the QM namespace. The page is, therefore, created as "QM:NewPage" if this setting is activated. [[File:force namespace from template.png|alt=force the namespace of the template|center|thumb|650x650px|force the namespace of the template]]
* '''Force target namespace:''' The page is always created in the target namespace that is associated with the template, even if the user provided a different namespace prefix. In the screenshot below, the user wants to create the page "NewPage" and then selects a template for the QM namespace. The page is, therefore, created as "QM:NewPage" if this setting is activated. [[File:force namespace from template.png|alt=force the namespace of the template|center|thumb|650x650px|force the namespace of the template]]


*'''Hide default templates:''' Hides the default ''Empty page'' template.
*'''Hide default templates:''' Hides the default ''Empty page'' template.
Line 206: Line 261:
[[File:Manual:configmanager-RSS.png|alt=RSS Feed settings|center|thumb|450x450px|RSS Feed settings]]
[[File:Manual:configmanager-RSS.png|alt=RSS Feed settings|center|thumb|450x450px|RSS Feed settings]]
<br />
<br />
===BlueSpiceReaders ===
===BlueSpiceReaders===


*'''Number of readers to display:''' Sets the number of readers that are displayed on the Page information in the Quality management tools. <br />[[File:Manual:PageInformation Reader.png|link=link=Special:FilePath/Manual:configmanager-readers.png|alt=displays readers of the page|center|page=readers|thumb|displays readers of the page]]<br />
*'''Number of readers to display:''' Sets the number of readers that are displayed on the Page information in the Quality management tools. <br />[[File:Manual:PageInformation Reader.png|link=link=Special:FilePath/Manual:configmanager-readers.png|alt=displays readers of the page|center|page=readers|thumb|displays readers of the page]]<br />


=== BlueSpiceSaferEdit===
===BlueSpiceSaferEdit===


*'''Interval for lookup for concurrent editings:''' Sets the time in seconds for checking if another person is editing the page.
*'''Interval for lookup for concurrent editings:''' Sets the time in seconds for checking if another person is editing the page.
*'''Show name of current editor:''' Shows or hides the name of the user who is currently editing the page.
* '''Show name of current editor:''' Shows or hides the name of the user who is currently editing the page.


===BlueSpiceUEModuleBookPDF===
===BlueSpiceUEModuleBookPDF===


* Table of Contents
*'''Table of Contents:'''
**''Only article titles (indent by grade):'' Only shows the article titles in the main contents table of the PDF.<br />[[File:Manual:configmanager-toc-simple.png|alt=PDF table of contents without article TOCs|center|thumb|450x450px|PDF table of contents without article TOCs]]<br />
**''Only article titles (indent by grade):'' Only shows the article titles in the main contents table of the PDF.<br />[[File:Manual:configmanager-toc-simple.png|alt=PDF table of contents without article TOCs|center|thumb|450x450px|PDF table of contents without article TOCs]]<br />
**''Embed article TOCs (No indent of article titles):'' Shows the table of contents for each article in the main contents table of the PDF.[[File:Manual:configmanager-toc-embed.png|alt=Embed article TOCs|center|thumb|450x450px|Embed article TOCs]]
**''Embed article TOCs (No indent of article titles):'' Shows the table of contents for each article in the main contents table of the PDF.[[File:Manual:configmanager-toc-embed.png|alt=Embed article TOCs|center|thumb|450x450px|Embed article TOCs]]  


===BlueSpiceUEModuleHTML===
===BlueSpiceUEModuleHTML===
Line 226: Line 281:
{{Messagebox|boxtype=note|Note text=If the page contains a "displaytitle" tag in the page source, the page display title is shown and this setting has no effect.}}
{{Messagebox|boxtype=note|Note text=If the page contains a "displaytitle" tag in the page source, the page display title is shown and this setting has no effect.}}


===BlueSpiceUEModulePDF===
===BlueSpiceUEModulePDF===  


*'''Hide namespace prefix in PDF:''' If activated, the namespace is shown in the PDF main heading for a page.
*'''Hide namespace prefix in PDF:''' If activated, the namespace is shown in the PDF main heading for a page.
Line 240: Line 295:
===BlueSpiceVisualEditorConnector===
===BlueSpiceVisualEditorConnector===


*'''<span class="col-red">Enable VisualEditor for BlueSpice extensions</span>'''
*'''Enable VisualEditor for BlueSpice extensions:''' Disabling this setting removes VisualEditor from extensions such as Page Forms or BlueSpiceSocial extensions.
*'''<span class="oo-ui-fieldLayout-header">Configuration variable to use a simplified save process</span>'''
* '''Upload type'''
*'''Upload type'''
**''Original:'' User permissions are verified during file upload; file name and namespace of the file can be changed; a category can be assigned and a description of the file is required
**Original (Here a confirmation of the rights of use/upload is obtained, file name and namespace of the file can be changed, a category can be assigned and a description of the file <span class="col-red">MUST</span> be given).
**''Simple:'' User permissions are not verified during file upload; the name and namespace of the file can be changed; a category  and a description of the file can be provided
**Simple (No confirmation of required rights is obtained here, the name and namespace of the file can be changed, a description and a category can be assigned, but does not have to be specified)
**''One click:''  User permissions are not verified during file upload; the image cannot be renamed and no category can be assigned. Only the namespace can, but does not have to be adjusted before uploading)  <br />
**One click (No confirmation about required rights is obtained here, the image cannot be renamed and no category can be assigned. Only the namespace can, but does not have to be adjusted before uploading)  <!-- verify what one-click means, since the next screens appear. --><br />


===BlueSpiceWhoIsOnline===
===BlueSpiceWhoIsOnline ===


*<span class="oo-ui-fieldLayout-header">'''Time in seconds until a user is marked as offline:'''</span> The system checks every ''x'' seconds if a user logged out and no longer displayed as online. This can  be less frequent than the update inteval for newly logged-in users.
*<span class="oo-ui-fieldLayout-header">'''Time in seconds until a user is marked as offline:'''</span> The system checks every ''x'' seconds if a user logged out and no longer displayed as online. This can  be less frequent than the update inteval for newly logged-in users.
*<span class="oo-ui-fieldLayout-header">'''Update interval in seconds:'''</span> The system checks every ''x'' seconds for users.
*<span class="oo-ui-fieldLayout-header">'''Update interval in seconds:'''</span> The system checks every ''x'' seconds for users.


===BlueSpiceExpiry===
=== BlueSpiceExpiry===


==== Export ====
*'''<span class="oo-ui-fieldLayout-header">Show watermark for expired pages in PDF</span>:'''  Shows the watermark for expired pages in PDFs.
*'''<span class="oo-ui-fieldLayout-header">Show watermark for expired pages in PDF</span>:'''  Shows the watermark for expired pages in PDFs.
*<span class="oo-ui-fieldLayout-header">'''Show watermark for expired pages in print version:''' Shows the watermark for expired pages when a page is printed.</span>
* <span class="oo-ui-fieldLayout-header">'''Show watermark for expired pages in print version:''' Shows the watermark for expired pages when a page is printed.</span>
*<span class="oo-ui-fieldLayout-header">'''Show watermark for expired pages'''</span>: Shows a watermark on the page itself.<br />[[File:Manual:configmanager-watermark.png|alt=watermark|center|thumb|250x250px|watermark]]


===BlueSpiceFlaggedRevsConnector===
==== Quality assurance ====
{{BSVersion|bsvFrom=|bsvTo=4.2|bsvFeature=BlueSpiceFlaggedRevsConnector|text=It is replaced by [[#Content Stabilization]].}}
* <span class="oo-ui-fieldLayout-header">'''Show watermark for expired pages'''</span>: Shows a watermark on the page itself.<br />[[File:Manual:configmanager-watermark.png|alt=watermark|center|thumb|250x250px|watermark]]
 
===BlueSpiceFlaggedRevsConnector {{Bsvs|bsvTo=4.2|bsvFeature=BlueSpiceFlaggedRevsConnector}}===
'''Export'''
'''Export'''


The export settings affect how the pages of a book are generated in the PDF export.
The export settings affect how the pages of a book are generated in the PDF export.


*'''<span class="oo-ui-fieldLayout-header">Bookshelf: List approved revisions log</span>:''' Shows a log of stable page versions of pages in the PDF and when these pages were put into accepted status. If editors did not provide a comment when accepting the page, the ''Stable comment'' field for a revision is empty. <br />[[File:Manual:configmanager-bookshelf-revisionslog.png|alt=accepted revisions log|center|thumb|450x450px|accepted revisions log]]<br />
*'''<span class="oo-ui-fieldLayout-header">Bookshelf: List approved revisions log</span>:''' Shows a log of stable page versions of pages in the PDF and when these pages were put into accepted status. If editors did not provide a comment when accepting the page, the ''Stable comment'' field for a revision is empty. <br />[[File:Manual:configmanager-bookshelf-revisionslog.png|alt=accepted revisions log|center|thumb|450x450px|accepted revisions log]]<br />  
*'''Bookshelf: List pages without stable revision:''' Displays a list of PDF pages at the beginning of the PDF that only exist as a first draft and have no released version.[[File:configmanager-book-nichtfreigegebeneseiten-EN.png|center|thumb|300x300px|Pages without acceptance feature|link=Special:FilePath/configmanager-book-nichtfreigegebeneseiten-EN.png]]<br />
*'''Bookshelf: List pages without stable revision:''' Displays a list of PDF pages at the beginning of the PDF that only exist as a first draft and have no released version.[[File:configmanager-book-nichtfreigegebeneseiten-EN.png|center|thumb|300x300px|Pages without acceptance feature|link=Special:FilePath/configmanager-book-nichtfreigegebeneseiten-EN.png]]<br />
*'''Bookshelf: List pages without FlaggedRevs:''' Displays a list of PDF pages that do not have a release mechanism at the beginning of the PDF.
*'''Bookshelf: List pages without FlaggedRevs:''' Displays a list of PDF pages that do not have a release mechanism at the beginning of the PDF.
Line 276: Line 332:
'''Quality assurance'''
'''Quality assurance'''


*'''Include handling:''' If resources are embedded in a page and those resources are located in namespaces with approval mechanism, then the following settings can be selected. For example: If an approved page contains a template or a file that has been changed after the page itself has been approved, the page will not get another draft version, but instead one of two configurations applies:
*'''Include handling:''' If resources are embedded in a page and those resources are located in namespaces with approval mechanism, then the following settings can be selected. For example: If an approved page contains a template or a file that has been changed after the page itself has been approved, the page will not get another draft version, but instead one of two configurations applies:  
**Current versions: Always show the latest version of the embedded resource.
**Current versions: Always show the latest version of the embedded resource.
**Stable versions: Always show the stable (=approved) version of a resource.  
**Stable versions: Always show the stable (=approved) version of a resource.


*<span class="oo-ui-fieldLayout-header">'''Show unstable pages for following groups:'''</span> If the group ''user'' is removed from the ''BlueSpiceFlaggedRevs'' configuration, users in this group will not be able to see draft versions when they are added as reviewers in a review process. When the group user is removed, only ''sysop'' and ''reviewer'' users can access drafts. If you want other groups, for example ''editor'', to see draft versions, you need to add them to the configuration. If no user groups are specified in the configuration field, not even reviewers and sysops users will see a visual status indication of a page. They will have access to drafts through the revision history for the page instead.
*<span class="oo-ui-fieldLayout-header">'''Show unstable pages for following groups:'''</span> If the group ''user'' is removed from the ''BlueSpiceFlaggedRevs'' configuration, users in this group will not be able to see draft versions when they are added as reviewers in a review process. When the group user is removed, only ''sysop'' and ''reviewer'' users can access drafts. If you want other groups, for example ''editor'', to see draft versions, you need to add them to the configuration. If no user groups are specified in the configuration field, not even reviewers and sysops users will see a visual status indication of a page. They will have access to drafts through the revision history for the page instead.
Line 284: Line 340:
'''Searching and Navigation'''
'''Searching and Navigation'''


*<span class="oo-ui-fieldLayout-header">'''Indexing only stable versions:''' Draft versions are excluded from the search results. If a page does not have a stable version, it is not shown as a search result.</span><span class="oo-ui-fieldLayout-field"><span id="bsgFlaggedRevsConnectorUEModulePDFShowFRTag" class="oo-ui-widget oo-ui-widget-enabled oo-ui-inputWidget oo-ui-checkboxInputWidget" aria-disabled="false" data-ooui><span class="oo-ui-checkboxInputWidget-checkIcon oo-ui-widget oo-ui-widget-enabled oo-ui-iconElement oo-ui-iconElement-icon oo-ui-icon-check oo-ui-iconWidget oo-ui-image-invert" aria-disabled="false"></span></span></span><span class="oo-ui-fieldLayout-field"><span id="bsgFlaggedRevsConnectorUEModulePDFShowFRTag" class="oo-ui-widget oo-ui-widget-enabled oo-ui-inputWidget oo-ui-checkboxInputWidget" aria-disabled="false" data-ooui><span class="oo-ui-checkboxInputWidget-checkIcon oo-ui-widget oo-ui-widget-enabled oo-ui-iconElement oo-ui-iconElement-icon oo-ui-icon-check oo-ui-iconWidget oo-ui-image-invert" aria-disabled="false"></span></span></span>
* <span class="oo-ui-fieldLayout-header">'''Indexing only stable versions:''' Draft versions are excluded from the search results. If a page does not have a stable version, it is not shown as a search result.</span><span class="oo-ui-fieldLayout-field"><span id="bsgFlaggedRevsConnectorUEModulePDFShowFRTag" class="oo-ui-widget oo-ui-widget-enabled oo-ui-inputWidget oo-ui-checkboxInputWidget" aria-disabled="false" data-ooui><span class="oo-ui-checkboxInputWidget-checkIcon oo-ui-widget oo-ui-widget-enabled oo-ui-iconElement oo-ui-iconElement-icon oo-ui-icon-check oo-ui-iconWidget oo-ui-image-invert" aria-disabled="false"></span></span></span><span class="oo-ui-fieldLayout-field"><span id="bsgFlaggedRevsConnectorUEModulePDFShowFRTag" class="oo-ui-widget oo-ui-widget-enabled oo-ui-inputWidget oo-ui-checkboxInputWidget" aria-disabled="false" data-ooui><span class="oo-ui-checkboxInputWidget-checkIcon oo-ui-widget oo-ui-widget-enabled oo-ui-iconElement oo-ui-iconElement-icon oo-ui-icon-check oo-ui-iconWidget oo-ui-image-invert" aria-disabled="false"></span></span></span>


=== BlueSpiceSocial ===
=== BlueSpicePrivacy {{Bsvs|bsvFrom=4.4|bsvFeature=BlueSpicePrivacy}} ===


* '''Show entrypoint "Timeline":''' Shows a link to the page ''Special:Timeline'' in the main navigation.
* '''Enable mandatory cookies:''' Users have to explicitely accept the mandatory cookies to get access to the wiki. If this setting is not activated, users accept the mandatory cookies implicitly.
* '''Enable mandatory "Privacy policy" and "Terms of service"''': Users have to consent to the "Privacy policy" and "Terms of service" to get and to keep access.
* '''Accept "Privacy policy" and "Terms of service" on login''': Accepting the "Privacy policy" and "Terms of service" is integrated into the login process. It is required on first login and everytime a user deactivates the consent in the user preferences.
 
===BlueSpiceSocial===
 
*'''Show entrypoint "Timeline":''' Shows a link to the page ''Special:Timeline'' in the main navigation.


===BlueSpiceSocialBlog===
===BlueSpiceSocialBlog===
Line 296: Line 358:
<br />[[File:Manual:configmanager-blogteaser.png|center|thumb|380x380px|blog teaser text|link=Special:FilePath/Manual:configmanager-blogteaser.png]]
<br />[[File:Manual:configmanager-blogteaser.png|center|thumb|380x380px|blog teaser text|link=Special:FilePath/Manual:configmanager-blogteaser.png]]


* '''Show entrypoint "Blog":''' Shows a link to the page ''Special:Blog'' in the main navigation.
*'''Show entrypoint "Blog":''' Shows a link to the page ''Special:Blog'' in the main navigation.


===BlueSpiceSocialTopics===
===BlueSpiceSocialTopics===
Line 304: Line 366:
If this setting is deactivated, the user is directed to the "Create page" default page first.<br />
If this setting is deactivated, the user is directed to the "Create page" default page first.<br />


== BlueSpiceDiscovery ==
==BlueSpiceDiscovery==
 
* '''Deactivating the Entrypoint links:''' Depending on the BlueSpice version, various links to special pages can be activated for the main navigation. They are called entrypoint links.


====Deactivating the Entrypoint links====
[[File:discovery-entrypoint links.png|alt=Entrypoint links for Discovery skin|center|thumb|650x650px|Entrypoint links for Discovery skin]]
[[File:discovery-entrypoint links.png|alt=Entrypoint links for Discovery skin|center|thumb|650x650px|Entrypoint links for Discovery skin]]


====Positioning of skin elements====
* '''Menu in main panel of primary sidebar:'''
[[File:BlueSpice-Discovery2.png|alt=positioning skin elements|center|thumb|600x600px|positioning skin elements]]
** ''MediaWiki sidebar:'' Activates the M''ediaWiki:Sidebar'' page, which can display a flat list of links.
 
** ''Namespace main page list'': The pages with the page name "Main Page" for each namespace are automatically linked in the main navigation. It is not possible to add links manually to the navigation.
*page-sentence: display of page status ([[Manual:Extension/FlaggedRevs|Approval status]], [[Manual:Extension/BlueSpiceExpiry|Expiry]])
** ''Subpage tree:'' In the main navigation, the pages with the page name "Main Page" are automatically linked in the respective namespaces.  It is not possible to add links manually to the navigation.
*categories: display of  [[:de:Handbuch:Kategorien_erstellen_und_nutzen|page categories]]
** ''Enhanced MediaWiki sidebar'': Activates the M''ediaWiki:Sidebar.json'' page, which can display a more dynamic and hierarchical list of links.
 
* '''Elements below the page title and below the page content:'''
*rating: display of [[Manual:Extension/BlueSpiceRating|page ratings]]
** page-sentence: display of page status ([[Manual:Extension/FlaggedRevs|Approval status]], [[Manual:Extension/BlueSpiceExpiry|Expiry]])
 
** categories: display of  [[:de:Handbuch:Kategorien_erstellen_und_nutzen|page categories]]
*recommendations: display of [[Manual:Extension/BlueSpiceRating|page recommendations]]
** rating: display of [[Manual:Extension/BlueSpiceRating|page ratings]]
 
** recommendations: display of [[Manual:Extension/BlueSpiceRating|page recommendations]][[File:BlueSpice-Discovery2.png|alt=positioning skin elements|center|thumb|600x600px|positioning skin elements]]
=== Content Stabilization{{bsvs|bsvFrom=4.3|bsvTo=|bsvFeature=}} ===
The following configuration options are available for page approvals:
 
*'''Include handling (1):'''  Wenn Ressourcen in eine Seite eingebettet sind '''und sich diese Ressourcen in Namensräumen mit Freigabe befinden''', können die folgenden Einstellungen ausgewählt werden. Es gibt zwei mögliche Einstellungen:
 
{| class="wikitable" style="width:100%;" data-ve-attributes="{&quot;style&quot;:&quot;width:100%;&quot;}"
! style="width:220px;" data-ve-attributes="{&quot;style&quot;:&quot;width:220px;&quot;}" |
!Verhalten
|-
| style="width:220px;" data-ve-attributes="{&quot;style&quot;:&quot;width:220px;&quot;}" |<span class="col-red ve-pasteProtect">Stable versions of included pages</span>
|Shows the approved (stable) version of a resource, even if it was approved after the page that includes the resource was approved. (This works only if the resource is located in a namespace with active approval feature).
|-
| style="width:220px;" data-ve-attributes="{&quot;style&quot;:&quot;width:220px;&quot;}" |<span class="col-red ve-pasteProtect">Versions that were current at the time of approval</span>
|Shows the version of the resource which was embedded at the time of the last approval of the wiki page where it is embedded. (This works only if the resource is located in a namespace with active approval feature).
|}For example, if an approved page contains a template that was modified after the page itself was approved, the page will not show  a draft version. Approvals work directly via the embedded resource.
 
*'''Allow viewing of first draft version (2):'''    If this setting is activated, then all users with read rights can view the first draft. When disabled, only groups from the "Show unstable pages for following groups" setting can see first drafts.
*'''Update semantic properties from stable pages only (3):'''    The  property value of the page is read from the stable version of the page and not from the draft version.
 
*'''Entwurfsseiten für folgende Gruppen anzeigen (4):'''  If the  group <code>user</code> has been removed from the configuration, users in this group will not be able to see draft versions when they are added as reviewers in a review process. In this case, only users with the roles <code>sysop</code> and <code>reviewer</code>  can access drafts unless other groups are specified. These system groups can only access drafts through the site's version history.
{{translation}}
{{translation}}
[[Category:Administration]]
[[Category:Administration]]

Latest revision as of 09:12, 6 November 2024

With the Config manager, a wiki user with sysop rights can manage wiki-wide settings in one place. In the navigation, it is located at Global navigation > Management > Configuration. This link loads the page Special:BluespiceConfigManager.

Layout

Filter options

All settings can be accessed through the following filter options:

  • Feature: group by type of functionality the setting belongs to (search, administration...)
  • Extension: group by extension name
  • Package: group by BlueSpice edition and services (BlueSpice free, BlueSpice pro, Matomo)
config manager filters
config manager filter

All settings are available in any type of grouping. Changing the grouping type does not add or remove setting options. It just groups them differently. After settings are adjusted, they can be saved by clickingSave, or cancelled by clicking Reset.

Note:If a server administrator has configured a setting to no longer be writable, it will be shown as greyed-out in the config manager. You will have to talk to your server administrator about changing such a setting.


Searching for settings

A search bar is located above the list of settings. Type in a keyword such as "logo" to find the corresponding setting. The search returns settings regardless of the currently selected group.

Note:The search field has to be empty if you want to see the filter menu instead of the search.


Config manager search box
Config manager search box

Settings by extension

EventBus

Eventbus sends notifications to external urls in case something happens in the wiki. For example, if a page is created, an external service could then be started and create a pdf of that page. See the extension's page on mediawiki.org.

EnhancedUpload   v4.3+

Sets the defaults for the advanced image settings when uploading and embedding an image into the wiki via drag-and-drop functionality. The default settings determine the orientation, type, and size of the image. These can be adjusted after embedding via the "Advanced settings" of the image on the page.

Screenshot of the "Enhanced Upload" configuration
Configuration settings for the Enhanced upload
  • Allow mismatched MIME types (potential security risk): If the file extension of a file does not match the actual file type, it will still be uploaded if it is listed as an allowed file extension in the wiki.

BlueSpiceDistributionConnector   v4.5+

  • BlueSpice subscription key: Sets the number of users as specified in the subscription contract. If this entry is missing, the number of users is limited to 25.
  • OAuth2 public key, OAuth private key: Required if user authentication is configured via OAuth.

ContentStabilization   v4.3+

Book

  • Export: List approved pages contained in the book
    Displays a list of the approved versions of each page at the beginning of the PDF.
    List of approved pages
  • Export: List unapproved pages contained in the book:
    Displays a list of the pages at the beginning of the PDF that only exist as a first draft and that do not have an approved version.
    Pages in the first draft
  • Export: List approved pages contained in the book that do not have stabilization enabled
    Displays a list of the pages at the beginning of the PDF that do not use the approval mechanism .
    Pages without approval mechanism

Export

  • Show stabilization information in PDF export:
    Prints the timestamp for the last approved version below the page headings in the PDF (date of approval and date of last edit before approval).
    FlaggedRevs info under the heading


Quality assurance

  • Include handling: If resources are embedded in a page and these resource namespace itself has approval enabled, the following settings can be selected:
Behavior
Versions that were current at the time of release Displays the version of the resource that was current at the time of the approval of the page on which the resource is embedded (only applies if the resource is in a namespace with approval function. If an approved page contains a template for example, the page does not exist in another draft version. The approval works directly on the embedded resource.) If the approval function is not activated in the namespace of the resource, the resource has to be approved on all wiki pages where it is embedded.
Approved versions of included pages Always displays the currently approved version of the resource, even if this version was created after the page was approved (this setting only applies if the resource is in a namespace with approval function. If an approved page contains a template, the page does not exist in another draft version. Sharing works directly via the embedded resource.) If the approval function is not activated in the namespace of the resource, the resource has to be approved on all wiki pages where it is embedded.
Current versions of included pages Always shows the most current version of a resource.
  • Show not approved pages for following groups: If the user group has been removed from the configuration, users in this group cannot see draft versions. This also applies if they are added as reviewers in a namespace. In this case, only users with the sysop and reviewer permissions can access drafts, unless other groups are specified. These system groups can then only access drafts via the page's version history. All groups that can see page drafts anywhere in the wiki must be explicitly specified here. This setting applies to the entire wiki and cannot be restricted to namespaces.
  • Allow viewing of first draft version for users who can normally not see drafts: If this setting is enabled, all users with read permissions can see the first draft. If disabled, only groups from the setting "The following groups can see draft versions" can see first drafts.
  • Update semantic properties from approved versions only: The attribute value of the page is set from the stable version of the page and not from the draft version.

Search and navigation

  • Index approved versions of pages only: Page names and contents of draft pages are not taken into account by the search.

AI Editing Assistant  v4.5+

  • Provider type: One of the supported providers is selected here (OpenAI or Ollama). OpenAI requires its own account, which provides an API key.
  • Connection params: The API key of the provider is entered here (OpenAI) or the endpoint URL (Ollama)

NumberHeadings   v4.5+

  • Enable heading numbering: Displays the numbering from the table of contents before the section headings on a page.
    Selected checkbox for the extension NumberHeadings
    Number headings
    Headings of an example page
    Activated heading numbers

BlueSpiceFoundation

Updating logo and favicon

Note:Since BlueSpice 4.2, the logo and favicon can also be managed via the page Special:Flexiskin together with further skin customizations.
  • Logo path: The logo image should be stored in the /images folder of your installation. If you store it in the /skins folder of your BlueSpice installation, it could be overwritten with an upgrade.

To upload the logo directly in the wiki:

  1. Upload the logo on the page from the menu Global actions > File list (Special:ExtendedFilelist).
  2. Click on the thumbnail image of the logo. This opens the logo on a separate page.
    logo thumbnail image
    logo thumbnail image
  3. Copy the relative logo path from the address bar. In a typical Wiki configuration, this path starts with /w/.... .
    relative image path
    relative image path
  4. Paste the logo path into the text field for the logo.
    logo path
    logo path
  5. Click Save.
  6. Refresh the page (Strg+F5).
    If the uploaded logo is too large, you can add the following code snippet to the page MediaWiki:Common.css. This automatically adjusts the image to the height of the main toolbar:
    .bs-logo a {background-size: contain;}
    
  • Favicon path: The favicon image should be stored in the /images folder of your installation. If you store it in the /skins folder of your BlueSpice installation, it could be overwritten with an upgrade. Favicon images have the file extension .ico.

System

  • Allowed file extensions: For security reasons, the types of files that users can upload are restricted. Here, you can allow additional file formats. If a file format is blacklisted in the server configuration, adding this file extension here will not allow this file type to be uploaded. See mediawiki.org/wiki/Manual:$wgFileExtensions for more info.
XML file type:The xml file type is blacklisted since MW 1.39 and has to be allowed in LocalSettings.php:
$GLOBALS['wgProhibitedFileExtensions'] = array_diff( $GLOBALS['wgProhibitedFileExtensions'] ?? [], [ 'xml' ] );
$GLOBALS['wgMimeTypeExclusions'] = array_diff( $GLOBALS['wgMimeTypeExclusions'] ?? [], [ 'application/xml', 'text/xml' ] );


BlueSpiceArticleInfo

BlueSpiceArticleInfo, together with BlueSpiceAuthors, BlueSpiceReaders, and BlueSpiceExtendedSearch is part of the Page information in the quality management tools.

  • Update interval in seconds: Sets the refresh rate for the "Last edit" value. By default, this date is updated every 10 seconds via JavaScript.
article info

BlueSpiceAuthors

BlueSpiceAuthors, together with BlueSpiceArticleInfo and BlueSpiceReaders, is part of the Page information in the quality management tools.

  • Display authors: Show or hide authors on the page information page. This setting has no effect on the version history of a page.
Authors of page

BlueSpiceAvatars

InstantAvatar

An avatar image is automatically generated if the user does not upload a profile picture or if the user decides to create an avatar image in the preferences.

  • Generator
    • InstantAvatar: Generates an avatar image based on using the initials of the Real name or the Username
    • Identicon: Generates an avatar image based on parts of the user's IP address.
      Identicon
      Identicon

BlueSpiceBookshelf

Book

  • Show book chapter pager after content: Displays previous/next book page navigation at the end of each book page. (1)
  • Show book chapter pager before content: Displays previous/next book page navigation at the beginning of each book page. (2)
    Book navigation
    Book navigation

  • Use display title from book source on article: Shows the title from the book navigation as page title instead of the page name.
book display title
book display title
Note:If the page additionally contains a {{DISPLAYTITLE}} tag, the display title of the page is shown on the page and in the book navigation instead of the page label provided in the book page.


Content structuring

Prepend article table of contents and headlines with book numberation: The page TOC does not start with the main heading 1, but with the actual number from the book chapter (see screenshot). If users have activated in their user preferences to "auto-number headings", the numbering system is matched accordingly.

Prepended chapter numbers
Prepended chapter numbers

Export

  • Supress namespace prefix of book articles in output: The namespace prefix of an article is not shown in PDFs.

Skinning

  • Show entrypoint "Books": Adds a link to the page Special:Books to the main navigation entrypoints.

BlueSpiceChecklist

  • Mark checklist changes as minor edit: If this setting is active, changes to a checklist (for example, checking a checkbox) in view mode are logged as minor edits. If this setting is inactive, a change to the checklist is recorded as a regular version in the page history.
    minor edit
    minor edit

BlueSpiceExtendedSearch

  • External file paths: External locations to scan for and index files from. These locations are entered in key/value pairs of Physical path and URL prefix.
    • Physical path: Storage path. For mounted drives, for example: X:\Documents
    • URL prefix: All files indexed from the indexed physical location are prefixed in the search results. It should be used if files are available from a web server. By default, the URL prefix is set to the same value as Physical path.


Examples for external file paths
Example file Phys. Path URL Prefix Link in results list
S:\Sales\Info\glossaryy.pdf S:\ file:///S:/ file:///S:/Sales/Info/glossary.pdf
https://sharepoint/Sales/

documents/

https://sharepoint/Sales/

documents/Sales/Info/glossary.pdf

https://intranet/showdocs

inline.aspx?path=

https://intranet/showdocsinline.aspx?

path=/Sales/Info/glossary.pdf

/var/www/bluespice/w/mounted_

share/Sales/Info/glossary.pdf

/var/www/bluespice/w/

mounted_share/

https://wiki.company.local/w/mounted_

share/Sales/Info/glossary.pdf

Add an external file path
Add an external file path: (1) confirm the checkmark and (2) save the settings.


  • Use simple autocomplete: forces a more compact autocomplete (1-column Sales thumbnail preview).
    compact autocomplete
    compact autocomplete
    regular autocomplete
    Salesautocompletey

  • Automatically set language filter: The search only returns pages whose language (PageLanguage) is identical to the user language (Language). Users can set their language in their preferences. By default, the language of content pages is the same as the installation language (ContentLanguage) of the wiki. Some extensions can set the language of individual pages independently of the content language of the wiki.. (See: https://www.mediawiki.org/wiki/Manual:Language#Page_content_language). In many wikis, activating this filter has little effect.
  • Exclude patterns: Files at external file locations can be exluded from search based on regular expression patterns.

BlueSpiceExtendedStatistics

  • Exclude these users: Some user groups, like WikiSysop can skew the statistics, for example the statistics for search queries or because they complete automated maintenance tasks. These types of user groups can be excluded from the statistical results.
  • Maximum number of interval steps: Sets the size of the x-axis for the results. For a few days, select the interval Day or Calendar Week, for periods over one year, select Year or Month. If you do not get any results for your query, try to adjust the interval accordingly.

BlueSpiceInsertCategory

  • Insert category with its parents: When a category is inserted on a page, its parent categories are automatically inserted as well.
  • Set page categories as default in upload dialog: When a file is uploaded to the wiki via the visual editor, the categories of the paged are automatically inserted on the file page.

BlueSpiceInsertLink

  • Allow unmapped links: if there is no prefix in the map, the link will still be inserted. Example: S:\HR. If this setting is unchecked, the link will not be inserted.
  • Allowed locations for external files:
Example file Filesystem prefix Web accessible Prefix Link output
S:\Sales\Info\glossaryy.pdf S:\ file:///S:/ file:///S:/Sales/Info/glossary.pdf
https://sharepoint/Sales/

documents/

https://sharepoint/Sales/

documents/Sales/Info/glossary.pdf

https://intranet/showdocs

inline.aspx?path=

https://intranet/showdocsinline.aspx?

path=/Sales/Info/glossary.pdf

/var/www/bluespice/w/mounted_

share/Sales/Info/glossary.pdf

/var/www/bluespice/w/

mounted_share/

https://wiki.company.local/w/mounted_

share/Sales/Info/glossary.pdf

When a new entry is added, it has to be confirmed by clicking the checkmark next to it before saving the page.

Screenshot of the InsertLink configuration options
InsertLink configuration options


BlueSpicePageTemplates

  • Force target namespace: The page is always created in the target namespace that is associated with the template, even if the user provided a different namespace prefix. In the screenshot below, the user wants to create the page "NewPage" and then selects a template for the QM namespace. The page is, therefore, created as "QM:NewPage" if this setting is activated.
    force the namespace of the template
    force the namespace of the template
  • Hide default templates: Hides the default Empty page template.
  • Hide template if the page is not to be created in the target namespace: Depending on the namespace prefix of the page to be created, templates that are associated with other namespaces will not be shown to the user for selection.

BlueSpicePermissionManager

  • Backup limit: Sets the number of backups for the permissions manager. Each time the page Special:PermissionManager is saved, a backup is created. If the backup limit is set to 5, the last five versions of the permissions configuration are saved as backups.

BlueSpiceRSSFeeder

  • URL whitelist: RSS feeds need to be whitelisted here by an administrator before they can be displayed in a wiki page.
  • Maximum number of allowed redirects: If there are URL redirects for any of the whitelisted URLs, the number of redirects needs to be adjusted (usually to 1 or 2).
RSS Feed settings
RSS Feed settings


BlueSpiceReaders

  • Number of readers to display: Sets the number of readers that are displayed on the Page information in the Quality management tools.
    displays readers of the page
    displays readers of the page

BlueSpiceSaferEdit

  • Interval for lookup for concurrent editings: Sets the time in seconds for checking if another person is editing the page.
  • Show name of current editor: Shows or hides the name of the user who is currently editing the page.

BlueSpiceUEModuleBookPDF

  • Table of Contents:
    • Only article titles (indent by grade): Only shows the article titles in the main contents table of the PDF.
      PDF table of contents without article TOCs
      PDF table of contents without article TOCs

    • Embed article TOCs (No indent of article titles): Shows the table of contents for each article in the main contents table of the PDF.
      Embed article TOCs
      Embed article TOCs

BlueSpiceUEModuleHTML

  • Hide namespace prefix in HTML: If activated, the namespace is shown in the HTML main heading.
Note:If the page contains a "displaytitle" tag in the page source, the page display title is shown and this setting has no effect.


BlueSpiceUEModulePDF

  • Hide namespace prefix in PDF: If activated, the namespace is shown in the PDF main heading for a page.
namespace in heading
namespace in heading
Note:If the page contains a "displaytitle" tag in the page source, the page display title is shown and this setting has no effect.


BlueSpiceUniversalExport

  • Metadata (standard, JSON): Additional data to be passed to the rendering template in JSON format. This data can be used in the export template. The template itself is maintened server-side.
  • Metadata (override, JSON): Allows overriding standard data sent to the rendering template in JSON format. Values that are set by default can be overriden with this option.

BlueSpiceVisualEditorConnector

  • Enable VisualEditor for BlueSpice extensions: Disabling this setting removes VisualEditor from extensions such as Page Forms or BlueSpiceSocial extensions.
  • Upload type
    • Original: User permissions are verified during file upload; file name and namespace of the file can be changed; a category can be assigned and a description of the file is required
    • Simple: User permissions are not verified during file upload; the name and namespace of the file can be changed; a category and a description of the file can be provided
    • One click: User permissions are not verified during file upload; the image cannot be renamed and no category can be assigned. Only the namespace can, but does not have to be adjusted before uploading)

BlueSpiceWhoIsOnline

  • Time in seconds until a user is marked as offline: The system checks every x seconds if a user logged out and no longer displayed as online. This can be less frequent than the update inteval for newly logged-in users.
  • Update interval in seconds: The system checks every x seconds for users.

BlueSpiceExpiry

Export

  • Show watermark for expired pages in PDF: Shows the watermark for expired pages in PDFs.
  • Show watermark for expired pages in print version: Shows the watermark for expired pages when a page is printed.

Quality assurance

  • Show watermark for expired pages: Shows a watermark on the page itself.
    watermark
    watermark

BlueSpiceFlaggedRevsConnector   -v4.2

Export

The export settings affect how the pages of a book are generated in the PDF export.

  • Bookshelf: List approved revisions log: Shows a log of stable page versions of pages in the PDF and when these pages were put into accepted status. If editors did not provide a comment when accepting the page, the Stable comment field for a revision is empty.
    accepted revisions log
    accepted revisions log

  • Bookshelf: List pages without stable revision: Displays a list of PDF pages at the beginning of the PDF that only exist as a first draft and have no released version.
    Pages without acceptance feature

  • Bookshelf: List pages without FlaggedRevs: Displays a list of PDF pages that do not have a release mechanism at the beginning of the PDF.


Pages with no FlaggedRevs feature.
Pages with no FlaggedRevs feature.


  • UEModulePDF: Show FlaggedRevs info below main heading: Prints the latest revision dates (last acceptance and last edit date) below the heading.
    FlaggedRevs info below heading
    FlaggedRevs info below heading

Quality assurance

  • Include handling: If resources are embedded in a page and those resources are located in namespaces with approval mechanism, then the following settings can be selected. For example: If an approved page contains a template or a file that has been changed after the page itself has been approved, the page will not get another draft version, but instead one of two configurations applies:
    • Current versions: Always show the latest version of the embedded resource.
    • Stable versions: Always show the stable (=approved) version of a resource.
  • Show unstable pages for following groups: If the group user is removed from the BlueSpiceFlaggedRevs configuration, users in this group will not be able to see draft versions when they are added as reviewers in a review process. When the group user is removed, only sysop and reviewer users can access drafts. If you want other groups, for example editor, to see draft versions, you need to add them to the configuration. If no user groups are specified in the configuration field, not even reviewers and sysops users will see a visual status indication of a page. They will have access to drafts through the revision history for the page instead.

Searching and Navigation

  • Indexing only stable versions: Draft versions are excluded from the search results. If a page does not have a stable version, it is not shown as a search result.

BlueSpicePrivacy   v4.4+

  • Enable mandatory cookies: Users have to explicitely accept the mandatory cookies to get access to the wiki. If this setting is not activated, users accept the mandatory cookies implicitly.
  • Enable mandatory "Privacy policy" and "Terms of service": Users have to consent to the "Privacy policy" and "Terms of service" to get and to keep access.
  • Accept "Privacy policy" and "Terms of service" on login: Accepting the "Privacy policy" and "Terms of service" is integrated into the login process. It is required on first login and everytime a user deactivates the consent in the user preferences.

BlueSpiceSocial

  • Show entrypoint "Timeline": Shows a link to the page Special:Timeline in the main navigation.

BlueSpiceSocialBlog

  • Use teaser text for blog entries in the timeline: When you create a blog entry, you can create a teaser text for it by clicking the cogwheel symbol in the blog entry form. If this setting is active, the teaser text will be shown on the page Special:Timeline instead of the first part of the content.


blog teaser text
  • Show entrypoint "Blog": Shows a link to the page Special:Blog in the main navigation.

BlueSpiceSocialTopics

  • Automatically create all discussion pages. If a user creates the first discussion topic for a page using the link in the page footer of a wiki page, the needed discussion page is automatically created first.
    create discussion topic
    create discussion topic

    A message "This discussion page was created automatically" is inserted on the discussion page.
    automatically created discussion page
    automatically created discussion page

If this setting is deactivated, the user is directed to the "Create page" default page first.

BlueSpiceDiscovery

  • Deactivating the Entrypoint links: Depending on the BlueSpice version, various links to special pages can be activated for the main navigation. They are called entrypoint links.
Entrypoint links for Discovery skin
Entrypoint links for Discovery skin
  • Menu in main panel of primary sidebar:
    • MediaWiki sidebar: Activates the MediaWiki:Sidebar page, which can display a flat list of links.
    • Namespace main page list: The pages with the page name "Main Page" for each namespace are automatically linked in the main navigation. It is not possible to add links manually to the navigation.
    • Subpage tree: In the main navigation, the pages with the page name "Main Page" are automatically linked in the respective namespaces. It is not possible to add links manually to the navigation.
    • Enhanced MediaWiki sidebar: Activates the MediaWiki:Sidebar.json page, which can display a more dynamic and hierarchical list of links.
  • Elements below the page title and below the page content:



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