This plugin lets you manage a database of links from your admin area and maintains a count of how many times each link has been clicked on by reader. When used as a skin variable, it displays a redirector URL in the form of /nucleus/plugins/blogroll/?n=id, or a group of such URLs.
The latest version add tag cloud and del.ico.us support.
| General Plugin info | |
|---|---|
| Current Version: | 0.40 (Beta) |
| Download: | Download the latest version here :np_blogroll_v30.zip (Old Version) |
| Forum Thread: | v0.4x Old Thread |
| Author: | Joel Pan (ketsugi) Modified by Edmond Hui (admun) |
Note: Version 0.36 onwards added new plugin and member options, so user need to uninstall/re-install to upgrade.
Parameters: Type, ID, Sort field, Sort order, GroupDesc, NumOfLinks, tagcloud, tagclousresult
‘group’ | ‘link’ | ‘user’ Tells plugin whether to display an individual link or a group of links as defined in the admin area, or a single user’s links.
If Type is ‘group’, this should be the name of the group to display. Use the pipe character (’|’) to separate multiple group names. If Type is ‘link’, this should be the numeric ID of the link to display. If Type is ‘user’, this should be the short name (login name) of the user whose blogroll should be displayed. If the user specified is not a member of the team for the blog being displayed, the blogroll will not be shown.
‘order’ | ‘url’ | ‘text’ | ‘desc’ | ‘created’ | ‘clicked’ | ‘counter’ If Type is ‘group’, tells plugin in what order to display links. Defaults to ‘order’, which displays links according to the order defined in admin area. If Type is ‘link’, this field is ignored.
‘asc’ | ‘desc’ If Type is group, tells plugin whether to display links in ascending or descending order according to the field defined in Sort field. Defaults to ‘asc’.
If ID defines multiple groups to display links from, the GroupDesc value will determine what will replace the <%groupdesc%> variable in the blogroll template. If no GroupDesc is specified, the description of the first group will be used.
If Type is group, tells plugin to display only a specified number of links. Must be a positive integer value; if not, plugin will display all links.
Set to “yes” or “no” to override the default as set in Blogroll’s plugin options to determine whether to show the redirector URL or the regular URL.
In the plugin options page, you can specify how links will appear on your page. The variables available for use in all fields except ‘Item’ are:
<%groupid%>: the group’s internal id number<%groupname%>: the group name<%groupdesc%>: the group’s descriptionVariables available for use in the item template are:
<%linkid%>: the link’s id number<%linkurl%>: the link’s redirector URL as generated by the plugin<%linktext%>: the link text<%linktitle%>: the link’s description<%linkcounter%>: number of times the link has been clicked (not available if redirection is off) <%linkclicked%>: date and time the link was last clicked (not available if redirection is off)<%linkcreated%>: when the link was created
If the <%Blogroll%> skinvar is used to call a single link, the item template will be used to display the link.
<%Blogroll(group,blogs)%>: displays the group of links named ‘blogs’<%Blogroll(group,mac,clicked,desc)%>: display the group of links named ‘mac’, from the most recently clicked to the least recently clicked<%Blogroll(group,blogs|news|mac,text,desc,Blogroll)%>: displays all links from ‘blogs’, ‘news’ and ‘mac, sorted by text in descending order, and using ‘Blogroll’ as a collective group description<%Blogroll(group,news|mac,random,,News,10)%>: displays 10 random links from ‘news’ and ‘mac’. <%Blogroll(link,5,,,,,yes)%>: displays the link for link #5, displaying the redirector URL even if the plugin option is set to “no”.<%Blogroll(user,johndoe)%>: displays all groups and links for the member with short name “johndoe”.<%Blogroll(tagcloud,[group]%> (New in Ver 0.36): display a tagcloud for a particular group<%Blogroll(tagcloudresult)%> (New in Ver 0.36): display all links for a tag (select from the tagcloud) p.s. The del.icio.us used the same phpDelicious code as NP_TechnoratiTags. So, if you have this plugin installed, just overwrite it.
Add the follow CSS to your skin CSS file:
.BRtinyT { font-size:14px;}
.BRsmallT { font-size:20px;}
.BRmediumT { font-size:24px;}
.BRlargeT { font-size:26px; font-weight: bold;}
<?php
$CONF = array();
$CONF['Self'] = 'index.php';
include('./config.php');
selectSkin('blogroll');
selector();
?>
If FancyURL/FancierURL2 is setup, the following code is need to add to .htaccess
<FilesMatch "^tags$">
ForceType application/x-httpd-php
</FilesMatch>
Then, rename tags.php to tags
Code: http://edmondhui.homeip.net/nudn/item/1029
Example: http://edmondhui.homeip.net/blog/blogroll.php
By adding <%Blogroll(searchbox, [group])%> in the blogroll page, a search box will be inserted to allow user to search for links with a keyword.
A new <%Blogroll(relatedtags)%> skinvar is added to allow showing of related tags in blogroll page.
NP_Blogroll version 0.40 works with Nucleus CMS version 3.31 - 2007-10-31 kg