mobile-fu-for-jquery-mobile 1.0.1

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA1:
+  metadata.gz: 50c4cc0fbf36925216cc21a6812e19df5d644e61
+  data.tar.gz: a8ef319e70b57b77ad3dc362e3bde3fdd06d6134
+SHA512:
+  metadata.gz: 71ca7cdaa0b5ae01b4b062bd257edb8b879c7bec701dd939c06c6e28c7b7f124dce73139bdf895e8b35236fa5e652517765fdd476c767b18162e7a8017cd743c
+  data.tar.gz: 82327bb1cfd8e7fd62d0aebf8e30cf8811e0f97e4f6d83c99f5dc9c5180c2101613e0f4d70f5b4172df213249470ede36ca694b6b49f2f8972b582682807a73c

data/CHANGELOG

@@ -0,0 +1,113 @@
+commit a46e0d5ff0a95407bbd8f3437a372ced53d90c9b
+Author: Brendan G. Lim <brendan@intridea.com>
+Date:   Sat Dec 20 20:59:49 2008 -0500
+
+    Added a helper method to determine if a device is JavaScript enabled and one to output the XHTML Mobile 1.0 doctype
+
+commit f4b29b2e2c68a79b8904dddb7a91efd4341540ee
+Author: Brendan G. Lim <brendan@intridea.com>
+Date:   Sun Sep 21 21:39:10 2008 -0400
+
+    Fixes issue with 'in_mobile_view' instead of 'is_mobile_view' helper method
+
+commit 29e8e8b407dd3dc8d5f3248183223d11c6a78843
+Author: Brendan G. Lim <brendan@intridea.com>
+Date:   Wed Sep 10 12:51:12 2008 -0400
+
+    Updating CHANGELOG
+
+commit 0aac5bd7f0d2f71e6af7b144a04a18dad9f5aca5
+Author: Brendan G. Lim <brendan@intridea.com>
+Date:   Wed Sep 10 12:50:50 2008 -0400
+
+    Styling overrides for iPods
+
+commit f30c97c794ba74e737856aa9226328469c8395b6
+Author: Brendan G. Lim <brendan@intridea.com>
+Date:   Mon Sep 8 00:07:27 2008 -0400
+
+    Adding in some comments to the latest changes
+
+commit 78dae861e46d383356d7e4d6dfdaefbf60072e27
+Author: Brendan G. Lim <brendan@intridea.com>
+Date:   Mon Sep 8 00:06:16 2008 -0400
+
+    Updating README
+
+commit 1a66ccd2142e387f6d3138acb688a58df4687fcd
+Author: Brendan G. Lim <brendan@intridea.com>
+Date:   Mon Sep 8 00:05:48 2008 -0400
+
+    Adding in a helper method to check for a specific mobile device and adding in 'ipod' to the list of mobile user agents
+
+commit cbb26fff3287e16a757ee2aed2dcc8e98cbfb369
+Author: Brendan G. Lim <brendan@intridea.com>
+Date:   Fri Aug 22 22:16:19 2008 -0400
+
+    Updating the CHANGELOG
+
+commit ee49945b593b1c55bf546da1d595a0941d071f94
+Author: Brendan G. Lim <brendan@intridea.com>
+Date:   Fri Aug 22 22:16:00 2008 -0400
+
+    Updating README
+
+commit 02c12a8563466f7cef6aba8e53915dc2efec908c
+Author: Brendan G. Lim <brendan@intridea.com>
+Date:   Mon Aug 18 16:08:51 2008 -0400
+
+    Adding in support for Android
+
+commit 2dffa5958905c0419288d03a0650127a0734b41a
+Author: Brendan G. Lim <brendan@intridea.com>
+Date:   Sat Jul 26 14:08:56 2008 -0400
+
+    Adding in other phone user agents, including some Japanese and French manufacturers
+
+commit e8f9f1a9c2e668d639690f4f1beb4f701f742cfa
+Author: Brendan G. Lim <brendan@intridea.com>
+Date:   Fri Jul 18 11:15:52 2008 -0400
+
+    Adding in CHANGELOG
+
+commit a3122b40c0c722b2942e9cb5341614d0e0d834a5
+Author: Brendan G. Lim <brendan@intridea.com>
+Date:   Fri Jul 18 11:14:35 2008 -0400
+
+    Changes to README
+
+commit 64a24e36b6a770757963eb2d961262fb8a14ec1b
+Author: Brendan G. Lim <brendan@intridea.com>
+Date:   Fri Jul 18 11:10:40 2008 -0400
+
+    Quick fix
+
+commit 116fa5b7c1168471cf56cb9961b98f0b73fc3308
+Author: Brendan G. Lim <brendan@intridea.com>
+Date:   Fri Jul 18 10:04:41 2008 -0400
+
+    Fixed issue with mobile view session variable getting set incorrectly, when forcing mobile format
+
+commit d172665c9d0458801fd672076e269a3c0ee9d80d
+Author: Brendan G. Lim <brendan@intridea.com>
+Date:   Fri Jul 18 01:04:19 2008 -0400
+
+    Adding in more MIT license goodness
+
+commit a6c947d684d2d9abdbe354dc1ea757f23cd5a633
+Author: Brendan G. Lim <brendan@intridea.com>
+Date:   Fri Jul 18 01:00:55 2008 -0400
+
+    Change to the README
+
+commit dad4f4db1f3cb816283069a91c01982c953ff8a5
+Author: Brendan G. Lim <brendan@intridea.com>
+Date:   Fri Jul 18 01:00:16 2008 -0400
+
+    Change to the README
+
+commit c5ec9de6ef19e48a66917d8f6f3a59771295765b
+Author: Brendan G. Lim <brendan@intridea.com>
+Date:   Fri Jul 18 00:59:36 2008 -0400
+
+    Releasing Mobile Fu to the world

