Download the PHP package springworks/pdf-maker without Composer
On this page you can find all versions of the php package springworks/pdf-maker. It is possible to download/install these versions without Composer. Possible dependencies are resolved automatically.
Download springworks/pdf-maker
More information about springworks/pdf-maker
Files in springworks/pdf-maker
Package pdf-maker
Short Description PDF creation using api2pdf v2
License proprietary
Informations about the package pdf-maker
Pdf Maker plugin for Craft CMS 3.x
PDF creation using the v2 API headless chrome services from api2pdf.com. You can also use Api2Pdf for rendering PDFs in Formie or Craft Commerce.
Requirements
This plugin requires Craft CMS 3.0.0-beta.23 or later.
Formie integration requires Formie 1.5 or later.
Commerce integration requires Commerce 2.0 or later.
Installation
To install the plugin, follow these instructions.
-
Open your terminal and go to your Craft project:
cd /path/to/project
-
Then tell Composer to load the plugin:
composer require springworks/pdf-maker
- In the Control Panel, go to Settings → Plugins and click the “Install” button for Pdf Maker.
Settings
The only required setting is a valid Api2Pdf API key. It is recommended to set this using an environment variable.
The plugin will automatically detect if either Formie or Craft Commerce is installed and enabled and will offer additional settings to override the PDF generation for these plugins if detected.
Default PDF creation options are set in the config file. Rename config.php
to pdf-maker.php
and place in your config
folder. Change the default options as required.
For details of what options are available, please see the following:
- PDF: https://app.swaggerhub.com/apis-docs/api2pdf/api2pdf/2.0.0#/ChromeAdvancedPdfOptions
- Image: https://app.swaggerhub.com/apis-docs/api2pdf/api2pdf/2.0.0#/ChromeAdvancedImageOptions
Examples
For any of the methods below, you can pass in an options
array as hidden inputs in the forms to override the default config options, for example:
Generate PDF from URL
Generate PDF from HTML
Generate PDF from Template
To generate a PDF from a template, set the hidden template
input to the hashed value of the path to the template to render. The path is hashed to prevent it being tempered with in the browser. For example, if you wanted to use a template called page
, which lived in a folder called _pdfs
in your templates
folder, you would set the value of the hidden template
to {{ '_pdfs/page'|hash }}
.
You can pass variables into the template by setting them as hidden variables[variableName]
inputs. Each of these values must also be hashed. So, for example, if your template required an entryId
to tell it what entry to render, you could pass that in like this:
<input type="hidden" name="variables[entryId]" value="{{ entry.id|hash }}" />
Full example:
Merge PDFs
Generate Image from URL
Generate Image from HTML
Generate Image from Template
To generate an image from a template, set the hidden template
input to the hashed value of the path to the template to render. The path is hashed to prevent it being tempered with in the browser. For example, if you wanted to use a template called page
, which lived in a folder called _pdfs
in your templates
folder, you would set the value of the hidden template
to {{ '_pdfs/page'|hash }}
.
You can pass variables into the template by setting them as hidden variables[variableName]
inputs. Each of these values must also be hashed. So, for example, if your template required an entryId
to tell it what entry to render, you could pass that in like this:
<input type="hidden" name="variables[entryId]" value="{{ entry.id|hash }}" />
Full example:
Brought to you by Steve Rowling