Sonido Gallery
| 开发者 | mrtuxit |
|---|---|
| 更新时间 | 2026年9月27日 19:37 |
| PHP版本: | 7.4 及以上 |
| WordPress版本: | 7.1 |
| 版权: | GPL-2.0-or-later |
| 版权网址: | 版权信息 |
详情介绍:
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)
- 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
[sonido_gallery id="123"].
Attributes:
id(required) - gallery post ID, found in the URL of each Gallery edit pagesize-thumbnail|medium|large(overrides global default)columns- 1 to 6 (overrides global default)layout- layout slug registered in the registry (grid, ormasonry/justified/carouselwith Sonido Gallery Pro)
sonido_gallery_layout— resolve the layout slug per rendersonido_gallery_shortcode_atts— modify shortcode attributessonido_gallery_item_html/sonido_gallery_caption_html— replace item and caption markupsonido_gallery_allowed_types+sonido_gallery_normalize_custom_item— add custom item types- Theme overrides:
<theme>/sonido-gallery/layout-<slug>.phpanditem.php
public/js/vendor/photoswipe.LICENSE.txt).
安装:
- Upload the
sonido-galleryfolder to/wp-content/plugins/. - Activate the plugin in Plugins in WordPress.
- Go to Galleries -> Add New, give it a title, then click "Add Images" (or add a video).
- 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, 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).
更新日志:
1.1.0
- New: layout registry with theme-overridable templates and
layoutshortcode 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).
- 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.
- Initial release.