www-apps/pmwiki/cookbook/RssFeedDisplay/readme-archive.txt

   1 !!!Installation:
   2
   3 *Download the latest [=magpieRSS=] version from the [[http://magpierss.sourceforge.net/ |Magpie]] site. You need the following files installed:
   4 **YOURWIKIHOME/local/magpie/rss_cache.inc
   5 **YOURWIKIHOME/local/magpie/rss_fetch.inc
   6 **YOURWIKIHOME/local/magpie/rss_parse.inc
   7 **YOURWIKIHOME/local/magpie/rss_utils.inc
   8 **YOURWIKIHOME/local/magpie/extlib/Snoopy.class.inc
   9
  10 ->%red%'''THE FILE DOWNLOADED BY CLICKING ON RSSDISPLAY.PHP IS NOT A PHP FILE!!!'''
  11 ->%red%'''I WOULD NOT DOWNLOAD IT IF I WERE YOU'''
  12 ->(It is actually a copy of magpie-0.72.tar.gz)
  13
  14 *Download the recipe to a file named rssdisplay.php.
  15 -->Attach:rssdisplay.php (`PmWiki 2)
  16 ** (Here are a [[http://www.christophedavid.org/w/c/w.php/Files/Rssdisplayphp|modified version of the script]], and a [[http://www.christophedavid.org/w/c/w.php/Files/RssDisplayDemo|demonstration of its output]].) [[Category.cda|cda]]
  17
  18 *Caching
  19
  20 Create a cache-directory to avoid having the rss feed fetched a zillion times a day. Ensure the directory is writable for the webserver (chmod 777)
  21
  22 In the top section of the rssdisplay.php file, there are some settings for the caching. You might want to adjust the location of the cache directory or the expiration time. The expiration time is the (minimum) time between fetching a rss-feed.
  23
  24  [@
  25  define('MAGPIE_CACHE_AGE', 2*60*60); #expiration time (seconds).
  26  define('MAGPIE_CACHE_DIR', "$FarmD/cache"); # location this is YOURWIKIHOME/cache
  27  @]
  28  --->[-''Note: 2*60*60 is two times 60 minutes times 60 seconds, aka 2 hours''-]
  29
  30 add the following lines to your local/config.php (in this order or rssdisplay fails)
  31 [@
  32 include_once("$FarmD/local/magpie/rss_fetch.inc");
  33 include_once("$FarmD/local/rssdisplay.php");@]
  34
  35
  36 '''%red%Question:%%''' Your instructions just above say to add inclusion of rssdisplay.php "or" rss_fetch.inc to config.php.  Should that say "and" - should the admin include ''both'' files?? \\
  37 '''%green%Answer:%%'''You have to add both to your config.php. I have changed it
  38
  39 !!Usage
  40 *[=(:RSS http://example.com/rss.xml [long|short] number_of_items>:)=]
  41
  42 !!!Defaults
  43 *how: short
  44 *number_of_items: 10
  45 ->Will display the items in a simple list with a max of ten items:
  46
  47 *[=(:RSS http://example.com/rss.xml:)=]
  48
  49 To display a long format and a max of 5 items use:
  50
  51 *[=(:RSS http://example.com/rss.xml long 5:)=]
  52
  53 !!![[http://www.brambring.nl/wiki/Main/RSSFeedDemo |Example]]
  54
  55 !!Comments
  56 Guys it didnt work for me. Can anyone tell me step by step guide to add
  57 magpie RSS display to pmwiki
  58      --Amala Singh(amalasingh@gmail.com)
  59
  60 Apache's documentation doesn't say anything on enabling outgoing http requests.  Is this something that would be known by a different name?
  61 Searching for "outgoing http" on the Apache documentation site yields no relevant information.
  62 --Mike Linke
  63