OGALLERY
A practical guide to building, styling and publishing responsive WordPress galleries, sliders, WooCommerce product galleries, lightboxes, albums and client-facing gallery pages with OGALLERY.
Overview
OGALLERY is organized around a visual Gallery Studio. A gallery can use manually selected images or dynamic content, and its layout, responsive behavior, interactions and lightbox can be configured from the same editor.
Standard galleries
Grid, Masonry, Masonry Straight Bottom, Justified, Bento and Polaroid layouts.
Sliders
Classic Slider, multi-image Carousel and Podium Slider presentation modes.
Product galleries
Product Bento, Product Slider and Product Podium layouts designed around WooCommerce or product ACF media.
Advanced presentation
Classic, Cinematic and Dream Lightbox modes, responsive styling, Hover Studio, Standalone pages, Gallery Albums and Client Proofing.
Requirements
The plugin declares the following minimum environment requirements.
| Component | Requirement |
|---|---|
| WordPress | 6.4 or newer |
| PHP | 8.0 or newer |
| Advanced Custom Fields | Optional. Required only when an ACF field is used as a gallery or product image source. |
| WooCommerce | Optional. Required when WooCommerce product images are used as the product gallery source. |
| PHP ZipArchive | Optional. Required only for ZIP import and ZIP download features in Media Folders. |
| HTTPS | Required for password-protected galleries. |
Installation & activation
Install the plugin
In WordPress, open Plugins → Add New → Upload Plugin, choose the OGALLERY ZIP package and install it.
Activate OGALLERY
Activate the plugin from the WordPress Plugins screen.
Activate your license
Open the OGALLERY License screen and enter a valid license key to unlock the complete Studio, gallery engine, dynamic sources and private updates.
Open Galleries
Use the Galleries menu to create your first gallery with Quick Setup or open the complete Advanced Editor.
Creating a gallery
OGALLERY provides two creation paths: a guided five-step Quick Setup and the full Gallery Studio.
Quick Setup
- Choose the gallery family and starting layout.
- Choose the real content source.
- Apply a built-in style or keep the default appearance.
- Set essential options such as columns, image gap, navigation, loop and lightbox.
- Name the gallery and create it, or continue directly to the full Studio.
Gallery Studio
The Advanced Editor exposes the complete configuration and includes live Gallery, Lightbox, Cinematic Lightbox, Dream Lightbox, Standalone Page and Secure Login previews where applicable.
Live Preview
Gallery Studio shows unsaved design changes directly in its preview so the gallery can be refined before publishing.
- Switch between Desktop, Tablet and Mobile preview modes.
- Preview the Gallery, Classic Lightbox, Cinematic Lightbox, Dream Lightbox, Standalone Page and Secure Login screen when those features are enabled.
- Most visual and layout adjustments update the active preview in place; changes that alter the component structure can trigger a full preview rebuild.
- Use Hold hover to inspect hover states while editing.
- Use Refresh preview whenever a manual refresh is needed.
- Copy compatible responsive settings from the current device view to the other device views.
Gallery modules & layouts
Choose the module first, then select a layout within that module.
| Module | Layouts | Purpose |
|---|---|---|
| Standard Gallery | Grid, Masonry, Masonry Straight Bottom, Justified, Bento, Polaroid | Portfolio, editorial, image collection and mixed-layout galleries. |
| Sliders | Slider, Carousel, Podium Slider | Single-image presentation, multiple visible images or a staged center-focused composition. |
| WooCommerce Product Gallery | Product Bento, Product Slider, Product Podium | Product-focused image presentation using WooCommerce or product ACF content. |
Standard layout controls
- Grid: responsive columns, gap, image ratio and alignment.
- Masonry: natural image proportions arranged in columns.
- Masonry Straight Bottom: masonry-style composition with an even lower edge.
- Justified: proportion-based rows with configurable last-row alignment.
- Bento: ready-made patterns or manual tile sizing. Manual tile sizes and image focus can be stored independently for Desktop, Tablet and Mobile.
- Polaroid: overlapping photo cards with rotation, title styling and responsive controls.
Slider controls
- Responsive visible-item counts for Carousel.
- Arrows, dots, looping, dragging, autoplay and transition timing.
- Thumbnail navigation for the classic Slider, including responsive thumbnail position, sizing and interaction.
- Podium stage controls for main slide width, side slide scale, spacing, opacity, blur, vertical offset and perspective angle.
Data sources
The source controls where OGALLERY reads images from. Dynamic sources stay connected to their original content.
Manual images
Select images from the WordPress Media Library, reorder them and edit title, description, alternative text and links per image.
Media Folders
Select one or multiple OGALLERY folders. Duplicate images are removed when the same attachment belongs to more than one selected folder.
ACF
Read images from an ACF field on the current post, a specific post or an ACF Options Page. Repeater-style data can map image, title, caption and link subfields.
WooCommerce
For product galleries, use the current or a specific WooCommerce product and read its featured image plus product gallery images.
Product ACF source
Product galleries can alternatively use an ACF image source from the current product, a specific product or an ACF Options Page. The featured product image can optionally be inserted before ACF images.
Media Folders
Media Folders organize WordPress images using virtual folders. Image file URLs and physical upload locations are not changed.
Folders & subfolders
Create, rename, delete and reorder folders. An image can belong to multiple folders without being duplicated.
Drag & organize
Reorder images inside a folder, add them to another folder or remove them from the current folder.
Image metadata
Edit title, ALT text, caption, description, folder assignments and OGALLERY tags.
Bulk editing
Edit selected images together and add, replace or remove tags in bulk.
Search & filters
Search images and folders, filter by tags, ALT status and image orientation.
Gallery usage
Folder management can show whether a folder is used directly by a gallery or indirectly through another source relationship.
ZIP download
Download selected images or a complete folder as ZIP, with optional subfolder inclusion.
ZIP import
Import validated image archives while recreating folder structure. Existing-file handling can skip, add as new or replace an existing attachment.
ZipArchive extension and remain subject to the upload and resource limits configured by the hosting server.Responsive design
Desktop, Tablet and Mobile are first-class editing views. OGALLERY stores responsive values for layout and many presentation controls instead of relying only on one automatic breakpoint behavior.
- Columns, gaps and visible slides can vary per device.
- Bento tile sizes and focus can be configured independently per device.
- Typography, spacing, radius, borders and selected image presentation settings can be device-specific.
- Progressive loading, pagination and filtering can be configured per device.
- Standalone Page appearance, watermark presentation and many lightbox controls follow the current device view.
Loading & pagination
Large Standard Galleries can use either Progressive Loading or Pagination. The two modes are intentionally mutually exclusive.
Progressive Loading
Progressive Loading intelligently loads images in stages instead of all at once. OGALLERY prioritizes what’s visible and preloads upcoming images just before they enter the viewport, keeping galleries fast, smooth and responsive — even with large image collections.
Pagination
Choose images per page, numeric and/or Previous/Next navigation, scroll behavior, alignment, spacing, typography, border and colors per device.
Image styling & content
Gallery images can be styled without editing the original Media Library files.
- Image fit and focal point.
- Image ratio, including custom ratios where supported.
- Corner radius, borders and box shadow.
- Overlay color and opacity.
- Title and description visibility, position and appearance.
- Typography including font, size, weight, line height, letter spacing, transform and alignment.
- Optional Google Fonts loaded only when selected in gallery settings.
- Hover icon styling and independent navigation control styling where supported.
Hover effects & Hover Studio
Use a built-in image effect or create a reusable custom interaction in Hover Studio.
Built-in hover effects
Hover Studio
Hover Studio is a layer-based visual editor for reusable custom hover effects. It includes independent Hover IN and Hover OUT timelines, keyframes and editable animation properties.
- Gallery image, overlay, title, description, custom text and icon layers.
- Shape layers, filter masks, animated color layers, light sweep and frame layers.
- Transform, opacity, blur, brightness, contrast, saturation, grayscale, hue and blend controls depending on layer type.
- Independent timing, delay and easing for Hover IN and Hover OUT.
- Pointer interaction and perspective controls.
- Undo/Redo, duplication, reusable custom effects and JSON import/export.
Image filters
Standard Galleries can expose visitor-facing filter buttons using OGALLERY tags assigned to Media Library images.
- Enable or disable filtering independently for Desktop, Tablet and Mobile.
- Show or hide the All button and customize its label.
- Choose which available tags appear as filter buttons.
- Control tag order, filter position, alignment, typography and button states.
- Choose filter transition and stagger behavior.
Lightboxes
The viewer can be turned Off or set to Classic, Cinematic or Dream Lightbox. Each mode has its own presentation controls.
Classic Lightbox
- Title and description display.
- Classic button navigation, drag/swipe navigation or a combination of both.
- Optional infinite loop.
- Image transitions and configurable lightbox opening animation.
- Image border and shadow.
- Configurable Previous, Next and Close controls.
- Optional bottom thumbnail strip with responsive styling.
- Flexible text placement above, below or on the image.
Cinematic Lightbox
- Living full-screen backdrop based on the current photograph.
- Base background, overall background opacity, backdrop opacity, blur, brightness and saturation.
- Slow background motion, atmosphere pulse and reduced-motion fallback.
- Independent image exit and entrance animations with configurable duration and easing.
- Main image size, radius, border and shadow controls.
- Optional Filmstrip at the Bottom, Left or Right with edge fade, thumbnail styling and active state.
- Independent Previous, Next and Close control styling and placement.
- Independent title/description placement and background styling.
Dream Lightbox
- 3, 5 or 7 photographs in the active scene.
- Scene depth, spread, pointer parallax and camera travel speed.
- Overall background opacity, vignette, ambient color, blur, brightness and saturation.
- Ambient fade or cloud-drift motion.
- Optional deeper background photo field with separate count, opacity, blur and spread.
- Shared Dream photo radius plus an optional separate main-photo radius and shadow.
- Independent Previous, Next and Close visibility and styling.
- Automatic mobile behavior that reduces expensive visual effects and reorganizes surrounding photographs vertically.
Standalone Gallery Page
A gallery can be published as a dedicated, branded page with its own URL and responsive presentation.
- Enable a dedicated page and configure its URL slug.
- Set page background, content width and responsive page spacing.
- Show a gallery title and optional introduction above the gallery.
- Style title and description typography independently.
- Use the same password access system and styled login screen when the gallery is protected.
- Preview the Standalone Page directly inside Gallery Studio before publishing.
Gallery access
Gallery access can remain public or be protected by a password independently from the way the gallery is published.
- Public or Password Protected access modes.
- The same gallery password applies to shortcode access and the Standalone Gallery Page.
- Protected gallery content is not rendered until successful authorization.
- Configurable login-session duration.
- Custom login page background, login box, typography, password field, button and error-message appearance.
- Configurable logout button position and styling.
Client Proofing
Client Proofing adds a private selection workflow to a Standalone Gallery Page. Client selections remain drafts until final submission.
- Exact, minimum, maximum or unrestricted selection rules.
- Requested number of photographs.
- Optional comments on selected images and a final message to the gallery owner.
- Private client proofing link that is separate from the normal Standalone Gallery URL.
- Automatic draft saving during selection.
- Final submission confirmation and locked final selection.
- Configurable photographer notification and optional client confirmation email.
- Custom invitation, notification and confirmation email templates.
- WordPress mail delivery or direct SMTP configuration.
- Custom selection-marker position and appearance.
Image protection & watermark
Protection tools are designed to discourage casual copying without modifying the original Media Library files.
Watermark
- Use your own watermark image.
- Choose whether it appears in the gallery, lightbox and Standalone Gallery Page.
- Control position, size, opacity, offsets and rotation.
- Responsive watermark presentation can be configured per device.
Right-click protection
OGALLERY can disable the browser context menu on gallery images to discourage casual saving and copying.
Gallery Albums
Gallery Albums organize galleries and nested subalbums into larger browsable collections.
- Create albums and subalbums and add existing OGALLERY galleries to them.
- Reorder album content and move subalbums without deleting the galleries themselves.
- Choose custom cover images and override item title, description and label.
- Use Grid, Masonry, Masonry Straight Bottom, Justified, Bento, Polaroid, Slider, Carousel or Podium album layouts.
- Configure Desktop, Tablet and Mobile layout values independently.
- Show breadcrumbs with configurable position and appearance.
- Use album filtering and style filter buttons.
- Configure item open behavior, including opening a target gallery/album, lightbox, custom URL or no action where supported.
- Publish an album as a shortcode or enable its own Standalone page.
- Protect albums with password access and a styled login/logout interface.
Gallery styles
Save a gallery's visual configuration as a reusable style without copying its images or source configuration.
- Built-in styles are available for Standard, Slider and Product gallery modules.
- Save the current appearance as a custom reusable style.
- A style includes layout, responsive appearance, effects, typography and lightbox design.
- Gallery images and data-source configuration are intentionally not included.
- Duplicate, delete and preview custom styles.
- Import and export styles as JSON.
- Standard, Slider and Product styles use separate style libraries and file types.
Gallery migration
The Migration screen can copy supported galleries into OGALLERY while leaving the source galleries untouched.
- Images, image order and supported metadata are preserved where available.
- Compatible source layout settings are mapped to OGALLERY automatically.
- Imported images can be assigned to an OGALLERY Media Folder without duplicating existing attachments.
- Existing source gallery shortcode placements can optionally be replaced on WordPress content.
- The latest shortcode-replacement batch can be undone without deleting the imported OGALLERY galleries.
- The source plugin does not need to be active for OGALLERY to scan supported gallery data stored in the database.
Embedding galleries & albums
Published galleries and albums can be inserted into WordPress content using their generated shortcodes.
Gallery shortcode
[ogallery id="123"]Album shortcode
[ogallery_album id="123"]Replace 123 with the actual gallery or album ID. The Gallery list and Gallery Studio provide copy controls for the generated shortcode.
Localization
OGALLERY includes a panel-language setting and compiled translation files for multiple locales. WordPress language can also be used automatically.
Troubleshooting
ACF source shows no images
Confirm that Advanced Custom Fields is active, the configured field name exists and the selected current/specific post contains compatible image data. For repeater data, verify the configured image subfield.
WooCommerce source shows no product images
Confirm that WooCommerce is active and that the current or selected product contains a featured image or gallery images. If Product ACF is selected, verify the ACF field and product context instead.
Password-protected gallery cannot be enabled
Use HTTPS and configure a gallery password of at least 10 characters. The password and confirmation must match before the protected mode can be saved.
Client Proofing link cannot be generated
Enable both Standalone Page and Client Proofing, save/publish the gallery, then generate the private client link.
ZIP import/download is unavailable
Confirm that PHP ZipArchive is available on the server. ZIP import is also limited by the server's upload and resource limits.
Proofing email is not delivered
Use the built-in test email option. Client Proofing can use the normal WordPress mail system or direct SMTP settings configured inside the gallery.