aboutsummaryrefslogtreecommitdiffstats

rss_dot_php

A minimal configurable RSS/Atom reader in about 200 lines of PHP.

This tool isn't intended for standalone reading, instead it's intended to be used as an aggregator for personal feeds, that can be embedded into a website via an <iframe>.

You can see it in action on my homepage.

Usage

To use this tool, just download the main rss.php file and edit it. Each entry in the $feeds array corresponds to a feed that will be displayed. The key of the entry is the name.

The following options are supported per-feed:

  • $feeds[feed]["url"]: REQUIRED: The URL of the RSS/Atom feed.
  • $feeds[feed]["home"]: An optional homepage for the feed. Will be linked under every entry from it.
  • $feeds[feed]["ttl"]: How long to cache the feed for, in seconds. Defaults to 1 hour.
  • $feeds[feed]["linkrel"]: For Atom, which rel= value to prefer when getting a link. Defaults to alternate.

The remaining config options are set on the $config array, and are documented inside the file.

Caching

The cache uses PHP's builtin serialize/unserialize functions, and stores entries at {$config["cache_dir"]}/{md5($feed["url"])}. Only one cache file will ever exist for a feed, and it is safe for multiple instances to share a cache directory, even if feed URLs overlap.

Styling

aleteoryx.css contains an example stylesheet.