Installing Responsive Focal Point, every setting it has, the screens it adds, and its 0 documented actions and filters. The full reference, including the arguments every hook receives, ships inside the plugin on its Documentation screen and in docs/HOOKS.md, so it can never describe a version you are not running.
What you need
- WordPress 6.4 or newer
- PHP 8.0 or newer
- No other plugin, service or account required
Installing it
- Open Plugins → Add New, search for Responsive Focal Point, install and activate it.
- Open its Status screen from the sidebar. It reports what is running, and it is the first place to look if something later seems not to be.
- That is the whole installation. Every setting has a working default, so nothing has to be configured before the plugin does its job.
Where everything is in wp-admin
- The focal point control appears on every image in the Media Library, which is where the work actually happens.
- Breakpoints is the list of widths an editor can set a separate point for.
- Status reports what is active and shows the template helpers.
- Images is the audit: coverage across the library, and what still has nothing set.
- Documentation is the full reference, bundled with the plugin.
Settings
Every one of these has a default that works. The defaults below are the ones in the code, not a recommendation.
| Setting | Default | What it does |
|---|---|---|
breakpoints | Tablet up to 1024px, Mobile up to 767px | The widths an editor can set a separate focal point for. Two in the free tier on top of the default, unlimited in Pro. |
use_important | on | Whether the generated object-position rules carry !important. Leave it on unless your theme sets object-position itself and you want it to win. |
content_images | on | Applies focal points to images inside post content, not only to featured images and template calls. |
Actions and filters
Limits, classifications, tracked values and admin screens are all filterable, so extending this plugin does not mean forking it. Names and descriptions below are generated from the source.
A worked example
// More breakpoints than the free tier allows.
add_filter( 'wpfp_breakpoint_limit', fn( int $limit ): int => 6 );
// Add a selector of your own to the generated stylesheet.
add_filter( 'wpfp_stylesheet', function ( string $css ): string {
return $css . "n.hero__image img { object-fit: cover; }";
} );
// Do something whenever an editor saves a focal point.
add_action( 'wpfp_points_saved', function ( int $attachment_id, array $points ): void {
do_action( 'my_cdn_purge', wp_get_attachment_url( $attachment_id ) );
}, 10, 2 );If something is wrong
Check the Status screen, then the debug panel on the front end: between them they name what was captured, what matched and why. If that does not answer it, write to us and say what you expected instead. There is also the product page if you want to see the screens before installing anything.