BlueSpiceSocialBlog

About the blog feature

Basically, a blog is a list of comments, questions, or feedback from different users. The blog is often sorted chronologically downwards, in the sense of a public journal. A lively communication can arise when the contributions are further commented, recommended, linked with related articles or placed on a personal watchlist.

The extension BlueSpiceSocialBlog is part of BlueSpiceSocial, the communication module of BlueSpice. In addition to the type blog, there are other types of so-called social entities, such as comment, discussion, attachment, or microblog. Contributions from all these types can be consolidated and displayed chronologically with BlueSpiceSocial in a timeline and filtered and sorted as needed. The blog function is ready for use on the special page Special:Blog. This page is linked directly from the main navigation in every new wiki installation. So you can start right away with using the blog. It is also possible to include the blog functionality on any wiki page.

Adding the blog to a page

If you want to include a view of your blog on another page of your wiki, for example your homepage, you need to insert the necessary codeblock in the source code of your page.

To include a blog view:

1. Go to the page where you want to insert the blog or create a new page.
2. Open the page in Source editing mode.
   
3. Copy the following code block to the section in your page where you want to show the blog.

   <bs:timeline>
    {
        "showentitylistmenu": true,
        "preloadtitles": {
            "blog": "Vorlage:Blog"
        },
        "preloadedentities": [{
            "type": "blog"
        }],
        "headlinemessagekey": "Community-Blog",
         "showheadline": true,
        "usemorescroll": false,
        "morelink": "Special:Blog",
        "limit": 5,
        "sort": [ {
            "property": "timestampcreated",
            "direction": "DESC"
        }],
        "lockedfilternames": [
            "type"
        ],
        "filter": [ {
            "type": "list",
            "property": "type",
            "value": [ "blog" ],
            "comparison": "ct"
        }]
    }
   </bs:timeline>
   

   After saving the page, you will see a list of existing blog entries based on the filter and sorting criteria you provided.

Defining the output

Element	Parameters	Description	Type	Default value
1 - header	headlinemessagekey	header text	str	Timeline
	showheadline	show the header text	boolean	false
2 - blog menu	showentitylistmenu	show or hide the menu with filter and other options	boolean	true
3 - create blog entry	showentityspawner	show the menu option for creating a new blog entry	boolean	true
4 - existing blog entry	outputtypes	defines the format of the blog entry. Possible values: List, Short, Default, Page	str	Default
	limit	defines how many blog entries are initially shown	str	40
4a - avatar	-	the user avatar is shown in all output types except List	-	-
4b - title bar	-	for blogs, the title bar is always shown. In the output type List, the user name is not included.	-	-
4c - blog entry content	-	for blogs, the blog entry is shown in all output types except List. The type Default collapses the content after the initial lines.	-	-
4d - social tags	-	social tags are always shown. For blog entries, the following social tags are always included: Comments, Recommend, Linked Page, Watch/Unwatch. Blog comments include the social tag Recommend.	-	-
4e - user menu	-	the user menu (three vertical dots) are shown for blog posts of the logged-in user. Users can edit or delete their own blog entries at any time.	-	-
5 - new comment	-	text field for creating a new comment	-	-
6 - existing comment	-		-	-
7 - "more" link	morelink	The more link (...) at the bottom of the blog. It is only used if the parameter usemorescroll / useendlessscroll (?) is set to false	str	Special:Timeline
	useendlessscroll	more blog entries are automatically loaded when the user scrolls to the end of the blog.	boolean	true