Extension/SimpleBlogPage: Difference between revisions

Latest revision as of 10:09, 9 September 2026

done
Blog functionality allows users to publish and share posts in the wiki. BlueSpice provides a built-in blog named "General" and supports additional blogs and personal user blogs.

Accessing blogs

The built-in blog "General" is available on the special page Special:ArticlesHome, which lists all blog posts.
Administrators can show or hide the Blogs link in the main navigation via Entrypoints in the Configuration manager.

Special page ArticlesHome with two blog posts with text and photo each.

All blog posts on the special page "ArticlesHome"

Entrypoints links with the Blogs link visible

Navigation menu "Entrypoints"

Creating a blog

A blog is a page in the Blog namespace. Blog posts are created as subpages of the blog page.
For example, the "Marketing" blog is created as:

Blog:Marketing

A page named "Marketing" in the namespace "Blog"

Marketing blog

Creating a blog post

Users with edit permissions in the Blog namespace can create blog posts.
Blog posts can be created from several entry points:

Select Create new blog post on the All blog posts page.
Select the + icon next to the blog page entry point and fill in the New blog post dialog.
Select New blog post from the New content button in the header.

For example, the post "Employee referral program" in the "General" blog has the page name:

Blog:General/Employee_referral_program

Blog post elements

A blog post includes:

A post heading that links to the wiki page for the post.
A Watch icon to add the post to or remove it from the user's watchlist.
The username and date of the last edit.
The post content, displayed below the heading and metadata.

Blog posts are automatically sorted by their last edit date. The sort order cannot be changed on the blog page.

User blogs

Users can create and manage a personal blog. The personal blog is accessed through Blog in the user menu.

User menu with highlighted link "Blog"

"Blog" link

User blogs are global. The same personal blog is available across the wikis in the BlueSpice Galaxy and is not specific to an individual wiki.
User blog posts are created as subpages of the user's name in the User_blog namespace. For example:

 User_blog:WikiSysop/New_helpdesk_has_been_published

User blog posts are marked with the User blog tag so that they can be identified as personal blog posts.

User blog post on the page "All blog posts"

User blog post

Users can edit only their own user blog pages. Moving a blog page to another user's blog is restricted.

@@ Line 1: / Line 1: @@
+<status color="green" light="true">done</status><br>
 {{DISPLAYTITLE:Blog}}
+Blog functionality allows users to publish and share posts in the wiki. BlueSpice provides a built-in blog named "General" and supports additional blogs and personal user blogs.
-In BlueSpice 4, the extensions bundle [[en4:Reference:BlueSpiceSocial|BlueSpiceSocial]] provided functionality such as blogs, discussions, and user profile info. In BlueSpice 5, these extensions are replaced by <code>SimpleBlogPage</code>, which introduces a blogging system that starts out with a built-in special page  for creating blog posts.
+== Accessing blogs ==
+The built-in blog "General" is available on the special page <code>Special:ArticlesHome</code>, which lists all blog posts. <br>
-[[File:blog special page.png|alt=Special page ArticlesHome with two blog posts with text and photo each.|center|thumb|500x500px|All blog posts on the special page "ArticlesHome"]]
+Administrators can show or hide the '''Blogs''' link in the main navigation via '''Entrypoints''' in the [[ConfigManager|Configuration manager]].
+[[File:simpleblogpage-all-blog-posts.png|alt=Special page ArticlesHome with two blog posts with text and photo each.|center|thumb|500x500px|All blog posts on the special page "ArticlesHome"]]
-== Accessing the blogs ==
+[[File:simpleblogpage-blogs-entrypoint.png|alt=Entrypoints links with the Blogs link visible|center|thumb|184x184px|Navigation menu "Entrypoints"]]
-The wiki provides a built-in blog named "General". Its blog posts are listed on the special page ''Special:ArticlesHome.''
+== Creating a blog ==
+A blog is a page in the <code>Blog</code> namespace. Blog posts are created as subpages of the blog page. <br>
-=== Entrypoint ===
+For example, the "Marketing" blog is created as:
-Administrators can show or hide a link to this page in the main navigation Entrypoints.
+<syntaxhighlight lang="text">
-[[File:blog entrypoint.png|alt=entrypoints links with the Blogs link visible|center|thumb|184x184px|Navigation menu "Entrypoints"]]
+Blog:Marketing
+</syntaxhighlight>
-==== New blog entry ====
+[[File:simpleblogpage-marketing-blog.png|alt=A page named "Marketing" in the namespace "Blog"|center|thumb|550x550px|Marketing blog]]
-Users with edit-permissions in the namespace <code>Blog</code> can create a new blog entry.  Each blog entry is a standard wiki page.
+== Creating a blog post ==
+Users with edit permissions in the <code>Blog</code> namespace can create blog posts.<br>
-'''To create a blog entry users can:'''
+Blog posts can be created from several entry points:
+# Select '''Create new blog post''' on the '''All blog posts''' page.
-* '''Click''' ''Create new blog post'' on the page ''All blog posts''.
+# Select the '''+''' icon next to the blog page entry point and fill in the '''New blog post''' dialog.
-* '''Click''' the wiki's (<code>+ plus</code>)-button and select ''New blog post''.
+# Select '''New blog post''' from the '''New content''' button in the header. <br>
+For example, the post "Employee referral program" in the "General" blog has the page name:
-All blog posts are created in the namespace ''Blog''. The name of the blog is the parent page and the blog post itself is a subpage of the parent page. The blog page for ''Employee referral program'' in the blog ''General'' is therefore created as:<syntaxhighlight lang="text">
+<syntaxhighlight lang="text">
 Blog:General/Employee_referral_program
