Rails | Vinsol - Leading Ruby on Rails Development and Consulting Firm in India

29 Mar 2010

Jquery Full Calendar with Ruby on Rails

RubyonRails, jquery, rails, ruby on rails posted by Akhil Bansal

Contrary to popular belief, working on a client project gives us a generous margin of creativity and explore innovative solutions. Take the example of a recent project I was working on. The client required a collaboration-based calendar module for their application similar to Google Calendar. Initially we started developing it from scratch , but then, we found an awesome Jquery plugin.

“FullCalendar” provides a full-sized, drag & drop calendar. It uses AJAX to fetch events on-the-fly for each month. It also supports an intuitive interface to manage events that spans over multiple days or weeks. It is visually customizable and exposes hooks for user-triggered events (like clicking or dragging an event).

I decided to give it a try and utilize its hooks for user triggered events within our Rails application. This small effort resulted in a barebone Rails app that might provide a good base for your project which require calendar, scheduling or appointment features. I called it fullcalendar_rails and it is now available on github with a working demo at http://fullcalendar.vinsol.com.

Feel free to give your valuable feedback. I hope you will find this useful.

Update: On popular demand, I have added recurring events functionality with daily, weekly and monthly frequencies. It also allows for exceptions to recurring events including delete and edit features.

29 Oct 2009

Integrating Yahoo! BOSS with your ruby on rails application

rails posted by amit

What is Yahoo! BOSS? Yahoo developer website cites it as:

“Yahoo! Search BOSS (Build your Own Search Service) is an initiative in Yahoo! Search to open up Yahoo!’s search infrastructure and enable third parties to build revolutionary search products leveraging their own data, content, technology, social graph, or other assets. This release includes Web, News, and Image Search as well as Spelling Suggestions.”

Some of the possible implementation of Yahoo! Boss may be finding related posts for your article, suggested tag/category for an article/query, correcting misspelled words by providing suggestions, fetching latest news on a topic dynamically, search over delicious tags, customized language search. Some of these have been tried and successfully implemented. An example is the TechCrunch’s Search Engine.

Here is a concise guide on how to use this new service in your next rails application.

Obtain API key

Get an application key from http://developer.yahoo.com/search/boss/.

Install BOSSMan Gem

BOSSMan is a gem for interaction with the Yahoo BOSS web service written by John Pignata. Install it using the following commands:

gem install gemcutter
gem tumble
gem install bossman

Usage

Put this in your environment.rb

require 'bossman'
include BOSSMan
BOSSMan.application_id = &lt;Your Application ID&gt;

Web Search

Use the following code to execute search over the web:

boss = Search.web(&quot;Apple Pie&quot;, { :count =&gt; 2, :filter =&gt; &quot;-hate&quot; })
puts &quot;Number of results: #{boss.totalhits}&quot;

boss.results.each do |result|
  puts &quot;#{result.title}&quot;
  puts &quot;#{result.dispurl}&quot;
  puts &quot;#{result.abstract}&quot;
end

# =&gt; Number of results: 2618888
# =&gt; &lt;b&gt;Apple&lt;/b&gt; &lt;b&gt;pie&lt;/b&gt; - Wikipedia, the free encyclopedia
# =&gt; &lt;b&gt;en.wikipedia.org&lt;/b&gt;/wiki/&lt;wbr&gt;&lt;b&gt;Apple&lt;/b&gt;_&lt;b&gt;pie&lt;/b&gt;
# =&gt; English &lt;b&gt;apple&lt;/b&gt; &lt;b&gt;pie&lt;/b&gt; recipes go back to the time of Chaucer. &lt;b&gt;...&lt;/b&gt; The basis of Dutch &lt;b&gt;apple&lt;/b&gt; &lt;b&gt;pie&lt;/b&gt; is a crust on the bottom and around the edges. &lt;b&gt;...&lt;/b&gt;

boss = Search.web(&quot;Moon&quot;, { :count =&gt; 10, :type =&gt; &quot;nonhtml,-pdf&quot; })

boss.results.each do |result|
  puts &quot;#{result.title}&quot;
  puts &quot;#{result.dispurl}&quot;
  puts &quot;#{result.abstract}&quot;
end

