FeedOnFeeds-Redux (FoFRedux)

Installation instructions - Upgrade instructions - Developer Guide - Tips

FoFRedux - Installation Instructions

Requirements:

MySQL version TBD (the MySQL server doesn't need to be on the same machine as the web server on which FeedOnFeeds-Redux is installed)
PHP version TBD

To Install:

Unzip the tarball fofredux-M.N.tar.gz somewhere in your web server's documents directory tree:
```
$ tar xzvf fofredux-M.N.tar.gz
```
The unarchived files will appear under fofredux-M.N/.
Create a database for FeedOnFeeds-Redux. At the MySQL client command line:
```
mysql> CREATE DATABASE fofredux;
```
Optional: Add a new database user just for FeedOnFeeds-Redux. At the MySQL client command line, as the MySQL root user:
```
mysql> GRANT ALL PRIVILEGES ON fofredux.* TO
    -> 'fofredux-user'@'localhost'
    -> IDENTIFIED BY 'some_password';
```
Configure FeedOnFeeds-Redux with information about its database. The simplest way is to:
```
$ cp config.php.sample config.php
```
and edit config.php, filling in the host, user, password, and database name for the database you created.
In a web browser, load the install.php page. The installer will first check that it can connect to your database and then attempt to create the necessary tables. Then it will attempt to create a subdirectory called cache where it will store cached copies of feeds. This part of the installation may fail, as your PHP process may not have permission to create a directory. You may need to create the directory {wherever you installed FeedOnFeeds-Redux}/cache/ yourself, and make sure it is writable by the PHP process. If you needed to do that, reload install.php.
You should be ready to roll. Start adding feeds!

To Restrict Access to FeedOnFeeds-Redux:

A future version of FeedOnFeeds-Redux may include support for multiple users and access control, but this version is open for the whole world (to add and delete feeds, mark items as read, etc.) by default. Here's how to use .htaccess to password-protect your FeedOnFeeds-Redux installation: ...

To Set Up Scheduled Updates:

The update-quiet.php script will update all feeds without producing any output. You can use cron -- or whatever task scheduling system is available to you -- to call this script periodically to update your feeds. For example, here is a crontab entry to run it 20 minutes past each hour:


20 * * * * /usr/bin/GET http://{your server}/{wherever you put FeedOnFeeds-Redux}/update-quiet.php

Or, if you have password-protected your FeedOnFeeds-Redux:


20 * * * * /usr/bin/GET -C user:password http://{your server}/{wherever you put FeedOnFeeds-Redux}/update-quiet.php

Upgrading from FeedOnFeeds:

Here are three different ways to upgrade from FeedOnFeeds to FeedOnFeeds-Redux. We don't recommend any one method over another; do what's easiest for you.

Whichever method you use, after you've upgraded you'll initially see "(UNKNOWN TYPE)" after the title of each feed; after an update this is replaced by the type of each feed.

Also, the default category for each feed is "None". You can change a feed's category by clicking its "edit" link.

Option 1: Use Your Existing Database

Follow the instructions in INSTALL but skip Step 2, where you would create a new database. In Step 4, when you edit config.php, use information about your existing FeedOnFeeds database. (Note: Do not simply copy your old config.php from FeedOnFeeds to your FeedOnFeeds-Redux directory; we've added new configuration items in this file.)

Option 2: Use a Copy of Your Existing Database

Make a copy of your existing FeedOnFeeds database:
shell> mysqldump feedonfeeds_db > feedonfeeds_db.sql
Make a new database for FeedOnFeeds-Redux:
mysql> create database fofredux_db;
Copy the schema and data from your FeedOnFeeds database to your new one:
shell> mysql fofredux_db < feedonfeeds_db.sql
Follow the instructions in INSTALL, skipping Step 2.

Option 3: Create a New Database

Follow the instructions in INSTALL. In your old FeedOnFeeds installation, export your feeds as an OPML file by clicking on "subscription list as opml" and saving that XML file. Once you have FeedOnFeeds-Redux set up, import your feeds using that OPML file at the Add Feeds page.

Tips

LiveJournal

To access friend-locked LiveJournal feeds, you need to enter the RSS url with the username and password in the feed uri:

http://username:password@www.livejournal.com/path/to/data/rss

Screensaver

If you're running Linux, you can use FoFRedux as your screensaver. See how to setup FoFRedux in XScreensaver. If you're running Mac OS X, you can use the built-in RSS Screensaver, and point your feed to the new RSS feed output from FoFRedux (located at rss.php)

FoFRedux - a personal, web-based news aggregator