1. Automatically downloads and attaches image to the node created by Feeds module.
2. Configurable XPath of the desired image location on the webpage of the feed item on per feed basis (using element’s id or CSS class).
3. Support for FileField Paths module.
4. Configurable maximum image size.
5. Configurable minimum and maximum image resolutions.

In this post, I will briefly demonstrate how to configure the settings for FIG to efficiently grab images for feed items.

Image Field Settings:

Feeds module will create nodes from feed-items of content type as chosen in the FeedsNodeProcessor settings. FIG will store the image grabbed in an image field attached to the node of this content type. Therefore, you must add an image field to this content type. For example, if the content type of feed-items is story, you need to go to admin > content types > story > manage fields and add a field of type File and widget Image. (http://drupal.org/node/609628)

Configure the settings of the image field, such as extensions, minimum and maximum resolution, maximum size, etc. While grabbing the image, FIG will automatically take into consideration the settings of the image field to which the downloaded image will be mapped.

Mapping Settings:

Now, you must go to the mapping settings for the Node Processor of the Feed Importer and map Item URL (Link) to one of the available imagefields which are appended by “(FIG)“.

Mapping for Node Processor

Feeds Image Grabber Settings:

After enabling FIG and configuring the above settings, you will see the following additional form whenever you create or edit a feed.

FIG config form

Here is a brief explanation of the available fields:

1. Enable Feeds Image Grabber: As the description says, check this box if you want FIG to download images of the feed items created by this feed.
2. Search for an image between the tag identified by: It has been explained before here.
3. Feeling Lucky: FIG will select the first image between the tag if the “yes” is selected, else will search for all the images to find the largest image between the tag.
4. Execution time: FIG will take the selected percentage of maximum PHP execution time to grab image for each feed item. If images are not grabbed for some feed, try increasing this percentage to decrease errors due to network timeouts.

That is all. Once you click on import, you will get the feed item nodes along with the images. If images are not grabbed, here is a list of possible reasons,

1. Timeout, try increasing the Execution time.
2. Malformed HTML source.
3. Validation failures (due to maximum size, minimum resolution, etc).

I am working on better error logging and reporting, so that you can know the reasons for sure.

Enjoy.

Related Posts:

• Feeds Image Grabber:  http://publicmind.in/blog/drupal-feeds-image-grabber
• FIG project page (Download): http://drupal.org/project/feeds_imagegrabber

[Google Reader (with thumbnails) can be imitated on a Drupal site by using Feeds, Feeds Image Grabber, FileField, ImageField, ImageCache, ImageAPI and Views module].

How it works
A classic method of mimicking the behavior of Feeds Image Grabber would be to do the same thing manually. Let us go through the procedure if you were to do it manually:

1. Refresh the feed to create nodes for feed items (using FeedsNodeProcessor).
2. For each feed-item, go to their respective webpage and save the image to display.
3. Upload the image to CCK image field for each feed item.

Feeds Image Grabber automates the last 2 steps of the three step process described. Imagecache module can be used to create thumbnail of the image retrieved which can be attached to the node.

What’s in the box
On 3rd March, first version of FIG was released. As of today, FIG supports following features:

1. Automatically downloads and attaches image to the node created by Feeds module.
2. Configurable XPath of the desired image location on the webpage of the feed item on per feed basis (using element’s id or CSS class).
3. Support for FileField Paths module.
4. Configurable maximum image size.
5. Configurable minimum and maximum image resolutions.

Get involved
You can get involved by doing any of the following:

1. write about this module, so that other folks can find it.
2. report bugs in the issue queue.
3. help in the support forums of the module.
4. buy me a Beer

Resources:

• Project Page (Download): http://drupal.org/project/feeds_imagegrabber
• Tutorials: http://publicmind.in/blog/tutorial-for-feeds-image-grabber

Note: Feature and Support requests should be made through the Feeds Image Grabber Forum. I may not be able to answer them here.

I get a lot of requests for this, so here is a tutorial explaining the 3 W’s (What, Why and How) of FeedAPI ImageGrabber.

Motivation

a feed item from google reader

This is a screenshot of a news item from my Google Reader. Anyone who has a moderate knowledge about the feeds would know that the image on the left in the above news-item is actually not published with the feed.

In other words, If you refresh any feed on your Drupal website using FeedAPI, you won’t get the image in the posts, unless they are published along with the feed which is quite rare.

The purpose of FeedAPI Imagegrabber is to make the feed more informative as well as interesting for the user. As, we all know that “comics are much better than novels”, this module appends the feed-item with an appropriate image from its content URL. The goal of the FeedAPI ImageGrabber is to mimic the thumbnail display of Google Reader for the feeds on your Drupal website.

As soon as you refresh the feed, ImageGrabber automatically attaches an appropriate image from the original article to the feed-item node on your website. You don’t even have to press an extra button!!

How it works
A classic method of mimicking the behavior of FeedAPI Imagegrabber will be to do the same thing manually. Let us go through the procedure if you were to do it manually:

1. Refresh the feed.
2. For each feed-item, go to their respective original URL and save the image to display.
3. For each node, crop the image, convert it into a thumbnail and then upload it in an CCK imagefield.

FeedAPI Imagegrabber automates the last 2 steps of the three step process described. You just need to refresh the feed and the ImageGrabber do the rest for you. The most difficult part which only humans can do is to select an appropriate image, for which I am constantly improving on the heuristics.

Download and Install
Download the latest release of FeedAPI ImageGrabber, compatible with your Drupal release, from the project page. Uncompress the folder in your site’s module directory and enable it from the admin/module page.

You are now ready to create new feeds with ImageGrabber enabled.

Next, you must install the following modules to get going:

• Imagefield
• Filefield
• CCK

You must then decide the content type for your feed-items for a particular feed and add CCK imagefields to that content type, before proceeding.

Form User Interface
You can enable the ImageGrabber for the feeds you want to download images for. When you add or edit any feed (i.e. feedapi enabled node), you will see the following additional settings for ImageGrabber:

Form Interface for ImageGrabber

Here is an detailed explanation of the input fields:

1. Enable ImageGrabber: Check this box if you want to enable ImageGrabber for this particular feed.
2. Select image field: ImageGrabber stores the downloaded image in a cck imagefield. You must select one of the imagefield from the drop-down menu.

If you receive this message “There are no imagefields associated with the ‘abcd’ content type.” , then you must add imagefield to the content type mentioned or change the content type of the feed-items to the one which has imagefields associated with it.

3. Search for an image between the tag identified by:
   To understand this, consider that the every feed-item associated with a particular feed has the following structure (HTML source code):
   

   HTML source code of a feed-item webpage

   For the above example, we know that the images associated with this particular post will always be within the

   1 2	<div class="post">...</div> tag

   Therefore, for this feed you must select the ‘class’ option here and enter ‘post’ in the text-field.
   Similarly, you must find out one such tag from the feed-items of the feed you want to create, see if it is identified by an id or an class. Then, select the appropriate option and enter the class or id in the text-field below. If you select None, the default tag will be ‘body’.

   simple way to find the id or class: Just find out the title of your article in the source code, and start looking for its parent/grandparent tags. Select the nearest parent which has an id or class.

   Now ImageGrabber will look for the images just between this tag, hence eliminating the download (and selection) of images in the sidebar or the header advertisement.

4. Enter the id or class (whatever you selected) in the text-field. Leave it empty if you selected the None option above.
5. Feeling Lucky: This has definitely been borrowed from the big devil Google. It will just select the first image it encounter between the tag specified, if ‘feeling lucky’ option is selected. Otherwise, it will select the largest image between the tags. I would personally recommend you to try out the ‘feeling lucky’ option as it helps saving a lot of bandwidth!! But if it doesn’t work for you, select the otherwise.

When you are done, just refresh the feed and you will see the images attached to the feed-item nodes.

Note: You can also modify your theme a little to get the Google Reader look in which the image floats on the left of the feed-item.

After refresh, you might get the following warning:

ImageGrabber: PHP execution time limit for system is 30 seconds, due to which images for some feed items couldn’t be downloaded. Please click on ‘Grab Images’ to refresh those feed-items.

If you get such a warning, no need to get afraid, just click on ‘Grab Images’ and the remaining feed-items will have their images as well. You may get multiple warnings depending upon your system’s execution time.

Enjoy grabbing images!!

Do leave a comment about this tutorial. Please make support and feature requests using support forums only.

Related Posts:

• FeedAPI ImageGrabber
• Feeds Image Grabber