v0.7.5

timriker · timriker · commit 3a418491fcc5 · 2026-04-15T16:42:14.000-06:00
diff --git a/CHANGELOG.md b/CHANGELOG.md
@@ -4,6 +4,12 @@ All notable changes to `woo-order-images` will be documented in this file.
 
 This project follows a pragmatic release history rather than a strict changelog format for older versions. Recent releases are documented in more detail.
 
+## [0.7.5] - 2026-04-15
+
+### Added
+- PDF Invoices & Packing Slips for WooCommerce integration: WOI customer-uploaded images now appear as inline thumbnails on invoices and packing slips. Thumbnails are embedded as base64 JPEG data URIs so the PDF renderer never makes an HTTP request, making it compatible with both admin-triggered PDFs and automated order-status emails.
+- Added a `Plugin URI` header for Woo Order Images, pointing to the GitHub project page so admin plugin lists (including WooCommerce status reports) can show a direct project link.
+
 ## [0.7.4] - 2026-03-29
 
 ### Fixed
diff --git a/includes/class-woi-admin-order-images.php b/includes/class-woi-admin-order-images.php
@@ -1752,4 +1752,99 @@ private function extend_tile_edges( $tile_img, $copy_x, $copy_y, $copy_w, $copy_
 			imagecopyresampled( $tile_img, $tile_img, $copy_right, 0, $copy_right - 1, 0, $full_w - $copy_right, $full_h, 1, $full_h );
 		}
 	}
+
+	/**
+	 * Generate a base64-encoded JPEG data URI of the cropped WOI image for embedding in PDF documents.
+	 *
+	 * Uses the item's stored spec (visible dimensions, puzzle config) and image entry (URL, crop, rotation)
+	 * to produce a small thumbnail suitable for mPDF/Dompdf without any HTTP requests.
+	 *
+	 * @param WC_Order_Item_Product $wc_item     The order line-item.
+	 * @param array                 $image_entry Single entry from the _woi_images meta array.
+	 * @param int                   $thumb_px    Maximum dimension (px) of the output thumbnail.
+	 * @return string  Data URI string, or empty string on failure.
+	 */
+	public static function generate_pdf_thumbnail_data_uri( $wc_item, $image_entry, $thumb_px = 120 ) {
+		$instance = new self();
+
+		$url      = isset( $image_entry['url'] ) ? (string) $image_entry['url'] : '';
+		$crop     = isset( $image_entry['crop'] ) && is_array( $image_entry['crop'] ) ? $image_entry['crop'] : array();
+		$rotation = isset( $image_entry['rotation'] ) ? WOI_Order_Images::normalize_rotation_value( $image_entry['rotation'] ) : 0;
+
+		if ( '' === $url ) {
+			return '';
+		}
+
+		$base_spec = $instance->get_item_spec( $wc_item );
+
+		// Build a no-bleed spec for thumbnail rendering so the output contains only the
+		// visible area without wrap-margin strips, which look odd at small sizes.
+		$thumb_spec                        = $base_spec;
+		$thumb_spec['wrap_margin']         = 0.0;
+		$thumb_spec['full_width']          = $base_spec['visible_width'];
+		$thumb_spec['full_height']         = $base_spec['visible_height'];
+		$thumb_spec['visible_width_percent']  = 100.0;
+		$thumb_spec['visible_height_percent'] = 100.0;
+
+		if ( ! empty( $base_spec['is_puzzle'] ) ) {
+			// For puzzle items, show the full assembled image rather than individual tiles.
+			$cols = max( 1, (int) $base_spec['puzzle_cols'] );
+			$rows = max( 1, (int) $base_spec['puzzle_rows'] );
+			$entry_cols = isset( $image_entry['puzzle_cols'] ) ? max( 0, (int) $image_entry['puzzle_cols'] ) : 0;
+			$entry_rows = isset( $image_entry['puzzle_rows'] ) ? max( 0, (int) $image_entry['puzzle_rows'] ) : 0;
+			if ( $entry_cols > 0 && $entry_rows > 0 ) {
+				$cols = $entry_cols;
+				$rows = $entry_rows;
+			}
+			$thumb_spec['visible_width']        = $base_spec['visible_width'] * $cols;
+			$thumb_spec['visible_height']       = $base_spec['visible_height'] * $rows;
+			$thumb_spec['full_width']           = $thumb_spec['visible_width'];
+			$thumb_spec['full_height']          = $thumb_spec['visible_height'];
+			$thumb_spec['visible_aspect_ratio'] = $thumb_spec['visible_height'] > 0
+				? $thumb_spec['visible_width'] / $thumb_spec['visible_height']
+				: 1.0;
+		} else {
+			$thumb_spec = $instance->get_oriented_spec_for_crop( $thumb_spec, $url, $crop, $rotation );
+		}
+
+		$jpeg = $instance->build_single_tile_jpeg( $url, $crop, $thumb_spec, $rotation );
+		if ( empty( $jpeg ) ) {
+			return '';
+		}
+
+		// Downsample to thumbnail dimensions so the PDF stays compact.
+		$src = @imagecreatefromstring( $jpeg );
+		if ( ! $src ) {
+			return '';
+		}
+
+		$sw    = imagesx( $src );
+		$sh    = imagesy( $src );
+		$scale = min( 1.0, (float) $thumb_px / max( 1, max( $sw, $sh ) ) );
+		$tw    = max( 1, (int) round( $sw * $scale ) );
+		$th    = max( 1, (int) round( $sh * $scale ) );
+
+		$thumb = imagecreatetruecolor( $tw, $th );
+		if ( ! $thumb ) {
+			imagedestroy( $src );
+			return '';
+		}
+
+		$white = imagecolorallocate( $thumb, 255, 255, 255 );
+		imagefill( $thumb, 0, 0, $white );
+		imagecopyresampled( $thumb, $src, 0, 0, 0, 0, $tw, $th, $sw, $sh );
+		imagedestroy( $src );
+
+		ob_start();
+		imagejpeg( $thumb, null, 85 );
+		$thumb_jpeg = ob_get_clean();
+		imagedestroy( $thumb );
+
+		if ( empty( $thumb_jpeg ) ) {
+			return '';
+		}
+
+		// phpcs:ignore WordPress.PHP.DiscouragedPHPFunctions.obfuscation_base64_encode
+		return 'data:image/jpeg;base64,' . base64_encode( $thumb_jpeg );
+	}
 }
