photonic / readme.txt

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

798 lines 50.1 KB

Raw Download Zip

1	=== Photonic Gallery & Lightbox for Flickr, SmugMug, Google Photos & Others ===
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.9
7	Tested up to: 5.2.4
8	Requires PHP: 5.6
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 → 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 → 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 → Settings → Generic Options → Generic Settings → 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 → Settings → Generic Options → Generic Settings → 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 → Settings → SmugMug → SmugMug Settings → 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 → Settings → Generic Options → Generic Settings → Disable Visual Editing for specific post types</em>). If that doesn't work, you can go thermonuclear on Photonic's visual editing (<em>Photonic → Settings → Generic Options → Generic Settings → 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 > 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.31 =
205
206	* Changed Zenfolio extension to use wp_remote_post instead of cURL because of "Unknown Error" for BlueHost installations
207	* Flickr photos' main size was not being considered while viewing collections
208
209	= 2.30 =
210
211	* Missed version number in previous release
212
213	= 2.29 =
214
215	* Plugin name changed to comply with FaceBook's terms of service (Instagram removed from the name)
216	* Made a change to Instagram to pull photos from within carousels (i.e. Instagram posts, which group more than one photo)
217
218	= 2.28 =
219
220	* Instagram authentication was failing due to a recent change in the Instagram API. This has been been addressed
221	* The admin menu showed a blank "Photonic" sub-menu item for users not authorized to "edit_theme_options". This has been removed
222	* Added a "Show Gallery" button capability to defer the loading of galleries
223	* Fixed an issue where Google's chain query mode would trigger an API quota issue if invalid album ids were passed to the shortcode
224
225	= 2.27 =
226
227	* Updated Colorbox to latest version; removes dependency on jQuery Migrate
228	* Updated Fancybox 1 to work with newer versions of jQuery without jQuery Migrate
229	* Updated Image Lightbox to work with newer versions of jQuery without jQuery Migrate
230	* Updated PrettyPhoto to work with newer versions of jQuery without jQuery Migrate
231	* Removed options for borders and padding around individual photos for all sources, reducing custom CSS size
232	* Moved options defaults to different file, reducing load time
233	* Combined JS files where possible to reduce HTTP requests
234	* Combined CSS files where possible to reduce HTTP requests
235	* Added screenshots to settings pages for "Add / Edit Photonic Gallery"
236
237	= 2.26 =
238
239	* Changed code to adapt to latest Flickr URL changes. Flickr no longer generates URLs with "static.flickr.com" in the URL and replaces that with "staticflickr.com"
240	* Single photos displayed for Flickr were relying explicitly on the "main_size" parameter. This has been changed to pick the "largest image" smaller than or equal to the main size image.
241	* Flickr's changes broke the thumbnail URL generation for new videos - this has been fixed
242	* LightGallery full-screen plugin has been updated to the latest version to address a JS error resultant from closing the gallery
243
244	= 2.25 =
245
246	* Changed the filtering logic for Google Photos to show results from subsequent pages only if the "Chain queries" option for Google Photos is turned on. This is to avoid API quota limit violations
247	* Made a modification to ensure that Photonic is not loading any scripts on admin pages such as the post listing page
248
249	= 2.24 =
250
251	* Fixed a bug where the shortcode builder was requiring the API key for SmugMug
252	* Added option to control title content for Google Photos
253	* Added condition to exclude loading the vanilla shortcode builder form if the Rich Content Editor is disabled
254	* Fixed album filtering logic for Google Photos to show results from subsequent pages if matches are not found on the first page
255
256	= 2.23 =
257
258	* Added a switch to allow scripts to load in the header, to account for themes including RetinaJS, <a href='https://github.com/strues/retinajs/issues/260'>which has a bug</a>.
259
260	= 2.22 =
261
262	* Conditional script placement was not working for blocks
263	* Added option to force load scripts
264
265	= 2.21 =
266
267	* Added logic to conditionally load JavaScript only on pages where Photonic is being invoked
268	* Replaced the jQuery UI Dialog script (used for password prompting) with a much smaller library (ModaliseJS) with no jQuery dependency
269	* Replaced the jQuery UI Tooltip script with a 2KB custom, no jQuery tooltip script
270	* Added support for Enhanced Media Library
271	* Fixed a mosaic layout bug that was causing the last row on smaller viewports to not render properly
272	* Fixed an issue with the Interactive Shortcode Builder not being able to process authenticated SmugMug calls
273	* Fixed a bug where Colorbox was not showing the lightbox for non-Photonic images
274	* Fixed a bug where on slow connections with the title being displayed below the photos, users were seeing a narrow, tall column of text
275
276	= 2.20 =
277
278	* Fixed an issue that was causing a fatal error on versions of PHP older than 5.5
279	* 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.
280
281	= 2.19 =
282
283	* Picasa is now deprecated, so support for it in the plugin has been removed
284	* Added support for the Gutenberg block "wide-alignment" and "full-width" options
285	* Added a <code>photonic_helper</code> utility shortcode
286	* The block-builder also shows the equivalent shortcode at the bottom for users who are facing Gutenberg conflicts or want to use a shortcode
287	* The <code>main_size</code> option was being ignored for the native galleries in favour of <code>slide_size</code>
288	* Escaped all translated strings appropriately
289	* The more button was not showing up on some OS configurations due to EOL character mismatches
290	* Performance tracing was causing native WP galleries to not show up
291	* Removed option to link photos for Google as all access is for private photos - "View" link is always erroneous
292	* Added an "end" element to the galleries, to enable linking to the end of the gallery
293	* Added PHP and extension info to the "Getting Started" page
294	* Added a <code>tile_size</code> option to Instagram
295	* Added PHP 7.3 compatibility
296	* Added a hover overlay icon for videos for Instagram, Flickr and SmugMug
297	* Fixed an issue where the slideshow layout was not respecting the <code>strip-above</code> option
298	* Removed the requirement for an API key for SmugMug - SmugMug users will require an API key only if they want to display private photos
299	* Fixed an "empty space" issue occurring for Safari with the masonry layout
300	* Fixed a bug with PhotoSwipe and the justified grid layout, which was causing the lightbox to show a different image than the one clicked
301	* Fixed a bug with PhotoSwipe and StripJS where the looping setting was not being respected
302	* Added options to disable loading of Photonic's scripts in case a theme / plugin supplies them
303	* Switched to minified versions of all JavaScript files; can be controlled by options
304	* Renamed translation file to photonic.pot from photonic.po
305
306	= 2.17 =
307
308	* Private albums for Flickr and SmugMug were not showing up in the interactive shortcode builder
309	* Resolved Divi conflict with Visual Editor, and in Text editor the WP media library gets pushed behind
310
311	= 2.16 =
312
313	* Zenfolio photosets with "smart" names were not being pulled up correctly
314	* Using <code>title_position='none'</code> was not disabling the title
315	* Masonry layout was not respecting the column count for level 2 displays
316	* Minor changes to ensure that the hints in the flow editor are showing up only when required
317	* Pinterest share now opens in a new window
318
319	= 2.15 =
320
321	* Added a filtering capability on the shortcode insertion screens
322	* Fixed a JS error that was showing up on clicking on "Add / Edit Photonic Gallery" button
323	* Added the ability to provide the thumbnail size for Instagram in the shortcode builder
324
325	= 2.14 =
326
327	* Fixed "disableShrink" behaviour for Lightcase.
328	* Fixed Fancybox3 social media linking issues
329	* Fixed a flickering issue for PhotoSwipe on mobiles
330	* Fixed a bug where Flickr collections were not showing nested collections in some scenarios
331
332	= 2.13 =
333
334	* Fixed a bug where the interactive flow was replacing the "Tile size" for WordPress galleries with a "Thumb Size"
335	* Fixed a bug where gallery transitions within Fancybox3, PrettyPhoto and StripJS galleries were not working
336	* Added a capability to check if the current user can edit posts before showing the interactive flow
337	* Added several new options to the lightbox configurations
338
339	= 2.12 =
340
341	* Added support for Magnific Popup
342	* Fixed an issue with LightSlider slideshows not going the full-width in specific cases
343	* Fixed a bug with the interactive flow that was causing a JS error for WP galleries if starting a new gallery
344	* Split out the lightbox options to their own tab
345	* Added multiple customization options to the lightboxes
346	* Added a capability to launch a lightbox from a slideshow for LightGallery and Magnific
347	* Added an option to remove the photo count from Google Album displays
348
349	= 2.11 =
350
351	* Optimized and modularized JavaScript by separating out each lightbox script
352	* Flickr photsets in a collection were losing their order due to parallel calls - now fixed
353	* Instagram Masonry layout was hardcoding image sizes and not working properly
354	* Fixed an issue in the interactive workflow that was causing a fatal error for PHP versions < 5.5
355	* 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
356
357	= 2.10 =
358
359	* Added Gutenberg compatibility
360	* Added a "Shortcode replacement" capability to prepare for Gutenberg. See <em>Photonic → Prepare for Gutenberg</em>
361	* Fixed a bug that was causing the default album search by user to fail for SmugMug
362	* The <code>layout='strip-above'</code> setting was not working for the slideshow layouts. This has been corrected
363	* Added new "Advanced" settings under "Generic Options". Moved SSL and performance logging options there.
364	* Added new options to increase the cURL timeout and to enable debug logging for troubleshooting, under the "Advanced" section
365	* Replaced Flickr collection-fetching with parallel calls
366
367	= 2.02 =
368
369	* Minor patch for Interactive Workflow z-index issue
370
371	= 2.01 =
372
373	* Added support for PhotoSwipe
374	* Addressed an Instagram change that was preventing higher resolution images from being displayed.
375	* Removed the explicitly defined Instagram sizes for 1080px and replaced them with a "Largest" option to automatically pull the largest available image
376	* Fixed a bug that was not respecting the sort order for SmugMug
377
378	= 2.00 =
379
380	* Added a new workflow-type button, "Add / Edit Photonic Gallery" to create Photonic galleries
381	* 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
382	* Added "search" capability for images in SmugMug albums, folders and for users by text and keywords
383	* User id is no longer required for Instagram photos. The authenticated user is used
384	* Added support for Zenfolio authentication
385	* Added support for user-specific text / category searches for Zenfolio photosets
386	* Added support for <code>photoset_type</code> (Gallery / Collection) for user-specific photosets in Zenfolio
387	* Added support for <code>kind</code> (Recent / Popular) for user-specific photosets in Zenfolio
388	* Added filter capability for Zenfolio photosets
389	* Switched Zenfolio call from HTTP to HTTPS
390	* Added <code>tile_size</code> support to native WP galleries
391	* Changed Flickr "download" URL to reflect the full-size original image
392	* Added capability to disable visual editing by post type
393	* Fixed a bug that was causing a "short term cache" for an authenticated Google account, resulting in erroneous photos if the account was switched
394	* 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
395	* Switched Masonry to use the script bundled natively with WP
396	* Added capability to track performance for each gallery (disabled by default)
397	* Added option to disable SSL verification on local sites
398	* 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
399
400	= 1.68 =
401
402	* 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
403	* Added capability to "show more" albums. Passing the <code>count</code> and <code>more</code> attributes allows pagination of albums
404	* 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
405	* 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
406	* Updated Featherlight to latest version
407
408	= 1.67 =
409
410	* Fixed an issue with Instagram where not all recent media was displaying
411	* Fixed an issue where a lightbox / interim popup launched from a Flickr album thumbnail capped off at 100 photos
412
413	= 1.66 =
414
415	* Added video support for Flickr, Picasa / Google, SmugMug, Zenfolio and Instagram, plus videos from YouTube or Vimeo, plus standalone, locally hosted MP4 files
416	* Added support for the <a href='https://fancyapps.com/fancybox/3/'>Fancybox3</a> lightbox
417	* Added thumbnails to the Picasa and SmugMug helpers for easier identification
418	* Added a <code>structure</code> option to the Zenfolio shortcode so that photosets can be shown without being grouped
419	* Fixed a bug where the shortcode insertion script was not printing the alternative shortcode
420	* Fixed a bug where, for the alternative shortcode being used with a native WP gallery, the <code>ids</code> parameter was not being respected
421	* Fixed a bug where the archive-view thumbnail limit was not working for the home page
422	* Updated LightGallery scripts to latest version
423	* Corrected instructions for Picasa redirect URLs
424	* 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>
425	* Random Justified Grid was setting the <code>alt</code> attribute of images to "undefined". This has been fixed
426
427	= 1.65 =
428
429	* Added back-end authentication support for Flickr, SmugMug and 500px (feature existed for Google/Picasa and Instagram)
430	* Fixed an incompatibility between themes and plugins using Bootstrap, and Photonic's use of jQuery Tooltip
431	* Added support for the <a href='http://noelboss.github.io/featherlight/'>Featherlight</a> lightbox
432	* Split out Authentication functionality to its own admin page, away from Helpers.
433	* Improved error messages
434	* Fixed a problem with the "Buy" link for SmugMug not appearing when opted for
435	* Fixed an issue where user names in 500px that had numbers at the start were not displaying photos from the correct user
436	* Streamlined the Picasa code to use native WP methods for HTTP requests
437	* 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
438	* Added support for Pinterest sharing
439	* The SmugMug folder view was dropping albums that didn't have a "Highlight image". This has been addressed to use a placeholder
440	* SmugMug folders were unable to display more than 10 albums within. This has been addressed to display up to 200 albums
441	* Fixed a bug with 500px.com categories, where categories with spaces were not being processed correctly
442	* 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.
443	* Added support for images in Flickr that do not follow Flickr's documented URL structure
444	* Added a new title style to stick the title over the lower portion of a photo
445
446	= 1.64 =
447
448	* New Masonry layout, triggered by <code>layout='masonry'</code> for external galleries, and <code>style='masonry'</code> for WP galleries
449	* New Mosaic layout, triggered by <code>layout='mosaic'</code> for external galleries, and <code>style='mosaic'</code> for WP galleries
450	* Added "More" button capability to native WP galleries
451	* Added deep-linking and sharing capabilities to native WP galleries
452	* Added an option to disable lightbox linking for Native WP galleries
453	* Added support to display a folder in SmugMug, using <code>view='folder'</code>
454	* Added size options for Instagram's larger sizes, e.g. 1080x1080px
455	* Added options for "Thumbnail effects" - opacity, zoom and none
456	* 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>
457	* Added an option to auto-start slideshows in the slideshow layout
458	* Added slideshow options to the shortcode insertion script for all galleries
459	* 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.
460	* Fixed a mismatched HTML tag for single-photo displays.
461	* Corrected a styling issue for the preview button in the WP editor that occurred when the back-end shortcode editor was active
462	* The SmugMug helper now also provides information about folders
463	* 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.
464
465	= 1.63 =
466
467	* Shortcode integration with TinyMCE. Placeholders show up for all galleries, and clicking them lets users update gallery properties.
468	* Added support for non-bundled lightbox, <a href='http://stripjs.com'>Strip</a>. There is deep-linking support, but social sharing doesn't work.
469	* "Download" capability for LightGallery was not working in Firefox for Picasa, SmugMug, Flickr, Zenfolio, 500px and Instagram. Fixed for Picasa, SmugMug and Flickr.
470	* Lightgallery showed a title in the lightbox even if "Show description only, even if blank" was selected. Fixed.
471
472	= 1.62 =
473
474	* 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>.
475	* 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.
476	* Modified the back-end to remove dependency on JQuery UI; different look, reduced size and load time. Streamlined Flickr options.
477	* Added new "Getting Started" page in the back-end with links to documentation.
478	* Added support for the <a href='https://sachinchoolur.github.io/lightGallery/'>Lightgallery</a> lightbox script.
479	* Added <code>controls</code> as an option for native WP galleries displayed as slideshows - shows "Previous" and "Next" buttons on the slideshow.
480	* 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.
481	* Added <code>caption</code> as an option for all galleries - helps pick the photo title or description / caption to display.
482	* 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.
483	* Added Circular thumbnails option for WP gallery layouts
484
485	= 1.61 =
486
487	* Fixed an issue that was causing the Flickr API to fail for old versions of PHP.
488
489	= 1.60 =
490
491	* Added a "Load More" feature to shortcodes that display images.
492	* Added capability to display a selected number of photos from SmugMug albums.
493	* Added support for the <a href='http://cornel.bopp-art.com/lightcase/'>Lightcase</a> lightbox. Optimized CSS and fonts to reduce file sizes.
494	* 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.
495
496	= 1.59 =
497
498	* Fixed a "Headers already sent" error for password-protected Zenfolio albums displayed "in page".
499	* Fixed an "Event not defined" error with Swipebox on FF.
500	* Added support for <a href='https://osvaldas.info/image-lightbox-responsive-touch-friendly'>Image Lightbox</a>.
501	* 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 → Helpers</em>
502	* Due to Instagram API changes, some features such as popular photos, follows and followed-by capabilities have been removed.
503	* Added options for lazy-loading of Flickr Collections.
504	* Added a new "headers" parameter for Flickr, SmugMug and Zenfolio, where the album / set / gallery / collection header display may be controlled via the shortcode.
505	* Added a new "Back-End Authentication" mode for Picasa / Google Photos to support the Google Photos API.
506
507	= 1.58 =
508
509	* 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.
510	* Added social sharing support for Facebook, Twitter and Google+ for the above-mentioned lightboxes.
511	* Fixed a SmugMug bug that was causing the album headers to show up twice.
512	* Added a hook, <code>photonic_modify_title</code> to apply a different title for photos.
513	* Fixed Fancybox styling issues for certain themes
514	* Enhanced Fancybox2 support: added support for "Bypass popup", thumbnail and button helpers, and touch gestures
515	* Added "Bypass popup" support for all included lightboxes, on by default
516	* Added new SmugMug sizes to the backend options
517	* In case an image has no title, and lightbox linking is disabled, the plugin will now not show the "View" text in the lightbox
518
519	= 1.57 =
520
521	* 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.
522	* 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.
523	* Added new capability to support clicking of password-protected and authenticated albums in SmugMug
524	* Added new capability to support clicking and display of password-protected albums in Zenfolio
525	* Added new helper for Picasa to fetch Google Photos / Picasa album ids.
526	* Added a "filter" option for the shortcode to allow for displaying selected albums / photosets / galleries / collections for Flickr, SmugMug, 500px and Picasa
527	* Added a "loading" wheel to show that images are loading on the front-end.
528
529	= 1.56 =
530
531	* Removed syntax that was causing errors in PHP versions <= 5.3.
532	* Made a correction to the Picasa processor to support https in all cases. Previously https was being used only for authenticated users.
533	* Added a new title style - slides up from the bottom upon hovering on a thumbnail.
534
535	= 1.55 =
536
537	* 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.
538	* Added support for <code>site_password</code> for SmugMug.
539	* Changed <code>load_textdomain</code> to <code>load_plugin_textdomain</code>.
540	* Replaced older fixed width popup panel with a responsive popup panel.
541	* Removed options for displaying a fixed number of images per screen in the popup panel.
542
543	= 1.54 =
544
545	* 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.
546	* Added the "authkey" option to the shortcode generation script.
547	* 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>.
548
549	= 1.53 =
550
551	* Added option for Photonic lightbox be used for non-Photonic images
552	* Added support for "anyone with link" albums in Picasa, via the <code>authkey</code> parameter
553	* Fixed an issue where a "." in the album id was causing JQuery errors
554
555	= 1.52 =
556
557	* Added option to save CSS file, can be loaded for caching.
558	* 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.
559	* Added support for "Random Justified Gallery" layout for displaying a group of albums, photosets etc.
560	* Added support to display all of one's 500px collections
561	* Added gesture support for Colorbox, PrettyPhoto and FancyBox
562	* Updated "wait for images" code to latest version, to facilitate getting the rest of the images when one image is blocked or broken.
563	* Added capability to bypass the popup for PrettyPhoto; on by default.
564	* Fixed an issue that was causing Fancybox, Colorbox and PrettyPhoto to fail to open images in a lightbox in the random justified gallery layout.
565	* Fixed an issue where the popup panel's lightbox was pulling photos from other popup panels
566	* Fixed an issue with 500px to support new Galleries API, which replaces the Collections / Sets API
567	* Swipebox would remove the title on mobiles by default. Added an option to address this.
568
569	= 1.51 =
570
571	* Fixed an issue with applying borders and padding to "in-page" Flickr photos
572	* Fixed an issue with Swipebox "bypassed popup panel" displays, which weren't supporting multi-line descriptions
573	* Added new layout options, "Random Justified Gallery" and "Circular Thumbnails", under <em>Settings → Generic Options → Layouts</em>
574	* Fixed an issue that wasn't showing the last used screen on the options pages upon saving
575
576	= 1.50 =
577
578	* Added Swipebox support for gestures on mobile devices
579	* Added capability to bypass the popup panel for libraries like Swipebox
580	* Corrected issues with Zenfolio displays. WP was corrupting the photoset ids for Zenfolio
581	* Added helper for SmugMug to find album id and album key
582	* Switched JQuery Tooltip to the default JQuery Tooltip script supplied by WP
583
584	= 1.49 =
585
586	* Security patch - updated PrettyPhoto to latest version
587
588	= 1.48 =
589
590	* Fixed Zenfolio API issues.
591
592	= 1.47 =
593
594	* Fixed a problem with the Flickr helpers.
595	* Fixed miscellaneous issues with SmugMug.
596
597	= 1.46 =
598
599	* 500px API updated to accommodate the new URL formats.
600
601	= 1.45 =
602
603	* Flickr API updated to use https instead of http, as per Flickr's transition plans.
604
605	= 1.44 =
606
607	* Options panel was not working for WP 3.6. This has been fixed.
608
609	= 1.43 =
610
611	* Added Thickbox support
612	* Fixed an incompatibility between Photonic and themes from Themify.
613	* Added capability to exclude passworded galleries from displaying for SmugMug.
614	* Added support for alternative shortcode - specifying this will mean Photonic will not use the gallery shortcode
615
616	= 1.42 =
617
618	* Massively refactored code. Several lines of JS code taken off, lots of PHP code modularized.
619	* Added option to use a Colorbox skin defined in the theme folder
620	* Updated SimpleModal, Colorbox and PrettyPhoto to latest versions.
621	* Swapped the use of "live" for "on". This means Photonic needs WP 3.3 at least (since "on" was introduced in JQuery 1.7)
622	* Removed the "View in Flickr" text from the plugin.
623	* Ensured consistent behaviour with the lightbox title linking behaviour across all providers.
624	* Introduced non-bundled lightbox support, with support for FancyBox2
625	* Removed the modified scripts for FancyBox and ColorBox - now the original scripts are used.
626
627	= 1.41 =
628
629	* Resolved a conflict between JetPack "Publicize" and protected access. The login box was not showing up.
630	* Added the "ids" parameter to the shortcode insertion UI.
631	* Added options to control thumbnail, title and photo count display in SmugMug album headers
632
633	= 1.40 =
634
635	* Added Zenfolio support for public photos.
636	* Fixed an issue with the shortcode generation for Instagram tags.
637	* Added the 'photonic_register_extensions' action hook for registering more extensions.
638	* Fixed some PHP notices that were showing up in debug mode when no options were set.
639	* Fixed an option to prevent SmugMug album thumbnails and titles from linking to the SmugMug page.
640
641	= 1.36 =
642
643	* Rewrote the Picasa processor to be DOM-based instead of event-based.
644	* Added option to let users display the Picasa image title instead of the description.
645	* Fixed a problem with Flickr Collections that was causing nested collections to display repeatedly.
646	* Fixed a problem with Flickr Collections that was making the collections link to an invalid page.
647	* Picasa thumbnails in the popup now have the same dimensions as those in the main page.
648
649	= 1.35 =
650
651	* Added Instagram support
652	* Gave Photonic its own menu item
653	* Added some helpers to let people find their Flickr and Instagram IDs
654	* Fixed a bug that was preventing Flickr Galleries from showing their overlaid popups
655	* Added capability to display external links in a new tab
656
657	= 1.30 =
658
659	* Removed singular check for 500px.com
660
661	= 1.29 =
662
663	* Added support for 500px.com collections.
664	* Fixed authentication problems in 500px.com.
665	* Added capability to show a different number of photos on an archive page than on the page for a single post/page
666	* Changed the Flickr API calls to be PHP-based instead of JS-based.
667
668	= 1.28 =
669
670	* Removed some debugging statements.
671
672	= 1.27 =
673
674	* Fixed a minor issue with the displaying of the login box for Picasa.
675
676	= 1.26 =
677
678	* Added support for displaying single photos in 500px.com.
679	* Added authentication support for Picasa.
680	* Added more skins for Colorbox.
681
682	= 1.25 =
683
684	* Changed some code so that not being connected to the web doesn't throw an error for 500px.
685	* Fixed an issue that was preventing 500px photos from being shown on certain servers.
686
687	= 1.24 =
688
689	* Added date filtering support for 500px.com. Thanks to Bart Kuipers (http://www.bartkuipers.com/) for the code.
690	* 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.
691
692	= 1.23 =
693
694	* Added search support for 500px.com, via tags and terms
695	* Added new categories, sort criteria and capability to exclude a category for 500px.com
696
697	= 1.22 =
698
699	* Made minor corrections to authentication behaviour. If not connected to the internet, Photonic was returning a fatal error.
700	* Changed the wording for PrettyPhoto licensing. PrettyPhoto is licensed under GPL, and that is now explicitly stated in the options page.
701	* Added the capability to include shortcodes inside the parameters of the gallery shortcode (nested shortcodes)
702
703	= 1.21 =
704
705	* 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.
706	* Fixed a bug that was killing the last thumbnail in a popup for SmugMug.
707
708	= 1.20 =
709
710	* Added authentication support for Flickr, 500px.com and SmugMug.
711	* Disabled the showing of password-protected SmugMug galleries.
712
713	= 1.12 =
714
715	* Fixed a problem with handling double quotes in the title of Flickr photos.
716
717	= 1.11 =
718
719	* Combined SimpleModal script with Photonic to save an HTTP request.
720	* Deleted some redundant JS files.
721	* Added support for a different default type.
722	* Added support for single photos in Flickr.
723
724	= 1.10 =
725
726	* Fixed a bug with the SmugMug processor, which was preventing the display of an album popup.
727
728	= 1.09 =
729
730	* Fixed a bug with the Flickr processor, which was preventing the execution of the shortcode with a group_id parameter
731	* Fixed a minor problem with the popup panels, where hovering over the panel titles was resulting in a Tooltip error.
732	* The Picasa inserter was not showing the "album" field. This has been rectified.
733
734	= 1.08 =
735
736	* Made a change to the Picasa processor to handle the recent change by Google. Google's change was forcing images to 512px.
737	* Updated the plugin to support WP 3.3.
738	* Fixed an issue with FancyBox that was showing server log errors for IE.
739
740	= 1.07 =
741
742	* Added support for SmugMug
743	* Modified the Picasa plugin to not display the file name if no title is found.
744
745	= 1.06 =
746
747	* Fixed an issue with the 500px.com extension, which had to be changed to invoke HTTPS instead of HTTP.
748	* Added support for the "sort" parameter for 500px.
749	* Fixed an issue with the PrettyPhoto library where you couldn't see the "View in Flickr" link.
750
751	= 1.05 =
752
753	* Added support for the PrettyPhoto JS library.
754	* Added check for _wp_additional_image_sizes. This was causing errors for some people.
755	* 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.
756	* Added option to launch images in a slideshow mode.
757	* Fixed a bug that was not accepting border settings for the thumbnails.
758
759	= 1.04 =
760
761	* Added support for photos on 500px.
762	* Modified the Colorbox invocation to fit in the browser window.
763
764	= 1.03 =
765
766	* Added support for Gallery objects in Flickr.
767	* Fixed an issue with the Picasa galleries where under certain circumstances users were getting a "Division by zero" error.
768	* Fixed an issue where Chrome and Safari were showing an overlap of the slides over the rest of the content in native galleries.
769	* Updated translation file.
770
771	= 1.02 =
772
773	* Added a UI panel for insertion of Photonic galleries through the Add Media screen.
774	* Restructured code for better extensibility.
775	* Updated translation file.
776
777	= 1.01 =
778
779	* Included a PO file for translation support.
780	* Fixed a bug to prevent appearance of Photonic stylesheets on other admin pages.
781
782	= 1.00 =
783
784	* New version created.
785
786	== Upgrade Notice ==
787
788	= 2.10 =
789
790	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>.
791
792	= 2.00 =
793
794	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>.
795
796	= 1.57 =
797
798	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>.