noelrappin / tank-engine

A new plugin for creating Rails applications targeted for iPhones. A successor to rails_iui

This URL has Read+Write access

Fixing discrepancy in plugin directory name
noelrappin (author)
Tue Dec 09 12:05:14 -0800 2008
commit  cd20398221e5405bedae18a35592bb1a95a97d56
tree    e4d860373e3f99852ef31f0be53780c3bbe97ed7
parent  478057ca67deed3f35fdbb7b2f6e6777448b109c
name age
history
message
file .gitignore Fri Sep 19 14:07:41 -0700 2008 initial commit [noelrappin]
file MIT-LICENSE Fri Sep 19 14:07:41 -0700 2008 initial commit [noelrappin]
file README Fri Sep 19 14:07:41 -0700 2008 initial commit [noelrappin]
file Rakefile Fri Sep 19 14:07:41 -0700 2008 initial commit [noelrappin]
directory assets/ Fri Sep 19 14:07:41 -0700 2008 initial commit [noelrappin]
file init.rb Fri Sep 19 14:07:41 -0700 2008 initial commit [noelrappin]
file install.rb Fri Sep 19 14:07:41 -0700 2008 initial commit [noelrappin]
directory lib/ Fri Sep 19 14:07:41 -0700 2008 initial commit [noelrappin]
directory tasks/ Tue Dec 09 12:05:14 -0800 2008 Fixing discrepancy in plugin directory name [noelrappin]
directory test/ Fri Sep 19 14:07:41 -0700 2008 initial commit [noelrappin]
file uninstall.rb Fri Sep 19 14:07:41 -0700 2008 initial commit [noelrappin]
README
TankEngine
==========

A Rails toolkit for creating applications optimized for Mobile Safari, 
iPhone, and the iPhone touch. Based on the iUI look and feel library.

Contact
=======

Contact the author at noelrappin at gmail.com


Example
=======

This plugin uses jQuery to manage it's JavaScript needs. The jRails plugin
(http://ennerchi.com/projects/jrails) is recommended -- it converts Rails
Prototype/Scriptaculous helpers to jQuery.

After installing the plugin, perform

rake tank_engine:install

to copy the public assets (images, javascript, and CSS) to the public folder.

Tank engine places an iPhone layout file in app/views/layouts/application.iphone.erb.

Controller Usage
================

The module ActionController::IphoneController adds support for recognizing
Mobile Safari as the :iphone pseudo-MIME type. 

In your controller (can be ApplicationController) add the line

acts_as_iphone_controller

By default, the following requests are redirected to the iphone format.

* Requests with a user agent including "Mobile Safari". To change this 
default, pass the option :ignore_iphone_user_agent => true to 
acts_as_iphone_controller.

* Requests which end in ".iphone". To change this default, pass the option
:format => <YOURFORMAT> to acts_as_iphone_controller.

* Requests to a subdomain "iphone". To change this default, pass the option
:subdomain => <YOURFORMAT> to acts_as_iphone_controller.

The option :test_mode => true will cause all requests to be treated as iPhone
requests.

To capture these requests, you can use :iphone as part of a respond_to block:

respond_to do |format|
  format.html # show.html.erb
  format.xml  { render :xml => @feature }
  format.iphone
end

The file extension for the view is .iphone.erb

The module TankEngineHelper provides a number of helper methods for creating
iPhone structures in your views.

When this plugin is installed, form builders have a new helper "toggle" that
creates an iPhone style toggle switch.

Copyright (c) 2008 Noel Rappin, released under the MIT license