Feeds

Last updated March 31, 2011. Created by alex_b on November 4, 2009.
Edited by lolmaus, arianek, eileenmcnaughton, iantresman. Log in to edit this page.

Overview

Feeds is a pluggable system for importing or aggregating content into Drupal. Out of the box, it supports

import or aggregation from RSS feeds, Atom feeds, OPML files or CSV files
import from an XML, or HTML document using the Feeds XPath Parser
generation of users, nodes, terms or simple database records
granular mapping (e. g. map the "author" column of a CSV file to a CCK field or map the title of an RSS feed item to a term name)
multiple simultaneous configurations organized in "Importers"
overridable default configuration for the most common use cases
"Feeds as nodes" paradigm as well as "Standalone" import forms
aggregation (periodic import) on cron
PubSubHubbub subscriptions
views-style exportables (using CTools)
a views-style plugin API (using CTools) providing a powerful API for rapidly adjusting Feeds to specific use cases on site builds: add other import sources or targets in a straightforward way
concurrent Feed aggregation with Drupal Queue

This documentation

This documentation is split into three parts:

The site builder's guide to Feeds

The site builder's guide explains core concepts in Feeds and walks you through how to configure Feeds to import or aggregate content from RSS, Atom or CSV as nodes, users, terms and more.

Check out the site builder's guide if you are new to Feeds and you are looking for instructions to get you started.

The developer's guide to Feeds

This section gives an introduction to Feeds' APIs and explains how to use them to address more complex use cases with Feeds.

This is for you if you are considering to write code that hooks into Feeds or if you are trying to fix a problem in Feeds and you need to get a quick overview of its architectural concepts.

The developer's guide builds on top of the site builder's guide to Feeds. If you are completely new to Feeds, start with the site builder's guide.

Feeds glossary

Feeds uses a series of terms in a specific way. Some examples are: Fetcher, Parser, Processor, Plugin, Scheduler, Importer. The glossary explains these terms.

Feeds contributed plugins

Overview of contributed fetchers, parsers and processors for feeds.

This section is for both site builders and developers.

Comments

Simplepie

Posted by SQP on May 18, 2010 at 12:23am

To enable simplepie, download it from http://simplepie.org/ copy the simplepie.inc into feeds/libraries like mentionned in the readme
And don't forget to clear the cache (admin/settings/performance) or you'll end up browse the code like me to understand why the option is still hidden

...or you can also use the

Posted by geerlingguy on November 21, 2010 at 7:25am

...or you can also use the Libraries API module, and put simplepie.inc inside sites/all/libraries/simplepie/ (so the end path would be sites/all/libraries/simplepie/simplepie.inc). Had to look in feeds.module to find that, and thought I'd post it here.

__________________
Me, to webchick, in IRC: "ice cream kittens!"
Work: Midwestern Mac, LLC | Personal: Life is a Prayer.com

Where to find simplepie.inc

Posted by mordaga on July 29, 2011 at 3:59am

The download link on simplepie.org is (at the time of this post) linked to an empty github directory.
I was able to find simplepie.inc at this location on github:
https://github.com/simplepie/simplepie/downloads

Also, when I tried to put simplepie.inc into sites/all/libraries/simplepie/ it did not show up as a parser option even after clearing all caches (same thing with sites/default/libraries/simplepie/).

It only worked when I uploaded it to modules/feeds/libraries.

I hope this saves someone else time in the future.

Feeds tutorial

Posted by wernerglinka on October 13, 2011 at 1:15am

I found a very good tutorial at: http://ring.ciard.net/consuming-agrifeeds-drupal-feeds

CSV Import Problem and Solution

Posted by corrie.potter on December 7, 2011 at 5:42pm

I tried various methods of getting a .csv file to import property and finally found that the problem is that the .csv file's fields did not have quotes around the fields when viewing in a text editor. The file that I got from a client was well formed but it was from ms excel. When I looked at the file in a text editor it was only comma separated instead of comma separated w/ quotes. I found that if you open the csv in Open office that it addes the quotes around each field. This made the file import properly into the feeds module. See below for more info.
MS Excel CSV - does not import

Title, Body, Date, Publisher
My Title, Body balh blah blah, 10-10-2012, MHS Press
My Title2, Body balh blah blah2, 11-11-2012, MHS Press2

Open Office CSV - imported properly

"Title", "Body", "Date", "Publisher"
"My Title", "Body balh blah blah", "10-10-2012", MHS Press"
"My Title2", "Body balh blah blah2", "11-11-2012", MHS Press2"