OGALLERY

OGALLERY Documentation

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.

ComponentRequirement
WordPress6.4 or newer
PHP8.0 or newer
Advanced Custom FieldsOptional. Required only when an ACF field is used as a gallery or product image source.
WooCommerceOptional. Required when WooCommerce product images are used as the product gallery source.
PHP ZipArchiveOptional. Required only for ZIP import and ZIP download features in Media Folders.
HTTPSRequired 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

  1. Choose the gallery family and starting layout.
  2. Choose the real content source.
  3. Apply a built-in style or keep the default appearance.
  4. Set essential options such as columns, image gap, navigation, loop and lightbox.
  5. 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.

Responsive preview: Desktop, Tablet and Mobile views are available in Studio. Many visual settings are stored independently for each device, and selected settings can be copied to the other views.

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.

ModuleLayoutsPurpose
Standard GalleryGrid, Masonry, Masonry Straight Bottom, Justified, Bento, PolaroidPortfolio, editorial, image collection and mixed-layout galleries.
SlidersSlider, Carousel, Podium SliderSingle-image presentation, multiple visible images or a staged center-focused composition.
WooCommerce Product GalleryProduct Bento, Product Slider, Product PodiumProduct-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.

Studio preview: Dynamic ACF and WooCommerce sources provide a separate preview-post or preview-product selection. This changes only what is displayed inside Studio and does not replace the published source configuration.

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.

ZIP support: ZIP import and download require the PHP 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

Zoom InZoom OutLiftTiltBlurGrayscaleKen Burns CinematicPrism LeakKinetic SplitOverslideDouble CurtainContrast BoostContrast FadeSaturation BoostSaturation FadeWarm GradeBlack & White ShiftColor Restore

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.
Tags belong to images: OGALLERY tags are attached to Media Library images and are not stored inside Gallery Style presets.

Social sharing

The lightbox can display a configurable sharing interface.

FacebookXWhatsAppPinterestEmailCopy Link
  • Share the gallery page or a direct link to the current photo.
  • Optionally include image title and description in share text.
  • Place the sharing interface inside the image, outside the image or around the caption area.
  • Control label, direction, spacing, icon style, hover states, shape, shadow and Copy Link confirmation.
  • Layout and style settings can be adjusted per device.

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.
Embedded behavior: When a Standalone Page is enabled for a non-product gallery, the regular gallery shortcode displays a standalone-gallery notice instead of rendering a second embedded copy of that gallery.

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.
HTTPS required: OGALLERY requires HTTPS when password protection is enabled.

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.
Required setup: Client Proofing is available when both the Standalone Page and Client Proofing are enabled and the gallery has been saved.

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.

Important: Right-click protection cannot prevent screenshots or access through browser developer tools and should not be treated as DRM.

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.

FooGalleryEnvira GalleryModulaNextGENPhoto Gallery by 10WebRobo Gallery
  • 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.

EnglishPolishGermanSpanishFrenchItalianPortuguese (Brazil)TurkishIndonesianRussianUkrainian

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.