{"id":361131,"date":"2026-09-19T15:59:17","date_gmt":"2026-09-19T15:59:17","guid":{"rendered":"https:\/\/wordpress.org\/plugins\/matcha-gallery-ai-photo-wall-masonry-portfolio-studio\/"},"modified":"2026-09-20T20:04:15","modified_gmt":"2026-09-20T20:04:15","slug":"matcha-gallery","status":"publish","type":"plugin","link":"https:\/\/wordpress.org\/plugins\/matcha-gallery\/","author":23360268,"comment_status":"closed","ping_status":"closed","template":"","meta":{"version":"1.0.1","stable_tag":"1.0.1","tested":"7.1.2","requires":"6.2","requires_php":"8.0","requires_plugins":null,"header_name":"Matcha Gallery \u2013 AI Photo Wall, Masonry & Portfolio Studio","header_author":"WP Matcha","header_description":"AI-powered image metadata generation, interactive mosaic photo walls, masonry layouts, picture framing, client proofing, and smart portfolios for WordPress.","assets_banners_color":"bab8b1","last_updated":"2026-09-20 20:04:15","external_support_url":"","external_repository_url":"","donate_link":"https:\/\/wpmatcha.com","header_plugin_uri":"","header_author_uri":"https:\/\/wpmatcha.com","rating":0,"author_block_rating":0,"active_installs":0,"downloads":122,"num_ratings":0,"support_threads":0,"support_threads_resolved":0,"author_block_count":0,"sections":["description","installation","faq","changelog"],"tags":{"1.0.0":{"tag":"1.0.0","author":"wpmatcha","date":"2026-09-19 15:58:45","revision":3703430},"1.0.1":{"tag":"1.0.1","author":"wpmatcha","date":"2026-09-20 20:04:15","revision":3704584}},"upgrade_notice":{"1.0.1":"<p>Fixes dashboard menu icon sizing and adds curated style presets.<\/p>","1.0.0":"<p>Initial release of Matcha Gallery.<\/p>"},"ratings":[],"assets_icons":{"icon-128x128.png":{"filename":"icon-128x128.png","revision":3703430,"resolution":"128x128","location":"assets","locale":"","width":128,"height":128},"icon-256x256.png":{"filename":"icon-256x256.png","revision":3703430,"resolution":"256x256","location":"assets","locale":"","width":256,"height":256},"icon.svg":{"filename":"icon.svg","revision":3703453,"resolution":false,"location":"assets","locale":false}},"assets_banners":{"banner-1544x500.png":{"filename":"banner-1544x500.png","revision":3703455,"resolution":"1544x500","location":"assets","locale":"","width":1544,"height":500},"banner-772x250.png":{"filename":"banner-772x250.png","revision":3703455,"resolution":"772x250","location":"assets","locale":"","width":772,"height":250}},"assets_blueprints":{},"all_blocks":{"matcha-ai\/smart-gallery":{"$schema":"https:\/\/schemas.wp.org\/trunk\/block.json","apiVersion":3,"name":"matcha-ai\/smart-gallery","version":"1.0.1","title":"Matcha AI Smart Gallery","category":"media","icon":"format-gallery","description":"AI-powered filterable image gallery with grid and masonry layouts.","keywords":["gallery","images","filter","ai","matcha","masonry"],"textdomain":"matcha-gallery","supports":{"html":false,"align":["wide","full"],"spacing":{"margin":true,"padding":true}},"attributes":{"sourceType":{"type":"string","default":"selected"},"imageIds":{"type":"array","default":[],"items":{"type":"number"}},"aiTags":{"type":"array","default":[],"items":{"type":"string"}},"layout":{"type":"string","default":"grid","enum":["grid","masonry","justified","mosaic","bento","pinwheel"]},"rowHeight":{"type":"number","default":240},"hoverEffect":{"type":"string","default":"zoom"},"hoverFrameColor":{"type":"string","default":""},"hoverMobileTap":{"type":"string","default":"lightbox"},"columns":{"type":"number","default":3},"columnsTablet":{"type":"number","default":2},"columnsMobile":{"type":"number","default":1},"gutterSize":{"type":"number","default":16},"filtersEnabled":{"type":"boolean","default":true},"showAllFilter":{"type":"boolean","default":true},"showTitle":{"type":"boolean","default":true},"showCaption":{"type":"boolean","default":false},"lightboxEnabled":{"type":"boolean","default":true},"galleryId":{"type":"number","default":0},"stylePreset":{"type":"string","default":"custom"},"contentPlacement":{"type":"string","default":"overlay"},"cardBackground":{"type":"string","default":""}},"editorScript":"file:..\/..\/build\/smart-gallery\/index.js","editorStyle":"file:..\/..\/build\/smart-gallery\/index.css"}},"tagged_versions":["1.0.0","1.0.1"],"block_files":[],"assets_screenshots":{"screenshot-1.png":{"filename":"screenshot-1.png","revision":3703430,"resolution":"1","location":"assets","locale":"","width":3798,"height":1936}},"screenshots":{"1":"Matcha Studio Editor \u2014 3-Panel visual workspace with dark studio theme and realistic wall preview.","2":"Layout Blueprints \u2014 6 visual presets including Classic Grid, Pinterest Masonry, and PhotoBlocks Mosaic.","3":"Picture Framing &amp; Matting \u2014 Realistic Oak Wood, Black Metal, Gold Brass, and White Matting frames.","4":"In-Frame Pan &amp; Zoom Cropper \u2014 2D interactive focal target reticle and zoom controls.","5":"AI Color Swatches &amp; Filters \u2014 Frontend live keyword search, dynamic category pills, and color dot palette filtering.","6":"Client Proofing &amp; Shoppable Hotspots \u2014 Heart favorite button with export tray and glassmorphic Buy Now buttons.","7":"Client Proofing Sheet Export \u2014 1-Click print\/PDF proposal generation with itemized specifications and prices."}},"plugin_section":[],"plugin_tags":[210,237,6822,649,789],"plugin_category":[43,50],"plugin_contributors":[251835],"plugin_business_model":[],"class_list":["post-361131","plugin","type-plugin","status-publish","hentry","plugin_tags-gallery","plugin_tags-lightbox","plugin_tags-masonry","plugin_tags-photo-gallery","plugin_tags-portfolio","plugin_category-customization","plugin_category-media","plugin_contributors-wpmatcha","plugin_committers-wpmatcha"],"banners":{"banner":"https:\/\/ps.w.org\/matcha-gallery\/assets\/banner-772x250.png?rev=3703455","banner_2x":"https:\/\/ps.w.org\/matcha-gallery\/assets\/banner-1544x500.png?rev=3703455","banner_rtl":false,"banner_2x_rtl":false},"icons":{"svg":"https:\/\/ps.w.org\/matcha-gallery\/assets\/icon.svg?rev=3703453","icon":"https:\/\/ps.w.org\/matcha-gallery\/assets\/icon.svg?rev=3703453","icon_2x":false,"generated":false},"screenshots":[{"src":"https:\/\/ps.w.org\/matcha-gallery\/assets\/screenshot-1.png?rev=3703430","caption":"Matcha Studio Editor \u2014 3-Panel visual workspace with dark studio theme and realistic wall preview."}],"raw_content":"<!--section=description-->\n<p><strong>Matcha Gallery<\/strong> is the next-generation WordPress gallery plugin built for photographers, visual artists, designers, and eCommerce portfolios. It combines a state-of-the-art <strong>Matcha Studio visual editor<\/strong> with Google Gemini AI vision to automatically tag photos, generate SEO alt-text, calculate color palettes, and create stunning responsive photo walls.<\/p>\n\n<p>Matcha Gallery produces clean, modern HTML5\/CSS3 output with zero jQuery dependencies and fast page load times (&lt;15KB frontend runtime).<\/p>\n\n<p><a href=\"https:\/\/wpmatcha.com\/wordpress-plugins\/matcha-gallery-pro\/\">Live Demo &amp; Documentation<\/a> | <a href=\"https:\/\/wpmatcha.com\/contact\/\">Support &amp; Help<\/a>\n<h3>Key Highlights<\/h3>\n* <strong>Matcha Studio Visual Editor:<\/strong> A distraction-free, 3-panel visual workspace inspired by Figma. Customize layouts, picture framing, drop shadows, and matting with real-time WYSIWYG preview.\n* <strong>AI Vision &amp; Metadata Generator:<\/strong> Powered by Google Gemini AI. Automatically generates ADA-compliant alt text, human-readable titles, descriptive captions, and SEO keyword taxonomy.\n* <strong>6 Algorithmic Layout Blueprints:<\/strong>\n  * <em>Classic Grid<\/em> \u2014 Uniform aspect ratio with responsive column presets.\n  * <em>Pinterest Masonry<\/em> \u2014 Fluid cascading heights preserving native aspect ratios.\n  * <em>PhotoBlocks Mosaic<\/em> \u2014 Custom geometric tile spans (1x1, 2x1 wide, 1x2 tall, 2x2 hero).\n  * <em>Pinwheel Spiral<\/em> \u2014 Center hero spotlight with surrounding spiral thumbnails.\n  * <em>Bento Showcase<\/em> \u2014 Modern tech-style hero spread.\n  * <em>Justified Rows<\/em> \u2014 Flickr-style edge-to-edge justified rows.\n* <strong>1-Click \u2728 Smart Fill:<\/strong> AI analyzes image aspect ratios across your entire collection and automatically assigns the optimal geometric tile layout with one click.\n* <strong>In-Frame Pan &amp; Zoom Cropping:<\/strong> Interactive 2D target reticle and zoom slider (1.0x to 2.5x) to set pixel-perfect focal framing without cutting off heads or subjects.\n* <strong>Realistic Picture Framing &amp; Matting:<\/strong> 5 gallery-grade picture frames (<em>White Matting, Slim Black Metal, Natural Oak Wood, Brushed Gold Brass, Glass Float<\/em>) with customizable 0\u201332px matting margins.\n* <strong>Multi-Section Gallery Chapters:<\/strong> Organize a single gallery into tabbed chapters (e.g. <em>Ceremony, Reception, Portraits<\/em> or <em>Living Room, Bedroom, Kitchen<\/em>) with smooth animated switching.\n* <strong>AI Color Swatches &amp; Live Filter Toolbar:<\/strong> Instant color dot filter buttons extracted by AI, plus live keyword search and animated category filter pills.\n* <strong>Client Proofing &amp; Shoppable Portfolios:<\/strong> Visitors can favorite photos with heart icons (<code>\ud83e\udd0d \u2192 \u2764\ufe0f<\/code>) and export clean selection lists, or click glassmorphic <em>Buy \/ Shop Now<\/em> buttons.\n* <strong>1-Click \ud83d\udcf7 Export Wall &amp; Client Proofing Sheet:<\/strong> Download a 2x crystal-clear PNG snapshot of your arranged gallery wall, or print a branded client proposal sheet with dimensions and pricing.\n* <strong>Gutenberg Block &amp; Shortcode:<\/strong> Embed galleries seamlessly via the native <code>[matcha_gallery id=\"...\"]<\/code> shortcode or the dedicated Gutenberg block.<\/p>\n\n<h3>Third-Party Services<\/h3>\n\n<p>This plugin can optionally integrate with the following external third-party AI provider services to generate image alt-text, titles, captions, keyword tags, color swatches, and focal cropping coordinates. All AI features are entirely optional and require you to provide your own API key in the plugin settings.<\/p>\n\n<ul>\n<li><p><strong>Google Gemini AI API (Google LLC)<\/strong><\/p>\n\n<ul>\n<li><strong>What it is used for:<\/strong> Analyzes uploaded image attachments to generate descriptive alt-text, titles, captions, keyword tags, dominant color palettes, and focal point coordinates.<\/li>\n<li><strong>What data is sent and when:<\/strong> Image URLs or base64 image data are sent over secure HTTPS only when you explicitly click \"\u26a1 AI Enhance\", click \"Generate AI Metadata\" in the WordPress Media Library, or enable the \"Auto-generate on upload\" option in settings.<\/li>\n<li><strong>Privacy Policy:<\/strong> <a href=\"https:\/\/policies.google.com\/privacy\">https:\/\/policies.google.com\/privacy<\/a><\/li>\n<li><strong>Terms of Service:<\/strong> <a href=\"https:\/\/ai.google.dev\/terms\">https:\/\/ai.google.dev\/terms<\/a><\/li>\n<\/ul><\/li>\n<li><p><strong>OpenAI API (OpenAI, Inc.)<\/strong><\/p>\n\n<ul>\n<li><strong>What it is used for:<\/strong> Vision-based image metadata generation, keyword tagging, and alt text analysis for users configuring an OpenAI API key.<\/li>\n<li><strong>What data is sent and when:<\/strong> Image data and text prompts are sent over secure HTTPS only when triggered by user request in the editor or media library.<\/li>\n<li><strong>Privacy Policy:<\/strong> <a href=\"https:\/\/openai.com\/policies\/privacy-policy\/\">https:\/\/openai.com\/policies\/privacy-policy\/<\/a><\/li>\n<li><strong>Terms of Service:<\/strong> <a href=\"https:\/\/openai.com\/policies\/terms-of-use\/\">https:\/\/openai.com\/policies\/terms-of-use\/<\/a><\/li>\n<\/ul><\/li>\n<li><p><strong>OpenRouter API (OpenRouter)<\/strong><\/p>\n\n<ul>\n<li><strong>What it is used for:<\/strong> Multi-model AI routing allowing users to connect alternative vision models using an OpenRouter API key.<\/li>\n<li><strong>What data is sent and when:<\/strong> Image data and prompt requests are sent over secure HTTPS only when triggered by user request.<\/li>\n<li><strong>Privacy Policy:<\/strong> <a href=\"https:\/\/openrouter.ai\/privacy\">https:\/\/openrouter.ai\/privacy<\/a><\/li>\n<li><strong>Terms of Service:<\/strong> <a href=\"https:\/\/openrouter.ai\/terms\">https:\/\/openrouter.ai\/terms<\/a><\/li>\n<\/ul><\/li>\n<\/ul>\n\n<!--section=installation-->\n<ol>\n<li>Upload the <code>matcha-gallery<\/code> folder to your <code>\/wp-content\/plugins\/<\/code> directory, or install directly through <strong>Plugins \u2192 Add New<\/strong> in your WordPress dashboard.<\/li>\n<li>Activate the plugin through the <strong>Plugins<\/strong> menu in WordPress.<\/li>\n<li>Navigate to <strong>Matcha AI \u2192 AI Settings<\/strong> and enter your free Google Gemini API key (or OpenAI key).<\/li>\n<li>Go to <strong>Matcha AI \u2192 All Galleries<\/strong> and click <strong>Add New Gallery<\/strong> to open the Matcha Studio visual editor.<\/li>\n<li>Add photos, customize your layout and framing, and copy your shortcode <code>[matcha_gallery id=\"...\"]<\/code> into any page or post.<\/li>\n<\/ol>\n\n<!--section=faq-->\n<dl>\n<dt id=\"do%20i%20need%20a%20paid%20api%20key%20to%20use%20the%20ai%20features%3F\"><h3>Do I need a paid API key to use the AI features?<\/h3><\/dt>\n<dd><p>No! Google Gemini offers a generous free tier (up to 15 requests per minute) that is completely free of charge. You can generate a free API key at <a href=\"https:\/\/aistudio.google.com\/\">Google AI Studio<\/a>.<\/p><\/dd>\n<dt id=\"can%20i%20use%20matcha%20gallery%20without%20ai%3F\"><h3>Can I use Matcha Gallery without AI?<\/h3><\/dt>\n<dd><p>Yes, absolutely! All 6 layouts, picture framing, matting, multi-section chapters, lightboxes, and shortcodes work 100% out of the box without configuring an API key.<\/p><\/dd>\n<dt id=\"will%20ai%20overwrite%20my%20existing%20image%20alt%20text%3F\"><h3>Will AI overwrite my existing image alt text?<\/h3><\/dt>\n<dd><p>By default, no. Matcha Gallery only enriches images with missing alt text or captions. You can toggle \"Overwrite existing metadata\" in Settings if you wish to re-generate everything.<\/p><\/dd>\n<dt id=\"is%20matcha%20gallery%20fast%20and%20lightweight%3F\"><h3>Is Matcha Gallery fast and lightweight?<\/h3><\/dt>\n<dd><p>Yes! The frontend runtime is under 15KB of vanilla JavaScript with zero jQuery or external framework dependencies. It uses native CSS Grid and Flexbox for maximum rendering speed and 100\/100 Google PageSpeed scores.<\/p><\/dd>\n<dt id=\"how%20do%20i%20embed%20a%20gallery%20into%20a%20page%3F\"><h3>How do I embed a gallery into a page?<\/h3><\/dt>\n<dd><p>You can insert the native <strong>Matcha Gallery<\/strong> Gutenberg block, or paste the shortcode <code>[matcha_gallery id=\"123\"]<\/code> into any block, page builder (Elementor, Divi, Beaver Builder), or widget area.<\/p><\/dd>\n\n<\/dl>\n\n<!--section=changelog-->\n<h4>1.0.1<\/h4>\n\n<ul>\n<li>Fix: Admin sidebar menu icon sizing on the WordPress dashboard constrained to 20x20px with inline SVG data URI and global head style guard.<\/li>\n<li>Feature: Curated Style Presets (Exhibition Hairline Frame, Architectural Curtain, Cinematic Pullback, Minimalist Drawer).<\/li>\n<li>Enhancement: Layout rendering performance and zero-CLS image frame reservation.<\/li>\n<li>Enhancement: Codebase hygiene, translation template updates, and package optimizations.<\/li>\n<\/ul>\n\n<h4>1.0.0<\/h4>\n\n<ul>\n<li>Initial public release on WordPress.org.<\/li>\n<li>Matcha Studio 3-panel dark workspace editor.<\/li>\n<li>6 Algorithmic layout blueprints: Grid, Masonry, Mosaic, Pinwheel, Bento, and Justified.<\/li>\n<li>1-Click Smart Fill aspect-ratio matcher.<\/li>\n<li>Picture Framing &amp; Matting system (5 realistic frame styles).<\/li>\n<li>In-Frame Pan &amp; Zoom cropping with 2D focal reticle.<\/li>\n<li>Multi-Section Gallery Chapters (tabbed sub-stories in 1 gallery).<\/li>\n<li>1-Click 2x High-Res PNG Wall Snapshot &amp; PDF Client Proofing Sheet export.<\/li>\n<li>AI Vision metadata enrichment via Google Gemini (alt text, titles, captions, colors, focal points).<\/li>\n<li>Frontend live search, color swatch filter, proofing tray, and accessible lightbox.<\/li>\n<li>Native Gutenberg block and <code>[matcha_gallery]<\/code> shortcode.<\/li>\n<li>Local vendored JS dependencies (zero CDN reliance).<\/li>\n<\/ul>","raw_excerpt":"AI-powered image metadata generation, interactive mosaic photo walls, masonry layouts, framing, client proofing, and smart portfolio galleries.","jetpack_sharing_enabled":true,"_links":{"self":[{"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin\/361131","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin"}],"about":[{"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wp\/v2\/types\/plugin"}],"replies":[{"embeddable":true,"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wp\/v2\/comments?post=361131"}],"author":[{"embeddable":true,"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wporg\/v1\/users\/wpmatcha"}],"wp:attachment":[{"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wp\/v2\/media?parent=361131"}],"wp:term":[{"taxonomy":"plugin_section","embeddable":true,"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_section?post=361131"},{"taxonomy":"plugin_tags","embeddable":true,"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_tags?post=361131"},{"taxonomy":"plugin_category","embeddable":true,"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_category?post=361131"},{"taxonomy":"plugin_contributors","embeddable":true,"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_contributors?post=361131"},{"taxonomy":"plugin_business_model","embeddable":true,"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_business_model?post=361131"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}