KISS Flickr Gallery
Flickr albums, fast, on your own site.
KISS Flickr Gallery shows the public albums and photos of one Flickr account, rendered on your server and cached, so the gallery is quick and your API key never reaches the browser.
- Version
- 1.4.3
- WordPress
- 6.5+
- Tested up to
- WordPress 7.1.4
- PHP
- 8.1+
- Releases
- 22
- License
- GPL 2.0 or later
What it solves
Organizations that shoot a lot of events often keep their photos on Flickr. Embedding those albums usually means slow scripts in the browser and a gallery that goes blank when Flickr has a bad day.
This plugin asks Flickr from the server, keeps a snapshot in the database, and serves the last good copy if Flickr is down. Visitors only ever load the images.
What it does
Server-rendered albums
The first cover is a real image, so nothing shifts while the page loads.
Batches as you scroll
Justified or masonry grids, laid out from the sizes Flickr returns, with no layout library.
Lightbox on first click
PhotoSwipe loads only when someone opens a photo: touch, keyboard, captions and a View on Flickr link.
No browser API calls
Every Flickr request is server-side, and the key never appears in the page source.
Outage-proof cache
Snapshots live in the database, so they survive cache flushes and Redis restarts, and serve during a Flickr outage.
Three ways to place it
A shortcode, a block or an Elementor widget, sharing one renderer.
SEO plugin aware
Works with Rank Math and Yoast for album titles and Open Graph on shared album links.
What it needs
- WordPress 6.5 or later
- PHP 8.1 or later
- A Flickr API key (the free non-commercial key)
- Public photos only, by design
See it running
Fighter Country Foundation's photostream runs on it.
Install
- 01
Step 1
Upload the kiss-flickr folder to /wp-content/plugins/ and activate it.
- 02
Step 2
Create a Flickr API key (non-commercial) at flickr.com/services/apps/create. Only the key is needed; the secret is never used.
- 03
Step 3
Under KISS Flickr → Connection in the admin menu, enter the key and your Flickr username or profile URL, then Save and click Test Connection.
- 04
Step 4
Place [kiss_flickr] in a page or add the KISS Flickr Gallery block.
New versions install the same way: upload the new ZIP over the old one. Settings are kept.
Changelog
22 releases so far. The newest:
1.4.3
- Changed marked compatible with WordPress 7.1.4, so the update screen no longer says "Not tested".
- Changed the icon on the update screen has rounded corners and, every few seconds, flips over to Imaginary Trout's power button.
- Changed the banner in the plugin details leaves room for the plugin name WordPress writes over its lower left corner.
1.4.2
- Added the KISS Flickr icon beside the title on the settings page, and as the admin menu icon.
- Added when a newer version is available, a red "Update to vX" badge appears beside the version number and links to Dashboard, Updates.
1.4.1
- Added Back link style under Album View. The "All albums" link above the album title can be the theme's button (Elementor's button style where available, an outline button elsewhere; the default), an outline button in the link colour, or the plain text link it was.
- Changed the version badge on the settings page is an outlined pill.
1.4.0
- Added a loading indicator for the photo grid. Large photos can take several seconds to arrive, and until now the visitor looked at an empty page.
- Changed the plugin now has its own top-level admin menu, KISS Flickr, right below Comments alongside the other KISS plugins, with one entry per settings tab.
1.3.5
- Fixed with a theme header that hides on scroll down and reveals on scroll up (Salient and others), opening an album or going back could land the gallery at the top of the viewport while the header was hidden, and the header then revealed over the title and back link.
1.3.4
- Changed a fixed Columns count is now the most columns to show, not a hard count.
- Fixed opening an album or going back to the index scrolled the gallery under fixed theme headers, hiding the title and the back link.
KISS Flickr Gallery questions
Never. All Flickr requests are server-side and cached. Visitors' browsers only load images from live.staticflickr.com.
Nothing visible. Gallery data is stored as snapshots in the options table, so a flush only clears the in-memory copy, which is rebuilt from the database without a Flickr call.
No. Public content only, by design. No OAuth and no API secret are needed or stored.
[kiss_flickr album="72177720315945885" album_header="none"]
The plugin opts its thumbnails out of Elementor's and common theme lightboxes. If a theme still hijacks clicks, set the lightbox provider to "site" to hand the images to the theme deliberately, or report the theme so the opt-out can be added.
Other KISS plugins
Want KISS Flickr Gallery on your site?
It is not on WordPress.org yet. It runs on the sites we build and manage. Tell us about yours, or about a plugin you need built.
Start a project