Focal Point Picker
Zero-dependency custom focal point picker for your WordPress images π―
by Rasso Hilber Β· github.com/hirasso/focal-point-picker Β· website
β
42stars
12kcomposer installs
6forks
Install
No release zip yet. The repository archive installs, but the folder name will carry the branch suffix and updates will not flow:
wp plugin install https://github.com/hirasso/focal-point-picker/archive/refs/heads/main.zipAlso on Packagist as hirasso/focal-point-picker:
composer require hirasso/focal-point-pickerDeclares an update source (hirasso/focal-point-picker), so updates arrive through the plugin's own updater.
From the readme
Focal Point Picker
Zero-dependency custom focal point)) picker for your WordPress images π―
Installation
Via Composer (recommended):
1. Install the plugin:
1. Activate the plugin manually or using WP CLI:
Manually:
1. Download and extract the plugin
2. Copy the focal-point-picker folder into your wp-content/plugins folder
3. Activate the plugin via the plugins admin page β Done!
4. Handle updates via afragen/git-updater
Data structure
You can retrieve the focal point for an image like this:
Output:
Usage in your templates
Object Position
Background Position
Using wpgetattachmentimage
If you are making use of the WordPress function wpgetattachmentimage(), the plugin will automatically inject a class focal-point-image and two custom css properties for you to use:
You can use that like this, for example:
Filters
The default position of the focal point can be customized using filters:
This might come in handy if you have many photographs where the eyes of people are at the top of the image somewhere and you don't want to adjust them all manually.
WPCLI Interface
fcp apply-default-position
Apply the default position to existing images:
Read the full README on GitHub β
Releases
| Tag | Published | Asset | Downloads |
|---|---|---|---|
| v1.4.0 | Oct 30, 2025 | β | β |
| v1.3.8 | Feb 14, 2025 | β | β |
| v1.3.7 | Feb 11, 2025 | β | β |
| v1.3.6 | Feb 6, 2025 | β | β |
| v1.3.5 | Jan 17, 2025 | β | β |
| v1.3.4 | Jan 17, 2025 | β | β |
| v1.3.3 | Jan 17, 2025 | β | β |
| 1.3.2 | Oct 28, 2024 | β | β |
| 1.3.1 | Jul 25, 2024 | β | β |
| 1.3.0 | Jul 24, 2024 | β | β |
| 1.2.6 | Jul 24, 2024 | β | β |
| 1.2.5 | Jul 23, 2024 | β | β |
| 1.2.4 | Jul 23, 2024 | β | β |
| 1.2.3 | Jul 22, 2024 | β | β |
| 1.2.1 | Jul 19, 2024 | β | β |
| 1.2.0 | Jul 11, 2024 | β | β |