Archive:Manual:Extension/BlueSpiceSocial: Difference between revisions

Back to version history
Browse history interactively
← Older editNewer edit →
VisualWikitext
Redaktion (talk | contribs)
ES_editors, Administrators
8,180 edits
No edit summary
Tags: Reverted Visual edit
Redaktion (talk | contribs)
ES_editors, Administrators
8,180 edits
No edit summary
Tags: Manual revert Visual edit
Line 1: Line 1:
BlueSpice goes beyond traditional documentation by integrating dynamic social features that foster interaction, personalization, and engagement with the wiki.
<bookshelf src="Book:User manual" />
{{DISPLAYTITLE:Introduction to BlueSpice Social}}


Tools like '''user mentions''', '''blogs''', '''user profiles''', and '''page comments''' transform the wiki into a more personalized collaborative space.  
'''BlueSpiceSocial''' is a set of extensions that add  social features around a wiki page. It allows users to quickly communicate on the wiki and to express their opinion on pages.
==Scope==
BlueSpice Social contains the following functionality:
*'''User profile:''' Provides the page ''User:<username>.''
*'''Attachments:''' Connects uploaded files to wiki pages.
*'''Discussions:''' Enables discussions with comments created on wiki pages. Discussion entries can be marked as "closed".
*'''Activities:''' Automatically creates pages in the ''SocialEntity'' namespace to track page edits and creations.
*'''Blog:''' Provides the special page ''Special:Blog''. A blog view can also be embedded into individual wiki pages.
*'''Microblog:''' Similar to blog entries, but without a headline.
*'''Timeline:''' A chronological list of all social entities. The timeline filter can be used for displaying social entities on wiki pages.
<section end="training-slides" /><section end="training-maintainer" />


==User mentions==
==User profile==
You can mention another user by simply typing the <code>@</code>-Symbol and then selecting a username. This generates a link to the user's profile page and the user receives a notification with a link to this page from the wiki.
Every user has a profile that is displayed on the page ''User:<username>''. Users can access their user profile by clicking on ''Profile'' in the user menu (located in the [[Manual:Extension/BlueSpiceDiscovery|header bar]]).


{{ButtonLink|external=no|target=Manual:Extension/AtMentions|label=More about user mentions|format=blue}}
The  user profile shows the user's basic information (depending on the wiki setup) and the user's profile image.
==Blogs==
Below the user info, the user's 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.[[File:Profile1a-en.png|thumb|User profile|alt=User profile|center|650x650px]]
With this blog functionality, users find  a space to share opinions, insights, and experiences that go beyond factual documentation. This fosters a culture of expertise and personal voice within the organization.
==Discussions==
BlueSpiceSocial integrates a discussion section at the bottom of every wiki page. This section allows users to create comments directly on a wiki page. If it is the first entry in a discussion, the discussion page is automatically created at this time if this is configured in the [[Manual:Extension/BlueSpiceConfigManager|Configuration manager]].


The discussion section can be disabled on the page-level by adding the [[Manual:MagicWords|MagicWord]] ''<nowiki></nowiki>'' to the page in source editing mode.


The wiki includes two namespaces — <code>Blog</code> and <code>User_blog</code> — that are reserved for wiki pages of type <code>blog-page</code>.  
==Timeline==
[[File:Timeline1a-en.png|thumb|alt=Timeline|center|650x650px|Timeline]]
Timeline is a special page that provides an overview of all social conversations on the wiki.  


​{{ButtonLink|external=no|target=Manual:Extension/AtMentions|label=More about blogs|format=blue}}
By default, it is listed on the ''Main navigation''. You can also access the page directly at <code>Special:Timeline</code>.
On this page, users can sort and filter existing social entries or create new entries.


== Page comments ==
===Creating new entries===
Page  Comments allow users to ask questions, suggest improvements, or clarify points directly on the page, keeping discussions contextual and focused. Instead of waiting for formal reviews or edits, contributors can quickly respond to feedback, making the content more agile and responsive.
To create a new entry, click on the "Plus" icon to add a new timeline entry:


