PDF Generator

Added

• Support for Craft CMS 5.0.0-beta and later versions.

Fixed

• A bug that prevented accessing plugin settings in Craft CMS 5.0.0-beta.

Codename

• Washington’s Birthday

Added

• Users can now install monolog\monolog package to enable logging for log option on Craft CMS.

Fixed

• Resolve issue with unavailable settings in GenerateThumbConfiguration class.
  • Users can now adjust the thumbnail quality by passing a thumbQuality parameter.

Changed

• Improve code readability and consistency across all classes.
  • This change does not affect the functionality or performance of the project.

Codename

• Happy Orthodox New Years Day.

Added

• Customizable filename for dumb thumbnails
• Option to specify the directory for dumb thumbnails
• Functionality to adjust thumbnail quality
• Random filename when input filename is null
• Empty Entry when input entry is null

Changed

• Mechanism for loading PDF footers and headers with start and end page options:
  • Fixed duplicated start pages,
  • Fixed incorrect page numbering when using footers or headers,
  • Fixed the empty page at the end of the file.
• Refactor classes targeted to paths.
  • Fixed fallback image when QR package is missing

Codename

• Team CoolTRONIC.pl LLC wishes everyone a Merry Orthodox Christmas.

Added

• Support for Craft v5.0.x in Optional packages installer, using the same versions as v4.0.
• Import of image generation classes for methods via Imagick, compatible with v5.0.x.
• Detection of PHP 8.2 and 8.3 locations for Craft v5.0.

Fixed

• Missing packages for JavaScript in Admin Settings options, causing plugin issue in 5.0.0.alpha.

Added

• Compatibility with the latest 5.0.0.alpha version of Craft CMS, a flexible and user-friendly content management system.

Codename

• Happy New Year Edition

Codename

• Happy Christmas Eve from CoolTRONIC.pl LLC team

Added

• Lite: Option to disable compression of the generated PDF files (disableCompression). This may affect the file size and the quality.
• Plus: Option to choose the generation mode of the PDF files (generateMode) among PDF-A, PDF-X, PDF-A Auto, and PDF-X Auto. This option requires the Plus plan and can be set as one of the following strings: pdfa, pdfx, pdfaauto, or pdfxauto.
• Lite: Mechanism to check status of installed packages in PackageManager class.
• Lite: Option to uninstall packages and new optional package simplehtmldom/simplehtmldom.
• Plus: Option to convert all images to CMYK in document for PDF-X mode (convertImgToCMYK) with optional package simplehtmldom/simplehtmldom. This option requires the Plus plan and ImageMagick.
• Lite: Option to set the mode for parsing URLs (URLMode). The possible values are default, curl, or simplehtml. The simplehtml mode requires the optional package simplehtmldom/simplehtmldom.
• Lite: Option to print output of debug mPDF into specified file (log). For example, @alias(root) ~ '\mpdf.txt'.
• Lite: Option to set the colorspace (colorspace). It can be set as an integer:
  • 1 - allow GRAYSCALE only [convert CMYK/RGB->gray]
  • 2 - allow RGB / SPOT COLOR / Grayscale [convert CMYK->RGB]
  • 3 - allow CMYK / SPOT COLOR / Grayscale [convert RGB->CMYK]
  • 0 - or any other value: no restriction is made on colorspace used

Changed

• Improve the readability and consistency of the functions and descriptions in the plugin classes.
• Change the order of the settings in the General Tab with checkboxes and switches.
• Optimize the keywords in composer.json for better searchability.
• Optimize the mechanism and layout of installing packages. Now plugin uses light switches to install / uninstall optional packages and shows what is installed.
• Improve mechanism of saving generated by ImageMagick thumbnails to be more reliable.

Removed

• Delete the unused imports from the code.
• Remove unnecessary alerts import from plugin settings panel.

Fixed

