• View
• Edit
• History
• Attach
• Print
• Backlinks

RSSSimple

Problem

PmWiki is cool for content, but Dolph wanted a simple solution to create a single blog-like wiki-page with RSS feed.

Solution

You can use rsssimple-1.2.phpΔ to create a valid RSS 2.0 feed of a single page without the need for a wiki-trail.

However, you must use a specific but very easy syntax on the wiki-page.

Sample Syntax of a Main.Blog Site:

    !:: Blog

    Here goes some text. You can describe your blog here, but it will be
    skipped in the feed. Everything depends on level three (!!!) headings.

    Let me explain it a bit more:
    The RSS channel options are defined in the rsssimple.php script. But
    every RSS item is extracted from the wikipage by separating the page
    into chunks between !!! headings. The heading itself will be the
    item-title. Everything up to the next !!! heading will be in the
    item-description.

    The date/time in the heading is also very important. Be sure it matches
    the date given at the beginning of the level 3 heading (see below).

    You can also give a RSS-link like that to your readers: \\
    [[http://www.mysite.com/pmwiki2/pmwiki.php/Main/Blog?action=rsss | RSS-Feed]]


    !!!2005-08-16 22:05 :: blog item 4 [[#a2005-08-16T22:05]]
    Some text that will be shown. The anchor above is for emulating
    the permalink feature of other blogs. You can skip that anchor
    if you like.

    !!!2005-08-16 14:30 :: blog item 3 [[#a2005-08-16T14:30]]
    Another blog entry. Full '''wiki-syntax''' is supported [[Main.HomePage | here]].

    Note, that you can also specify the time if you like.

    !!!2005-08-14 :: blog item 2 [[#a2005-08-14]]
    And another one.

    You can make paragraphs too.

    !!!2005-08-13 :: first blog item [[#a2005-08-13]]
     Welcome to my blog!

Installation

1. Download rsssimple-1.2.phpΔ
2. Copy rsssimple-1.2.php to your cookbook directory
3. Configure the settings in rsssimple-1.2.php
4. Add to your local/config.php: if ($action == 'rsss') { include_once("cookbook/rsssimple-1.2.php"); }
5. Enable clean URLs in your local/config.php: $EnablePathInfo = 1;
6. Create a page with the specific syntax
7. Test the RSS-Feed by adding ?action=rsss to your sites URL

Older versions

• rsssimple-1.1.phpΔ
• rsssimple-1.0.phpΔ

Notes and Comments

Mark Matienzo (26.07.2006):

• I added support for the guid tag.

Jens Rosenfeld (09.09.2005):

• For users which use umlauts:

Change this line

### RSS 2.0 definitions
SDV($RssChannelFmt,'<?xml version="1.0"?'.'>

to:

### RSS 2.0 definitions
SDV($RssChannelFmt,'<?xml version="1.0" encoding="iso-8859-1"?'.'>

for international umlauts support.

       $anchor = str_replace('[[# -> ', '', $anchor[0]);