Focalio – Focal Point Cropping, WebP & AVIF Images
| 开发者 | bigfatinternet |
|---|---|
| 更新时间 | 2026年11月4日 21:43 |
| PHP版本: | 8.3 及以上 |
| WordPress版本: | 7.1 |
| 版权: | GPL-2.0-or-later |
| 版权网址: | 版权信息 |
详情介绍:
Focalio serves cropped, format-converted image variants on demand via signed URLs — no more pre-generated intermediate sizes filling up your uploads directory. Editors pick a focal point per image so crops always keep the subject in frame.
Try it without installing: click Live Preview for a demo page with three photos at three crops. Move a focal point and reload the page: every crop follows.
Features:
- On-demand image cropping via signed URLs
- WebP or AVIF output for all uploads
- Focal-point picker in the media library and the block editor
- Non-destructive rotate and flip, applied to every rendition
- LQIP (Low Quality Image Placeholder) support
- Settings for image quality, output format and maximum width
- Presets, as many as you need: edited on the Presets tab, each with its own quality and LQIP, or registered in code with glide_register_preset()
- Attention / entropy / center crop fallback for images without a manual focal point
- Cached images are served before the rest of WordPress loads
- Presets also appear as image sizes, so the media library, Advanced Custom Fields, widgets and page builders can pick them by name
- Optional: skip writing intermediate image sizes to disk on upload
- Turn off the WordPress image sizes your site does not use
- A Cache tab: how big the image cache is, and a button to clear it. A weekly cleanup drops renders that are no longer used
- WP-CLI commands for the cache and the crop fallback
- WooCommerce product images go through Focalio too, and its cropped sizes follow the focal point
- Multisite: activate it for the whole network; deleting it cleans up every site
- Control: focal-point zoom, a straighten ruler that levels a tilted photo by up to 45°, a live crop preview, a hand-made crop per ratio where the focal point is not enough, a watermark, and a version history per image to go back to an earlier focal point or crop, like undo and redo
- Performance: AVIF with a WebP fallback in a picture element, and a cache warm-up that renders images before the first visitor asks for them
- Workflow: face detection that puts the focal point on the people in a photo, bulk actions in the media library, import and export of the settings to set up one site and give others the same, and tools to manage every site of a multisite network
- WooCommerce: the shop grid of a block theme cut on the focal point at the store's ratio, and one ratio for every photo on a product page
安装:
- Upload the plugin files to
/wp-content/plugins/focalio/, or install via the WordPress plugin repository. - Activate the plugin through the Plugins menu in WordPress.
- Configure via Focalio in the admin menu.
屏幕截图:
常见问题:
Can I try it before installing?
Yes. Click Live Preview at the top of this page: a demo site opens in your browser with three sample photos, each with a focal point, and a page that shows them as a banner, a grid thumbnail and a mobile crop. Nothing is installed on your own site.
Does Focalio change my original uploads?
No. Your uploads stay as they are. Every crop and format is rendered from them when it is first asked for, and kept in the .glide-cache folder in your uploads folder. That folder can be deleted at any time: what is gone is rendered again.
Where do I set the focal point?
In the media library, in the image's details, and in the block editor, on an image block. Without one, the crop fallback on the Settings tab decides: attention, entropy or the center.
Which WP-CLI commands are there?
wp focalio cache stats: what is in the image cachewp focalio cache cleanup: the weekly cleanup, now (add--dry-runto only count)wp focalio cache clear: delete every rendered imagewp focalio guess: work out the automatic focal point of every image ahead of time (add--forceto redo them)
Does it work with WooCommerce?
Yes. Product images are served through Focalio like every other image, and WooCommerce's cropped sizes, such as the shop thumbnails of a classic theme and the gallery thumbnails, follow the focal point.
Does it work on multisite?
Yes. Activate it per site or for the whole network. Each site keeps its own settings and image cache, and deleting Focalio cleans up every site.
更新日志:
1.0.41
- The media REST API no longer fails on an image without metadata, such as an imported or synced upload: listing the media library through
/wp/v2/mediastopped with "Cannot use object of type stdClass as array".
- Uploads whose file name holds a format character, such as the invisible soft hyphen macOS puts in Dutch screenshot names, are now served: every crop of them answered 404 although the file was there.
glide_image()andglide_source()no longer make an image taller than its original: a landscape photo on a portrait or squarer ratio is now bounded by its height (1200×896 on 3:4 gave 1200×1600). A preset's size in Advanced Custom Fields'sizesarray follows the same rule.- Images without metadata, such as imported or synced uploads, are measured from the file, so they are never enlarged either.
- Images are no longer broken when PHP notices are displayed (development,
WP_DEBUG_DISPLAY): output another plugin or theme printed earlier in the request is discarded before the image is sent, and errors during the image response go to the log only. - The Plugins screen shows the same name as the WordPress.org listing: Focalio – Focal Point Cropping, WebP & AVIF Images.
- Crop preview: a preset's tile shows its ratio as the preset gives it (21:9, as on the Presets tab), no longer reduced to 7:3. Sizes with the same ratio still share one tile.
- Cache tab: right after the image cache is cleared it says when, instead of "Not measured yet"; the next cleanup counts what was rendered since.
- A preset without a quality of its own renders at the quality on the Settings tab instead of 85, and a quality passed to
glide_image()orglide_source()together with a preset wins over the preset's. Preset images are rendered again once, at the right quality. - Presets added through the
wp_glide/register_presetsfilter read LQIP likeglide_register_preset()does:'off','no','false'and0turn it off. - Info tab: the URL signing key row says the key is auto-generated and stored, instead of "Falling back to wp_salt".
- Cache tab: before the first cleanup it points to
wp focalio cache cleanup, which records the numbers. - Security tab: the
define()line for wp-config.php is folded away until you click "Show the line to paste".
- The default image quality is 82 instead of 100: at web sizes images look the same and are much smaller. Sites that saved a quality on the Settings tab keep theirs; on the others every image is rendered again, smaller, the first time it is asked for.
glide_register_preset()no longer stops the site when a quality or LQIP value is not of the expected type:''andnullmean the site's setting,'95'works like95, and LQIP also takes'on'/'off'and1/0.- For developers: the
focalio_focal_picker_sidebarhook adds sections at the end of the image editor's sidebar, and the editor takes thefocalio:editor-settleandfocalio:editor-reloadevents, in the media library and the block editor. - The plugin header links to focalio.eu.
- Focalio has a menu of its own in the admin, with its own icon, instead of a page under Settings.
- A Cache tab: how big the image cache is, and the button to clear it, which used to be on the Info tab.
- Multisite: activated for the whole network, the opt-in is asked once for the network. Deleting Focalio cleans up every site; deactivating it for the network stops every site's weekly cleanup.
- For developers: the
focalio/cache_tab_afterandfocalio/wordpress_sizes_afterhooks add a section to the Cache and Presets tabs.
- First release on WordPress.org.