mcw_ma_gnolia is a TextPattern plugin that generates a customizable Ma.gnolia link roll for use on your website. Download it now, and start playing!
Updated 26. April, 2006: Version 0.3 is out, adding the ability to filter the links in your linkroll by a specific tag, and changing the link retrieval mechanism so that it functions correctly on more servers.
Updated 25. April, 2006: Version 0.2 is out, and corrects a small bug with the
What is it?
Ma.gnolia is a social bookmarking site (somewhat like del.icio.us) that I use to keep track of interesting websites I come across. It provides the built in ability to display your most recent bookmarks on your personal website (a ‘link roll’), but I don’t like the mechanism it uses to make that happen.
document.write to dump the link roll to your site. This works, but it’s not exactly accessible, nor is it very flexible.
How Do I Use
mcw_ma_gnolia? (e.g. quickstart)
Start by downloading the plugin and installing it like you would any other. Once you’ve gotten the plugin installed,
edit it, and enter your ma.gnolia username and the number of links you’d like displayed into the public config section of the PHP code (should be lines 6 and 7 or so). If you don’t do this, you’ll be seeing my links. That’s a fine way to test, but you’ll probably want to make this change before you go live.
Next, click on the
extensions tab, and then on the
Ma.gnolia Linkroll subtab. Hitting this page will automatically create a
mcw_ma_gnolia, and offer you the opportunity to force-update your cached ma.gnolia links. Go ahead and hit that button now to speed things up later.
Finally, edit a
page to include the
<txp:mcw_ma_gnolia /> tag. Viola, ma.gnolia links on your page. Astounding!
How do I configure the output?
Excellent question. Here’s brief documentation of each of the tags this plugin enables:
mcw_ma_gnoliatag is a single tag that gets replaced with the Link Roll. It can be included on a
pagedirectly, or as part of a
formthat’s displayed on a page.
form– this specifies the
formto be used for each of the displayed links. Defaults to
wrap_tag– specifies the block-level tag to wrap the links. Defaults to
class– applies a CSS class to the block-level tag specified in the
mcw_ma_gnolia_uritag is a single tag that gets replaced with a link’s URI (the actual address of the link).
mcw_ma_gnolia_linktag is a single tag that gets replaced with a link’s ma.gnolia redirect (e.g.
mcw_ma_gnolia_titletag is a single tag that gets replaced with a link’s title.
mcw_ma_gnolia_desctag is a single tag that gets replaced with a link’s description.
Page: default ... <div id='ma_gnolia_linkroll'> <h2>My Recent Bookmarks</h2> <txp:mcw_ma_gnolia form='mcw_ma_gnolia' wrap_tag='ol' class='ma_gnolia_list' /> </div> ...
Form: mcw_ma_gnolia <li> <a href='<txp:mcw_ma_gnolia_link />' title='<txp:mcw_ma_gnolia_title />' ><txp:mcw_ma_gnolia_title /></a> - <txp:mcw_ma_gnolia_desc /> </li>
<div id='ma_gnolia_linkroll'> <h2>My Recent Bookmarks</h2> <ol class='ma_gnolia_list'> <li> <a href='LINK_GO_HERE' title='TITLE_GO_HERE' >TITLE_GO_HERE</a> - DESCRIPTION GO HERE </li> ... <li> <a href='LINK_GO_HERE' title='TITLE_GO_HERE' >TITLE_GO_HERE</a> - DESCRIPTION GO HERE </li> </ol> </div>
Nice, eh?— Mike West