Title: Presswell Art Direction Author: Presswell Published: April 12, 2018 Last modified: April 30, 2026 --- Search plugins ![](https://ps.w.org/presswell-art-direction/assets/banner-772x250.jpg?rev=3519851) ![](https://ps.w.org/presswell-art-direction/assets/icon-256x256.png?rev=3519851) # Presswell Art Direction By [Presswell](https://profiles.wordpress.org/presswell/) [Download](https://downloads.wordpress.org/plugin/presswell-art-direction.2.0.0.zip) * [Details](https://test.wordpress.org/plugins/presswell-art-direction/#description) * [Reviews](https://test.wordpress.org/plugins/presswell-art-direction/#reviews) * [Installation](https://test.wordpress.org/plugins/presswell-art-direction/#installation) * [Development](https://test.wordpress.org/plugins/presswell-art-direction/#developers) [Support](https://wordpress.org/support/plugin/presswell-art-direction/) ## Description Presswell Art Direction gives editors and developers a consistent way to manage image sizing and cropping in WordPress. Define custom sizes, set focal points, and generate non-core thumbnails only when they are actually needed. **Features** * Control image cropping with focal points * Define custom image sizes and nested thumbnail variants * Select custom image sizes directly in the WordPress editor * Dynamically generate non-core thumbnails on demand * Run batch regeneration from a dedicated Media tool * Use Endpoint Mode when filename-based 404 handoff is unavailable * Import/export size definitions and migrate legacy focal-point metadata **_Focal Point Cropping_** Set a focal point for Media Library images to control how custom crops are framed. Mark the visual subject once, and generated thumbnails stay centered on the correct area. **_Custom Size Management_** Use the settings UI to define and edit custom image sizes. Registered sizes become available when inserting images in the block editor and classic editor workflows. **_Dynamic Generation + Endpoint Mode_** Presswell Art Direction avoids generating every custom size at upload time. WordPress core sizes are generated normally, while custom sizes are generated when requested in templates or by URL. If filename-based 404 image requests do not reach WordPress (common in some NGINX/ server setups), enable Endpoint Mode (`/pwad-image/?id=...&size=...`). The plugin includes an automatic compatibility check in wp-admin. **_Regenerator_** The Regenerator screen (Media -> Regenerate Thumbnails) builds a queue and processes images in batches, with progress metrics and retry handling for failed jobs. You can choose exactly which sizes should be regenerated. #### Documentation **Public APIs** **pwad_add_image_size( $args )** * **$args** (array) (required) – Keyed array containing `name`, `key`, `height`,` width`, `crop` (optional), and optionally `thumbnails` values. * Thumbnail keys are prefixed with parent’s key like `[size]-[thumbnail]`. Example: ``` pwad_add_image_size( array( 'name' => 'Square', 'key' => 'square', 'width' => '1200', 'height' => '1200', 'crop' => true, 'thumbnails' => array( array( 'name' => 'Medium', 'key' => 'medium', 'width' => '800', 'height' => '800', ), array( 'name' => 'Small', 'key' => 'small', 'width' => '400', 'height' => '400', ), ), ) ); ``` **pwad_get_image_sizes()** Returns all currently-available sizes (WordPress defaults + plugin/theme sizes + Presswell Art Direction sizes/thumbnails). Example: $sizes = pwad_get_image_sizes(); **pwad_get_image( $attachment_ID, $size_key, $attr = array() )** * **$attachment_ID** (int) (required) – ID of image attachment * **$size_key** (string) (required) – Image size identifier (`thumbnail`, `large`,` my-size`, `my-size-mobile`, etc.) * **$attr** (array) (optional) – HTML attributes passed to the rendered image element Returns an image tag. Example: $square_large = pwad_get_image( $img_ID, ‘square’ ); $square_small = pwad_get_image( $img_ID, ‘square-small’, array( ‘class’ => ‘hero-image’ ) ); **pwad_get_image_src( $attachment_ID, $size_key )** * **$attachment_ID** (int) (required) – ID of image attachment * **$size_key** (string) (required) – Image size identifier (`thumbnail`, `large`,` my-size`, `my-size-mobile`, etc.) Returns a keyed array containing the `file`, `url`, `path`, `height`, `width`, and` mime-type` values. Example: $square_large = pwad_get_image_src( $img_ID, ‘square’ ); $square_small = pwad_get_image_src( $img_ID, ‘square-small’ ); **WP-CLI** **wp pwad regenerate** Regenerates thumbnails. * `--queue-per-page=` (default `200`) * `--batch-size=` (default `25`) * `--target-seconds=` (default `5`) * `--resume-last=<0|1>` (default `0`, continue the last interrupted queue) **wp pwad cache-prime** Generates thumbnails based on sitemap. * `--sitemap=` (optional, auto-detects from robots.txt/common sitemap endpoints) * `--page-limit=` (default unlimited) * `--image-limit=` (default unlimited) * `--delay-ms=` (default `250`) * `--timeout=` (default `10`) * `--retries=` (default `2`) * `--include-external=<0|1>` (default `0`) * `--force-endpoint=<0|1>` (default `0`) * `--report-csv=` (optional, writes per-URL status/error report) * `--dry-run=<0|1>` (default `0`) * `--resume-last=<0|1>` (default `0`, continue the last interrupted prime run) **wp pwad cache-prune** Deletes cached thumbnails not referenced in sitemap. * `--sitemap=` (optional, auto-detects from robots.txt/common sitemap endpoints) * `--batch-size=` (default `200`) * `--max-images=` (default unlimited) * `--page-limit=` (default unlimited) * `--image-limit=` (default unlimited) * `--timeout=` (default `10`) * `--grace-days=` (default `0`, uses file modified time) * `--include-external=<0|1>` (default `0`) * `--force-endpoint=<0|1>` (default `0`) * `--report-csv=` (optional, writes per-file keep/delete report) * `--dry-run=<0|1>` (default `1`) * `--resume-last=<0|1>` (default `0`, continue the last interrupted prune run) **wp pwad cache-clean** Deletes all cached thumbnails. * `--batch-size=` (default `200`) * `--max-images=` (default unlimited) * `--include-default=<0|1>` (default `0`) * `--dry-run=<0|1>` (default `1`) * `--resume-last=<0|1>` (default `0`, continue the last interrupted clean run) **wp pwad queue-status** Shows resumable/remaining state for regenerator and cache queue runs. ### Privacy Presswell Art Direction does not send image data to external services. It processes image metadata and generated variants within your WordPress environment. ## Screenshots * [[ * Focal point editor with crop preview. * [[ * Bulk regenerator queue with progress and status. * [[ * Settings screen for custom size and compatibility configuration. * [[ * Settings screen with various plugin tools. * [[ * Settings screen with internal debugger. ## Installation Install via the WordPress plugin installer, or manually upload the plugin directory to `wp-content/plugins/`. **Configuration** 1. Activate the plugin. 2. Navigate to _Settings -> Art Direction_. 3. Configure custom image sizes, focal point behavior, and compatibility mode as needed. 4. Use _Media -> Regenerate Thumbnails_ when you need to pre-build or refresh generated variants. ## FAQ ### How do I set a focal point? When viewing an image in the media library click the ‘Set Focal Point’ button. Use the size dropdown to change the crop preview. Click and drag the blue focal point marker to identify the subject of the image. When finished, click the ‘Save Focal Point’ button to update the focal point settings and clear the image thumbnail cache for regeneration. ### Why should I use focal points? Focal points let you control crop framing across many sizes without manually defining crop coordinates for every variant. ### Why use dynamic image generation? Themes often register many custom sizes, but only a subset are used on the live site. Dynamic generation creates only the thumbnails that are actually requested. ### What is Endpoint Mode (Compatibility Mode)? Endpoint Mode serves generated images through a WordPress endpoint when your server does not pass filename-based 404 image requests to WordPress. The plugin can auto- enable this mode when compatibility checks fail. ### How do I regenerate images in bulk? Open _Media_ -> _Regenerate Thumbnails_ and run the regenerator, or run `wp pwad regenerate` from WP-CLI. ### Why would I delete all cached images? When migrating a large site it is beneficial to delete any generated image sizes to speed up the data transfer. Images will be re-generated dynamically when requested from the new location. ## Reviews ![](https://secure.gravatar.com/avatar/e12f3cb24e2036ca17bb07b17a141a22e3f5695593d523906bde906f0431b527? s=60&d=retro&r=g) ### 󠀁[Very well done](https://wordpress.org/support/topic/very-well-done-67/)󠁿 [Dalton Rooney](https://profiles.wordpress.org/daltonrooney/) June 8, 2020 Really easy to use, and integrated perfectly with the front end of the site without any extra javascript or CSS required. Perfect add-on. ![](https://secure.gravatar.com/avatar/e696e564dcd79a3ea9bc12429dc21cce13e810f40b60a73d8cc15a8c5b929fe6? s=60&d=retro&r=g) ### 󠀁[Great at setting image focus and works with themes](https://wordpress.org/support/topic/great-at-setting-image-focus-and-works-with-themes/)󠁿 [Jonathan Camp](https://profiles.wordpress.org/nampara17/) December 19, 2018 Tested a load of “so called” image crop tools. This is the only one I’ve found that: 1. Works with theme image sizes! (that was enough to clinch it for me) 2. Easy to use in the media management 3. Easy to manually set the focal position for each image and override as needed. This plugin (20181219) is only 54kb in size and worth 5*’s. Not sure why no one else has reviewed it. So easy to select which image size you want to adjust, then set the focus point and job done. Nice one guys. [ Read all 2 reviews ](https://wordpress.org/support/plugin/presswell-art-direction/reviews/) ## Contributors & Developers “Presswell Art Direction” is open source software. The following people have contributed to this plugin. Contributors * [ Presswell ](https://profiles.wordpress.org/presswell/) * [ benplum ](https://profiles.wordpress.org/benplum/) [Translate “Presswell Art Direction” into your language.](https://translate.wordpress.org/projects/wp-plugins/presswell-art-direction) ### Interested in development? [Browse the code](https://plugins.trac.wordpress.org/browser/presswell-art-direction/), check out the [SVN repository](https://plugins.svn.wordpress.org/presswell-art-direction/), or subscribe to the [development log](https://plugins.trac.wordpress.org/log/presswell-art-direction/) by [RSS](https://plugins.trac.wordpress.org/log/presswell-art-direction/?limit=100&mode=stop_on_copy&format=rss). ## Changelog #### 2.0.0 * Added dedicated regenerator screen. * Added compatibility mode (NGINX support). * Added debug logging. * Added CLI commands. * Complete overhaul of codebase. #### 1.1.11 * Adding alt text support to get_image_src. #### 1.1.10 * Fixing url mismatch. #### 1.1.9 * Fixing filesize warning. #### 1.1.8 * Adjusting multisite rewrite rules. #### 1.1.7 * Adding multisite support. #### 1.1.6 * Fixing duplicate path on original image. #### 1.1.5 * Fixing erroneous array key. #### 1.1.4 * Fixing empty array. #### 1.1.3 * Fixing errors and warnings. #### 1.1.2 * Fixing issue with thumbnail sizes that match the original upload’s dimensions. #### 1.1.1 * Reading real image sizes. #### 1.1.0 * New image regeneration method. #### 1.0.9 * Fixing issue with erroneous crops. #### 1.0.8 * Fixing empty image data array. #### 1.0.7 * Fixing issue with character encoding in filenames. #### 1.0.6 * Adding ability to disable smart caching. #### 1.0.5 * Fixing permalink protocol mismatch. #### 1.0.4 * Fixing media modal issue. * Adding Elementor support. #### 1.0.3 * Fixing updater issue. #### 1.0.0 * First public release. ## Meta * Version **2.0.0** * Last updated **2 weeks ago** * Active installations **100+** * WordPress version ** 6.1 or higher ** * Tested up to **6.9.4** * Language * [English (US)](https://wordpress.org/plugins/presswell-art-direction/) * Tags * [crop](https://test.wordpress.org/plugins/tags/crop/)[focal-point](https://test.wordpress.org/plugins/tags/focal-point/) [image](https://test.wordpress.org/plugins/tags/image/)[responsive images](https://test.wordpress.org/plugins/tags/responsive-images/) [thumbnails](https://test.wordpress.org/plugins/tags/thumbnails/) * [Advanced View](https://test.wordpress.org/plugins/presswell-art-direction/advanced/) ## Ratings 5 out of 5 stars. * [ 2 5-star reviews ](https://wordpress.org/support/plugin/presswell-art-direction/reviews/?filter=5) * [ 0 4-star reviews ](https://wordpress.org/support/plugin/presswell-art-direction/reviews/?filter=4) * [ 0 3-star reviews ](https://wordpress.org/support/plugin/presswell-art-direction/reviews/?filter=3) * [ 0 2-star reviews ](https://wordpress.org/support/plugin/presswell-art-direction/reviews/?filter=2) * [ 0 1-star reviews ](https://wordpress.org/support/plugin/presswell-art-direction/reviews/?filter=1) [Your review](https://wordpress.org/support/plugin/presswell-art-direction/reviews/#new-post) [See all reviews](https://wordpress.org/support/plugin/presswell-art-direction/reviews/) ## Contributors * [ Presswell ](https://profiles.wordpress.org/presswell/) * [ benplum ](https://profiles.wordpress.org/benplum/) ## Support Got something to say? Need help? [View support forum](https://wordpress.org/support/plugin/presswell-art-direction/)