Image Regenerate & Select Crop

Description

The plugin appends two custom buttons that allows you to regenerate and crop the images, provides details about the image sizes registered in the application and the status of each image sizes for images. The plugin also appends a sub-menu to “Settings” that allows you to configure the plugin for global or particular post type attached images and to enable the developer mode for debug if necessary. The most recent details of the plugin features are available at https://iuliacazan.ro/image-regenerate-select-crop/.

The “Details/Options” button will open a lightbox where you can see all the image sizes registered in the application and details about the status of each image sizes for that image. If one of the image sizes has not been found, you will see more details about this and, if possible, the option to manually generate this (for example the image size width and height are compatible with the original image). For the image sizes that are of “crop” type, you will be able to re-crop in one click the image using a specific portion of the original image: left/top, center/top, right/top, left/center, center/center, right/center, left/bottom, center/bottom, right/bottom. The preview of the result is shown right away, so you can re-crop if necessary.

The “Regenerate” button allows you to regenerate in one click all the image sizes for that specific image. This is really useful when during development you registered various image sizes and the already uploaded images are “left behind”.

The plugin does not require any additional code, it hooks in the admin_post_thumbnail_html and edit_form_top filter and appends two custom buttons that will be shown in “Edit Media” page and in the “Edit Post” and “Edit Page” where there is a featured image. This works also for custom post types. Also, it can be used in different resolutions and responsive layout.

Hooks

image_regenerate_select_crop_button, sirsc_custom_upload_rule

License

This program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.

Version history

4.3 – Tested up to 4.9.8 version, new WP-CLI command and flags, configurable custom rules and new hook for more complex rules, links to the images from the info view, styling updates, translations
4.2.2 – Tested up to 4.9.2 version, added Imagick support and fallback for placeholders, added progress to WP-CLI commands
4.2.1 – Fix static warning, fix direct access to the wp-admin folder instead of login
4.2 – Tested up to 4.8.3 version, add the image quality option for each image size, display the quality settings and the file size in the image details overlay, preserve the selected crop position for the image size in the image details overlay, dix multisite warning on switching the blog when using the WP-CLI commands
4.1 – Tested up to 4.8 version, fix the missing button for 4.8 in the edit post screen
4.0 – Tested up to 4.6.1 version, update the image buttons to work with WP >= 4.6 new hooks parameters, changes for the image buttons backward compatibility (core versions less than 4.6)
3.3 – Tested up to 4.4.2 version, code cleanup, fix typo, fix element position in edit media screen
3.0 – Forced original resize for already uploaded images when using the regenerate option.
2.0 – Default crop configuration and WP-CLI extension.
1.0 – Prototype.

Custom Actions

If you want to display the custom buttons in your plugins, you can use the custom action with $attachmentId parameter as the image post->ID you want the button for. Usage example : do_action( ‘image_regenerate_select_crop_button’, $attachmentId );

Images Placeholders Developer Mode

This option allows you to display placeholders for front-side images called programmatically (that are not embedded in content with their src, but retrieved with the wp_get_attachment_image_src, and the other related WP native functions). If there is no placeholder set, then the default behavior would be to display the full size image instead of a missing image size.
If you activate the “force global” option, all the images on the front side that are related to posts will be replaced with the placeholders that mention the image size required. This is useful for debug, to quick identify the image sizes used for each layout.
If you activate the “only missing images” option, all the images on the front side that are related to posts and do not have the requested image size generate, will be replaced with the placeholders that mention the image size required. This is useful for showing smaller images instead of full size images.

Global Ignore

This option allows you to exclude globally from the application some of the image sizes that are registered through various plugins and themes options, but you don’t need these in your application at all (these are just stored in your folders and database but not used). By excluding these, the unnecessary image sizes will not be generated at all.

Hide Preview

This option allows you to exclude from the “Image Regenerate & Select Crop Settings” lightbox the details and options for the selected image sizes. This is useful when you want to restrict from other users the functionality of crop or resize for particular image sizes.

Force Original

This option means that the original image will be scaled to a max width or a max height specified by the image size you select. This might be useful if you do not use the original image in any of the layout at the full size, and this might save some storage space.
Leave “nothing selected” to keep the original image as what you upload.

Cleanup All

This option allows you to cleanup all the image sizes you already have in the application but you don’t use these at all. Please be careful, once you click to remove the selected image size, the action is irreversible, the images generated will be deleted from your folders and database records.

Regenerate All

This option allows you to regenerate all the image for the selected image size Please be careful, once you click to regenerate the selected image size, the action is irreversible, the images already generated will be overwritten.

Default Crop

This option allows you to set a default crop position for the images generated for particular image size. This default option will be used when you chose to regenerate an individual image or all of these and also when a new image is uploaded.

WP-CLI Usage

The available methods are “regenerate” and “cleanup”. The arguments for both methods are the site id (1 for single site install, or if you are using the plugin in multi-site environment then you should specify the site id), the post type (post, page, or one of your custom post types), image size name (thumbnail, medium, etc.).

However, if you do not know all the options you have you can simply start by running the command “sirsc regenerate 1” and for each argument that is not mentioned the plugin will present the list of available values.
If you want to regenerate the images for only one post, then the 4th argument can be passed and this should be the post ID.

