@@ -1,4 +1,4 @@ -Copyright (c) 2008 Borja Martín <borjam@dagi3d.net> +Copyright (c) 2008-2009 Borja Martín Sánchez de Vivar <borjam@dagi3d.net> Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the MIT-LICENSE @@ -2,7 +2,19 @@ ActsAsFlyingSaucer is a Ruby On Rails plugin that allows to save xhtml documents into pdf files using the Flying Saucer java library. -= Usage: += Install + +Grab the last version from Github: + + ./script/plugin/install git://github.com/dagi3d/acts_as_flying_saucer.git + + += Requirements + +JDK 1.5.x or 1.6.x +It was tested under Mac OS X Leopard but it should work on any operating system with a compatible Java Virtual Machine + += Usage Just call the acts_as_flying_saucer method inside the controller you want to enable to generate pdf documents. Then you can call the render_pdf method. It accepts the same options as ActionController::Base#render plus the following ones: @@ -15,7 +27,9 @@ Then you can call the render_pdf method. It accepts the same options as ActionCo def create render_pdf :template => 'foo/pdf_template.hml.erb' end - end + end + +Easy as pie = Configuration @@ -24,7 +38,7 @@ These are the default settings which can be overwriten in your enviroment config ActsAsFlyingSaucer::Config.options = { :java_bin => "java", # java binary :classpath_separator => ':', # classpath separator. unixes system use ':' and windows ';' - :tmp_path => "/tmp", # path to store the temporary files + :tmp_path => "/tmp", # path where temporary files will be stored } = Roadmap @@ -33,4 +47,4 @@ These are the default settings which can be overwriten in your enviroment config -Copyright (c) 2008 Borja Martín <borjam@dagi3d.net> - http://dagi3d.net, released under the MIT license +Copyright (c) 2008-2009 Borja Martín Sánchez de Vivar <borjam@dagi3d.net> - http://dagi3d.net, released under the MIT license README.rdoc @@ -54,6 +54,17 @@ module ActsAsFlyingSaucer }) ActsAsFlyingSaucer::Xhtml2Pdf.write_pdf(generate_options) + + # sending the file to the client + if options.has_key?(:send_file) + + send_file_options = { + :filename => File.basename(output_file), + :x_sendfile => true, + }.merge(options[:send_file]) + + send_file(output_file, send_file_options) + end end end lib/acts_as_flying_saucer.rb @@ -6,7 +6,7 @@ class FooController < ActionController::Base acts_as_flying_saucer def show - render_pdf :template => 'foo' + render_pdf :template => 'foo', :pdf_file => "/Users/dagi3d/Desktop/foo.pdf" end end test/acts_as_flying_saucer_test.rb README 5ed5220491b53f5ab3d2275e47e362edad7b3c93 dagi3d borjam@dagi3d.net http://github.com/dagi3d/acts_as_flying_saucer/commit/2c961620335e6434cb4bed33fa2ca8f6b90dcaf6 2c961620335e6434cb4bed33fa2ca8f6b90dcaf6 2008-12-06T07:57:44-08:00 2008-12-06T07:57:44-08:00 added the send_file feature 1b24ece7c3d29e2a7b20d22109befcb6f1eee3a9 dagi3d borjam@dagi3d.net