 readme  id readmetxt v 13422 20101028 204412 alexb exp it feeds feeds an import and aggregation framework for drupal http drupalorg project feeds features pluggable import configurations consisting of fetchers get data parsers read and transform data and processors create content on drupal http upload with optional pubsubhubbub support file upload csv rss atom parsing creates nodes or terms creates lightweight database records if data module is installed http drupalorg project data additional fetchers parsers or processors can be added by an object oriented plugin system granular mapping of parsed data to content elements import configurations can be piggy backed on nodes thus using nodes to track subscriptions to feeds or they can be used on a standalone form unlimited number of import configurations export import configurations to code optional libraries module support requirements ctools 1x http drupalorg project ctools job scheduler 1x http drupalorg project jobscheduler drupal 6x http drupalorg project drupal php safe mode is not supported depending on your feeds importer configuration safe mode may cause no problems though php 52x recommended installation install feeds feeds admin ui to get started quick install one or all of the following feature modules feeds news feeds import feeds fast news more info below make sure cron is correctly configured http drupalorg cron go to import to import data to use simplepie parser download simplepie and place simplepieinc into feeds libraries recommended version 12 http simplepieorg feature modules feeds ships with three feature modules that can be enabled on admin build modules or if you are using features on admin build features http drupalorg project features the purpose of these modules is to provide a quick start for using feeds you can either use them out of the box as they come or you can take them as samples to learn how to build import or aggregation functionality with feeds the feature modules merely contain sets of configurations using feeds and in some cases the modules node views or data if the default configurations do not fit your use case you can change them on the respective configuration pages for feeds node views or data here is a description of the provided feature modules feeds news this feature is a news aggregator it provides a content type feed that can be used to subscribe to rss or atom feeds every item on such a feed is aggregated as a node of the type feed item also provided by the module what s neat about feeds news is that it comes with a configured view that shows a list of news items with every feed on the feed node s view items tab it also comes with an opml importer filter that can be accessed under import feeds fast news this feature is very similar to feeds news the big difference is that instead of aggregating a node for every item on a feed it creates a database record in a single table thus significantly improving performance this approach especially starts to save resources when many items are being aggregated and expired deleted on a site feeds import this feature is an example illustrating feeds import capabilities it contains a node importer and a user importer that can be accessed under import both accept csv or tsv files as imports pubsubhubbub support feeds supports the pubsubhubbub publish subscribe protocol follow these steps to set it up for your site http codegooglecom p pubsubhubbub go to admin build feeds and edit override the importer configuration you would like to use for pubsubhubbub choose the http fetcher if it is not already selected on the http fetcher click on settings and check use pubsubhubbub optionally you can use a designated hub such as http superfeedrcom or your own if a designated hub is specified every feed on this importer configuration will be subscribed to this hub no matter what the feed itself specifies libraries support if you are using libraries module you can place external libraries in the libraries module s search path for instance sites all libraries the only external library used at the moment is simplepie libraries found in the libraries search path are preferred over libraries in feeds libraries transliteration support if you plan to store files with feeds for instance when storing podcasts or images from syndication feeds it is recommended to enable the transliteration module to avoid issues with nonascii characters in file names http drupalorg project transliteration api overview see the developer s guide to feeds http drupalorg node 622700 testing see the developer s guide to feeds http drupalorg node 622700 debugging set the drupal variable feedsdebug to true i e using drush this will create a file tmp feeds mysitelocation log use tail f on the command line to get a live view of debug output note at the moment only pubsubhubbub related actions are logged performance see the site builder s guide to feeds http drupalorg node 622698 hidden settings hidden settings are variables that you can define by adding them to the conf array in your settingsphp file name feedsdebug default false description set to true for enabling debug output to drupaltmpdir feeds sitename log name feedsimporterclass default feedsimporter description the class to use for importing feeds name feedssourceclass default feedssource description the class to use for handling feed sources name feedsworkertime default 15 description execution time for a queue worker only effective if used with drupalqueue name feedsdata importerid default feedsdata importerid description the table used by feedsdataprocessor to store feed items usually a feedsdataprocessor builds a table name from a prefix feedsdata and the importer s id importerid this default table name can be overridden by defining a variable with the same name name feedsnodebatchsize default 50 the number of nodes feed node processor creates or deletes in one page load name httprequesttimeout default 15 description timeout in seconds to wait for an http get request to finish name feedsneverusecurl default false description flag to stop feeds from using its curl for http requests see httprequestusecurl glossary see feeds glossary http drupalorg node 622710  