內容簡介
Shared Albums for Google Photos (by JanZeman) 允許使用者在 WordPress 文章和頁面中輕鬆顯示公開分享的 Google Photos 相簿，並透過簡單的短碼提供美觀的觸控式畫廊體驗。
【主要功能】
• 縮圖網格模式：以統一佈局顯示照片
• 現代畫廊檢視器：使用 Swiper 11 提供流暢體驗
• 響應式設計：適用於桌面、平板和手機
• 短碼遊樂場：管理員專用的短碼實驗區
• 全螢幕模式：點擊查看照片於全螢幕
• 進階加載：優化性能的漸進式加載
外掛標籤
開發者團隊
② 後台搜尋「Shared Albums for Google Photos (by JanZeman)」→ 直接安裝（推薦）
原文外掛簡介
Shared Albums for Google Photos (by JanZeman) allows you to easily display publicly shared Google Photos albums in your WordPress posts and pages using a simple shortcode. The plugin uses the modern Swiper library to provide a beautiful, touch-enabled gallery experience.
Note: This plugin is not affiliated with or endorsed by Google LLC. Google Photos™ is a trademark of Google LLC.
IMPORTANT: Short links (photos.app.goo.gl) might stop working in the future. While both full and short link formats work today, we strongly recommend using the full link format https://photos.google.com/share/ to ensure your galleries continue working. The plugin will display a warning banner when short links are detected.
Features
Grid Mode – Display photos as a thumbnail grid with uniform/justified layouts
Grid Paging Or Scrolling – Use grid-rows with optional grid-scroller to choose page controls or a single scrollable grid
Modern Gallery Viewer – Powered by Swiper 11, a modern mobile-friendly slider
Responsive Design – Works perfectly on desktop, tablet, and mobile devices
Shortcode Playground – Admin-only sandbox on the Settings page for experimenting with [jzsa-album] shortcodes and previews
Touch Gestures – Swipe navigation on touch devices
Fullscreen Mode – Click to view photos in fullscreen
Play/Pause Control – Fullscreen play/pause button with spacebar keyboard shortcut
Click Navigation – Optional click/double-click on left/right areas to navigate between photos
Dual-Mode Autoplay – Separate autoplay settings for normal and fullscreen modes
Zoom Support – Pinch-to-zoom and double-click to zoom on photos
Keyboard Navigation – Use arrow keys to navigate, spacebar to play/pause in fullscreen
Progressive Loading – Loads preview images first, then full-resolution for optimal performance
Smart Preloading – Automatically preloads adjacent slides for smooth navigation
Lazy Loading – Images load as needed for optimal performance
Error Recovery – Graceful fallback with placeholder when images fail to load
Download Button – Optional download button to save photos to your device
Customizable – Control dimensions, autoplay, delays, and more
Cached for Performance – Gallery HTML is cached for 24 hours
Large Album Support – Handles up to 300 photos per album (Google Photos limitation; very old iOS/WebKit devices may be limited to 25 photos for stability)
How It Works
The plugin fetches your public Google Photos album and creates a responsive gallery. Simply paste the share link from Google Photos into the shortcode.
Security & Error Handling
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 or short links
Automatic detection and warning for deprecated goo.gl links
Usage
Basic Usage
RECOMMENDED: Use the full photos.google.com/share/ URL format for future compatibility.
[jzsa-album link="https://photos.google.com/share/YOUR_LONG_ALBUM_ID"]
Concrete example with a real album link (for testing):
[jzsa-album link="https://photos.google.com/share/AF1QipOg3EA51ATc_YWHyfcffDCzNZFsVTU_uBqSEKFix7LY80DIgH3lMkLwt4QDTHd8EQ?key=RGwySFNhbmhqMFBDbnZNUUtwY0stNy1XV1JRbE9R"]
Note: Short links (photos.app.goo.gl) are still supported but will show a deprecation warning.
Advanced Usage
[jzsa-album
link="https://photos.google.com/share/YOUR_LONG_ALBUM_ID"
background-color="#000000"
image-fit="contain"
width="500"
height="375"
autoplay="true"
autoplay-delay="5"
autoplay-inactivity-timeout="60"
start-at="1"
full-screen-autoplay="true"
full-screen-autoplay-delay="3"
full-screen-switch="double-click"
full-screen-navigation="single-click"
show-title="true"
show-counter="true"
show-link-button="true"
show-download-button="true"
]
Shortcode Parameters
The only required parameter is link — the Google Photos share URL.
All other parameters are optional and control appearance, autoplay, fullscreen behavior, display options, gallery mode, and grid layout.
For the complete list of all parameters with descriptions and defaults, visit the plugin’s Settings page in your WordPress admin (Settings → Shared Albums for Google Photos). The Settings page also includes a Playground for experimenting with shortcodes and live Samples you can copy.
Getting Your Album Share Link
Open Google Photos and select an album
Click the share button (or three-dot menu > Share)
Click “Create link” or “Get link”
Copy the FULL share link (format: https://photos.google.com/share/AF1QipN...)
IMPORTANT: Google Photos may show a short link like https://photos.app.goo.gl/abc123. These short links might stop working in the future.
Current Behavior:
– Short links still work but display a warning banner
– We strongly recommend using full links to avoid future issues
How to get the full link:
– On web: Right-click the album share link and choose “Copy link address” to get the full link
– Or visit the short link in your browser and copy the full link from the address bar
Example:
Full link (recommended): https://photos.google.com/share/AF1QipNxLo... ✅
Short link (works with warning): https://photos.app.goo.gl/abc123 ⚠️
Use the shortcode with full link:
[jzsa-album link=”https://photos.google.com/share/AF1QipNxLo…”]
Or with short link (not recommended):
[jzsa-album link=”https://photos.app.goo.gl/abc123″]
Important: The album must be public (shared via link) for the plugin to access it.
Credits
Uses Swiper – MIT License
Developed by Jan Zeman
Privacy Policy
This plugin does not collect or store any user data.
Use of external Google services
The plugin fetches public Google Photos album pages from https://photos.google.com and image files from *.googleusercontent.com in order to render the galleries.
Only publicly shared album links are supported; the plugin has no access to private albums or any content that is not already available via a public share link.
The plugin does not collect, store, or transmit user credentials or personal data. It only caches album HTML and image URLs in WordPress transients for performance, and this cache is stored locally in your WordPress database.
Support
Bug reports: Open an issue on GitHub
Feature requests: Post on the support forum
Leave a rating: Review on WordPress.org
Buy Me a Coffee: buymeacoffee.com/janzeman
![Swiper – 3D Coverflow Effect for visual composer [WPBakery Page Builder]](https://ps.w.org/swiper-for-visual-composer/assets/icon.svg?rev=2295909){kind=icon}
