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.<\/p>\n\n
For performance and stability reasons, very old iOS devices using legacy WebKit<\/strong> 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.<\/p><\/dd>\nWill this slow down my site?<\/h3><\/dt>\nNo. 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<\/code> (default: 7 days).<\/p><\/dd>\nCan I customize the appearance?<\/h3><\/dt>\nYes! You can override the CSS by adding custom styles to your theme. The main container class is .jzsa-album<\/code>.<\/p><\/dd>\nDoes it work on mobile?<\/h3><\/dt>\nAbsolutely! The gallery is fully responsive and supports touch gestures (swipe, pinch-to-zoom).<\/p><\/dd>\n
How does the download button work?<\/h3><\/dt>\nWhen enabled with show-download-button=\"true\"<\/code>, 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.<\/p>\n\nUse fullscreen-show-download-button<\/code> to control the fullscreen download button separately. If omitted, it inherits from show-download-button<\/code>.<\/p><\/dd>\nHow does the play\/pause button work?<\/h3><\/dt>\nIn 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 (\u25b6) when paused and a pause icon (\u23f8) when playing. This works regardless of the fullscreen-slideshow<\/code> setting - if slideshow is disabled, the button lets you start it manually.<\/p><\/dd>\nWhat happens if I update the shortcode?<\/h3><\/dt>\nThe cache is automatically cleared when you save the post, so changes take effect immediately.<\/p><\/dd>\n
What if I use the wrong URL format?<\/h3><\/dt>\nThe plugin provides clear feedback:<\/p>\n\n
Errors (gallery won't display):<\/strong>\n- Invalid URL: Not a valid Google Photos link\n- Album is private or link expired: \"Unable to Load Album\" error\n- Empty album: \"No Photos Found\" error<\/p><\/dd>\n\n<\/dl>\n\n\n2.1.5<\/h4>\n\n\n- Progressively loaded Guide page<\/li>\n<\/ul>\n\n
2.1.4<\/h4>\n\n\n- Screenshots added<\/li>\n<\/ul>\n\n
2.1.3<\/h4>\n\n\n- Add \"How the cache works\" section<\/li>\n
- Improve Guide page loading experience<\/li>\n<\/ul>\n\n
2.1.2<\/h4>\n\n\n- Make caching description more clear and prominent<\/li>\n<\/ul>\n\n
2.1.0<\/h4>\n\n\n- Settings page moved to top-level admin menu with subpages for easier navigation and reference<\/li>\n
- Google Photo description can be supported after all :-)<\/li>\n
- Introduce a halo effect to improve text readability<\/li>\n<\/ul>\n\n
2.0.11<\/h4>\n\n\n- Swiper loop navigation<\/li>\n<\/ul>\n\n
2.0.10<\/h4>\n\n\n- Lighter loading for large sliders<\/li>\n<\/ul>\n\n
2.0.9<\/h4>\n\n\n- New
fullscreen-display-max-width<\/code> and fullscreen-display-max-height<\/code><\/li>\n- New
info-wrap<\/code> and info text alignment parameters<\/li>\n- New
gallery-buttons-on-mobile<\/code> behavior for touch devices<\/li>\n- Responsive layout improvements<\/li>\n<\/ul>\n\n
2.0.8<\/h4>\n\n\n- File name bug fix<\/li>\n<\/ul>\n\n
2.0.7<\/h4>\n\n\n- New dynamic photo info overlays<\/li>\n
- EXIF placeholders with background loading<\/li>\n
- Slider, carousel, gallery and fullscreen photo info<\/li>\n
- All Settings page samples are editable by now, not only the Playground<\/li>\n<\/ul>\n\n
2.0.6<\/h4>\n\n\n- Touch devices: Controls appear on tap and fade out on inactivity<\/li>\n<\/ul>\n\n
2.0.5<\/h4>\n\n\n- Fullscreen vs inline controls<\/li>\n
- Video download support<\/li>\n
- Download UX & settings improvements<\/li>\n<\/ul>\n\n
2.0.4<\/h4>\n\n\n- New: Mosaic thumbnail strip (
mosaic=\"true\"<\/code>) for slider and carousel modes<\/li>\n- Mosaic feature inspired by Mateusz Starzak's fork<\/li>\n
- Added
fullscreen-background-color<\/code> (default #000<\/code>) to control fullscreen background separately<\/li>\n- Fixed gallery mode where
show-download-button=\"true\"<\/code> did not render the download button<\/li>\n- Fixed slideshow option logic: use
disabled<\/code>, manual<\/code>, or auto<\/code> for slideshow<\/code> and fullscreen-slideshow<\/code><\/li>\n- Fixed
fullscreen-toggle=\"click\"<\/code> for video slides in gallery mode<\/li>\n- Improved iPhone pseudo-fullscreen behavior, including fullscreen arrow navigation<\/li>\n
- Added restore-to-last-viewed position when closing fullscreen<\/li>\n
- Thanks to Peter and Ulf for detailed bug reports and testing<\/li>\n<\/ul>\n\n
2.0.3<\/h4>\n\n\n- New parameter: \"cache-refresh\"<\/li>\n
- Clear Cache button added<\/li>\n<\/ul>\n\n
2.0.1<\/h4>\n\n\n- Fixed album titles being truncated (dates and special characters are now preserved)<\/li>\n<\/ul>\n\n
2.0.0<\/h4>\n\n\n- Gallery mode support<\/li>\n
- Experimental video support<\/li>\n
- Shortcode parameters and their default values changed (Breaking. Apologies!)<\/li>\n<\/ul>\n\n
1.0.6<\/h4>\n\n\n- New animated logo<\/li>\n<\/ul>\n\n
1.0.3<\/h4>\n\n\n- Improved Settings page with more intuitive onboarding and richer, example-driven documentation<\/li>\n
- Added Shortcode Playground on the Settings page to test and preview
[jzsa-album]<\/code> shortcodes without leaving admin<\/li>\n<\/ul>\n\n1.0.2<\/h4>\n\n\n- Initial Settings page and onboarding content<\/li>\n<\/ul>\n\n
1.0.1<\/h4>\n\n\n- Release related improvements<\/li>\n<\/ul>\n\n
1.0.0<\/h4>\n\n\n- Initial release<\/li>\n
- Modern Swiper 11 library integration<\/li>\n
- Fullscreen mode with dedicated button<\/li>\n
- Play\/pause button in fullscreen with spacebar keyboard shortcut<\/li>\n
- Download button with server-side proxy (optional, disabled by default)<\/li>\n
- Zoom support (pinch on touch devices)<\/li>\n
- Keyboard navigation (arrows to navigate, spacebar to play\/pause in fullscreen)<\/li>\n
- Lazy loading for optimal performance<\/li>\n
- Progressive image loading with error recovery and placeholders<\/li>\n
- Click-to-fullscreen option<\/li>\n
- Random start position for galleries<\/li>\n
- SSRF protection and proper escaping<\/li>\n
- WordPress coding standards compliance<\/li>\n
- 24-hour caching mechanism<\/li>\n
- User-friendly error messages for invalid album URLs<\/li>\n
- Responsive design with touch gestures<\/li>\n<\/ul>","raw_excerpt":"Display publicly shared Google Photos albums with a modern, responsive Swiper-based gallery viewer.","jetpack_sharing_enabled":true,"_links":{"self":[{"href":"https:\/\/da.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin\/273213","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/da.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin"}],"about":[{"href":"https:\/\/da.wordpress.org\/plugins\/wp-json\/wp\/v2\/types\/plugin"}],"replies":[{"embeddable":true,"href":"https:\/\/da.wordpress.org\/plugins\/wp-json\/wp\/v2\/comments?post=273213"}],"author":[{"embeddable":true,"href":"https:\/\/da.wordpress.org\/plugins\/wp-json\/wporg\/v1\/users\/janzeman"}],"wp:attachment":[{"href":"https:\/\/da.wordpress.org\/plugins\/wp-json\/wp\/v2\/media?parent=273213"}],"wp:term":[{"taxonomy":"plugin_section","embeddable":true,"href":"https:\/\/da.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_section?post=273213"},{"taxonomy":"plugin_tags","embeddable":true,"href":"https:\/\/da.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_tags?post=273213"},{"taxonomy":"plugin_category","embeddable":true,"href":"https:\/\/da.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_category?post=273213"},{"taxonomy":"plugin_contributors","embeddable":true,"href":"https:\/\/da.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_contributors?post=273213"},{"taxonomy":"plugin_business_model","embeddable":true,"href":"https:\/\/da.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_business_model?post=273213"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}