Google Chart

Google Chart的优点是接口简单，容易上手，但是缺点也很明显，需要依赖Google的服务，在有些地方加载可能会存在速度问题，并且有被GFW的风险。

Google Chart的Rails插件很多，个人比较喜欢mattetti的googlecharts：

• googlecharts: http://github.com/mattetti/googlecharts
• gchartrb：http://code.google.com/p/gchartrb
• google-charts-on-rails：http://code.google.com/p/google-charts-on-rails/
• gc4r：http://code.google.com/p/gc4r/

Google Visualization

Google Visualization是Google Chart的升级版，Rails插件：http://github.com/mwarnock/rails-google-visualization-plugin

Gruff

Gruff是基于RMagick的Ruby绘图工具，功能强大，可扩展性和可定制性都非常好，不过由于Gruff需要在服务端实时生成图片，因此不适合实时展示数据。

Gruff还有一个JS封装bluff：http://bluff.jcoglan.com/

Flot

Flot是一个jQuery插件，可以基于JS生成实时图表，如果你使用jQuery，那么Flot是个不错的选择。Flot有一个很好用的Rails插件插件Flotilla: http://github.com/joshuamiller/flotilla

GNUPlot

GNUPlot最初是为学术目的使用的数据可视化工具，但是现在也支持生成非交互式的2d和3d图形，如果你需要生成非常复杂的图形，那么可以试试gnuplot，GNUPlot有一个叫rgplot的rubygem可以使用：http://rgplot.rubyforge.org

Ziya

Ziya是一个Rails图表插件，可以生成非常漂亮和复杂的Flash图表，如果你不介意Flash，那么Ziya是个不错的选择。

Scruffy

Scruffy是一个Rubygem，它的目标是帮你生成高质量的SVG和PNG图片，同Gruff一样，是一个服务端解决方案，不过Scruffy目前似乎已经停止开发了，首页的图片在Firefox和Chrome下均无法显示。

Highcharts

感谢dxiao同学留言，Highchars是一个纯JS的图表库，但是实现的效果却和Flash不相上下，相当绚丽，兼容性也很不错，并且有一个Rails的插件可以用，值得一试。

Raphaeljs

感谢Quake推荐，Raphael也是一个非常不错的JS绘图控件，他的核心库是raphaeljs，一个画图工具，详情可以看官方网站 : http://g.raphaeljs.com/

Flash

除了上面介绍的Ziya，Flash图表解决方案还有很多，下面列举几个对Rails支持比较好的：

• Open Flash Chart II：http://pullmonkey.com/projects/open_flash_chart2/
• Fusion Charts Free：http://www.fusioncharts.com/free/
• maani.us xml/swf charts：http://www.maani.us/xml_charts/
• amcharts： http://www.amcharts.com/，archarts有一个很好用的Rails插件：ambling

参考：http://stackoverflow.com/questions/87561/what-is-your-preferred-way-to-produce-charts-in-a-ruby-on-rails-web-application

无觅猜您也喜欢：
升级到Rails 3 Beta	Rails性能优化简明指南	Shanghai on Rails线下活动	Shanghai on Rails 7.26活动照片，PPT及视频
无觅

安装

sudo gem install ar_mailer_rails

使用

script/rails generate ar_mailer_rails3 Email

你也可以将Email替换为其它名字，邮件将会被保存到这个Model中。

Generator会自动生成一个initializer：


# config/initializers/ar_mailer.rb
ActionMailer::Base.add_delivery_method :active_record,
    ArMailerRails3::ActiveRecord, :email_class => Email
ActionMailer::Base.delivery_method = :active_record


如果你不希望所有Mailer都使用ActiveRecord发送，也可以在Mailer中单独定义：


class MyMailer < ActionMailer::Base
   self.delivery_method = :active_record
end


命令行的使用方式和ar_mailer是一样的，只不过为了和ar_mailer 2保持兼容，命令行的程序变成了ar_mailer_rails3:

$ ar_sendmail_rails3 -h

详细的使用方法可参看这里

无觅猜您也喜欢：
升级到Rails 3 Beta	Shanghai on Rails线下活动	Rails性能优化简明指南	Shanghai on Rails 7.26活动照片，PPT及视频
无觅

安装

$ gem install douban

使用

1. 修改Gemfile:


