WP Image Mask

Description

Select custom mask for your Gutenberg image’s block or add a masked image anywhere via shortcode [wp-image-mask].

Shortcode attributes:

  • src – URL of the image;
  • mask – URL of the mask;
  • fit – how the mask should fit into the image. cover, contain (default contain);
  • alt – alt text for the image.

Screenshots

  • Select your image (or add a new one from Gutenberg blocks).
  • Select type of image mask from the block’s settings.
  • If you choosed custom image – click on the Choose mask image button to upload your custom mask.
  • Once you have selected the mask – it will apply to your image.
  • If you choosed SVG code – paste your SVG code in the textarea field.
  • Once you have pasted the code – it will apply to your image.
  • You can also apply image masks to gallery’s images.

Blocks

This plugin provides 2 blocks.

  • wp-image-mask – CGB Block
  • WP Image Mask

Installation

Upload the WP Image Mask plugin to your site, activate it and start using.

FAQ

Do I need to replace my images with some custom Gutenberg block to use image mask?

No, this plugin attaches to the native Gutenberg image block, so no need to replace your existing images.

Can I apply my custom image mask?

Sure! You can select a custom image mask file or paste SVG code of your image mask.

I don’t use Gutenberg – is there any way to add an image with mask?

Yes! You can use shortcode [wp-image-mask src="https://url_of_your_image" mask="https://url_of_your_mask_image"].

Reviews

22 de diciembre de 2023 1 reply
I needed a way to have irregular looking shapes for photos. I thought I might have to create a custom solution, but was pleased that this plugin did exactly what I needed. I was able to upload SVG images to use as masks to the site media library, and then it was really easy to assign those to be used as masks to images using the default WP image block. I like how the plugin integrates directly into the image block interface. Excellent! I will end up using this plugin on a lot more sites in the future.
Read all 1 review

Contributors & Developers

“WP Image Mask” is open source software. The following people have contributed to this plugin.

Contributors

“WP Image Mask” has been translated into 3 locales. Thank you to the translators for their contributions.

Translate “WP Image Mask” into your language.

Interested in development?

Browse the code, check out the SVN repository, or subscribe to the development log by RSS.

Changelog

3.1

  • Add the ability to select mask fit in the Gutenberg block

3.0

  • Stable release.
  • Add shortcode to apply image mask.

2.0

  • Stable release.
  • Fixed issues with applying custom mask to images.
  • Add the ability to paste SVG code for image mask.

1.0

  • First release.