RSS 2.0 Enclosure Plugin
Original plugin written by Dave Slusher (http://www.evilgeniuschronicles.org/)
Original RSS 2.0 flavour written by Mike Mason (http://mikemason.ca/)
Both tweaked for public consumption by Keith Irwin
(http://www.asyserver.com/~kirwin/cgi-bin/blosxom.cgi/index.html)
The plugin requires the LWP (libwww-perl) perl library in order to find
the MIME type and size of the enclosed file as required by the enclosure
tag. Please install this library or ask your system administrator to
install this library if you intend to use this plugin.
Add the plugin ("enclosures") to your plugin directory. Add the flavour
(*.rss20 and if you want, *.buttress) to your blosxom directory
(or other flavour directory). Edit the specific information in
the flavour documents to reflect thing like your
author and copyright information.
Then any references in your entries which you wish to include as an
enclosure (meaning that it will be downloaded automatically by the
RSS feed reader when it reads the feed), you can do so by adding
'enclosure = "true"' into the anchor tag. That is, instead of writing:
you write
or
Both sets of quotes can probably be omitted, but are recommended. Leaving
off one quote (i.e. href="http://myblog.com/audiofile1.mp3 ) is likely to
cause problems.
The plugin takes the URL and automatically determines the MIME type
and size of the file which is being pointed to. As such, you should
be sure that the MIME type of the file being pointed to is correct
on its server so that things are dealt with appropriately. Any type
of file can be enclosed, including audio and video files, documents,
pictures, and torrent files. This plugin should work with software
such as iPodder and Torrentocracy with the rss20 flavour.
It will work with Buttress with the buttress flavour.
Remember that any enclosure will be downloaded from wherever it is hosted.
So, please, do not enclose large media files on other people's servers
without their permission both because it will suck their bandwidth and
because it may result in them moving or removing the file.
A word of caution about using Buttress with this plugin: Buttress expects
a torrent file in the URL field of any and every RSS entry. It was
originally designed strictly for sites which only had torrents. Do not
count on there being a sensible result for the URL field for stories
which do not have an enclosure. The easiest way to work around this
problem is to use Buttress's ability to filter by having some word which
is included in every post which has an enclosure and is not in any which
does not. The other work around is to always include a torrent file in
every story.