diff --git a/includes/class-woi-pdf-invoices.php b/includes/class-woi-pdf-invoices.php
@@ -0,0 +1,70 @@
+<?php
+
+if ( ! defined( 'ABSPATH' ) ) {
+	exit;
+}
+
+/**
+ * Integrates Woo Order Images thumbnails into PDF Invoices & Packing Slips for WooCommerce
+ * (plugin slug: woocommerce-pdf-invoices-packing-slips, class: WPO_WCPDF).
+ *
+ * Hooks into wpo_wcpdf_after_item_meta to inject a small cropped JPEG thumbnail,
+ * encoded as a data URI, directly into the PDF HTML before the renderer sees it.
+ * This avoids any HTTP requests from the PDF engine (mPDF/Dompdf), so it works
+ * regardless of authentication context (admin-triggered or automated email).
+ */
+class WOI_PDF_Invoices {
+
+	public function init() {
+		// Register the hook unconditionally — it will never fire if WPO WCPDF is absent.
+		add_action( 'wpo_wcpdf_after_item_meta', array( $this, 'inject_thumbnails' ), 10, 3 );
+	}
+
+	/**
+	 * Output thumbnail(s) for a line item's WOI images into the PDF document.
+	 *
+	 * @param string   $document_type WPO document type slug ('invoice', 'packing-slip', etc.).
+	 * @param array    $item          WPO-processed item data array.  Key 'item' holds the
+	 *                                underlying WC_Order_Item_Product object.
+	 * @param WC_Order $order         The WooCommerce order.
+	 */
+	public function inject_thumbnails( $document_type, $item, $order ) {
+		if ( ! is_array( $item ) || ! isset( $item['item'] ) ) {
+			return;
+		}
+
+		$wc_item = $item['item'];
+		if ( ! $wc_item instanceof WC_Order_Item_Product ) {
+			return;
+		}
+
+		$images = $wc_item->get_meta( WOI_Order_Images::ORDER_META_IMAGES, true );
+		if ( empty( $images ) || ! is_array( $images ) ) {
+			return;
+		}
+
+		$thumb_html = '';
+		foreach ( $images as $image_entry ) {
+			if ( empty( $image_entry['url'] ) ) {
+				continue;
+			}
+
+			$data_uri = WOI_Admin_Order_Images::generate_pdf_thumbnail_data_uri( $wc_item, $image_entry );
+			if ( '' === $data_uri ) {
+				continue;
+			}
+
+			// Inline style only — mPDF/Dompdf have limited CSS support.
+			// max-height drives the row height; width:auto preserves aspect ratio.
+			$thumb_html .= '<img src="' . esc_attr( $data_uri ) . '" '
+				. 'style="max-height:60px;max-width:60px;width:auto;height:auto;'
+				. 'display:inline-block;vertical-align:middle;margin:2px;" alt="">';
+		}
+
+		if ( '' === $thumb_html ) {
+			return;
+		}
+
+		echo '<div style="margin-top:4px;line-height:0;">' . $thumb_html . '</div>'; // phpcs:ignore WordPress.Security.EscapeOutput.OutputNotEscaped
+	}
+}
diff --git a/includes/class-woi-plugin.php b/includes/class-woi-plugin.php
@@ -9,6 +9,7 @@
 require_once WOI_PLUGIN_DIR . 'includes/class-woi-frontend.php';
 require_once WOI_PLUGIN_DIR . 'includes/class-woi-order-images.php';
 require_once WOI_PLUGIN_DIR . 'includes/class-woi-settings.php';
