Difference between revisions of "Manual:Extension/BlueSpiceSocial"

<bs:bookshelf src="Book:User manual" />
            
            
            
            __TOC__
            
            
            
            ==What is BlueSpiceSocial?==
            
            '''BlueSpiceSocial''' is a package consisting of a set of extensions, that add social media features to the wiki{{DISPLAYTITLE:About social content}}
            
            __TOC__
            
            
            
            '''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 more clearly and easily accessible.
            
            
            
            ==Parts of BlueSpiceSocial==
            
            BlueSpiceSocial integrates to many aspects of the wiki.
            
            
            
            ===User profile===.
            
            ==User profile==
        
        [[File:Profile1a.png|thumb|User profile]]
        
        Every user has a profile on the wiki, provided by BlueSpiceSocial. It is located on each user's user . It is displayed on the user page (<code>User:Username</code>), available from the user's personal menu (by clicking on user image in top right corner), by selecting the "My profile" item. This page displays a modern overview of . Users can access their user profiles by clicking on ''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.
        
        {{Clear}}
        
        
        
            
            ====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==
        
        [[File:Timeline1a.png|thumb]]
        
        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 <code>Special:Timeline</code>.
        
        
        Once on the On this page, users can sort and filter the items displayed based on various critiria or create new Timeline entries.
            
            {{Clear}}
            
            
            
            ====Creating new entries====existing social entries or create new entries.
            
            {{Clear}}
            
            ===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 create:
            
            
            
            *Blog entry - to add a new timeline entry:
            
            
            
            *'''Blog entry''': [[#Blog|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.
            
            *Discussion topic - raises a discussion point related to a certain page.
            
            
            
            ====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 (and anywhere else on the wiki) is called a social entity. Depending on the type of thesocial entity, following options are available in the bottom part of the entity:
            
            
            
            *Comment - shows the number the following 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.
            
            *Linked articles - shows the number ''Recommend''.
            
            *'''Linked articles:''' Number of articles linked to this entity and Clicking on ''Linked articles'' shows the list of linked articles when clicked.
            
            *Watch/Unwatch - shows .
            
            *'''Watch/Unwatched:''' Shows if the user is currently watching the entity (user will receive the receives notifications when the entity is changed); clicking. Clicking on this button will changeWatch 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.
        
        {| class="wikitable"
        
        |+
        
        ![[File:Timeline2a.png|thumb|Adding new entries]]
        
        ![[File:Timeline3.png|thumb|Adding new entries]]
        
        ![[File:Timeline4.png|thumb|Commenting on an entity]]
        
        |}
        
        {{Clear}}
        
        
        
            
            =====Blog===
        
        [[File:Blog1a.png|thumb]]
        
        
        Blog[[Manual:Extension/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  <code>Special:Blog</code>.
        
        
        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.
        
        
        {{Clear}}
            
            
            
            ===Page attachments===
            
            Learn how to [[Manual:Extension/BlueSpiceSocialBlog|include the blog on any wiki page]].
            
            {{Clear}}
            
            
            
            ==Page attachments==
        
        [[File:PageComments1.png|thumb|Page attachments and discussions]]
        
        [[File:PageCommentsAttachments.png|thumb|Management of page attachments]]
        
        
        UnderFor 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 <code>''Special:Attachments/Page_name</code>'', 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 attachementsattachments for the page.
        
        
        {{Clear}}
            
            
            
            ===Page discussions===
            
            Same as for the 
            
            Page attachments can be disabled in the Page by adding the [[Manual:MagicWords|MagicWord]] ''<nowiki>__NOSTASH__</nowiki>'' to the page in source editing mode.
            
            
            
            {{Clear}}
            
            ==Page discussions==
            
            Like page attachments, BlueSpiceSocial integrates a discussion section on every content page on the wiki. This section offers users to comment on the page content. Users with appropriate permissions will be able to create new topics or comment on existing ones.
            
            {{Clear}}
            
            
            
            ==See also==
            
            Reference pages for each extension is this package:
            
            
            
            [[Reference:Social|Social]]
            
            
            
            [[Reference:SocialMicroBlog|SocialMicroBlog]]
            
            
            
            [[Reference:SocialTimelineUpdate|SocialTimelineUpdate]]
            
            
            
            [[Reference:SocialComments|SocialComments]]
            
            
            
            [[Reference:SocialRating|SocialRating]]
            
            
            
            [[Reference:SocialWikiPage|SocialWikiPage]]
            
            
            
            [[Reference:SocialGroups|SocialGroups]]
            
            
            
            [[Reference:SocialResolve|SocialResolve]]
            
            
            
            [[Reference:SocialArticleActions|SocialArticleActions]]
            
            
            
            [[Reference:SocialBlog|SocialBlog]]
            
            
            
            {{Translation}}at the bottom of every wiki page. This section allows users to 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 [[Manual:MagicWords|MagicWord]] ''<nowiki>__NODISCUSSION__</nowiki>'' 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.''
            
            
            <br />
            
            {| class="contenttable-blue"
            
            !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=[[Manual:Extension/BlueSpiceSocialComments|Social comments]]
            
            |Topic5=[[Manual:Extension/BlueSpiceSocialProfile|User Profile]]
            
            |Topic2=[[Manual:Extension/BlueSpiceSocialWikiPage|Discussions and Attachments]]
            
            |Topic6=[[Reference:BlueSpiceSocial]]
            
            }}
            
            
            
            
            
            [[en:{{FULLPAGENAME}}]]
            
            [[de:Handbuch:Erweiterung/BlueSpiceSocial]]
            
            [[Category:Social]]