Sonido Gallery

Description

Sonido Gallery lets you build beautiful, responsive image and video galleries entirely from the WordPress admin. No builders, no bloat: images stay in your Media Library, galleries render with a lightweight CSS grid and open in a PhotoSwipe lightbox with zoom, swipe and keyboard navigation.

Features

  • Custom post type “Galleries” for managing multiple galleries
  • Pick images from the Media Library, or add videos
  • Supports YouTube and self-hosted video files, with custom cover images
  • Three thumbnail sizes: thumbnail / medium / large
  • HTML-formatted captions (bold, italic, links, line breaks)
  • PhotoSwipe v5 lightbox with touch, zoom, and keyboard navigation
  • Responsive CSS grid with per-instance column override
  • Developer-friendly layout registry: register new layouts with one filter
  • Translation ready (text domain sonido-gallery)

Take it further with Sonido Gallery Pro

Pro adds layouts and video capabilities that don’t fit a plugin meant to stay lightweight:

  • Masonry layout — CSS columns that flow vertically, perfect for mixed-ratio photography
  • Justified layout — Google-Photos-style rows with a shared height
  • Carousel layout — horizontal scroll-snap slider with prev/next buttons
  • Vimeo videos — add Vimeo URLs to any gallery, with cached thumbnails and in-modal playback
  • Per-gallery layout selector — choose the layout straight from the gallery editor
  • Theme-overridable templates — every layout and the item markup can be replaced from your theme

Pro is a separate paid plugin, licensed per site, with automatic updates and priority support. All layouts keep working with the same [sonido_gallery] shortcode you already use — switching is as simple as changing one attribute. See Pro

Shortcode

Embed a gallery with [sonido_gallery id="123"].

Attributes:

  • id (required) – gallery post ID, found in the URL of each Gallery edit page
  • size – thumbnail | medium | large (overrides global default)
  • columns – 1 to 6 (overrides global default)
  • layout – layout slug registered in the registry (grid, or masonry / justified / carousel with Sonido Gallery Pro)

For convenience, the plugin shows the shortcode on the settings page together with a copy/paste example.

For developers

The plugin exposes a small, stable extension API:

  • sonido_gallery_layout — resolve the layout slug per render
  • sonido_gallery_shortcode_atts — modify shortcode attributes
  • sonido_gallery_item_html / sonido_gallery_caption_html — replace item and caption markup
  • sonido_gallery_allowed_types + sonido_gallery_normalize_custom_item — add custom item types
    • Theme overrides: <theme>/sonido-gallery/layout-<slug>.php and item.php

Credits

The bundled lightbox is PhotoSwipe v5 by Dmytro Semenov, released under the MIT License (license text included in public/js/vendor/photoswipe.LICENSE.txt).

Sonido Gallery Pro

Upgrade when you need more: Sonido Gallery Pro adds Masonry, Justified and Carousel layouts, Vimeo video support and a per-gallery layout selector. Distributed separately with automatic updates and priority support.

External services

This plugin shows YouTube video items inside galleries, which relies on two external services operated by Google LLC:

  1. YouTube thumbnails. When a gallery contains a YouTube video item, the visitor’s browser loads the video’s preview image directly from i.ytimg.com so the gallery can display a thumbnail without storing a copy in your site.
  2. YouTube embedded player. When a visitor opens a YouTube item, the plugin loads YouTube’s embedded iframe player from youtube.com to play the video inside the lightbox.

What data is sent: the YouTube video ID (part of the URL you add to the gallery) is included in the requests the visitor’s browser makes to i.ytimg.com and youtube.com. The requests happen only when a visitor loads a page that renders a gallery containing that YouTube item. No plugin data is sent to any other third-party service, and no server-to-server requests are made.

The plugin does not connect to these services on your server; only the visitor’s browser makes those requests. YouTube may set its own cookies per its policies.

Service provided by Google LLC — YouTube Terms of Service: https://www.youtube.com/t/terms — Google Privacy Policy: https://policies.google.com/privacy

Screenshots

Installation

  1. Upload the sonido-gallery folder to /wp-content/plugins/.
  2. Activate the plugin in Plugins in WordPress.
  3. Go to Galleries -> Add New, give it a title, then click “Add Images” (or add a video).
  4. Copy the [sonido_gallery id="123"] shortcode from the settings page and paste it into any post or page.

FAQ

Can I embed multiple galleries on the same page?

Yes. Each [sonido_gallery id="..."] uses its own ID and has its own independent set of images.

Can I add videos to my gallery?

Yes. Add YouTube URLs or upload video files from the Media Library; each video can have a custom cover image. Clicking a video thumbnail opens a dedicated player modal.

Can I use a different grid style?

The free version ships a responsive CSS grid. Masonry, Justified and Carousel layouts are available in Sonido Gallery Pro, together with a per-gallery layout selector.

Are the images saved on my server?

Yes. The plugin uses the regular WordPress Media Library; nothing is sent to third-party services. YouTube embeds load from YouTube only when a video is actually played.

Does the plugin work without JavaScript?

Yes. If JavaScript is disabled, clicking a thumbnail opens the full-size image in the browser. If the lightbox toggle is off in the settings, the lightbox script is not loaded.

Is there a Pro version?

Yes. Sonido Gallery Pro adds Masonry, Justified and Carousel layouts, Vimeo support and a per-gallery layout selector. The free version is complete on its own: Pro is for when you need more presentation options or premium support.

How do I update PhotoSwipe to a newer version?

The bundled PhotoSwipe version is updated by the plugin author in each release; for manual updates replace the three files in public/js/vendor/ (keeping the MIT license text).

Reviews

There are no reviews for this plugin.

Contributors & Developers

“Sonido Gallery” is open source software. The following people have contributed to this plugin.

Contributors

Translate “Sonido Gallery” into your language.

Interested in development?

Browse the code, check out the SVN repository, or subscribe to the development log by RSS.

Changelog

1.1.0

  • New: layout registry with theme-overridable templates and layout shortcode attribute.
  • New: per-gallery layout selector in the gallery meta box.
  • New: developer hooks — sonido_gallery_layout, sonido_gallery_shortcode_atts, sonido_gallery_item_html, sonido_gallery_caption_html, sonido_gallery_item_template_path, sonido_gallery_template_path, sonido_gallery_after_render, sonido_gallery_loaded.
  • New: filterable item types for add-ons (sonido_gallery_allowed_types, sonido_gallery_normalize_custom_item, sonido_gallery_video_item_props), with front-end and admin JS hooks.
  • Refactor: item markup extracted into a shared, theme-overridable template — output unchanged.
  • New: item captions now appear inside the PhotoSwipe lightbox.
  • Fix: built-in layout label now translates lazily, avoiding a just-in-time textdomain notice on WordPress 6.7+ (new Sonido_Gallery_Layouts::get_label() helper).

1.0.1

  • Performance: plugin CSS/JS (including PhotoSwipe) are now loaded only on pages that render a [sonido_gallery] shortcode.
  • Security: unpublished (draft/private) galleries are no longer rendered to public visitors; editors still see previews.
  • Editors now see an inline notice instead of silent empty output when a shortcode ID is invalid or a gallery is empty.
  • Accessibility: video modal now manages focus (trap on open, restore on close) and uses translatable labels.
  • Admin: cover buttons use proper translatable strings; settings page now shows save confirmation notices.
  • Added uninstall.php to clean the plugin settings without touching gallery content.

1.0.0

  • Initial release.