gem 'douban', :require => 'oauth'
require 'douban'


2. 运行generator

$ script/rails generate douban

3. 修改config/douban.yml, 并在ApplicationController中包含DoubanHelper:


class ApplicationController
  include DoubanHelper
end


4. 然后在你的application layout中加入：


<% if douban_authorized? %>
  <%= link_to '注销豆瓣登录', douban_logout_path %>
<% else %>
  <%= link_to "使用豆瓣帐号登录", douban_login_path %>
<% end %>


还可以使用下面的Helper:

• douban_auth_or_login_required, 方便和RESTFUL_AUTH一起使用
• douban_auth_required, 可以作为before_filter使用

5. 要访问用户资源，可以调用：


douban.get('/people/yzhang')
douban.post('/reviews', review)


6. 要验证用户是否已授权，可以调用:


douban.authorized?
=> true # 如果已经获得access token


无觅猜您也喜欢：
升级到Rails 3 Beta	Rails性能优化简明指南	Rails Templates	Shanghai on Rails 7.26线下活动
无觅

安装

$ script/plugin install git://github.com/yzhang/kuaiqian.git

使用

1. 安装完成后，插件会自动在你的应用的config目录创建一个kuaiqian.yml文件，默认是快钱提供的测试帐号（关于测试帐号的使用方法请参看测试章节）。将kuaiqian.yml中的商户ID和密钥替换为快钱提供给你的真实ID和密钥然后进行下一步。

2. 下面的代码会创建一笔新订单：


@request = Kuaiqian::Request.new('产品名称', # 产品名称
            1, # 订单ID，必须全局唯一
            Time.now.strftime("%Y%m%d%H%M%S"), # 订单生成时间，格式为20091104174132
            4500, # 订单金额，以分为单位
            'http://return', # 通知地址，用户支付成功后快钱会通过此地址通知商户支付结果
            '00', # 支付类型，00显示所有方式，10只显示银行卡方式，11只显示电话银行方式，12只显示快钱帐户支付方式，13只显示线下方式
            'attach') #自定义数据，会在返回URL中原样返回
redirect_to @request.url


上面的代码会将用户重定向到快钱的支付页面。

3. 在用户完成支付后，快钱会调用你在支付请求中提供的返回URL：


@response = Kuaiqian::Response.new(params)
if @response.successful?
  # 支付成功
else
  # 支付失败
end


注意，快钱可能会多次调用你的返回URL，并将结果展现给用户，因此你的代码要考虑多次执行后的输出对用户的有好度。

同时Response还提供了以下方法供用户检查响应的有效性：


pay_amount # 用户实际支付金额
bank_name # 银行名称
bank_deal_id # 银行交易ID
deal_id # 订单在快钱系统中的ID
order_id # 订单ID
order_time # 订单时间
order_amount # 订单金额
fee # 快钱收取的手续费，以分为单位
deal_time # 快钱对交易进行处理的时间
ext1 # 用户自带的数据


测试

要使用快钱提供的测试商户ID和密钥，需要修改你的hosts文件，将快钱的域名指向测试服务器：

218.242.247.5 www.99bill.com

然后使用下面的帐号进行支付：

用户名：kquser02@sina.com
密码：99bill

最后，必须也抱怨一下快钱，开发者社区没有忘记密码功能，提供的测试工具不能用，FAQ没有排版，所有问答都在一行，并且测试环境的信息不在开发文档里，而是在FAQ的最后一个问题里，实在是愁人的很。

无觅猜您也喜欢：
升级到Rails 3 Beta	Rails性能优化简明指南	Shanghai on Rails 7.26线下活动	Rails Cookie测试
无觅

安装


$ script/plugin install git://github.com/yzhang/tenpay.git


使用

1. 插件安装后，会在你的config目录下创建一个tenpay.yml文件（默认是腾讯提供的测试帐户，往这个帐户付款它居然真的就收了，虽然只是1分钱），你需要修改这个文件，填入你从腾讯申请的商户号（spid）和密钥（key）。

2. 下面的代码演示如何创建一个新交易:


@request = Tenpay::Request.new('测试产品', # 产品名称
      1, # 订单编号，需要保证全局唯一
      4500, # 产品价格，以分为单位
      'http://return', # 用户完成支付后返回的URL, 支持Get/Post
      request.remote_ip, #用户IP，用户production模式下检验用户，development模式忽略。
      'attach data') # 商户数据，会原样传递给返回URL，可不填
