{"id":132526,"date":"2020-12-07T06:41:02","date_gmt":"2020-12-07T06:41:02","guid":{"rendered":"https:\/\/ru.wordpress.org\/plugins\/wp-image-mask\/"},"modified":"2025-05-09T15:25:26","modified_gmt":"2025-05-09T15:25:26","slug":"wp-image-mask","status":"publish","type":"plugin","link":"https:\/\/bal.wordpress.org\/plugins\/wp-image-mask\/","author":17884139,"comment_status":"closed","ping_status":"closed","template":"","meta":{"_crdt_document":"","version":"3.1.3","stable_tag":"3.1.3","tested":"6.8.5","requires":"6.0.1","requires_php":"7.3","requires_plugins":null,"header_name":"WP Image Mask","header_author":"Bogdan Bendziukov","header_description":"Add the ability to set an SVG mask to Gutenberg image block","assets_banners_color":"d2e798","last_updated":"2025-05-09 15:25:26","external_support_url":"","external_repository_url":"","donate_link":"","header_plugin_uri":"https:\/\/wordpress.com\/plugins\/wp-image-mask","header_author_uri":"https:\/\/bogdan.kyiv.ua","rating":5,"author_block_rating":0,"active_installs":200,"downloads":4736,"num_ratings":1,"support_threads":0,"support_threads_resolved":0,"author_block_count":0,"sections":["description","installation","faq","changelog"],"tags":{"3.0":{"tag":"3.0","author":"barb0ss","date":"2023-07-18 11:47:08"},"3.1":{"tag":"3.1","author":"barb0ss","date":"2024-04-25 17:08:26"},"3.1.1":{"tag":"3.1.1","author":"barb0ss","date":"2024-08-08 13:21:02"},"3.1.2":{"tag":"3.1.2","author":"barb0ss","date":"2024-11-05 15:16:38"},"3.1.3":{"tag":"3.1.3","author":"barb0ss","date":"2025-05-09 15:25:26"}},"upgrade_notice":{"3.1.3":"<ul>\n<li>Fixed security vulnerability<\/li>\n<\/ul>","3.1.2":"<ul>\n<li>Removed inline  tags, applied image mask as inline css<\/li>\n<li>Fixed Gutenberg view for custom image mask<\/li>\n<li>Migrate to @wordpress\/create-block<\/li>\n<\/ul>","3.1.1":"<ul>\n<li>Removed unnecessary wp-image-mask \u2013 CGB Block<\/li>\n<\/ul>","3.1":"<ul>\n<li>Add the ability to select mask fit in the Gutenberg block<\/li>\n<li>Removed network level from the plugin<\/li>\n<\/ul>","3.0":"<ul>\n<li>Add a shortcode to apply image mask.<\/li>\n<\/ul>","2.0":"<ul>\n<li>Fixed issues with applying custom masks to images.<\/li>\n<\/ul>","1.0":"<ul>\n<li>First release.<\/li>\n<\/ul>"},"ratings":{"1":0,"2":0,"3":0,"4":0,"5":1},"assets_icons":{"icon-256x256.jpg":{"filename":"icon-256x256.jpg","revision":2939892,"resolution":"256x256","location":"assets","locale":""},"icon.svg":{"filename":"icon.svg","revision":3267792,"resolution":false,"location":"assets","locale":false}},"assets_banners":{"banner-1544x500.jpg":{"filename":"banner-1544x500.jpg","revision":3267791,"resolution":"1544x500","location":"assets","locale":""},"banner-772x250.jpg":{"filename":"banner-772x250.jpg","revision":3267791,"resolution":"772x250","location":"assets","locale":""}},"assets_blueprints":{},"all_blocks":[],"tagged_versions":["3.0","3.1","3.1.1","3.1.2","3.1.3"],"block_files":[],"assets_screenshots":{"screenshot-1.jpg":{"filename":"screenshot-1.jpg","revision":2779245,"resolution":"1","location":"assets","locale":""},"screenshot-2.jpg":{"filename":"screenshot-2.jpg","revision":2779245,"resolution":"2","location":"assets","locale":""},"screenshot-3.jpg":{"filename":"screenshot-3.jpg","revision":2779245,"resolution":"3","location":"assets","locale":""},"screenshot-4.jpg":{"filename":"screenshot-4.jpg","revision":2779245,"resolution":"4","location":"assets","locale":""},"screenshot-5.jpg":{"filename":"screenshot-5.jpg","revision":2939892,"resolution":"5","location":"assets","locale":""},"screenshot-6.jpg":{"filename":"screenshot-6.jpg","revision":2939892,"resolution":"6","location":"assets","locale":""},"screenshot-7.jpg":{"filename":"screenshot-7.jpg","revision":2939892,"resolution":"7","location":"assets","locale":""}},"screenshots":{"1":"Select your image (or add a new one from Gutenberg blocks).","2":"Select the type of image mask from the block's settings.","3":"If you choose a custom image - click on the Choose mask image button to upload your custom mask.","4":"Once you have selected the mask - it will apply to your image.","5":"If you choose SVG code - paste your SVG code in the textarea field.","6":"Once you have pasted the code - it will apply to your image.","7":"You can also apply image masks to gallery's images."},"jetpack_post_was_ever_published":false},"plugin_section":[],"plugin_tags":[148076,133,557,80],"plugin_category":[50],"plugin_contributors":[193845],"plugin_business_model":[],"class_list":["post-132526","plugin","type-plugin","status-publish","hentry","plugin_tags-gutenberg","plugin_tags-image","plugin_tags-mask","plugin_tags-shortcode","plugin_category-media","plugin_contributors-barb0ss","plugin_committers-barb0ss"],"banners":{"banner":"https:\/\/ps.w.org\/wp-image-mask\/assets\/banner-772x250.jpg?rev=3267791","banner_2x":"https:\/\/ps.w.org\/wp-image-mask\/assets\/banner-1544x500.jpg?rev=3267791","banner_rtl":false,"banner_2x_rtl":false},"icons":{"svg":"https:\/\/ps.w.org\/wp-image-mask\/assets\/icon.svg?rev=3267792","icon":"https:\/\/ps.w.org\/wp-image-mask\/assets\/icon.svg?rev=3267792","icon_2x":false,"generated":false},"screenshots":[{"src":"https:\/\/ps.w.org\/wp-image-mask\/assets\/screenshot-1.jpg?rev=2779245","caption":"Select your image (or add a new one from Gutenberg blocks)."},{"src":"https:\/\/ps.w.org\/wp-image-mask\/assets\/screenshot-2.jpg?rev=2779245","caption":"Select the type of image mask from the block's settings."},{"src":"https:\/\/ps.w.org\/wp-image-mask\/assets\/screenshot-3.jpg?rev=2779245","caption":"If you choose a custom image - click on the Choose mask image button to upload your custom mask."},{"src":"https:\/\/ps.w.org\/wp-image-mask\/assets\/screenshot-4.jpg?rev=2779245","caption":"Once you have selected the mask - it will apply to your image."},{"src":"https:\/\/ps.w.org\/wp-image-mask\/assets\/screenshot-5.jpg?rev=2939892","caption":"If you choose SVG code - paste your SVG code in the textarea field."},{"src":"https:\/\/ps.w.org\/wp-image-mask\/assets\/screenshot-6.jpg?rev=2939892","caption":"Once you have pasted the code - it will apply to your image."},{"src":"https:\/\/ps.w.org\/wp-image-mask\/assets\/screenshot-7.jpg?rev=2939892","caption":"You can also apply image masks to gallery's images."}],"raw_content":"<!--section=description-->\n<p>Select a custom mask for your Gutenberg image's block or add a masked image anywhere via shortcode <code>[wp-image-mask]<\/code>.<\/p>\n\nShortcode attributes:\n\n<ul>\n<li><code>src<\/code> - URL of the image;<\/li>\n<li><code>mask<\/code> - URL of the mask;<\/li>\n<li><code>fit<\/code>  - how the mask should fit into the image. <code>cover<\/code>, <code>contain<\/code> (default <code>contain<\/code>);<\/li>\n<li><code>alt<\/code> - alt text for the image.<\/li>\n<\/ul>\n\n<!--section=installation-->\n<p>Upload the WP Image Mask plugin to your site, activate it and start using.<\/p>\n\n<!--section=faq-->\n<dl>\n<dt id='do%20i%20need%20to%20replace%20my%20images%20with%20some%20custom%20gutenberg%20block%20to%20use%20an%20image%20mask%3F'><h3>Do I need to replace my images with some custom Gutenberg block to use an image mask?<\/h3><\/dt>\n<dd><p>No, this plugin attaches to the native Gutenberg image block, so no need to replace your existing images.<\/p><\/dd>\n<dt id='can%20i%20apply%20my%20custom%20image%20mask%3F'><h3>Can I apply my custom image mask?<\/h3><\/dt>\n<dd><p>Sure! You can select a custom image mask file or paste SVG code of your image mask.<\/p><\/dd>\n<dt id='i%20don%27t%20use%20gutenberg%20-%20is%20there%20any%20other%20way%20to%20add%20an%20image%20with%20a%20mask%3F'><h3>I don't use Gutenberg - is there any other way to add an image with a mask?<\/h3><\/dt>\n<dd><p>Yes! You can use shortcode <code>[wp-image-mask src=\"https:\/\/url_of_your_image\" mask=\"https:\/\/url_of_your_mask_image\"]<\/code>.<\/p><\/dd>\n\n<\/dl>\n\n<!--section=changelog-->\n<h4>3.1.3<\/h4>\n\n<ul>\n<li>Fixed security vulnerability<\/li>\n<\/ul>\n\n<h4>3.1.2<\/h4>\n\n<ul>\n<li>Removed inline  tags, applied image mask as inline css<\/li>\n<li>Fixed Gutenberg view for custom image mask<\/li>\n<li>Migrate to @wordpress\/create-block<\/li>\n<\/ul>\n\n<h4>3.1.1<\/h4>\n\n<ul>\n<li>Removed unnecessary wp-image-mask \u2013 CGB Block<\/li>\n<\/ul>\n\n<h4>3.1<\/h4>\n\n<ul>\n<li>Add the ability to select mask fit in the Gutenberg block<\/li>\n<\/ul>\n\n<h4>3.0<\/h4>\n\n<ul>\n<li>Stable release. <\/li>\n<li>Add a shortcode to apply image mask. <\/li>\n<\/ul>\n\n<h4>2.0<\/h4>\n\n<ul>\n<li>Stable release. <\/li>\n<li>Fixed issues with applying custom masks to images.<\/li>\n<li>Add the ability to paste SVG code for image masks.<\/li>\n<\/ul>\n\n<h4>1.0<\/h4>\n\n<ul>\n<li>First release.<\/li>\n<\/ul>","raw_excerpt":"This plugin adds the ability to set a mask to Gutenberg&#039;s image block or via shortcode [wp-image-mask].","jetpack_sharing_enabled":true,"_links":{"self":[{"href":"https:\/\/bal.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin\/132526","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/bal.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin"}],"about":[{"href":"https:\/\/bal.wordpress.org\/plugins\/wp-json\/wp\/v2\/types\/plugin"}],"replies":[{"embeddable":true,"href":"https:\/\/bal.wordpress.org\/plugins\/wp-json\/wp\/v2\/comments?post=132526"}],"author":[{"embeddable":true,"href":"https:\/\/bal.wordpress.org\/plugins\/wp-json\/wporg\/v1\/users\/barb0ss"}],"wp:attachment":[{"href":"https:\/\/bal.wordpress.org\/plugins\/wp-json\/wp\/v2\/media?parent=132526"}],"wp:term":[{"taxonomy":"plugin_section","embeddable":true,"href":"https:\/\/bal.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_section?post=132526"},{"taxonomy":"plugin_tags","embeddable":true,"href":"https:\/\/bal.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_tags?post=132526"},{"taxonomy":"plugin_category","embeddable":true,"href":"https:\/\/bal.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_category?post=132526"},{"taxonomy":"plugin_contributors","embeddable":true,"href":"https:\/\/bal.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_contributors?post=132526"},{"taxonomy":"plugin_business_model","embeddable":true,"href":"https:\/\/bal.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_business_model?post=132526"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}