+require_once WOI_PLUGIN_DIR . 'includes/class-woi-pdf-invoices.php';
 
 class WOI_Plugin {
 	private static $instance = null;
@@ -36,5 +37,8 @@ public function init() {
 
 		$admin_order_images = new WOI_Admin_Order_Images();
 		$admin_order_images->init();
+
+		$pdf_invoices = new WOI_PDF_Invoices();
+		$pdf_invoices->init();
 	}
 }
diff --git a/readme.txt b/readme.txt
@@ -4,7 +4,7 @@ Tags: woocommerce, product images, image upload, printing, puzzle
 Requires at least: 6.8
 Tested up to: 6.9.4
 Requires PHP: 7.4
-Stable tag: 0.7.4
+Stable tag: 0.7.5
 License: GPLv2 or later
 License URI: https://www.gnu.org/licenses/gpl-2.0.html
 
@@ -23,6 +23,7 @@ Key capabilities include:
 * Order-level print-sheet generation
 * Puzzle layouts with portrait and landscape grid support
 * Global print bleed, margins, watermark text, and page size settings
+* Optional integration with PDF Invoices & Packing Slips for WooCommerce (by WP Overnight) — customer-uploaded images appear as inline thumbnails on invoices and packing slips
 
 == Installation ==
 
@@ -70,6 +71,10 @@ This plugin bundles the following third-party library:
 
 == Changelog ==
 
+= 0.7.5 =
+* Added integration with PDF Invoices & Packing Slips for WooCommerce (by WP Overnight): customer-uploaded images now appear as inline thumbnails on invoices and packing slips. Thumbnails are embedded as JPEG data URIs so the PDF renderer makes no HTTP requests, making it compatible with both admin-triggered and automated email PDFs.
+* Added a `Plugin URI` header pointing to the GitHub project so admin plugin lists (including WooCommerce status reports) can link WOI to its project page.
+
 = 0.7.4 =
 * Fixed the GitHub release workflow to build from the exact pushed ref and to fail if a pushed tag version does not match the plugin version in the checked-out files.
 * Released the shared thumbnail-resolution and customer DPI warning improvements in a correctly versioned package.
diff --git a/woo-order-images.php b/woo-order-images.php
@@ -1,8 +1,9 @@
 <?php
 /**
  * Plugin Name: Woo Order Images
+ * Plugin URI: https://github.com/timriker/woo-order-images
  * Description: Collects customer image uploads for WooCommerce products and generates order print sheets, including puzzle layouts.
- * Version: 0.7.4
+ * Version: 0.7.5
  * Requires at least: 6.8
  * Requires PHP: 7.4
  * Requires Plugins: woocommerce
@@ -20,7 +21,7 @@
 }
 
 if ( ! defined( 'WOI_VERSION' ) ) {
-	define( 'WOI_VERSION', '0.7.4' );
+	define( 'WOI_VERSION', '0.7.5' );
 }
 
 if ( ! defined( 'WOI_PLUGIN_FILE' ) ) {

Original file line number	Diff line number	Diff line change
`@@ -9,6 +9,7 @@`
`9`	`9`	`require_once WOI_PLUGIN_DIR . 'includes/class-woi-frontend.php';`
`10`	`10`	`require_once WOI_PLUGIN_DIR . 'includes/class-woi-order-images.php';`
`11`	`11`	`require_once WOI_PLUGIN_DIR . 'includes/class-woi-settings.php';`
	`12`	`+require_once WOI_PLUGIN_DIR . 'includes/class-woi-pdf-invoices.php';`
`12`	`13`
`13`	`14`	`class WOI_Plugin {`
`14`	`15`	`private static $instance = null;`
`@@ -36,5 +37,8 @@ public function init() {`
`36`	`37`
`37`	`38`	`$admin_order_images = new WOI_Admin_Order_Images();`
`38`	`39`	`$admin_order_images->init();`
	`40`	`+`
	`41`	`+ $pdf_invoices = new WOI_PDF_Invoices();`
	`42`	`+ $pdf_invoices->init();`
`39`	`43`	`}`
`40`	`44`	`}`