inlineRSS - the RSS, RDF, HTML, and random XML importer plugin for WordPress.
-----------------------------------------------------------------------------
Copyright (C) 2005 Cal Demaine

This program is free software; you can redistribute it and/or
modify it under the terms of the GNU General Public License
as published by the Free Software Foundation; either version 2
of the License, or (at your option) any later version.

This program is distributed in the hope that it will be useful,
but WITHOUT ANY WARRANTY; without even the implied warranty of
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
GNU General Public License for more details.

The GNU General Public License is available here:
  http://www.gnu.org/copyleft/gpl.html



WHY:
====
I wanted dynamically-generated lists from del.icio.us and other sources to appear
in my WordPress site.  The existing tools weren't generalized enough, and I like
general.  Look around www.iconophobia.com.  Almost everywhere there's a list, it's
from an off-site feed.

For example, if you use http://del.icio.us, and tag stuff you want with "needful",
your site can have an automaticly updated "Wishlist".  Useful if you're running 
some kind of cam-girl site.  Or wanted to be able to point your friends and family
at one page as the gift-giving season draws near.

But it's not limited to that.  Any XML source can be translated.  And any other
content can be loaded straight in.  And, finally, you can run PHP script files
from within it.  Why you'd want to do some of these things is beyond me, but you
can.

USAGE:
======
1.  Put the contents of this zip file, minus readme.txt, into wp-content/plugins/
2.  In the WordPress plugins control panel, edit the inlineRSS.txt file to point
    at your feeds.  There are three fields per line, the "casual" name, the
    html/rss/xml feed URL, and the minimum time between refreshes, in minutes.
    See inside file for more details around options.
3.  In your theme's templates, add in <?php inlineRSS('casualname'); ?> 
    everywhere you want a feed.
4.  In your posts and pages, add in !inlineRSS:casualname everywhere you want
    a feed.  A trailing space or carriage return is a good idea if it's at the
    end of a post.
5.  There is an expanded calling feature for the templates, if you want to get
    get fancy or build bigger plugins.  It's:  inlineRSS('casualname','feedurl',
    timeout,'alternativeXSLT'), where the parameters are replaced by the values
    (in single quotes) that you'd normally put in the inlineRSS.txt file.  No
    inlineRSS.txt file is required if you do this.  The casual name is required
    because it uses that for the cache filename.

NOTES:
======
1.  The "casual" name is used to create a file called in_casualname.txt for caching,
    so nothing but pure alpha/numerics will work.
2.  There is now support for PHP 4 and 5, as well as XLST and DOM XSL.
3.  The system defaults to using CURL to pull feeds from other sites, to avoid
    some security issues.  Local file system reads use file_get_contents.
4.  You can modify the XSLT file to produce different or count-limited results,
    refer to the FAQ on www.iconophobia.com for more information.

SUPPORT:
========
You can check in at www.iconophobia.com and drop me a note if you require something.
No promises or anything, but I'd like it to work for you too.  There is a FAQ and
more up to date support information.