[#45896] Generate PDF document from a work package description

app/components/work_packages/exports/generate/modal_dialog_component.html.erb

@@ -0,0 +1,58 @@
+<%= render(Primer::Alpha::Dialog.new(
+  title: "Generate PDF",
+  id: MODAL_ID,
+  size: :large
+)) do |dialog|
+  dialog.with_header(variant: :large)
+  dialog.with_body do
+    primer_form_with(
+      url: generate_pdf_work_package_path(work_package),
+      data: { turbo: false },
+      id: GENERATE_PDF_FORM_ID,
+      method: :get
+    ) do |form|
+      flex_layout do |modal_body|
+        generate_selects.each_with_index do |entry, index|
+          modal_body.with_row(mt: index == 0 ? 0 : 3) do
+            render(Primer::Alpha::Select.new(
+              name: entry[:name],
+              label: entry[:label],
+              caption: entry[:caption],
+              size: :medium,
+              input_width: :small,
+              value: entry[:options].find { |e| e[:default] }[:value])
+            ) do |component|
+              entry[:options].each do |entry|
+                component.option(label: entry[:label], value: entry[:value])
+              end
+            end
+          end
+        end
+        modal_body.with_row(mt: 3) do
+          render Primer::Alpha::TextField.new(
+            name: :header_text_right,
+            label: 'Header right',
+            caption: 'Text to be displayed in the right of the header',
+            visually_hide_label: false,
+            value: default_header_text_right
+          )
+        end
+        modal_body.with_row(mt: 3) do
+          render Primer::Alpha::TextField.new(
+            name: :footer_text_center,
+            label: 'Footer center',
+            caption: 'Text to be displayed in the center of the footer',
+            visually_hide_label: false,
+            value: default_footer_text_center
+          )
+        end
+      end
+    end
+  end
+  dialog.with_footer do
+    render(Primer::ButtonComponent.new(data: { "close-dialog-id": MODAL_ID })) { I18n.t(:button_cancel) }
+    render(Primer::ButtonComponent.new(
+      scheme: :primary, type: :submit, form: GENERATE_PDF_FORM_ID,
+      data: { "close-dialog-id": MODAL_ID })) { "Generate" }
+  end
+end %>

app/components/work_packages/exports/generate/modal_dialog_component.rb

@@ -0,0 +1,133 @@
+# frozen_string_literal: true
+
+# -- copyright
+# OpenProject is an open source project management software.
+# Copyright (C) the OpenProject GmbH
+#
+# This program is free software; you can redistribute it and/or
+# modify it under the terms of the GNU General Public License version 3.
+#
+# OpenProject is a fork of ChiliProject, which is a fork of Redmine. The copyright follows:
+# Copyright (C) 2006-2013 Jean-Philippe Lang
+# Copyright (C) 2010-2013 the ChiliProject Team
+#
+# This program is free software; you can redistribute it and/or
+# modify it under the terms of the GNU General Public License
+# as published by the Free Software Foundation; either version 2
+# of the License, or (at your option) any later version.
+#
+# This program is distributed in the hope that it will be useful,
+# but WITHOUT ANY WARRANTY; without even the implied warranty of
+# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+# GNU General Public License for more details.
+#
+# You should have received a copy of the GNU General Public License
+# along with this program; if not, write to the Free Software
+# Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA  02110-1301, USA.
+#
+# See COPYRIGHT and LICENSE files for more details.
+# ++
+require "text/hyphen"
+
+module WorkPackages
+  module Exports
+    module Generate
+      class ModalDialogComponent < ApplicationComponent
+        MODAL_ID = "op-work-package-generate-pdf-dialog"
+        GENERATE_PDF_FORM_ID = "op-work-packages-generate-pdf-dialog-form"
+        include OpTurbo::Streamable
+        include OpPrimer::ComponentHelpers
+
+        attr_reader :work_package, :params
+
+        def initialize(work_package:, params:)
+          super
+
+          @work_package = work_package
+          @params = params
+        end
+
+        def default_header_text_right
+          "#{work_package.type} ##{work_package.id}"
+        end
+
+        def default_footer_text_center
+          work_package.subject
+        end
+
+        def generate_selects
+          [
+            {
+              name: "hyphenation",
+              label: "Hyphenation",
+              caption: "Break words between lines to improve text justification and readability.",
+              options: hyphenation_options
+            },
+            {
+              name: "paper_size",
+              label: I18n.t("export.dialog.pdf.paper_size.label"),
+              caption: "The size of the paper to use for the PDF.",
+              options: paper_size_options
+            }
+          ]
+        end
+
+        def language_name(locale)
+          I18n.translate('cldr.language_name', locale: locale)
+        rescue
+          nil # not supported language
+        end
+
+        def hyphenation_options
+          # This is a list of languages that are supported by the hyphenation library
+          # https://rubygems.org/gems/text-hyphen
+          # The labels are the language names in the language itself (NOT to be put I18n)
+          supported_languages = [
+            { value: "ca", label: "Català" },
+            { value: "cs", label: "Čeština" },
+            { value: "da", label: "Dansk" },
+            { value: "de", label: "Deutsch" },
+            { value: "en_uk", label: "English (UK)" },
+            { value: "en_us", label: "English (USA)" },
+            { value: "es", label: "Español" },
+            { value: "et", label: "Eesti" },
+            { value: "eu", label: "Euskara" },
+            { value: "fi", label: "Suomi" },
+            { value: "fr", label: "Français" },
+            { value: "ga", label: "Gaeilge" },
+            { value: "hr", label: "Hrvatski" },
+            { value: "hu", label: "Magyar" },
+            { value: "ia", label: "Interlingua" },
+            { value: "id", label: "Indonesia" },
+            { value: "is", label: "Ísland" },
+            { value: "it", label: "Italiano" },
+            { value: "mn", label: "Монгол" },
+            { value: "ms", label: "Melayu" },
+            { value: "nl", label: "Nederlands" },
+            { value: "no", label: "Norsk" },
+            { value: "pl", label: "Polski" },
+            { value: "pt", label: "Português" },
+            { value: "ru", label: "Русский" },
+            { value: "sk", label: "Slovenčina" },
+            { value: "sv", label: "Svenska" }
+          ].sort_by { |item| item[:label] }
+          [{ value: "", label: "Off", default: true }].concat(supported_languages)
+        end
+
+        def paper_size_options
+          [
+            { label: "A4", value: "A4", default: true },
+            { label: "A3", value: "A3" },
+            { label: "A2", value: "A2" },
+            { label: "A1", value: "A1" },
+            { label: "A0", value: "A0" },
+            { label: "Executive", value: "EXECUTIVE" },
+            { label: "Folio", value: "FOLIO" },
+            { label: "Letter", value: "LETTER" },
+            { label: "Tabloid", value: "TABLOID" }
+          ]
+        end
+      end
+    end
+  end
+end

app/controllers/work_packages_controller.rb

@@ -37,13 +37,13 @@ class WorkPackagesController < ApplicationController
   accept_key_auth :index, :show
 
   before_action :authorize_on_work_package,
-                :project, only: :show
+                :project, only: %i[show generate_pdf_dialog generate_pdf]
   before_action :load_and_authorize_in_optional_project,
                 :check_allowed_export,
                 :protect_from_unauthorized_export, only: %i[index export_dialog]
 
   before_action :authorize, only: :show_conflict_flash_message
-  authorization_checked! :index, :show, :export_dialog
+  authorization_checked! :index, :show, :export_dialog, :generate_pdf_dialog, :generate_pdf
 
   before_action :load_and_validate_query, only: :index, unless: -> { request.format.html? }
   before_action :load_work_packages, only: :index, if: -> { request.format.atom? }
@@ -93,6 +93,19 @@ def export_dialog
     respond_with_dialog WorkPackages::Exports::ModalDialogComponent.new(query: @query, project: @project, title: params[:title])
   end
 
+  def generate_pdf_dialog
+    respond_with_dialog WorkPackages::Exports::Generate::ModalDialogComponent.new(work_package: work_package, params: params)
+  end
+
+  def generate_pdf
+    exporter = WorkPackage::PDFExport::DocumentGenerator.new(work_package, params)
+    export = exporter.export!
+    send_data(export.content, type: export.mime_type, filename: export.title)
+  rescue ::Exports::ExportError => e
+    flash[:error] = e.message
+    redirect_back(fallback_location: work_package_path(work_package))
+  end
+
   def show_conflict_flash_message
     scheme = params[:scheme]&.to_sym || :danger
 

app/models/work_package/pdf_export/attachments.rb → app/models/work_package/pdf_export/common/attachments.rb

@@ -28,7 +28,7 @@
 
 require "mini_magick"
 
-module WorkPackage::PDFExport::Attachments
+module WorkPackage::PDFExport::Common::Attachments
   def resize_image(file_path)
     tmp_file = Tempfile.new(["temp_image", File.extname(file_path)])
     @resized_images = [] if @resized_images.nil?
@@ -51,4 +51,27 @@ def delete_all_resized_images
     @resized_images&.each(&:close!)
     @resized_images = []
   end
+
+  def attachment_image_local_file(attachment)
+    attachment.file.local_file
+  rescue StandardError => e
+    Rails.logger.error "Failed to access attachment #{attachment.id} file: #{e}"
+    nil # return nil as if the id was wrong and the attachment obj has not been found
+  end
+
+  def attachment_image_filepath(work_package, src)
+    # images are embedded into markup with the api-path as img.src
+    attachment = attachment_by_api_content_src(work_package, src)
+    return nil if attachment.nil? || !pdf_embeddable?(attachment.content_type)
+
+    local_file = attachment_image_local_file(attachment)
+    return nil if local_file.nil?
+
+    resize_image(local_file.path)
+  end
+
+  def attachment_by_api_content_src(work_package, src)
+    # find attachment by api-path
+    work_package.attachments.detect { |a| api_url_helpers.attachment_content(a.id) == src }
+  end
 end

app/models/work_package/pdf_export/common.rb → app/models/work_package/pdf_export/common/common.rb

@@ -26,7 +26,7 @@
 # See COPYRIGHT and LICENSE files for more details.
 #++
 
-module WorkPackage::PDFExport::Common
+module WorkPackage::PDFExport::Common::Common
   include Redmine::I18n
   include ActionView::Helpers::TextHelper
   include ActionView::Helpers::NumberHelper
@@ -36,7 +36,7 @@ module WorkPackage::PDFExport::Common
   private
 
   def get_pdf(_language)
-    ::WorkPackage::PDFExport::View.new(current_language)
+    ::WorkPackage::PDFExport::Common::View.new(current_language)
   end
 
   def field_value(work_package, attribute)
@@ -76,26 +76,11 @@ def with_vertical_margin(opts)
     pdf.move_down(opts[:bottom_margin]) if opts.key?(:bottom_margin)
   end
 
-  def write_optional_page_break
-    space_from_bottom = pdf.y - pdf.bounds.bottom
-    if space_from_bottom < styles.page_break_threshold
-      pdf.start_new_page
-    end
-  end
-
   def get_column_value(work_package, column_name)
     formatter = formatter_for(column_name, :pdf)
     formatter.format(work_package)
   end
 
-  def get_column_value_cell(work_package, column_name)
-    value = get_column_value(work_package, column_name)
-    return get_id_column_cell(work_package, value) if column_name == :id
-    return get_subject_column_cell(work_package, value) if wants_report? && column_name == :subject
-
-    escape_tags(value)
-  end
-
   def get_formatted_value(value, column_name)
     return "" if value.nil?
 
@@ -108,19 +93,6 @@ def escape_tags(value)
     value.to_s.gsub("<", "&lt;").gsub(">", "&gt;")
   end
 
-  def get_id_column_cell(work_package, value)
-    href = url_helpers.work_package_url(work_package)
-    make_link_href_cell(href, value)
-  end
-
-  def get_subject_column_cell(work_package, value)
-    make_link_anchor(work_package.id, escape_tags(value))
-  end
-
-  def make_link_href_cell(href, caption)
-    "<color rgb='#{styles.link_color}'><link href='#{href}'>#{caption}</link></color>"
-  end
-
   def make_link_anchor(anchor, caption)
     "<link anchor=\"#{anchor}\">#{caption}</link>"
   end
@@ -306,6 +278,10 @@ def title_datetime
     DateTime.now.strftime("%Y-%m-%d_%H-%M")
   end
 
+  def footer_date
+    format_time(Time.zone.now)
+  end
+
   def current_page_nr
     pdf.page_number + @page_count - (with_cover? ? 1 : 0)
   end

app/models/work_package/pdf_export/common/logo.rb

@@ -0,0 +1,23 @@
+module WorkPackage::PDFExport::Common::Logo
+  def logo_image
+    image_obj, image_info = pdf.build_image_object(logo_image_filename)
+    [image_obj, image_info]
+  end
+
+  def logo_image_filename
+    image_file = custom_logo_image_filename
+    image_file = Rails.root.join("app/assets/images/logo_openproject.png") if image_file.nil?
+    image_file
+  end
+
+  def custom_logo_image_filename
+    return unless CustomStyle.current.present? &&
+      CustomStyle.current.export_logo.present? && CustomStyle.current.export_logo.local_file.present?
+
+    image_file = CustomStyle.current.export_logo.local_file.path
+    content_type = OpenProject::ContentTypeDetector.new(image_file).detect
+    return unless pdf_embeddable?(content_type)
+
+    image_file
+  end
+end

app/models/work_package/pdf_export/markdown_field.rb → app/models/work_package/pdf_export/common/macro.rb

@@ -26,28 +26,15 @@
 # See COPYRIGHT and LICENSE files for more details.
 #++
 
-module WorkPackage::PDFExport::MarkdownField
-  include WorkPackage::PDFExport::Markdown
+module WorkPackage::PDFExport::Common::Macro
   PREFORMATTED_BLOCKS = %w(pre code).freeze
 
-  def write_markdown_field!(work_package, markdown, label)
-    return if markdown.blank?
-
-    write_optional_page_break
-    with_margin(styles.wp_markdown_label_margins) do
-      pdf.formatted_text([styles.wp_markdown_label.merge({ text: label })])
-    end
-    with_margin(styles.wp_markdown_margins) do
-      write_markdown! work_package, apply_markdown_field_macros(markdown, work_package)
-    end
-  end
-
-  private
-
   def apply_markdown_field_macros(markdown, work_package)
     apply_macros(markdown, work_package, WorkPackage::Exports::Macros::Attributes)
   end
 
+  private
+
   def apply_macros(markdown, work_package, formatter)
     return markdown unless formatter.applicable?(markdown)