Installing Link Roller

To install Link Roller, follow these simple steps:

  1. Extract the distribution and preserve the directories. The directories that have been extracted correspond to the directories in your Movable Type installation. Upload these directories to your Movable Type installation such that file structure looks like so (where mt-static is your StaticWebPath):

    MT_DIR/
    |__ mt-static/
    |   |__ plugins/
    |       |__ LinkRoller/
    |          |__ styles-linkroller.css
     |__ plugins/
         |__ LinkRoller/
            |__ lib/
            |   |__ LinkRoller/
            |      |__ App/
            |      |  |__ CMS.pm
            |      |__ Asset/
            |      |  |__ Link.pm
            |      |__ Import.pm
            |      |__ Template/
            |      |  |__ ContextHandlers.pm
            |      |__ Upgrade.pm
            |__ LinkRoller.pl
             |__ tmpl/
                |__ edit_link.tmpl
                |__ quickadd.tmpl
    

    If you're upgrading from MT Blogroll, copy the Blogroll folder found in MT_DIR/plugins/Blogroll/lib to MT_DIR/plugins/LinkRoller/lib. This will allow your MT Blogroll links to be imported into Link Roller.

  2. Point your browser to Movable Type (mt.cgi) and you will be prompted to install Link Roller. This step will update your database in order to support Link Roller. At this stage, your MT Blogroll links will also be imported:

    Upgrade Link Roller

  3. If the plugin has been correctly installed, the wizard will successfully complete and you will see the following under System Overview > Plugins

    Link Roller Registration

  4. If you're upgrading from MT Blogroll, your links should have been successfully imported. You can check this by going to the system-wide asset listing. You can now safely remove the Blogroll folder previously copied.

15 Comments

modemlooper said:
on Jan 30, 2008 10:10 PM | Reply

I installed this it shows up in system overview and I can add a link but as soon as you click save it shows this error

Loading template 'edit_asset.tmpl' failed.

Jim said:
on Feb 3, 2008 9:51 PM | Reply

I receive the same error as modemlooper.

Jim said:
on Feb 3, 2008 11:20 PM | Reply

hmmmm OK, I upgraded from 4.01 to 4.1 and the links seem to work now. Doesn't show up in plugins, but sill seems to function OK.

Roger said:
on Mar 4, 2008 9:55 PM | Reply

Hi

I think I could like the plugin except that you make huge assumptions about what people know about MT especial MT4.

I installed it and the instructions actually were not as clear as I would have liked or am accustomed to also I added a link like you showed on the site and nothing happened afterwards.

Is a link supposed to show up on my site? If so where? Is there some MT Tag I have to alter on my site?

All I can tell you is there is no link adding activities happening on my site.

Also I know you didn't say to do this but it seems to be required quit often with MT so I republished everything and nothing happend still...

Just wanted you to know.

Cheers

Becky said:
on Mar 8, 2008 2:53 PM | Reply

Arvind -

As usual, a superb plugin. I'm a big fan of keeping my data under my control instead of farming it out to flickr, YouTube, del.icio.us, and so forth... as popular as such sites are today, one never knows where they'll be in the future (and, accordingly, my data!). So I thank you for making it a wee bit easier to do so.

Two other things.

First, given some complaints I've seen around the MT community about the lack of documentation with the plugin (such as Roger's above), I thought I'd contribute I'd help out and take a tiny bit off your shoulders. So, everyone who's not Arvind, listen up:

Here's an example of code to include a list of your links on your blog:


">

The above will give a list of links, with the link text being the name you gave the link, and the link pointing towards the link URL (as you would expect). The key to using this plugin is understanding that Arvind has simply created a new type of asset called "link" and given us a way to manage them. So instead of adding a bunch of new template tags, you use the tags related to assets already built in to the MT engine.

Okay, that's done. This second item is directed at Arvind and the whole community: In displaying my links, I'd like to sort them alphabetically. This doesn't appear to be an option in 4.1. Has anyone come up with a template hack/workaround to achieve this effect?

Blessings to all!

Becky said:
on Mar 8, 2008 2:58 PM | Reply

Me again. Seems my example code didn't show up properly. Trying again... using brackets for tags.

[mt:assets type="link"] [p] [a href="[mt:assetURL /]"][mt:assetLabel /][/a] [/p] [/mt:assets]

Sorry 'bout that!

MicheleC said:
on Apr 5, 2008 9:31 AM | Reply

