gfpdf_mpdf_class_config

Description

This filter is used to modify the mPDF configuration settings which is passed to the mPDF object upon initialisation.

Version

This filter was added in Gravity PDF 5.2.

Parameters

$config | array

• The mPDF configuration settings

$form | array

• The current Gravity Forms array

$entry | array

• The raw Gravity Forms Entry array.

$settings | array

• The current PDF settings being processed

$Helper_PDF | object

• The initialised \GFPDF\Helper\Helper_PDF class

Usage

Gravity PDF has some very sane defaults for mPDF, but you may want to utilise one of their more advanced features or change the default settings. If so, this is the filter to use.

Below is a snippet to disable SSL verification while requesting images (and other assets) for inclusion within the PDF. You might do this if your host is running an outdated version of cURL or the OpenSSL library and the images aren't displaying:

add_filter( 'gfpdf_mpdf_class_config', function( $config, $form, $entry, $settings, $Helper_PDF ) {
	$config['curlAllowUnsafeSslRequests'] = true;

	return $config;
}, 10, 5 );

Another example is enabling the use of active form fields in PDFs. Keep in mind Gravity PDF does NOT support this feature, and our support team will not be able to assist you with any problems you encounter.

add_filter( 'gfpdf_mpdf_class_config', function( $config, $form, $entry, $settings, $Helper_PDF ) {

	/**
	 * Due to the large number of compatibility problems with active form fields in mPDF,
	 * Gravity PDF does not support them and they are disabled by default.
	 *
	 * Below is how you can turn this feature back on. Keep in mind our support team will not
	 * be able to assist if with any problems when this setting is active.
	 *
	 * For more information about active form fields in mPDF review the documentation
	 * http://mpdf.github.io/what-else-can-i-do/forms.html
	 */
	$config['useActiveForms'] = true;

	return $config;

}, 10, 5 );

Source Code

This filter is located in the Helper_PDF::begin_pdf() method of /src/helper/Helper_PDF.php.