Advanced Custom Fields: Image Aspect Ratio Crop Field

Popis

A field for Advanced Custom Field that forces the user to crop their image to specific aspect ratio after uploading. This is especially useful in responsive image use cases.

After cropping, a new cropped image variant is created in the gallery and saved into the post. Thumbnails are also generated for the new image. User can re-crop the original image at any time from the post page.

The cropped image variants are hidden by default in the media browser and on the media page but you can view them by selecting the „list view“ on the media page.

Compatibility

This ACF field type is compatible with:

  • ACF 5

Thanks

Special thanks to Anders Thorborg for ACF Image Crop which served as a inspiration for this plugin. Also, thanks to Fengyuan Chen for the cropper.js library!

Snímky obrazovky

  • Cropping an image to 16:9 aspect ratio
  • Cropping in progress
  • Option to re-crop the image after upload

Instalace

  1. Copy the acf-image-aspect-ratio-crop folder into your wp-content/plugins folder
  2. Activate the Image Aspect Ratio Crop plugin via the plugins admin page
  3. Create a new field via ACF and select the Image Aspect Ratio Crop type
  4. Read the description above for usage instructions

Časté dotazy

Can I access metadata in the original image from a cropped image?

Yes, the original image data is saved under original_image key in the returned ACF array. You can access data such as alt text, description and title this way.

I have an issue or I want to contribute code

Please use the GitHub repository to raise issues about the plugin. You are also free to send a pull request on GitHub.

How is this different from the other plugin?

Advanced Custom Fields: Image Crop Add-on is based on exact image dimensions (like 640×480). This plugin uses an aspect ratio such as 4:3 instead. Using an aspect ratio is is more convenient when working with responsive images since you care about the aspect ratio more than pixel dimensions.

Of course, nothing will stop you from using an aspect ratio like 1200:630 which is similar to a pixel amount with this plugin, if you want.

Also, as of 2019, the other plugin is not actively maintained anymore and does not work well with latest ACF versions. I try to maintain this plugin as best as I can when new versions of ACF and WordPress come out.

Recenze

1. 11. 2019
I've used ACF crop for a very long time and just stumbled upon this plugin today. I really like it. It works well and it feels a bit more modern. As a thanks I've contributed with a Danish translation. 🙂
31. 8. 2019
Works great but I don't like how when you make a 1 crop and expect 1 image in the uploads folder but it actually makes a bunch of new sizes for this 1 crop. Clutters up the uploads folder with the exact same image. Also could you make it not mandatory to crop every upload?
6. 7. 2019
With a combination of this plugin and Toolbox, you can easily integrate it to have your Beaver Builder or Beaver Themer site recognize this as an ACF field. This plugin is amazing!
31. 3. 2019
The plugin works great, it's fast and intuitive.
Přečtěte si všech 8 recenzí

Autoři

Advanced Custom Fields: Image Aspect Ratio Crop Field je otevřený software. Následující lidé přispěli k vývoji tohoto pluginu.

Spolupracovníci

Plugin „Advanced Custom Fields: Image Aspect Ratio Crop Field“ byl přeložen do 1 jazyku. Děkujeme všem překladatelům za jejich pomoc.

Přeložte “Advanced Custom Fields: Image Aspect Ratio Crop Field” do svého jazyka.

Zajímá vás vývoj?

Prohledejte kód, podívejte se do SVN repozitáře, nebo se přihlaste k odběru protokolu vývoje pomocí RSS.

Přehled změn

3.0.1

  • Fix: bump plugin version

3.0.0

  • Fix / Breaking change: If image was deleted, object with empty original_image field was returned. In 3.0.0 false is returned instead to keep compatibility with normal image field.

2.2.1

  • Fix: Improve WPML compatibility

2.2.0

  • Feature: Add compatibility with ACF Image Crop plugin
  • Fix: Change default preview size to medium, as in ACF 5.8.1
  • Fix: Remove image CSS shadow to match latest ACF image field styles

2.1.1

  • Fix: Fix issue where crop coordinates persisted after deleting image

2.1.0

  • Feature: Cropper now remembers last crop position when re-cropping image
  • Feature: Add button to reset crop position to default (centered)
  • Fix: Bump supported WordPress version to 5.2

2.0.3

  • Fix: Allow cropping in cases when image is hosted remotely and is missing CORS headers

2.0.2

  • Fix: Fix issue where saving in image modal replaced cropped image with original when „Original image“ was selected in „Image displayed in attachment edit modal dialog“
  • Fix: Actually save plugin version in the database for migration support
  • Fix: Get file hash in debug mode from file path instead of URL

2.0.1

  • Fix: Fix typo

2.0.0

  • Feature: Compatibility with WP Offload Media and similar plugins that move WordPress images to a remote location. Plugin will now attempt to fetch images from remote URLs if they are not found in the file system.
  • Breaking change: Due to new dependencies, PHP 5.5 is now the minimum required version

1.3.1

  • Fix: Fix deployment script

1.3.0

  • Feature: Handle translation through w.org

1.2.3

  • Fix: Update readme

1.2.2

  • Fix: Update screenshots

1.2.0

  • Feature: It’s now possible to edit original image data instead of cropped image data when pressing the pencil button in the image field. This is handy if you have meta data such as alt text that you want to share between the original image and its cropped variants. Toggle this by selecting Settings in the plugin list.
  • Feature: There is now a progress indicator (spinner) displayed while the image is being cropped
  • Feature: If an error occurs while cropping an image, the error message is displayed inline in the modal instead of a browser alert window
  • Feature: Improved styles for the cropper
  • Feature: Modern and improved build process with webpack
  • Feature: Make it possible to localize UI texts

1.1.2

  • Fix: Bump supported WordPress version to 5.1

1.1.1

  • Fix: Update readme

1.1.0

  • Feature: Allow customizing file upload directory with filters aiarc_pre_customize_upload_dir and aiarc_after_customize_upload_dir

1.0.9

  • Fix: Update screenshots
  • Fix: Update WordPress compatibility information

1.0.8

  • Fix bug with detecting the same aspect ratio

1.0.7

  • Update compatibility information

1.0.6

  • Fix bug with detecting the same aspect ratio

1.0.5

  • User interface improvements
  • Fixed issue where cropper sometimes showed a wrong image
  • Improved performance in cases uploaded image had the correct aspect ratio. Thanks to @hrohh on w.org for the tip!

1.0.4

  • Fix incompatibility with ACF 5.7

1.0.3

  • Release on w.org

1.0.2

  • Update readme

1.0.1

  • Fix issue where the cropper broke if multiple images were selected inside a repeater
  • Cropper is now disabled while cropping is in progress
  • Fix issue where is was not possible to re-crop image before saving the post

1.0.0

  • Initial Release.