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'

You are viewing proxied material from ftp.icm.edu.pl. The copyright of proxied material belongs to its original authors. Any comments or complaints in relation to proxied material should be directed to the original authors of the content concerned. Please see the disclaimer for more details.