YahooBlogSearch
==============

Version 0.0.2 - 2007/04/12
- Fix bug in Sample Usage of Readme.

Version 0.0.1 - 2007/04/10

by Junya Ishihara <http://blog.champierre.com>  

== Overview

This plugin is a library to access Yahoo Blog Search RSS on Ruby on Rails.

== Installing

Run

  script/plugin install
  http://rails-workshop-tokyo.googlecode.com/svn/trunk/plugins/yahoo_blog_search

or checkout the source into your plugins folder.

  svn checkout 
  http://rails-workshop-tokyo.googlecode.com/svn/trunk/plugins/yahoo_blog_search

== Example Usage

=== Controller(yahoo_controller.rb)

  class YahooController < ApplicationController
    def blog_search
      #   Request parameters in Hash
      #    n  - Number of results retrieved per one request
      #    b  - Start number
      #    so - Sort Order(dd: Latest first, gd: Matched first)
      params = { :n => 10, :b => 1, :so => 'dd' }

      yahoo_blog_search = YahooBlogSearch.new('Search Keyword', params)
		
      # Get search results
      @results = yahoo_blog_search.results

      # Get request URL
      @req_url = yahoo_blog_search.req_url
    end
  end

=== View(web_search.rhtml)

  <h1>Yahoo#web_search</h1>
  Request URL: <%= @req_url %><br>
  <br>
  <%- unless @results.is_a?(Array) -%>
    Error: <%= @results %>
  <%- else -%>
    <%- @results.each do |result| -%>
      <p>
      <%= link_to result.title, result.link %><br>
      <%= result.description %><br>
      <%= "#{result.source}(#{result.sourceUrl}) - #{result.pubDate}" %>
      </p>    
    <%- end -%>
  <%- end -%>

== Documentation

You can create the documentation by running:

  rake rdoc

== Required files

open-uri rexml/document cgi kconv

== Links

Yahoo! JAPAN Blog Search http://blog-search.yahoo.co.jp

== License

This plugin is released under the MIT license.  See MIT-LICENSE for details.

== Feedback

Please leave a comment or send a trackback to

http://blog.champierre.com/archives/505