Title: Sonido Gallery
Author: Emilio Petrozzi - MrTux
Published: <strong>2026 年 9 月 27 日</strong>
Last modified: 2026 年 9 月 27 日

---

搜尋外掛

![](https://ps.w.org/sonido-gallery/assets/banner-772x250.png?rev=3715404)

![](https://ps.w.org/sonido-gallery/assets/icon-256x256.png?rev=3715404)

# Sonido Gallery

 由 [Emilio Petrozzi – MrTux](https://profiles.wordpress.org/mrtuxit/) 開發

[下載](https://downloads.wordpress.org/plugin/sonido-gallery.1.1.0.zip)

 * [詳細資料](https://tw.wordpress.org/plugins/sonido-gallery/#description)
 * [使用者評論](https://tw.wordpress.org/plugins/sonido-gallery/#reviews)
 *  [安裝方式](https://tw.wordpress.org/plugins/sonido-gallery/#installation)
 * [開發資訊](https://tw.wordpress.org/plugins/sonido-gallery/#developers)

 [技術支援](https://wordpress.org/support/plugin/sonido-gallery/)

## 外掛說明

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 ](https://wpforge.site/sonido-gallery-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](https://wpforge.site/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](https://photoswipe.com) 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](https://wpforge.site/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

## 螢幕擷圖

[⌊Gallery meta box with sortable image list and caption editor⌉⌊Gallery meta box
with sortable image list and caption editor⌉[

Gallery meta box with sortable image list and caption editor

[⌊Frontend grid with lightbox open⌉⌊Frontend grid with lightbox open⌉[

Frontend grid with lightbox open

[⌊Settings page (Layout, Captions, Visuals)⌉⌊Settings page (Layout, Captions, Visuals
)⌉[

Settings page (Layout, Captions, Visuals)

## 安裝方式

 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.

## 常見問題集

### 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](https://wpforge.site/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](https://wpforge.site/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).

## 使用者評論

這個外掛目前沒有任何使用者評論。

## 參與者及開發者

以下人員參與了開源軟體〈Sonido Gallery〉的開發相關工作。

參與者

 *   [ Emilio Petrozzi – MrTux ](https://profiles.wordpress.org/mrtuxit/)

[將〈Sonido Gallery〉外掛本地化為台灣繁體中文版](https://translate.wordpress.org/projects/wp-plugins/sonido-gallery)

### 對開發相關資訊感興趣？

任何人均可[瀏覽程式碼](https://plugins.trac.wordpress.org/browser/sonido-gallery/)、
查看 [SVN 存放庫](https://plugins.svn.wordpress.org/sonido-gallery/)，或透過 [RSS](https://plugins.trac.wordpress.org/log/sonido-gallery/?limit=100&mode=stop_on_copy&format=rss)
訂閱[開發記錄](https://plugins.trac.wordpress.org/log/sonido-gallery/)。

## 變更記錄

#### 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.

## 中繼資料

 *  版本 **1.1.0**
 *  最後更新 **6 天前**
 *  啟用安裝數 **少於 10 次**
 *  WordPress 版本需求 ** 6.0 或更新版本 **
 *  已測試相容的 WordPress 版本 **7.1.2**
 *  PHP 版本需求 ** 7.4 或更新版本 **
 *  語言
 * [English (US)](https://wordpress.org/plugins/sonido-gallery/)
 * 標籤:
 * [gallery](https://tw.wordpress.org/plugins/tags/gallery/)[image](https://tw.wordpress.org/plugins/tags/image/)
   [lightbox](https://tw.wordpress.org/plugins/tags/lightbox/)[photoswipe](https://tw.wordpress.org/plugins/tags/photoswipe/)
   [video](https://tw.wordpress.org/plugins/tags/video/)
 *  [進階檢視](https://tw.wordpress.org/plugins/sonido-gallery/advanced/)

## 評分

這個項目尚無任何評論記錄。

[撰寫評分](https://wordpress.org/support/plugin/sonido-gallery/reviews/#new-post)

[查看全部使用者評論](https://wordpress.org/support/plugin/sonido-gallery/reviews/)

## 參與者

 *   [ Emilio Petrozzi – MrTux ](https://profiles.wordpress.org/mrtuxit/)

## 技術支援

使用者可在技術支援論壇提出意見反應或使用問題。

 [檢視技術支援論壇](https://wordpress.org/support/plugin/sonido-gallery/)