NAME

mt-allconsuming - A MovableType plugin to incorporate XML feeds from allconsuming.net into a web page


VERSION

1.0.


SYNOPSIS

    <MTAllConsumingList username="daveseidel" type="favorite_books">
        <a href="<$MTAllConsumingListLink$>"><$MTAllConsumingListTitle$></a><br/>
        &nbsp; &nbsp; <span class="realsmall">Last updated: <$MTAllConsumingListLastBuildDate$></span><br/>
        <table border="0" cellpadding="3">
        <MTAllConsumingListBooks sort_by="author,title">
            <tr>
                <td align="middle">
                    <img src="<$MTAllConsumingListBookImage$>"
                         border="0"
                         width="39"
                         height="60"
                         alt="<$MTAllConsumingListBookTitle$>" />
                </td>
                <td class="small" align="middle">
                    <$MTAllConsumingListBookAuthor$><br/>
                    <em><$MTAllConsumingListBookTitle$></em><br/>
                    <span class="realsmall">
                        <MTAllConsumingListBookPageNotZero>
                            Page: <$MTAllConsumingListBookPage$><br/>
                        </MTAllConsumingListBookPageNotZero>
                        <MTAllConsumingListBookCommentNotEmpty>
                            &quot;<$MTAllConsumingListBookComment$>&quot;<br/>
                        </MTAllConsumingListBookCommentNotEmpty>
                        [<a href="<$MTAllConsumingListBookAmazonLink$>">Amazon</a>]
                        [<a href="<$MTAllConsumingListBookACLink$>">All Consuming</a>]
                    </span>
                </td>
            </tr>
        </MTAllConsumingListBooks>
        </table>
    </MTAllConsumingList>


DESCRIPTION

All Consuming (http://allconsuming.net) is a web site that lets you create and maintain lists of your favorite books and books that you're currently reading, and creates XML feeds for those lists. All Consuming has lots of other cool features and services as well, and is free to use. Visit the web site to learn more.

mt-allconsuming is a MovableType plugin that retrieves an All Consuming XML feed and provides a set of tags so that you can incorporate the book information in a MovableType template. The plugin makes use of caching (implemented with code adapted from Timothy Appnel's mt-rssfeed plugin, see the Acknowledgements section) to keep a local copy of each feed you use, and only downloads a new copy if the original has been updated.


REQUIREMENTS


INSTALLATION

To install mt-allconsuming, copy the mt-allconsuming.pl file into your MovableTypeHome/plugins/ directory. If the plugins directory does not exist, just create it.


CONFIGURATION

You may need to configure one or more of the following configuration variables in the mt-allconsuming.pl file. They are located near the beginning of the file. If you change any of these variables, make sure you un-comment it before you save and upload the file.


TAG REFERENCE

Booklist Tags

Book Tags


ACKNOWLEDGEMENTS

Caching and caching configuration code adapted from Timothy Appnel's mt-rssfeed[1] plugin with Tim's generous permission. Tim's excellent article[2] on plugins was essential in helping me learn the MT plugin framework and write this, my first plugin.

 [1] http://www.mplode.com/tima/files/mt-plugins/#mt-rssfeed
 [2] http://www.oreillynet.com/pub/a/javascript/2003/03/18/movabletype.html?page=1

Thanks also to Erik Benson at allconsuming.net for encouraging me to get this done.


LICENSE

This work is licensed under the Creative Commons Attribution License. To view a copy of this license, visit http://creativecommons.org/licenses/by/1.0 or send a letter to Creative Commons, 559 Nathan Abbott Way, Stanford, California 94305, USA.


AUTHOR & COPYRIGHT

mt-allconsuming is Copyright 2003, Dave Seidel. All rights reserved.

 email: dave@superluminal.com
 weblog: http://www.superluminal.com/dave/weblog/