class-thumbnails.php — Gallery : FooGallery 3.2.6

foogallery / includes / class-thumbnails.php

foogallery / includes Last commit date

class-thumbnails.php

340 lines

1	<?php
2
3	if ( ! defined( 'ABSPATH' ) ) {
4	exit;
5	}
6
7	/*
8	* FooGallery Thumbnail Resizing class
9	*/
10
11	if ( !class_exists( 'FooGallery_Thumbnails' ) ) {
12
13	class FooGallery_Thumbnails {
14
15	function __construct() {
16	add_filter( 'foogallery_attachment_resize_thumbnail', array( $this, 'resize' ), 10, 3 );
17
18	add_filter( 'foogallery_test_thumb_url', array( $this, 'override_test_thumb_url' ) );
19
20	add_filter( 'foogallery_thumbnail_resize_args', array( $this, 'check_for_force_original_thumb') );
21	}
22
23	function check_for_force_original_thumb( $args ){
24	global $current_foogallery;
25
26	if ( isset( $current_foogallery ) ) {
27	$args['force_use_original_thumb'] = $current_foogallery->force_use_original_thumbs;
28	}
29
30	return $args;
31	}
32
33	function resize( $original_image_src, $args, $thumbnail_object ) {
34	global $current_foogallery;
35	global $foogallery_last_generated_thumb_url;
36
37	$arg_defaults = array(
38	'width' => 0,
39	'height' => 0,
40	'crop' => true,
41	'jpeg_quality' => foogallery_thumbnail_jpeg_quality(),
42	'thumb_resize_animations' => true,
43	'foogallery_attachment_id'=> $thumbnail_object->ID
44	);
45
46	if ( isset( $current_foogallery ) ) {
47	$arg_defaults['foogallery_id'] = $current_foogallery->ID;
48	}
49
50	$args = wp_parse_args( $args, $arg_defaults );
51
52	//allow for plugins to change the thumbnail creation args
53	$args = apply_filters( 'foogallery_thumbnail_resize_args', $args, $original_image_src, $thumbnail_object );
54
55	//check the current arguments passed in by the shortcode
56	global $current_foogallery_arguments;
57	if ( isset( $current_foogallery_arguments ) && isset( $current_foogallery_arguments['template'] ) ) {
58	$thumbnail_args = apply_filters( 'foogallery_calculate_thumbnail_dimensions-' . $current_foogallery_arguments['template'], $args, $current_foogallery_arguments );
59	$args = wp_parse_args( $thumbnail_args, $args );
60	}
61
62	//allow for plugins to change the thumbnail creation args one final time
63	$args = apply_filters( 'foogallery_thumbnail_resize_args_final', $args, $original_image_src, $thumbnail_object );
64	$requires_image_processing = ! empty( $args['watermark_options'] );
65
66	$width = (int)$args['width'];
67	$height = (int)$args['height'];
68	$crop = (bool)$args['crop'];
69
70	if ( 0 === $width && 0 === $height && ! $requires_image_processing ) {
71	return $original_image_src;
72	}
73
74	//we can force the use of the originally uploaded full-size image
75	$force_use_original_image = isset( $args['force_use_original_image'] ) && true === $args['force_use_original_image'];
76
77	if ( ! $requires_image_processing && $thumbnail_object->ID > 0 && $force_use_original_image ) {
78	$fullsize = wp_get_attachment_image_src( $thumbnail_object->ID, 'fullsize' );
79
80	return $fullsize[0];
81	}
82
83	//we can force the use of the original WP icon or WP-generated thumb by passing through args individually
84	$force_use_original_thumb = isset( $args['force_use_original_thumb'] ) && true === $args['force_use_original_thumb'];
85
86	if ( ! $requires_image_processing && $thumbnail_object->ID > 0 && $force_use_original_thumb ) {
87	$thumbnail_icon = wp_get_attachment_image_src( $thumbnail_object->ID, array( $width, $height ) );
88
89	return $thumbnail_icon[0];
90	}
91
92	//we can force the use of original WP thumbs by passing through args individually, or by saved settings
93	$use_original_thumbs = ( isset( $args['use_original_thumbs'] ) && true === $args['use_original_thumbs'] ) \|\| 'on' === foogallery_get_setting( 'use_original_thumbs' );
94
95	if ( ! $requires_image_processing && $use_original_thumbs ) {
96
97	$option_thumbnail_size_w = get_option( 'thumbnail_size_w' );
98	$option_thumbnail_size_h = get_option( 'thumbnail_size_h' );
99	$option_thumbnail_crop = get_option( 'thumbnail_crop' );
100
101	//check if we are trying to get back the default thumbnail that we already have
102	if ( $thumbnail_object->ID > 0 && $width == $option_thumbnail_size_w && $height == $option_thumbnail_size_h && $crop == $option_thumbnail_crop ) {
103	$thumbnail_attributes = wp_get_attachment_image_src( $thumbnail_object->ID );
104
105	return $thumbnail_attributes[0];
106	}
107	}
108
109	//remove invalid resize args
110	if ( array_key_exists( 'height', $args ) && 0 === $args['height'] ) {
111	unset( $args['height'] );
112	}
113
114	$force_resize = false;
115
116	//only worry about upscaling if we have supplied both a width and height for cropping
117	if ( array_key_exists( 'height', $args ) && $args['height'] > 0 &&
118	array_key_exists( 'width', $args ) && $args['width'] > 0 ) {
119	//check if we must upscale smaller images
120	if ( 'on' === foogallery_get_setting( 'thumb_resize_upscale_small' ) ) {
121	$force_resize = true;
122	if ( !isset( $args['background_fill'] ) ) {
123	$color = foogallery_get_setting( 'thumb_resize_upscale_small_color', '' );
124	if ( $color !== 'auto' && $color !== 'transparent' ) {
125	$colors = foogallery_rgb_to_color_array( $color );
126	$color = sprintf( "%03d%03d%03d000", $colors[0], $colors[1], $colors[2] );
127	}
128	$args['background_fill'] = $color;
129	}
130	}
131	}
132
133	//do some checks to see if the image is smaller
134	if ( $requires_image_processing \|\| $force_resize \|\| $this->should_resize( $thumbnail_object, $args ) ) {
135	/**
136	* Filters the source URL immediately before the active thumbnail engine runs.
137	*
138	* @param string $original_image_src Original image source URL.
139	* @param array $args Final thumbnail generation arguments.
140	* @param FooGalleryAttachment $thumbnail_object Current attachment.
141	*/
142	$thumbnail_source = apply_filters( 'foogallery_thumbnail_resize_source', $original_image_src, $args, $thumbnail_object );
143
144	//save the generated thumb url to a global so that we can use it later if needed
145	$foogallery_last_generated_thumb_url = foogallery_thumb( $thumbnail_source, $args );
146	} else {
147	$foogallery_last_generated_thumb_url = apply_filters('foogallery_thumbnail_resize_small_image', $original_image_src, $args );
148	}
149
150	return $foogallery_last_generated_thumb_url;
151	}
152
153	function should_resize($thumbnail_object, $args) {
154	$original_width = $thumbnail_object->width;
155	$original_height = $thumbnail_object->height;
156
157	if ( $original_width === $original_height && $original_height === 0 ) {
158	//we do not have the original dimensions, so assume we must resize!
159	return true;
160	}
161
162	$new_width = isset( $args['width'] ) ? $args['width'] : 0;
163	$new_height = isset( $args['height'] ) ? $args['height'] : 0;
164
165	if ( $new_width > 0 && $new_height > 0 ) {
166	return $original_width > $new_width \|\| $original_height > $new_height;
167	} else if ( $new_width > 0 ) {
168	return $original_width > $new_width;
169	}
170	return $original_height > $new_height;
171	}
172
173	function run_thumbnail_generation_tests() {
174	if ( !foogallery_thumb_active_engine()->requires_thumbnail_generation_tests() ) {
175	return array(
176	'success' => true
177	);
178	}
179
180	$test_image_url = foogallery_test_thumb_url();
181
182	//next, generate a thumbnail
183	$test_args = array(
184	'width' => 20,
185	'height' => 20,
186	'crop' => true,
187	'jpeg_quality' => foogallery_thumbnail_jpeg_quality()
188	);
189
190	//first, clear any previous cached files
191	$engine = foogallery_thumb_active_engine();
192	$engine->clear_local_cache_for_file( $test_image_url );
193
194	$generated_thumb = $engine->generate( $test_image_url, $test_args );
195
196	$success = $test_image_url !== $generated_thumb;
197	$file_info = wp_check_filetype( $test_image_url );
198
199	$test_results = array(
200	'success' => $success,
201	'thumb' => $generated_thumb,
202	'error' => $engine->get_last_error(),
203	'file_info' => $file_info
204	);
205
206	do_action( 'foogallery_thumbnail_generation_test', $test_results );
207
208	return $test_results;
209	}
210
211	function override_test_thumb_url( $test_thumb_url ) {
212	if ( 'on' !== foogallery_get_setting( 'override_thumb_test', false ) ) {
213	$image_url = $this->find_first_image_in_media_library();
214
215	if ( $image_url !== false ) {
216	return $image_url;
217	}
218	}
219
220	//if we get here, then either, we have set the override_thumb_test setting,
221	//or there are no good images to use from the media library
222	return $test_thumb_url;
223	}
224
225	static function find_first_image_in_media_library( $min_width = 50, $min_height = 50 ) {
226	static $cached = array();
227
228	$min_width = absint( $min_width );
229	$min_height = absint( $min_height );
230	$cache_key = $min_width . 'x' . $min_height;
231
232	if ( array_key_exists( $cache_key, $cached ) ) {
233	return $cached[ $cache_key ];
234	}
235
236	// Try a small set of recent images with minimal query overhead.
237	$args = array(
238	'post_type' => 'attachment',
239	'post_mime_type' => 'image',
240	'post_status' => 'inherit',
241	'posts_per_page' => 25,
242	'orderby' => 'date',
243	'order' => 'DESC',
244	'fields' => 'ids',
245	'no_found_rows' => true,
246	'update_post_meta_cache' => false,
247	'update_post_term_cache' => false,
248	);
249
250	$query_images = new WP_Query( $args );
251	if ( empty( $query_images->posts ) ) {
252	$cached[ $cache_key ] = false;
253	return $cached[ $cache_key ];
254	}
255	foreach ( $query_images->posts as $image_id ) {
256	$local_path = get_attached_file( $image_id );
257	$image_url = wp_get_attachment_url( $image_id );
258
259	if ( empty( $image_url ) \|\| ! self::image_meets_minimum_test_dimensions( $image_id, $local_path, $min_width, $min_height ) ) {
260	continue;
261	}
262
263	if ( $local_path && file_exists( $local_path ) ) {
264	$cached[ $cache_key ] = $image_url;
265	return $cached[ $cache_key ];
266	}
267
268	if ( ! empty( $image_url ) ) {
269	if ( self::image_file_exists( $image_url ) \|\| self::image_file_exists( $image_url, true ) ) {
270	$cached[ $cache_key ] = $image_url;
271	return $cached[ $cache_key ];
272	}
273	}
274	}
275
276	$cached[ $cache_key ] = false;
277	return $cached[ $cache_key ];
278	}
279
280	/**
281	* Checks whether an attachment is large enough to be useful for test pages.
282	*
283	* @param int $image_id Attachment ID.
284	* @param string\|bool $local_path Local file path.
285	* @param int $min_width Minimum width.
286	* @param int $min_height Minimum height.
287	*
288	* @return bool
289	*/
290	static function image_meets_minimum_test_dimensions( $image_id, $local_path, $min_width, $min_height ) {
291	if ( $min_width <= 0 && $min_height <= 0 ) {
292	return true;
293	}
294
295	$metadata = wp_get_attachment_metadata( $image_id );
296	if ( isset( $metadata['width'], $metadata['height'] ) ) {
297	return intval( $metadata['width'] ) >= $min_width && intval( $metadata['height'] ) >= $min_height;
298	}
299
300	if ( $local_path && file_exists( $local_path ) ) {
301	// phpcs:ignore -- Compatibility is guarded by function_exists().
302	$size = function_exists( 'wp_getimagesize' ) ? wp_getimagesize( $local_path ) : @getimagesize( $local_path );
303
304	if ( isset( $size[0], $size[1] ) ) {
305	return intval( $size[0] ) >= $min_width && intval( $size[1] ) >= $min_height;
306	}
307	}
308
309	return true;
310	}
311
312	/**
313	* Check if a remote image file exists.
314	*
315	* @param string $url The url to the remote image.
316	* @param bool $force_https Whether to force the url to be https.
317	*
318	* @return bool Whether the remote image exists.
319	*/
320	static function image_file_exists( $url, $force_https = false ) {
321	if ( $force_https ) {
322	$url = str_replace( 'http://', 'https://', $url );
323	}
324
325	$response = wp_remote_head( $url, array(
326	'timeout' => 2,
327	'redirection' => 0,
328	'reject_unsafe_urls' => true,
329	) );
330
331	if ( is_wp_error( $response ) ) {
332	return false;
333	}
334
335	$code = wp_remote_retrieve_response_code( $response );
336	return ( $code >= 200 && $code < 400 ) \|\| 403 === $code;
337	}
338	}
339	}
340