NAME
Dancer::Plugin::XML::RSS - Dancer plugin for using XML::RSS to parse or
create RSS feeds
VERSION
Version 0.01
INSTALLATION
To install this module, run the following commands:
perl Makefile.PL
make
make test
make install
SYNOPSIS
Allows access to XML::RSS object from inside of your Dancer application
and default configuration of XML::RSS using the standard Dancer
configuration file.
package MyDancerApp;
use Dancer 'syntax';
use Dancer::Plugin::XML::RSS;
# parse rss file and output
get '/show_news' => {
rss->parsefile( settings( 'news_feed' ) );
# grab entries for template
my @stories;
my $display_max = settings('news_feed_display') || 5;
for ( my $i = 0; $i <= $display_max; $i++ ) {
next unless exists rss->{items}->[$i]
and ref rss->{items};
push @stories, $item;
}
template 'news', { stories => \@stories };
};
get '/our_feed' => {
rss->channel(
title => 'My Special Site',
link => 'mysite.example.org',
description => 'A generic example for docs',
);
rss->add_item(
);
rss_output;
};
DESCRIPTION
Provides a simple way to parse RSS files by using `XML::RSS'. It will
hold onto currently parsed feed or keyword 'rss' will return object
instance for application use.
Using the 'rss_output' command it will first create correct content type
and then serialize object into RSS XML for use in route.
CONFIGURATION
XML:RSS configuration parameters will be taken from your `Dancer'
application config file. They should be specified as:
plugins:
'XML::RSS':
output: '0.9' # output as rss v0.9
See `XML::RSS' for more detail on configuration options.
SUBROUTINES/METHODS
rss('new')
Creates and returns XML::RSS object. It will be setup with any XML::RSS
options from configuration file.
After first call to rss existing XML::RSS object will be called to force
a new object pass 'new' to `rss'
'new' - optional string to force creation of new rss object
rss_output
Converts XML::RSS object into xml with correct content type and body.
Use for returning inside of route.
AUTHOR
Lee Carmichael, `<lcarmich at cpan.org>'
BUGS
Please report any bugs or feature requests to `bug-dancer-plugin-xml-rss
at rt.cpan.org', or through the web interface at
http://rt.cpan.org/NoAuth/ReportBug.html?Queue=Dancer-Plugin-XML-RSS. I
will be notified, and then you'll automatically be notified of progress
on your bug as I make changes.
SUPPORT
You can find documentation for this module with the perldoc command.
perldoc Dancer::Plugin::XML::RSS
You can also look for information at:
* RT: CPAN's request tracker (report bugs here)
http://rt.cpan.org/NoAuth/Bugs.html?Dist=Dancer-Plugin-XML-RSS
* AnnoCPAN: Annotated CPAN documentation
http://annocpan.org/dist/Dancer-Plugin-XML-RSS
* CPAN Ratings
http://cpanratings.perl.org/d/Dancer-Plugin-XML-RSS
* Search CPAN
http://search.cpan.org/dist/Dancer-Plugin-XML-RSS/
TODO
* Add configuration of output header with config file
* Use configuration file to setup details of channel for rss output
LICENSE AND COPYRIGHT
Copyright 2011 Lee Carmichael.
This program is free software; you can redistribute it and/or modify it
under the terms of either: the GNU General Public License as published
by the Free Software Foundation; or the Artistic License.
See http://dev.perl.org/licenses/ for more information.
SEE ALSO
`Dancer', `XML::RSS', `Dancer::Plugin', `Dancer::Plugin::Feed'