redirect_to @request.url

用户访问这个action的时候会被引导到支付页面。

3. 用户完成支付后，需要返回商户页面，也就是你在请求中填写的返回URL，下面的代码用于验证请求是否有效：


@response = Tenpay::Response.new(params)
if @response.successful?
  # 支付成功
else
  # 不合法的请求或支付失败
end

目前还不支持查询接口，欢迎大家的意见和建议。

无觅猜您也喜欢：
升级到Rails 3 Beta	Rails Templates	Rails性能优化简明指南	Shanghai on Rails 7.26线下活动
无觅

city_helper提供了几个简单的helper来实现省及城市的二级联动select，目前只支持国内城市，经过测试的浏览器：FF3, Chrome 2 beta, IE7,
Safari 4。

安装


$ script/plugin install git://github.com/yzhang/city_helper.git


使用
安装之后，你就可以在View中直接使用以下Helper了：


state_select :user, :state # 选择省份
capital_select :user, :city # 选择省会城市
city_select :user, :city # 选择所有地级及地级以上城市
state_and_city_select :user, :state, :city # 省市二级联动select


当然，你也可以在FormBuilder中使用，同时还有一个不需要object的_tag版本：


form.city_select :city
city_select_tag :city


你也可以传递options给city_helper，参数定义同select：


city_select :user, :city, options, html_options
state_and_city_select :user, :state, :city, {:city => city_options, :state => state_options}, {:city => city_html_options, :state => state_html_options}

state_and_city_select稍微复杂一点，下面给个例子：


state_and_city_select :user, :state, :city, {:state => {:include_blank => '请选择省'}, :city => {:include_blank => '请选择城市'}}


TODO

1. 支持其它国家城市及国际化
2. 和country_select集成，实现三级联动

无觅猜您也喜欢：
RJS实现Select级联	CityHelper更新：增加国家和国际化支持	select层叠的AJAX实现	Bash提示符显示Git分支
无觅

安装

$ script/plugin install http://mattmccray.com/svn/rails/plugins/theme_support

使用

1. 生成主题

$ script/generate theme [theme_name]

这将在你的Rails应用的跟目录下创建一个themes文件夹：

app_root
  themes/
    [theme_name]
      layouts/ <- layout .rhtml or .liquid templates
      images/
      stylesheets/
      javascripts/
      views/ <- you can override application views
      about.markdown
      preview.png

2. 然后你需要将原本在app/views目录下的模板文件移到themes/[theme_name]/views下，同时将layouts下的文件也移到模板中去，当然还有相关的CSS，JS以及图片等等。

3. 同时你需要将主题中的JS，CSS以及Images引用改为如下路径：

Image: /theme/:theme_name/images/:image_file
JS: /theme/:theme_name/javascripts/:image_file
CSS: /theme/:theme_name/stylesheets/:image_file

如果使用erb，你可以使用下面的helper：

• theme_image_tag(filename)
• theme_image_path(filename)
• theme_javascript_include_tag(filename)
• theme_javascript_path(filename)
• theme_stylesheet_link_tag(filename)
• theme_stylesheet_path(filename)

liquid也有一个helper：themeitem

<link rel=”StyleSheet” href=”{% themeitem %} default.css {% endthemeitem %}” />

它被转换为：

<link rel=”StyleSheet” href=”/themes/[current_theme]/stylesheets/default.css” />

4. 指定要使用的主题：


class ApplicationController
  layout 'fire'
  theme 'demo'
end

你也可以在filter中根据当前用户的设置来动态决定使用那个theme：


class ApplicationController
  before_filter :set_theme
  def set_theme
    theme current_user.theme
  end
end

Rails 2.1

如果你使用Rails 2.1，那么你还得多做一点工作:

1. 首先修改routeset_ex.rb，将draw和create_theme_routes改为如下定义：


def draw
  old_routes = @routes
  @routes = []
  begin
    create_theme_routes
    yield Mapper.new(self)
    install_helpers
  rescue
    @routes = old_routes
    raise
  end
