Skip to content


Subversion checkout URL

You can clone with
Download ZIP
This project allows to create reports/documents(as pdf,jpg,gif,tiff, etc) in Rails View Layer using RGhost or RGhost Barcode.
Latest commit 5c6e299 @sobrinho sobrinho Merge pull request #7 from jonathanccalixto/master
Adding support for controllers with namespace
Failed to load latest commit information.
lib adding support for controllers with namespace
README.rdoc No commit message
rghost_rails.gemspec Adding support to rails 3


The gem RGhost has been developed to run independently of Rails but nowadays we're developing most of our application using Rails. Rails allows us a standard organization in MVC and my mail box is full of questions like “where will I create my rghost reports?”, generally I answer, “create the report as a private method in controller”. This doesn't satisfy everybody(and me either). With the goal of resolving that, I've been writing the new rghost-rails gem that will provide us the best way to work with rghost together with Rails.


In your config/environment.rb add the follows lines

config.gem "rghost", :version => ">=0.8.7"
config.gem "rghost_rails"

so install those gems using the rake task

sudo rake gems:install

Notice that that rghost-rails depends of rghost >= 0.8.7

Using it

the rghost-rails needs some basic conventions

1- A file into the view-layer should have .rghost.rb as a suffix, for example to a file/action called invoice


2- Just use a block to format your report, for instance, using the same file invoice.rghost.rb explained above :paper => :A4 do |doc| "Hi this is my RGhost Report"
 doc.grid :data => @clients do |g|
   g.column :name, :title => "Client name", :align => :center
   g.column :site, :title => "Site url"
   g.column :created_at, :title => "Client since", :format => lambda{|d| d.strftime('%d/%m/%Y')}

3- In the controller just use a new method rghost_render, that you'll pass the report format such as pdf, jpg etc, the path for the file is the same as the action name and the file's name to download it

class ReportsController < ApplicationController
  def print
    @clients = Client.find :all
    rghost_render :pdf, :report => {:action => 'invoice'}, :filename => 'invoice022009.pdf'

You also can use the respond_to to render a report/document for each format, before do that, register the mime types entries that you'll use, in this example we'll use pdf, jpg and png, so the file config/initializers/mime_types.rb will be

Mime::Type.register "application/pdf", :pdf
Mime::Type.register "image/jpg", :jpg
Mime::Type.register "image/png", :png

Now, write a block for each format

respond_to do |format|
  format.xml  { render :xml => @clients }
  format.pdf { rghost_render :pdf, :report => 'invoice', :filename => "invoice022009.pdf" }
  format.jpg { rghost_render :jpg, :report => 'invoice', :filename => "invoice022009.jpg" }
  format.png { rghost_render :png, :report => 'invoice', :filename => "invoice022009.jpg" }

Get your formats by url typing .format after action or action/id

/clients    #html

Please let me know if you find any bugs

Something went wrong with that request. Please try again.