# =&gt; BACKGROUND:
# =&gt; www.&lt;b&gt;radford.edu&lt;/b&gt;/~rusmart/&lt;wbr&gt;&lt;b&gt;moon&lt;/b&gt;.doc
# =&gt; We noticed was that one of the scan lines took longer to scan the &lt;b&gt;moon&lt;/b&gt; then any other. This occurred toward the middle of the &lt;b&gt;moon&lt;/b&gt;. &lt;b&gt;...&lt;/b&gt;

boss = Search.web(&quot;Star&quot;, { :sites =&gt; &quot;wwe.com&quot;, :style=&gt;'raw' })
boss.results.each do |result|
  puts &quot;#{result.title}&quot;
  puts &quot;#{result.dispurl}&quot;
  puts &quot;#{result.abstract}&quot;
end

# =&gt; John Cena - WWE: Raw
# =&gt; www.&lt;b&gt;wwe.com&lt;/b&gt;/super&lt;b&gt;star&lt;/b&gt;s/raw/&lt;wbr&gt;johncena
# =&gt; Official profile from WWE for the professional wrestler John Cena, who has been training since he was 15. Features lots of photos and video clips, including John ...

Apart from universal arguments mentioned at the end of this document, the following arguments can also be used:

Parameters	Values/Description
`:filter`	Filter out adult or hate content Syntax: `:filter => "-hate, -porn"`
`:type`	Specifies document formats (pdf, msoffice,etc)
:view	Syntax: `:view => "view1,view2"`, etc `:view => "keyterms"` will retrieve related words and phrases for each search result. `:view => "searchmonkey_feed"` will retrieve structured data markup, if available, for the search result in dataRSS format. `:view => "searchmonkey_rdf"` will retrieve structured data markup, if available, for the search result in rdf format. `:view => "delicious_toptags"` will retrieve the top public delicious tags for a document and the counts associated with each tag `:view => "delicious_saves"` will retrieve the number of times a document was saved in delicious `:view => "language"` identifies the language of the document
:abstract	`:abstract => "long"` will retrieve and display an abstract of a web document up to 300 characters. This expanded abstract provides the requestor with a larger piece of information to work from in a web search query. The default for abstract is an abbreviated description.

Click here to view list of response fields returned by web search.

Fields	Details
`count`	Indicates how many results to show per page. The value shown in results is the smaller of the default or explicit “count” request argument value or the actual number of results in the response. The result set will include the requested “count” unless there are fewer than that number of matching documents.
`totalhits`	A result count that reflects no duplicates. The totalhits value is an approximation, and its value may change depending on the requested “start” and “count” values, because the approximation is adjusted as more exact result URLs are processed. A normal use for totalhits is to determine how many pages of results to offer in search result navigation. Since totalhits is an approximation, and the value may change as “start” increases on successive result pages, the result page navigation may need to be adjusted as a user browses result pages.
`deephits`	It returns an approximate count that reflects duplicate documents and all documents from a host. deephits, therefore, is invariably equal to or larger than TotalHits. The deephits value is normally used as an information display on a search result page, reporting how many total documents matched the search terms.
`abstract`	Abstract with keywords highlighted with HTML tags. abstract=long will retrieve and display an abstract of a web document up to 300 characters. This expanded abstract provides the requester with a larger piece of information to work from in a web search query.
`title`	Title with keywords highlighted with HTML tags
`url`	URL of result
`clickurl`	Returns a navigation URL that leads to the target URL for each result. A clickurl might lead through a redirect server, which provides Yahoo! with important usage data from search result sets.
`dispurl`	Returns the URLs of documents matching the query result. Use this field only for display purposes on result pages. To direct search users to the target document, use the clickurl value
`size`	Returns the document’s size in bytes
`date`	Returns date in YYYY/MM/DD format
`keyterms`	When `:view => "keyterms"` is used in query string the keyterms section is included in the response. This includes a list of related words and phrases with the `term` subheadings.
`searchmonkey_feed`	Using this field will retrieve structured data markup, if available, for the search result in dataRSS format.
`searchmonkey_rdf`	Using this field will retrieve structured data markup, if available, for the search result in RDF format.
`delicious_toptags`	Retrieves the top public delicious tags for a document and the counts associated with each tag.
`delicious_saves`	The number of times a document was saved in delicious.
`language`	The language of the document.

Images Search

For searching images on web, use the following code:

boss = Search.images(&quot;snow hills&quot;, { :dimensions =&gt; &quot;large&quot; })