end
def create_theme_routes
  # Added patch from D.J. Vogel that changes :filename to *filename... allowing sub-folders
  add_named_route 'theme_images', "/themes/:theme/images/*filename", :controller=>'theme', :action=>'images'
  add_named_route 'theme_stylesheets', "/themes/:theme/stylesheets/*filename", :controller=>'theme', :action=>'stylesheets'
  add_named_route 'theme_javascript', "/themes/:theme/javascript/*filename", :controller=>'theme', :action=>'javascript'
  add_route "/themes/*whatever", :controller=>'theme', :action=>'error'
end

2. 然后修改actionview_ex.rb，将render_file改为如下定义：


def render_file(template_path, use_full_path = true, local_assigns = {})
  ["#{RAILS_ROOT}/themes/#{controller.current_theme}/views", # for normal views
    "#{RAILS_ROOT}/themes/#{controller.current_theme}" # for layouts
   ].each do |prefix|
    @finder.prepend_view_path(prefix)
  end
  __render_file(template_path, use_full_path, local_assigns)
end

3. 如果还有问题，欢迎留言，可能我漏掉了什么。

无觅猜您也喜欢：

升级到Rails 3 Beta

Rails Templates

Shanghai on Rails 7.26线下活动

Rails Cookie测试

无觅

安装

$ cd vendor/plugins
$ git clone git://github.com/yzhang/ajax_rating.git

使用

在你要评分的model中添加acts_as_ratable，比如post：


class Post < ActiveRecord::Base
   :acts_as_ratable
end

这为post增加了如下方法：

1. rating，当前post的平均得分
2. rating_count，评分人数

在可以打分的Model中添加acts_as_rater，比如user：


class User < ActiveRecord::Base
   :acts_as_rater
end

这为User增加了如下方法：

1. rating_on(ratable)，返回这个用户为某个对象打的分（1-5）

然后在view中调用：

rating_tag(rater, ratable)

rater就是打分者，ratable则是被评分的对象，如果rater为nil，则用户只能看到分数，但不能打分。

如果需要自定义外观，可以修改rating.css和images下的star123.png，关于CSS的原理说明请参看（十分对不起原作者，找不到原始出处）：http://www.viphot.com/InfoView/Article_285645.html

如果为了安全考虑，需要限制只有当前登录用户可以打分，可以通过定义RatingsController#current_rater实现：


class RatingsController < ActiveController::Base
   :before_filter :login_required
  def current_rater
    current_user
  end
end

这样客户端传递的rater参数将失去作用。

完整例子

1. 创建demo：

$ rails ratable_demo
$ cd ratable_demo

2. 安装RESTFul_Auth

$ git clone git://github.com/technoweenie/restful-authentication.git vendor/plugins/restful_authentication
$ ./script/generate authenticated user sessions

3. 安装Ajax Rating

$ cd vendor/plugins
$ git clone git://github.com/yzhang/ajax_rating.git
$ cd ../../
$ ./script/generate ratable

4. 创建打分对象

$ ./script/generate scaffold post title:string body:text
$ rake db:migrate

5. 修改user.rb


class User < ActiveRecord::Base
   :acts_as_rater
end


6. 修改post.rb


class Post < ActiveRecord::Base
  acts_as_ratable
end


7. 修改 app/views/layout/posts.html.erb，包含Prototype和rating.css：


<%= stylesheet_link_tag 'scaffold', 'rating' %>
<%= javascript_include_tag :defaults %>


8. 修改application.rb:


include AuthenticatedSystem


9. 修改app/views/posts/show.html.erb:


<% if logged_in? -%>
   <%= rating_tag current_user, @post %>
<% else -%>
   <%= rating_tag nil, @post %>
   <%= link_to 'login to rating this post', new_session_path %>
<% end -%>


启动server，打开浏览器到/posts，创建一个新的Post，应该就可以看到一个打分的标签了。

无觅猜您也喜欢：
AJAX分页(paginate)	select层叠的AJAX实现	谷歌字典Mac客户端	CSS缩放iframe实现大号Facebook like
无觅

