Help:Blogs/Bloglist



The bloglist is a feature that allows you to group a specific list of blog posts from one or several categories in a page. It also gives you the opportunity to embed a list of blogs within a normal article.

Why create a bloglist
Blog listing pages are a great way to quickly gather a list of blog posts with categories. By default, "Blog:Recent posts" exists on all wikis with blog posts enabled, listing all the recent blog posts on the wiki and accessible in the Explore menu of each local navigation.

It can be helpful to separate blogs in two or more lists so visitors can choose the type of blog that users want to read and follow.

For example, readers could be interested in the latest news and reviews about the topic of your wiki or fanfiction written by users but not so much about reviews with spoilers. The community could choose to create three different bloglists: one that would group all blogs about news and reviews, one dedicated to user fanfiction, and third one for blogs with spoilers.

So a blog can appear in as many bloglist as wished. To add a blog to the list, you just need to add the category used to feed the relevant bloglist. For example, by default and on each wiki, every blog placed in "Category:Blog posts" is displayed in "Blog:Recent posts".

Unlike categories, bloglists can be sorted by dates or number of comments. Each blog in the bloglist shows, alongside the author's name and the blog title:
 * The date of creation
 * The number of comments
 * The first lines of the blog

How to create a blog listing page
You can create a new blog listing at "Special:CreateBlogListingPage", which you will automatically land on if you try to create the bloglist in the Blog: namespace. If you wish to edit an already existing bloglist, you can add  at the end of the URL of the bloglist page. You can also visit the page, replacing "Page name" by the name of the blog list.

The Special:CreateBlogListingPage page has the following options:
 * "": the title that the blog post list will have. The page will then be saved in the  namespace.
 * "" module: several existing categories on the wiki. Select the category that will allow the blogs to be displayed in the list.
 * If you click on the category, the text turns meaning that you have selected this category.
 * If the module does not contain the desired category, fill in the "" field omitting the namespace (e.g. Fanfiction instead of Category:Fanfiction) then click on "".
 * "": If you click on the "" button, it will display the number of blogs that would be displayed with the current settings. You can try as many time as you want by clicking "Re-calculate".
 * "": It allows you to choose the way your blog listing page will be displayed. You can sort the list by date in descending order (""), by editor in alphabetic order ("") and by activity in descending order ("").
 * "" module: several existing (or used) categories on the wiki. Select the category in which the list will appear.
 * If you click on the category, the text turns meaning that you have selected this category.
 * If the module does not contain the desired category, fill in the "" field omitting the namespace (e.g. "Community blogs" instead of "Category:Community blogs") then click on "".
 * Then you have the choice between creating the page or displaying the source code that you can copy and paste on the desired page. The easiest way is to save directly but the source code can be helpful if you want to embed or further customize the list.
 * You can also preview the page before saving it to see how it will be displayed. It is recommended so you don't have to make multiple edits.


 * Note that blog listings do not update immediately upon creation of a new blog post. You can wait for the cache to clear (a couple of hours), or add  to the URL of the listing page.

How to create an embedded bloglist
A tag is available to allow you to embed a list of blogs within a normal article. There are a number of parameters you can define to format the embedded list to fit within different content pages - e.g. the main page, the community portal, a contest page, etc. - and it is extremely customizable.

Step-by-step

 * Decide which page you'd like to display the list of blogs on, and open that page for editing.
 * Switch to source mode and enter the following code on the page:
 * Bloglist example update.png The  tag without further customization will display all of the recent blog posts on the wiki, and look something like the image to the right.

Customizing your bloglist
There are a number of parameters you can define to change the content of your blog list so it works for different content pages. Though this may seem complex at first, you can specify up to ten parameters as you wish. Those you don't specify will use the default setting.

Here's an example of customization:

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 any posts by the selected authors from the selected categories.

List of parameters

 * author
 * This specifies which authors posts are selected from.
 * It is an "or" selector - if you specify more than one author, it will collate posts from each author together. If unspecified, it defaults to all authors.
 * To use it type:


 * category
 * This specifies which categories posts are pulled from.
 * It is an "or" selector - if you specify more than one category, and it will collate posts from each category together. If unspecified, it defaults to show all categorized and uncategorized posts.
 * To use it type:


 * count
 * This specifies the number of posts to query.
 * Takes a number 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 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 . If not specified, it defaults to 200 characters.
 * For example:


 * type
 * Choose the general output style.
 * Inputs are either  or  . If unspecified, it defaults to  .   will include the "Create Blog Post" button at the top of the list and the " See More > " link at the bottom by default.
 * - places the listing in a pre-stylized box.
 * - is just the list without any styling.
 * 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:


 * order
 * This specifies how the posts 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 descending order.
 * 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!"
 * It is possible to follow a bloglist by either add  at the end of the URL of the bloglist page or by clicking on "" on your toolbar.

Further Help & Feedback
de:Hilfe:Blog-Artikel/Bloglist es:Ayuda:Blogs/Lista de Blogs fr:Aide:Blogs/Liste de blog it:Aiuto:Blog/Lista di blog ja:ヘルプ:ブログ/ブログリスト pl:Pomoc:Blogi/bloglist pt:Ajuda:Blogs/Lista de blogs ru:Справка:Блог/Bloglist tr:Yardım:Bloglar/Blog listesi uk:Довідка:Блог/Bloglist zh:Help:博客列表