I have had to release version 1.61 as a patch for older PHP versions. There was a line of code that was causing the Flickr interface to crash (and occasionally bring down websites) if the PHP version was old.
Version 1.60 of Photonic is now out. This version has the following updates:
- “Count” support in SmugMug
Photonic interfaces for all providers have had a capability to restrict the number of photos pulled. Flickr has
per_page, Google Photos / Picasa
rpp(results per page), and Instagram
count. The big exception to this rule was SmugMug, because SmugMug API v1.3 didn’t support this capability. However, API v2 supports it, and oversight on my part while implementing it for Photonic v1.57 caused me to skip it. This has been rectified, and now you can get a specified number of photos for SmugMug.
- “Load More”
The above capability has made it easy for me to provide a “Load More” feature. Let’s say your album has 355 photos, and you want to display 100 photos in the beginning so as to not overwhelm your site’s visitors. Photonic so far lacked a capability to display the remaining photos on the same page. You can now pass an additional
moreparameter to the shortcode, which Photonic then knows to interpret as being asked to show a button. Whatever value you pass to the parameter will become the text of the button. So,
more='Load More'will show a button with text “Load More”, while
more='More …'will show a button with text “More …”.
This feature uses “lazy loading”, so unless you click on the button the new batch of 100 photos (or whatever your count parameter specified) will not be fetched from the server, and the old set of existing photos will not be re-fetched.
- Lightcase Lightbox Support
I have added support for the Lightcase lightbox script. This script is a bit heavy (25KB minified) compared to the last 2 scripts I added support for (Swipebox and Image Lightbox) and it requires third-party touch plugins, but it looks pretty nice. I did some optimization on the CSS (16KB), which originally used a custom font that added quite a few KB and files to the volume, and replaced it with CSS animations for the icons.
- I have fixed a bug with the “Image Lightbox” script wherein if interim popups were enabled, clicking on an image in the interim popup wouldn’t show the lightbox.
Enjoy the update!
I have just released version 1.59 of Photonic. This is a very big release, with a lot of far-reaching changes:
- Rewritten Instagram Integration:
Some time in June 2016 Instagram made several changes to its API. Every service provider makes changes to APIs (SmugMug has done it, Twitter has done it, and, notoriously, Google has done it with Picasa). Among things removed from Instagram’s API were popular photos and a few other things… and the changes broke Photonic. What messed things up rather badly, though, was that every Client ID (API key) was by default pushed into a highly crippled “Sandbox mode”, and every level of privilege that you seek for your Client ID to move it from its Sandbox to Production requires a labyrinthine round of approval. To the best of my knowledge Instagram is the only provider with an API that does this.
Now, if every user of Photonic were to get stuck in this quagmire of requesting approvals for Instagram, they would require at least one week in addition to creating a screencast (!!) for the approval. The alternative would be to get an API key in Sandbox mode, which never returns more than 20 photos.
So I put in place a different method of displaying Instagram content. Rather than than having users get their Client IDs (in Sandbox) from Instagram, they can use mine to obtain an “Access Token”. I have outlined the procedure on the Instagram page.
I have, however, hit a hitch. Over the past 10 days I have been trying to get Instagram to approve Photonic for displaying all public content (including hashtags and locations), however they have refused. So far Photonic has only obtained “Basic” permissions, which will allow a user to display his or her own photos. But I still haven’t been successful in getting the “Public Content” permissions, which lets brands / advertisers / marketers / publishers display content by hashtags and locations. I am continuing my fight, but I am not sure if I will succeed anytime soon.
- Rewritten Picasa Integration:
My frustration with the Google’s rewrite of the Picasa API is well known. However, my rewrite of the Instagram integration switched on the proverbial light-bulb with respect to Picasa. Enter “Back-End Authentication”, or “Server-Side Authentication”. Using this approach you will be able to show your users photos that you are allowed to see, not what they are allowed to see. This has several advantages over the traditional “Front-End” or “Client-Side” authentication. I have explained this in-depth on the Picasa documentation page. This completely eliminates the restrictions imposed by the Picasa API around private and protected albums.
The Picasa rewrite has introduced a couple of new parameters for the Picasa shortcode, namely
protection. Again, these are explained in the documentation page.
- Lazy Loading Flickr Collections
Flickr’s Collections API is very inefficient, causing long load times if you have many albums in your collections. To counter this I introduced a concept called “lazy loading” of the collections. The details are explained in the Collections documentation.
- New Lightbox – Image Lightbox
I have been considering the addition of several new lightbox scripts over the past couple of months. I finally got around to adding support for an ultra-lightweight one – Image Lightbox. The minified script is only 6KB, and it definitely looks pretty nice.
- Other Changes
- I fixed a “Headers already sent” error for password-protected Zenfolio albums.
- Swipebox in FireFox was throwing an “Event not defined” error. That has been rectified.
- I added a new “
headers” parameter for Flickr, SmugMug and Zenfolio, where the album / set / gallery / collection header display may be controlled via the shortcode. It can take a comma-separated list consisting of
counter, to show those specific elements.
Hope you enjoy the update!
At the cusp of the new year, I have released a new version of Photonic with some big, and difficult changes.
This has been a very, very difficult thing to implement. Every image in a Photonic gallery is now assigned a unique id, which, when appended to the URL, is called a deep-link. This was pretty easy to implement. But, when you open an image in a lightbox, the URL in the browser should change to reflect its id, and when you navigate using the lightbox, the URL should change to reflect the new image. And when someone opens this deep-link in a browser, it should automatically launch the image in a lightbox. This was the hard part, thanks to the different lightboxes and scenarios that I had to account for. You can control deep-linking from Photonic → Settings → Generic Options → Generic Settings → Deep Linking. That being said, a couple of things don’t work:
- I couldn’t get it working for Fancybox. But I did get it working for Fancybox2. So it works for Swipebox, PrettyPhoto, Colorbox and Fancybox2. If you are curious about using Fancybox2 as your lightbox, see this.
- If you are diplaying an album as a thumbnail, and upon clicking it, it launches a slideshow, the deep-links for the images show up in the browser. However, if you provide this link to someone, it will not automatically launch the image in a lightbox. For all other scenarios the lightbox opens up correctly.
This brings me to the next big change …
- Social Sharing
When you open a deep-link in the browser and the lightbox shows up, it will show you sharing icons for Facebook, Twitter and Google+. You can then share deep-linked image, which will let others access your photos directly. Social sharing can be controlled from Photonic → Settings → Generic Options → Generic Settings → Social media integration, and will not be active.
- Other Changes
- Another big change is the addition of “Bypass popup” support to all lightboxes supported by Photonic. Previously Photonic supported this mode in Swipebox and PrettyPhoto only, but now it is available in Fancybox, Colorbox and Fancybox2 as well. This is on by default, and you can switch it off from Photonic → Settings → Generic Options → Popup Panel → Enable Interim Popup for Album Thumbnails.
- I have added a hook,
photonic_modify_titleto apply a different title for photos.
- I have enhanced the support for Fancybox2, amongst third-party lightboxes, adding popup bypassing, thumbnail and touch gesture support.
- In case an image has no title, and lightbox linking is disabled, the plugin will now not show the “View” text in the lightbox.
- I have fixed a Smugmug bug that was causing the album headers to show up twice.
- There were Fancybox styling issues in certain themes, like Twenty Fifteen and Twenty Sixteen, which I have addressed.
- A while back Smugmug had introduced some new image sizes – I have got them added to the options.
Deep-linking and Social Media Integration is only available in expensive premium lightboxes, so I am happy to be able to bring this to you for free.
Hope you like this release, and have a Great New Year!
As outlined in my previous post, I updated Photonic to use the latest version of Smugmug’s API, v2. Apparently this causes your API keys to stop working unless you provide some authorization. Don’t worry – it is a lot easier than it sounds. This is what you do:
- Login to your Smugmug account.
- Go to the API Terms of Service at https://api.smugmug.com/api/developer/accept.
- You will be presented with this screen:
- If you accept the terms of service, select the two checkboxes and click “Accept”.
That’s it. You should be good to go! Please let me know if it doesn’t work.
It has been such a long time since I released a Photonic update! In fact, this is my first WP contribution in a long time.
As per my original plan I intended to replace JQuery Cycle in Photonic and Suffusion at the same time with JQuery Cycle 2, and I had started making the changes. But with Suffusion being pulled from the repository in June, updating Photonic would cause a software incompatibility. So I had to reverse all the JQuery Cycle 2 changes, and focus on newer things. As a result this ended up being a big update.
These are the changes I put in:
- Smugmug Updates
- Quite some time back Smugmug declared v1.3 of its API deprecated. So I updated the code to use to version 2 of the Smugmug API. This was a herculean undertaking, as I had to go through a long process to ensure that things were not broken. Things had changed fundamentally between the two versions, and I spent several days working with Smugmug support to ensure smoother integration with WP. Eventually it got done. This resulted in improved performance, and better support of titles, captions and highlight images.
- As a direct consequence of the above, you now only require the
album_keyinstead of both, the
album_key. See the Smugmug Photos page for details. Your existing shortcodes will work, though.
- I added full support for password-protected albums in Smugmug. To see an example go to the Smugmug Albums page and try opening the Bushveld album with the password Saffa.
- I added more information to the Smugmug Helper (Photonic → Helpers). If you are authenticated it will show you album information for password-protected albums as well.
- Note that if you are using Smugmug authentication, you will need to define a Callback URL for your API key. This wasn’t a requirement earlier.
- Zenfolio Updates
- Picasa / Google Photos
Unfortunately here it is not all good news. One of the reasons I restarted work on Photonic was that Google had moved away from PicasaWeb. It turns out that the move has been rather draconian. They have made it impossible to make a new, public album in Google without third-party APIs or lengthy workarounds, they have completely killed the
authkeyoption that existed in Picasa, and they have made sure that the new “Share URL” option for albums only works for authenticated users. In short, they have adopted a Facebook-style photo-sharing approach rather than their more robust competitors, Smugmug, Zenfolio and Flickr.
They had also made it impossible to determine album ids easily, for which I added a solution. I introduced a Picasa Helper (Photonic → Helpers) that is capable of listing out all your album ids.
- Miscellaneous Changes
- For Flickr / Smugmug / Picasa / 500px, I added a
filterattribute to the shortcode, which lets you pass a comma-separated list of Albums / Photosets / Galleries / Collections for which thumbnails should be displayed, rather than the entire list of such entities. You can see examples on most of the help pages, e.g. Smugmug Albums.
- A rather minor thing, but I added a “loading wheel” that would show up while the images on your site were rendering.
- For Flickr / Smugmug / Picasa / 500px, I added a
That’s about it. Do let me know what you think of this update.
I have released version 1.56 of Photonic. This version has the following changes:
- You can now get a “slide-up” style title for all your thumbnails, in addition to the JQuery Tooltip and other options that you have.
- I removed some syntax that was causing the plugin to break installations with PHP versions 5.3 or below. If problems persist, please let me know and I will take a look.
- I have made a small change to ensure that Picasa photos are pulled from an
httpslink instead of
http. This will ensure that the plugin works for Picasa even when the WP installation has SSL.
I learnt today that Google is shutting down Picasa (both, Web and Desktop) in favour of Google Photos. This isn’t good news. They haven’t provided any information regarding API changes, and given the challenges we have had with
authkey settings and the differences between album protection of PicasaWeb and Google Photos, I can only surmise the level of difficulty I am going to face in making things work once Picasa is gone for good. Google has currently provided a date of 1st May 2016. Let’s hope they at least do a good job of the API updates before then. In the meanwhile, do let me know if your Picasa albums suddenly stop working.
Version 1.55 of Photonic is now live. The following are the changes:
- Earlier, password-protected albums on Smugmug would display only for authenticated users. Now, if you simply pass the
passwordattribute, your album will display.
- The Smugmug module now supports the
site_passwordattribute as well.
- Translations are now officially supported via the WordPress site for the plugin.
- There were often complaints about the popup dialog that used to show up for images was not working correctly. Moreover it was fixed width, and did not do well with mobile devices. So I replaced it with a largely self-authored modal script (based on the animatedModal.js script), which changes this to more of an overlaid panel rather than a popup. Since it took less than a day of coding I am surprised I didn’t do it earlier. The following are the highlights of the current popup:
- The width is no longer given in pixels, but it takes a percentage. By default the popup will be at 80% of the window width.
- Earlier the popup used to display multiple “screens”. That has been done away with, entirely. All images show up in the same screen now, and you have the ability to scroll down to view them.
- By using my own modal script I was able to significantly optimize the overall JS (about a 30% reduction in its size).
Let me know if you encounter any issues.
I have just released version 1.54 of Photonic. This is a minor version with the following changes:
- While adding the support for
authkeyfor Picasa albums I had forgotten to add this in the shortcode generator. This has been remedied.
- I added the “Text Domain” tag to the theme’s readme file. This makes it possible for contributors to do translations directly on wordpress.org.
I also submitted a small updated to Suffusion, mainly to correct some issues on responsive layouts. That hasn’t been approved yet, but should be, hopefully soon.
I just released version 1.53 of Photonic. This is a pretty small release with a couple of big new additions:
- You now have the option to use Photonic’s lightbox for non-Photonic images. Bye bye, standalone lightbox plugins!
- One oft-requested feature had been the support for displaying Picasa albums with an access key. This is now available by means of the additional
authkeyparameter for the Picasa invocation. Note that Google Photos doesn’t have a public API, and the old Picasa API remains. If you have created an album in Google Photos, you cannot directly use its ID in the plugin. But you can go to your PicasaWeb account, and see the newly created album listed there. You will also notice that PicasaWeb offers 2 options for “Limited” sharing – restricted albums from Google Photos show up as “Limited”, while the classical PicasaWeb option of “Limited, anyone with the link” still exists. You will need to change the album’s security settings to “Limited, anyone with the link”, unless you want to make it public. You can then use the
authkeyparameter to show the album using Photonic, by including the secret authorization key provided by Google.
- There was an obscure issue that was resultant from having a “.” in the id of a gallery. I have addressed this, thanks to some very handy tips provided in the WP support forum.