# mt-rating.pl
#
# A MovableType plugin for displaying a rating (for a movie, book, or
# whatever) embedded within the keywords section in an individual blog
# entry.
#
# I'm not laying any copyright claim to this, since it is simply a port
# of Rael Dornfest's (http://www.raelity.org/) meta.rating plugin for
# blosxom. I thought it was a cool idea that would be useful for other
# MT users as well.
#
# Ported by David Thomson <[email protected]>
# You can always find the latest version at http://dwlt.net/
#
# I suppose it could benefit from a little further tidying up, but since it
# is so simple, and this is my first real attempt at both Perl and MT plugins,
# I don't think it would really be worth the time.
#
# This software is provided 'as-is', without any express or implied
# warranty. In no event will the authors be held liable for any damages
# arising from the use of this software.
#
#
# Installation
# ------------
# Place this file inside of your plugins directory where MT is installed. If
# the directory does not exist, create the plugins directory. Be sure the file
# permissions of rating.pl is set to 755.
#
#
# Usage
# -----
#
# <MTRatingExists>
# <$MTRating type="textual"$>
# </MTRatingExists>
#
# The above template code would display a rating in the appropriate format (which must be
# specified. Rating info should be specified in the keywords field of the entry, using the
# format 'rating=N', where N is a number between 1 and 5 (this can edited to suit using the
# config parameters below).
#
# Formats (examples based on rating=4):
#
# Numerical: 4
# Textual : <===O=>
# Star : ****
# Graphical: <img src="/images/rating_below.gif" height="10" width="30">
# <img src="/images/rating.gif" height="10" width="10">
# <img src="/images/rating_above.gif" height="10" width="10">
#
# Changelog
# ---------
# 0.1.0 July 1 2003
# - Initial Release