dnadesign/silverstripe-generatepdf

This module generates a PDF version of a page

Silverstripe GeneratePDF

Introduction

This extension allow for a PDF version of any page to be created and served either via a direct link to the generated file or via a method that triggers the download of the generated pdf., _(*1)

Requirements

• Silverstripe 3.1
• WKHTMLTOPDF library

Installation

composer require "dnadesign/silverstripe-generatepdf" "dev-master"

Extend any page type with the GeneratePDF extension as well as the page type controller with GeneratePDF_Controller extension. This can be done via the SilverStripe YAML config API, _(*2)

mysite/_config/app.yml, _(*3)

Page:
  extensions:
    - GeneratePDF

Page_Controller:
  extensions:
    - GeneratePDF_Controller

Define WKHTMLTOPDF path To use the library locally, you can define the path in the yaml file, _(*4)

Page:
    wkhtmltopdf_binary: /usr/local/bin/wkhtmltopdf

Configuration

The AutoGeneratePDF extension refreshes the generated pdf upon publish. Everytime you republish a page with the extension GeneratePDF, the previous version of the pdf is deleted and a new one is recreated, keeping the generated file always up-to-date with the live version., _(*5)

Page:
  extensions:
    - AutoGeneratePDF

The PublishRefreshPDF allow for subpage to publish automatically the parent page in order to regenerate the pdf. It can also be used with silvertsripe-elemental to trigger the page publish when a widget (element) is published., _(*6)

SubPage:
  extensions:
    - PublishRefreshPDF

 BaseElement:
  extensions:
    - PublishRefreshPDF