So, for example, if I would want to regenerate just the thumbnails for a post with the ID = 7, my command would be

  • sirsc regenerate 1 post thumbnail 7

If I would want to regenerate just the medium images for a post with the id 7, my command would be

  • sirsc regenerate 1 post medium 7

You can regenerate all images sizes for all the pages like this:

  • sirsc regenerate 1 page all

Or, you can regenerate all images sizes for the page with the ID = 3 type like this:

  • sirsc regenerate 1 page all 3

The cleanup command works with the exactly parameters order and types as the regenerate one.

Screenshots

  • The most recent view of the image details, with details and links for the original file and all the generated images.
  • The new interface for configuring advanced custom rules based on the post where the images will be uploaded.
  • The custom buttons are added in the featured image box or to edit media page, and by clicking the Details/Options button you can access the details of that image and options to regenerate / crop this for a particular image size. As you can see, the image was not found for the image size name called in the example "4columns", hence, on the front side the full size image is provided.
  • After regenerating the "4columns" image, you will be able to crop this and preview the result on the fly. Based on the crop type you chose, the front image will be updated.
  • However, you can regenerate all images for a selected image size and the result will be that all the front side tiles from the example will have the same size and fit as required.
  • The developer mode for placeholders allows you to select the global mode or the "only missing images" mode. This allows you to identify on the front side the image sizes names used in different layouts and also you can identify what are the images that did not get to be generated due to various reasons or development steps.

Installation

  • Upload Image Regenerate & Select Crop to the /wp-content/plugins/ directory of your application
  • Login as Admin
  • Activate the plugin through the ‘Plugins’ menu in WordPress

FAQ

None

Installation Instructions
  • Upload Image Regenerate & Select Crop to the /wp-content/plugins/ directory of your application
  • Login as Admin
  • Activate the plugin through the ‘Plugins’ menu in WordPress

Reviews

Don’t work

Try to install on docker / Wamp and a bitnami pre production server and crop based on top / left / etc don’t work.

I am on wp 4.9.8

Thanks anyway

Works as well as SquareSpace

Don’t forget to “Save Settings” before exercising this plugin even when using the default settings. Otherwise the plugin may not work at all.

Media => Library => Edit (in Table mode) then look for the two ‘blue’ buttons just below the heading “Edit Media”. (When viewing your Media Library in grid mode you will have to “Edit more details” to see the blue buttons.)

The “Details/Options” button is quite a revelation. I could see all the “versions” of the image (there were more sizes than I expected). Some I could change, some I could not change, as expected. On those I could change it was easy to click on the radio button to choose one of the 9 areas of each image on which to focus when generating a “cropped” version of the image. I found that clicking the radio button instantly changed the cropped version of the image. Previously chopped heads on portraits became full faces. It was a bit tedious to have to repeat on all the cropped versions of the image but it’s not hard to do and could be an advantage if you only wanted to update selected sizes.

I believe this plugin works in the same manner as the image editing function on SquareSpace.

Many thanks to the author for a handy plugin. I will be adopting for all my websites.

Really helpfull – Muito útil mesmo

Work’s smooth and help me to understand what kind images I wanna regenerate and clean up.

Funcionou muito bem, melhor que todos os outros plugins que testei até o momento e a interface e bem prática.

Read all 20 reviews

Contributors & Developers

“Image Regenerate & Select Crop” is open source software. The following people have contributed to this plugin.

Contributors

Changelog

4.3

  • Tested up to 4.9.8 version
  • New WP-CLI command to cleanup everything except for the full-size image, if you want to cleanup and start over
  • New WP-CLI command flags to force remove image sizes that are not registered in the application anymore
  • Configurable custom rules and new hook added so that you can create programmatically more complex rules
  • Changes to the info view to that include links to the original and the generated images
  • Styling updates
  • Added translation source file and RO translation included

4.2.2

  • Tested up to 4.9.2 version
  • Added Imagick support and fallback for placeholders
  • Added progress to WP-CLI commands

4.2.1

  • Fix static warning, fix access to direct wp-admin folder instead of login

4.2

  • Tested up to 4.8.3 version
  • Add the image quality option for each image size, display the quality settings and the file size in the image details overlay
  • Preserve the selected crop position for the image size in the image details overlay
  • Fix multisite warning on switching the blog when using the WP-CLI commands

4.1

  • Tested up to 4.8 version
  • Fix the missing button for 4.8

4.0

  • Tested up to 4.6.1 version
  • Update the image buttons to work with WP >= 4.6 new hooks parameters
  • Changes for the image buttons backward compatibility (core versions less than 4.6)

3.3

  • Tested up to 4.4.2 version
  • Cleanup
  • Fix typo
  • Fix element position in edit media screen

3.2

  • Tested up to 4.3.1 version

3.1

  • Add * in front of options that have settings applied.

3.0

  • Add the forced original resize execution for already uploaded images when using the regenerate option (this will not just resize the images for the selected image size but will also alter the original images).

2.0

  • Add the default crop configuration for each image size.
  • And the WP-CLI extension.