====== feedmod Plugin ======

---- plugin ----
description: Action plugin which modifies parts of the full HTML feed to make it suitable for blogging with DokuWiki
author     : Gina Häußge, Michael Klier, Rainer Kaufmann
type       : Action
lastupdate : 2023-02-04
compatible : Igor+
depends    : 
conflicts  : 
similar    : 
tags       : feed, rss, blog

downloadurl: https://github.com/kaufmannr/dokuwiki-plugin-feedmod/archive/refs/tags/2023-02-04.tar.gz
bugtracker : https://github.com/kaufmannr/dokuwiki-plugin-feedmod/issues
sourcerepo : https://github.com/kaufmannr/dokuwiki-plugin-feedmod
----

^ Download | [[https://github.com/kaufmannr/dokuwiki-plugin-feedmod/archive/refs/tags/2023-02-04.tar.gz|plugin-feedmod.tgz]] |
^ Github URL | see above |

===== Donate =====
Support the ongoing development of DokuWiki Plugins and Templates and [[https://www.paypal.com/xclick/business=chi%40chimeric.de&item_name=DokuWiki%2BPlugin%2BDonation&no_shipping=1&no_note=1&tax=0&currency_code=EUR&lc=US|buy Gina/Michael a coffee]] resp. [[https://www.buymeacoffee.com/Dieselschrauber|buy Rainer a coffee]] ;-)


===== Description =====
This [[devel:action_plugins|Action Plugin]] modifies the content of [[:DokuWiki|DokuWiki's]] **full HTML** feed to make it suitable for blogging purposes. It removes the first headline from the feed item body and sets it as feed item title. It also detects if the page uses the [[discussion]] plugin and adds a link to the discussion section after the feed item. It has also support for a custom footer template which gets added to each feed item. This can be used to add links to social bookmarking services for example (see [[#customization]]).

**Note:** The plugin modifies the feed only if two conditions are set, namely when the ''content'' is set to ''html'' and ''linkto'' is set to ''direct'' (see [[..syndication|syndication]]).
>> I had to set the kind of feed to RSS1.0 to make it work  --- //[[sebastian.5113109002@temporaryforwarding.com|seb_1204]] 2010/05/04 21:49//
===== Installation =====
Download the archive and unpack it into ''<dokuwiki>/lib/plugins''.
  
The plugin is also available via git.

<code>
% cd <dokuwiki>/lib/plugins
% git clone git://github.com/kaufmannr/dokuwiki-plugin-feedmod.git feedmod
</code>

===== Customization =====
The plugin has support for a custom //footer// template which gets added to every feed item. To get it working you have to create a file named ''_footer.txt'' below the plugin directory. The plugin contains a ''_footer.txt.dist'' file which contains some examples. The following replacement patterns can be used in this file.

^ @URL@ | Full url to the feed item |
^ @PAGE@ | Page id of the feed item |
^ @TITLE@ | Title (first headline) of the feed item |
^ @AUTHOR@ | Author of the feed item (wiki page) |

Here's a short example for social bookmarking services:

<file>
<a href="http://digg.com/submit?phase=2&url=@URL@" title="Digg this post">Digg this post</a> &middot;
<a href="http://www.stumbleupon.com/submit?url=@URL@" title="Digg this post">Stumble it</a> &middot;
<a href="http://del.icio.us/post/?url=@URL@" title="Save to del.icio.us">Save to del.icio.us</a>
</file>

===== Bugs / Feature Requests =====
Please report bugs and feature requests at the [[https://github.com/kaufmannr/dokuwiki-plugin-feedmod/issues|bug tracker]].

===== Changelog =====
A complete changelog is available [[https://github.com/kaufmannr/dokuwiki-plugin-feedmod/commits/|here]]

{{rss>https://github.com/kaufmannr/dokuwiki-plugin-feedmod/commits/master.atom date}}

===== Discussion =====