This page and the OPML Renderer are deprecated. In a few seconds, you will be automatically redirected to the page for Optimal, which now can be installed as a WordPress plugin.
OPML Renderer renders valid OPML from any source as an expandable/collapsible list.
XSL stylesheets are used to transform the OPML from XML to HTML. Two XSL stylesheets are included: one for use in pages or posts and one for use as a sidebar item .
OPML Renderer is invoked through either a new content filter or a new template function.
To access the content filter, use the following in a page or post (without spaces):
!OPMLRender : url,updatetime,page|sidebar
To access the template function, use the following:
<? OPMLRender('url','updatetime','page|sidebar'); ?>
- 'updatetime' is the number of seconds to cache a file before requesting an update
- 'page' or 'sidebar' indicates which XSL transform to use
Click here to download the latest version.
This is beta software, so please use with caution and report any problems.
Images are included as of version 0.5.
Thanks to iconophobia and the inlineRSS plugin for some code and ideas.
And great thanks to Dave Winer for his work on OPML.
Installation
- Unzip opmlRenderer.zip into your plugins directory. It should automatically create a new subdirectory.
- Activate the plugin.
That's about it!
You may want to edit the XSL stylesheets to use your own icons or change the appearance of the rendered HTML. Links to do so are provided in the plugin's description on the Plugin pane of the Admin panel.
Errata and Gotchas
I'm very sorry. At least I didn't destroy your data, right?
Changes
Thank you, Dan! I just send my hosting company an e-mail. I can’t wait to see the plugin working on my page 🙂
Thanks! Works great for me.
Hey Dan, just heard about your Optimal, came for a download.
While I’m here, I need to ask: is the latest Renderer the only one that has the RSS img button next to each file when it is expanded? Basically, I’m not sure what version I have right now.
Second, if you expand my list on my sidebar, you will notice that the 4-5 file down the list is not indented like the rest, is that something that can be rectified?
You the man, heading towards your Optimal now. Thx.
I see you’re not gonna answer for some reason but I’ll tell you anyway, renderer wouldn’t work in my new theme which has the sidebar on the left side because the click box was outside the margin (pushing it in with the CSS squcished everything together too close) so since you haven’t answered either question I had about Renderer or Optimal, I won’t be able to use either one (sounds just like Winer when he wouldn’t answer questions either). You people are so trying to get stuff out there but won’t help anybody do it and I’ve never even met either one of you, what the hell is the matter with you people? Jerks, that’s what the problem is. Winer and his trolls, guess I was right (you obviously read my post on DW, how shallow of you).
Billy, I don’t know you. I don’t know or care what you wrote about Dave Winer. My life doesn’t revolve around answering your questions that you should be able to answer yourself. I’ve been quite responsive to your many prior comments.
If you don’t like OPML Renderer, don’t use it. I made it for me, not for anyone else. I’m not selling anything here. This is my hobby, not a marketing tool.
If you thought your prior questions were going unnoticed, the polite thing to do (if your questions were so important) would have been to post a simple “nudge.”
If posting nasty comments about people on your blog makes you so paranoid that you think I’m trying to get back at you, you probably should stop posting nasty comments.
fine, forget the whole Dave thing and I realize that I’m not Mr #1 on your list or whatever but why put something out there and then not respond when someone posts a question that obviously sat on your site for over a week?
maybe you were on holiday or something at which point I’m sorry but I get so frustrated at stuff like this and I know it gives me a bad name but how else am I supposed to get hel because you’re right, I don’t know you?
I never said I didn’t like the Renderer, I loved it, I’m just letting you know that it doesn’t work on the left hand side for me (and I assumed you weren’t gonna answer that because you never answered the previous post about one of the links not working once it was expanded, even after deleting the first link that it happened to because I thought it may have had some bad characters which were throwing the alignment off on my end). How was I supposed to answer that myself when I don’t see the code being used because it is coming from your script and can’t do anything about it anyway? I was just trying to help by pointing out something I was seeing on my end but since you still haven’t acknowledged it, I assume it’s my end only for that one occurence 4 or 5 nodes down when expanding the list.
Sorry for all the trouble. I will definitely use it again if/when I go back to a right-handed sidebar theme.
I think you have a fundamental misunderstanding of what this is. I make no representations of any kind about this plugin or my support of any problems with the plugin. That’s the nature of software like this: caveat emptor. Hell, I hesitate to even call it “software,” since I’m not a developer, I’m just a hobbyist.
I just put this thing I’ve done for myself out in public in case someone else wants to do the same thing and finds my work helpful. I’m just sharing.
In so doing, I’ve also gone to lengths to which I wouldn’t ordinarily go to make it as easy as I can for users to help themselves. To wit, your left sidebar problem.
There is CSS in the rendered HTML that you can use to spindle and mutilate the results to an almost limitless extent. You’ve got the source code. As far as I’m concerned, asking for more is akin to asking me to design your website. If I’m in the wrong, then so be it.
As it is, I have spent nearly an hour of my day reading your comments from today, researching information to include in my responses, and writing my responses. For free. You’re welcome.
I’m sorry I caused all this trouble.
I did play with the CSS before coming here but it just pushed each link title too close together within the small space of the sidebar. Maybe it wasn’t going for the Renderer title itself where the expandable click box is (which is the only part sticking out).
Either way, I see that it is none of your concern and rightly so (this same situation has arisen at other sites as well), I guess I was just mad at myself for not figuring it out before coming here crying about it.
Peace.
Hi Dan,
Thanks for the nice plugins and OPML-thingies. I am playing around with the OPML Renderer now, and found it not working properly in the Lush theme I am using now. It does show the expanded feedlists, but the “clollapse” button doesn’t work.
I’m not a programmer either but I assume it’s something in the theme’s CSS that is causing this, since it does work when using the default WP theme. Would you have an idea where to look?
Thanks anyway.
Tibor,
I took a look at the Lush theme. It’s very nice looking, but it really hacks its way around the WordPress loop. The reason the OPML Renderer plugin doesn’t work is because the Lush theme does not use the wp_head() function in the header.php file. So no WP plugin that needs to add things to the <head> part of the HTML (such as JavaScript) will work. Try adding a call to wp_head() (i.e.,
<?php wp_head(); ?>) somewhere in header.php between the <head> tags and see if that solves the problem without breaking the theme. Then let the author of the theme know if it works.🙂 So far so good: the theme is in tact and the collapse feature works. THANKS!
I’ll update the author too.
Thanks indeed, until now, i had no idea what this wp_head() does. Will be included in further versions!
Woo! This has been a godsend. I have like 100 of blogs in my bloglines.com opml and being able to do it your way rocks. Now all that’s left for me to do is figure out how to nudge the contents of it over to the right about 10 pixels and i’m rockin.
I thought it didnt work because going to a bloglines OPML file shows nothing (Firefox). However if you view source, or save as, you can get the OPML file to import into your own rss reader.
Started with a simple file today and it looks good. But it shows only one feed at all. Could you please give me a hint? How I can display all feeds?
http://code.exploreourpla.net/2006/05/31/feeds.html
with this:
!OPMLRender:/wp-content/themes/mapWorld/media/eopFeeds.opml,1000,page
got it – the editor has to load the feed once, before it gets displayed.
Really great plugin, much power with one line of text.
Glad you worked that out, noiv. Thanks for the compliment.
I think I miss the trick.
What mechanism I have to use that updates my opml
file automatically with recent rss content?
Hi!
I’ve been trying to translate the chain “Contributors” into Spanish, but I just don’t find where it is stored… any help would be appreciated 🙂
Thanks in advance.
OK, just forget it! I’m so sorry. Your plugin is great, btw.
Hi again.
Is there any way to stop using the AJAX? I mean, I would like just the list, without all the expand stuff. In IE I get a problem everytime the list expands:
http://mirmorandum.es/mireando