Presswell Art Direction

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=<int> (default 200)
• --batch-size=<int> (default 25)
• --target-seconds=<float> (default 5)
• --resume-last=<0|1> (default 0, continue the last interrupted queue)

wp pwad cache-prime Generates thumbnails based on sitemap.

• --sitemap=<url> (optional, auto-detects from robots.txt/common sitemap endpoints)
• --page-limit=<int> (default unlimited)
• --image-limit=<int> (default unlimited)
• --delay-ms=<int> (default 250)
• --timeout=<float> (default 10)
• --retries=<int> (default 2)
• --include-external=<0|1> (default 0)
• --force-endpoint=<0|1> (default 0)
• --report-csv=<path> (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=<url> (optional, auto-detects from robots.txt/common sitemap endpoints)
• --batch-size=<int> (default 200)
• --max-images=<int> (default unlimited)
• --page-limit=<int> (default unlimited)
• --image-limit=<int> (default unlimited)
• --timeout=<float> (default 10)
• --grace-days=<int> (default 0, uses file modified time)
• --include-external=<0|1> (default 0)
• --force-endpoint=<0|1> (default 0)
• --report-csv=<path> (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=<int> (default 200)
• --max-images=<int> (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.

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.

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.