• Fixed a bug that prevented users from setting options in settings when the Plus Plan was active. Now you can customize your PDFs with the advanced features of the Plus Plan.

Changed

• Changed URLMode option in plugin settings panel.
• Refactored descriptions and instructions in plugin settings panel for clarity and consistency.

Fixed

• Fixed a typo in the CHANGELOG.md file.

Changed

• Changed option from URLmode into URLMode.

Fixed

• Correct endPage settings in the plugin panel.
• Fixed error to save stream with another encoding than UTF-8 when setting encoding with enabled URLPurify in DocumentHelperVariable.

Fixed

• Restore URLMode and correct startPage settings in the plugin panel for the master branch that was missing in the previous release.
• Correct the URLMode description in the README.md file.

Added

• thumbBestfit option to adjust thumbnail size with best-fit mode when using dumbThumb or assetThumb options. This improves the quality and appearance of thumbnails.
• protection mode and helper options to enhance password protection of PDFs with ISO, DIN, and BSI standards (Plus Plan required). This enhances the security and privacy of documents.
• Option to remove the plugin’s invisible watermark from generated documents (Plus Plan required). This improves the aesthetics and professionalism of documents.
• URLTwigRender option to render Twig variables on parsed custom URLs as optional. This allows to use of attributes like {{custom}} or QR Code as {{qrimg}} from parsed custom URL.
• startPage is the first page of the PDF to be generated. You can use this option to trim unnecessary pages from the beginning of the PDF.
• endPage is the last page of the PDF to be generated. You can use this option to trim unnecessary pages from the end of the PDF.
• URLMode option can be set to curl, to get URLs via CURL instead of file_get_contents.

Changed

• [BREAKING] Merged two Craft CMS branches craft3 and master into one package with version 2.0.0. This requires updating the plugin to use it on Craft CMS 3.x and 4.x.
• Improved the layout and design of the settings control panel tabs. This improves the usability and responsiveness of the settings control panel.
• Refactored code of DocumentHelperVariable.php to remove duplicate code and improve readability. This improves the maintainability and compatibility of the code.
• Implemented Plus functionality in the plugin to restrict some new features for paying users. These features include the new protection mode and the option to remove the plugin’s watermark. Please consider upgrading to the Plus plan to use them.

Fixed

• [SECURITY] Bug in the functions when parsing URL content with unset URLPurify option. This bug could allow malicious users to inject arbitrary code into your website by sending specially crafted URLs. This fix prevents this vulnerability by sanitizing the input before passing without setting URLPurify.
• Missing encoding setting in the plugin panel for Craft CMS 3.x branch.
• Improper handle of a plugin into document-helpers which is used in the Plugin Store.

Removed

• [BREAKING] Discontinued the separate craft3 branch for Craft CMS 3 and unified the codebase for both Craft CMS 3 and 4 in the master branch. This requires updating the plugin to the latest version to use it on either Craft CMS version.

Fixed

• Corrected spelling errors in the plugin settings panel descriptions.
• Added checks for the existence of Twig or HTML files in the template, header, and footer parameters.
• Added checks for the existence of external classes of optional QR code generator package.
• Resolved an issue where setting an option to false could cause problems with the isset() function.

Added

• Enabled the generation of PDFs from inline code block content or custom URLs as the template, header, and footer parameters.

Changed

• Included an optional package for scraping external URLs with HTML Purifier.
• Added the URLPurify option to sanitize the HTML content scraped from URLs when installed optional package.
• Added the encoding option to specify the encoding for the URLPurify and mPDF input streams.

Enhancement

• Made QR Code package as optional and not installed by default.
• Implemented plugin default settings screen.

New Feature

• Added a new option to configure the plugin globally.
• Enabled installing additional packages from the Settings menu.

• Bug Fix: Fixed a bug that caused incorrect date validation of PDF file.
• Bug Fix: Fixed a bug that caused an error when using headers and footers.
• New Feature: Added a feature that allows you to include a QR code image in the template using qrdata and qrimg variables.

