Version: v5

gfpdf_post_save_pdf

Description

This action is run right after a PDF is saved to disk. It allows you to copy the PDF to another location (do not move the PDF otherwise you'll break the PDF notifications).

It will be triggered when a Gravity Forms notification is sent AND the PDF is configured to be attached to it – this includes during the initial form submission and when resending notifications. It will also be triggered during the form submission when the Always Save PDF setting is enabled or when using GPDFAPI::create_pdf( $entry_id, $pdf_id ) method in our API.

You can also use the gfpdf_post_save_pdf_$form_id action if needed.

Parameters

$pdf_path | string

  • The full path to the generated PDF

$filename | string

  • The filename of the generated PDF

$settings | array

  • The current PDF's settings

$entry | array

  • The raw Gravity Form Entry array.

$form | array

  • The current Gravity Form array

Usage

This snippet shows you how to copy the generated PDF to a separate directory on your server. Keep in mind that unless the folder you copy to is placed outside the root website directory your PDFs will be publicly accessible from this new folder:

add_action( 'gfpdf_post_save_pdf', function( $pdf_path, $filename, $settings, $entry, $form ) {
/* Only move PDFs from form #2 */
if ( '2' == $form['id'] ) {
/* The directory we want to copy our PDF to */
$copy_to_dir = ABSPATH . 'PDFs/';
/* Create the directory if it doesn't exist */
if( ! is_dir( $copy_to_dir ) ) {
wp_mkdir_p( $copy_to_dir );
}
/* Ensure we get a unique filename for the directory we are copying to */
$filename = wp_unique_filename( $copy_to_dir, $filename );
/* Copy the PDF to the new directory */
copy( $pdf_path, $copy_to_dir . $filename );
}
}, 10, 5 );

You can also use the form-specific action and remove the IF statement:

add_action( 'gfpdf_post_save_pdf_2', function( $pdf_path, $filename, $settings, $entry, $form ) {
/* The directory we want to copy our PDF to */
$copy_to_dir = ABSPATH . 'PDFs/';
/* Create the directory if it doesn't exist */
if( ! is_dir( $copy_to_dir ) ) {
wp_mkdir_p( $copy_to_dir );
}
/* Ensure we get a unique filename for the directory we are copying to */
$filename = wp_unique_filename( $copy_to_dir, $filename );
/* Copy the PDF to the new directory */
copy( $pdf_path, $copy_to_dir . $filename );
}, 10, 5 );

You might also like to copy all PDFs to another directory and group them by their forms:

add_action( 'gfpdf_post_save_pdf', function( $pdf_path, $filename, $settings, $entry, $form ) {
/* The directory we want to copy our PDF to */
$copy_to_dir = ABSPATH . 'PDFs/' . $form['title'] . '/';
/* Create the directory if it doesn't exist */
if( ! is_dir( $copy_to_dir ) ) {
wp_mkdir_p( $copy_to_dir );
}
/* Ensure we get a unique filename for the directory we are copying to */
$filename = wp_unique_filename( $copy_to_dir, $filename );
/* Copy the PDF to the new directory */
copy( $pdf_path, $copy_to_dir . $filename );
}, 10, 5 );

Source Code

This action is located in the Model_PDF::generate_and_save_pdf() method of /src/model/Model_PDF.php.

Last updated on