Shared Albums for Google Photos (by JanZeman)
| 开发者 | janzeman |
|---|---|
| 更新时间 | 2026年4月25日 22:35 |
| PHP版本: | 7.0 及以上 |
| WordPress版本: | 6.9 |
| 版权: | GPLv2 or later |
| 版权网址: | 版权信息 |
详情介绍:
- Google Photos Gallery And Slider - Display public Google Photos albums as responsive galleries or sliders
- Photo And Video Support - Supports both images and videos from shared Google Photos albums
- Fullscreen Viewer - Mobile-friendly fullscreen viewing with touch gestures, keyboard controls, and slideshow support
- Photo Info Overlays - Dynamic placeholders for counters, filenames, dimensions, dates, and EXIF data
- Download And Link Buttons - Optional inline and fullscreen action buttons
- Performance Features - Lazy loading, progressive loading, caching, and large album support
- Shortcode Playground - Admin-only sandbox on the Settings page for experimenting with
[jzsa-album]shortcodes and previews - Mosaic Strip - Optional mosaic thumbnail strip alongside the main viewer, including a fullscreen mosaic mode
- SSRF protection - validates Google Photos URLs
- Proper output escaping for XSS prevention
- WordPress coding standards compliant
- Swiper library bundled locally
- User-friendly error messages for invalid album links
安装:
- Install & Activate the plugin
- Open the plugin's Settings & Onboarding page. It includes a very very large number of customization parameters, many samples, and a live shortcode playground.
- Start with a sample there, then use your own Google Photos albums in posts and pages.
屏幕截图:
常见问题:
Does this work with private albums?
No, the album must be shared publicly via a link. Google Photos does not provide API access to private albums without OAuth authentication.
How many photos can I embed?
The plugin can handle up to 300 photos per album. This is a limitation from Google Photos, which typically returns around 300 photos in the initial page load. For performance and stability reasons, very old iOS devices using legacy WebKit may automatically be limited to 25 photos on the client side, even if the server-side limit is higher. All other platforms (desktop, Android, modern iOS/iPadOS) can use the full per-album limit you configure.
Will this slow down my site?
No. The plugin uses lazy loading, progressive image loading, and local bundled frontend assets. Album data is cached, and the refresh interval is configurable with cache-refresh (default: 7 days).
Can I customize the appearance?
Yes! You can override the CSS by adding custom styles to your theme. The main container class is .jzsa-album.
Does it work on mobile?
Absolutely! The gallery is fully responsive and supports touch gestures (swipe, pinch-to-zoom).
How does the download button work?
When enabled with show-download-button="true", a download button appears in inline (non-fullscreen) view. Clicking it downloads the current full-resolution photo to your device. The download uses a server-side proxy to bypass CORS restrictions from Google Photos.
Use fullscreen-show-download-button to control the fullscreen download button separately. If omitted, it inherits from show-download-button.
How does the play/pause button work?
In fullscreen mode, a play/pause button appears above the photo counter at the bottom center. Click it or press the spacebar to toggle slideshow on/off. The button shows a play icon (▶) when paused and a pause icon (⏸) when playing. This works regardless of the fullscreen-slideshow setting - if slideshow is disabled, the button lets you start it manually.
What happens if I update the shortcode?
The cache is automatically cleared when you save the post, so changes take effect immediately.
What if I use the wrong URL format?
The plugin provides clear feedback: Errors (gallery won't display):
- Invalid URL: Not a valid Google Photos link
- Album is private or link expired: "Unable to Load Album" error
- Empty album: "No Photos Found" error
更新日志:
- Fullscreen support of mosaic. Many thanks
@luisbenitez777for sharing the idea. - Warning added: Google truncates descriptions to 100 chars. Thanks
@naveenbachwanifor the detailed repro steps.
- Fixed info-wrap bug
- Fixed slider mode getting stuck on loading spinner (regression from 2.1.5)
- Reworked Guide page loading to reduce blocking and improve responsiveness
- Improved cache/help guidance on the settings page
- Big thanks to
@naveenbachwanifor detailed testing, UX observations, and support-thread feedback
- Screenshots added
- Add "How the cache works" section
- Improve Guide page loading experience
- Make caching description more clear and prominent
- Settings page moved to top-level admin menu with subpages for easier navigation and reference
- Google Photo description can be supported after all :-)
- Introduce a halo effect to improve text readability
- Swiper loop navigation
- Lighter loading for large sliders
- New
fullscreen-display-max-widthandfullscreen-display-max-height - New
info-wrapand info text alignment parameters - New
gallery-buttons-on-mobilebehavior for touch devices - Responsive layout improvements
- File name bug fix
- New dynamic photo info overlays
- EXIF placeholders with background loading
- Slider, carousel, gallery and fullscreen photo info
- All Settings page samples are editable by now, not only the Playground
- Touch devices: Controls appear on tap and fade out on inactivity
- Fullscreen vs inline controls
- Video download support
- Download UX & settings improvements
- New: Mosaic thumbnail strip (
mosaic="true") for slider and carousel modes - Mosaic feature inspired by Mateusz Starzak's fork
- Added
fullscreen-background-color(default#000) to control fullscreen background separately - Fixed gallery mode where
show-download-button="true"did not render the download button - Fixed slideshow option logic: use
disabled,manual, orautoforslideshowandfullscreen-slideshow - Fixed
fullscreen-toggle="click"for video slides in gallery mode - Improved iPhone pseudo-fullscreen behavior, including fullscreen arrow navigation
- Added restore-to-last-viewed position when closing fullscreen
- Thanks to Peter and Ulf for detailed bug reports and testing
- New parameter: "cache-refresh"
- Clear Cache button added
- Fixed album titles being truncated (dates and special characters are now preserved)
- Gallery mode support
- Experimental video support
- Shortcode parameters and their default values changed (Breaking. Apologies!)
- New animated logo
- Improved Settings page with more intuitive onboarding and richer, example-driven documentation
- Added Shortcode Playground on the Settings page to test and preview
[jzsa-album]shortcodes without leaving admin
- Initial Settings page and onboarding content
- Release related improvements
- Initial release
- Modern Swiper 11 library integration
- Fullscreen mode with dedicated button
- Play/pause button in fullscreen with spacebar keyboard shortcut
- Download button with server-side proxy (optional, disabled by default)
- Zoom support (pinch on touch devices)
- Keyboard navigation (arrows to navigate, spacebar to play/pause in fullscreen)
- Lazy loading for optimal performance
- Progressive image loading with error recovery and placeholders
- Click-to-fullscreen option
- Random start position for galleries
- SSRF protection and proper escaping
- WordPress coding standards compliance
- 24-hour caching mechanism
- User-friendly error messages for invalid album URLs
- Responsive design with touch gestures