Athenian Photo Gallery for WooCommerce
product details.
Customer Photo Gallery turns customer-submitted product photos into searchable, shoppable WooCommerce galleries. It supports guided uploads, product tagging, color filters, profile attribution, privacy preferences, moderation, product-specific galleries, lightbox viewing, and REST/AJAX tools—helping stores showcase real customer results as trusted social proof.
Customer Photo Gallery is a WooCommerce-integrated customer-generated-content plugin that turns customer-submitted project photos into structured, searchable, product-linked storefront content. Instead of treating customer imagery as disconnected media uploads or loose social embeds, the plugin stores each submission as a dedicated customer_gallery post, links it to WooCommerce products and color attributes, preserves contributor profile details, and routes entries through an approval workflow before publication.
The plugin is best positioned as a customer proof and merchandising layer for commerce sites where real-world application photos matter. Customers can submit images, choose how their business or personal profile should appear, tag related products, and send entries into a moderation workflow. Store teams can approve or decline submissions, send reusable notification emails, and publish approved entries into searchable galleries, product-specific showcases, floating gallery blocks, and contributor profile pages.
For WooCommerce stores with color-driven, project-driven, installation-heavy, or design-focused catalogs, Customer Photo Gallery creates more value than a static image grid. Each gallery entry can preserve contributor identity, connect to real products, inherit product category and color logic, and render as a shoppable card with related product links, thumbnails, price displays, and lightbox details.
Within the Athenian Platform, Customer Photo Gallery serves as the customer media and social-proof layer, helping merchants convert real customer examples into searchable, attributable, product-aware content that supports discovery, trust, and conversion.
Customer Media Intake
Collect Customer Project Photos With Profile Context and Review Controls
Customer Photo Gallery gives WooCommerce stores a structured upload workflow
where logged-in customers can submit project images, add titles and descriptions,
tag related products, choose attribution preferences, and route each entry
through admin moderation before publication.
| Submission Layer | Operational Value |
|---|---|
| Customer Upload Form | Allows logged-in users to submit one or more image files with per-image titles, descriptions, related products, and display preferences. |
| Profile Snapshot | Captures contributor details from WordPress and WooCommerce customer data so attribution remains stable after submission. |
| Business Logo Support | Lets contributors upload or update a business logo stored in user meta for use in gallery/profile presentation. |
| Moderation Workflow | Creates pending draft gallery entries that admins can approve, decline, annotate with reasons, and notify submitters about. |
- Registers a public
customer_gallerycustom post type for customer-submitted entries. - Uses review metadata such as
cpg_review_status,cpg_decline_reason, andcpg_review_email_ts. - Stores contributor data in
cpg_profile_snapshot,cpg_display_preset, andcpg_display_fields. - Supports upload and submission surfaces through shortcode names such as
'customer_gallery_submission_form'.
Product-Linked Social Proof
Turn Approved Customer Photos Into Searchable, Shoppable Gallery Content
Approved entries can appear in full gallery grids, product-specific galleries,
floating visual blocks, and filterable discovery pages that connect customer
proof back to WooCommerce products, categories, prices, thumbnails, and color groups.
Connect gallery entries to real WooCommerce catalog items
Use WooCommerce color attribute terms for swatches and discovery
Display related product links, thumbnails, prices, and lightbox details
| Gallery Surface | How It Helps |
|---|---|
| Main Gallery | Renders searchable gallery grids with product, category, author, and color filtering options. |
| Product Galleries | Displays customer submissions related to a specific WooCommerce product and can infer product context on product pages. |
| Floating Gallery | Creates scattered or floating customer gallery blocks for more visual landing-page and showcase layouts. |
| Lightbox Details | Includes structured card data for images, titles, descriptions, products, contributors, colors, thumbnails, and price HTML. |
- Supports gallery shortcode names such as
'customer_gallery_filters','customer_gallery','customer_gallery_for_product', and'floating_customer_gallery'. - Stores related WooCommerce products in
related_productspost meta with ACF-compatible and fallback formats. - Uses product category filtering through
product_catand color filtering through detected WooCommerce attribute taxonomies such aspa_color-group,pa_color_group, orpa_color. - Uses WooCommerce product data for gallery product names, thumbnails, permalinks, and price HTML.
Contributor Showcase
Promote Customers, Creators, Shops, Installers, and Partners Through Gallery Pages
Customer Photo Gallery includes contributor-specific gallery routes, helper
shortcodes, AJAX filters, REST rendering/search endpoints, admin settings,
ACF-compatible fields, and moderation controls that make customer content
easier to manage as a storefront asset.
| Platform Layer | Operational Purpose |
|---|---|
| Contributor Pages | Creates virtual public gallery pages such as /gallery/{username}/ to spotlight individual customers, shops, creators, installers, or partners. |
| AJAX Filtering | Supports gallery filtering, product typeahead, author typeahead, admin product search, and business-logo uploads through AJAX actions. |
| REST Rendering | Provides gallery rendering, product search, author search, filter handling, and debug utilities under the /cpg/v1 REST namespace. |
| Admin Settings | Centralizes category policy controls and moderation email templates for approval, decline, and update-needed workflows. |
Structured social proof for WooCommerce:
Customer Photo Gallery is strongest when customer media needs to remain
connected to contributors, products, categories, color groups, approval
status, and storefront discovery instead of living as disconnected uploads.
- Supports contributor helper shortcode names such as
'cpg_my_gallery_url'and'cpg_my_gallery_link'. - Stores settings in options such as
cpg_filters_settingsandcpg_moderation_settings. - Provides REST routes such as
/wp-json/cpg/v1/gallery,/wp-json/cpg/v1/filter-gallery,/wp-json/cpg/v1/product-search, and/wp-json/cpg/v1/author-search. - Builds toward video support, capability-locked debug routes, bulk moderation, customer edit/resubmit flows, Bricks widgets, consent fields, analytics, image optimization, Site Themes styling, and Data Intelligence reporting.