{"id":151,"date":"2026-06-27T19:43:12","date_gmt":"2026-06-27T19:43:12","guid":{"rendered":"https:\/\/awesomediscoveryzone.com\/auragallery\/?post_type=docs&#038;p=151"},"modified":"2026-07-02T03:16:33","modified_gmt":"2026-07-02T03:16:33","slug":"overview","status":"publish","type":"docs","link":"https:\/\/awesomediscoveryzone.com\/squareorb\/docs\/square-orb\/getting-started\/overview\/","title":{"rendered":"Control Panel Overview"},"content":{"rendered":"\n<h2 class=\"wp-block-heading\"><strong>Interface Structure<\/strong><\/h2>\n\n\n\n<p class=\"wp-block-paragraph\">The Square Orb Gallery control panel is divided into four main tabs to manage your ecosystem:<\/p>\n\n\n\n<ul class=\"wp-block-list\">\n<li><strong>Global Defaults:<\/strong> Controls centralized, site-wide gallery behavior, layout, Lightbox settings, and asset protection.<\/li>\n\n\n\n<li><strong>Import Media:<\/strong> The hub for sideloading images from your connected cloud accounts, such as Google Photos or Lightroom CC.<\/li>\n\n\n\n<li><strong>Authentication:<\/strong> Manage API credentials and connect\/disconnect Google Photos, Adobe Lightroom CC, and the Google Vision API.<\/li>\n\n\n\n<li><strong>Analytics:<\/strong> View engagement telemetry, including top-performing assets by views and dwell time.<\/li>\n<\/ul>\n\n\n\n<hr class=\"wp-block-separator has-alpha-channel-opacity\"\/>\n\n\n\n<h2 class=\"wp-block-heading\"><strong>Global Defaults Tab<\/strong><\/h2>\n\n\n\n<h3 class=\"wp-block-heading\"><strong>1. Performance Data Vault (Transient Cache)<\/strong><\/h3>\n\n\n\n<p class=\"wp-block-paragraph\"><strong>Purpose:<\/strong>&nbsp;Manages Square Orb Gallery&#8217;s caching system that stores API calls, EXIF data extraction, and DOM generation to enable instant page loads without database queries.<\/p>\n\n\n\n<p class=\"wp-block-paragraph\"><strong>Features:<\/strong><\/p>\n\n\n\n<ul class=\"wp-block-list\">\n<li>&#8220;Purge High-Performance Cache&#8221; button &#8211; allows manual clearing of cached data when image metadata is updated, or a fresh pull is needed<\/li>\n<\/ul>\n\n\n\n<hr class=\"wp-block-separator has-alpha-channel-opacity\"\/>\n\n\n\n<h3 class=\"wp-block-heading\"><strong>2. Master Override Switch<\/strong><\/h3>\n\n\n\n<p class=\"wp-block-paragraph\"><strong>Purpose:<\/strong>&nbsp;Global control enforcement across all galleries site-wide.<\/p>\n\n\n\n<p class=\"wp-block-paragraph\"><strong>Toggle Option:<\/strong> When enabled, forces every gallery container site-wide to inherit centralized styles, bypassing individual Gutenberg block-level overrides<\/p>\n\n\n\n<hr class=\"wp-block-separator has-alpha-channel-opacity\"\/>\n\n\n\n<h3 class=\"wp-block-heading\"><strong>3. Gallery Presentation<\/strong><\/h3>\n\n\n\n<p class=\"wp-block-paragraph\"><strong>Purpose:<\/strong>&nbsp;Controls the visual layout and appearance of gallery grids.<\/p>\n\n\n\n<p class=\"wp-block-paragraph\"><strong>Settings:<\/strong><\/p>\n\n\n\n<ul class=\"wp-block-list\">\n<li><strong>Gallery Style<\/strong>&nbsp;(dropdown) &#8211; 5 layout options:\n<ul class=\"wp-block-list\">\n<li>Perfect Square Grid (default)<\/li>\n\n\n\n<li>Dynamic Masonry<\/li>\n\n\n\n<li>Cinematic Justified Row<\/li>\n\n\n\n<li>Responsive Swipe Carousel<\/li>\n\n\n\n<li>Interactive Traveler&#8217;s Map<\/li>\n<\/ul>\n<\/li>\n\n\n\n<li><strong>Desktop Columns<\/strong>&nbsp;(dropdown) &#8211; Responsive auto-fill or fixed 3-6 columns<\/li>\n\n\n\n<li><strong>Mobile Columns<\/strong>&nbsp;(number input) &#8211; 1-4 columns for mobile devices (default: 2)<\/li>\n\n\n\n<li><strong>Grid Gap<\/strong>&nbsp;(px) &#8211; Spacing between images (default: 15px)<\/li>\n\n\n\n<li><strong>Corner Radius<\/strong>&nbsp;(px) &#8211; Rounded corners for grid items (default: 0px)<\/li>\n\n\n\n<li><strong>Enable Scroll Animations<\/strong>&nbsp;(toggle) &#8211; Fade-in effects as images enter viewport (default: yes)<\/li>\n\n\n\n<li><strong>Enable Category Filters<\/strong>&nbsp;(toggle) &#8211; Shows taxonomy\/category filter UI (default: no)<\/li>\n\n\n\n<li><strong>Enable Smart Search (Experimental AI)<\/strong>&nbsp;(toggle) &#8211; Displays live-search bar for instant grid filtering (default: yes)\n<ul class=\"wp-block-list\">\n<li>Note: &#8220;Displays an animated live-search bar to instantly filter grid results.&#8221;<\/li>\n<\/ul>\n<\/li>\n<\/ul>\n\n\n\n<hr class=\"wp-block-separator has-alpha-channel-opacity\"\/>\n\n\n\n<h3 class=\"wp-block-heading\"><strong>4. Display &amp; Loading Options<\/strong><\/h3>\n\n\n\n<p class=\"wp-block-paragraph\"><strong>Purpose:<\/strong>&nbsp;Configures the &#8220;Load More&#8221; pagination button and its styling.<\/p>\n\n\n\n<p class=\"wp-block-paragraph\"><strong>Live Preview Feature:<\/strong><\/p>\n\n\n\n<ul class=\"wp-block-list\">\n<li>Interactive button preview showing real-time style updates<\/li>\n<\/ul>\n\n\n\n<p class=\"wp-block-paragraph\"><strong>Settings:<\/strong><\/p>\n\n\n\n<ul class=\"wp-block-list\">\n<li><strong>Initial Items to Show<\/strong>&nbsp;(number input) &#8211; How many images load on page start (default: 20, min: 4)\n<ul class=\"wp-block-list\">\n<li>Note: &#8220;Determines how many images load on page start. A lower number improves initial page load speed.&#8221;<\/li>\n<\/ul>\n<\/li>\n\n\n\n<li><strong>Button Text<\/strong>&nbsp;(text input) &#8211; Custom button label (default: &#8220;Load More&#8221;)<\/li>\n\n\n\n<li><strong>Button Styling<\/strong>&nbsp;(dropdown) &#8211; 4 shape options:\n<ul class=\"wp-block-list\">\n<li>Pill (Fully Rounded)<\/li>\n\n\n\n<li>Rounded Corners<\/li>\n\n\n\n<li>Square<\/li>\n\n\n\n<li>Inherit WordPress Theme Default<\/li>\n<\/ul>\n<\/li>\n\n\n\n<li><strong>Button Background Color<\/strong>&nbsp;(color picker) &#8211; HEX color input + visual swatch (default: #333333)<\/li>\n\n\n\n<li><strong>Button Text Color<\/strong>&nbsp;(color picker) &#8211; HEX color input + visual swatch (default: #ffffff)<\/li>\n<\/ul>\n\n\n\n<hr class=\"wp-block-separator has-alpha-channel-opacity\"\/>\n\n\n\n<h3 class=\"wp-block-heading\"><strong>5. Digital Asset Protection<\/strong><\/h3>\n\n\n\n<p class=\"wp-block-paragraph\"><strong>Purpose:<\/strong>&nbsp;Security and watermarking controls for protecting gallery images.<\/p>\n\n\n\n<p class=\"wp-block-paragraph\"><strong>Settings:<\/strong><\/p>\n\n\n\n<ul class=\"wp-block-list\">\n<li><strong>Right-Click Protection<\/strong>&nbsp;(toggle) &#8211; Disables right-click context menu on images (default: yes)<\/li>\n\n\n\n<li><strong>Watermark Overlay (PNG)<\/strong>&nbsp;&#8211; Non-destructive watermarking system:\n<ul class=\"wp-block-list\">\n<li>Image preview display (max 200px \u00d7 100px)<\/li>\n\n\n\n<li>&#8220;Select PNG Watermark&#8221; button &#8211; media uploader integration<\/li>\n\n\n\n<li>&#8220;Remove Watermark File&#8221; button &#8211; conditionally displayed<\/li>\n\n\n\n<li>Note: &#8220;Select a transparent PNG. We non-destructively stamp generated sizes, keeping your original master files pristine.&#8221;<\/li>\n<\/ul>\n<\/li>\n\n\n\n<li><strong>Auto-Watermark Native Uploads<\/strong>&nbsp;(toggle) &#8211; Automatically applies watermark to newly uploaded media (default: no)<\/li>\n\n\n\n<li><strong>Watermark Position<\/strong>&nbsp;(dropdown) &#8211; 2 options:\n<ul class=\"wp-block-list\">\n<li>Bottom Right (default)<\/li>\n\n\n\n<li>Center<\/li>\n<\/ul>\n<\/li>\n<\/ul>\n\n\n\n<hr class=\"wp-block-separator has-alpha-channel-opacity\"\/>\n\n\n\n<h3 class=\"wp-block-heading\"><strong>6. Lightbox Presentation<\/strong><\/h3>\n\n\n\n<p class=\"wp-block-paragraph\"><strong>Purpose:<\/strong>&nbsp;Comprehensive lightbox\/modal viewer customization.<\/p>\n\n\n\n<p class=\"wp-block-paragraph\"><strong>Live Lightbox Mockup:<\/strong><\/p>\n\n\n\n<ul class=\"wp-block-list\">\n<li>Interactive preview showing:\n<ul class=\"wp-block-list\">\n<li>Dark overlay background<\/li>\n\n\n\n<li>Media display area with border\/radius styling<\/li>\n\n\n\n<li>Navigation controls (prev\/next arrows)<\/li>\n\n\n\n<li>Close button<\/li>\n\n\n\n<li>Play button (for videos)<\/li>\n\n\n\n<li>Filmstrip thumbnail carousel at the bottom<\/li>\n\n\n\n<li>Title and filmstrip preview grid<\/li>\n<\/ul>\n<\/li>\n<\/ul>\n\n\n\n<h4 class=\"wp-block-heading\"><strong>Video<\/strong><\/h4>\n\n\n\n<ul class=\"wp-block-list\">\n<li><strong>Autoplay Lightbox Videos<\/strong>&nbsp;(toggle) &#8211; Auto-plays video content when opened (default: yes)<\/li>\n<\/ul>\n\n\n\n<h4 class=\"wp-block-heading\"><strong>Overlay &amp; Media Style<\/strong><\/h4>\n\n\n\n<ul class=\"wp-block-list\">\n<li><strong>Overlay Matte Color<\/strong>&nbsp;(color picker) &#8211; Dark overlay background (default: rgba(0, 0, 0, 0.95))\n<ul class=\"wp-block-list\">\n<li>Supports HEX or RGBA values<\/li>\n\n\n\n<li>Color swatch picker<\/li>\n\n\n\n<li>Note: &#8220;Supports HEX or RGBA (for transparency). Use the swatch to select a solid color.&#8221;<\/li>\n<\/ul>\n<\/li>\n\n\n\n<li><strong>Transition Style<\/strong>\u00a0(dropdown) &#8211; animation options:\n<ul class=\"wp-block-list\">\n<li>Instant Swap (None) (default)<\/li>\n\n\n\n<li>Smooth Opacity Fade<\/li>\n\n\n\n<li>Gaussian Blur Dissolve<\/li>\n\n\n\n<li>Hardware Accelerated Clip Wipe<\/li>\n\n\n\n<li>Stage Curtain<\/li>\n\n\n\n<li>Vertical Swipe<\/li>\n\n\n\n<li>Directional Slide<\/li>\n\n\n\n<li>Pop &amp; Zoom<\/li>\n\n\n\n<li>Elastic Bounce<\/li>\n\n\n\n<li>3D Axis Flip<\/li>\n\n\n\n<li>Quarter Spin<\/li>\n<\/ul>\n<\/li>\n\n\n\n<li><strong>Media Border Color<\/strong>&nbsp;(color picker) &#8211; Frame border around images (default: #ffffff)\n<ul class=\"wp-block-list\">\n<li>Color input + swatch<\/li>\n<\/ul>\n<\/li>\n\n\n\n<li><strong>Media Border Width<\/strong>&nbsp;(px) &#8211; Border thickness (default: 0px, max: 20px)<\/li>\n\n\n\n<li><strong>Media Corner Radius<\/strong>&nbsp;(px) &#8211; Rounded corners on media (default: 0px, max: 50px)<\/li>\n<\/ul>\n\n\n\n<h4 class=\"wp-block-heading\"><strong>Navigation &amp; Controls<\/strong><\/h4>\n\n\n\n<ul class=\"wp-block-list\">\n<li><strong>Enable Slideshow Mode<\/strong>&nbsp;(toggle) &#8211; Auto-advance through images (default: yes)<\/li>\n\n\n\n<li><strong>Slideshow Speed<\/strong>&nbsp;(seconds) &#8211; Interval between slides (default: 5 seconds, 1-20 range)<\/li>\n\n\n\n<li><strong>Control Buttons Background<\/strong>&nbsp;(color picker) &#8211; Button overlay color (default: rgba(0,0,0,0.5))\n<ul class=\"wp-block-list\">\n<li>Controls: prev\/next arrows, close, play buttons<\/li>\n<\/ul>\n<\/li>\n\n\n\n<li><strong>Control Buttons Color<\/strong>&nbsp;(color picker) &#8211; Icon\/text color on buttons (default: #ffffff)<\/li>\n\n\n\n<li><strong>Control Buttons Radius<\/strong>&nbsp;(px) &#8211; Button border radius (default: 4px, max: 50px)<\/li>\n<\/ul>\n\n\n\n<h4 class=\"wp-block-heading\"><strong>Sub-section: Information Bar Display<\/strong><\/h4>\n\n\n\n<ul class=\"wp-block-list\">\n<li><strong>Enable Gallery Filmstrip<\/strong>&nbsp;(toggle) &#8211; Shows thumbnail carousel at bottom (default: yes)<\/li>\n\n\n\n<li><strong>Show Titles<\/strong>&nbsp;(toggle) &#8211; Display image titles (default: yes)<\/li>\n\n\n\n<li><strong>Show Captions<\/strong>&nbsp;(toggle) &#8211; Display image captions\/descriptions (default: yes)<\/li>\n\n\n\n<li><strong>Show Advanced EXIF Data<\/strong>&nbsp;(toggle) &#8211; Display camera metadata (default: yes)<\/li>\n\n\n\n<li><strong>Enable Social Sharing<\/strong>&nbsp;(toggle) &#8211; Share buttons with universal app link formatting (default: yes)\n<ul class=\"wp-block-list\">\n<li>Note: &#8220;Automatically formats URLs for mobile Universal App Links.&#8221;<\/li>\n<\/ul>\n<\/li>\n<\/ul>\n\n\n\n<hr class=\"wp-block-separator has-alpha-channel-opacity\"\/>\n\n\n\n<h2 class=\"wp-block-heading\"><strong>Import Media Tab<\/strong><\/h2>\n\n\n\n<p class=\"wp-block-paragraph\"><strong>Purpose:<\/strong>&nbsp;Cloud media import interface for Google Photos and Adobe Lightroom.<\/p>\n\n\n\n<p class=\"wp-block-paragraph\"><strong>Features:<\/strong><\/p>\n\n\n\n<ul class=\"wp-block-list\">\n<li>Displays cloud service import tools based on active authenticated connections<\/li>\n\n\n\n<li>&#8220;Select Cloud Photos via Google Canvas&#8221; button (requires authentication)<\/li>\n\n\n\n<li>&#8220;Sideload to WordPress Core&#8221; button (appears after selection, shows count)<\/li>\n\n\n\n<li>Status indicator showing import state<\/li>\n\n\n\n<li>Photo grid display for selected assets<\/li>\n\n\n\n<li>Error log display<\/li>\n\n\n\n<li>Authentication requirement notice with link to the Authentication tab<\/li>\n<\/ul>\n\n\n\n<hr class=\"wp-block-separator has-alpha-channel-opacity\"\/>\n\n\n\n<h2 class=\"wp-block-heading\"><strong>Authentication Tab<\/strong><\/h2>\n\n\n\n<p class=\"wp-block-paragraph\"><strong>Purpose:<\/strong>&nbsp;Manage API credentials and OAuth connections for cloud services.<\/p>\n\n\n\n<h3 class=\"wp-block-heading\"><strong>Google Photos Engine<\/strong><\/h3>\n\n\n\n<p class=\"wp-block-paragraph\"><strong>Features:<\/strong><\/p>\n\n\n\n<ul class=\"wp-block-list\">\n<li>Connection status display (active\/not connected)<\/li>\n\n\n\n<li>Authorized redirect URI display (read-only code block)<\/li>\n\n\n\n<li>OAuth connection button<\/li>\n\n\n\n<li>Settings form with:\n<ul class=\"wp-block-list\">\n<li>Google OAuth Client ID (text input)<\/li>\n\n\n\n<li>Google OAuth Client Secret (password input)<\/li>\n\n\n\n<li>Google Vision API Key (password input, experimental AI auto-tagging)<\/li>\n\n\n\n<li>Note on experimental AI Vision API<\/li>\n\n\n\n<li>&#8220;Save Google Credentials&#8221; button<\/li>\n<\/ul>\n<\/li>\n\n\n\n<li>Disconnect button (appears when connected)<\/li>\n<\/ul>\n\n\n\n<h3 class=\"wp-block-heading\"><strong>Adobe Lightroom CC Engine<\/strong><\/h3>\n\n\n\n<p class=\"wp-block-paragraph\"><strong>Features:<\/strong><\/p>\n\n\n\n<ul class=\"wp-block-list\">\n<li>Parallel layout to Google section<\/li>\n\n\n\n<li>Connection status display<\/li>\n\n\n\n<li>Authorized redirect URI<\/li>\n\n\n\n<li>OAuth connection button<\/li>\n\n\n\n<li>Settings form with:\n<ul class=\"wp-block-list\">\n<li>Adobe Client ID \/ API Key (text input)<\/li>\n\n\n\n<li>Adobe Client Secret (password input)<\/li>\n\n\n\n<li>&#8220;Save Adobe Credentials&#8221; button<\/li>\n<\/ul>\n<\/li>\n\n\n\n<li>Disconnect button (appears when connected)<\/li>\n<\/ul>\n\n\n\n<hr class=\"wp-block-separator has-alpha-channel-opacity\"\/>\n\n\n\n<h2 class=\"wp-block-heading\"><strong>Analytics Tab<\/strong><\/h2>\n\n\n\n<p class=\"wp-block-paragraph\"><strong>Purpose:<\/strong>&nbsp;Engagement telemetry and visitor interaction tracking.<\/p>\n\n\n\n<p class=\"wp-block-paragraph\"><strong>Features:<\/strong><\/p>\n\n\n\n<ul class=\"wp-block-list\">\n<li><strong>Engagement Telemetry<\/strong>&nbsp;section<\/li>\n\n\n\n<li>Data description: &#8220;Discover which assets are capturing the most attention. Data is securely tracked via silent browser beacons.&#8221;<\/li>\n<\/ul>\n\n\n\n<p class=\"wp-block-paragraph\"><strong>When No Data Collected:<\/strong><\/p>\n\n\n\n<ul class=\"wp-block-list\">\n<li>Notice: &#8220;No telemetry data collected yet. Once visitors start interacting with your Lightbox, data will appear here.&#8221;<\/li>\n<\/ul>\n\n\n\n<p class=\"wp-block-paragraph\"><strong>When Data Available:<\/strong><\/p>\n\n\n\n<ul class=\"wp-block-list\">\n<li>Chart.js visualization &#8211; Shows engagement metrics<\/li>\n\n\n\n<li>Data table with columns:\n<ul class=\"wp-block-list\">\n<li>Thumbnail preview<\/li>\n\n\n\n<li>Asset Title<\/li>\n\n\n\n<li>Total Views<\/li>\n\n\n\n<li>Dwell Time (seconds)<\/li>\n<\/ul>\n<\/li>\n\n\n\n<li>10 top-performing items displayed<\/li>\n<\/ul>\n\n\n\n<hr class=\"wp-block-separator has-alpha-channel-opacity\"\/>\n\n\n\n<h2 class=\"wp-block-heading\"><strong>Key UX Features<\/strong><\/h2>\n\n\n\n<ol class=\"wp-block-list\">\n<li><strong>Live Previews<\/strong>&nbsp;&#8211; Button styling and lightbox mockup update in real-time<\/li>\n\n\n\n<li><strong>Color Pickers<\/strong>&nbsp;&#8211; Both text input and visual swatch selection<\/li>\n\n\n\n<li><strong>Conditional Displays<\/strong>&nbsp;&#8211; Elements show\/hide based on connection status<\/li>\n\n\n\n<li><strong>Responsive Layout<\/strong>&nbsp;&#8211; Auth section uses flexbox for side-by-side panels<\/li>\n\n\n\n<li><strong>Status Indicators<\/strong>&nbsp;&#8211; Connection status, asset engine status<\/li>\n\n\n\n<li><strong>Helpful Notes<\/strong>&nbsp;&#8211; Small text hints throughout for each setting<\/li>\n\n\n\n<li><strong>Organized Sections<\/strong>&nbsp;&#8211; Related settings grouped under colored boxes with clear hierarchy<\/li>\n<\/ol>\n","protected":false},"featured_media":0,"parent":135,"menu_order":1,"comment_status":"open","ping_status":"closed","template":"","meta":{"_is_vendor_doc":"0","footnotes":""},"doc_tag":[],"class_list":["post-151","docs","type-docs","status-publish","hentry"],"comment_count":0,"_links":{"self":[{"href":"https:\/\/awesomediscoveryzone.com\/squareorb\/wp-json\/wp\/v2\/docs\/151","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/awesomediscoveryzone.com\/squareorb\/wp-json\/wp\/v2\/docs"}],"about":[{"href":"https:\/\/awesomediscoveryzone.com\/squareorb\/wp-json\/wp\/v2\/types\/docs"}],"replies":[{"embeddable":true,"href":"https:\/\/awesomediscoveryzone.com\/squareorb\/wp-json\/wp\/v2\/comments?post=151"}],"version-history":[{"count":8,"href":"https:\/\/awesomediscoveryzone.com\/squareorb\/wp-json\/wp\/v2\/docs\/151\/revisions"}],"predecessor-version":[{"id":345,"href":"https:\/\/awesomediscoveryzone.com\/squareorb\/wp-json\/wp\/v2\/docs\/151\/revisions\/345"}],"up":[{"embeddable":true,"href":"https:\/\/awesomediscoveryzone.com\/squareorb\/wp-json\/wp\/v2\/docs\/135"}],"next":[{"title":"FAQs","link":"https:\/\/awesomediscoveryzone.com\/squareorb\/docs\/square-orb\/getting-started\/faqs\/","href":"https:\/\/awesomediscoveryzone.com\/squareorb\/wp-json\/wp\/v2\/docs\/145"}],"prev":[{"title":"Download and Install Square Orb Gallery","link":"https:\/\/awesomediscoveryzone.com\/squareorb\/docs\/square-orb\/getting-started\/download-and-install-aura-gallery\/","href":"https:\/\/awesomediscoveryzone.com\/squareorb\/wp-json\/wp\/v2\/docs\/136"}],"wp:attachment":[{"href":"https:\/\/awesomediscoveryzone.com\/squareorb\/wp-json\/wp\/v2\/media?parent=151"}],"wp:term":[{"taxonomy":"doc_tag","embeddable":true,"href":"https:\/\/awesomediscoveryzone.com\/squareorb\/wp-json\/wp\/v2\/doc_tag?post=151"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}