data/Gemfile

@@ -0,0 +1,4 @@
+source "http://rubygems.org"
+
+# Specify your gem's dependencies in mobile-fu.gemspec
+gemspec

data/Gemfile.lock

@@ -0,0 +1,102 @@
+PATH
+  remote: .
+  specs:
+    mobile-fu (1.3.1)
+      rack-mobile-detect
+      rails
+
+GEM
+  remote: http://rubygems.org/
+  specs:
+    actionmailer (4.0.2)
+      actionpack (= 4.0.2)
+      mail (~> 2.5.4)
+    actionpack (4.0.2)
+      activesupport (= 4.0.2)
+      builder (~> 3.1.0)
+      erubis (~> 2.7.0)
+      rack (~> 1.5.2)
+      rack-test (~> 0.6.2)
+    activemodel (4.0.2)
+      activesupport (= 4.0.2)
+      builder (~> 3.1.0)
+    activerecord (4.0.2)
+      activemodel (= 4.0.2)
+      activerecord-deprecated_finders (~> 1.0.2)
+      activesupport (= 4.0.2)
+      arel (~> 4.0.0)
+    activerecord-deprecated_finders (1.0.3)
+    activesupport (4.0.2)
+      i18n (~> 0.6, >= 0.6.4)
+      minitest (~> 4.2)
+      multi_json (~> 1.3)
+      thread_safe (~> 0.1)
+      tzinfo (~> 0.3.37)
+    arel (4.0.1)
+    atomic (1.1.14)
+    builder (3.1.4)
+    erubis (2.7.0)
+    hike (1.2.3)
+    httparty (0.11.0)
+      multi_json (~> 1.0)
+      multi_xml (>= 0.5.2)
+    i18n (0.6.9)
+    json (1.6.4)
+    mail (2.5.4)
+      mime-types (~> 1.16)
+      treetop (~> 1.4.8)
+    metaclass (0.0.2)
+    mime-types (1.25.1)
+    minitest (4.7.5)
+    mocha (1.0.0)
+      metaclass (~> 0.0.1)
+    multi_json (1.8.4)
+    multi_xml (0.5.5)
+    polyglot (0.3.3)
+    rack (1.5.2)
+    rack-mobile-detect (0.4.0)
+      rack
+    rack-test (0.6.2)
+      rack (>= 1.0)
+    rails (4.0.2)
+      actionmailer (= 4.0.2)
+      actionpack (= 4.0.2)
+      activerecord (= 4.0.2)
+      activesupport (= 4.0.2)
+      bundler (>= 1.3.0, < 2.0)
+      railties (= 4.0.2)
+      sprockets-rails (~> 2.0.0)
+    railties (4.0.2)
+      actionpack (= 4.0.2)
+      activesupport (= 4.0.2)
+      rake (>= 0.8.7)
+      thor (>= 0.18.1, < 2.0)
+    rake (10.1.1)
+    rdoc (3.12)
+      json (~> 1.4)
+    sprockets (2.10.1)
+      hike (~> 1.2)
+      multi_json (~> 1.0)
+      rack (~> 1.0)
+      tilt (~> 1.1, != 1.3.0)
+    sprockets-rails (2.0.1)
+      actionpack (>= 3.0)
+      activesupport (>= 3.0)
+      sprockets (~> 2.8)
+    thor (0.18.1)
+    thread_safe (0.1.3)
+      atomic
+    tilt (1.4.1)
+    treetop (1.4.15)
+      polyglot
+      polyglot (>= 0.3.1)
+    tzinfo (0.3.38)
+
+PLATFORMS
+  ruby
+
+DEPENDENCIES
+  httparty
+  mobile-fu!
+  mocha
+  rdoc

