← All releases

wp-content/plugins/lathe/lathe.php

Lathe

Per-size crops that keep the subject in frame, chosen once per image rather than per use.

== Description ==

WordPress crops from the centre, which decapitates people in every portrait used at a wide aspect ratio. Lathe lets you set a focal point once per image; every registered size then crops around it, including sizes registered later.

Where the automatic result is still wrong, you can override a single size by hand without affecting the others.

It also warns when an image is being used at a size larger than it was uploaded, which is the actual cause of most “why does this look blurry” tickets.

== Screenshots ==

Numbered the way they ship in /assets/. Click any one to see it full width.

== Installation ==

  • Install and activate the plugin.
  • Set focal points in the media library, or accept the detected suggestion.
  • Run wp lathe recrop --all to apply to existing images.

Originals are never modified. Recropping regenerates the derived sizes only.

== Frequently asked questions ==

Is subject detection automatic?

It suggests a focal point using edge density, and is right often enough to be a starting point rather than an answer.

New image sizes later?

They crop around the existing focal point with no extra work.

== Changelog ==

= 2.4.0 =

  • Upscale warning when an image is displayed larger than it was uploaded.
  • Per-size manual overrides.

= 2.2.0 =

  • Focal point suggestions from edge density.

= 2.0.0 =

  • Focal points stored per attachment rather than per size, so sizes registered later inherit them.