Manual:Extension/BlueSpiceConfigManager

About Config manager

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

Config manager navigation item

Layout

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 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 reset to the default settings by clicking Reset.

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

Settings by extension

BlueSpiceFoundation

• 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 Extended file list (Special:ExtendedFilelist). This is a link under the Global actions navigation.
2. Search for the logo name in the extended file list.
3. Click on the thumbnail image of the logo. This opens the logo on a separate page.
   
   

   logo thumbnail image
4. Copy the relative logo path from the address bar.In a typical Wiki configuration, this path starts with /w/.... .
   
   

   relative image path
   
   
5. Paste the logo path into the text field for the logo.
   
   

   logo path
6. Click Save.
7. Refresh the page (Strg+F5).

• 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.
• 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:Configuring_file_uploads for more info.

• Allowed image extensions: The standard web image types are listed here. In general, you want to restrict image uploads to web images. See developer.mozilla.org/en-US/docs/Web/Media/Formats/Image_types for more on browser-supported image types.

BlueSpiceAbout

• Show link "About BlueSpice" in the main menu: Shows or hides the link to the page AboutBlueSpice in the main navigation.
  

main navigation

BlueSpiceArticleInfo

BlueSpiceArticleInfo, together with BlueSpiceAuthors, 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, is part of the Page Information in the quality management tools.

• Display authors: Show or hide authors on the page information page.

page authors in page information

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

BlueSpiceBookshelf

• Use the 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

Note: If the page additionally contains a

"displaytitle" tag in the page source, this display title

{{DISPLAYTITLE}} tag, the display title of the page is shown instead of the

display

book title

of the book

.

• Prepend article table of contents and headlines with book numberation
• Supress namespace prefix of book articles in output

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 not recorded in the page history.
  
  

  minor edit

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.

BlueSpiceReaders

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

  page readers
  
  

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):
  • Embed article TOCs (No indent of article titles)

BlueSpiceUEModuleHTML

• Hide namespace prefix in PDF: 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

Note: If the page contains a "displaytitle" tag in the page source, the page display title is shown and this setting has no effect.

BlueSpiceVisualEditorConnector

Enable VisualEditor for BlueSpice extensionsConfiguration variable to use a simplified save process Upload type

Original

Simple

One click

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

• 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.
• Show watermark for expired pages: shows a watermark on the page itself.
  
  

  watermark
  
  

BlueSpiceFlaggedRevsConnector

• Export: The export settings affect how the pages of a book are generated in the PDF export.
  • Bookshelf: List accepted revisions log: Shows a log of stable page versions 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
    
    
  • Bookshelf: List pages without stable revision
  • Bookshelf: List pages without FlaggedRevs
  • UEModulePDF: Show FlaggedRevs info below main heading: Prints the latest revision dates below the heading.
    
    

    FlaggedRevs info below heading
    
    
  • Automatically set the page to stable, when the workflow was finished successfully: The workflow ends with setting the page status to stable.
  • Automatically delete the workflow, when a page was marked as stable: The workflow is deleted.

• 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.
  

Indexing only stable versions

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
  
  

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
  
  A message "This discussion page was created automatically" is inserted on the discussion page.
  
  

  automatically created discussion page
  
  

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

BlueSpiceMatomoConnector

• Site ID: Eingabe der Matomo ID für die Webseite. Diese findet man leicht als url parameter in of the wiki. You can find the site ID as a url parameter in the browser address bar when you are logged into Matomo.

matomo site ID

• Base url: Die The url zu Ihrer Matomo Login-Seiteto your Matomo installation.
• Show opt-out link in footer: matomo url Displays a link in your wiki footer, usually named Analysis service.
  
  

  footer links
  
  On the Analysis service page, there is a checkbox that allows a user to opt-out from being tracked for analysis purposes.
  

  Matomo opt-out checkbox
  
  

Related info

• Reference:ConfigManager