|
|
|
| Line 1: |
Line 1: |
|
<bookshelf src="Book:User manual" />
|
|
{{BSExtensionInfobox |
|
{{DISPLAYTITLE:Introduction to BlueSpice Social}} |
|
|desc=Syntax-highlighted editing for JavaScript and CSS pages using Ace editor |
|
|
|status=stable |
|
|
|developer=Brion Vibber, Derk-Jan Hartmann, and others |
|
|
|type=MediaWiki |
|
|
|edition=BlueSpice free, BlueSpice pro, BlueSpice Farm, BlueSpice Cloud |
|
|
|active=Yes |
|
|
|compatible=MediaWiki
|
|
|
|category=Editor |
|
|
|license=GPL v2+ and BSD 3 Clause |
|
|
|docu=https://www.mediawiki.org/wiki/Extension:CodeEditor
|
|
|
}}The '''CodeEditor''' extension extends the WikiEditor advanced editing toolbar with an embedded Ace editor widget, providing some handy features for user/site JS, CSS pages, and — when Extension:Scribunto is also installed — for pages in the ''Module'' namespace:
|
|
|
|
|
|
'''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.
|
|
*syntax highlighting for JavaScript, CSS and Lua
|
|
==Scope==
|
|
*auto-indent |
|
BlueSpice Social contains the following functionality:
|
|
*tab key produces tab indents (since 1.22), soft indents before. |
|
*'''User profile:''' Provides the page ''User:<username>.''
|
|
*indent/unindent selection with tab/shift-tab
|
|
*'''Attachments:''' Connects uploaded files to wiki pages. |
|
*syntax validity check for JavaScript
|
|
*'''Discussions:''' Enables discussions with comments created on wiki pages. Discussion entries can be marked as "closed".
|
|
*Pair-matching for parenthesis, braces and square brackets
|
|
*'''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 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 [[Manual:Extension/BlueSpiceDiscovery|header bar]]).
|
|
|
|
|
|
|
The user profile shows the user's basic information (depending on the wiki setup) and the user's profile image.
|
|
While this extension is licensed GNU General Public License v2.0 or later (GPL-2.0+) it makes use of the Ace editor software which is licensed BSD 3-clause "New" or "Revised" License (BSD-3-Clause). |
|
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]]
|
|
|
==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>__NODISCUSSION__</nowiki>'' to the page in source editing mode.
|
|
|
|
|
|
==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.
|
|
|
|
|
|
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.
|
|
|
|
|
|
===Creating new entries===
|
|
|
To create a new entry, click on the "Plus" icon to add a new timeline entry:
|
|
|
|
|
|
*'''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:
|
|
|
|
|
|
*'''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.
|
|
|
|
|
|
Learn how to [[Manual:Extension/BlueSpiceSocialBlog|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.''
|
|
|
<br />
|
|
|
{| 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=
|
|
|
}}
|
|
|
|
|
|
|
|
|
[[en:{{FULLPAGENAME}}]]
|
|
|
[[de:Handbuch:Erweiterung/BlueSpiceSocial]]
|
|
|
[[Category:Social]]
|
|