Help:Blogs/Bloglist



The bloglist feature from blog articles allows you to embed a blog listing within a normal wiki article. It's like a blog listing page to go, and uses the  extension.

Step-by-Step

 * Decide what page you'd like to display a blog listing on, and open that page for editing.


 * Switch to Source mode and enter the following code on the page:




 * Save the page and enjoy your new bloglist, which displays all of the recent blog posts of the wiki, and looks something like the image to the right.

Customizing
There are a number of parameters you can define to change the content of your blog list so it works for different content pages. it is extremely customizable.

Though this may seem complex at first, you can specify as many or as few parameters as you wish, as each parameter has a default setting.

Here's an example of customization:

 Blog Glob Kirkburn Legolas Drizzt

Categories and authors
Note how the category and author sections are written differently to other inputs - this is because they can take multiple inputs. Using author and category together gives you posts by the selected authors from the selected categories.

List of parameters

 * author
 * This specifies which authors posts are collated from.
 * It is an "or" selector - i.e. give it several authors, and it will collate posts from each author together. If unspecified, it defaults to all authors.
 * To use it type:

Author1 Author2 Author3


 * category
 * This specifies which categories posts are pulled from.
 * It is an "or" selector - i.e. give it several categories, and it will collate posts from each category together. If unspecified, it defaults to show all categories (even uncategorized posts).
 * To use it type:

Category1 Category2 Category3


 * count
 * This specifies the number of posts to query.
 * Takes a number (integer) input. If unspecified, it defaults to 5.
 * For example:


 * displaycount
 * This specifies the number of posts to display. Normally this shouldn't be used, unless there is some reason you want to query the database for more results than are actually shown on the page.
 * Takes a number (integer) input. If unspecified, it defaults to 5.
 * For example:


 * summary
 * This specifies whether a section of the blog post is shown on the listing. Please note it is not intended to show full blog posts - it shows only sections, stripped of formatting.
 * Inputs are  or , defaulting to false. If true, it shows first 200 characters of the blog post.
 * For example:


 * summarylength
 * This allows you to specify length of the text quoted in characters, if.
 * For example:


 * title
 * This specifies the title when posts are shown with . If it uses multiple words, the text must be written in quote marks.
 * For example:


 * type
 * Choose the general output style.
 * Inputs are either,  ,  ,   and  . If unspecified, it defaults to box.
 * places the listing in a pre-stylized box.
 * is just the list without any styling.
 * doesn't display a blog listing at all, instead it displays the number of blog posts on the wiki.
 * shows entire blog posts, completely ignoring the summary length.
 * doesn't seem to be useful / hasn't been implemented. It just prints the word "Array".
 * For example:


 * style
 * This allows the addition of extra style parameters for the listing, and works like normal CSS styling.
 * If unspecified, it defaults to blank.
 * For example:


 * order
 * This specifies how the post are sorted.
 * Inputs are,  , or  . If unspecified, it defaults to date.
 * For example:


 * ordertype
 * This specifies what direction to sort in.
 * Inputs are  (meaning "descending") or   (meaning "ascending"). If unspecified, it defaults to.
 * For example:


 * create_timestamp
 * Allows for only showing posts that have been created more recently than a specified date.
 * Input is a timestamp of the form YYYYMMDDHHMMSS (year, month, day, hours, minutes, seconds)
 * For example:


 * timestamp
 * Allows for only showing posts that have been edited more recently than a specified date.
 * Input is a timestamp of the form YYYYMMDDHHMMSS (year, month, day, hours, minutes, seconds)
 * For example:


 * seemore
 * This specifies the URL that the "See More >" link should go to.
 * For example:

Other notes

 * If no valid posts are found, the following message will be displayed: "No posts found. Write one!"

Further Help & Feedback
de:Hilfe:Blog-Artikel/Bloglist es:Ayuda:Artículo de blog/Lista de Blogs ja:Help:ブログ記事/ブログリスト ru:Справка:Блог/Bloglist