-</syntaxhighlight>To create a separate blog, simply create the necessary page in the namespace blog:<syntaxhighlight lang="text">
+</syntaxhighlight>
-Blog:Marketing
-</syntaxhighlight>When a user creates a new blog post for the blog "Marketing", the blog post page is created as a subpage of the page "Marketing" in the namespace blog.[[File:blog marketing.png|alt=A page named "Marketing" in the namespace "Blog"|center|thumb|550x550px|Marketing blog]]
 == Blog post elements ==
-Each blog post has the following elements:
+A blog post includes:
 * A post heading that links to the wiki page for the post.
-* A star-toggle button to put the post on one own's watchlist.
+* A '''Watch''' {{Icon|bi bi-bs-watch|||}} icon to add the post to or remove it from the user's watchlist.
 * The username and date of the last edit.
-* The content of the post.
+* The post content, displayed below the heading and metadata. <br>
-{{Textbox|boxtype=note|header=Sorting of blog posts|text=Blog posts are automatically shown by last edit date. It is not possible to change the sort order on a blog page. You can, however, create an [[#Displaying blog titles on other pages|inline query of blog post titles on any other page]] and determine the sort order there.|icon=yes}}
+Blog posts are automatically sorted by their last edit date. The sort order cannot be changed on the blog page.
 == User blogs ==
-Users can create their own blog posts. To create and edit their personal blog, users select the link ''My blog'' from their user menu.
+Users can create and manage a personal blog. The personal blog is accessed through '''Blog''' in the user menu.
-[[File:user blog menu link.png|alt=user menu with highlighted link "My blog"|center|thumb|650x650px|"My blog" link]]
+[[File:simpleblogpage-user-blog-menu.png|alt=User menu with highlighted link "Blog"|center|thumb|650x650px|"Blog" link]]
+User blogs are global. The same personal blog is available across the wikis in the BlueSpice Galaxy and is not specific to an individual wiki. <br>
+User blog posts are created as subpages of the user's name in the <code>User_blog</code> namespace. For example:
-User blog pages are created in the User_blog namespace as subpages of the user name:<syntaxhighlight lang="text">
+<syntaxhighlight lang="text"> User_blog:WikiSysop/New_helpdesk_has_been_published </syntaxhighlight>
-User_blog:WikiSysop/New_helpdesk_has_been_published
+User blog posts are marked with the '''User blog''' tag so that they can be identified as personal blog posts.
-</syntaxhighlight>User blog posts are marked with the specific tag ''User blog'' so that they are easily recognized.
+[[File:simpleblogpage-user-blog-post.png|alt=User blog post on the page "All blog posts"|center|thumb|650x650px|User blog post]]
-[[File:user blog entry example.png|alt=user blog post on the page "All blog posts"|center|thumb|650x650px|User blog post]]
+Users can edit only their own user blog pages. Moving a blog page to another user's blog is restricted.
-{{Textbox|boxtype=note|header=Note:|text=Users can only edit their own user blog pages. Trying to move a blog page to a different user's blog results in an error.|icon=yes}}
-== Displaying blog titles on other pages ==
-You can list
-The following inline query results in a list of the latest 5 blog entries of the blog "Marketing". It prints  the creation date of the article and sorts by creation date descending. <syntaxhighlight lang="text">
-== Latest news ==
-{{#ask:[[Blog:+]] [[~*Marketing/*]][[Modification date::+]]
-|?Creation date#-F[d.m.Y]
-|headers=hide
-|format=ul
-|limit=5
-|searchlabel=
-|sort=Creation date
-|order=desc
-|template=SMW Subpagename
-|link=none
-}}
-</syntaxhighlight>Since all blog posts are subpages of the main page Marketing, the query uses the template SMW Subpagename to format the title to only show the blog page (Grand opening) title instead of the entire page name (Marketing/Grand opening). The page Template:SMW Subpagename contains the following content:<syntaxhighlight lang="text">
-[[{{{1}}}|{{SUBPAGENAME:{{{1}}} }}]] ({{{2}}})
-</syntaxhighlight>
-[[File:Simpleblog inline query.png|alt=List of blog posts with heading named "Latest news" and two related posts|center|thumb|400x400px|list of blog posts of a specific blog]]
-{{translation}}