Full-Text RSS — from FiveFilters.org
For the site owner
Thanks for downloading and setting this up. If you haven't done so already, check server compatibility to see if your environment will support this application. Full-Text RSS runs on most shared web hosting environments.
Configure
In addition to the options above, Full-Text RSS comes with a configuration file which allows you to control how the application works. Features include:
- Restrict access to a pre-defined set of URLs or block certain URLs
- Restrict the maximum number of feed items to be processed
- Prepend or append an HTML fragment to each feed item processed
- Caching
To change the configuration, save a copy of config.php as custom_config.php and make any changes you like to it.To change the configuration, edit custom_config.php and make any changes you like.
If everything works fine, feel free to modify this page by saving it as custom_index.php and change it to whatever you like.
Sharing is caring
If you plan to offer this service to others through your hosted copy, please keep a download link so users can grab a copy of the code if they want it (you can either offer the download yourself, or link to the download page on fivefilters.org to support us). That's one requirement of the license.Thanks! :)
Updates
To see if you're running the latest version, check for updates.
Support
We have more information in the section below, but if you need help with anything, please email fivefilters@fivefilters.org.
For everyone
About
This is a free software project to help people extract content from web pages. It can extract content from a standard HTML page and return a 1-item feed or it can transform an existing feed into a full-text feed. It is being developed as part of the Five Filters project to promote independent, non-corporate media.
Bookmarklet
To easily transform partial-feeds you encounter (or convert any content on a page into a 1-item feed), drag the link below to your browser's bookmarks toolbar. Then whenever you'd like a full-text feed, click the bookmarklet.
Drag this:
API
To extract content from a web page or to transform an existing partial feed to full text, pass the URL (encoded) in the querystring to the following URL:
- /makefulltextfeed.php?url=[url]
If you have an API key, add that to the querystring:
- /makefulltextfeed.php?key=[key]&url=[url]
- /makefulltextfeed.php?key=[key]&max=[number of feed items]&url=[url]
All the parameters in the form above can be passed in this way. Examine the URL in the addressbar after you click 'Create Feed' to see the values.
Note: If you're not hosting this yourself, you do not have to rely on an external API if you don't want to — this is a free software (open source) project licensed under the AGPL. You're free to download your own copy.
Source Code and Technologies
The application uses PHP, PHP Readability, SimplePie, FeedWriter, Humble HTTP Agent. Depending on configuration, these optional components may also be used: Zend Cache, Zend DOM Query and IRI. Readability is the magic piece of code that tries to identify and extract the content block from any given web page.
System Requirements
PHP 5.2 or above is required. A simple shared web hosting account will work fine. The code has been tested on Windows and Linux using the Apache web server. If you're a Windows user, you can try it on your own machine using WampServer.
Download
Download from fivefilters.org - old versions are available in the code repository.
License
This web application is licensed under the AGPL version 3 — which basically means if you use the code to offer the same or similar service for your users, you are also required to share the code with your users so they can run it for themselves. (More on why this is important.)
The libraries used by the application are licensed as follows...