Sometimes the most valuable insights come from informal remarks. Comments can surface practical tips, alternative perspectives, or real-world applications that enrich the main content. Instead of long email threads or separate chat discussions, comments centralize communication right where it’s needed—on the content itself.
*'''Blog entry''': [[#Blog|Blog]] is used for topics to be shared with other users on the wiki
*'''Microblog''': Like a blog entry, but without titles. It should be used for a short entry, e.g., a quick announcement.
*'''Discussion topic''': Adds a discussion entry to a particular wiki page.


===Interacting with social entities===
Every entry in the timeline is called a social entity. Depending on the type of social entity, the following interaction options exist:


{{ButtonLink|external=no|target=Manual:Extension/CommentStreams|label=More about page comments|format=blue}}
*'''Comments:''' Number of comments related to the entity. Clicking on ''Comments'' opens all current comments and allows users to add a comment (if user has the necessary permissions).
*'''Recommend:''' Number of users that recommended the entity. Uers can add a recommendation by clicking on ''Recommend''.
*'''Linked articles:''' Number of articles linked to this entity Clicking on ''Linked articles'' shows the list of linked articles.
*'''Watch/Unwatched:''' Shows if the user is currently watching the entity (the receives notifications when the entity is changed). Clicking on Watch or Unwatch changes the state of watching.
*'''Resolved/Unresolved''': 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.
==Blog==
[[Manual:Extension/Blog|Blog]] is a special page showing an overview of all blog entities available on the wiki. By default, it is listed on the ''Main navigation.'' You can also access the page directly at  <code>Special:Blog</code>.
Users can sort and filter the list entries by clicking on the icons above the list.


==User profiles==
Learn how to [[Manual:Extension/BlueSpiceSocialBlog|include the blog on any wiki page]].
Each user who has logged into the wiki has a profile page. Everywhere the user name is shown in the wiki, it links to the related profile page. Seeing who contributed to a page adds a personal touch and reminds users that real people with expertise and intentions are behind the information.


Profiles can showcase a user’s role, skills, interests, and contributions—making it easier to find subject-matter experts or collaborators across the organization. Highlighting contributions on profile pages can help recognize efforts, boosting morale and reinforcing a culture of shared knowledge.
==Permissions==
 
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.''
 
<br />
{{ButtonLink|external=no|target=Manual:Extension/UserProfile|label=More about user profiles|format=blue}}
{| class="contenttable-blue" style=""
!Rechte/Rolle
!commenter
!editor
!admin
!maintenance-<br />
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.


==<span class="mw-headline" id="Deaktivieren_der_Kommentarfunktion" style="box-sizing: inherit;">Deactivating the comments feature</span>==
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
];
<br />{{Box Links-en
|Topic1=[[Manual:Extension/BlueSpiceSocialBlog|Blog]]
|Topic4=[[Reference:BlueSpiceSocial]]
|Topic5=
|Topic2=[[Manual:Extension/BlueSpiceSocialWikiPage|Discussions and Attachments]]
|Topic6=
}}
{{translation}}
{{translation}}
[[Category:Social]]
[[Category:Social]]

Revision as of 10:04, 13 August 2025

Archived! This documentation is obsolete and no longer applies to the current BlueSpice version.


BlueSpiceSocial is a set of extensions that add social features around a wiki page. It allows users to quickly communicate on the wiki and to express their opinion on pages.

Scope

BlueSpice Social contains the following functionality:

  • User profile: Provides the page User:<username>.
  • Attachments: Connects uploaded files to wiki pages.
  • Discussions: Enables discussions with comments created on wiki pages. Discussion entries can be marked as "closed".
  • Activities: Automatically creates pages in the SocialEntity namespace to track page edits and creations.
  • Blog: Provides the special page Special:Blog. A blog view can also be embedded into individual wiki pages.
  • Microblog: Similar to blog entries, but without a headline.
  • Timeline: A chronological list of all social entities. The timeline filter can be used for displaying social entities on wiki pages.

User profile

Every user has a profile that is displayed on the page User:<username>. Users can access their user profile by clicking on Profile in the user menu (located in the header bar).

The user profile shows the user's basic information (depending on the wiki setup) and the user's profile image.

Below the user info, the user's 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.

User profile
User profile

Discussions

BlueSpiceSocial integrates a discussion section at the bottom of every wiki page. This section allows users to create comments directly on a wiki page. If it is the first entry in a discussion, the discussion page is automatically created at this time if this is configured in the Configuration manager.

The discussion section can be disabled on the page-level by adding the MagicWord to the page in source editing mode.

Timeline

Timeline
Timeline

Timeline is a special page that provides an overview of all social conversations on the wiki.

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

Creating new entries

To create a new entry, click on the "Plus" icon to add a new timeline entry:

  • Blog entry: Blog is used for topics to be shared with other users on the wiki
  • Microblog: Like a blog entry, but without titles. It should be used for a short entry, e.g., a quick announcement.
  • Discussion topic: Adds a discussion entry to a particular wiki page.

Interacting with social entities

Every entry in the timeline is called a social entity. Depending on the type of social entity, the following interaction options exist:

  • Comments: Number of comments related to the entity. Clicking on Comments opens all current comments and allows users to add a comment (if user has the necessary permissions).
  • Recommend: Number of users that recommended the entity. Uers can add a recommendation by clicking on Recommend.
  • Linked articles: Number of articles linked to this entity Clicking on Linked articles shows the list of linked articles.
  • Watch/Unwatched: Shows if the user is currently watching the entity (the receives notifications when the entity is changed). Clicking on Watch or Unwatch changes the state of watching.
  • Resolved/Unresolved: 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.

Blog

Blog is a special page showing an overview of all blog entities available on the wiki. By default, it is listed on the Main navigation. You can also access the page directly at Special:Blog. 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.

Permissions

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

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


Retrieved from "https://en.wiki.bluespice.com/w/index.php?title=Archive:Manual:Extension/BlueSpiceSocial&oldid=12809"