• Bug Fix: Solved a problem that was caused by the new GenerateThumb class, which had many errors in the code. This fix makes the thumbnail generation work correctly.

• Bug Fix: Fixed a problem that occurred due to the introduction of the ExtendedAsset class, which had a conflicting declaration of setter and getter methods and an incorrect getMimeType getter return type declaration. This fix resolves the issues with thumbnail generation.

• Bug Fix: Solved a problem that was introduced by importing the FileHelper class.

• New Feature: Introduced additional parameters for image thumbnail generation in pdfOptions for pdfAsset and pdf methods:
  • assetThumb: Generates an image thumbnail of the Asset using pdfAsset. Individual options include:
    • assetThumbVolumeHandle: An optional parameter for specifying the Volume Handle for the Thumbnail.
  • dumbThumb: Generates a simple thumbnail image (without Asset) using the pdf method.
  • Thumbnail customization options for both assetThumb and dumbThumb include:
    • thumbType: Allows selection of thumbnail format from jpg, gif, webp, avif, and png.
    • thumbWidth: Specifies the width of the thumbnail.
    • thumbHeight: Specifies the height of the thumbnail.
    • thumbPage: Specifies the page to generate (first page is 0).
    • thumbTrim: Trims and centers the page.
    • thumbBgColor: Sets the background color of the thumbnail (default is white).
    • thumbTrimFrameColor: Changes the color of the trim frame.
• Bug Fix: Resolved an issue causing deletion of PDF files with the pdfAsset method, even without assetDelete. Also fixed minor bugs.
• Enhancement: Updated README.md with information about the newly added thumbnail generation options.

• Fix: Corrected the pluginVendorName for accurate synchronization with the plugin store.
• Fix: Corrected the composer.json file for accurate synchronization with the plugin store.
• Fix: Made revisions to README.md and fixed minor bugs.

• Feature: Introduced pdfAsset method, which can create, update, or retrieve a Craft CMS Asset.
• Enhancement: Added additional options to pdfOptions for the new pdfAsset method:
  • assetDelete: Deletes the temporary file after adding the Asset,
  • assetTitle: Sets a custom title for the stored Asset,
  • assetFilename: Sets a custom filename for the stored Asset,
  • assetSiteId: Sets a custom siteId for the Asset.
• Feature: Updated README with descriptions of the new method, options, and a guide on generating thumbnails for PDF Assets.
• Enhancement: Switched to the Craft License for legal reasons.

• Introduced an example for right-to-left (RTL) text
• Expanded pdfOptions with support for Watermark Images and Text
• Implemented functionality for automatic Table of Contents generation
• Implemented functionality for automatic Bookmarks generation

• Performed necessary code refactoring for the plugin.
• Introduced a new attribute to specify a custom temporary directory path.
• Added capability to set the PDF orientation to either portrait or landscape mode.
• Expanded format options beyond the default A4, effective since version 1.0.4.
• Included an example of a PDF thumbnail in the README.md documentation.

• Update CHANEGLOG and README

• Feature update for Craft CMS 4
• Add author option
• Add keywords option
• Enable manual page break mode (no_auto_page_break) option
• Add option to password protect of PDF

• Merged with @AramLoosman
• Remove unused function
• Add custom variables to footer and header
• Changed fontDirs variable in plugin code to fontDir as in README.md

• Minor changes
• Fix some typos in README.md
• Fixed encoding issues and minor mislead of comments in non-latin extended systems in files

• Update for Craft 4
• Now autoupdate of files works properly with PHP8.0.x like on examples

Fixed

• Corrected spelling errors in the plugin settings panel descriptions.
• Added checks for the existence of Twig or HTML files in the template, header, and footer parameters.
• Added checks for the existence of external classes of optional QR code generator package.
• Resolved an issue where setting an option to false could cause problems with the isset() function.

