Difference between revisions of "Manual:Extension/Blog"
| [unchecked revision] | [unchecked revision] |
(→Blog tags) |
Contents
What is Blog?[edit | edit source]
Blog extension allows creating news feeds on the wiki. These news feeds can be shown on any page, and users can be allowed to add their own news
Where can I find the blog function?[edit | edit source]
In the TopMenuBar, at the very top of any page there is a link to Blog special page, which then opens a page containing a form for writing a new blog entry and a list of previous entries.
Blog news feed can be displayed on any page by adding blog tag to the page
This will also display "Create new blog" form on the page, unless its disabled using blog tag attibutes
A blog entry consists of a title, revision information (date and author of first revision), the entry itself and possibly links for comments and a permalink.
If a blog entry is too long, link "continue reading" will be displayed
Write an entry or create a new entry[edit | edit source]
As described above, new blog entries can be created through the form on the page containing blog tag, on Blog special page (Special:Blog), or by directly creating new pages in Blog namespace.
Blog tags[edit | edit source]
Blog extension offers several tags. These tags can be added to a page using InsertMagic functionality, or writing tag syntax directly to wiki code editor.
| Wiki tag | Description |
|---|---|
| <blog <bs:blog /> Normal blog | Displays blog news feed on the page. It can be extended with multiple attributes. For more on attubutes read section "Blog tag attibutes" below. |
| <bs:blog:more /> | The "more" tag is used in the single entries limit the teaser to its position. A link "Continue reading" appears at this point in the blog which links to the This tag should be placed inside the content of a blog entry (pages in Blog namespace) to define at which point in text "continue reading" link should be placed. This will override default cut-off length of an entry. |
| <bs:blog:time time="201503161200YYYYMMDDHHmm" /> |
Set the time stamp This tag also should be placed inside the content of a blog post to a defined date. e.g. the 16.03.2015 at 12:00 o'clock you should insert <bs:blog:time time="201503161200" />entry. It allows manually defining timestamp for that particular blog entry. Timestamp is used in sorting and displaying blog entries. |
Creating a second blog[edit | edit source]
If you would like to start a second blog which is independent from the first, you can use categories: Set up the blog with <blog cat=“NewBlog“ />. This will mean that As described, default blog feed is consisted of pages in Blog namespace. Other blog feeds can exist in addition to this feed, and they can be defined by category of namespace.
For example, category "Company news" can be designated for a second blog. In that case all pages in this category will appear as blogs.
Setting your preferences[edit | edit source]
- Images are incorporated as thumbnails, by default. This can be changed with the attribute renderimage.
- The blog page can be called up via the "blog" button in the topbar, or via the URL .../index.php?action=blog.
- The standard namespaces can be changed. Standard setting:
$wgExtraNamespaces[102] = 'Blog'; $wgExtraNamespaces[103] = 'Blog_talk';
Other option is to designate a namespace for this purpose. Using example from above, namespace "Company news" must be created and all pages inside this namespace (Company news:News1, Company news:News2) will be considered blog entries. Syntax that should be used for blog tag in this case is: <bs:blog ns="Company news" />
Keep in mind that when blog tags with "cat" or "ns" are used, all pages from that category/namespace will be shown, so those categories/namespaces should be used for that purpose only.
<bs:blog /> attributes[edit | edit source]
The following tag arguments can be used with the tag <bs:blog />:
| Argument Attribute | Description Attribute | Value | |
|---|---|---|---|
| count | Number of blog entries to displaybe displayed. | n number | |
| cat | Articles from this category are Category from which to show pages as blog entries . | NAME Category name | |
| ns | Special namespace | NAME Namespace from which to show pages as blog entries | Namespace name or ID |
| newentryfield | Display the form Should "Create new blog entry" be shown? | 0 or 1 | |
| newentryfieldposition | Position of the "Create new blog entry" form. | "bottom" or "top" | |
| renderimages | Image display | Should images be displayed | 0 or 1 |
| maxchars | Number of characters that should be shown before the "Continue reading" link is shown. | n |
Example: <bs:blog count="3" cat="test" newentryfield="0"/>
| number |
Tips for working with blogs[edit | edit source]
Put a link to the blog in the left hand navigation menu. Then your colleagues will be able to find the blog whenever they want.