Community Central
Register
Community Central
(fr)
(the "type" parameter has no effect on UCP)
Tags: Source edit Help
(32 intermediate revisions by 18 users not shown)
Line 1: Line 1:
[[File:Bloglist_example.png|thumb|225px|Example blog list]]
+
[[File:Bloglist_example_update.png|thumb|300px|A blog list]]
 
{{Enabled by default}}
 
{{Enabled by default}}
   
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 allows you to embed a list of [[Help:Blogs|blogs]] within a normal article.
   
 
==Step-by-Step==
 
==Step-by-Step==
* Decide what page you'd like to display a blog listing on, and open that page for editing.
+
* Decide which page you'd like to display the list of blogs on, and open that page for editing.
 
* Switch to [[Help:Editing|source mode]] and enter the following code on the page: <code><nowiki><bloglist/></nowiki></code>
 
* The <code><nowiki><bloglist/></nowiki></code> 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==
* Switch to [[Help:Editing|Source mode]] and enter the following code on the page:
 
 
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:
::<pre><bloglist></bloglist></pre>
 
 
* 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:
 
   
 
<pre>
 
<pre>
 
<bloglist count=3 summary=true summarylength=250 type=plain title="Sample code" timestamp=true order=date>
 
<bloglist count=3 summary=true summarylength=250 type=plain title="Sample code" timestamp=true order=date>
<category>Blog</category>
+
<category>News</category>
<category>Glob</category>
+
<category>Opinion</category>
<author>Kirkburn</author>
+
<author>User1</author>
<author>Legolas</author>
+
<author>User2</author>
<author>Drizzt</author>
+
<author>User3</author>
 
</bloglist>
 
</bloglist>
 
</pre>
 
</pre>
 
   
 
===Categories and authors===
 
===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.
+
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===
 
===List of parameters===
 
;author
 
;author
:This specifies which authors posts are collated from.
+
:This specifies which authors posts are selected 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.
+
: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:
 
:To use it type:
  +
 
<pre>
 
<pre>
 
<author>Author1</author>
 
<author>Author1</author>
Line 48: Line 41:
 
;category
 
;category
 
:This specifies which categories posts are pulled from.
 
: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).
+
: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:
 
:To use it type:
  +
 
<pre>
 
<pre>
 
<category>Category1</category>
 
<category>Category1</category>
Line 58: Line 52:
 
;count
 
;count
 
:This specifies the number of posts to query.
 
:This specifies the number of posts to query.
:Takes a number (integer) input. If unspecified, it defaults to 5.
+
:Takes a number input. If unspecified, it defaults to 5.
 
:For example: <code>&lt;bloglist count=3&gt;</code>
 
:For example: <code>&lt;bloglist count=3&gt;</code>
   
 
;displaycount
 
;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.
 
: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.
+
:Takes a number input. If unspecified, it defaults to 5.
 
:For example: <code>&lt;bloglist displaycount=3&gt;</code>
 
:For example: <code>&lt;bloglist displaycount=3&gt;</code>
   
Line 72: Line 66:
   
 
;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>. If not specified, it defaults to 200 characters.
 
:For example: <code>&lt;bloglist summary=true summarylength=300&gt;</code>
 
:For example: <code>&lt;bloglist summary=true summarylength=300&gt;</code>
   
Line 78: Line 72:
 
:This specifies the title when posts are shown with <code>type=box</code>. If it uses multiple words, the text must be written in quote marks.
 
:This specifies the title when posts are shown with <code>type=box</code>. If it uses multiple words, the text must be written in quote marks.
 
:For example: <code>&lt;bloglist title="Evil draws close"&gt;</code>
 
:For example: <code>&lt;bloglist title="Evil draws close"&gt;</code>
 
;type
 
:Choose the general output style.
 
:Inputs are either <code>box</code>, <code>plain</code>, <code>count</code>, <code>noparse</code> and <code>array</code>. If unspecified, it defaults to box.
 
::<code>box</code> places the listing in a pre-stylized box.
 
::<code>plain</code> is just the list without any styling.
 
::<code>count</code> doesn't display a blog listing at all, instead it displays the number of blog posts on the wiki.
 
::<code>noparse</code> shows entire blog posts, completely ignoring the summary length.
 
::<code>array</code> doesn't seem to be useful / hasn't been implemented. It just prints the word "Array".
 
:For example: <code>&lt;bloglist type=plain&gt;</code>
 
   
 
;order
 
;order
:This specifies how the post are sorted.
+
:This specifies how the posts are sorted.
 
:Inputs are <code>date</code>, <code>author</code>, or <code>comments</code>. If unspecified, it defaults to date.
 
:Inputs are <code>date</code>, <code>author</code>, or <code>comments</code>. If unspecified, it defaults to date.
 
:For example: <code>&lt;bloglist order=author&gt;</code>
 
:For example: <code>&lt;bloglist order=author&gt;</code>
Line 96: Line 80:
 
;ordertype
 
;ordertype
 
:This specifies what direction to sort in.
 
