Use Ferrum for PDF

Gemfile

@@ -36,6 +36,8 @@ gem "decidim-user_extension", path: "decidim-user_extension"
 
 gem "slack-ruby-client"
 
+gem "ferrum"
+
 group :development, :test do
   gem "byebug", "~> 11.0", platform: :mri
   gem "figaro"

Gemfile.lock

@@ -447,6 +447,11 @@ GEM
     faraday-multipart (1.0.4)
       multipart-post (~> 2)
     faraday-net_http (3.0.2)
+    ferrum (0.13)
+      addressable (~> 2.5)
+      concurrent-ruby (~> 1.1)
+      webrick (~> 1.7)
+      websocket-driver (>= 0.6, < 0.8)
     ffi (1.15.5)
     figaro (1.2.0)
       thor (>= 0.14.0, < 2)
@@ -870,6 +875,7 @@ GEM
       rack-proxy (>= 0.6.1)
       railties (>= 5.2)
       semantic_range (>= 2.3.0)
+    webrick (1.8.1)
     websocket-driver (0.7.5)
       websocket-extensions (>= 0.1.0)
     websocket-extensions (0.1.5)
@@ -903,6 +909,7 @@ DEPENDENCIES
   dotenv-rails
   factory_bot_rails
   faker (~> 2.14)
+  ferrum
   figaro
   fog-aws
   image_processing

config/initializers/decidim.rb

@@ -247,6 +247,7 @@
 end
 
 require "decidim/map/provider/static_map/cfj_osm"
+require "decidim/exporters/pdf"
 
 Rails.application.config.i18n.available_locales = Decidim.available_locales
 Rails.application.config.i18n.default_locale = Decidim.default_locale

lib/decidim/exporters/pdf.rb

@@ -0,0 +1,64 @@
+# frozen_string_literal: true
+
+module Decidim
+  module Exporters
+    # Exports a PDF using the provided hash, given a collection and a
+    # Serializer. This is an abstract class that should be inherited
+    # to create PDF exporters, with each PDF exporter class setting
+    # the desired template, layout and orientation.
+    #
+    class PDF < Exporter
+      # Public: Exports a PDF version of the collection by rendering
+      # the template into html and then converting it to PDF.
+      #
+      # Returns an ExportData instance.
+      def export
+        html = controller.render_to_string(
+          template: template,
+          layout: layout,
+          locals: locals
+        )
+
+        Dir.mktmpdir do |dir|
+          html_path = File.join(dir, "tmp.html")
+          File.write(html_path, html)
+          pdf_path = File.join(dir, "tmp.pdf")
+          url = URI::File.build([nil, html_path])
+
+          browser = Ferrum::Browser.new
+          browser.go_to(url)
+          browser.pdf(path: pdf_path, landscape: orientation != "Portrait", printBackground: true)
+
+          document = File.read(pdf_path)
+          ExportData.new(document, "pdf")
+        end
+      end
+
+      # may be overwritten if needed
+      def orientation
+        "Portrait"
+      end
+
+      # implementing classes should return a valid ERB path here
+      def template
+        raise NotImplementedError
+      end
+
+      # implementing classes should return a valid ERB path here
+      def layout
+        raise NotImplementedError
+      end
+
+      # This method may be overwritten if the template needs more local variables
+      def locals
+        { collection: collection }
+      end
+
+      protected
+
+      def controller
+        raise NotImplementedError
+      end
+    end
+  end
+end