Important: Breaking changes in version 2.0.0 — Migration guide

Hi everyone,

Version 2.0.0 introduces new features like experimental video support and, based on user feedback, makes ‘gallery’ the default mode. I also took the liberty to clean up naming inconsistencies in shortcode parameter names, default values, and allowed values while the plugin is still young and the user base is small. This is a one-time cleanup — from 2.0.0 onward, all parameter names and values will remain stable and backward-compatible.

If you are upgrading from 1.0.x, you will need to update your shortcodes. Below is a complete migration guide.

Renamed Parameters

autoplay → slideshow
autoplay-delay → slideshow-delay
full-screen-autoplay → fullscreen-slideshow
full-screen-autoplay-delay → fullscreen-slideshow-delay
autoplay-inactivity-timeout → slideshow-inactivity-timeout
full-screen-switch → fullscreen-toggle
image-width → source-width
image-height → source-height
max-photos-per-album → limit

Changed Default Values

width: 267 → 400 (better default container size)
height: 200 → 300 (better default container size)
slideshow: true → false (autoplay should be opt-in)
slideshow-delay: “4-12” (random) → “5” (predictable behavior)
fullscreen-slideshow: true → false (autoplay should be opt-in)
fullscreen-slideshow-delay: “3” → “5” (consistent with inline delay)
source-width: 1920 → 800 (faster loading; set source-width=”1920″ for high-res)
source-height: 1440 → 600 (faster loading; set source-height=”1440″ for high-res)
fullscreen-toggle: “double-click” → “button-only” (more discoverable for new users)
background-color: “#FFFFFF” → “transparent” (blends with your page theme)
start-at: “random” → “1” (predictable behavior)
mode: “single” → “gallery” (gallery is now the default experience)

Changed Values

mode: “single” has been renamed to “slider”. “carousel-to-single” has been removed. “gallery” is a new mode.
image-fit: “stretch” has been removed (use “cover” instead).
fullscreen-toggle: “single-click” has been renamed to “click”.

Removed Parameters

full-screen-navigation: This parameter has been removed. Fullscreen navigation is now controlled via fullscreen-toggle (set to “disabled” to prevent entering fullscreen entirely) and interaction-lock (set to “true” to disable all user interaction).

New Parameters in 2.0.0

The following new parameters have been added:

• fullscreen-source-width, fullscreen-source-height — separate source resolution for fullscreen mode (default 1920×1440)
• fullscreen-image-fit — image fit mode for fullscreen, independent from inline (default “contain”)
• controls-color — color of slider/gallery UI controls
• video-controls-color — color of video player controls
• show-navigation — show/hide prev/next arrows (default true)
• show-videos — include or exclude video entries (default false)
• video-controls-autohide — auto-hide video controls (default false)
• interaction-lock — lock all user interaction, useful for digital signage (default false)
• gallery-layout — gallery thumbnail layout: “grid” or “justified” (default “grid”)
• gallery-sizing — gallery thumbnail sizing: “ratio” or “fill” (default “ratio”)
• gallery-columns — number of gallery columns on desktop (default 3)
• gallery-columns-tablet — number of gallery columns on tablet (default 2)
• gallery-columns-mobile — number of gallery columns on mobile (default 1)
• gallery-row-height — row height in pixels for justified layout (default 200)
• gallery-rows — number of gallery rows per page, 0 = show all (default 0)
• gallery-scrollable — enable scrollable gallery container (default false)

Quick migration example

Before (1.0.x):
[jzsa-album link="..." mode="single" autoplay="true" autoplay-delay="5" full-screen-switch="single-click" image-width="1920" image-height="1440"]

After (2.0.0):
[jzsa-album link="..." mode="slider" slideshow="true" slideshow-delay="5" fullscreen-toggle="click" source-width="1920" source-height="1440"]

For the full parameter reference with live examples, visit the plugin’s Settings page in your WordPress admin (Settings → Shared Albums for Google Photos).

I apologize for any inconvenience. These changes were necessary to establish clear, consistent, and industry-standard naming before the plugin grows further. Going forward, backward compatibility will be maintained in all future releases.

I had to go myself through this small hassle on the site which I originally wrote the plugin for. In my case I had to add these 4 parameters:
[jzsa-album link="..." mode="slider" width="267" height="200" fullscreen-toggle="double-click"]

Best regards,
Jan