:This specifies what direction to sort in.
:Inputs are <code>desc</code> (meaning "descending") or <code>asc</code> (meaning "ascending"). If unspecified, it defaults to <code>desc</code>.
+
:Inputs are <code>desc</code> (meaning "descending") or <code>asc</code> (meaning "ascending"). If unspecified, it defaults to descending order.
 
:For example: <code>&lt;bloglist ordertype=desc&gt;</code>
 
:For example: <code>&lt;bloglist ordertype=desc&gt;</code>
   
<!--
 
;offset
 
:unknown / disfunctional?
 
 
:pages
 
:unknown / disfunctional?
 
 
;paging
 
:unknown / disfunctional?
 
-->
 
 
;create_timestamp
 
;create_timestamp
 
:Allows for only showing posts that have been ''created'' more recently than a specified date.
 
: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)
 
:Input is a timestamp of the form YYYYMMDDHHMMSS (year, month, day, hours, minutes, seconds)
:For example: <code>&lt;bloglist create_timestamp=20121028000000&gt;</code>
+
:For example: <code>&lt;bloglist create_timestamp=20140101000000&gt;</code>
   
 
;timestamp
 
;timestamp
 
:Allows for only showing posts that have been ''edited'' more recently than a specified date.
 
: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)
 
:Input is a timestamp of the form YYYYMMDDHHMMSS (year, month, day, hours, minutes, seconds)
:For example: <code>&lt;bloglist timestamp=20121028000000&gt;</code>
+
:For example: <code>&lt;bloglist timestamp=20140101000000&gt;</code>
   
 
;seemore
 
;seemore
 
:This specifies the URL that the "See More >" link should go to.
 
:This specifies the URL that the "See More >" link should go to.
:For example: <code>&lt;bloglist seemore="http://lyrics.wikia.com"&gt;</code>
+
:For example: <code>&lt;bloglist seemore="https://lyrics.fandom.com"&gt;</code>
   
 
==Other notes==
 
==Other notes==
Line 131: Line 105:
   
 
==Further Help & Feedback==
 
==Further Help & Feedback==
{{Help and feedback section}}
+
{{Help and feedback section}}[[be:Даведка:Блог/Bloglist]]
 
 
 
 
 
 
[[de:Hilfe:Blog-Artikel/Bloglist]]
 
[[de:Hilfe:Blog-Artikel/Bloglist]]
[[eshelp:Ayuda:Artículo de blog/Lista de Blogs]]
+
[[es:Ayuda:Blogs/Lista de Blogs]]
 
[[fr:Aide:Blogs/Liste de blog]]
 
[[fr:Aide:Blogs/Liste de blog]]
[[jahelp:Help:ブログ記事/ブログリスト]]
+
[[ja:ヘルプ:ブログ/ブログリスト]]
  +
[[pl:Pomoc:Blogi/bloglist]]
[[ruhelp:Справка:Блог/Bloglist]]
 
[[pl:Pomoc:Blogi/Listy]]
+
[[pt:Ajuda:Blogs/Lista de blogs]]
 
[[ru:Справка:Блог/Bloglist]]
  +
[[tr:Yardım:Bloglar/Blog listesi]]
  +
[[uk:Довідка:Блог/Bloglist]]
  +
[[zh:Help:博客列表]]
 
[[Category:Help|{{PAGENAME}}]]
 
[[Category:Help|{{PAGENAME}}]]

Revision as of 23:48, 31 January 2021

Bloglist example update

A blog list

This extension is enabled by default on Fandom.

The bloglist feature allows you to embed a list of blogs within a normal article.

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/>
  • The <bloglist/> 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:

<bloglist count=3 summary=true summarylength=250 type=plain title="Sample code" timestamp=true order=date>
<category>News</category>
<category>Opinion</category>
<author>User1</author>
<author>User2</author>
<author>User3</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. 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:
<author>Author1</author>
<author>Author2</author>
<author>Author3</author>
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:
<category>Category1</category>
<category>Category2</category>
<category>Category3</category>
count
This specifies the number of posts to query.
Takes a number input. If unspecified, it defaults to 5.
For example: <bloglist count=3>
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: <bloglist displaycount=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. If not specified, it defaults to 200 characters.
For example: <bloglist summary=true summarylength=300>
title
This specifies the title when posts are shown with type=box. If it uses multiple words, the text must be written in quote marks.
For example: <bloglist title="Evil draws close">
order
This specifies how the posts are sorted.
Inputs are date, author, or comments. If unspecified, it defaults to date.
For example: <bloglist order=author>
ordertype
This specifies what direction to sort in.
Inputs are desc (meaning "descending") or asc (meaning "ascending"). If unspecified, it defaults to descending order.
For example: <bloglist ordertype=desc>
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: <bloglist create_timestamp=20140101000000>
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: <bloglist timestamp=20140101000000>
seemore
This specifies the URL that the "See More >" link should go to.
For example: <bloglist seemore="https://lyrics.fandom.com">

Other notes

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

See also

Further Help & Feedback