setup(); } return self::$instance; } /** * Register all of the needed hooks and actions. */ public function setup() { // Allow people to change what capability is required to use this plugin. $this->capability = apply_filters( 'regenerate_thumbs_cap', $this->capability ); // Initialize the REST API routes. add_action( 'rest_api_init', array( $this, 'rest_api_init' ) ); // Add a new item to the Tools menu in the admin menu. add_action( 'admin_menu', array( $this, 'add_admin_menu' ) ); // Load the required JavaScript and CSS. add_action( 'admin_enqueue_scripts', array( $this, 'admin_enqueues' ) ); // For the bulk action dropdowns. add_action( 'admin_head-upload.php', array( $this, 'add_bulk_actions_via_javascript' ) ); add_action( 'admin_action_bulk_regenerate_thumbnails', array( $this, 'bulk_action_handler' ) ); // Top drowndown. add_action( 'admin_action_-1', array( $this, 'bulk_action_handler' ) ); // Bottom dropdown. // Add a regenerate button to the non-modal edit media page. add_action( 'attachment_submitbox_misc_actions', array( $this, 'add_button_to_media_edit_page' ), 99 ); // Add a regenerate button to the list of fields in the edit media modal. // Ideally this would with the action links but I'm not good enough with JavaScript to do it. add_filter( 'attachment_fields_to_edit', array( $this, 'add_button_to_edit_media_modal_fields_area' ), 99, 2 ); // Add a regenerate link to actions list in the media list view. add_filter( 'media_row_actions', array( $this, 'add_regenerate_link_to_media_list_view' ), 10, 2 ); } /** * Initialize the REST API routes. */ public function rest_api_init() { $this->rest_api = new RegenerateThumbnails_REST_Controller(); $this->rest_api->register_routes(); $this->rest_api->register_filters(); } /** * Adds a the new item to the admin menu. */ public function add_admin_menu() { $this->menu_id = add_management_page( __( 'Regenerate Thumbnails', 'regenerate-thumbnails' ), __( 'Regenerate Thumbnails', 'regenerate-thumbnails' ), $this->capability, 'regenerate-thumbnails', array( $this, 'regenerate_interface' ) ); add_action( 'admin_head-' . $this->menu_id, array( $this, 'add_admin_notice_if_resizing_not_supported' ) ); } /** * Enqueues the requires JavaScript file and stylesheet on the plugin's admin page. * * @param string $hook_suffix The current page's hook suffix as provided by admin-header.php. */ public function admin_enqueues( $hook_suffix ) { if ( $hook_suffix != $this->menu_id ) { return; } // Pre-4.9 compatibility. if ( ! wp_script_is( 'wp-api-request', 'registered' ) ) { wp_register_script( 'wp-api-request', plugins_url( 'js/api-request.min.js', __FILE__ ), array( 'jquery' ), '4.9', true ); wp_localize_script( 'wp-api-request', 'wpApiSettings', array( 'root' => esc_url_raw( get_rest_url() ), 'nonce' => ( wp_installing() && ! is_multisite() ) ? '' : wp_create_nonce( 'wp_rest' ), 'versionString' => 'wp/v2/', ) ); } wp_enqueue_script( 'regenerate-thumbnails', plugins_url( 'dist/build.js', __FILE__ ), array( 'wp-api-request' ), ( defined( 'SCRIPT_DEBUG' ) && SCRIPT_DEBUG ) ? filemtime( dirname( __FILE__ ) . '/dist/build.js' ) : $this->version, true ); $script_data = array( 'data' => array( 'thumbnailSizes' => $this->get_thumbnail_sizes(), 'genericEditURL' => admin_url( 'post.php?action=edit&post=' ), ), 'options' => array( 'onlyMissingThumbnails' => apply_filters( 'regenerate_thumbnails_options_onlymissingthumbnails', true ), 'updatePostContents' => apply_filters( 'regenerate_thumbnails_options_updatepostcontents', false ), 'deleteOldThumbnails' => apply_filters( 'regenerate_thumbnails_options_deleteoldthumbnails', false ), ), 'l10n' => array( 'common' => array( 'regenerateThumbnails' => __( 'Regenerate Thumbnails', 'regenerate-thumbnails' ), 'loading' => __( 'Loading…', 'regenerate-thumbnails' ), 'onlyRegenerateMissingThumbnails' => __( 'Skip regenerating existing correctly sized thumbnails (faster).', 'regenerate-thumbnails' ), 'deleteOldThumbnails' => __( "Delete thumbnail files for old unregistered sizes in order to free up server space. You risk broken images if you do this so it's strongly recommended that you update the content of posts to reduce the risk.", 'regenerate-thumbnails' ), 'thumbnailSizeItemWithCropMethodNoFilename' => __( '{label}: {width}×{height} pixels ({cropMethod})', 'regenerate-thumbnails' ), 'thumbnailSizeItemWithCropMethod' => __( '{label}: {width}×{height} pixels ({cropMethod}) {filename}', 'regenerate-thumbnails' ), 'thumbnailSizeItemWithoutCropMethod' => __( '{label}: {width}×{height} pixels {filename}', 'regenerate-thumbnails' ), 'thumbnailSizeBiggerThanOriginal' => __( '{label}: {width}×{height} pixels (thumbnail would be larger than original)', 'regenerate-thumbnails' ), 'thumbnailSizeItemIsCropped' => __( 'cropped to fit', 'regenerate-thumbnails' ), 'thumbnailSizeItemIsProportional' => __( 'proportionally resized to fit inside dimensions', 'regenerate-thumbnails' ), ), 'Home' => array( 'intro1' => sprintf( __( 'When you change WordPress themes or change the sizes of your thumbnails at Settings → Media, images that you have previously uploaded to you media library will be missing thumbnail files for those new image sizes. This tool will allow you to create those missing thumbnail files for all images.', 'regenerate-thumbnails' ), esc_url( admin_url( 'options-media.php' ) ) ), 'intro2' => sprintf( __( 'To process a specific image, visit your media library and click the "Regenerate Thumbnails" link or button. To process multiple specific images, make sure you\'re in the list view and then use the Bulk Actions dropdown after selecting one or more images.', 'regenerate-thumbnails' ), esc_url( admin_url( 'upload.php?mode=list' ) ) ), 'updatePostContents' => __( 'Update the content of posts to use the new sizes.', 'regenerate-thumbnails' ), 'RegenerateThumbnailsForAllAttachments' => __( 'Regenerate Thumbnails For All Attachments', 'regenerate-thumbnails' ), 'RegenerateThumbnailsForAllXAttachments' => __( 'Regenerate Thumbnails For All {attachmentCount} Attachments', 'regenerate-thumbnails' ), 'RegenerateThumbnailsForFeaturedImagesOnly' => __( 'Regenerate Thumbnails For Featured Images Only', 'regenerate-thumbnails' ), 'RegenerateThumbnailsForXFeaturedImagesOnly' => __( 'Regenerate Thumbnails For The {attachmentCount} Featured Images Only', 'regenerate-thumbnails' ), 'thumbnailSizes' => __( 'Thumbnail Sizes', 'regenerate-thumbnails' ), 'thumbnailSizesDescription' => __( 'These are all of the thumbnail sizes that are currently registered:', 'regenerate-thumbnails' ), 'alternatives' => __( 'Alternatives', 'regenerate-thumbnails' ), 'alternativesText1' => __( 'If you have command-line access to your site\'s server, consider using WP-CLI instead of this tool. It has a built-in regenerate command that works similarly to this tool but should be significantly faster since it has the advantage of being a command-line tool.', 'regenerate-thumbnails' ), 'alternativesText2' => __( 'Another alternative is to use the Photon functionality that comes with the Jetpack plugin. It generates thumbnails on-demand using WordPress.com\'s infrastructure. Disclaimer: The author of this plugin, Regenerate Thumbnails, is an employee of the company behind WordPress.com and Jetpack but I would recommend it even if I wasn\'t.', 'regenerate-thumbnails' ), ), 'RegenerateSingle' => array( /* translators: Admin screen title. */ 'title' => __( 'Regenerate Thumbnails: {name} — WordPress', 'regenerate-thumbnails' ), 'errorWithMessage' => __( 'ERROR: {error}', 'regenerate-thumbnails' ), 'filenameAndDimensions' => __( '{filename} {width}×{height} pixels', 'regenerate-thumbnails' ), 'preview' => __( 'Preview', 'regenerate-thumbnails' ), 'updatePostContents' => __( 'Update the content of posts that use this attachment to use the new sizes.', 'regenerate-thumbnails' ), 'regenerating' => __( 'Regenerating…', 'regenerate-thumbnails' ), 'done' => __( 'Done! Click here to go back.', 'regenerate-thumbnails' ), 'errorRegenerating' => __( 'Error Regenerating', 'regenerate-thumbnails' ), 'errorRegeneratingMessage' => __( 'There was an error regenerating this attachment. The error was: {message}', 'regenerate-thumbnails' ), 'registeredSizes' => __( 'These are the currently registered thumbnail sizes, whether they exist for this attachment, and their filenames:', 'regenerate-thumbnails' ), 'unregisteredSizes' => __( 'The attachment says it also has these thumbnail sizes but they are no longer in use by WordPress. You can probably safely have this plugin delete them, especially if you have this plugin update any posts that make use of this attachment.', 'regenerate-thumbnails' ), ), 'RegenerateMultiple' => array( 'errorsEncountered' => __( 'Errors Encountered', 'regenerate-thumbnails' ), 'regenerationLog' => __( 'Regeneration Log', 'regenerate-thumbnails' ), 'pause' => __( 'Pause', 'regenerate-thumbnails' ), 'resume' => __( 'Resume', 'regenerate-thumbnails' ), 'logRegeneratedItem' => __( 'Regenerated {name}', 'regenerate-thumbnails' ), 'logSkippedItem' => __( 'Skipped Attachment ID {id} ({name}): {reason}', 'regenerate-thumbnails' ), 'logSkippedItemNoName' => __( 'Skipped Attachment ID {id}: {reason}', 'regenerate-thumbnails' ), 'duration' => __( 'All done in {duration}.', 'regenerate-thumbnails' ), 'hours' => __( '{count} hours', 'regenerate-thumbnails' ), 'minutes' => __( '{count} minutes', 'regenerate-thumbnails' ), 'seconds' => __( '{count} seconds', 'regenerate-thumbnails' ), 'error' => __( "Unable to fetch a list of attachment IDs to process from the WordPress REST API. You can check your browser's console for details.", 'regenerate-thumbnails' ), ), ), ); // Bulk regeneration. if ( ! empty( $_GET['ids'] ) ) { $script_data['data']['thumbnailIDs'] = array_map( 'intval', explode( ',', $_GET['ids'] ) ); $script_data['l10n']['Home']['RegenerateThumbnailsForXAttachments'] = sprintf( __( 'Regenerate Thumbnails For The %d Selected Attachments', 'regenerate-thumbnails' ), count( $script_data['data']['thumbnailIDs'] ) ); } wp_localize_script( 'regenerate-thumbnails', 'regenerateThumbnails', $script_data ); wp_enqueue_style( 'regenerate-thumbnails-progressbar', plugins_url( 'css/progressbar.css', __FILE__ ), array(), ( defined( 'SCRIPT_DEBUG' ) && SCRIPT_DEBUG ) ? filemtime( dirname( __FILE__ ) . '/css/progressbar.css' ) : $this->version ); } /** * The main Regenerate Thumbnails interface, as displayed at Tools → Regenerate Thumbnails. */ public function regenerate_interface() { global $wp_version; echo '
'; echo '

' . esc_html__( 'Regenerate Thumbnails', 'regenerate-thumbnails' ) . '

'; if ( version_compare( $wp_version, '4.7', '<' ) ) { echo '

' . sprintf( __( 'This plugin requires WordPress 4.7 or newer. You are on version %1$s. Please upgrade.', 'regenerate-thumbnails' ), esc_html( $wp_version ), esc_url( admin_url( 'update-core.php' ) ) ) . '

'; } else { ?>

'; } /** * If the image editor doesn't support image resizing (thumbnailing), then add an admin notice * warning the user of this. */ public function add_admin_notice_if_resizing_not_supported() { if ( ! wp_image_editor_supports( array( 'methods' => array( 'resize' ) ) ) ) { add_action( 'admin_notices', array( $this, 'admin_notices_resizing_not_supported' ) ); } } /** * Outputs an admin notice stating that image resizing (thumbnailing) is not supported. */ public function admin_notices_resizing_not_supported() { ?>

ID, '_wp_attachment_context', true ) ) { return false; } if ( wp_attachment_is_image( $post ) ) { return true; } $fullsize = get_attached_file( $post->ID ); if ( ! $fullsize || ! file_exists( $fullsize ) ) { return false; } $image_editor_args = array( 'path' => $fullsize, 'methods' => array( 'resize' ) ); $file_info = wp_check_filetype( $image_editor_args['path'] ); // If $file_info['type'] is false, then we let the editor attempt to // figure out the file type, rather than forcing a failure based on extension. if ( isset( $file_info ) && $file_info['type'] ) { $image_editor_args['mime_type'] = $file_info['type']; } return (bool) _wp_image_editor_choose( $image_editor_args ); } /** * Adds "Regenerate Thumbnails" below each image in the media library list view. * * @param array $actions An array of current actions. * @param WP_Post $post The current attachment's post object. * * @return array The new list of actions. */ public function add_regenerate_link_to_media_list_view( $actions, $post ) { if ( ! current_user_can( $this->capability ) || ! $this->is_regeneratable( $post ) ) { return $actions; } $actions['regenerate_thumbnails'] = '' . __( 'Regenerate Thumbnails', 'regenerate-thumbnails' ) . ''; return $actions; } /** * Add a "Regenerate Thumbnails" button to the submit box on the non-modal "Edit Media" screen for an image attachment. */ public function add_button_to_media_edit_page() { global $post; if ( ! current_user_can( $this->capability ) || ! $this->is_regeneratable( $post ) ) { return; } echo ''; } /** * Adds a "Regenerate Thumbnails" button to the edit media modal view. * * Ideally it would be down with the actions but I'm not good enough at JavaScript * in order to be able to do it, so instead I'm adding it to the bottom of the list * of media fields. Pull requests to improve this are welcome! * * @param array $form_fields An array of existing form fields. * @param WP_Post $post The current media item, as a post object. * * @return array The new array of form fields. */ public function add_button_to_edit_media_modal_fields_area( $form_fields, $post ) { if ( ! current_user_can( $this->capability ) || ! $this->is_regeneratable( $post ) ) { return $form_fields; } $form_fields['regenerate_thumbnails'] = array( 'label' => '', 'input' => 'html', 'html' => '' . __( 'Regenerate Thumbnails', 'regenerate-thumbnails' ) . '', 'show_in_modal' => true, 'show_in_edit' => false, ); return $form_fields; } /** * Add "Regenerate Thumbnails" to the bulk actions dropdown on the media list using Javascript. */ public function add_bulk_actions_via_javascript() { if ( ! current_user_can( $this->capability ) ) { return; } ?> 'regenerate-thumbnails', 'ids' => rawurlencode( implode( ',', array_map( 'intval', $_REQUEST['media'] ) ) ), ), admin_url( 'tools.php' ) ) ); exit(); } /** * Returns an array of all thumbnail sizes, including their label, size, and crop setting. * * @return array An array, with the thumbnail label as the key and an array of thumbnail properties (width, height, crop). */ public function get_thumbnail_sizes() { global $_wp_additional_image_sizes; $thumbnail_sizes = array(); foreach ( get_intermediate_image_sizes() as $size ) { $thumbnail_sizes[ $size ]['label'] = $size; if ( in_array( $size, array( 'thumbnail', 'medium', 'medium_large', 'large' ) ) ) { $thumbnail_sizes[ $size ]['width'] = (int) get_option( $size . '_size_w' ); $thumbnail_sizes[ $size ]['height'] = (int) get_option( $size . '_size_h' ); $thumbnail_sizes[ $size ]['crop'] = ( 'thumbnail' == $size ) ? (bool) get_option( 'thumbnail_crop' ) : false; } elseif ( ! empty( $_wp_additional_image_sizes ) && ! empty( $_wp_additional_image_sizes[ $size ] ) ) { $thumbnail_sizes[ $size ]['width'] = (int) $_wp_additional_image_sizes[ $size ]['width']; $thumbnail_sizes[ $size ]['height'] = (int) $_wp_additional_image_sizes[ $size ]['height']; $thumbnail_sizes[ $size ]['crop'] = (bool) $_wp_additional_image_sizes[ $size ]['crop']; } } return $thumbnail_sizes; } } /** * Returns the single instance of this plugin, creating one if needed. * * @return RegenerateThumbnails */ function RegenerateThumbnails() { return RegenerateThumbnails::instance(); } /** * Initialize this plugin once all other plugins have finished loading. */ add_action( 'init', 'RegenerateThumbnails' );