This plugin hasn’t been tested with the latest 3 major releases of WordPress. It may no longer be maintained or supported and may have compatibility issues when used with more recent versions of WordPress.

TK SmugMug Slideshow Shortcode

Description

Making it easy to embed a SmugMug slideshow (iframe, not Flash)

Integrates with Shortcake (Shortcode UI) so building shortcodes (even ones with complex options) is super easy!

Highlights

  • Easily embed a SmugMug Slideshow iframe (not Flash so it works on all devices, including mobile)
  • Customize each slideshow’s settings, including Width, Auto Start, Captions, etc.
  • Slideshow is responsive by default (set to 100% Width) but can be modified to be fixed width.
  • Shortcode appears in Visual Editor for live preview, avoiding the need to preview every change by visiting the front-end.
  • Internationalized / translatable.
  • Lightweight code base using WordPress best practices.
  • Valid HTML5 output.
  • No WP_DEBUG messages
  • Actions and Filters available for developers and advanced customizations
  • Responsive plugin developer

Complementary Items

These items may come in handy for using TK SmugMug Slideshow Shortcode:
(may contain affiliate links)

  • My Copy SmugMug Album Key Chrome extension helps me easily find the AlbumKey required to use this shortcode; it might come in handy for you too.
  • Unless you’re embedding another user’s SmugMug galleries, you’ll need to get your own SmugMug account. Sign up via my link to support me. Plus, you’ll get 20% off your subscription!
  • Shortcake (Shortcode UI) – You’ll be prompted to install this one when you install TK SmugMug Slideshow Shortcode; that’s how great it is!

Acknowledgements

Special thanks to the Shortcake (Shortcode UI) and TGM Plugin Activation developers/contributors.

FYI: This is a third-party plugin, not officially from the SmugMug company.

Support Me

Screenshots

  • Plugin GUI - Shortcode Generator (with Shortcake active)

  • Shortcode vs SmugMug slideshow generators

  • WP Editor preview

  • WP Editor preview with Edit-Delete buttons

Installation

After automatically installing to wp-content/plugins/:

  1. Install the Shortcake (Shortcode UI) plugin (you’ll be prompted to do so if it’s not already installed and activated). It’s optional but highly recommended.
  2. Just use the shortcode in any Visual Editor (e.g. Post/Page edit screens). With Shortcake (Shortcode UI) plugin activated you’ll be able to click “Add Media” then “Insert Post Element” then select one of the shortcodes to customize.

FAQ

Installation Instructions

After automatically installing to wp-content/plugins/:

  1. Install the Shortcake (Shortcode UI) plugin (you’ll be prompted to do so if it’s not already installed and activated). It’s optional but highly recommended.
  2. Just use the shortcode in any Visual Editor (e.g. Post/Page edit screens). With Shortcake (Shortcode UI) plugin activated you’ll be able to click “Add Media” then “Insert Post Element” then select one of the shortcodes to customize.
What are some shortcode examples?

Here are some shortcode examples:

  • At the least, the SmugMug Album Key is required: [smugmug-slideshow key="TrBCmb"]
  • A variety of shortcode arguments: [smugmug-slideshow domain="media.tourkick.com" key="TrBCmb" autostart_off="true" navigation="true" playbutton="true" height="400"]
  • By default, width is set to 100% (responsive), but here’s an example of how to make it fixed width: [smugmug-slideshow key="TrBCmb" width="450" widthunits="px"]

Don’t forget: This shortcode has a user interface (UI) to make it easy to generate or edit [smugmug-slideshow] in the Visual Editor (so you don’t have to manually enter all that shortcode garbly-gook).

Does the shortcode work with my theme?

Yes. It’s just an iframe.

Does the shortcode work over SSL/HTTPS?

Yes (as of version 1.5) as long as you use the “smugmug.com” domain (which is the default) or your custom SmugMug subdomain (e.g. tourkick.smugmug.com, not your media.tourkick.com CNAME domain).

Contributors & Developers

“TK SmugMug Slideshow Shortcode” is open source software. The following people have contributed to this plugin.

Contributors

Changelog

Changelog DIFFs for all versions are available at WordPress SVN.

Version 1.5

  • May 27, 2017
  • Added HTTPS/SSL support. If the shortcode’s “domain” argument ends with ‘smugmug.com’ (e.g. xyz.smugmug.com), the slideshow will load via HTTPS, else HTTP. Really, though, you could just leave the “domain” argument empty to load it from https://smugmug.com/…, which should work in all cases.
  • Added ‘randomize’ shortcode argument
  • Added tk_smugmug_slideshow_shortcode_before_output and tk_smugmug_slideshow_shortcode_after_output filters in case you want to add your own button that links to view the full screen slideshow (same link as the generated iframe src).
  • Integrated Freemius.

Version 1.4

  • January 30, 2017
  • Technically no version change from 1.3 but somehow the plugin’s version was set at 1.4. Either I missed a readme update or ¯_(ツ)_/¯ so we’ll call it v1.4…
  • Readme updated to include link to Chrome extension, specify that others’ SmugMug galleries could be used too, and that this plugin has been tested working with WordPress 4.7.2

Version 1.3

  • November 25, 2015
  • Fix check for global $content_width (!empty instead of isset to avoid iframe width of zero).
  • Added esc_url() to iframe src to improve HTML validation and security.

Version 1.2

  • November 21, 2015
  • Fix plugin header to avoid error with attempt to activate plugin upon initial installation (included TGM Plugin Activation had valid plugin header info and WP scans down another directory looking for additional plugins)

Version 1.1

  • November 20, 2015
  • Change Tested Up To WP version 4.4.

Version 1.0

  • November 17, 2015
  • Initially uploaded to WordPress.org on November 17, 2015