PluginProbe
Photonic Gallery & Lightbox for Flickr, SmugMug & Others / 2.21
Photonic Gallery & Lightbox for Flickr, SmugMug & Others v2.21
3.36 3.35 3.34 3.33 2.19 2.20 2.21 2.22 2.23 2.24 2.25 2.26 2.27 2.28 2.29 2.30 2.31 2.32 2.33 2.34 2.40 2.41 2.42 2.43 2.44 All 141 releases
photonic / readme.txt

readme.txt in Photonic Gallery & Lightbox for Flickr, SmugMug & Others 2.21, at readme.txt

737 lines 46.9 KB
No matching file
Up and down to move Enter to open Esc to close
Raw Download Zip
1 === Photonic Gallery & Lightbox for Flickr, SmugMug, Google Photos, Zenfolio and Instagram ===
2 Contributors: sayontan
3 Donate link: https://aquoid.com/plugins/photonic/
4 Tags: flickr, google photos, smugmug, zenfolio, instagram, gallery, lightbox, responsive, gestures, colorbox, fancybox, lightcase, lightgallery, magnific, photoswipe, prettyphoto, swipebox, strip, slideshow, deeplinking, social
5 Text Domain: photonic
6 Requires at least: 4.8
7 Tested up to: 5.1
8 Requires PHP: 5.5
9 Stable tag: trunk
10 License: GPLv3 or later
11
12 Galleries on steroids! A stylish lightbox & gallery plugin for WP, Flickr, SmugMug, Google Photos, Zenfolio & Instagram photos and videos.
13
14 == Description ==
15
16 Photonic takes the WordPress gallery and super-charges it with a lot of added functionality. It adds support for several new sources and parameters to enhance the content and look-and-feel of your galleries. It supports <a href='https://flickr.com'>Flickr</a> photos, Albums (Photosets), Galleries and Collections, along with <a href='https://photos.google.com/'>Google Photos</a> photos and albums, <a href='https://smugmug.com'>SmugMug</a> folders, albums and images, <a href='https://zenfolio.com'>Zenfolio</a> photos, Photosets and Groups, and <a href='https://instagram.com'>Instagram</a> photos. You can also set up authentication so that visitors can see private and protected photos from each provider.
17
18 When used without the Gutenberg editor Photonic by default overrides the <code>gallery</code> shortcode. In case you happen to be using a theme or plugin that already overrides the <code>gallery</code> shortcode, Photonic provides you with the option to use your own shortcode for Photonic galleries. This lets your plugins coexist. Bear in mind that if you deactivate Photonic you will have to remove all instances of this custom shortcode, something that is not required if you stick to the <code>gallery</code> shortcode.
19
20 When used with Gutenberg Photonic creates no shortcodes, rather it creates blocks. If some of your posts were written with Gutenberg and some without, Photonic supports both scenarios.
21
22 = Lightboxes =
23
24 Photonic has built-in support for commonly used lightbox scripts such as:
25
26 * <a href='http://www.jacklmoore.com/colorbox/'>Colorbox</a>
27 * <a href='http://fancybox.net/'>Fancybox</a>
28 * <a href='http://fancyapps.com/fancybox/'>Fancybox2</a> - not GPL, so the script is not included with the plugin. See the <a href='https://aquoid.com/plugins/photonic/third-party-lightboxes/'>Lightboxes</a> page for details
29 * <a href='https://fancyapps.com/fancybox/3/'>Fancybox3</a>
30 * <a href='https://noelboss.github.io/featherlight/'>Featherlight</a>
31 * <a href='https://osvaldas.info/image-lightbox-responsive-touch-friendly'>Image Lightbox</a>
32 * <a href='http://cornel.bopp-art.com/lightcase/'>Lightcase</a>
33 * <a href='https://sachinchoolur.github.io/lightGallery/'>Lightgallery</a>
34 * <a href='http://dimsemenov.com/plugins/magnific-popup/'>Magnific Popup</a>
35 * <a href='http://photoswipe.com/'>PhotoSwipe</a>
36 * <a href='http://www.no-margin-for-errors.com/projects/prettyphoto-jquery-lightbox-clone/'>PrettyPhoto</a>
37 * <a href='http://brutaldesign.github.io/swipebox/'>Swipebox</a>
38 * <a href='http://www.stripjs.com'>Strip</a> - not GPL, so the script is not included with the plugin. See the <a href='https://aquoid.com/plugins/photonic/third-party-lightboxes/'>Lightboxes</a> page for details
39 * Thickbox
40
41 Non-GPL alternatives like <a href='http://fancyapps.com/fancybox/'>Fancybox2</a> and <a href='http://www.stripjs.com'>Strip</a> are supported, provided you install the scripts yourself. With the exception of Thickbox the lightboxes have been adapted to become touch and gesture-friendly. See the <a href='https://aquoid.com/plugins/photonic/third-party-lightboxes/'>Lightboxes</a> page for details.
42
43 = Flickr Support =
44
45 The following Flickr concepts are supported in Photonic:
46
47 * <a href='https://aquoid.com/plugins/photonic/flickr/flickr-photos/'>Photos</a>
48 * <a href='https://aquoid.com/plugins/photonic/flickr/flickr-photosets/'>PhotoSets (Albums)</a>
49 * <a href='https://aquoid.com/plugins/photonic/flickr/flickr-galleries/'>Galleries</a>
50 * <a href='https://aquoid.com/plugins/photonic/flickr/flickr-collections/'>Collections</a>
51 * <a href='https://aquoid.com/plugins/photonic/flickr/flickr-photo/'>Single Photo</a>
52 * <a href='https://aquoid.com/plugins/photonic/flickr/flickr-authentication/'>Authentication</a>
53
54 For demos of Flickr support visit the <a href='https://aquoid.com/plugins/photonic/flickr/'>Flickr page</a>.
55
56 = Google Photos Support =
57
58 The following Google Photos concepts are supported in Photonic:
59
60 * <a href='https://aquoid.com/plugins/photonic/google-photos/photos/'>Photos</a>
61 * <a href='https://aquoid.com/plugins/photonic/google-photos/albums/'>Albums</a>
62
63 For demos of Google Photos support visit the <a href='https://aquoid.com/plugins/photonic/google-photos/'>Google Photos page</a>. Note that the Google has released the API in a <a href='https://developers.google.com/photos/library/guides/api-limits-quotas'>"Developer preview" mode</a>, so there are some restrictions around usage.
64
65 = SmugMug Support =
66
67 The following SmugMug concepts are supported in Photonic:
68
69 * <a href='https://aquoid.com/plugins/photonic/smugmug/smugmug-tree/'>User Tree</a>
70 * <a href='https://aquoid.com/plugins/photonic/smugmug/smugmug-photos/'>Photos</a>
71 * <a href='https://aquoid.com/plugins/photonic/smugmug/smugmug-albums/'>Albums</a>
72 * <a href='https://aquoid.com/plugins/photonic/smugmug/folders/'>Folders</a>
73
74 For demos of SmugMug support visit the <a href='https://aquoid.com/plugins/photonic/smugmug/'>SmugMug page</a>.
75
76 = Zenfolio Support =
77
78 The following Zenfolio concepts are supported in Photonic:
79
80 * <a href='https://aquoid.com/plugins/photonic/zenfolio/photos/'>Photos</a>
81 * <a href='https://aquoid.com/plugins/photonic/zenfolio/photosets/'>PhotoSets (Galleries and Collections)</a>
82 * <a href='https://aquoid.com/plugins/photonic/zenfolio/groups/'>Groups</a>
83 * <a href='https://aquoid.com/plugins/photonic/zenfolio/group-hierarchy/'>Group Hierarchies</a>
84
85 For demos of Zenfolio support visit the <a href='https://aquoid.com/plugins/photonic/zenfolio/'>Zenfolio page</a>. Note that authenticated content in Zenfolio is not currently supported.
86
87 = Instagram Support =
88
89 Instagram photos <a href='https://aquoid.com/plugins/photonic/instagram/'>are supported in Photonic</a>. You can display your own feed, and photos based on tags, and location-based searches. Note that while code has been written to support tags and locations, Instagram hasn't approved Photonic's access to others' photos. This means that currently only displaying one's own feed will work.
90
91 = Enhanced Native Galleries =
92
93 Your existing gallery insertions are left intact. However you can add a <code>style</code> parameter to a native gallery to open it up to Photonic. The <code>style</code> parameter can take any of the values documented on the <a href='https://aquoid.com/plugins/photonic/layouts/'>Layouts</a> page.
94
95 = 500px Support - Historical =
96
97 Photos and Galleries (a.k.a. Collections, a.k.a. Sets) on <a href='https://aquoid.com/plugins/photonic/500px/'>500px.com are supported in Photonic</a>, but 500px.com has <a href='https://support.500px.com/hc/en-us/articles/360002435653-API-'>shut down its API access with effect from 15th June 2018</a>. The code has been left in the plugin in case 500px.com revives the API, but for now, 500px.com is not supported.
98
99 = Video Support =
100
101 Photonic provides gallery and lightbox support for <a href='https://aquoid.com/plugins/photonic/videos/'>videos as well</a>. Videos of the following sorts are supported:
102
103 * External videos from YouTube or Vimeo can be opened in any of the lightboxes apart from Image Lightbox or Thickbox
104 * Self-hosted or external videos in MP4 formats can be opened in any of the lightboxes apart from Image Lightbox, PrettyPhoto, Strip or Thickbox
105 * Videos hosted by external service providers (Flickr, Google etc.) can be opened as a part of a gallery in any of the lightboxes apart from Image Lightbox, PrettyPhoto, Strip or Thickbox. Some lightboxes have issues with specific features. Please refer to the <a href=''>Lightboxes</a> documentation for more.
106
107 = Deep-Linking and Social Sharing =
108
109 Photonic provides deep-linking support for non-WP images, and by extension, supports social sharing to Facebook, Twitter, Google+ and Pinterest.
110
111 = Beautiful Layouts =
112
113 Photonic displays your galleries either as a grid of square thumbnails (the default), or circular thumbnails (like Jetpack), or random tiles in a justified grid, or a masonry layout, or a random mosaic (a much improved variant of the Jetpack Tiled Gallery layout), or a slideshow. See the <a href='https://aquoid.com/plugins/photonic/layouts/'>Layouts</a> page for details.
114
115 = Interactive Editing =
116
117 The WordPress editor shows up with a button that says "Add / Edit Photonic Gallery". Clicking on it will show you the different types of galleries you can work with.
118
119 = Gutenberg Support =
120
121 With effect from version 2.10 Photonic is Gutenberg-capable. There are some steps you might need to take to migrate your existing galleries. Please refer to the <a href='https://aquoid.com/plugins/photonic/gutenberg-support/'>documentation</a>.
122
123 == Installation ==
124
125 You can install the plugin through the WordPress installer under <strong>Plugins &rarr; Add New</strong> by searching for "Photonic", or by uploading the file downloaded from here.
126
127 Alternatively you can download the file from here, unzip it and move the unzipped contents to the <code>wp-content/plugins</code> folder of your WordPress installation. You will then be able to activate the plugin.
128
129 Once you have activated the plugin, refer to <em>Photonic &rarr; Getting Started</em> for a list of capabilities and documentation.
130
131 == Screenshots ==
132
133 For the plugin in action see the <a href='https://aquoid.com/plugins/photonic/'>plugin page</a>.
134
135 1. If you are using Gutenberg look for the "Photonic" block
136 2. If you are not using Gutenberg insert the shortcode for Photonic through the Media Uploader by clicking "Add Media", or click on "Add / Edit Photonic Gallery".
137 3. Clicking on the Gutenberg block, or on "Add / Edit Photonic Gallery" shows up an interactive flow for you to build out your gallery.
138 4. The interactive flow shows you the options available and helps construct the gallery easily.
139 5. If you click on "Add Media" you will see a new tab for "Photonic". This is not available for Gutenberg.
140 6. Clicking on the "Photonic" tab will show you new tabs, one for each type of gallery. Fill out what you need and click "Insert into post".
141 7. The gallery placeholder shows up in the "Visual Editor" or in the Gutenberg editor. Each provider's placeholder is designated by its logo.
142 8. Clicking on the placeholder lets you edit the attributes of the shortcode if Gutenberg is not being used and the interactive workflow is disabled.
143 9. An example of the "Random Justified Gallery" layout.
144
145 == Frequently Asked Questions ==
146
147 = If I disable the plugin what happens to the galleries? =
148
149 Obviously, your galleries will not show. If you are using Gutenberg you don't have to worry about anything. If you are not using Gutenberg and you are using the native <code>gallery</code> shortcode, you will not see any empty shortcode tags on your site. But if you are not using Gutenberg and you are using a custom shortcode that shortcode tag will now show up.
150
151 = When I click on a gallery in the Visual Editor nothing happens. Is the plugin working? =
152
153 Yes, the plugin is working. Unfortunately the integration of Photonic with the visual editor is complex, and there is a likelihood of conflicts with other TinyMCE-specific plugins. If you come across such a conflict, please report it on the support forum. In the meanwhile you can disable the visual editing capability of Photonic (<em>Photonic &rarr; Settings &rarr; Generic Options &rarr; Generic Settings &rarr; Disable shortcode editing in Visual Editor</em>) and you should still be able to edit the gallery shortcode directly through the text editor.
154
155 = My gallery layout seems to get messed up with random text showing up at various places. Are you sure the plugin is working? =
156
157 Yes, the plugin is working. The issue you are facing is that you have another plugin (typically some sort of a lightbox plugin) that is modifying the markup generated by Photonic.
158
159 Of course, it would be easiest if you were to disable that plugin. If a lightbox is all you need, Photonic's lightbox can be used to display regular photos as well, from your admin dashboard under <em>Photonic &rarr; Settings &rarr; Generic Options &rarr; Generic Settings &rarr; Photonic Lightbox for non-Photonic Images</em>. This will ensure consistency across Photonic and non-Photonic images.
160
161 However, if you really wanted to keep that plugin, Photonic offers a way out there too! For each provider (e.g. Flickr, Google Photos etc.) go to the Settings page, e.g. <em>Photonic &rarr; Settings &rarr; SmugMug &rarr; SmugMug Settings &rarr; Disable lightbox linking</em> and set that option.
162
163 = I upgraded, and now my SmugMug galleries won't show. Are you really sure the plugin is working? =
164
165 Yes, the plugin is working. Here is what happened: version 1.57 of Photonic moved from API v1.3 of SmugMug to API v2. Your API keys probably were created for v1.3 and need to be authorized for v2. See <a href='https://aquoid.com/2016/12/smugmug-access-in-photonic-1-57/'>here</a> for instructions.
166
167 = Does the plugin support Picasa? =
168
169 Not with effect from January 2019, when Google terminated the Picasa API. It does support Google Photos though. See the <a href='https://aquoid.com/plugins/photonic/google-photos/'>documentation pages</a> for instructions.
170
171 = Does the plugin support 500px.com? =
172
173 The plugin has code to support 500px.com, however 500px.com has shut down its API access with effect from mid June 2018, so you will not be able to obtain an API key for it, and if you have an API key already, it will have stopped working.
174
175 = What about other photo-sharing platforms? =
176
177 Suggestions are welcome for other photo-sharing platforms.
178
179 = What about other JS libraries? =
180
181 Currently Colorbox, Fancybox, Fancybox3, Featherlight, Image Lightbox, Lightcase, Lightgallery, PrettyPhoto and Swipebox are supported. Inbuilt support is also present for the non-GPL Fancybox2 and Strip. Both lighter and heavier alternatives are being considered. If you have specific suggestions please feel free to contact the plugin author.
182
183 Note that there have been slight modifications to some of the above scripts to make them interact seamlessly with JQuery tooltips.
184
185 = Are there any known issues? =
186
187 As explained in the "Description", the Instagram API has been coded to support hashtags and locations, but Instagram itself has not provided Photonic access to those features.
188
189 Also, the TinyMCE integration for the plugin is complex, predominantly since Photonic doesn't rely on a separate shortcode. This can cause potential conflicts with other plugins. If such a situation arises, please report it in the <a href='https://wordpress.org/support/plugin/photonic/'>Support Forum</a>, and disable the visual editor capability for the shortcode by specific post-types (<em>Photonic &rarr; Settings &rarr; Generic Options &rarr; Generic Settings &rarr; Disable Visual Editing for specific post types</em>). If that doesn't work, you can go thermonuclear on Photonic's visual editing (<em>Photonic &rarr; Settings &rarr; Generic Options &rarr; Generic Settings &rarr; Disable shortcode editing in Visual Editor</em>) - you will still be able to edit the shortcode using the Text Editor in WordPress.
190
191 The "Mosaic" layout may sometimes show 1px wide gaps betweeen images if you set the padding between images to 0. This happens due to rounding errors in the height and width calculations. To avoid this, it is recommended that you use a padding &gt; 0 between images for this layout.
192
193 Apart from these, while the plugin can handle pretty much whatever you throw at it, Lubarsky's Law of Cybernetic Entomology states:
194 <blockquote>There is always one more bug.</blockquote>
195
196 Bug reports are welcome, and handled enthusiastically.
197
198 = Are translations supported? =
199
200 Yes, but only for the plugin front-end and the interactive workflow. The admin panel is not translated at this point. Also note that any strings included in the third-party JS scripts are not translated.
201
202 == Changelog ==
203
204 = 2.21 =
205
206 * Added logic to conditionally load JavaScript only on pages where Photonic is being invoked
207 * Replaced the jQuery UI Dialog script (used for password prompting) with a much smaller library (ModaliseJS) with no jQuery dependency
208 * Replaced the jQuery UI Tooltip script with a 2KB custom, no jQuery tooltip script
209 * Added support for Enhanced Media Library
210 * Fixed a mosaic layout bug that was causing the last row on smaller viewports to not render properly
211 * Fixed an issue with the Interactive Shortcode Builder not being able to process authenticated SmugMug calls
212 * Fixed a bug where Colorbox was not showing the lightbox for non-Photonic images
213 * Fixed a bug where on slow connections with the title being displayed below the photos, users were seeing a narrow, tall column of text
214
215 = 2.20 =
216
217 * Fixed an issue that was causing a fatal error on versions of PHP older than 5.5
218 * Fixed an issue where the <code>video_size</code> attribute, if passed to a collection of albums, was not being propagated to the photos within each album.
219
220 = 2.19 =
221
222 * Picasa is now deprecated, so support for it in the plugin has been removed
223 * Added support for the Gutenberg block "wide-alignment" and "full-width" options
224 * Added a <code>photonic_helper</code> utility shortcode
225 * The block-builder also shows the equivalent shortcode at the bottom for users who are facing Gutenberg conflicts or want to use a shortcode
226 * The <code>main_size</code> option was being ignored for the native galleries in favour of <code>slide_size</code>
227 * Escaped all translated strings appropriately
228 * The more button was not showing up on some OS configurations due to EOL character mismatches
229 * Performance tracing was causing native WP galleries to not show up
230 * Removed option to link photos for Google as all access is for private photos - "View" link is always erroneous
231 * Added an "end" element to the galleries, to enable linking to the end of the gallery
232 * Added PHP and extension info to the "Getting Started" page
233 * Added a <code>tile_size</code> option to Instagram
234 * Added PHP 7.3 compatibility
235 * Added a hover overlay icon for videos for Instagram, Flickr and SmugMug
236 * Fixed an issue where the slideshow layout was not respecting the <code>strip-above</code> option
237 * Removed the requirement for an API key for SmugMug - SmugMug users will require an API key only if they want to display private photos
238 * Fixed an "empty space" issue occurring for Safari with the masonry layout
239 * Fixed a bug with PhotoSwipe and the justified grid layout, which was causing the lightbox to show a different image than the one clicked
240 * Fixed a bug with PhotoSwipe and StripJS where the looping setting was not being respected
241 * Added options to disable loading of Photonic's scripts in case a theme / plugin supplies them
242 * Switched to minified versions of all JavaScript files; can be controlled by options
243 * Renamed translation file to photonic.pot from photonic.po
244
245 = 2.17 =
246
247 * Private albums for Flickr and SmugMug were not showing up in the interactive shortcode builder
248 * Resolved Divi conflict with Visual Editor, and in Text editor the WP media library gets pushed behind
249
250 = 2.16 =
251
252 * Zenfolio photosets with "smart" names were not being pulled up correctly
253 * Using <code>title_position='none'</code> was not disabling the title
254 * Masonry layout was not respecting the column count for level 2 displays
255 * Minor changes to ensure that the hints in the flow editor are showing up only when required
256 * Pinterest share now opens in a new window
257
258 = 2.15 =
259
260 * Added a filtering capability on the shortcode insertion screens
261 * Fixed a JS error that was showing up on clicking on "Add / Edit Photonic Gallery" button
262 * Added the ability to provide the thumbnail size for Instagram in the shortcode builder
263
264 = 2.14 =
265
266 * Fixed "disableShrink" behaviour for Lightcase.
267 * Fixed Fancybox3 social media linking issues
268 * Fixed a flickering issue for PhotoSwipe on mobiles
269 * Fixed a bug where Flickr collections were not showing nested collections in some scenarios
270
271 = 2.13 =
272
273 * Fixed a bug where the interactive flow was replacing the "Tile size" for WordPress galleries with a "Thumb Size"
274 * Fixed a bug where gallery transitions within Fancybox3, PrettyPhoto and StripJS galleries were not working
275 * Added a capability to check if the current user can edit posts before showing the interactive flow
276 * Added several new options to the lightbox configurations
277
278 = 2.12 =
279
280 * Added support for Magnific Popup
281 * Fixed an issue with LightSlider slideshows not going the full-width in specific cases
282 * Fixed a bug with the interactive flow that was causing a JS error for WP galleries if starting a new gallery
283 * Split out the lightbox options to their own tab
284 * Added multiple customization options to the lightboxes
285 * Added a capability to launch a lightbox from a slideshow for LightGallery and Magnific
286 * Added an option to remove the photo count from Google Album displays
287
288 = 2.11 =
289
290 * Optimized and modularized JavaScript by separating out each lightbox script
291 * Flickr photsets in a collection were losing their order due to parallel calls - now fixed
292 * Instagram Masonry layout was hardcoding image sizes and not working properly
293 * Fixed an issue in the interactive workflow that was causing a fatal error for PHP versions < 5.5
294 * Modified the Flickr photo display link to be more "specific". E.g. if a photo is in an album its link in Flickr will be specific to that album instead of the user's photostream
295
296 = 2.10 =
297
298 * Added Gutenberg compatibility
299 * Added a "Shortcode replacement" capability to prepare for Gutenberg. See <em>Photonic &rarr; Prepare for Gutenberg</em>
300 * Fixed a bug that was causing the default album search by user to fail for SmugMug
301 * The <code>layout='strip-above'</code> setting was not working for the slideshow layouts. This has been corrected
302 * Added new "Advanced" settings under "Generic Options". Moved SSL and performance logging options there.
303 * Added new options to increase the cURL timeout and to enable debug logging for troubleshooting, under the "Advanced" section
304 * Replaced Flickr collection-fetching with parallel calls
305
306 = 2.02 =
307
308 * Minor patch for Interactive Workflow z-index issue
309
310 = 2.01 =
311
312 * Added support for PhotoSwipe
313 * Addressed an Instagram change that was preventing higher resolution images from being displayed.
314 * Removed the explicitly defined Instagram sizes for 1080px and replaced them with a "Largest" option to automatically pull the largest available image
315 * Fixed a bug that was not respecting the sort order for SmugMug
316
317 = 2.00 =
318
319 * Added a new workflow-type button, "Add / Edit Photonic Gallery" to create Photonic galleries
320 * Introduced a "Default user" feature for Flickr, SmugMug, Picasa and Zenfolio. This is used if a user is not specified. For Instagram the authenticated user is used by default and Google supports only the authenticated user
321 * Added "search" capability for images in SmugMug albums, folders and for users by text and keywords
322 * User id is no longer required for Instagram photos. The authenticated user is used
323 * Added support for Zenfolio authentication
324 * Added support for user-specific text / category searches for Zenfolio photosets
325 * Added support for <code>photoset_type</code> (Gallery / Collection) for user-specific photosets in Zenfolio
326 * Added support for <code>kind</code> (Recent / Popular) for user-specific photosets in Zenfolio
327 * Added filter capability for Zenfolio photosets
328 * Switched Zenfolio call from HTTP to HTTPS
329 * Added <code>tile_size</code> support to native WP galleries
330 * Changed Flickr "download" URL to reflect the full-size original image
331 * Added capability to disable visual editing by post type
332 * Fixed a bug that was causing a "short term cache" for an authenticated Google account, resulting in erroneous photos if the account was switched
333 * If a video is added to a native WP gallery via third party plugins such as Media Library Assistant, Photonic can now display it as a part of the gallery and play the video in a lightbox
334 * Switched Masonry to use the script bundled natively with WP
335 * Added capability to track performance for each gallery (disabled by default)
336 * Added option to disable SSL verification on local sites
337 * There was an issue where, in the "Random Justified Gallery" layout, there was a visible "pop and realign" happening whenever the "Load More" button was being clicked. This has now been addressed
338
339 = 1.68 =
340
341 * Added support for the new Google Photos API. The Google Photos module of Photonic coexists with the older Picasa module. Please refer to the <a href='https://aquoid.com/plugins/photonic/google-photos/'>documentation</a> for further details
342 * Added capability to "show more" albums. Passing the <code>count</code> and <code>more</code> attributes allows pagination of albums
343 * Added capability to paginate and "show more" in the overlaid popup window. Passing the <code>photo_count</code> and <code>photo_more</code> attributes allow this when the overlaid popup is enabled
344 * Fixed an issue that was causing the photos of albums to not display if the global layout option was set to one of the slideshow options
345 * Updated Featherlight to latest version
346
347 = 1.67 =
348
349 * Fixed an issue with Instagram where not all recent media was displaying
350 * Fixed an issue where a lightbox / interim popup launched from a Flickr album thumbnail capped off at 100 photos
351
352 = 1.66 =
353
354 * Added video support for Flickr, Picasa / Google, SmugMug, Zenfolio and Instagram, plus videos from YouTube or Vimeo, plus standalone, locally hosted MP4 files
355 * Added support for the <a href='https://fancyapps.com/fancybox/3/'>Fancybox3</a> lightbox
356 * Added thumbnails to the Picasa and SmugMug helpers for easier identification
357 * Added a <code>structure</code> option to the Zenfolio shortcode so that photosets can be shown without being grouped
358 * Fixed a bug where the shortcode insertion script was not printing the alternative shortcode
359 * Fixed a bug where, for the alternative shortcode being used with a native WP gallery, the <code>ids</code> parameter was not being respected
360 * Fixed a bug where the archive-view thumbnail limit was not working for the home page
361 * Updated LightGallery scripts to latest version
362 * Corrected instructions for Picasa redirect URLs
363 * Scrapped support for 500px.com because its <a href='https://support.500px.com/hc/en-us/articles/360002435653-API-'>API has been shut down with effect from 15th June 2018</a>
364 * Random Justified Grid was setting the <code>alt</code> attribute of images to "undefined". This has been fixed
365
366 = 1.65 =
367
368 * Added back-end authentication support for Flickr, SmugMug and 500px (feature existed for Google/Picasa and Instagram)
369 * Fixed an incompatibility between themes and plugins using Bootstrap, and Photonic's use of jQuery Tooltip
370 * Added support for the <a href='http://noelboss.github.io/featherlight/'>Featherlight</a> lightbox
371 * Split out Authentication functionality to its own admin page, away from Helpers.
372 * Improved error messages
373 * Fixed a problem with the "Buy" link for SmugMug not appearing when opted for
374 * Fixed an issue where user names in 500px that had numbers at the start were not displaying photos from the correct user
375 * Streamlined the Picasa code to use native WP methods for HTTP requests
376 * Changed permissions for "Helpers" and "Getting Started" pages. These will now display for non-admins. The Authentication and Settings pages will be shown only to admin users
377 * Added support for Pinterest sharing
378 * The SmugMug folder view was dropping albums that didn't have a "Highlight image". This has been addressed to use a placeholder
379 * SmugMug folders were unable to display more than 10 albums within. This has been addressed to display up to 200 albums
380 * Fixed a bug with 500px.com categories, where categories with spaces were not being processed correctly
381 * Added a parameter called <code>filter_type</code> that takes the values <code>exclude</code> and <code>include</code> to indicate if a list of albums in the <code>filter</code> parameter should be excluded or included.
382 * Added support for images in Flickr that do not follow Flickr's documented URL structure
383 * Added a new title style to stick the title over the lower portion of a photo
384
385 = 1.64 =
386
387 * New Masonry layout, triggered by <code>layout='masonry'</code> for external galleries, and <code>style='masonry'</code> for WP galleries
388 * New Mosaic layout, triggered by <code>layout='mosaic'</code> for external galleries, and <code>style='mosaic'</code> for WP galleries
389 * Added "More" button capability to native WP galleries
390 * Added deep-linking and sharing capabilities to native WP galleries
391 * Added an option to disable lightbox linking for Native WP galleries
392 * Added support to display a folder in SmugMug, using <code>view='folder'</code>
393 * Added size options for Instagram's larger sizes, e.g. 1080x1080px
394 * Added options for "Thumbnail effects" - opacity, zoom and none
395 * Added a <code>popup</code> attribute to the shortcode, which overrides the "Bypass Popup" capability. It takes the values <code>hide</code> and <code>show</code>
396 * Added an option to auto-start slideshows in the slideshow layout
397 * Added slideshow options to the shortcode insertion script for all galleries
398 * Fixed a corner-case issue with the "random" layout: if the post-content width was being rounded up, e.g. 549.8px became 550px, some widths were not being computed correctly, causing the layout to break.
399 * Fixed a mismatched HTML tag for single-photo displays.
400 * Corrected a styling issue for the preview button in the WP editor that occurred when the back-end shortcode editor was active
401 * The SmugMug helper now also provides information about folders
402 * Fixed a bug with Image Lightbox's deep-linking, where if the same image was repeated in different galleries, the deep-link would show up from the first instance.
403
404 = 1.63 =
405
406 * Shortcode integration with TinyMCE. Placeholders show up for all galleries, and clicking them lets users update gallery properties.
407 * Added support for non-bundled lightbox, <a href='http://stripjs.com'>Strip</a>. There is deep-linking support, but social sharing doesn't work.
408 * "Download" capability for LightGallery was not working in Firefox for Picasa, SmugMug, Flickr, Zenfolio, 500px and Instagram. Fixed for Picasa, SmugMug and Flickr.
409 * Lightgallery showed a title in the lightbox even if "Show description only, even if blank" was selected. Fixed.
410
411 = 1.62 =
412
413 * Added new "Slideshow" layout for all galleries, triggered by layout values <code>strip-below</code>, <code>strip-above</code>, <code>strip-right</code>, and <code>no-strip</code>.
414 * Replaced jQuery Cycle with <a href='http://sachinchoolur.github.io/lightslider/index.html'>Lightslider</a> - responsive, touch-enabled and smaller. Lost most transition effects as a result.
415 * Modified the back-end to remove dependency on JQuery UI; different look, reduced size and load time. Streamlined Flickr options.
416 * Added new "Getting Started" page in the back-end with links to documentation.
417 * Added support for the <a href='https://sachinchoolur.github.io/lightGallery/'>Lightgallery</a> lightbox script.
418 * Added <code>controls</code> as an option for native WP galleries displayed as slideshows - shows "Previous" and "Next" buttons on the slideshow.
419 * Added <code>caption_control</code> as an option for native WP galleries displayed as slideshows - shows the image caption at the bottom of the slideshow.
420 * Added <code>caption</code> as an option for all galleries - helps pick the photo title or description / caption to display.
421 * Added <code>thumb_size</code> and <code>main_size</code> options to all shortcodes. This overrides the settings in the back-end for individual providers.
422 * Added Circular thumbnails option for WP gallery layouts
423
424 = 1.61 =
425
426 * Fixed an issue that was causing the Flickr API to fail for old versions of PHP.
427
428 = 1.60 =
429
430 * Added a "Load More" feature to shortcodes that display images.
431 * Added capability to display a selected number of photos from SmugMug albums.
432 * Added support for the <a href='http://cornel.bopp-art.com/lightcase/'>Lightcase</a> lightbox. Optimized CSS and fonts to reduce file sizes.
433 * Fixed a bug with "Image Lightbox" wherein if interim popups were enabled, clicking on an image in the interim popup wouldn't show the lightbox.
434
435 = 1.59 =
436
437 * Fixed a "Headers already sent" error for password-protected Zenfolio albums displayed "in page".
438 * Fixed an "Event not defined" error with Swipebox on FF.
439 * Added support for <a href='https://osvaldas.info/image-lightbox-responsive-touch-friendly'>Image Lightbox</a>.
440 * Rewrote the Instagram extension, which was broken due to API changes. Multiple changes, now authentication happens in the back-end, but users require an "access token", which can be obtained from <em>Photonic &rarr; Helpers</em>
441 * Due to Instagram API changes, some features such as popular photos, follows and followed-by capabilities have been removed.
442 * Added options for lazy-loading of Flickr Collections.
443 * Added a new "headers" parameter for Flickr, SmugMug and Zenfolio, where the album / set / gallery / collection header display may be controlled via the shortcode.
444 * Added a new "Back-End Authentication" mode for Picasa / Google Photos to support the Google Photos API.
445
446 = 1.58 =
447
448 * Added deeplinking support if Swipebox, Colorbox, PrettyPhoto, or Fancybox2 (not Fancybox) are the lightbox libraries. Nested deep-links currently show the correct album, but cannot open the correct image within.
449 * Added social sharing support for Facebook, Twitter and Google+ for the above-mentioned lightboxes.
450 * Fixed a SmugMug bug that was causing the album headers to show up twice.
451 * Added a hook, <code>photonic_modify_title</code> to apply a different title for photos.
452 * Fixed Fancybox styling issues for certain themes
453 * Enhanced Fancybox2 support: added support for "Bypass popup", thumbnail and button helpers, and touch gestures
454 * Added "Bypass popup" support for all included lightboxes, on by default
455 * Added new SmugMug sizes to the backend options
456 * In case an image has no title, and lightbox linking is disabled, the plugin will now not show the "View" text in the lightbox
457
458 = 1.57 =
459
460 * Changed the SmugMug code to point to version 2 of the API, resulting in better performance, and improved support of titles, captions and highlight images.
461 * Changed the format of the <code>album</code> parameter of the shortcode. It now requires only the album key. The older format still works, though.
462 * Added new capability to support clicking of password-protected and authenticated albums in SmugMug
463 * Added new capability to support clicking and display of password-protected albums in Zenfolio
464 * Added new helper for Picasa to fetch Google Photos / Picasa album ids.
465 * Added a "filter" option for the shortcode to allow for displaying selected albums / photosets / galleries / collections for Flickr, SmugMug, 500px and Picasa
466 * Added a "loading" wheel to show that images are loading on the front-end.
467
468 = 1.56 =
469
470 * Removed syntax that was causing errors in PHP versions <= 5.3.
471 * Made a correction to the Picasa processor to support https in all cases. Previously https was being used only for authenticated users.
472 * Added a new title style - slides up from the bottom upon hovering on a thumbnail.
473
474 = 1.55 =
475
476 * Fixed a password-protection issue for SmugMug albums. Earlier password-protected albums would display only for authenticated users. Now, just passing the <code>password</code> attribute works.
477 * Added support for <code>site_password</code> for SmugMug.
478 * Changed <code>load_textdomain</code> to <code>load_plugin_textdomain</code>.
479 * Replaced older fixed width popup panel with a responsive popup panel.
480 * Removed options for displaying a fixed number of images per screen in the popup panel.
481
482 = 1.54 =
483
484 * Changed the "gestures" script from TouchSwipe to TouchWipe, saving over 10KB of JS. The option to enable touch is now removed, as it is included by default for all libraries.
485 * Added the "authkey" option to the shortcode generation script.
486 * Added the "Text Domain" to the readme header to support translations on <a href='https://translate.wordpress.org/projects/wp-plugins/photonic'>wordpress.org</a>.
487
488 = 1.53 =
489
490 * Added option for Photonic lightbox be used for non-Photonic images
491 * Added support for "anyone with link" albums in Picasa, via the <code>authkey</code> parameter
492 * Fixed an issue where a "." in the album id was causing JQuery errors
493
494 = 1.52 =
495
496 * Added option to save CSS file, can be loaded for caching.
497 * Added support for an additional "layout" attribute for the shortcode. Will take a value <code>square</code>, <code>circle</code> or <code>random</code>, can override the global layout.
498 * Added support for "Random Justified Gallery" layout for displaying a group of albums, photosets etc.
499 * Added support to display all of one's 500px collections
500 * Added gesture support for Colorbox, PrettyPhoto and FancyBox
501 * Updated "wait for images" code to latest version, to facilitate getting the rest of the images when one image is blocked or broken.
502 * Added capability to bypass the popup for PrettyPhoto; on by default.
503 * Fixed an issue that was causing Fancybox, Colorbox and PrettyPhoto to fail to open images in a lightbox in the random justified gallery layout.
504 * Fixed an issue where the popup panel's lightbox was pulling photos from other popup panels
505 * Fixed an issue with 500px to support new Galleries API, which replaces the Collections / Sets API
506 * Swipebox would remove the title on mobiles by default. Added an option to address this.
507
508 = 1.51 =
509
510 * Fixed an issue with applying borders and padding to "in-page" Flickr photos
511 * Fixed an issue with Swipebox "bypassed popup panel" displays, which weren't supporting multi-line descriptions
512 * Added new layout options, "Random Justified Gallery" and "Circular Thumbnails", under <em>Settings &rarr; Generic Options &rarr; Layouts</em>
513 * Fixed an issue that wasn't showing the last used screen on the options pages upon saving
514
515 = 1.50 =
516
517 * Added Swipebox support for gestures on mobile devices
518 * Added capability to bypass the popup panel for libraries like Swipebox
519 * Corrected issues with Zenfolio displays. WP was corrupting the photoset ids for Zenfolio
520 * Added helper for SmugMug to find album id and album key
521 * Switched JQuery Tooltip to the default JQuery Tooltip script supplied by WP
522
523 = 1.49 =
524
525 * Security patch - updated PrettyPhoto to latest version
526
527 = 1.48 =
528
529 * Fixed Zenfolio API issues.
530
531 = 1.47 =
532
533 * Fixed a problem with the Flickr helpers.
534 * Fixed miscellaneous issues with SmugMug.
535
536 = 1.46 =
537
538 * 500px API updated to accommodate the new URL formats.
539
540 = 1.45 =
541
542 * Flickr API updated to use https instead of http, as per Flickr's transition plans.
543
544 = 1.44 =
545
546 * Options panel was not working for WP 3.6. This has been fixed.
547
548 = 1.43 =
549
550 * Added Thickbox support
551 * Fixed an incompatibility between Photonic and themes from Themify.
552 * Added capability to exclude passworded galleries from displaying for SmugMug.
553 * Added support for alternative shortcode - specifying this will mean Photonic will not use the gallery shortcode
554
555 = 1.42 =
556
557 * Massively refactored code. Several lines of JS code taken off, lots of PHP code modularized.
558 * Added option to use a Colorbox skin defined in the theme folder
559 * Updated SimpleModal, Colorbox and PrettyPhoto to latest versions.
560 * Swapped the use of "live" for "on". This means Photonic needs WP 3.3 at least (since "on" was introduced in JQuery 1.7)
561 * Removed the "View in Flickr" text from the plugin.
562 * Ensured consistent behaviour with the lightbox title linking behaviour across all providers.
563 * Introduced non-bundled lightbox support, with support for FancyBox2
564 * Removed the modified scripts for FancyBox and ColorBox - now the original scripts are used.
565
566 = 1.41 =
567
568 * Resolved a conflict between JetPack "Publicize" and protected access. The login box was not showing up.
569 * Added the "ids" parameter to the shortcode insertion UI.
570 * Added options to control thumbnail, title and photo count display in SmugMug album headers
571
572 = 1.40 =
573
574 * Added Zenfolio support for public photos.
575 * Fixed an issue with the shortcode generation for Instagram tags.
576 * Added the 'photonic_register_extensions' action hook for registering more extensions.
577 * Fixed some PHP notices that were showing up in debug mode when no options were set.
578 * Fixed an option to prevent SmugMug album thumbnails and titles from linking to the SmugMug page.
579
580 = 1.36 =
581
582 * Rewrote the Picasa processor to be DOM-based instead of event-based.
583 * Added option to let users display the Picasa image title instead of the description.
584 * Fixed a problem with Flickr Collections that was causing nested collections to display repeatedly.
585 * Fixed a problem with Flickr Collections that was making the collections link to an invalid page.
586 * Picasa thumbnails in the popup now have the same dimensions as those in the main page.
587
588 = 1.35 =
589
590 * Added Instagram support
591 * Gave Photonic its own menu item
592 * Added some helpers to let people find their Flickr and Instagram IDs
593 * Fixed a bug that was preventing Flickr Galleries from showing their overlaid popups
594 * Added capability to display external links in a new tab
595
596 = 1.30 =
597
598 * Removed singular check for 500px.com
599
600 = 1.29 =
601
602 * Added support for 500px.com collections.
603 * Fixed authentication problems in 500px.com.
604 * Added capability to show a different number of photos on an archive page than on the page for a single post/page
605 * Changed the Flickr API calls to be PHP-based instead of JS-based.
606
607 = 1.28 =
608
609 * Removed some debugging statements.
610
611 = 1.27 =
612
613 * Fixed a minor issue with the displaying of the login box for Picasa.
614
615 = 1.26 =
616
617 * Added support for displaying single photos in 500px.com.
618 * Added authentication support for Picasa.
619 * Added more skins for Colorbox.
620
621 = 1.25 =
622
623 * Changed some code so that not being connected to the web doesn't throw an error for 500px.
624 * Fixed an issue that was preventing 500px photos from being shown on certain servers.
625
626 = 1.24 =
627
628 * Added date filtering support for 500px.com. Thanks to Bart Kuipers (http://www.bartkuipers.com/) for the code.
629 * Removed the included script for JQuery Dimensions, which was causing conflicts with other JQuery plugins. Dimensions has been merged into JQuery Core a while back.
630
631 = 1.23 =
632
633 * Added search support for 500px.com, via tags and terms
634 * Added new categories, sort criteria and capability to exclude a category for 500px.com
635
636 = 1.22 =
637
638 * Made minor corrections to authentication behaviour. If not connected to the internet, Photonic was returning a fatal error.
639 * Changed the wording for PrettyPhoto licensing. PrettyPhoto is licensed under GPL, and that is now explicitly stated in the options page.
640 * Added the capability to include shortcodes inside the parameters of the gallery shortcode (nested shortcodes)
641
642 = 1.21 =
643
644 * Added support for SmugMug password-protected albums where the user has access to the albums. Other albums show up, but clicking on them takes the users nowhere.
645 * Fixed a bug that was killing the last thumbnail in a popup for SmugMug.
646
647 = 1.20 =
648
649 * Added authentication support for Flickr, 500px.com and SmugMug.
650 * Disabled the showing of password-protected SmugMug galleries.
651
652 = 1.12 =
653
654 * Fixed a problem with handling double quotes in the title of Flickr photos.
655
656 = 1.11 =
657
658 * Combined SimpleModal script with Photonic to save an HTTP request.
659 * Deleted some redundant JS files.
660 * Added support for a different default type.
661 * Added support for single photos in Flickr.
662
663 = 1.10 =
664
665 * Fixed a bug with the SmugMug processor, which was preventing the display of an album popup.
666
667 = 1.09 =
668
669 * Fixed a bug with the Flickr processor, which was preventing the execution of the shortcode with a group_id parameter
670 * Fixed a minor problem with the popup panels, where hovering over the panel titles was resulting in a Tooltip error.
671 * The Picasa inserter was not showing the "album" field. This has been rectified.
672
673 = 1.08 =
674
675 * Made a change to the Picasa processor to handle the recent change by Google. Google's change was forcing images to 512px.
676 * Updated the plugin to support WP 3.3.
677 * Fixed an issue with FancyBox that was showing server log errors for IE.
678
679 = 1.07 =
680
681 * Added support for SmugMug
682 * Modified the Picasa plugin to not display the file name if no title is found.
683
684 = 1.06 =
685
686 * Fixed an issue with the 500px.com extension, which had to be changed to invoke HTTPS instead of HTTP.
687 * Added support for the "sort" parameter for 500px.
688 * Fixed an issue with the PrettyPhoto library where you couldn't see the "View in Flickr" link.
689
690 = 1.05 =
691
692 * Added support for the PrettyPhoto JS library.
693 * Added check for _wp_additional_image_sizes. This was causing errors for some people.
694 * Fixed a bug with the thumbnail_width and thumbnail_height attribute of the plugin. The attributes should have been called thumb_width and thumb_height.
695 * Added option to launch images in a slideshow mode.
696 * Fixed a bug that was not accepting border settings for the thumbnails.
697
698 = 1.04 =
699
700 * Added support for photos on 500px.
701 * Modified the Colorbox invocation to fit in the browser window.
702
703 = 1.03 =
704
705 * Added support for Gallery objects in Flickr.
706 * Fixed an issue with the Picasa galleries where under certain circumstances users were getting a "Division by zero" error.
707 * Fixed an issue where Chrome and Safari were showing an overlap of the slides over the rest of the content in native galleries.
708 * Updated translation file.
709
710 = 1.02 =
711
712 * Added a UI panel for insertion of Photonic galleries through the Add Media screen.
713 * Restructured code for better extensibility.
714 * Updated translation file.
715
716 = 1.01 =
717
718 * Included a PO file for translation support.
719 * Fixed a bug to prevent appearance of Photonic stylesheets on other admin pages.
720
721 = 1.00 =
722
723 * New version created.
724
725 == Upgrade Notice ==
726
727 = 2.10 =
728
729 Version 2.10 introduces Gutenberg support. Please read <a href='https://aquoid.com/plugins/photonic/gutenberg-support/'>the documentation</a> before you embark on using it. If you encounter any issues with Gutenberg support, please log a ticket on the <a href='https://wordpress.org/support/plugin/photonic/'>support forum</a>.
730
731 = 2.00 =
732
733 Version 2.00 is a major release, providing users with the ability to use an interactive workflow to insert / edit galleries, moving away from the traditional shortcode editor. If you encounter any issues with the interactive workflow, please log a ticket on the <a href='https://wordpress.org/support/plugin/photonic/'>support forum</a>.
734
735 = 1.57 =
736
737 Version 1.57 was a major release for the SmugMug API. If you were on older versions of the plugin and using SmugMug, please read <a href='https://aquoid.com/2016/12/smugmug-access-in-photonic-1-57/'>this article</a>.