tworgy-rails 0.2.0 → 0.3.0

data/lib/tworgy/iphoneification.rb

@@ -0,0 +1,98 @@
+# The following code is copies from the following repository (with a tweak or two)
+# git://github.com/jameswilding/iphoneification.git
+
+module IPhoneification
+  
+  # Class methods are added to ActionController::Base so you can do:
+  #
+  #   class ApplicationController < ActionController::Base
+  #     responds_to_iphone
+  #     ...
+  #   end
+  #
+  # Use +responds_to_iphone!+ (with the bang) instead to make your app act
+  # like an Apple fanboy, always serving iPhone views even if your visitors
+  # are using some other browser.
+  module ClassMethods
+ 
+    # #responds_to_iphone sets up the before-filter which checks for iphone requests
+    # and adjusts the request format accordingly.
+    #
+    # You can then use +respond_to+ in your controllers to serve
+    # iPhone-optimised views:
+    #
+    #   def index
+    #     @posts = Post.all
+    #     
+    #     respond_to do |format|
+    #       format.html   # renders posts/index.html.erb
+    #       format.iphone { some_special_code_for_iphone_requests } # renders posts/index.iphone.erb
+    #     end
+    #   end
+    #
+    # Use the extension '.iphone.erb' for your iPhone views and templates.    
+    #
+    # ==== Options
+    # Pass in any options appropriate for +before_filter+.
+    def responds_to_iphone(options = {})
+      before_filter :adjust_format_for_iphone_requests, options
+    end
+    
+    # Makes a controller act like _every_ request is from an iPhone. 
+    #
+    # ==== Options
+    # Pass in any options appropriate for +before_filter+.
+    def responds_to_iphone!(options = {})
+      before_filter :ensure_format_is_iphone, options
+    end
+    
+    # Skips the iphoneification before_filter set by #responds_to_iphone or #responds_to_iphone!.
+    #
+    # ==== Options
+    # Pass in any options appropriate for +before_filter+.
+    def skip_iphone_response(options = {})
+      if self.filter_chain.any? { |f| f.method == :ensure_format_is_iphone }
+        skip_before_filter :ensure_format_is_iphone, options
+      else
+        skip_before_filter :adjust_format_for_iphone_requests, options
+      end
+    end
+    
+  end
+  
+  # Just some utility methods.
+  module InstanceMethods    
+    
+    private
+
+    # Sets request.format to :iphone if request is from an iPhone.
+    def adjust_format_for_iphone_requests
+      set_format_to_iphone if iphone_request?
+    end
+    
+    # Just sets format to :iphone, whatever.
+    def ensure_format_is_iphone
+      set_format_to_iphone # always
+    end
+    
+    # Rails uses request.format in +respond_to+ blocks, and other places: 
+    # this is where the magic happens.
+    def set_format_to_iphone
+      request.format = :iphone
+    end
+
+    # This method looks at the browser's user-agent string to determine
+    # whether or not the current request is from an iPhone (or iPod Touch).
+    def iphone_request?
+      (agent = request.env["HTTP_USER_AGENT"]) && agent[/(Mobile\/.+Safari)/]
+    end
+    
+  end
+end
+
+Mime::Type.register_alias "text/html", :iphone
+ 
+if defined?(ActionController::Base)
+  ActionController::Base.send(:extend, IPhoneification::ClassMethods)
+  ActionController::Base.send(:include, IPhoneification::InstanceMethods)
+end

data/lib/tworgy-rails.rb

@@ -1,3 +1,4 @@
 require 'tworgy/active_record'
 require 'tworgy/routing'
+require 'tworgy/iphoneification'
 

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification 
 name: tworgy-rails
 version: !ruby/object:Gem::Version 
-  version: 0.2.0
+  version: 0.3.0
 platform: ruby
 authors: 
 - Mat Holroyd
@@ -9,7 +9,7 @@ autorequire:
 bindir: bin
 cert_chain: []
 
-date: 2009-11-02 00:00:00 +11:00
+date: 2010-02-26 00:00:00 +11:00
 default_executable: 
 dependencies: 
 - !ruby/object:Gem::Dependency 
@@ -37,6 +37,7 @@ files:
 - Rakefile
 - lib/tworgy-rails.rb
 - lib/tworgy/active_record.rb
+- lib/tworgy/iphoneification.rb
 - lib/tworgy/routing.rb
 - spec/spec.opts
 - spec/spec_helper.rb