|
|
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]]
| |