Arvind: I followed the instructions exactly 4 or 5 times, but I must be doing something wrong, because I never get the prompt to install Link Roller. I kept thinking that I'd put the files in the wrong locations, but they looked like the right locations each time when I rechecked them.

Becky: How did you get it to work and what could I be doing wrong?

TIA! Michele

tired of mt's bs said:
on May 12, 2008 12:15 AM | Reply

I have found the upgrade to 4.0, and the crappy documentation for MT4 to be a tremendous dissapointment and the fact that one stupid 3rd party plug in I grew to depend on not only suddenly changed names (thus making me feel like an idiot when I googled for updates and couldn't find 'em) was bad enough, but overall, no matter how many great features this software has, if MT and SA continue to put out shit documentation, and continue to piss on the end user, guess what? they'll switch to something else.

none of the 'documentation' with this plug in really helps much, and I don't understand why this site gets so much praise when it seems writing simple instructions so we can RTFM instead of relying on the goodwill of others. If I wanted that I'd switch to fucking wordpress.

Oh wait, Metblogs already did! Hmm, and they run 70+ sites with it...hmm...

demonsurfer said:
on May 23, 2008 9:13 AM | Reply

Thanks Arvind. Couldn't locate any instructions on usage tags, or the fact we need to sign up for http://shots.snap.com ..if it weren't for Becky further up in the comments, I imagine some users would just junk this plugin, which is a shame considering how much time you clearly put into creating it. Anyway cheers.

demonsurfer said:
on May 23, 2008 9:37 AM | Reply

btw, works fine on MT4.15b2, just added a widget and no worries:

    <mt:LinksHeader>

<div class="widget-recent-entries widget-archives widget"> <h3 class="widget-header">Link Roller</h3> <div class="widget-content"> <ul class="widget-list"> </mt:LinksHeader> <mt:assets type="link"> <li class="widget-list-item"><a href="<mt:assetURL />"><mt:assetLabel /></a></li> </mt:assets> <mt:LinksFooter> </ul> </div> </div> </mt:LinksFooter>

Karl Elvis said:
on May 31, 2008 7:35 PM | Reply

I'm a little disappointed to see no examples of use with the documentation; that seems like an essential part of any released plugin. Those of us who are good with templates can figure it out but asking beginner users to do that is unrealistic.

Also, there's a bug in the import of Blogroll entries, which was disappointing. I have a LOT of blogroll entries. It would be nice if there was a more robust import function.

Error during upgrade: Statement has no result columns to bind (perhaps you need to successfully call execute first) at /var/www/vhosts/(my site)/cgi-bin/mt4/extlib/Data/ObjectDriver/Driver/DBI.pm line 119.

Karl Elvis said:
on May 31, 2008 8:12 PM | Reply

I also REALLY wish this had all the features of MTBLogRoll. Priority and Category are both gone.

I used 'Category' to group my links, and it worked very well; now I have to use some sort of 'MtIF' construction and the manage things with tags, which is over-loading the idea of tags, or I have to mis-use 'author'.

I used 'Priority' to control sort order in the display.

This feels like a backwards step; Arvind, if you're replacing blogroll with this tool, we really need full functionality from Blogroll. Thx.

Karl Elvis replied to Karl Elvis's comment:
on Jun 2, 2008 7:31 PM | Reply

Ah, I see. The 'Error during upgrade' thing is a bug in importing from MtBlogroll. I'd forgotten that I'd upgraded to MT4 by importing entries (because MT4 is absolutely horrible about backwards compatibility). So I don't have my blogroll in MT4.

So the error seems to mean "you don't have a blogroll". That should have an intelligent error message though, not this Epic Fail.

Meanwhile, we really still need an import feature that would slurp in links in some reasonably exported format. Because I still have a database full of links I need to extract from MT3 and import to Mt4 once I get linkroller working.

Patrick said:
on Jun 9, 2008 11:17 PM | Reply

Is it pretty much safe to say there is no documentation for this plugin currently in existence? I don't fare well with shooting in the dark. :)

Please consider this all important documentation a necessity, unless of course I overlooked it somewhere on the site.

Cheers

Karl Elvis said:
on Jun 9, 2008 11:21 PM | Reply

Patrick, there's no documentation whatsoever.

About

This is part of the official user manual for Link Roller, a plugin for Movable Type by Arvind Satyanarayan.

More Information »

Screenshots

Click a screenshot to browse through the gallery or the arrows to flip through them

←→

Documentation

I Heart Melody