Manual:Extension/BlueSpiceSocial

What is BlueSpiceSocial?

BlueSpiceSocial is a package consisting of a set of extensions , that add social media features to the around a wiki page. It allows users to quickly communicate on the wiki and to express their opinion on pages more clearly and easily accessible.

Parts of BlueSpiceSocial

BlueSpiceSocial integrates to many aspects of the wiki.

User profile

User profile

Every user has a profile on the wiki, provided by BlueSpiceSocial. It is located displayed on each the user 's user page (User:Username), available from the user's personal menu (. Users can access their user profiles by clicking on user image in top right corner), by selecting the "My profile" item. This page displays a modern overview of My profile in the user menu which is located in the header toolbar.

The user profile shows the user's basic information (depending on the wiki setup) and the user's profile image. Also, below Below the user info, a list of the user's activity is presented. This list shows comments wiki activities are listed: Comments the user made, actions on pages, and in general the user's activity on the wiki. It also allows other users to leave comments on the user's profile page.

Classic user page

MediaWiki's standart view of the user's profile page is still available and users can switch between BlueSpiceSocial view and classic view by clicking on the "arrows" icon in the page tools (at the top of the page).

Timeline

Timeline is a special page that provides an overview of all social conversations on the wiki. It is available from the left navigation, in the "Main navigation" tab or directly by navigating to

By default, it is listed on the Main navigation. You can also access the page directly at Special:Timeline. Once on the On this page, users can sort and filter the items displayed based on various critiria existing social entries or create new Timeline entries.

Creating new entries

To create a new entry, click on the "Plus" icon on the top of the page. A menu will open which offers different types of entries to createto add a new timeline entry:

• Blog entry - : Blog is used for topics to be shared with other users on the wiki
• Microblog - very similar to : Like a blog entry, but intended for short, concise announcments.without titles. It should be used for a short entry, e.g., a quick announcement.
• Discussion topic - raises : Adds a discussion point related entry to a certain particular wiki page.

Interacting with social entities

Every entry in the timeline (and anywhere else on the wiki) is called a social entity. Depending on the type of the social entity, the following options are available in the bottom part of the entity:

Comment - shows the number

interaction options exist:

• Comments: Number of comments related to the entity; clicking . Clicking on it Comments opens all current comments and allows users to add a comment (if user has appropriate the necessary permissions).
• Recommend - shows the number : Number of users that recommended the entity; users . Uers can add a recommendation by clicking on this button Recommend.
• Linked articles - shows the number : Number of articles linked to this entity and Clicking on Linked articles shows the list of linked articles when clicked.
• Watch/Unwatch - shows Unwatched: Shows if the user is currently watching the entity (user will receive the receives notifications when the entity is changed); clicking on this button will change . Clicking on Watch or Unwatch changes the state of watching.
• Resolved/Unresolved - shows the : The status of the entity. Some entities, like discussions on a question can have a status attached to them, so that other users know if the question is answered.

Editing and deleting entities

Users can edit and delete their own entities (created by them) by clicking on the "3 dots" icon in the top right corner of the entity.

Adding new entries	Adding new entries	Commenting on an entity

Blog

Blog is a special page showing an overview of all blog entities available on the wiki. It is availble from the left navigation, in the "Main navigation" section, or by navigating directly to By default, it is listed on the Main navigation. You can also access the page directly at Special:Blog. The list of blog entries can be sorted and filtered Users can sort and filter the list entries by clicking on the icons above the list.

Learn how to include the blog on any wiki page.

Page attachments

Page attachments and discussions

Management of page attachments

Under For every content page on the wiki, BlueSpiceSocial integrates an attachments section. This section shows the files that are related to the particular page. Users can add or remove files to and from this section by clicking on the "..." icon at the bottom of the section. Clicking on this icon will lead links to Special:Attachments/Page_name, which allows managing the files attached to a particular page.

Users can attach files that are already uploaded to the wiki by clicking on the "Plus" button and selecting a file. Or, or users can upload new files to be attached by dropping files into the marked area or by clicking the same area to select the files to upload.

This page also shows the history of file attachements attachments for the page.

Page attachments can be disabled in the Page by adding the MagicWord __NOSTASH__ to the page in source editing mode.

Page discussions

Same as for the Like page attachments, BlueSpiceSocial integrates a discussion section on every content page on the wikiat the bottom of every wiki page. This section offers allows users to comment on the page content. Users with appropriate permissions will be able to create new topics or comment on existing ones.

See also

create comments directly on a wiki page without having to switch to the discussions page. If it is the first entry in a discussion, the discussion page is automatically created at this time.

The discussion section can be disabled in the Page by adding the MagicWord __NODISCUSSION__ to the page in source editing mode.

Rights

From BlueSpice version 3.2.7 the following roles have associated "social" permissions. Earlier versions have no option to limit the creation and editing of blog entries by using the role commenter.

Rechte/Rolle	commenter	editor	admin	maintenance- admin	Berechtigung
Create and edit blog entry		x	x	x	social-blog
Comment on blog entry	x	x	x	x	social-blog-comment
Create and edit microblog entry	x	x	x	x	social-microblog
Comment on microblog entry	x	x	x	x	social-microblog-comment
Create discussion entry	x	x	x	x	social-topics
Comment on discussion entry	x	x	x	x	social-topics-comment
Create and edit attachments	x	x	x	x	soical-stash

The comments function for blog, microblog and discussion entries can be deactivated in the LocalSettings-file on the server.

Deactivating the comments feature

Reference pages for each extension is this package:

Reference:Social

Reference:SocialMicroBlog

Reference:SocialTimelineUpdate

Reference:SocialComments

Reference:SocialRating

Reference:SocialWikiPage

Reference:SocialGroups

Reference:SocialResolve

Reference:SocialArticleActions

Reference:SocialBlog

The comment function for comments on blog, microblog and discussion entries can be deactivated in the LocalSettings file on the server.

                $bsgSocialCanHaveChildrenBlacklist = [
	'blog', // disable comments on blog
	'topic', // diable comments on discussion topics
	'microblog' // disable comments on microblogs
];

            

Related info

• Blog
• Discussions and Attachments
• Social comments
• User Profile

• Reference:BlueSpiceSocial