Added

• Enabled the generation of PDFs from inline code block content or custom URLs as the template, header, and footer parameters.

Changed

• Included an optional package for scraping external URLs with HTML Purifier.
• Added the URLPurify option to sanitize the HTML content scraped from URLs when installed optional package.
• Added the encoding option to specify the encoding for the URLPurify and mPDF input streams.

Enhancement

• Made QR Code package as optional and not installed by default.
• Implemented plugin default settings screen.

New Feature

• Added a new option to configure the plugin globally.
• Enabled installing additional packages from the Settings menu.

• Bug Fix: Fixed a bug that caused incorrect date validation of PDF file.
• Bug Fix: Fixed a bug that caused an error when using headers and footers.
• New Feature: Added a feature that allows you to include a QR code image in the template using qrdata and qrimg variables.

• New Feature: Introduced additional parameters for image thumbnail generation in pdfOptions for pdfAsset and pdf methods:
  • assetThumb: Generates an image thumbnail of the Asset using pdfAsset. Individual options include:
    • assetThumbVolumeHandle: An optional parameter for specifying the Volume Handle for the Thumbnail.
  • dumbThumb: Generates a simple thumbnail image (without Asset) using the pdf method.
  • Thumbnail customization options for both assetThumb and dumbThumb include:
    • thumbType: Allows selection of thumbnail format from jpg, gif, webp, avif, and png.
    • thumbWidth: Specifies the width of the thumbnail.
    • thumbHeight: Specifies the height of the thumbnail.
    • thumbPage: Specifies the page to generate (first page is 0).
    • thumbTrim: Trims and centers the page.
    • thumbBgColor: Sets the background color of the thumbnail (default is white).
    • thumbTrimFrameColor: Changes the color of the trim frame.
• Bug Fix: Resolved an issue causing deletion of PDF files with the pdfAsset method, even without assetDelete. Also fixed minor bugs.
• Enhancement: Updated README.md with information about the newly added thumbnail generation options.

• Fix: Corrected the composer.json file for accurate synchronization with the plugin store.
• Fix: Made revisions to README.md and fixed minor bugs.

• Feature: Introduced pdfAsset method, which can create, update, or retrieve a Craft CMS Asset.
• Enhancement: Added additional options to pdfOptions for the new pdfAsset method:
  • assetDelete: Deletes the temporary file after adding the Asset
  • assetTitle: Sets a custom title for the stored Asset
  • assetFilename: Sets a custom filename for the stored Asset
  • assetSiteId: Sets a custom siteId for the Asset
• Feature: Updated README with descriptions of the new method, options, and a guide on generating thumbnails for PDF Assets.
• Enhancement: Switched to the Craft License for legal reasons.

• Introduced an example for right-to-left (RTL) text
• Expanded pdfOptions with support for Watermark Images and Text
• Implemented functionality for automatic Table of Contents generation
• Implemented functionality for automatic Bookmarks generation

• Performed necessary code refactoring for the plugin.
• Introduced a new attribute to specify a custom temporary directory path.
• Added capability to set the PDF orientation to either portrait or landscape mode.
• Expanded format options beyond the default A4, effective since version 1.0.4.
• Included an example of a PDF thumbnail in the README.md documentation.

• Update Icon's, CHANEGLOG and README for Craft CMS 3

• Feature update for Craft CMS 3
• Add author option
• Add keywords option
• Enable manual page break mode (no_auto_page_break) option
• Add option to password protect of PDF

• Fix of fontDir bug, thanks to @iwe-hi

• Merged with @AramLoosman
• remove unused function
• add custom variables to footer and header
• changed fontDirs variable in plugin code to fontDir as in README.md

• Add custom fonts to include in template

• Added custom title to attributes
• Added custom variables to attributes
• Update README.MD

• Updated README.MD
• Rename the plugin

• Initial release
• PDF Generator for Craft 3