boss.results.each do |result|
  puts &quot;#{result.url}: #{result.abstract}&quot;
end

# =&gt; http://www.amanita-photolibrary.co.uk/photo_library/BI_habitats/gb96_chiltern_hills_from_ivinghoe_snow_std.jpg: Copyright © 2004 Chiltern hills east from near Ivinghoe snow habitats landscapes British Isles

Click here for list of additional arguments that can be provided with image search.

Parameters	Values	Description
`:filter`	`yes` (default) or `no`	Whether or not to activate the Offensive Content Reduction filter. If set to yes, content marked as offensive is omitted from results.
`:dimensions`	`all` (default), `small`, `medium`, `large`, `wallpaper`, `widewallpaper`	Small images are generally thumbnail or icon sized. Medium sized images are average sized; usually not exceeding an average screen size. Large images are screen size or larger. Size pairs other than those listed are ignored.
`:refererurl`	URL, no default	Search for this URL. Depending on other query restrictions, returns all image objects with this referring URL. Example: http://www.foo.com/~foo/images.htm
`:url`	URL, no default	Search for this URL. Returns this exact image result. Example: http://www.foo.com/~foo/images/mydog.gif

Click here to view list of response fields returned by image search.

Field Name	Description
`totalhits, deephits`	Number of listings that match the query parameters.
`abstract`	Description of image
`clickurl`	URL to click to view image
`filename`	Filename of image
`size`	Size of image file
`format`	Format of image
`height`	Height of full-size image
`date`	Last modification date of image YYYY/MM/DD
`mimetype`	MIME type of image
`refererclickurl`	Clickable link to page in which image was found
`refererurl`	Original link to page in which image was found
`title`	Title of image (usually the filename)
`url`	URL of image itself
`width`	Width of full-size image
`thumbnail_url`	Thumbnail image
`thumbnail_height`	Thumbnail height
`thumbnail_width`	Thumbnail width

News Search

Yahoo! BOSS also provides news search capabilties.

boss = BOSSMan::Search.news(&quot;free shipping&quot;, { :age =&gt; &quot;1d-2w&quot;, :orderby =&gt; &quot;date&quot;, :count =&gt; 1})

boss.results.each do |result|
  puts &quot;#{result.title} [from #{result.source}]&quot;
  puts &quot;#{result.abstract}&quot;
end
# =&gt; Wal-Mart announces weekly price cuts for holidays [from USA Today]
# =&gt; Wal-Mart said it will cut prices this holiday season for a week at a time on thousands of items, from bananas to board games. The first group of cuts hit Wednesday.

Click here for list of additional arguments that can be provided with news search.

Parameters	Values	Description
`:age`	`7d`	Use age= to retrieve documents by age: `:age => "[value]d"` NOTE: Maximum [value] cannot be greater than 1000. The default is 30 days, and valid values are `[1-30]d`. (News Search maintains a 30-day index.) The following example searches the full index: `:age => "7d"` Age can be specified using a string made an integer and one of the letters “`s`“, “`m`“, “`h`“, “`d`” and “`w`” representing seconds, minutes, hours, days and weeks. No spaces are allowed in the string. Some examples: `:age => "30d"` `:age => "1w"` `:age => "12h"` To specify an age range two values can be concatenated with a dash/hyphen for example: `:age => "5d-10d"` Between 5 and 10 days old `:age => "2w-30d"` Between 2 weeks and 30 days old Multiple ranges or more than one age parameter is not supported.
`:orderby`	relevance	To order by date add `:orderby => "date"` to the query string. Results will be returned with the most recent first.

Click here to view list of response fields returned by news search.

Field Name	Description
`totalhits, deephits`	Number of listings that match the query parameters.
`abstract`	Abstract of news story.
`clickurl`	Click this link to reach story, if present.
`language`	Language of story.
`date`	Last publication date of story.
`time`	Last publication time of story.
`source`	Source publication.
`sourceurl`	URL of source publication.
`title`	Title (or Headline) of the story.
`url`	Link to story.

Spelling Search

Correct your misspelled words using its spelling suggestion feature:

boss = BOSSMan::Search.spelling(&quot;acknowlegment&quot;)
puts boss.suggestion # =&gt; acknowledgment

Site Explorer

You can also search for the pages from other sites linking into your site pages.

