Timeline

With group synchronization, a user's AD groups are regularly retrieved from AD (the first time they log in each day and then about once an hour) and matched to the groups assigned in the wiki. If a group assigned in the wiki is not in the list of AD groups, the user is removed from it - and vice versa.

If, for example, you create and authorize a "Wiki_Editor" group in the wiki, a group with the exact same name must also be created in AD and the users must be added accordingly. In this case, you no longer need to assign groups in the wiki's user management. This happens automatically through the existence of the group alone.

If it is not possible to create the group in AD and you are dependent on the user administration to assign the groups, we have to put the corresponding group in the configuration of the wiki on the list of "locally managed groups".

Therefore, there are two options:

1. You create the group in AD and assign the users there. Then, you create them in the wiki via the group management and authorize them via the rights management. In this case you only need the support of your internal IT and no assistance from us.

2. You only create the group via the group administration, assign rights via the rights administration and assign the users to the groups manually via the user administration. In this case, we have to put the group on the list of "locally administered groups". We need server access for this and you are responsible for the assignment yourself. Of course, we can also provide instructions for your IT that describe what needs to be done in this case. In this case you would not need our support.

Version: 3.1

Question: Where can I specify the template path for PDF export? In the ConfigManager, I only see the option "Hide Namespace prefix in PDF for BlueSpiceUEModulePDF

Answer: The corresponding option has not made it into configuration management. In general, it is discussed internally which settings should all be customizable via the web interface.

The path to the PDF template as well as the default template can be set in the LocalSettings.php:

$bsgUEModulePDFTemplatePath = "/path/to/directory";

$bsgUEModulePDFDefaultTemplate = "Foldername-of-the-template";

https://github.com/wikimedia/mediawiki-extensions-BlueSpiceUEModulePDF/blob/master/extension.json#L77-L82

Question:

I'm tring to install public extension for mediawiki "Translate" that add multilanguage feature to the wikipages.

This extension require some permission to user, I have added it on LocalSettings.php but seems that during loading of pages, something override this permission. So i'm tring to add it from BSPermissionManager but it can't add new permission, only assign default.

Is there a way to add custom permission to a group and avoid overriding of BSPermissionManager?

Answer:

BlueSpice since version 3.0 implements a custom access system using roles. This system still supports using 3rd party permisisons, but they must be registered with BlueSpice role system.

When registering new permission you define to which roles that permission will belong to, and all user groups assigned that role will be also assigned that permission.

Example:

- to register new permission "mypermission" you would add following code to LocalSettings.php:

<code><nowiki>

$bsgPermissionConfig["mypermission"] = [

"type" => "global",

"roles" => ["admin", "reader" ]

];</nowiki></code>

Of course, substitute "mypermission" for the permission name required for Translate extension. If there are multiple required permission, create one of these entries for each one.

This means that roles "admin" and "reader" will now also contain "mypermission". To verify this, go to PermissionManager and click on the "i" icon in front of the role name (one of the roles you assigned permission to). In dialog that opens you should see your new permission listed.

If permission is there just make sure those roles are assigned to desired user groups and that is it. (By default, "reader" role is assigned to "*" group, so by adding the permission to "reader" role, all uses on the wiki will receive this permission)

Error:

not all Avatars are displayed

Solution:

This caused by late loading of NSFileRepoConnector that sets the $wgUploadPath. Define it in LocalSettings, before loading Avatars, then it works.

'Error: "I am not able to create a new namespace on our BlueSpice docu starter site (v.2.23) using Namespace Manager. We have two BlueSpice installations: one runs docu starter (2.23) and the other site runs BlueSpice free (2.22). On the BlueSpice docu starter site, I clicked on Admin > Namespace manager > Add. Entered Test as the namespace name with no options checked and clicked the button to add it. I did not receive a message stating that the namespace was created and Test didn't appear in the namespace list (even after refreshing). The same steps were successful in creating a Test namespace in our BlueSpice free site (v 2.22).

Solution: The error_log shows problems with writing to the file needed. Please verify the permissions for the config folder found in BlueSpiceFoundation, e.g. execute chmod a+w /var/www/mediawiki/extensions/BlueSpiceFoundation/config For the correct permissions for the folders needed by the apache refer to the installation manual.

Error: I have an intallation of BlueSpice docu starter (v. 2.23) with bookmaker extension I installed. can create a book with articles and subarticles in the book manager. However, the navigation for the book does not appear in the Book navigation on the left navigation area. The books are listed. Clicking on a book title displays the first page in the book. No book navigation appears. Only the title of the book as a clickable link that takes you to the first article in the page."

Solution: "The Bookmaker adds tags to the pages included in the book. You may have a look at the pages included in the book, to reset the tag and insert it in the correct way you could try to save the book again. To do so go to the BookManager (via Special:Specialpages -> BlueSpice -> Book Manager), select the book needed and click on the small arrow next to the save button on the right bottom of the Book Editor. Here select “Save and add book navigation to each article” this time. Afterwards you may revalidate if the problem persists. A restart of the apache is not mandatory but may solve the problem here as well."

Error:

Upload of pictures stays in "waiting" screen forever Before uploading, in "Details", existing Categories are not shown like in BS 2.23.3 When cancelling "insert image", picture is available in File Upload Nothing is logged in database logs, php.log, httpd error.log or messages log.

Solution: It looks like this is a bug. A required dependency is not being loaded properly. As a work around you can add the following statement to your MediaWiki:Common.js page:

 /* Bugfix for https://sourceforge.net/p/bluespice/bugs/373/ */
