FANDOM


(+ja)
Line 1: Line 1:
 
{{new feature}}
 
{{new feature}}
 
{{Enabled by default}}
 
{{Enabled by default}}
  +
 
{{tocright}}
 
{{tocright}}
  +
  +
 
[[File:Wikia blog articles 3.png|frame|A bloglist using the code:<br/><code>&lt;bloglist summary="true" timestamp="true" count=50><br/><title>Sample!</title><br/>&lt;/bloglist&gt;</code>]]
 
[[File:Wikia blog articles 3.png|frame|A bloglist using the code:<br/><code>&lt;bloglist summary="true" timestamp="true" count=50><br/><title>Sample!</title><br/>&lt;/bloglist&gt;</code>]]
 
The '''bloglist''' feature from [[Help:Blog article|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 <code><nowiki><bloglist></nowiki></code> extension.
 
The '''bloglist''' feature from [[Help:Blog article|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 <code><nowiki><bloglist></nowiki></code> extension.
Line 50: Line 53:
 
:This specifies the number of posts shown.
 
:This specifies the number of posts shown.
 
:Takes a number (integer) input. If unspecified, it defaults to 5.
 
:Takes a number (integer) input. If unspecified, it defaults to 5.
:For example: <code><bloglist count=3></code>
+
:For example: <code>&lt;bloglist count=3&gt;</code>
   
 
;summary
 
;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.
 
: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 <code>true</code> or <code>false</code>, defaulting to false. If true, it shows first 200 characters of the blog post.
 
:Inputs are <code>true</code> or <code>false</code>, defaulting to false. If true, it shows first 200 characters of the blog post.
:For example: <code><bloglist summary=true></code>
+
:For example: <code>&lt;bloglist summary=true&gt;</code>
   
 
;summarylength
 
;summarylength
 
:This allows you to specify length of the text quoted in characters, if <code>summary=true</code>.
 
:This allows you to specify length of the text quoted in characters, if <code>summary=true</code>.
:For example: <code><bloglist summary=true summarylength=300></code>
+
:For example: <code>&lt;bloglist summary=true summarylength=300&gt;</code>
   
 
;type
 
;type
 
:Choose the general output style.
 
:Choose the general output style.
 
:Inputs are either <code>box</code> or <code>plain</code>. If unspecified, it defaults to box. Plain is just the content, without any box styling.
 
:Inputs are either <code>box</code> or <code>plain</code>. If unspecified, it defaults to box. Plain is just the content, without any box styling.
:For example: <code><bloglist type=plain></code>
+
:For example: <code>&lt;bloglist type=plain&gt;</code>
   
 
;title
 
;title
 
:When posts are shown in a box, this is shown as the box title. If it uses multiple words, the text must be written in quote marks.
 
:When posts are shown in a box, this is shown as the box title. If it uses multiple words, the text must be written in quote marks.
:For example: <code><bloglist title="Evil draws close"></code>
+
:For example: <code>&lt;bloglist title="Evil draws close"&gt;</code>
   
 
;style
 
;style
 
:This allows the addition of extra style parameters for the listing, and works like normal CSS styling.
 
:This allows the addition of extra style parameters for the listing, and works like normal CSS styling.
 
:If unspecified, it defaults to blank.
 
:If unspecified, it defaults to blank.
:For example :<code><bloglist style="float:right;clear:left;"></code>
+
:For example&nbsp;:<code>&lt;bloglist style="float:right;clear:left;"&gt;</code>
   
 
;order
 
;order
 
:This specifies how the post are sorted.
 
:This specifies how the post are sorted.
 
:Inputs are <code>date</code> or <code>author</code>. If unspecified, it defaults to date.
 
:Inputs are <code>date</code> or <code>author</code>. If unspecified, it defaults to date.
:For example :<code><bloglist order=date></code>
+
:For example&nbsp;:<code>&lt;bloglist order=date&gt;</code>
   
 
;ordertype
 
;ordertype
 
:This specifies what direction to sort in.
 
:This specifies what direction to sort in.
 
:Inputs are <code>descending</code>, <code>ascending</code>. If unspecified, it defaults to descending.
 
:Inputs are <code>descending</code>, <code>ascending</code>. If unspecified, it defaults to descending.
:For example :<code><bloglist ordertype=descending></code>
+
:For example&nbsp;:<code>&lt;bloglist ordertype=descending&gt;</code>
   
 
;timestamp
 
;timestamp
 
:This specifies whether a timestamp is shown.
 
:This specifies whether a timestamp is shown.
 
:Inputs are <code>true</code> or <code>false</code>. If unspecified, it defaults to false.
 
:Inputs are <code>true</code> or <code>false</code>. If unspecified, it defaults to false.
:For example :<code><bloglist timestamp=true></code>
+
:For example&nbsp;:<code>&lt;bloglist timestamp=true&gt;</code>
   
 
<!--
 
<!--
Line 113: Line 116:
   
 
[[ja:Help:ブログ記事/ブログリスト]]
 
[[ja:Help:ブログ記事/ブログリスト]]
[[Category:Help]]
+
[[Category:Help|{{PAGENAME}}]]

Revision as of 14:11, September 18, 2009

Nuvola Green Plus

This is a new feature on Fandom!

This extension is enabled by default on Fandom.


File:Wikia blog articles 3.png

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 <bloglist> extension.

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. In addition, 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. Even <bloglist></bloglist> will give you good results - it will list every post on the wiki.

Basic form

The basic form of the extension is as following:

<bloglist parameter1=setting1 parameter2="setting with spaces" p3=s3 p4=s4>
<category>Category1</category>
<category>Category2</category>
<author>Author1</author>
<author>Author2</author>
</bloglist>

Categories and authors

Note how the category and author sections are written differently to other inputs - this is because they can take multiple inputs.

In addition, using author and category together gives you posts by the selected authors from the selected categories.

Valid extension inputs

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:
<category>Category1</category>
<category>Category2</category>
<category>Category3</category>
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:
<author>Author1</author>
<author>Author2</author>
<author>Author3</author>
count
This specifies the number of posts shown.
Takes a number (integer) input. If unspecified, it defaults to 5.
For example: <bloglist count=3>
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 true or false, defaulting to false. If true, it shows first 200 characters of the blog post.
For example: <bloglist summary=true>
summarylength
This allows you to specify length of the text quoted in characters, if summary=true.
For example: <bloglist summary=true summarylength=300>
type
Choose the general output style.
Inputs are either box or plain. If unspecified, it defaults to box. Plain is just the content, without any box styling.
For example: <bloglist type=plain>
title
When posts are shown in a box, this is shown as the box title. If it uses multiple words, the text must be written in quote marks.
For example: <bloglist title="Evil draws close">
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 :<bloglist style="float:right;clear:left;">
order
This specifies how the post are sorted.
Inputs are date or author. If unspecified, it defaults to date.
For example :<bloglist order=date>
ordertype
This specifies what direction to sort in.
Inputs are descending, ascending. If unspecified, it defaults to descending.
For example :<bloglist ordertype=descending>
timestamp
This specifies whether a timestamp is shown.
Inputs are true or false. If unspecified, it defaults to false.
For example :<bloglist timestamp=true>


Sample code

<bloglist count=3 summary=true summarylength=250 type=plain title="Sample code" timestamp=true order=date>
<category>Blog</category>
<category>Glob</category>
<author>Kirkburn</author>
<author>Legolas</author>
<author>Drizzt</author>
</bloglist>

Other notes

  • If no valid posts are found, the following message will be displayed: "No posts found. Write one!"
Community content is available under CC-BY-SA unless otherwise noted.