/*==================================================
How to use DeliciousJSON plugin
==================================================*/
2008.04.19 by okayama(http://weeeblog.net/)

Download:
http://weeeblog.net/publish/MT/plugins/DeliciousJSON.zip

Documentation(Sorry, only available in Japanese as yet):
http://weeeblog.net/logs/2008/03/30_2208.php


Thank you for using my plugin.

Documentation of using this plugin on my blog is only in Japanese, so I wrote this.

My explanation may come across strange because I am not accustomed to writing in English.
Please ask again if you do not understand.
And please correct me if I make any grammatical error.


================
Overview
================

Show information of your bookmarks using del.icio.us.
Works with Movable Type 4 or 3.


====================
How To Install
====================

1. Download DeliciousJSON.zip and unzip.

2. Upload or copy 'DeliciousJSON' folder and all files in the folder
into your Movable Type's plugin directory.
For example:
mt/plugins/DeliciousJSON

3. After proper installation, you will see a new "DeliciousJSON Plugin" listed
on the Main Menu of your Movable Type.


==============================
Available Template Tags
==============================

1. 'MTDeliciousInfo' block(container) tag

A block(container) tag for listing your bookmarks using del.icio.us.

Options of 'MTDeliciousInfo' tag

user="USER NAME"
Your username for del.icio.us.

count="N"
Shows only N bookmarks.

tag="TAG"
Show bookmarks only tagged 'TAG'.
'TAG1+TAG2' is more limited.


2. 'MTDeliciousInfoHeader' block(container) tag

You can use this tag only in 'MTDeliciousInfo' tag.
Contents that encloses it with this tag is processed only first time of 'MTDeliciousInfo' tag's loop.
This tag is looking like 'MTEntriesHeader'.
http://www.movabletype.org/documentation/appendices/tags/entriesheader.html


3. 'MTDeliciousInfoFooter' block(container) tag

You can use this tag only in 'MTDeliciousInfo' tag.
Contents inside this tag are processed during 'MTDeliciousInfo' tag's last loop.
This tag looks like 'MTEntriesFooter'.
http://www.movabletype.org/documentation/appendices/tags/entriesfooter.html


4. 'MTDeliciousCount' function(variable) tag

You can use this tag only in 'MTDeliciousInfo' tag.
It will show the number of your bookmarks using del.icio.us.
This tag is for 'MTIfNonZero' tag (example: <MTIfNonZero tag="MTDeliciousCount">*</MTIfNonZero>).


5. 'MTDeliciousURL' function(variable) tag

You can use this tag only in 'MTDeliciousInfo' tag.
It will show the URL of the bookmark.

Options of 'MTDeliciousInfo' tag

cut="1"
It will show the URL of Document Root of the bookmark. 
It will also show the favicon of the site.
(example: http://weeeblog.net/logs/index.php => http://weeeblog.net/)


6. 'MTDeliciousDescription' function(variable) tag

You can use this tag only in 'MTDeliciousInfo' tag.
It will show the 'Description' of the bookmark.
This might be the page title.


7. 'MTDeliciousNotes' function(variable) tag

You can use this tag only in 'MTDeliciousInfo' tag.
It will show the 'Notes' of the bookmark.
This might be the page title.


8. 'MTDeliciousTags' block(container) tag

You can use this tag only in 'MTDeliciousInfo' tag.
This tag is for listing tags of the bookmark.

Options of 'MTDeliciousTags' tag

glue="*"
This separates each of the tags with a string specified by "glue".
This is useful when you wish to separate the tag names with a comma, for example.


9. 'MTDeliciousTag' function(variable) tag

You can use this tag only in 'MTDeliciousTags' tag.
This will show tags of the bookmark.


================
Examples
================

To list 5 of my (okayama) bookmarks tagged with 'MovableType' and 'Plugins' with favicon:

<!--[del.icio.us START]-->
<MTDeliciousInfo count="5" tag="MovableType+Plugins" user="okayama">
<MTIfNonZero tag="MTDeliciousCount">
<MTDeliciousInfoHeader>
<dl>
</MTDeliciousInfoHeader>
    <dt><a href="<$MTDeliciousURL$>"><img src="<$MTDeliciousURL cut="1"$>favicon.ico" alt="" width="16" height="16" /><$MTDeliciousDescription$></a></dt>
    <dd><$MTDeliciousNotes$></dd>
    <dd>tag: <MTDeliciousTags glue=","><a href="http://del.icio.us/tag/<$MTDeliciousTag$>"><$MTDeliciousTag$></a></MTDeliciousTags></dd>
<MTDeliciousInfoFooter>
</dl>
</MTDeliciousInfoFooter>
</MTIfNonZero>
</MTDeliciousInfo>
<!--[del.icio.us END]-->

This is just like using Javascript on the following page:
http://del.icio.us/help/json/posts


================
Feedback
================

okayama(weeeblog@gmail.com)


==============================
Author & Copyright
==============================

Copyright 2008, okayama(weeeblog@gmail.com)