414 lines
11 KiB
PHP
414 lines
11 KiB
PHP
<?php
|
||
namespace Imagify\Optimization\Process;
|
||
|
||
defined( 'ABSPATH' ) || die( 'Cheatin’ uh?' );
|
||
|
||
/**
|
||
* Fallback class to optimize medias.
|
||
*
|
||
* @since 1.9
|
||
* @author Grégory Viguier
|
||
*/
|
||
class Noop implements ProcessInterface {
|
||
|
||
/**
|
||
* The suffix used in the thumbnail size name.
|
||
*
|
||
* @var string
|
||
* @since 1.9
|
||
* @author Grégory Viguier
|
||
*/
|
||
const WEBP_SUFFIX = '@imagify-webp';
|
||
|
||
/**
|
||
* The suffix used in file name to create a temporary copy of the full size.
|
||
*
|
||
* @var string
|
||
* @since 1.9
|
||
* @author Grégory Viguier
|
||
*/
|
||
const TMP_SUFFIX = '@imagify-tmp';
|
||
|
||
/**
|
||
* Used for the name of the transient telling if a media is locked.
|
||
* %1$s is the context, %2$s is the media ID.
|
||
*
|
||
* @var string
|
||
* @since 1.9
|
||
* @author Grégory Viguier
|
||
*/
|
||
const LOCK_NAME = 'imagify_%1$s_%2$s_process_locked';
|
||
|
||
/**
|
||
* Tell if the given entry can be accepted in the constructor.
|
||
* For example it can include `is_numeric( $id )` if the constructor accepts integers.
|
||
*
|
||
* @since 1.9
|
||
* @access public
|
||
* @author Grégory Viguier
|
||
*
|
||
* @param mixed $id Whatever.
|
||
* @return bool
|
||
*/
|
||
public static function constructor_accepts( $id ) {
|
||
return false;
|
||
}
|
||
|
||
/**
|
||
* Get the data instance.
|
||
*
|
||
* @since 1.9
|
||
* @access public
|
||
* @author Grégory Viguier
|
||
*
|
||
* @return DataInterface|false
|
||
*/
|
||
public function get_data() {
|
||
return false;
|
||
}
|
||
|
||
/**
|
||
* Get the media instance.
|
||
*
|
||
* @since 1.9
|
||
* @access public
|
||
* @author Grégory Viguier
|
||
*
|
||
* @return MediaInterface|false
|
||
*/
|
||
public function get_media() {
|
||
return false;
|
||
}
|
||
|
||
/**
|
||
* Get the File instance.
|
||
*
|
||
* @since 1.9
|
||
* @access public
|
||
* @author Grégory Viguier
|
||
*
|
||
* @return File|false
|
||
*/
|
||
public function get_file() {
|
||
return false;
|
||
}
|
||
|
||
/**
|
||
* Tell if the current media is valid.
|
||
*
|
||
* @since 1.9
|
||
* @access public
|
||
* @author Grégory Viguier
|
||
*
|
||
* @return bool
|
||
*/
|
||
public function is_valid() {
|
||
return false;
|
||
}
|
||
|
||
/**
|
||
* Tell if the current user is allowed to operate Imagify in this context.
|
||
*
|
||
* @since 1.9
|
||
* @access public
|
||
* @author Grégory Viguier
|
||
*
|
||
* @param string $describer Capacity describer. See \Imagify\Context\ContextInterface->get_capacity() for possible values. Can also be a "real" user capacity.
|
||
* @return bool
|
||
*/
|
||
public function current_user_can( $describer ) {
|
||
return false;
|
||
}
|
||
|
||
|
||
/** ----------------------------------------------------------------------------------------- */
|
||
/** OPTIMIZATION ============================================================================ */
|
||
/** ----------------------------------------------------------------------------------------- */
|
||
|
||
/**
|
||
* Optimize a media files by pushing tasks into the queue.
|
||
*
|
||
* @since 1.9
|
||
* @access public
|
||
* @author Grégory Viguier
|
||
*
|
||
* @param int $optimization_level The optimization level (0=normal, 1=aggressive, 2=ultra).
|
||
* @return bool|WP_Error True if successfully launched. A \WP_Error instance on failure.
|
||
*/
|
||
public function optimize( $optimization_level = null ) {
|
||
return new \WP_Error( 'invalid_media', __( 'This media is not valid.', 'imagify' ) );
|
||
}
|
||
|
||
/**
|
||
* Re-optimize a media files with a different level.
|
||
*
|
||
* @since 1.9
|
||
* @access public
|
||
* @author Grégory Viguier
|
||
*
|
||
* @param int $optimization_level The optimization level (0=normal, 1=aggressive, 2=ultra).
|
||
* @return bool|WP_Error True if successfully launched. A \WP_Error instance on failure.
|
||
*/
|
||
public function reoptimize( $optimization_level = null ) {
|
||
return new \WP_Error( 'invalid_media', __( 'This media is not valid.', 'imagify' ) );
|
||
}
|
||
|
||
/**
|
||
* Optimize several file sizes by pushing tasks into the queue.
|
||
*
|
||
* @since 1.9
|
||
* @access public
|
||
* @author Grégory Viguier
|
||
*
|
||
* @param array $sizes An array of media sizes (strings). Use "full" for the size of the main file.
|
||
* @param int $optimization_level The optimization level (0=normal, 1=aggressive, 2=ultra).
|
||
* @return bool|WP_Error True if successfully launched. A \WP_Error instance on failure.
|
||
*/
|
||
public function optimize_sizes( $sizes, $optimization_level = null ) {
|
||
return new \WP_Error( 'invalid_media', __( 'This media is not valid.', 'imagify' ) );
|
||
}
|
||
|
||
/**
|
||
* Optimize one file with Imagify directly.
|
||
*
|
||
* @since 1.9
|
||
* @access public
|
||
* @author Grégory Viguier
|
||
*
|
||
* @param string $size The media size.
|
||
* @param int $optimization_level The optimization level (0=normal, 1=aggressive, 2=ultra).
|
||
* @return array|WP_Error The optimization data. A \WP_Error instance on failure.
|
||
*/
|
||
public function optimize_size( $size, $optimization_level = null ) {
|
||
return new \WP_Error( 'invalid_media', __( 'This media is not valid.', 'imagify' ) );
|
||
}
|
||
|
||
/**
|
||
* Restore the media files from the backup file.
|
||
*
|
||
* @since 1.9
|
||
* @access public
|
||
* @author Grégory Viguier
|
||
*
|
||
* @return bool|WP_Error True on success. A \WP_Error instance on failure.
|
||
*/
|
||
public function restore() {
|
||
return new \WP_Error( 'invalid_media', __( 'This media is not valid.', 'imagify' ) );
|
||
}
|
||
|
||
|
||
/** ----------------------------------------------------------------------------------------- */
|
||
/** MISSING THUMBNAILS ====================================================================== */
|
||
/** ----------------------------------------------------------------------------------------- */
|
||
|
||
/**
|
||
* Get the sizes for this media that have not get through optimization.
|
||
* No sizes are returned if the file is not optimized, has no backup, or is not an image.
|
||
* The 'full' size os never returned.
|
||
*
|
||
* @since 1.9
|
||
* @access public
|
||
* @author Grégory Viguier
|
||
*
|
||
* @return array|WP_Error {
|
||
* A WP_Error object on failure.
|
||
* An array of data for the thumbnail sizes on success.
|
||
* Size names are used as array keys.
|
||
*
|
||
* @type int $width The image width.
|
||
* @type int $height The image height.
|
||
* @type bool $crop True to crop, false to resize.
|
||
* @type string $name The size name.
|
||
* @type string $file The name the thumbnail "should" have.
|
||
* }
|
||
*/
|
||
public function get_missing_sizes() {
|
||
return [];
|
||
}
|
||
|
||
/**
|
||
* Optimize missing thumbnail sizes.
|
||
*
|
||
* @since 1.9
|
||
* @access public
|
||
* @author Grégory Viguier
|
||
*
|
||
* @return bool|WP_Error True if successfully launched. A \WP_Error instance on failure.
|
||
*/
|
||
public function optimize_missing_thumbnails() {
|
||
return new \WP_Error( 'invalid_media', __( 'This media is not valid.', 'imagify' ) );
|
||
}
|
||
|
||
|
||
/** ----------------------------------------------------------------------------------------- */
|
||
/** BACKUP FILE ============================================================================= */
|
||
/** ----------------------------------------------------------------------------------------- */
|
||
|
||
/**
|
||
* Delete the backup file.
|
||
*
|
||
* @since 1.9
|
||
* @access public
|
||
* @author Grégory Viguier
|
||
*/
|
||
public function delete_backup() {}
|
||
|
||
|
||
/** ----------------------------------------------------------------------------------------- */
|
||
/** RESIZE FILE ============================================================================= */
|
||
/** ----------------------------------------------------------------------------------------- */
|
||
|
||
/**
|
||
* Maybe resize an image.
|
||
*
|
||
* @since 1.9
|
||
* @access protected
|
||
* @author Grégory Viguier
|
||
*
|
||
* @param string $size The size name.
|
||
* @param File $file A File instance.
|
||
* @return array|WP_Error A \WP_Error instance on failure, an array on success as follow: {
|
||
* @type bool $resized True when the image has been resized.
|
||
* @type bool $backuped True when the image has been backuped.
|
||
* @type int $file_size The file size in bytes.
|
||
* }
|
||
*/
|
||
public function maybe_resize( $size, $file ) {
|
||
return [
|
||
'resized' => false,
|
||
'backuped' => false,
|
||
'file_size' => 0,
|
||
];
|
||
}
|
||
|
||
|
||
/** ----------------------------------------------------------------------------------------- */
|
||
/** WEBP ==================================================================================== */
|
||
/** ----------------------------------------------------------------------------------------- */
|
||
|
||
/**
|
||
* Generate WebP images if they are missing.
|
||
*
|
||
* @since 1.9
|
||
* @access public
|
||
* @author Grégory Viguier
|
||
*
|
||
* @return bool|WP_Error True if successfully launched. A \WP_Error instance on failure.
|
||
*/
|
||
public function generate_webp_versions() {
|
||
return new \WP_Error( 'invalid_media', __( 'This media is not valid.', 'imagify' ) );
|
||
}
|
||
|
||
/**
|
||
* Delete the WebP images.
|
||
*
|
||
* @since 1.9
|
||
* @access public
|
||
* @author Grégory Viguier
|
||
*/
|
||
public function delete_webp_files() {}
|
||
|
||
/**
|
||
* Tell if a thumbnail size is an "Imagify WebP" size.
|
||
*
|
||
* @since 1.9
|
||
* @access public
|
||
* @author Grégory Viguier
|
||
*
|
||
* @param string $size_name The size name.
|
||
* @return string|bool The unsuffixed name of the size if WebP. False if not WebP.
|
||
*/
|
||
public function is_size_webp( $size_name ) {
|
||
return false;
|
||
}
|
||
|
||
|
||
/** ----------------------------------------------------------------------------------------- */
|
||
/** PROCESS STATUS ========================================================================== */
|
||
/** ----------------------------------------------------------------------------------------- */
|
||
|
||
/**
|
||
* Tell if a process is running for this media.
|
||
*
|
||
* @since 1.9
|
||
* @access public
|
||
* @author Grégory Viguier
|
||
*
|
||
* @return bool
|
||
*/
|
||
public function is_locked() {
|
||
return false;
|
||
}
|
||
|
||
/**
|
||
* Set the running status to "running" for a period of time.
|
||
*
|
||
* @since 1.9
|
||
* @access public
|
||
* @author Grégory Viguier
|
||
*/
|
||
public function lock() {}
|
||
|
||
/**
|
||
* Delete the running status.
|
||
*
|
||
* @since 1.9
|
||
* @access public
|
||
* @author Grégory Viguier
|
||
*/
|
||
public function unlock() {}
|
||
|
||
|
||
/** ----------------------------------------------------------------------------------------- */
|
||
/** DATA ==================================================================================== */
|
||
/** ----------------------------------------------------------------------------------------- */
|
||
|
||
/**
|
||
* Tell if a size already has optimization data.
|
||
*
|
||
* @since 1.9
|
||
* @access public
|
||
* @author Grégory Viguier
|
||
*
|
||
* @param string $size The size name.
|
||
* @return bool
|
||
*/
|
||
public function size_has_optimization_data( $size ) {
|
||
return false;
|
||
}
|
||
|
||
/**
|
||
* Update the optimization data for a size.
|
||
*
|
||
* @since 1.9
|
||
* @access public
|
||
* @author Grégory Viguier
|
||
*
|
||
* @param object $response The API response.
|
||
* @param string $size The size name.
|
||
* @param int $level The optimization level (0=normal, 1=aggressive, 2=ultra).
|
||
* @return array {
|
||
* The optimization data.
|
||
*
|
||
* @type string $size The size name.
|
||
* @type int $level The optimization level.
|
||
* @type string $status The status: 'success', 'already_optimized', 'error'.
|
||
* @type bool $success True if successfully optimized. False on error or if already optimized.
|
||
* @type string $error An error message.
|
||
* @type int $original_size The weight of the file, before optimization.
|
||
* @type int $optimized_size The weight of the file, once optimized.
|
||
* }
|
||
*/
|
||
public function update_size_optimization_data( $response, $size, $level ) {
|
||
return [
|
||
'size' => 'noop',
|
||
'level' => false,
|
||
'status' => '',
|
||
'success' => false,
|
||
'error' => '',
|
||
'original_size' => 0,
|
||
'optimized_size' => 0,
|
||
];
|
||
}
|
||
}
|