事实上，Generator也不是个好方法，之所以要将代码复制到你的App目录下，而不是放在Plugin中，是因为你需要修改它，而且在大部分情况下你期望对这些生成代码的修改能够复用到不同的项目中，但是使用Generator，你无法复用对这部分代码的修改，而只能一遍遍的重复“生成－修改”的过程，或者从其它项目中copy生成的代码到新项目，但这是个繁琐的过程，John Long在06年的时候就注意到了这个问题，并且他发现Django的解决方案不错，他在05年底的时候帮助组织了Adrian Holovaty（Django之父）和DHH之间的一场讨论，本来他希望看到Django中的一些优秀思想被吸收到Rails中来，但是遗憾的是，这一幕没有发生，直到Rails 2.0，Rails的插件模式并没有发生什么大的变化。

Django的解决方案是将Plugin组织成一个个的mini app而不是Rails的插件，这些mini app同你的app是并列的，要加入一个新的mini app，只需要修改INSTALLED_APPS 即可：

INSTALLED_APPS = (
   ‘django.contrib.auth’,
   ‘django.contrib.contenttypes’,
   ‘django.contrib.sessions’,
   ‘django.contrib.sites’,
   ‘mysite.polls’
)

这样如果你对某个mini app做了修改，在下一个项目中，你只需要将这个mini app直接copy到新项目中即可。

实际上，将Rails的plugin变成Django的mini app也并不难，只需要将Plugin目录变成在development模式下每次重新加载，然后加强路由支持即可，当然更进一步，实际上应该将Rails的插件两类，包含MVC代码的和不包含MVC代码的，John Long已经在Radiant中实践了这个想法，他给包含MVC代码的插件起的名字是extensions。

不过就目前来说，如果你确定你不会修改Plugin中的代码（一般来说发生几率相当小），那么Engines是个不错的选择，否则还是Generator好一些。

参考:

• Rails Needs Something Better Than Engines
• Why engines and components are not evil but distracting

无觅猜您也喜欢：
升级到Rails 3 Beta	Rails Templates	Rails性能优化简明指南	Shanghai on Rails 7.26活动照片，PPT及视频
无觅

class CustomPaginationRenderer < WillPaginate::LinkRenderer
  def to_html
    links = @options[:page_links] ? windowed_links : []    
    html = links.join(@options[:separator])
    @options[:container] ? @template.content_tag(:div, html, html_attributes) : html
  end  
end


要在view中使用这个自定义的renderer，只需要加上:renderer参数即可：


<%= will_paginate @items, :renderer => 'CustomPaginationRenderer' %>


下面给出一个更复杂的自定义Renderer，它会在分页链接后显示一个文本框，以及一个‘Goto’按钮，允许用户直接跳转到某一页：


class CustomPaginationRenderer < WillPaginate::LinkRenderer
  @@id = 1
  def to_html
    links = @options[:page_links] ? windowed_links : []
    # previous/next buttons
    links.unshift page_link_or_span(@collection.previous_page, 'disabled', @options[:prev_label])
    links.push    page_link_or_span(@collection.next_page,     'disabled', @options[:next_label])
    html = links.join(@options[:separator])
    html += goto_box
    @options[:container] ? @template.content_tag(:div, html, html_attributes) : html
  end
  private
  def goto_box
    @@id += 1
    @@id = 1 if @@id > 100
  <<-GOTO
    <input type="text" maxlength="5" size="3" id="page#{@@id}" />
    <input type="submit" onclick="goto_page#{@@id}()" value="Goto"/>
    <script type="text/javascript"&gt
      function goto_page#{@@id}()
      {
        page = Number($('page#{@@id}').value)
        total = #{total_pages}
        if(page < 1 || page > total)
        {
          alert('Please enter a number between 1 and ' + total + '!')
          return;
        }
        var link = '#{@template.url_for(url_options("_page"))}'
        var new_link = link.replace("_page", page)
        window.location.assign(new_link)
      }
    </script>
    GOTO
  end
end


@@id的作用是因为一个view中有可能多次调用will_paginate，需要对inputbox进行区分，这个renderer还用到了一些继承自WillPaginate::LinkRenderer的方法：

• url_for(page), 返回指向某页的链接，比如url_for(1) => ‘/posts?page=1′
• total_pages, 返回总页数
• page_link_or_span，返回指向某页面的链接

更多方法可以在WillPaginate的view_helper.rb中找到。

无觅猜您也喜欢：
AJAX分页(paginate)	NetBeans IDE: Windows平台最好的Ruby IDE	JRuby1.0发布	Ruby 1.9正式发布
无觅