osdrv / is_it_iphone

non-official fork

is_it_iphone

• http://rubyforge.org/projects/isitiphone/

AUTHOR:

Damon Danieli ([email protected])

FEATURES/PROBLEMS:

• Fast & Lightweight
• Simple: I'm not smart enough to make something complex

DESCRIPTION:

This gem was inspired by the IsItMobile gem done by Dave Myron.

The code to check for the iPhone user agent is from http://developer.apple.com. This doesn't have any dependencies.

• in app/controllers/application.rb

  require 'is_it_iphone' class ApplicationController < ActionController::Base include IsItIPhone before_filter :adjust_format_for_iphone # Always show iPhone views end

You will have these functions:

iphone_user_agent?
  Returns true if the user agent is an iPhone.
  (as spec'ed on http://developer.apple.com)

iphone_request?
  Returns true if the request came from an iPhone.
  Override being an iPhone with ?format=xxxx in the URL.

adjust_format_for_iphone
  Call when you want to show iPhone views to iPhone users.
  Note: It is recommended by Apple that you default to showing 
  your "normal" html page to iPhone users and allow them to 
  choose if they want an iPhone version.

With Rails 2.0, you can use its multiview capabilities by simply adding this to your app:

• in config/initializers/mime_types.rb

  Mime::Type.register_alias "text/html", :iphone

Then, just create your views using suffices of iphone.erb instead of html.erb:

index.iphone.erb
show.iphone.erb
etc.

Note: you will probably want to use a Web library specific for iPhone applications. FWIW, I use Dashcode (in the iPhone SDK) to write and debug the iPhone application and then integrate it with my Rails project.

REQUIREMENTS:

None

INSTALL:

sudo gem install is_it_iphone

NOTE! Dont't forget to add/uncomment line Mime::Type.register_alias "text/html", :iphone in RAILS_ROOT/config/initializers/mime_types.rb after gem being installed. Otherwise you'll get exception "undefined method `ref' for nil:NilClass" without backtrace.

LICENSE:

Copyright (c) 2008

MIT Licence