settings->debug_settings['enable_debug'] ) ) {
$this->enable_debug();
}
// include template specific custom functions
$this->load_template_functions();
// test mode
add_filter( 'wpo_wcpdf_document_use_historical_settings', array( $this, 'test_mode_settings' ), 15, 2 );
// page numbers & currency filters
add_filter( 'wpo_wcpdf_get_html', array( $this, 'format_page_number_placeholders' ), 10, 2 );
add_action( 'wpo_wcpdf_after_dompdf_render', array( $this, 'page_number_replacements' ), 9, 2 );
add_filter( 'wpo_wcpdf_pdf_filters', array( $this, 'pdf_currency_filters' ) );
add_filter( 'wpo_wcpdf_html_filters', array( $this, 'html_currency_filters' ) );
// scheduled attachments cleanup (following settings on Advanced tab)
add_action( 'wp_scheduled_delete', array( $this, 'schedule_temporary_files_cleanup' ) );
// remove private data
if ( apply_filters( 'wpo_wcpdf_remove_order_personal_data', true ) ) {
add_action( 'woocommerce_privacy_remove_order_personal_data_meta', array( $this, 'remove_order_personal_data_meta' ), 10, 1 );
add_action( 'woocommerce_privacy_remove_order_personal_data', array( $this, 'remove_order_personal_data' ), 10, 1 );
add_filter( 'wpo_wcpdf_document_is_allowed', array( $this, 'disable_anonymized' ), 11, 2 );
}
// export private data
add_action( 'woocommerce_privacy_export_order_personal_data_meta', array( $this, 'export_order_personal_data_meta' ), 10, 1 );
// apply header logo height
add_action( 'wpo_wcpdf_custom_styles', array( $this, 'set_header_logo_height' ), 9, 2 );
// show notice of missing required directories
add_action( 'admin_notices', array( $this, 'no_dir_notice' ), 1 );
// add custom webhook topics for documents
add_filter( 'woocommerce_webhook_topic_hooks', array( $this, 'wc_webhook_topic_hooks' ), 10, 2 );
add_filter( 'woocommerce_valid_webhook_events', array( $this, 'wc_webhook_topic_events' ) );
add_filter( 'woocommerce_webhook_topics', array( $this, 'wc_webhook_topics' ) );
add_action( 'wpo_wcpdf_save_document', array( $this, 'wc_webhook_trigger' ), 10, 2 );
// Add due date via action hook for legacy templates
add_action( 'wpo_wcpdf_after_order_data', array( $this, 'display_due_date_table_row' ), 10, 2 );
add_action( 'wpo_wcpdf_delete_document', array( $this, 'log_document_deletion_to_order_notes' ) );
// Add document link to emails
add_action( 'init', array( $this, 'handle_document_link_in_emails' ) );
}
/**
* Attach document to WooCommerce email
*/
public function attach_document_to_email( $attachments, $email_id, $order, $email = null ) {
// check if all variables properly set
if ( ! is_object( $order ) || ! isset( $email_id ) ) {
return $attachments;
}
// allow third party emails to swap the order object
$order = apply_filters( 'wpo_wcpdf_email_order_object', $order, $email_id, $email );
// Skip User emails
if ( get_class( $order ) == 'WP_User' ) {
return $attachments;
}
$order_id = is_callable( array( $order, 'get_id' ) ) ? $order->get_id() : false;
if ( ! ( $order instanceof \WC_Order || is_subclass_of( $order, '\WC_Abstract_Order') ) && $order_id == false ) {
return $attachments;
}
// WooCommerce Booking compatibility
if ( get_post_type( $order_id ) == 'wc_booking' && isset( $order->order ) && ! empty( $order->order ) ) {
// $order is actually a WC_Booking object!
$order = $order->order;
$order_id = $order->get_id();
}
// do not process low stock notifications, user emails etc!
if ( in_array( $email_id, array( 'no_stock', 'low_stock', 'backorder', 'customer_new_account', 'customer_reset_password' ) ) ) {
return $attachments;
}
// final check on order object
if ( ! ( $order instanceof \WC_Order || is_subclass_of( $order, '\WC_Abstract_Order' ) ) ) {
return $attachments;
}
// clear pdf files from temp folder (from http://stackoverflow.com/a/13468943/1446634)
// array_map('unlink', ( glob( $tmp_path.'*.pdf' ) ? glob( $tmp_path.'*.pdf' ) : array() ) );
// disable deprecation notices during email sending
add_filter( 'wcpdf_disable_deprecation_notices', '__return_true' );
// reload translations because WC may have switched to site locale (by setting the plugin_locale filter to site locale in wc_switch_to_site_locale())
if ( apply_filters( 'wpo_wcpdf_allow_reload_attachment_translations', true ) ) {
WPO_WCPDF()->translations();
do_action( 'wpo_wcpdf_reload_attachment_translations' );
}
$attach_to_document_types = $this->get_documents_for_email( $email_id, $order );
$semaphore = new Semaphore( "attach_doc_to_email_{$email_id}_from_order_{$order_id}" );
if ( $semaphore->lock() ) {
$semaphore->log( sprintf( 'Lock acquired for attach document to email for order ID# %s.', $order_id ), 'info' );
foreach ( $attach_to_document_types as $output_format => $document_types ) {
foreach ( $document_types as $document_type ) {
$email_order = apply_filters( 'wpo_wcpdf_email_attachment_order', $order, $email, $document_type );
$email_order_id = $email_order->get_id();
do_action( 'wpo_wcpdf_before_attachment_creation', $email_order, $email_id, $document_type );
try {
// log document generation to order notes
add_action( 'wpo_wcpdf_init_document', function( $document ) {
$this->log_document_creation_to_order_notes( $document, 'email_attachment' );
$this->log_document_creation_trigger_to_order_meta( $document, 'email_attachment' );
$this->mark_document_printed( $document, 'email_attachment' );
} );
// prepare document
// we use ID to force to reloading the order to make sure that all meta data is up to date.
// this is especially important when multiple emails with the PDF document are sent in the same session
$document = wcpdf_get_document( $document_type, (array) $email_order_id, true );
if ( ! $document ) { // something went wrong, continue trying with other documents
wcpdf_log_error( "Couldn't get the document object for email attachment. document type: {$document_type}, output format: {$output_format}, email order ID: #{$email_order_id}", 'critical' );
continue;
}
$attachment = wcpdf_get_document_file( $document, $output_format );
if ( $attachment ) {
$attachments[] = $attachment;
} else {
continue;
}
do_action( 'wpo_wcpdf_email_attachment', $attachment, $document_type, $document, $output_format );
} catch ( \Exception $e ) {
wcpdf_log_error( $e->getMessage(), 'critical', $e );
continue;
} catch ( DompdfException $e ) {
wcpdf_log_error( 'DOMPDF exception: '.$e->getMessage(), 'critical', $e );
continue;
} catch ( FileWriteException $e ) {
wcpdf_log_error( 'UBL FileWrite exception: '.$e->getMessage(), 'critical', $e );
continue;
} catch ( \Error $e ) {
wcpdf_log_error( $e->getMessage(), 'critical', $e );
continue;
}
}
}
if ( $semaphore->release() ) {
$semaphore->log( sprintf( 'Lock released for attach document to email for order ID# %s.', $order_id ), 'info' );
}
} else {
$semaphore->log( sprintf( 'Couldn\'t get the lock for attach document to email for order ID# %s.', $order_id ), 'critical' );
}
remove_filter( 'wcpdf_disable_deprecation_notices', '__return_true' );
return $attachments;
}
public function get_document_pdf_attachment( $document, $tmp_path ) {
$wp_filesystem = wpo_wcpdf_get_wp_filesystem();
$filename = $document->get_filename();
$pdf_path = $tmp_path . $filename;
$document_type = $document->get_type();
$order_id = isset( $document->order ) ? $document->order->get_id() : 0;
$lock_file = apply_filters( 'wpo_wcpdf_lock_attachment_file', true );
$reuse_attachment = apply_filters( 'wpo_wcpdf_reuse_document_attachment', true, $document );
$max_reuse_age = apply_filters( 'wpo_wcpdf_reuse_attachment_age', 60 );
$lock_acquired = false;
try {
// Check if the file can be reused
if ( $wp_filesystem->exists( $pdf_path ) && $reuse_attachment && $max_reuse_age > 0 ) {
$filemtime = filemtime( $pdf_path );
if ( $filemtime && ( time() - $filemtime < $max_reuse_age ) ) {
return $pdf_path;
}
}
// Get PDF data and set up the Semaphore
$pdf_data = $document->get_pdf();
$semaphore = new Semaphore( "get_{$document_type}_document_pdf_attachment_for_order_{$order_id}", $max_reuse_age );
// Attempt to acquire the lock if needed
if ( $lock_file ) {
$lock_acquired = $semaphore->lock();
}
$write_file = ( $lock_file && $lock_acquired ) || ! $lock_file;
// Write the file
if ( $write_file ) {
$file_written = $wp_filesystem->put_contents( $pdf_path, $pdf_data, FS_CHMOD_FILE );
$semaphore->log( "PDF attachment written to {$pdf_path}", 'info' );
} else {
$semaphore->log( "PDF attachment not written to {$pdf_path} because the lock was not acquired", 'info' );
}
// Log if the lock was not acquired
if ( $lock_file && ! $lock_acquired ) {
$semaphore->log( "Couldn't get the lock for the PDF attachment", 'critical' );
}
} catch ( \Exception $e ) {
wcpdf_log_error( "Exception occurred: " . $e->getMessage(), 'critical' );
return false;
} finally {
// Release the lock if it was acquired
if ( $lock_acquired ) {
$semaphore->release();
$semaphore->log( 'Lock released for the PDF attachment.', 'info' );
}
}
// Check if the file was written successfully
if ( ! $file_written ) {
$message = "Couldn't write the PDF attachment to {$pdf_path}";
$semaphore->log( $message, 'critical' );
wcpdf_log_error( $message, 'critical' );
return false;
}
return $pdf_path;
}
public function get_document_ubl_attachment( $document, $tmp_path ) {
$ubl_maker = wcpdf_get_ubl_maker();
$ubl_maker->set_file_path( $tmp_path );
$ubl_document = new UblDocument();
$ubl_document->set_order_document( $document );
$builder = new SabreBuilder();
$contents = $builder->build( $ubl_document );
$filename = $document->get_filename( 'download', [ 'output' => 'ubl' ] );
$full_filename = $ubl_maker->write( $filename, $contents );
return $full_filename;
}
public function get_documents_for_email( $email_id, $order ) {
$documents = WPO_WCPDF()->documents->get_documents( 'enabled', 'any' );
$attach_documents = array();
foreach ( $documents as $document ) {
// Pro not activated, only attach Invoice
if ( ! function_exists( 'WPO_WCPDF_Pro' ) && 'invoice' !== $document->get_type() ) {
continue;
};
foreach ( $document->output_formats as $output_format ) {
if ( $document->is_enabled( $output_format ) ) {
$attach_documents[ $output_format ][ $document->get_type() ] = $document->get_attach_to_email_ids( $output_format );
}
}
}
$attach_documents = apply_filters( 'wpo_wcpdf_attach_documents', $attach_documents );
$document_types = array();
foreach ( $attach_documents as $output_format => $_documents ) {
foreach ( $_documents as $document_type => $attach_to_email_ids ) {
// legacy settings: convert abbreviated email_ids
foreach ( $attach_to_email_ids as $key => $attach_to_email_id ) {
if ( in_array( $attach_to_email_id, array( 'completed', 'processing' ) ) ) {
$attach_to_email_ids[ $key ] = "customer_{$attach_to_email_id}_order";
}
}
$extra_condition = apply_filters( 'wpo_wcpdf_custom_attachment_condition', true, $order, $email_id, $document_type, $output_format );
if ( 'ubl' === $output_format ) {
$extra_condition = apply_filters_deprecated( 'wpo_wcpdf_custom_ubl_attachment_condition', array( true, $order, $email_id, $document_type, $output_format ), '3.6.0', 'wpo_wcpdf_custom_attachment_condition' );
}
if ( in_array( $email_id, $attach_to_email_ids ) && $extra_condition ) {
$document_types[ $output_format ][] = $document_type;
}
}
}
return apply_filters( 'wpo_wcpdf_document_types_for_email', $document_types, $email_id, $order );
}
/**
* Load and generate the template output with ajax
*/
public function generate_document_ajax() {
$access_type = WPO_WCPDF()->endpoint->get_document_link_access_type();
$redirect_url = WPO_WCPDF()->endpoint->get_document_denied_frontend_redirect_url();
$request = stripslashes_deep( $_REQUEST );
// handle bulk actions access key (_wpnonce) and legacy access key (order_key)
if ( empty( $request['access_key'] ) ) {
foreach ( array( '_wpnonce', 'order_key' ) as $legacy_key ) {
if ( ! empty( $request[ $legacy_key ] ) ) {
$request['access_key'] = sanitize_text_field( $request[ $legacy_key ] );
}
}
}
$access_key = isset( $request['access_key'] ) ? sanitize_text_field( $request['access_key'] ) : '';
$action = isset( $request['action'] ) ? sanitize_text_field( $request['action'] ) : '';
$valid_nonce = ! empty( $access_key ) && ! empty( $action ) && wp_verify_nonce( $access_key, $action );
// check if we have the access key set
if ( empty( $access_key ) ) {
$message = esc_attr__( 'You do not have sufficient permissions to access this page. Reason: empty access key', 'woocommerce-pdf-invoices-packing-slips' );
wcpdf_safe_redirect_or_die( $redirect_url, $message );
}
// check if we have the action
if ( empty( $action) ) {
$message = esc_attr__( 'You do not have sufficient permissions to access this page. Reason: empty action', 'woocommerce-pdf-invoices-packing-slips' );
wcpdf_safe_redirect_or_die( $redirect_url, $message );
}
// Check the nonce for logged in users
if ( is_user_logged_in() && 'logged_in' === $access_type && ! $valid_nonce ) {
$message = esc_attr__( 'You do not have sufficient permissions to access this page. Reason: invalid nonce', 'woocommerce-pdf-invoices-packing-slips' );
wcpdf_safe_redirect_or_die( $redirect_url, $message );
}
// Check if all parameters are set
if ( empty( $request['document_type'] ) && ! empty( $request['template_type'] ) ) {
$request['document_type'] = sanitize_text_field( $request['template_type'] );
}
if ( empty( $request['order_ids'] ) ) {
$message = esc_attr__( "You haven't selected any orders", 'woocommerce-pdf-invoices-packing-slips' );
wcpdf_safe_redirect_or_die( null, $message );
}
if ( empty( $request['document_type'] ) ) {
$message = esc_attr__( 'Some of the export parameters are missing.', 'woocommerce-pdf-invoices-packing-slips' );
wcpdf_safe_redirect_or_die( null, $message );
}
// debug enabled by URL
if ( isset( $request['debug'] ) && ! ( is_user_logged_in() || isset( $request['my-account'] ) ) ) {
$this->enable_debug();
}
$document_type = sanitize_text_field( $request['document_type'] );
$order_ids = isset( $request['order_ids'] ) ? array_map( 'absint', explode( 'x', sanitize_text_field( $request['order_ids'] ) ) ) : array();
$order = false;
// single order
if ( count( $order_ids ) === 1 ) {
$order_id = reset( $order_ids );
$order = wc_get_order( $order_id );
if ( $order && $order->get_status() == 'auto-draft' ) {
$message = esc_attr__( 'You have to save the order before generating a PDF document for it.', 'woocommerce-pdf-invoices-packing-slips' );
wcpdf_safe_redirect_or_die( null, $message );
} elseif ( ! $order ) {
$message = sprintf(
/* translators: %s: Order ID */
esc_attr__( 'Could not find the order #%s.', 'woocommerce-pdf-invoices-packing-slips' ),
$order_id
);
wcpdf_safe_redirect_or_die( null, $message );
}
}
// Process oldest first: reverse $order_ids array if required
$sort_order = apply_filters( 'wpo_wcpdf_bulk_document_sort_order', 'ASC' );
$current_sort_order = ( count( $order_ids ) > 1 && end( $order_ids ) < reset( $order_ids ) ) ? 'DESC' : 'ASC';
if ( in_array( $sort_order, array( 'ASC', 'DESC' ) ) && $sort_order != $current_sort_order ) {
$order_ids = array_reverse( $order_ids );
}
// set default is allowed
$allowed = true;
// no order when it is a single order
if ( ! $order && 1 === count( $order_ids ) ) {
$allowed = false;
}
// check the user privileges
$full_permission = WPO_WCPDF()->admin->user_can_manage_document( $document_type );
// multi-order only allowed with full permissions
if ( ! $full_permission && ( count( $order_ids ) > 1 || isset( $request['bulk'] ) ) ) {
$allowed = false;
}
switch ( $access_type ) {
case 'logged_in':
if ( ! is_user_logged_in() || ! $valid_nonce ) {
$allowed = false;
break;
}
if ( ! $full_permission ) {
if ( ! isset( $request['my-account'] ) && ! isset( $request['shortcode'] ) ) {
$allowed = false;
break;
}
// check if current user is owner of order IMPORTANT!!!
if ( ! current_user_can( 'view_order', $order_ids[0] ) ) {
$allowed = false;
break;
}
}
break;
case 'full':
// check if we have a valid access when it's from bulk actions
if ( isset( $request['bulk'] ) && ! $valid_nonce ) {
$allowed = false;
break;
}
// check if we have a valid access key only when it's not from bulk actions
if ( ! isset( $request['bulk'] ) && $order && ! hash_equals( $order->get_order_key(), $access_key ) ) {
$allowed = false;
break;
}
break;
}
$allowed = apply_filters( 'wpo_wcpdf_check_privs', $allowed, $order_ids );
if ( ! $allowed ) {
$message = esc_attr__( 'You do not have sufficient permissions to access this page.', 'woocommerce-pdf-invoices-packing-slips' );
wcpdf_safe_redirect_or_die( $redirect_url, $message );
}
// if we got here, we're safe to go!
try {
// log document creation to order notes
if ( count( $order_ids ) > 1 && isset( $request['bulk'] ) ) {
add_action( 'wpo_wcpdf_init_document', function( $document ) use ( $request ) {
$this->log_document_creation_to_order_notes( $document, 'bulk' );
$this->log_document_creation_trigger_to_order_meta( $document, 'bulk', false, $request );
$this->mark_document_printed( $document, 'bulk' );
} );
} elseif ( isset( $request['my-account'] ) ) {
add_action( 'wpo_wcpdf_init_document', function( $document ) use ( $request ) {
$this->log_document_creation_to_order_notes( $document, 'my_account' );
$this->log_document_creation_trigger_to_order_meta( $document, 'my_account', false, $request );
$this->mark_document_printed( $document, 'my_account' );
} );
} else {
add_action( 'wpo_wcpdf_init_document', function( $document ) use ( $request ) {
$this->log_document_creation_to_order_notes( $document, 'single' );
$this->log_document_creation_trigger_to_order_meta( $document, 'single', false, $request );
$this->mark_document_printed( $document, 'single' );
} );
}
// get document
$document = wcpdf_get_document( $document_type, $order_ids, true );
if ( $document ) {
do_action( 'wpo_wcpdf_document_created_manually', $document, $order_ids ); // note that $order_ids is filtered and may not be the same as the order IDs used for the document (which can be fetched from the document object itself with $document->order_ids)
$output_format = WPO_WCPDF()->settings->get_output_format( $document, $request );
switch ( $output_format ) {
case 'ubl':
$document->output_ubl();
break;
case 'html':
add_filter( 'wpo_wcpdf_use_path', '__return_false' );
$document->output_html();
break;
case 'pdf':
default:
if ( has_action( 'wpo_wcpdf_created_manually' ) ) {
do_action( 'wpo_wcpdf_created_manually', $document->get_pdf(), $document->get_filename() );
}
$output_mode = WPO_WCPDF()->settings->get_output_mode( $document_type );
$document->output_pdf( $output_mode );
break;
}
} else {
$message = sprintf(
/* translators: document type */
esc_html__( "Document of type '%s' for the selected order(s) could not be generated", 'woocommerce-pdf-invoices-packing-slips' ),
$document_type
);
wcpdf_safe_redirect_or_die( null, $message );
}
} catch ( DompdfException $e ) {
$message = 'DOMPDF Exception: '.$e->getMessage();
wcpdf_log_error( $message, 'critical', $e );
wcpdf_output_error( $message, 'critical', $e );
} catch ( FileWriteException $e ) {
$message = 'UBL FileWrite Exception: '.$e->getMessage();
wcpdf_log_error( $message, 'critical', $e );
wcpdf_output_error( $message, 'critical', $e );
} catch ( \Exception $e ) {
$message = 'Exception: '.$e->getMessage();
wcpdf_log_error( $message, 'critical', $e );
wcpdf_output_error( $message, 'critical', $e );
} catch ( \Error $e ) {
$message = 'Fatal error: '.$e->getMessage();
wcpdf_log_error( $message, 'critical', $e );
wcpdf_output_error( $message, 'critical', $e );
}
exit;
}
/**
* Include template specific custom functions
*/
private function load_template_functions() {
$file = trailingslashit( WPO_WCPDF()->settings->get_template_path() ) . 'template-functions.php';
if ( file_exists( $file ) ) {
$loaded = @include_once( $file );
if ( $loaded === false ) {
wcpdf_log_error( sprintf( 'Failed to load template functions: %s', $file ), 'critical' );
}
}
}
/**
* Return tmp path for different plugin processes
*/
public function get_tmp_path( $type = '' ) {
$tmp_base = $this->get_tmp_base();
// don't continue if we don't have an upload dir
if ($tmp_base === false) {
return false;
}
// check if tmp folder exists => if not, initialize
if ( ! @is_dir( $tmp_base ) || ! wp_is_writable( $tmp_base ) ) {
$this->init_tmp();
}
if ( empty( $type ) ) {
return $tmp_base;
}
switch ( $type ) {
case 'dompdf':
$tmp_path = $tmp_base . 'dompdf';
break;
case 'ubl':
$tmp_path = $tmp_base . 'ubl';
break;
case 'font_cache':
case 'fonts':
$tmp_path = $tmp_base . 'fonts';
break;
case 'attachments':
$tmp_path = $tmp_base . 'attachments/';
break;
default:
$tmp_path = $tmp_base . $type;
break;
}
$wp_filesystem = wpo_wcpdf_get_wp_filesystem();
// double check for existence, in case tmp_base was installed, but subfolder not created
if ( ! $wp_filesystem->is_dir( $tmp_path ) ) {
$dir = $wp_filesystem->mkdir( $tmp_path );
if ( ! $dir ) {
update_option( 'wpo_wcpdf_no_dir_error', $tmp_path );
wcpdf_log_error( "Unable to create folder {$tmp_path}", 'critical' );
return false;
}
} elseif( ! wp_is_writable( $tmp_path ) ) {
update_option( 'wpo_wcpdf_no_dir_error', $tmp_path );
wcpdf_log_error( "Temp folder {$tmp_path} not writable", 'critical' );
return false;
}
return apply_filters( "wpo_wcpdf_tmp_path_{$type}", $tmp_path );
}
/**
* return the base tmp folder (usually uploads)
*/
public function get_tmp_base ( $append_random_string = true ) {
// wp_upload_dir() is used to set the base temp folder, under which a
// 'wpo_wcpdf' folder and several subfolders are created
//
// wp_upload_dir() will:
// * default to WP_CONTENT_DIR/uploads
// * UNLESS the ‘UPLOADS’ constant is defined in wp-config (http://codex.wordpress.org/Editing_wp-config.php#Moving_uploads_folder)
//
// May also be overridden by the wpo_wcpdf_tmp_path filter
$wp_upload_base = $this->get_wp_upload_base();
if( $wp_upload_base ) {
if( $append_random_string && $code = $this->get_random_string() ) {
$tmp_base = $wp_upload_base . 'wpo_wcpdf_'.$code.'/';
} else {
$tmp_base = $wp_upload_base . 'wpo_wcpdf/';
}
} else {
$tmp_base = false;
}
$tmp_base = apply_filters( 'wpo_wcpdf_tmp_path', $tmp_base );
if ($tmp_base !== false) {
$tmp_base = trailingslashit( $tmp_base );
}
return $tmp_base;
}
/**
* Get WordPress uploads folder base
*/
public function get_wp_upload_base () {
$upload_dir = wp_upload_dir();
if ( ! empty($upload_dir['error']) ) {
$wp_upload_base = false;
} else {
$upload_base = trailingslashit( $upload_dir['basedir'] );
$wp_upload_base = $upload_base;
}
return $wp_upload_base;
}
/**
* Checks if the tmp subfolder has files
*
* @param string $subfolder Can be 'attachments', 'fonts', or 'dompdf'.
* @return bool
*/
public function tmp_subfolder_has_files( string $subfolder ): bool {
if ( empty( $subfolder ) || ! in_array( $subfolder, $this->subfolders, true ) ) {
wcpdf_log_error( sprintf( 'The directory %s is not a default tmp subfolder from this plugin.', $subfolder ), 'critical' );
return false;
}
$cache_key = "wpo_wcpdf_subfolder_{$subfolder}_has_files";
// Check cached value
$cached_value = get_transient( $cache_key );
if ( ! empty( $cached_value ) ) {
return wc_string_to_bool( $cached_value );
}
$tmp_path = untrailingslashit( $this->get_tmp_path( $subfolder ) );
// Define allowed extensions per subfolder
$allowed_extensions = array(
'attachments' => array( 'pdf' ),
'fonts' => array( 'ttf' ),
'dompdf' => array(), // All files
);
try {
$iterator = new \FilesystemIterator( $tmp_path, \FilesystemIterator::SKIP_DOTS );
foreach ( $iterator as $file ) {
// If we don't have a file extension restriction, return true immediately
if ( empty( $allowed_extensions[ $subfolder ] ) ) {
set_transient( $cache_key, 'yes', DAY_IN_SECONDS );
return true;
}
// Check if file extension matches the allowed list
$extension = strtolower( pathinfo( $file->getFilename(), PATHINFO_EXTENSION ) );
if ( in_array( $extension, $allowed_extensions[ $subfolder ], true ) ) {
set_transient( $cache_key, 'yes', DAY_IN_SECONDS );
return true;
}
}
} catch ( \Exception $e ) {
wcpdf_log_error( 'Error reading directory: ' . $e->getMessage(), 'critical' );
return false;
}
// If no files found, cache the result
set_transient( $cache_key, 'no', DAY_IN_SECONDS );
return false;
}
/**
* Maybe reinstall fonts
*
* @param bool $force force fonts reinstall
*
* @return void
*/
public function maybe_reinstall_fonts( bool $force = false ): void {
$has_font_files = $this->tmp_subfolder_has_files( 'fonts' );
if ( ! $has_font_files || $force ) {
$fonts_path = untrailingslashit( $this->get_tmp_path( 'fonts' ) );
// clear folder first
if ( function_exists( 'glob' ) && $files = glob( $fonts_path.'/*.*' ) ) {
$exclude_files = array( 'index.php', '.htaccess' );
foreach ( $files as $file ) {
if ( is_file( $file ) && ! in_array( basename( $file ), $exclude_files ) ) {
wp_delete_file( $file );
}
}
} else {
wcpdf_log_error( "Couldn't clear fonts tmp subfolder before copy fonts.", 'critical' );
}
// copy fonts
$this->copy_fonts( $fonts_path );
// save to cache
set_transient( 'wpo_wcpdf_subfolder_fonts_has_files', 'yes' , DAY_IN_SECONDS );
}
}
/**
* Generate random string
*/
public function generate_random_string() {
if ( function_exists( 'random_bytes' ) ) {
$code = bin2hex( random_bytes( 16 ) );
} else {
$code = md5( uniqid( wp_rand(), true ) );
}
// create option
update_option( 'wpo_wcpdf_random_string', $code );
}
/**
* Get random string
*/
public function get_random_string () {
$code = get_option( 'wpo_wcpdf_random_string', '' );
if ( ! empty( $code ) ) {
return esc_attr( $code );
} else {
return false;
}
}
/**
* Install/create plugin tmp folders
*/
public function init_tmp() {
// generate random string if don't exist
if( ! $this->get_random_string() ) {
$this->generate_random_string();
}
$tmp_base = $this->get_tmp_base(); // get tmp base
$wp_filesystem = wpo_wcpdf_get_wp_filesystem();
// create plugin base temp folder
if ( ! $wp_filesystem->is_dir( $tmp_base ) ) {
$dir = $wp_filesystem->mkdir( $tmp_base );
// don't continue if we don't have an upload dir
if ( ! $dir ) {
update_option( 'wpo_wcpdf_no_dir_error', $tmp_base );
wcpdf_log_error( "Unable to create temp folder {$tmp_base}", 'critical' );
return false;
}
} elseif( ! wp_is_writable( $tmp_base ) ) {
update_option( 'wpo_wcpdf_no_dir_error', $tmp_base );
wcpdf_log_error( "Temp folder {$tmp_base} not writable", 'critical' );
return false;
}
// create subfolders & protect
foreach ( $this->subfolders as $subfolder ) {
$path = $tmp_base . $subfolder . '/';
if ( ! $wp_filesystem->is_dir( $path ) ) {
$dir = $wp_filesystem->mkdir( $path );
// check if we have dir
if ( ! $dir ) {
update_option( 'wpo_wcpdf_no_dir_error', $path );
wcpdf_log_error( "Unable to create folder {$path}", 'critical' );
return false;
}
} elseif( ! wp_is_writable( $path ) ) {
update_option( 'wpo_wcpdf_no_dir_error', $path );
wcpdf_log_error( "Temp folder {$path} not writable", 'critical' );
return false;
}
// copy font files
if ( $subfolder == 'fonts' ) {
$this->copy_fonts( $path, false );
}
// create .htaccess file and empty index.php to protect in case an open webfolder is used!
$wp_filesystem->put_contents( $path . '.htaccess', 'deny from all', FS_CHMOD_FILE );
$wp_filesystem->put_contents( $path . 'index.php', '', FS_CHMOD_FILE );
}
}
public function no_dir_notice() {
if( is_admin() && ( $path = get_option( 'wpo_wcpdf_no_dir_error' ) ) ) {
// if all folders exist and are writable delete the option
if( $this->tmp_folders_exist_and_writable() ) {
delete_option( 'wpo_wcpdf_no_dir_error' );
// if not, show notice
} else {
if ( $path ) {
ob_start();
?>
PDF Invoices & Packing Slips for WooCommerce',
'' . wpo_wcpdf_escape_url_path_or_base64( $path ) . '
' // phpcs:ignore WordPress.Security.EscapeOutput.OutputNotEscaped
);
?>
is_dir( $new_path ) ) {
$dir = $wp_filesystem->mkdir( $new_path );
// check if we have dir
if ( ! $dir ) {
update_option( 'wpo_wcpdf_no_dir_error', $new_path );
wcpdf_log_error( "Unable to create folder {$new_path}", 'critical' );
return false;
}
} elseif ( ! wp_is_writable( $new_path ) ) {
update_option( 'wpo_wcpdf_no_dir_error', $new_path );
wcpdf_log_error( "Temp folder {$new_path} not writable", 'critical' );
return false;
}
// we have the directories, let's try to copy
try {
$result = copy_dir( $old_path, $new_path );
// delete old directory with contents
if( $result ) {
$wp_filesystem->delete( $old_path, true );
}
} catch ( \Error $e ) {
wcpdf_log_error( "Unable to copy directory contents: ".$e->getMessage(), 'critical', $e );
return;
}
}
/**
* checks if the plugin tmp folders exist and are writable
*/
private function tmp_folders_exist_and_writable()
{
// tmp base
$tmp_base = $this->get_tmp_base();
if( ! @is_dir( $tmp_base ) || ! wp_is_writable( $tmp_base ) ) {
return false;
}
// subfolders
foreach( $this->subfolders as $type ) {
$tmp_path = $this->get_tmp_path( $type );
if( ! @is_dir( $tmp_path ) || ! wp_is_writable( $tmp_base ) ) {
return false;
}
}
return true;
}
/**
* Copy DOMPDF fonts to wordpress tmp folder
*/
public function copy_fonts( $path = '', $merge_with_local = true ) {
// only copy fonts if the bundled dompdf library is used!
$default_pdf_maker = '\\WPO\\IPS\\Makers\\PDFMaker';
if ( $default_pdf_maker !== apply_filters( 'wpo_wcpdf_pdf_maker', $default_pdf_maker ) ) {
return;
}
if ( empty( $path ) ) {
$path = $this->get_tmp_path( 'fonts' );
}
$path = trailingslashit( $path );
// get local font dir from filtered options
$dompdf_options = apply_filters( 'wpo_wcpdf_dompdf_options', array(
'defaultFont' => 'dejavu sans',
'tempDir' => $this->get_tmp_path( 'dompdf' ),
'logOutputFile' => $this->get_tmp_path( 'dompdf' ) . "/log.htm",
'fontDir' => $path,
'fontCache' => $path,
'isRemoteEnabled' => true,
'isFontSubsettingEnabled' => true,
'isHtml5ParserEnabled' => true,
) );
$fontDir = $dompdf_options['fontDir'];
$synchronizer = WPO_WCPDF()->font_synchronizer;
$synchronizer->sync( $fontDir, $merge_with_local );
}
public function disable_free( $allowed, $document ) {
if( ! $document->exists() && ! empty($order = $document->order) ) {
if ( ! is_callable( array($order, 'get_total') ) ) {
return false;
}
// check order total & setting
$order_total = $order->get_total();
if ( $order_total == 0 && $document->get_setting('disable_free') ) {
return false;
} else {
return $allowed;
}
} else {
return $allowed;
}
}
public function disable_anonymized( $allowed, $document ) {
if ( ! empty( $document->order ) && ! empty( $anonymized = $document->order->get_meta( '_anonymized' ) ) ) {
if ( apply_filters( 'wpo_wcpdf_disallow_anonymized_order_document', wc_string_to_bool( $anonymized ), $this ) ) {
$allowed = false;
}
}
return $allowed;
}
public function test_mode_settings( $use_historical_settings, $document ) {
if ( isset( WPO_WCPDF()->settings->general_settings['test_mode'] ) ) {
$use_historical_settings = false;
}
return $use_historical_settings;
}
/**
* Adds spans around placeholders to be able to make replacement (page count) and css (page number)
*/
public function format_page_number_placeholders ( $html, $document ) {
if ( ! empty( $html ) ) {
$html = str_replace( '{{PAGE_COUNT}}', '^C^', $html );
$html = str_replace( '{{PAGE_NUM}}', '', $html );
}
return $html;
}
/**
* Replace {{PAGE_COUNT}} placeholder with total page count
*/
public function page_number_replacements ( $dompdf, $html ) {
$placeholder = '^C^';
// create placeholder version with ASCII 0 spaces (dompdf 0.8)
$placeholder_0 = '';
$placeholder_chars = str_split($placeholder);
foreach ($placeholder_chars as $placeholder_char) {
$placeholder_0 .= chr(0).$placeholder_char;
}
// check if placeholder is used
if ( ! empty( $html ) && false !== strpos( $html, $placeholder ) ) {
foreach ( $dompdf->get_canvas()->get_cpdf()->objects as &$object ) {
if ( array_key_exists( "c", $object ) && ! empty( $object["c"] ) && false !== strpos( $object["c"], $placeholder ) ) {
$object["c"] = str_replace( array( $placeholder, $placeholder_0 ) , $dompdf->get_canvas()->get_page_count() , $object["c"] );
} elseif ( array_key_exists( "c", $object ) && ! empty( $object["c"] ) && false !== strpos( $object["c"], $placeholder_0 ) ) {
$object["c"] = str_replace( array( $placeholder, $placeholder_0 ) , chr(0).$dompdf->get_canvas()->get_page_count() , $object["c"] );
}
}
}
return $dompdf;
}
public function pdf_currency_filters( $filters ) {
if ( isset( WPO_WCPDF()->settings->general_settings['currency_font'] ) ) {
$filters[] = array( 'woocommerce_currency_symbol', array( $this, 'use_currency_font' ), 10001, 2 );
// 'wpo_wcpdf_custom_styles' is actually an action, but WP handles them with the same functions
$filters[] = array( 'wpo_wcpdf_custom_styles', array( $this, 'currency_symbol_font_styles' ) );
}
return $filters;
}
public function html_currency_filters( $filters ) {
// only apply these fixes if the bundled dompdf version is used!
if ( wcpdf_pdf_maker_is_default() ) {
$filters[] = array( 'woocommerce_currency_symbol', array( $this, 'use_currency_code' ), 10001, 2 );
}
return $filters;
}
/**
* Use currency symbol font (when enabled in options)
* @param string $currency_symbol Currency symbol
* @param string $currency Currency
*
* @return string Currency symbol
*/
public function use_currency_font( $currency_symbol, $currency ) {
$currency_symbol = sprintf( '%s', $currency_symbol );
return $currency_symbol;
}
/**
* Set currency font CSS
*/
public function currency_symbol_font_styles () {
?>
.wcpdf-currency-symbol { font-family: 'Currencies'; }
get_rtl_currencies() ) ) {
$currency_symbol = $currency;
}
return $currency_symbol;
}
/**
* Get all currencies that require RTL text direction support
*
* @return array ISO currency codes
*/
public function get_rtl_currencies() {
return array( 'AED', 'BHD', 'DZD', 'IQD', 'IRR', 'JOD', 'KWD', 'LBP', 'LYD', 'MAD', 'MVR', 'OMR', 'QAR', 'SAR', 'SYP', 'TND', 'YER' );
}
/**
* Apply header logo height from settings
*/
public function set_header_logo_height( $document_type, $document = null ) {
if ( !empty($document) && $header_logo_height = $document->get_header_logo_height() ) {
?>
td.header img {
max-height: ;
}
settings->debug_settings['enable_cleanup'] ) ) {
return;
}
$cleanup_age_days = isset( WPO_WCPDF()->settings->debug_settings['cleanup_days'] ) ? floatval( WPO_WCPDF()->settings->debug_settings['cleanup_days'] ) : 7.0;
$delete_timestamp = time() - ( intval ( DAY_IN_SECONDS * $cleanup_age_days ) );
$this->temporary_files_cleanup( $delete_timestamp );
}
/**
* Temporary files cleanup from paths
* @param int $delete_timestamp timestamp of the date/time before which to clean up files
*
* @return array Output message
*/
public function temporary_files_cleanup( int $delete_timestamp = 0 ): array {
$wp_filesystem = wpo_wcpdf_get_wp_filesystem();
$delete_before = ! empty( $delete_timestamp ) ? intval( $delete_timestamp ) : time();
$paths_to_cleanup = apply_filters( 'wpo_wcpdf_cleanup_tmp_paths', array(
$this->get_tmp_path( 'attachments' ),
$this->get_tmp_path( 'dompdf' ),
) );
$excluded_files = apply_filters( 'wpo_wcpdf_cleanup_excluded_files', array(
'index.php',
'.htaccess',
'log.htm',
) );
apply_filters_deprecated( 'wpo_wcpdf_cleanup_folders_level', array( 3 ), '3.9.1', '', 'This filter is no longer necessary.' );
$files = array();
$success = 0;
$error = 0;
$output = array();
// Gather all files from the paths
foreach ( $paths_to_cleanup as $path ) {
if ( $wp_filesystem->is_dir( $path ) ) {
$listed_files = $wp_filesystem->dirlist( $path, true, true );
if ( $listed_files ) {
foreach ( $listed_files as $fileinfo ) {
$file_path = trailingslashit( $path ) . $fileinfo['name'];
$basename = wp_basename( $file_path );
// Exclude specific files before adding to list
if ( ! in_array( $basename, $excluded_files ) && $wp_filesystem->exists( $file_path ) && ! $wp_filesystem->is_dir( $file_path ) ) {
$files[] = $file_path;
}
}
}
}
}
// No files to delete
if ( empty( $files ) ) {
$output['success'] = esc_html__( 'Nothing to delete!', 'woocommerce-pdf-invoices-packing-slips' );
return $output;
}
// Process and delete files
foreach ( $files as $file ) {
$file_timestamp = $wp_filesystem->mtime( $file );
// Delete file if it's older than the specified timestamp
if ( $file_timestamp < $delete_before ) {
if ( $wp_filesystem->delete( $file ) ) {
$success++;
} else {
$error++;
}
}
}
if ( $error > 0 ) {
$message_error = sprintf(
/* translators: %1$d is the number of files that couldn't be deleted, %2$d is the number of successfully deleted files */
_n(
'Unable to delete %1$d file! (deleted %2$d)',
'Unable to delete %1$d files! (deleted %2$d)',
$error,
'woocommerce-pdf-invoices-packing-slips'
),
$error,
$success
);
$output['error'] = $message_error;
} else {
$message_success = sprintf(
/* translators: %d is the number of files successfully deleted */
_n(
'Successfully deleted %d file!',
'Successfully deleted %d files!',
$success,
'woocommerce-pdf-invoices-packing-slips'
),
$success
);
$output['success'] = $message_success;
}
return $output;
}
/**
* Remove all invoice data when requested
*/
public function remove_order_personal_data_meta( $meta_to_remove ) {
$wcpdf_private_meta = array(
'_wcpdf_invoice_number' => 'numeric_id',
'_wcpdf_invoice_number_data' => 'array',
'_wcpdf_invoice_date' => 'timestamp',
'_wcpdf_invoice_date_formatted' => 'date',
);
return $meta_to_remove + $wcpdf_private_meta;
}
/**
* Remove references to order in number store tables when removing WC data
*/
public function remove_order_personal_data( $order ) {
global $wpdb;
// remove order ID from number stores
$number_stores = apply_filters( "wpo_wcpdf_privacy_number_stores", array( 'invoice_number' ) );
foreach ( $number_stores as $store_name ) {
$order_id = $order->get_id();
$table_name = apply_filters( "wpo_wcpdf_number_store_table_name", "{$wpdb->prefix}wcpdf_{$store_name}", $store_name, 'auto_increment' ); // i.e. wp_wcpdf_invoice_number
$wpdb->query( // phpcs:ignore WordPress.DB.DirectDatabaseQuery.NoCaching, WordPress.DB.DirectDatabaseQuery.DirectQuery
$wpdb->prepare(
"UPDATE " . esc_sql( $table_name ) . " SET order_id = 0 WHERE order_id = %s",
$order_id
)
);
}
}
/**
* Export all invoice data when requested
*/
public function export_order_personal_data_meta( $meta_to_export ) {
$private_address_meta = array(
// _wcpdf_invoice_number_data & _wcpdf_invoice_date are duplicates of the below and therefore not included
'_wcpdf_invoice_number' => esc_html__( 'Invoice Number', 'woocommerce-pdf-invoices-packing-slips' ),
'_wcpdf_invoice_date_formatted' => esc_html__( 'Invoice Date', 'woocommerce-pdf-invoices-packing-slips' ),
);
return $meta_to_export + $private_address_meta;
}
/**
* Set the default PHPMailer validator to 'php' ( which uses filter_var($address, FILTER_VALIDATE_EMAIL) )
* This avoids issues with the presence of attachments affecting email address validation in some distros of PHP 7.3
* See: https://wordpress.org/support/topic/invalid-address-setfrom/#post-11583815
* Fixed in WP5.5 due to upgrade to newer PHPMailer
*/
public function set_phpmailer_validator( $mailArray ) {
if ( version_compare( get_bloginfo( 'version' ), '5.5-dev', '<' ) ) {
global $phpmailer;
if ( ! ( $phpmailer instanceof \PHPMailer ) ) {
require_once ABSPATH . WPINC . '/class-phpmailer.php';
require_once ABSPATH . WPINC . '/class-smtp.php';
$phpmailer = new \PHPMailer( true );
}
$phpmailer::$validator = 'php';
}
return $mailArray;
}
/**
* Log document creation to order notes
*
* @param object $document
* @param string $trigger
*
* @return void
*/
public function log_document_creation_to_order_notes( object $document, string $trigger ) {
if ( empty( $document ) || empty( $trigger ) || ! isset( WPO_WCPDF()->settings->debug_settings['log_to_order_notes'] ) ) {
return;
}
$triggers = $this->get_document_triggers();
if ( ! array_key_exists( $trigger, $triggers ) ) {
return;
}
$user_note = '';
$manual_triggers = $this->get_document_triggers( 'manual' );
// Add user information if the trigger is manual.
if ( array_key_exists( $trigger, $manual_triggers ) ) {
$user = wp_get_current_user();
if ( ! empty( $user->user_login ) ) {
$user_note = sprintf(
' (%s: %s)',
__( 'User', 'woocommerce-pdf-invoices-packing-slips' ),
esc_html( $user->user_login )
);
}
}
$note = sprintf(
/* translators: 1. document title, 2. creation trigger */
__( 'PDF %1$s created via %2$s.', 'woocommerce-pdf-invoices-packing-slips' ),
$document->get_title(),
$triggers[ $trigger ]
);
$this->log_to_order_notes( $note . $user_note, $document );
}
/**
* Log document deletion to order notes.
*
* @param object $document
*
* @return void
*/
public function log_document_deletion_to_order_notes( object $document ): void {
if ( ! empty( WPO_WCPDF()->settings->debug_settings['log_to_order_notes'] ) ) {
$user_note = '';
$user = wp_get_current_user();
if ( ! empty( $user->user_login ) ) {
$user_note = sprintf(
' (%s: %s)',
__( 'User', 'woocommerce-pdf-invoices-packing-slips' ),
esc_html( $user->user_login )
);
}
$note = sprintf(
/* translators: document title */
__( 'PDF %s deleted.', 'woocommerce-pdf-invoices-packing-slips' ),
$document->get_title()
);
$this->log_to_order_notes( $note . $user_note, $document );
}
}
/**
* Log document printed to order notes
*
* @param object $document
* @param string $trigger
* @return void
*/
public function log_document_printed_to_order_notes( $document, $trigger ) {
$triggers = array_merge(
[ 'manually' => __( 'manually', 'woocommerce-pdf-invoices-packing-slips' ) ],
$this->get_document_triggers()
);
if ( ! empty( $document ) && isset( WPO_WCPDF()->settings->debug_settings['log_to_order_notes'] ) && ! empty( $trigger ) && array_key_exists( $trigger, $triggers ) ) {
/* translators: 1. document title, 2. creation trigger */
$message = __( '%1$s document marked as printed via %2$s.', 'woocommerce-pdf-invoices-packing-slips' );
$note = sprintf( $message, $document->get_title(), $triggers[$trigger] );
$this->log_to_order_notes( $note, $document );
}
}
/**
* Log document unmark printed to order notes
*
* @param object $document
* @param string $trigger
* @return void
*/
public function log_unmark_document_printed_to_order_notes( $document ) {
if ( ! empty( $document ) && isset( WPO_WCPDF()->settings->debug_settings['log_to_order_notes'] ) ) {
/* translators: 1. document title, 2. creation trigger */
$message = __( '%1$s document unmark printed.', 'woocommerce-pdf-invoices-packing-slips' );
$note = sprintf( $message, $document->get_title() );
$this->log_to_order_notes( $note, $document );
}
}
/**
* Logs to the order notes
*
* @param string $note
* @param object $document
* @return void
*/
public function log_to_order_notes( $note, $document ) {
if ( property_exists( $document, 'order_ids' ) && ! empty( $document->order_ids ) ) { // bulk document
$order_ids = $document->order_ids;
} else {
$order_ids = [ $document->order->get_id() ];
}
foreach ( $order_ids as $order_id ) {
$order = wc_get_order( $order_id );
if ( empty( $order ) ) {
continue;
}
if ( is_callable( array( $order, 'add_order_note' ) ) ) { // order
$order->add_order_note( wp_strip_all_tags( $note ) );
} elseif ( $document->is_refund( $order ) ) { // refund order
$parent_order = $document->get_refund_parent( $order );
if ( ! empty( $parent_order ) && is_callable( array( $parent_order, 'add_order_note' ) ) ) {
$parent_order->add_order_note( wp_strip_all_tags( $note ) );
}
}
}
}
/**
* Logs to the order meta
*
* @param object $document
* @param string $trigger
* @param boolean $force
* @param array|null $request
* @return void
*/
public function log_document_creation_trigger_to_order_meta( $document, $trigger, $force = false, $request = null ) {
if ( $trigger == 'bulk' && property_exists( $document, 'order_ids' ) && ! empty( $document->order_ids ) ) { // bulk document
$order_ids = $document->order_ids;
} elseif ( ! is_null( $document->order ) && is_callable( array( $document->order, 'get_id' ) ) ) {
$order_ids = array( $document->order->get_id() );
} elseif ( isset( $request['order_id'] ) ) {
$order_ids = array( absint( $request['order_id'] ) );
} else {
$order_ids = array();
}
if ( ! empty( $order_ids ) ) {
foreach ( $order_ids as $order_id ) {
$order = wc_get_order( $order_id );
if ( ! empty( $order ) ) {
if ( is_callable( [ $document, 'get_type' ] ) && $document->get_type() == 'credit-note' && is_callable( [ $order, 'get_parent_id' ] ) ) {
$order = wc_get_order( $order->get_parent_id() );
}
if ( empty( $order ) ) {
continue;
}
$status = $order->get_meta( "_wcpdf_{$document->slug}_creation_trigger" );
if ( true == $force || empty( $status ) ) {
$order->update_meta_data( "_wcpdf_{$document->slug}_creation_trigger", $trigger );
$order->save_meta_data();
}
}
}
}
}
/**
* Get the document triggers
*
* @param string $trigger_type The trigger type: 'manual', 'automatic', or 'all'. Defaults to 'all'.
*
* @return array
*/
public function get_document_triggers( string $trigger_type = 'all' ): array {
$manual_triggers = apply_filters( 'wpo_wcpdf_manual_document_triggers', array(
'single' => __( 'single order action', 'woocommerce-pdf-invoices-packing-slips' ),
'bulk' => __( 'bulk order action', 'woocommerce-pdf-invoices-packing-slips' ),
'my_account' => __( 'my account', 'woocommerce-pdf-invoices-packing-slips' ),
'document_data' => __( 'order document data (number and/or date set manually)', 'woocommerce-pdf-invoices-packing-slips' ),
) );
$automatic_triggers = apply_filters( 'wpo_wcpdf_automatic_document_triggers', array(
'email_attachment' => __( 'email attachment', 'woocommerce-pdf-invoices-packing-slips' ),
) );
switch ( $trigger_type ) {
case 'manual':
$triggers = $manual_triggers;
break;
case 'automatic':
$triggers = $automatic_triggers;
break;
case 'all':
default:
$triggers = array_merge( $manual_triggers, $automatic_triggers );
break;
}
return apply_filters( 'wpo_wcpdf_document_triggers', $triggers, $trigger_type );
}
/**
* Mark document printed
*
* @return void
*/
public function mark_document_printed( $document, $trigger ) {
$triggers = isset( $document->latest_settings['mark_printed'] ) && is_array( $document->latest_settings['mark_printed'] ) ? $document->latest_settings['mark_printed'] : [];
if ( ! empty( $document ) && ! $this->is_document_printed( $document ) ) {
if ( ! empty( $order = $document->order ) && ! empty( $trigger ) && in_array( $trigger, $triggers ) && apply_filters( 'wpo_wcpdf_allow_mark_document_printed', true, $document, $trigger ) ) {
if ( 'shop_order' === $order->get_type() ) {
$data = [
'date' => time(),
'trigger' => $trigger,
];
$order->update_meta_data( "_wcpdf_{$document->slug}_printed", $data );
$order->save_meta_data();
$this->log_document_printed_to_order_notes( $document, $trigger );
}
}
}
}
/**
* Unmark document printed
*
* @return void
*/
public function unmark_document_printed( $document ) {
if ( ! empty( $document ) && $this->is_document_printed( $document ) ) {
if ( ! empty( $order = $document->order ) && apply_filters( 'wpo_wcpdf_allow_unmark_document_printed', true, $document ) ) {
$meta_key = "_wcpdf_{$document->slug}_printed";
if ( 'shop_order' === $order->get_type() && ! empty( $order->get_meta( $meta_key ) ) ) {
$order->delete_meta_data( $meta_key );
$order->save_meta_data();
$this->log_unmark_document_printed_to_order_notes( $document );
}
}
}
}
/**
* AJAX request for mark/unmark document printed
*
* @return void
*/
public function document_printed_ajax() {
check_ajax_referer( 'printed_wpo_wcpdf', 'security' );
$data = stripslashes_deep( $_REQUEST );
$error = 0;
if ( ! empty( $data['action'] ) && $data['action'] == "printed_wpo_wcpdf" && ! empty( $data['event'] ) && ! empty( $data['document_type'] ) && ! empty( $data['order_id'] ) && ! empty( $data['trigger'] ) ) {
$document = wcpdf_get_document( esc_attr( $data['document_type'] ), esc_attr( $data['order_id'] ) );
$full_permission = WPO_WCPDF()->admin->user_can_manage_document( esc_attr( $data['document_type'] ) );
if ( ! empty( $document ) && ! empty( $order = $document->order ) && $full_permission ) {
switch ( esc_attr( $data['event'] ) ) {
case 'mark':
$this->mark_document_printed( $document, esc_attr( $data['trigger'] ) );
break;
case 'unmark':
$this->unmark_document_printed( $document );
break;
}
if ( is_callable( [ $order, 'get_edit_order_url' ] ) ) {
wp_redirect( $order->get_edit_order_url() );
} else {
wp_redirect( admin_url( 'post.php?action=edit&post=' . esc_attr( $data['order_id'] ) ) );
}
} else {
$error++;
}
} else {
$error++;
}
if ( $error > 0 ) {
wp_die(
sprintf(
/* translators: 1. document type, 2. mark/unmark */
esc_html__( 'Document of type %1$s for the selected order could not be marked as printed.', 'woocommerce-pdf-invoices-packing-slips' ),
esc_attr( $data['document_type'] )
)
);
}
}
/**
* Check if a document is printed
*
* @return bool
*/
public function is_document_printed( $document ) {
$is_printed = false;
if ( ! empty( $document ) && ! empty( $order = $document->order ) ) {
if ( 'shop_order' === $order->get_type() && ! empty( $printed_data = $order->get_meta( "_wcpdf_{$document->slug}_printed" ) ) ) {
$is_printed = true;
}
}
return $is_printed;
}
/**
* Check if a document can be manually marked as printed
*
* @return bool
*/
public function document_can_be_manually_marked_printed( $document ) {
$can_be_manually_marked_printed = false;
if ( empty( $document ) || ( property_exists( $document, 'is_bulk' ) && $document->is_bulk ) ) {
return $can_be_manually_marked_printed;
}
$document->save_settings();
$can_be_manually_marked_printed = false;
$document_exists = is_callable( array( $document, 'exists' ) ) ? $document->exists() : false;
$document_printed = $document_exists && is_callable( array( $document, 'printed' ) ) ? $document->printed() : false;
$triggers = isset( $document->latest_settings['mark_printed'] ) && is_array( $document->latest_settings['mark_printed'] ) ? $document->latest_settings['mark_printed'] : [];
$manually_print_enabled = in_array( 'manually', $triggers ) ? true : false;
if ( $document_exists && ! $document_printed && $manually_print_enabled ) {
$can_be_manually_marked_printed = true;
}
return apply_filters( 'wpo_wcpdf_document_can_be_manually_marked_printed', $can_be_manually_marked_printed, $document );
}
/**
* Get document printed data
*
* @return array
*/
public function get_document_printed_data( $document ) {
$data = [];
if ( ! empty( $document ) && $this->is_document_printed( $document ) && ! empty( $order = $document->order ) ) {
if ( 'shop_order' === $order->get_type() && ! empty( $printed_data = $order->get_meta( "_wcpdf_{$document->slug}_printed" ) ) ) {
$data = $printed_data;
}
}
return apply_filters( 'wpo_wcpdf_document_printed_data', $data, $document );
}
/**
* Enable error logging for administrators.
*/
public function enable_debug() {
if ( \WPO_WCPDF()->settings->user_can_manage_settings() ) {
error_reporting( E_ALL ); // phpcs:ignore WordPress.PHP.DevelopmentFunctions.prevent_path_disclosure_error_reporting
ini_set( 'display_errors', 1 ); // phpcs:ignore Squiz.PHP.DiscouragedFunctions.Discouraged
}
}
public function wc_webhook_topic_hooks( $topic_hooks, $wc_webhook ) {
$documents = WPO_WCPDF()->documents->get_documents();
foreach ($documents as $document) {
$topic_hooks["order.{$document->type}-saved"] = array(
"wpo_wcpdf_webhook_order_{$document->slug}_saved",
);
}
return $topic_hooks;
}
/**
* Adds custom webhook topic events.
*
* @param array $topic_events
*
* @return array
*/
public function wc_webhook_topic_events( array $topic_events = array() ): array {
$documents = WPO_WCPDF()->documents->get_documents();
foreach ( $documents as $document ) {
$topic_events[] = "{$document->type}-saved";
}
return $topic_events;
}
public function wc_webhook_topics( $topics ) {
$documents = WPO_WCPDF()->documents->get_documents();
foreach ($documents as $document) {
/* translators: document title */
$topics["order.{$document->type}-saved"] = esc_html( sprintf( __( 'Order %s Saved', 'woocommerce-pdf-invoices-packing-slips' ), $document->get_title() ) );
}
return $topics;
}
public function wc_webhook_trigger( $document, $order ) {
$this->reload_wpo_custom_webhooks();
do_action( "wpo_wcpdf_webhook_order_{$document->slug}_saved", $order->get_id() );
}
/**
* Reloads WooCommerce PDF Invoices webhooks to ensure custom hooks are processed.
*
* This function introduced to resolve an issue where WooCommerce
* webhooks were not enqueuing our plugin's custom hooks.
* The root cause is that the `wc_webhook_topic_hooks()` function, responsible
* for modifying hooks, is not executed in time. The `add_filter()` call that
* registers `wc_webhook_topic_hooks()` is executed after `apply_filters()`,
* preventing the `wpo_wcpdf_webhook_order_{$document->slug}_saved` action hook
* from being included in the list of webhook topics.
*
* https://github.com/wpovernight/woocommerce-pdf-invoices-packing-slips/issues/1083
*
* @return void
*/
private function reload_wpo_custom_webhooks() {
if (
! apply_filters( 'wpo_wcpdf_reload_wpo_custom_webhooks', true ) ||
! class_exists( 'WC_Data_Store' ) ||
! class_exists( 'WC_Webhook' )
) {
return;
}
$wpo_topic_hooks = $this->wc_webhook_topic_events();
$data_store = \WC_Data_Store::load( 'webhook' );
$webhooks = $data_store->get_webhooks_ids( 'active' );
if ( empty( $webhooks ) ) {
return;
}
foreach ( $webhooks as $webhook_id ) {
$webhook = new \WC_Webhook( $webhook_id );
if ( $webhook->get_pending_delivery() ) {
continue;
}
$webhook_topic = $webhook->get_topic();
if ( empty( $webhook_topic ) || ! is_string( $webhook_topic ) ) {
continue;
}
$topic = str_replace( 'order.', '', $webhook_topic );
if ( in_array( $topic, $wpo_topic_hooks, true ) ) {
$webhook->enqueue();
}
}
}
/**
* Display due date table row in the order data section for legacy templates.
*
* @param null|string $document_type
* @param null|\WC_Abstract_Order $order
*
* @return void
*/
public function display_due_date_table_row( ?string $document_type = null, ?\WC_Abstract_Order $order = null ): void {
if ( empty( $order ) || empty( $document_type ) ) {
return;
}
$current_template_path = explode( '/', WPO_WCPDF()->settings->get_template_path() );
$current_template = end( $current_template_path );
$premium_templates = array( 'Simple Premium', 'Modern', 'Business' );
// Return if the Simple template is selected. Due date is displayed through template.
if ( 'Simple' === $current_template ) {
return;
}
// Return if the Updated Premium Template is selected. Due date is displayed through template.
if (
function_exists( 'WPO_WCPDF_Templates' ) &&
version_compare( WPO_WCPDF_Templates()->version, '2.21.9', '>' ) &&
in_array( $current_template, $premium_templates, true )
) {
return;
}
$document = wcpdf_get_document( $document_type, $order );
if ( ! $document ) {
return;
}
$due_date_timestamp = is_callable( array( $document, 'get_due_date' ) ) ? $document->get_due_date() : 0;
if ( 0 >= $due_date_timestamp ) {
return;
}
$due_date = apply_filters_deprecated(
'wpo_wcpdf_due_date_display',
array(
date_i18n( wcpdf_date_format( $this, 'due_date' ), $due_date_timestamp ),
$due_date_timestamp,
$document_type,
$document
),
'3.9.0',
'wpo_wcpdf_document_due_date'
);
$due_date_title = is_callable( array( $document, 'get_due_date_title' ) ) ?
$document->get_due_date_title() : __( 'Due Date:', 'woocommerce-pdf-invoices-packing-slips' );
if ( ! empty( $due_date ) ) {
echo '
', esc_html( $due_date_title ), ' |
', esc_html( $due_date ), ' |
';
}
}
function handle_document_link_in_emails(): void {
$email_hooks = array();
$documents = WPO_WCPDF()->documents->get_documents();
foreach ( $documents as $document ) {
$document_settings = WPO_WCPDF()->settings->get_document_settings( $document->get_type(), 'pdf' );
$email_placement = $document_settings['include_email_link_placement'] ?? '';
if ( ! empty( $email_placement ) ) {
$email_hooks[] = 'woocommerce_email_' . $email_placement;
}
}
$email_hooks = apply_filters( 'wpo_wcpdf_add_document_link_to_email_hooks', $email_hooks );
foreach ( $email_hooks as $email_hook ) {
add_action( $email_hook, array( $this, 'add_document_link_to_email' ), 10, 4 );
}
}
/**
* Add document download link to the email.
*
* @param \WC_Abstract_Order $order
* @param bool $sent_to_admin
* @param bool $plain_text
* @param \WC_Email $email
*
* @return void
*/
public function add_document_link_to_email( \WC_Abstract_Order $order, bool $sent_to_admin, bool $plain_text, \WC_Email $email ): void {
// Check if document access type is 'full'.
$is_full_access_type = 'full' === WPO_WCPDF()->endpoint->get_document_link_access_type();
// Early exit if the requirements are not met
if ( ! apply_filters( 'wpo_wcpdf_add_document_link_to_email_requirements_met', $is_full_access_type, $order, $sent_to_admin, $plain_text, $email ) ) {
return;
}
$allowed_document_types = apply_filters( 'wpo_wcpdf_add_document_link_to_email_allowed_document_types', array( 'invoice' ), $order, $sent_to_admin, $plain_text, $email );
$documents = WPO_WCPDF()->documents->get_documents();
foreach ( $documents as $document ) {
$document_settings = WPO_WCPDF()->settings->get_document_settings( $document->get_type(), 'pdf' );
$selected_emails = $document_settings['include_email_link'] ?? array();
$is_allowed = in_array( $document->get_type(), $allowed_document_types, true ) && in_array( $email->id, $selected_emails, true );
if ( ! apply_filters( 'wpo_wcpdf_add_document_link_to_email_is_allowed', $is_allowed, $order, $sent_to_admin, $plain_text, $email ) ) {
continue;
}
$document = wcpdf_get_document( $document->get_type(), $order );
if ( ! $document ) {
continue;
}
if (
! $document->exists() &&
apply_filters( 'wpo_wcpdf_add_document_link_to_email_skip_missing_documents', false, $document, $order, $sent_to_admin, $plain_text, $email )
) {
continue;
}
$link_text = sprintf(
/* translators: %s: Document type */
__( 'View %s (PDF)', 'woocommerce-pdf-invoices-packing-slips' ),
wp_kses_post( $document->get_type() )
);
$link_url = WPO_WCPDF()->endpoint->get_document_link( $order, $document->get_type(), array(), true );
$document_link = sprintf(
'%s
',
esc_attr( 'wpo_wcpdf_' . $document->get_type() . '_document_link' ),
esc_url( $link_url ),
esc_html( $link_text )
);
echo wp_kses_post( apply_filters( 'wpo_wcpdf_add_document_download_link_to_email', $document_link, $document, $order, $sent_to_admin, $plain_text, $email ) );
}
}
}
endif; // class_exists