mw.loader.using( 'mediawiki.*' ); 

Error: I managed to mess up permissions. Now nobody can't view Permission Manager to change things back. What should I do?

Solution: You can edit the permissions file manually. You will need to connect to the server using a terminal (ssh) or FTP. Edit: /extensions/BlueSpiceFoundation/config/pm-settings.php You can also replace it with: /extensions/BlueSpiceFoundation/config.template/pm-settings.php if you want to reset everything.

Error: "Is there an up-to-date documentation available for the new Permission Manager. It seems to be intuitive, however I can't get it work? I add a new group via the Group Manager, e.g. qeditor. the new group is written to gm-settings.php - fine. Within the Permission Manager I assign new rights to this group, save - it says permissions saved - fine, however permissions for the new group are not reflected in pm-settings.php. Consequently when reloading the permission manager all settings for the new group are gone?"

Solution: This problem has been fixed in BlueSpice 2.23.1

How it works The first step to set permissions is to set them in the first folder for the whole wiki (*). The permissions you set for a group, will be set automatically for the following folders, for the wiki and all namespaces (green coloured - not checked). If you want to give the groups more/different permissions - maybe in different namespaces - you can select them manually, but if you do that, the other groups, in the same hierarchy level, lose that permission for the namespace you choosen.

'Error: "I am not able to create a new namespace on our BlueSpice docu starter site (v.2.23) using Namespace Manager. We have two BlueSpice installations: one runs docu starter (2.23) and the other site runs BlueSpice free (2.22). On the BlueSpice docu starter site, I clicked on Admin > Namespace manager > Add. Entered Test as the namespace name with no options checked and clicked the button to add it. I did not receive a message stating that the namespace was created and Test didn't appear in the namespace list (even after refreshing). The same steps were successful in creating a Test namespace in our BlueSpice free site (v 2.22).

Solution: The error_log shows problems with writing to the file needed. Please verify the permissions for the config folder found in BlueSpiceFoundation, e.g. execute chmod a+w /var/www/mediawiki/extensions/BlueSpiceFoundation/config For the correct permissions for the folders needed by the apache refer to the installation manual.

Error: I would like to modify the wiki background and replace the background image. As the admin, I opened the active skin, highlighted it and the skin preview appeared. I uploaded a new background image and saved. The first time I did it, a message appeared to save a file called "api.json". It saved in my downloads folder. I'm not sure what this is and where I should put it. Could you please tell me how to modify the background-image for my "NewSkin" so that it pulls the new graphic?

Solution: The problem is browser related, it didn't work with the Internet Explorer,but it works with another broweser like Firefox.

Error: Bluespice 2.23.3 MW 1.23.15 LTS I have been trying to create page templates, and I can, but the templates that are presented during page creation, are red letter templates, and the template is empty at the page creation stage. I think what may be the problem is I am unable to choose "Template namespace" during template creation as shown at https://wiki.bluespice.com/index.php/PageTemplates Here is what I see during template creation at the attached file. As you can see the "Template namespace" dialogue is missing. Any help is greatly appreciated.

Solution: This is a known bug in 2.23.3 [1]. You will need to update BlueSpiceExtensions to latest REL1_23 branch state (not released as tarball yet). You can find the download here: https://extdist.wmflabs.org/dist/extensions/BlueSpiceExtensions-REL1_23-d78d922.tar.gz You will have to recreate the page templates as the error already got written to the DB. Alternatively you can try to fix the DB entries in bs_pagetemplate.pt_template_title (Remove namespace prefix). [1] https://gerrit.wikimedia.org/r/#/c/295888/

Error: I have an intallation of BlueSpice docu starter (v. 2.23) with bookmaker extension installed. I can create a book with articles and subarticles in the book manager. However, the navigation for the book does not appear in the Book navigation on the left navigation area. The books are listed. Clicking on a book title displays the first page in the book. No book navigation appears. Only the title of the book as a clickable link that takes you to the first article in the page.

Solution: The Bookmaker adds tags to the pages included in the book. You may have a look at the pages included in the book, to reset the tag and insert it in the correct way you could try to save the book again. To do so go to the BookManager (via Special:Specialpages -> BlueSpice -> Book Manager), select the book needed and click on the small arrow next to the save button on the right bottom of the Book Editor. Here select “Save and add book navigation to each article” this time. A restart of the apache is not mandatory but may solve the problem here as well.

Error: When updating a page within a Namespace I can force a review using Responsible Editor, but how do I force a workflow to be started?

Solution: "That's no standard feature and must be ordered."

Error: "Currently the option to add a moderator to a page is only available in the Main Namespace. We would also like to be able to add moderators to pages in the namespaces."

Solution: "to add responsible feature on another namespace please do the following steps: index.php?title=Spezial:Wiki_Admin&mode=Preferences -> Responsible editors -> In List "Enabled namespaces" select all entries as needed, save to apply."

Error: not all Avatars are displayed

Solution: This caused by late loading of NSFileRepoConnector that sets the $wgUploadPath.

Define it in LocalSettings, before loading Avatars, then it works.

Error:

Upload of pictures stays in "waiting" screen forever Before uploading, in "Details", existing Categories are not shown like in BS 2.23.3 When cancelling "insert image", picture is available in File Upload Nothing is logged in database logs, php.log, httpd error.log or messages log.

Soluton: It looks like this is a bug. A required dependency is not being loaded properly. As a work around you can add the following statement to your MediaWiki:Common.js page:

 /* Bugfix for https://sourceforge.net/p/bluespice/bugs/373/ */
mw.loader.using( 'mediawiki.*' );