links = Search.se_inlink(&quot;http://mail.yahoo.com&quot;, :count =&gt; 2)
links.results.map { |result| p result.url }
# =&gt; http://www.aol.com/
# =&gt; http://groups.yahoo.com/

For displays a list of all pages belonging to a domain in the Yahoo! index, use se_pagedata method provided.

links = Search.se_pagedata(&quot;twitter.com&quot;, :count =&gt; 1)
links.results.map { |result| p &quot;#{result.url} - #{result.abstract}&quot; }
# =&gt; http://twitter.com/ - Use Twitter to send status updates (tweets) through your cell phone, instant messenger, or via the Web, and notify friends and followers of the little things &lt;b&gt;...&lt;/b&gt;

Universal Arguments for Web, Images and News

Following is the list of most commonly used arguments with web, image and news search. For more comprehensive list click here

Argument	Options/Details
`:start`	Ordinal position of first result. First position is 0. Default sets start to 0.
`:count`	Total number of results to return. Maximum value is 50. Default sets count to 10.
`:format`	The data format of the response. Value can be set to either `"xml"` or `"json"`. Default sets format to `"json"`.
`:callback`	The name of the callback function to wrap the result. Parameter is valid only if format is set to `"json"`. No default value exists.
`:sites`	Restrict BOSS search results to a set of pre-defined sites. Multiple sites must be comma separated. Example: (`:sites => "abc.com,cnn.com"`). The Images service does not yet support multiple sites.
`:view`	Retrieve additional search data provided by the respective BOSS service. Please see individual chapters to see what view options are available.
`:style`	By default for web search result titles and abstracts contain bold HTML tags around the search term. Use `:style => "raw"` to remove the bold tags around the search terms in titles and abstracts.

15 Feb 2009

Open Maturity Model – Let’s share Best Practices without auditors or certifications

rails, rmm posted by kapil

Nothing to do with OSMM (open source maturity model). There is some discussion going in rails community for Obie Fernandez post on idea of Rails Maturity Model.

I like the basic idea behind defining some sort of maturity model for rails but I don’t think RMM or anything like that should be modeled on CMM.

After spending hours looking at views of many people regarding RMM in blogosphere, twitter and rails business google group , I concluded that we might need some open system instead of something like RMM.

Following is an aggregation of views by various people who feel the need of a some model but dont like the idea of auditors, closed systems or certifications :

For time being , I am calling it Open Maturity Model and trying to draft some basic principles and guidelines.

So, What is Open Maturity Model ?

For Developers

1. Roadmap for Rails developers to adopt best practices defined by the community.

2. Community giving newcomers a more-or-less official set of guidelines for how to produce quality work. Having some sort of guideline from a trustworthy source is becoming more difficult.

3. It will not take fun out of rails or kills innovation. It will just make the rails community stronger and will attract more people who are not yet sure about rails.

4. Judge yourself , instead of an expensive auditor judging you – if you are serious about doing quality work, open maturity model will give you a good point to start with.

5. Let experienced developers share their experience on a common wiki in addition to blog posts about their experiences all on their own.

For Clients

1. A no nonsense, no lingo system to help a prospective client to choose a ROR shop. Give them more than just testimonials , a blog post, or a portfolio. The intent is to establish a minimum standard of operational efficiency so that clients who hire based on it can be sure they aren’t dealing with complete idiots.

2. Let’s share Business Knowledge – most development shops are busy coding and spend little to no effort on marketing or business development. Groups like rails business is a good start in this direction.

For Process

1. XP , SCRUM or whatever. One size doesnt fit all. At Vinsol, we follow a process which has evolved after lot of not-so-successful iterations. It works for us and we want to improve and share it with community. But we don’t want to call our process or anybody else’s practice “The Rails Way”. Again , a community website where companies can register and document the level of process they implement allowing for clients and other companies to provide feedback so they could get ranked.

2. Instead of wasting resources proving that we are level 4 or level 5 by an external auditor, lets just focus on why we are in the business – writing good quality code, having fun doing it and building awesome applications.

3. Continous improvement is very important for growth and survival of many rails companies with thousands of rails shops opening around the world.

Certifications

1. Replace open source projects with certification – open source can play the role of certification. Have you ever contributed or tried to contribute to rails core ? or, show us an interesting/useful open source project you started, or point to bugs that you submitted.

Looking for ideas and suggestions.

Update : Matthew Ford has started a rails manifesto document in github. Please add your best practices here – http://gist.github.com/65183