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.<\/p>\n\n
Features<\/strong><\/p>\n\n Focal Point Cropping<\/em><\/strong><\/p>\n\n 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.<\/p>\n\n Custom Size Management<\/em><\/strong><\/p>\n\n 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.<\/p>\n\n Dynamic Generation + Endpoint Mode<\/em><\/strong><\/p>\n\n 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.<\/p>\n\n If filename-based 404 image requests do not reach WordPress (common in some NGINX\/server setups), enable Endpoint Mode ( Regenerator<\/em><\/strong><\/p>\n\n 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.<\/p>\n\n Public APIs<\/strong><\/p>\n\n pwad_add_image_size( $args )<\/strong><\/p>\n\n Example:<\/p>\n\n pwad_get_image_sizes()<\/strong><\/p>\n\n Returns all currently-available sizes (WordPress defaults + plugin\/theme sizes + Presswell Art Direction sizes\/thumbnails).<\/p>\n\n Example:<\/p>\n\n $sizes = pwad_get_image_sizes();<\/p>\n\n pwad_get_image( $attachment_ID, $size_key, $attr = array() )<\/strong><\/p>\n\n Returns an image tag.<\/p>\n\n Example:<\/p>\n\n $square_large = pwad_get_image( $img_ID, 'square' );\n $square_small = pwad_get_image( $img_ID, 'square-small', array( 'class' => 'hero-image' ) );<\/p>\n\n pwad_get_image_src( $attachment_ID, $size_key )<\/strong><\/p>\n\n Returns a keyed array containing the Example:<\/p>\n\n $square_large = pwad_get_image_src( $img_ID, 'square' );\n $square_small = pwad_get_image_src( $img_ID, 'square-small' );<\/p>\n\n WP-CLI<\/strong><\/p>\n\n wp pwad regenerate<\/strong><\/p>\n\n Regenerates thumbnails.<\/p>\n\n wp pwad cache-prime<\/strong><\/p>\n\n Generates thumbnails based on sitemap.<\/p>\n\n wp pwad cache-prune<\/strong><\/p>\n\n Deletes cached thumbnails not referenced in sitemap.<\/p>\n\n wp pwad cache-clean<\/strong><\/p>\n\n Deletes all cached thumbnails.<\/p>\n\n wp pwad queue-status<\/strong><\/p>\n\n Shows resumable\/remaining state for regenerator and cache queue runs.<\/p>\n\n Presswell Art Direction does not send image data to external services. It processes image metadata and generated variants within your WordPress environment.<\/p>\n\n\n Install via the WordPress plugin installer, or manually upload the plugin directory to Configuration<\/strong><\/p>\n\n 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.<\/p><\/dd>\n Focal points let you control crop framing across many sizes without manually defining crop coordinates for every variant.<\/p><\/dd>\n 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.<\/p><\/dd>\n 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.<\/p><\/dd>\n Open Media<\/em> -> Regenerate Thumbnails<\/em> and run the regenerator, or run 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.<\/p><\/dd>\n\n<\/dl>\n\n\n\n
\/pwad-image\/?id=...&size=...<\/code>). The plugin includes an automatic compatibility check in wp-admin.<\/p>\n\nDocumentation<\/h4>\n\n
\n
name<\/code>, key<\/code>, height<\/code>, width<\/code>, crop<\/code> (optional), and optionally thumbnails<\/code> values.<\/li>\n[size]-[thumbnail]<\/code>.<\/li>\n<\/ul>\n\npwad_add_image_size( array(\n 'name' => 'Square',\n 'key' => 'square',\n 'width' => '1200',\n 'height' => '1200',\n 'crop' => true,\n 'thumbnails' => array(\n array(\n 'name' => 'Medium',\n 'key' => 'medium',\n 'width' => '800',\n 'height' => '800',\n ),\n array(\n 'name' => 'Small',\n 'key' => 'small',\n 'width' => '400',\n 'height' => '400',\n ),\n ),\n) );\n<\/code><\/pre>\n\n\n
thumbnail<\/code>, large<\/code>, my-size<\/code>, my-size-mobile<\/code>, etc.)<\/li>\n\n
thumbnail<\/code>, large<\/code>, my-size<\/code>, my-size-mobile<\/code>, etc.)<\/li>\n<\/ul>\n\nfile<\/code>, url<\/code>, path<\/code>, height<\/code>, width<\/code>, and mime-type<\/code> values.<\/p>\n\n\n
--queue-per-page=<int><\/code> (default 200<\/code>)<\/li>\n--batch-size=<int><\/code> (default 25<\/code>)<\/li>\n--target-seconds=<float><\/code> (default 5<\/code>)<\/li>\n--resume-last=<0|1><\/code> (default 0<\/code>, continue the last interrupted queue)<\/li>\n<\/ul>\n\n\n
--sitemap=<url><\/code> (optional, auto-detects from robots.txt\/common sitemap endpoints)<\/li>\n--page-limit=<int><\/code> (default unlimited)<\/li>\n--image-limit=<int><\/code> (default unlimited)<\/li>\n--delay-ms=<int><\/code> (default 250<\/code>)<\/li>\n--timeout=<float><\/code> (default 10<\/code>)<\/li>\n--retries=<int><\/code> (default 2<\/code>)<\/li>\n--include-external=<0|1><\/code> (default 0<\/code>)<\/li>\n--force-endpoint=<0|1><\/code> (default 0<\/code>)<\/li>\n--report-csv=<path><\/code> (optional, writes per-URL status\/error report)<\/li>\n--dry-run=<0|1><\/code> (default 0<\/code>)<\/li>\n--resume-last=<0|1><\/code> (default 0<\/code>, continue the last interrupted prime run)<\/li>\n<\/ul>\n\n\n
--sitemap=<url><\/code> (optional, auto-detects from robots.txt\/common sitemap endpoints)<\/li>\n--batch-size=<int><\/code> (default 200<\/code>)<\/li>\n--max-images=<int><\/code> (default unlimited)<\/li>\n--page-limit=<int><\/code> (default unlimited)<\/li>\n--image-limit=<int><\/code> (default unlimited)<\/li>\n--timeout=<float><\/code> (default 10<\/code>)<\/li>\n--grace-days=<int><\/code> (default 0<\/code>, uses file modified time)<\/li>\n--include-external=<0|1><\/code> (default 0<\/code>)<\/li>\n--force-endpoint=<0|1><\/code> (default 0<\/code>)<\/li>\n--report-csv=<path><\/code> (optional, writes per-file keep\/delete report)<\/li>\n--dry-run=<0|1><\/code> (default 1<\/code>)<\/li>\n--resume-last=<0|1><\/code> (default 0<\/code>, continue the last interrupted prune run)<\/li>\n<\/ul>\n\n\n
--batch-size=<int><\/code> (default 200<\/code>)<\/li>\n--max-images=<int><\/code> (default unlimited)<\/li>\n--include-default=<0|1><\/code> (default 0<\/code>)<\/li>\n--dry-run=<0|1><\/code> (default 1<\/code>)<\/li>\n--resume-last=<0|1><\/code> (default 0<\/code>, continue the last interrupted clean run)<\/li>\n<\/ul>\n\nPrivacy<\/h3>\n\n
wp-content\/plugins\/<\/code>.<\/p>\n\n\n
\n
How do I set a focal point?<\/h3><\/dt>\n
Why should I use focal points?<\/h3><\/dt>\n
Why use dynamic image generation?<\/h3><\/dt>\n
What is Endpoint Mode (Compatibility Mode)?<\/h3><\/dt>\n
How do I regenerate images in bulk?<\/h3><\/dt>\n
wp pwad regenerate<\/code> from WP-CLI.<\/p><\/dd>\nWhy would I delete all cached images?<\/h3><\/dt>\n
2.0.0<\/h4>\n\n
\n
1.1.11<\/h4>\n\n
\n
1.1.10<\/h4>\n\n
\n
1.1.9<\/h4>\n\n
\n
1.1.8<\/h4>\n\n
\n
1.1.7<\/h4>\n\n
\n
1.1.6<\/h4>\n\n
\n
1.1.5<\/h4>\n\n
\n
1.1.4<\/h4>\n\n
\n
1.1.3<\/h4>\n\n
\n
1.1.2<\/h4>\n\n
\n
1.1.1<\/h4>\n\n
\n
1.1.0<\/h4>\n\n
\n
1.0.9<\/h4>\n\n
\n
1.0.8<\/h4>\n\n
\n
1.0.7<\/h4>\n\n
\n
1.0.6<\/h4>\n\n
\n
1.0.5<\/h4>\n\n
\n
1.0.4<\/h4>\n\n
\n