data/MIT-LICENSE

@@ -0,0 +1,20 @@
+Copyright (c) 2008 Brendan G. Lim, Intridea, Inc.
+
+Permission is hereby granted, free of charge, to any person obtaining
+a copy of this software and associated documentation files (the
+"Software"), to deal in the Software without restriction, including
+without limitation the rights to use, copy, modify, merge, publish,
+distribute, sublicense, and/or sell copies of the Software, and to
+permit persons to whom the Software is furnished to do so, subject to
+the following conditions:
+
+The above copyright notice and this permission notice shall be
+included in all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
+EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
+MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND
+NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE
+LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION
+OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION
+WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.

data/README.md

@@ -0,0 +1,159 @@
+Mobile Fu
+=========
+
+Want to automatically detect mobile devices that access your Rails application?
+Mobile Fu allows you to do just that.  People can access your site from a Palm,
+Blackberry, iPhone, iPad, Nokia, etc. and it will automatically adjust the format
+of the request from :html to :mobile or :tablet.
+
+Installation
+------------
+
+Simply add `gem 'mobile-fu-for-jquery-mobile'` to your Gemfile and run bundle install.
+
+Usage
+-----
+
+Add this this one line to the controller.
+
+```ruby
+class ApplicationController < ActionController::Base
+  has_mobile_fu
+end
+```
+
+Once this is in place, any request that comes from a mobile device will be
+set as :mobile format.  It is up to you to determine how you want to handle
+these requests.  It is also up to you to create the .mobile.erb versions of
+your views that are to be requested.
+
+If you do not want to set the format to :mobile or :tablet and only use the
+helper functions, pass false as an argument.
+
+```ruby
+class ApplicationController < ActionController::Base
+  has_mobile_fu false
+end
+```
+
+If you dont want to have all the methods respond to :mobile and :tablet, you can opt-in this actions
+using the following class method: `has_mobile_fu_for :action`
+Example:
+
+```ruby
+class YourAwesomeClass < ActionController::Base
+  has_mobile_fu
+  has_mobile_fu_for :index
+
+  def index
+    # Mobile format will be set as normal here if user is on a mobile device
+  end
+
+  def another_method
+    # Mobile format will not be set, even if user is on a mobile device
+  end
+```
+
+Mobile Fu automatically adds a new `:mobile` and `:tablet` to `text/html` mime type
+alias for Rails apps. If you already have a custom `:mobile` alias registered in
+`config/initializers/mime_types.rb`, you can remove that.
+
+I recommend that you setup a before_filter that will redirect to a specific page
+depending on whether or not it is a mobile request.  How can you check this?
+
+```ruby
+is_mobile_device? # => Returns true or false depending on the device or
+
+is_tablet_device? # => Returns true if the device is a tablet
+```
+
+You can also determine which format is currently set in by calling the following:
+
+```ruby
+in_mobile_view? # => Returns true or false depending on current req. format or
+
+in_tablet_view? # => Returns true if the current req. format is for tablet view
+```
+
+Also, if you want the ability to allow a user to switch between 'mobile' and
+'standard' format (:html), you can just adjust the mobile_view session variable
+in a custom controller action.
+
+```ruby
+session[:mobile_view] # => Set to true if request format is :mobile and false
+                           if set to :html
+
+session[:tablet_view] # => Set to true if request format is :tablet and false
+                           if set to :html
+```
+
+If you want to use the default response templates, like index.html.erb, instead of the index.tablet.erb you can
+exclude the tablet rendering from beeing used:
+you can create a `before_filter` and put it before the has_mobile_fu call
+
+```ruby
+before_filter :force_tablet_html
+has_mobile_fu
+
+def force_tablet_html
+	session[:tablet_view] = false
+end
+```
+
+Same will work for mobile, just change the `tablet` values to `mobile`
+
+So, different devices need different styling.  Don't worry, we've got this
+baked in to Mobile Fu.
+
+If you are including a css or sass file via `stylesheet_link_tag`, all you have
+to do is add _device to the name of one of your files to override your styling
+for a certain device.  The stylesheet that is loaded is dependant on which device
+is making the request.
+
+e.g., Accessing a page from a Blackberry.
+
+```ruby
+stylesheet_link_tag 'mobile.css'
+```
+
+This loads mobile.css, and mobile_blackberry.css if the file exists.
+
+Supported stylesheet override device extensions at the moment are:
+
+  * blackberry
+  * iphone (iphone,ipod)
+  * ipad
+  * android
+  * mobileexplorer
+  * nokia
+  * palm
+
+The stylesheet awesomeness was derived from [Michael Bleigh's browserized styles](http://www.intridea.com/2007/12/9/announcing-browserized-styles)
+
+Inspiration for Mobile Fu came from [Noel Rappin's rails_iui](http://blogs.pathf.com/agileajax/2008/05/rails-developme.html)
+
+Hopefully this should help you create some awesome mobile applications.
+
+Testing Mobile Interface
+------------------------
+
+If you want to force the mobile interface for testing, you can either use a
+mobile device emulator, or you can call `force_mobile_format` in a before filter.
+
+```ruby
+class ApplicationController < ActionController::Base
+  has_mobile_fu
+  before_filter :force_mobile_format
+end
+```
+
+You can also force the tablet view by calling `force_tablet_format` instead
+
+```ruby
+class ApplicationController < ActionController::Base
+  has_mobile_fu
+  before_filter :force_tablet_format
+end
+```
+
+Copyright (c) 2008 Brendan G. Lim, Intridea, Inc., released under the MIT license

data/Rakefile

@@ -0,0 +1,77 @@
+require 'bundler/gem_tasks'
+require 'rake/testtask'
+require 'json'
+require 'httparty'
+
+MOBILE_DETECT_JSON = 'https://raw.github.com/serbanghita/Mobile-Detect/master/Mobile_Detect.json'
+TABLET_FILE        = 'lib/mobile-fu/tablet.rb'
+
+task :default => [:test]
+
+Rake::TestTask.new do |t|
+  t.libs.push 'lib'
+  t.test_files = FileList['spec/*_spec.rb', 'spec/mobile-fu/*_spec.rb']
+  t.verbose = true
+end
+
+desc "Pull in data from Mobile Detect"
+task :pull_mobile_detect_data do
+  
+  # call out to Mobile Detect to get the data
+  content = HTTParty.get(MOBILE_DETECT_JSON).body
+
+  # build a new tablet regex
+  data      = JSON.parse content
+  regexes   = data['uaMatch']['tablets'].each.map { |_, v| v }
+  new_regex = regexes.join('|').downcase
+
+  # rewrite the tablet regex in our file
+  new_content = File.read(TABLET_FILE).gsub!(/TABLET_USER_AGENTS = \/.*\//, "TABLET_USER_AGENTS = \/#{new_regex}\/")
+  File.open(TABLET_FILE, 'w') { |f| f.write new_content }
+
+end
+
+
+# desc 'Generate documentation for the mobile_fu plugin.'
+# Rake::RDocTask.new(:rdoc) do |rdoc|
+#   rdoc.rdoc_dir = 'rdoc'
+#   rdoc.title    = 'MobileFu'
+#   rdoc.options << '--line-numbers' << '--inline-source'
+#   rdoc.rdoc_files.include('README')
+#   rdoc.rdoc_files.include('lib/**/*.rb')
+# end
+
+desc "Update asset files for Rails"
+task :update_assets do
+
+  Dir.glob(File.join('app/assets/stylesheets', '*.css')).each do |css_file_name|
+    # rename css file
+    css_file_name_out = css_file_name.split('-').first + '.css.scss'
+    File.rename(css_file_name, css_file_name_out)
+    # update image reference
+    file_content = ''
+    File.open(css_file_name_out, "r:UTF-8") do |file|
+      file_content = file.read
+    end
+    file_content.gsub! /url\(images\/icons-png\/([A-Za-z0-9_-]*\.)(png|gif)\)/ do
+      "image-url(\"jquery-mobile/icons-png/#{$1}#{$2}\")"
+    end
+    file_content.gsub! /url\(images\/([A-Za-z0-9_-]*\.)(png|gif)\)/ do
+      "image-url(\"jquery-mobile/#{$1}#{$2}\")"
+    end
+    File.open(css_file_name_out, 'w') do |file|
+      file << file_content
+    end
+    puts "Renamed and updated #{css_file_name_out}"
+  end
+
+  Dir.glob(File.join('app/assets/javascripts', '*.js')).each do |js_file_name|
+    # rename js file
+    if js_file_name.include? "-"
+      js_file_name_out = js_file_name.split('-').first + '.js'
+      File.rename(js_file_name, js_file_name_out)
+      puts "Renamed #{js_file_name_out}"
+    end
+  end
+
+end