rss_dot_php, a small script to show your feeds on your site

[vvinrg]

so, picture this: you've got all these posts everywhere. a wordpress, a youtube, a mastodon, a jekyll site, and more. you want a way to show all of them to anyone who comes to your site, and you don't want to use javascript. you've come to the right place!

rss_dot_php is a simple (~200 lines) PHP script for rendering your various feeds on one page. it supports RSS and Atom, and can have custom styles applied. it also allows users to filter out whatever feeds they dont want to see. it's designed to be thrown into an iframe somewhere on your site.

If you're curious what it looks like when styled and configured, my homepage has an instance

Install Guide:

to use it, you'll need a server with PHP support, or someone willing to host a single PHP script for you. I built this with the intention of doing the latter for a friend.

you should also have some basic knowledge of PHP syntax, but if you need help, I will be watching this thread.

first, download the script. save it somewhere on your computer, and open it in your text editor of choice.

there are 2 sections to edit, the first contains your feeds, and the second contains general config stuff. the script has 2 example feeds by default, "Dreamwidth News" and "OTW News". you can delete these, and add your own. every feed needs, at minimum, a URL. you can set this like so:

Code

$feeds[<name of your feed>]["url"] = <url of the RSS or Atom file>

every key in the $feeds array is used as the name for the given feed.

besides ["url"], the following config options are also supported:

Code

// how many seconds to wait before refreshing the feed data.
// defaults to 1 hour.
$feeds[<feed>]["ttl"] = <seconds>

// which rel= value to prefer on links, when reading links from an Atom feed
// defaults to "alternate"
$feeds[<feed>]["linkrel"] = <rel= value>

// a homepage for the feed, that gets linked to under everything from it.
// no default.
$feeds[<feed>]["home"] = <URL>

then, once you have the feeds configured, you may want to edit the config section just below. in particular, custom CSS can be put in the part that looks like

Code

/// Custom CSS
$config["custom_css"] = <<<'EOC'

/* custom CSS goes here! */

EOC;

the contents will be included verbatim in a <style> tag in the header.

finally, save the file with your edits, and put it anywhere. it can be set in the src= value of an iframe, and it wil just-work.

I hope this is useful to folks!

[invader_gvim]

I really love love love love this idea because my website already shows my melonland posts and I currently do it via just html. Do you know if neocities allows me to use php scripts? 

I really love the hard work you have contributed in writing this