|
@@ -1,48 +1,66 @@ |
|
1
|
|
-=== Photonic Gallery & Lightbox for Flickr, SmugMug, Google Photos & Others ===
|
|
1
|
+=== Photonic Gallery & Lightbox for Flickr, SmugMug & Others ===
|
|
2
|
2
|
Contributors: sayontan
|
|
3
|
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
|
|
4
|
+Tags: flickr, smugmug, zenfolio, gallery, lightbox
|
|
5
|
5
|
Text Domain: photonic
|
|
6
|
|
-Requires at least: 4.9
|
|
7
|
|
-Tested up to: 5.4.1
|
|
8
|
|
-Requires PHP: 5.6
|
|
9
|
|
-Stable tag: trunk
|
|
6
|
+Requires at least: 6.2
|
|
7
|
+Tested up to: 7.1
|
|
8
|
+Requires PHP: 7.4
|
|
9
|
+Stable tag: 3.37
|
|
10
|
10
|
License: GPLv3 or later
|
|
11
|
11
|
|
|
12
|
|
-Galleries on steroids! A stylish lightbox & gallery plugin for WP, Flickr, SmugMug, Google Photos, Zenfolio & Instagram photos and videos.
|
|
12
|
+Galleries on steroids! A stylish lightbox & gallery plugin for WP, Flickr, SmugMug and Zenfolio photos and videos.
|
|
13
|
13
|
|
|
14
|
|
-== Description ==
|
|
14
|
+## Description
|
|
15
|
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.
|
|
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://smugmug.com'>SmugMug</a> folders, albums and images, and <a href='https://zenfolio.com'>Zenfolio</a> photos, Photosets and Groups. You can also set up authentication so that visitors can see private and protected photos from each provider.
|
|
17
|
17
|
|
|
18
|
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
|
19
|
|
|
20
|
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
|
21
|
|
|
22
|
|
-= Lightboxes =
|
|
22
|
+### Lightboxes
|
|
23
|
23
|
|
|
24
|
|
-Photonic has built-in support for commonly used lightbox scripts such as:
|
|
24
|
+Of all plugins free or paid, Photonic has support built in for the highest number of lightbox scripts. This includes scripts that run on pure JavaScript without relying on external libraries, or those that require jQuery.
|
|
25
|
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
|
|
26
|
+#### Pure JS Libraries
|
|
27
|
+
|
|
28
|
+* <a href='https://feimosi.github.io/baguetteBox.js/'>BaguetteBox</a>
|
|
29
|
+* <a href='https://henrygd.me/bigpicture/'>BigPicture</a>
|
|
30
|
+* <a href='https://biati-digital.github.io/glightbox/'>"Gie" Lightbox (GLightbox)</a>
|
|
31
|
+* <a href='https://www.lightgalleryjs.com/'>LightGallery</a>
|
|
32
|
+* <a href='https://github.com/dimsemenov/PhotoSwipe/tree/v4.1.3'>PhotoSwipe v4</a>
|
|
33
|
+* <a href='https://photoswipe.com/'>PhotoSwipe v5</a>
|
|
34
|
+* <a href='https://nextapps-de.github.io/spotlight/'>Spotlight</a>
|
|
35
|
+* <a href="https://veno.es/venobox/">VenoBox</a>
|
|
36
|
+
|
|
37
|
+#### jQuery Based Libraries
|
|
38
|
+
|
|
39
|
+* <a href='https://jacklmoore.com/colorbox/'>Colorbox</a>
|
|
40
|
+* <a href='https://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
|
41
|
* <a href='https://fancyapps.com/fancybox/3/'>Fancybox3</a>
|
|
30
|
42
|
* <a href='https://noelboss.github.io/featherlight/'>Featherlight</a>
|
|
31
|
43
|
* <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
|
|
44
|
+* <a href='https://cornel.bopp-art.com/lightcase/'>Lightcase</a>
|
|
45
|
+* <a href='https://brutaldesign.github.io/swipebox/'>Swipebox</a>
|
|
39
|
46
|
* Thickbox
|
|
40
|
47
|
|
|
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.
|
|
48
|
+#### Obsolete Libraries
|
|
42
|
49
|
|
|
43
|
|
-= Flickr Support =
|
|
50
|
+* <a href='http://fancybox.net/'>Fancybox 1</a> - no update since November 2010
|
|
51
|
+* <a href='http://dimsemenov.com/plugins/magnific-popup/'>Magnific Popup</a> - no update since February 2016
|
|
52
|
+* <a href='http://www.no-margin-for-errors.com/projects/prettyphoto-jquery-lightbox-clone/'>PrettyPhoto</a> - no update since May 2015
|
|
53
|
+* <a href='http://www.stripjs.com'>Strip</a> - archived GitHub repository
|
|
44
|
54
|
|
|
55
|
+For the non-GPL alternatives like <a href='https://fancyapps.com/fancybox/'>Fancybox2</a> and the obsolete libraries, Photonic has code to work with them, but you have to install the scripts yourself or rely on them from your theme or another plugin.
|
|
56
|
+
|
|
57
|
+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.
|
|
58
|
+
|
|
59
|
+### Support for Multiple Platforms
|
|
60
|
+
|
|
61
|
+#### Flickr
|
|
62
|
+
|
|
45
|
63
|
The following Flickr concepts are supported in Photonic:
|
|
46
|
64
|
|
|
47
|
65
|
* <a href='https://aquoid.com/plugins/photonic/flickr/flickr-photos/'>Photos</a>
|
|
48
|
66
|
* <a href='https://aquoid.com/plugins/photonic/flickr/flickr-photosets/'>PhotoSets (Albums)</a>
|
|
@@ -52,19 +70,14 @@ |
|
52
|
70
|
* <a href='https://aquoid.com/plugins/photonic/flickr/flickr-authentication/'>Authentication</a>
|
|
53
|
71
|
|
|
54
|
72
|
For demos of Flickr support visit the <a href='https://aquoid.com/plugins/photonic/flickr/'>Flickr page</a>.
|
|
55
|
73
|
|
|
56
|
|
-= Google Photos Support =
|
|
74
|
+#### Google Photos
|
|
57
|
75
|
|
|
58
|
|
-The following Google Photos concepts are supported in Photonic:
|
|
76
|
+Google API Change: **With effect from 31st March 2025, Google's Photos API is discontinued (see <a href='https://developers.google.com/photos/support/updates'>here for Google's official announcement</a>). Consequently, Photonic no longer works for Google Photos**. For more details, see <a href='https://wordpress.org/support/topic/potential-shutdown-of-google-photos-support-from-march-2025/'>this thread</a>. Note that while Google's official announcement says otherwise, as of 20th April 2025 the API is still working, so older versions of Photonic will seem to work. However, there is no guarantee about when Google will truly shut it off.
|
|
59
|
77
|
|
|
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>
|
|
78
|
+#### SmugMug
|
|
62
|
79
|
|
|
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
|
80
|
The following SmugMug concepts are supported in Photonic:
|
|
68
|
81
|
|
|
69
|
82
|
* <a href='https://aquoid.com/plugins/photonic/smugmug/smugmug-tree/'>User Tree</a>
|
|
70
|
83
|
* <a href='https://aquoid.com/plugins/photonic/smugmug/smugmug-photos/'>Photos</a>
|
|
@@ -72,9 +85,9 @@ |
|
72
|
85
|
* <a href='https://aquoid.com/plugins/photonic/smugmug/folders/'>Folders</a>
|
|
73
|
86
|
|
|
74
|
87
|
For demos of SmugMug support visit the <a href='https://aquoid.com/plugins/photonic/smugmug/'>SmugMug page</a>.
|
|
75
|
88
|
|
|
76
|
|
-= Zenfolio Support =
|
|
89
|
+#### Zenfolio
|
|
77
|
90
|
|
|
78
|
91
|
The following Zenfolio concepts are supported in Photonic:
|
|
79
|
92
|
|
|
80
|
93
|
* <a href='https://aquoid.com/plugins/photonic/zenfolio/photos/'>Photos</a>
|
|
@@ -81,47 +94,59 @@ |
|
81
|
94
|
* <a href='https://aquoid.com/plugins/photonic/zenfolio/photosets/'>PhotoSets (Galleries and Collections)</a>
|
|
82
|
95
|
* <a href='https://aquoid.com/plugins/photonic/zenfolio/groups/'>Groups</a>
|
|
83
|
96
|
* <a href='https://aquoid.com/plugins/photonic/zenfolio/group-hierarchy/'>Group Hierarchies</a>
|
|
84
|
97
|
|
|
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.
|
|
98
|
+For demos of Zenfolio support visit the <a href='https://aquoid.com/plugins/photonic/zenfolio/'>Zenfolio page</a>.
|
|
86
|
99
|
|
|
87
|
|
-= Instagram Support =
|
|
100
|
+#### Instagram
|
|
88
|
101
|
|
|
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.
|
|
102
|
+In mid-September 2022 Meta / Facebook / Instagram changed its rules to disallow individual developers (i.e. developers not operating as a business) from meaningfully using its API. As a result, Photonic no longer works for Instagram photos. The code is still in place though, and can be used by someone with a business wishing to adopt it.
|
|
90
|
103
|
|
|
91
|
|
-= Enhanced Native Galleries =
|
|
104
|
+#### Native WordPress Galleries
|
|
92
|
105
|
|
|
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.
|
|
106
|
+Your existing galleries 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
|
107
|
|
|
95
|
|
-= 500px Support - Historical =
|
|
108
|
+### Other Photonic Goodies
|
|
96
|
109
|
|
|
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.
|
|
110
|
+#### Gallery Wizard
|
|
98
|
111
|
|
|
99
|
|
-= Video Support =
|
|
112
|
+The WordPress Classic editor shows up with a button that says "Add / Edit Photonic Gallery". Clicking on it launches a wizard that helps you interactively build out a gallery with just a few clicks.
|
|
100
|
113
|
|
|
114
|
+#### Gutenberg Support
|
|
115
|
+
|
|
116
|
+The Gallery Wizard can be accessed via Gutenberg / the Block Editor as well. While creating a block, just look for Photonic. Please refer to the <a href='https://aquoid.com/plugins/photonic/gutenberg-support/'>documentation</a>.
|
|
117
|
+
|
|
118
|
+#### Video Support
|
|
119
|
+
|
|
101
|
120
|
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
|
121
|
|
|
103
|
|
-* External videos from YouTube or Vimeo can be opened in any of the lightboxes apart from Image Lightbox or Thickbox
|
|
122
|
+* External videos from YouTube or Vimeo can be opened in any of the lightboxes apart from Image Lightbox, Thickbox or BaguetteBox
|
|
104
|
123
|
* 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.
|
|
124
|
+* Videos hosted by external service providers (Flickr, SmugMug 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='https://aquoid.com/plugins/photonic/third-party-lightboxes/'>Lightboxes</a> documentation for more.
|
|
106
|
125
|
|
|
107
|
|
-= Deep-Linking and Social Sharing =
|
|
126
|
+#### Deep-Linking and Social Sharing
|
|
108
|
127
|
|
|
109
|
|
-Photonic provides deep-linking support for non-WP images, and by extension, supports social sharing to Facebook, Twitter, Google+ and Pinterest.
|
|
128
|
+Photonic provides deep-linking support for non-WP images, and by extension, supports social sharing to Facebook, Twitter and Pinterest.
|
|
110
|
129
|
|
|
111
|
|
-= Beautiful Layouts =
|
|
130
|
+#### Beautiful Layouts
|
|
112
|
131
|
|
|
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.
|
|
132
|
+Photonic displays your galleries in multiple forms:
|
|
114
|
133
|
|
|
115
|
|
-= Interactive Editing =
|
|
134
|
+* A grid of square thumbnails (the default)
|
|
135
|
+* A grid of circular thumbnails (like Jetpack)
|
|
136
|
+* A neat justified grid
|
|
137
|
+* A masonry layout
|
|
138
|
+* A "horizontal" masonry layout, for those who prefer having their masonry layouts sorted horizontally
|
|
139
|
+* A tiled, random mosaic (a much improved variant of the Jetpack Tiled Gallery layout)
|
|
140
|
+* A slideshow, using the <a href='https://splidejs.com'>Splide</a> script
|
|
116
|
141
|
|
|
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.
|
|
142
|
+See the <a href='https://aquoid.com/plugins/photonic/layouts/'>Layouts</a> documentation page for details and examples.
|
|
118
|
143
|
|
|
119
|
|
-= Gutenberg Support =
|
|
144
|
+### Obsessively Comprehensive Documentation (OCD)
|
|
120
|
145
|
|
|
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>.
|
|
146
|
+Photonic's <a href='https://aquoid.com/plugins/photonic/photonic-documentation/'>documentation</a> is comprehensive to the point of obsession. And yet, if you find something missing, please feel free to get in touch via the support forum.
|
|
122
|
147
|
|
|
123
|
|
-== Installation ==
|
|
148
|
+## Installation
|
|
124
|
149
|
|
|
125
|
150
|
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
|
151
|
|
|
127
|
152
|
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.
|
|
@@ -127,16 +152,16 @@ |
|
127
|
152
|
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
|
153
|
|
|
129
|
154
|
Once you have activated the plugin, refer to <em>Photonic → Getting Started</em> for a list of capabilities and documentation.
|
|
130
|
155
|
|
|
131
|
|
-== Screenshots ==
|
|
156
|
+## Screenshots
|
|
132
|
157
|
|
|
133
|
158
|
For the plugin in action see the <a href='https://aquoid.com/plugins/photonic/'>plugin page</a>.
|
|
134
|
159
|
|
|
135
|
160
|
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.
|
|
161
|
+2. If you are not using Gutenberg, build the shortcode for Photonic through the Media Uploader by clicking on "Add / Edit Photonic Gallery".
|
|
162
|
+3. Clicking on the Gutenberg block, or on "Add / Edit Photonic Gallery" shows a wizard for you to build out your gallery.
|
|
163
|
+4. The wizard shows you the options available and helps construct the gallery easily.
|
|
139
|
164
|
5. If you click on "Add Media" you will see a new tab for "Photonic". This is not available for Gutenberg.
|
|
140
|
165
|
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
|
166
|
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
|
167
|
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.
|
|
@@ -141,9 +166,9 @@ |
|
141
|
166
|
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
|
167
|
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
|
168
|
9. An example of the "Random Justified Gallery" layout.
|
|
144
|
169
|
|
|
145
|
|
-== Frequently Asked Questions ==
|
|
170
|
+## Frequently Asked Questions
|
|
146
|
171
|
|
|
147
|
172
|
= If I disable the plugin what happens to the galleries? =
|
|
148
|
173
|
|
|
149
|
174
|
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.
|
|
@@ -157,46 +182,26 @@ |
|
157
|
182
|
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
|
183
|
|
|
159
|
184
|
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
|
185
|
|
|
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.
|
|
186
|
+However, if you really wanted to keep that plugin, Photonic offers a way out there too! For each provider (e.g. Flickr, SmugMug etc.) go to the Settings page, e.g. <em>Photonic → Settings → SmugMug → SmugMug Settings → Disable lightbox linking</em> and set that option.
|
|
162
|
187
|
|
|
163
|
|
-= My Instagram gallery is not working. Are you really sure the plugin is working? =
|
|
164
|
|
-
|
|
165
|
|
-It's complicated. Photonic's code works for Instagram's new Graph API, as can be seen from the demo URL. Photonic's Application Key was approved by Facebook for usage. However, Photonic's developer needs to be verified as an individual by Facebook, and that step is pending at the time of the release of version 2.32, due to Facebook redirecting some resources to work on COVID-19 support. The latest status may be found <a href='https://wordpress.org/support/topic/potential-disruption-for-instagram-galleries/'>here</a>.
|
|
166
|
|
-
|
|
167
|
|
-= Your link above says that all steps for Facebook's approval are complete, but my Instagram gallery is not working. Surely the plugin is not working? =
|
|
168
|
|
-
|
|
169
|
|
-Yes, the plugin is working. You simply need to re-authenticate with new API, from <em>Photonic → Authentication</em>
|
|
170
|
|
-
|
|
171
|
|
-= Why is the Google Photos setup process so painful? =
|
|
172
|
|
-
|
|
173
|
|
-Blame Big G here! Google Photos' API has several shortcomings, primary among them being the high number of API calls required to fetch a gallery. This would cause API keys to routine hit their limits if they were being used for too many galleries. This makes it impossible for developers to authenticate users using their API keys without signing up for the Google Partners program. Unfortunately Photonic's design is not one of the use cases supported by the Partners program.
|
|
174
|
|
-
|
|
175
|
|
-As a net result, to prevent users from getting locked out using Photonic's API key, it is an unfortunate requirement that users use their own key. And this is where Google makes things needlessly complicated. Photonic's documentation is very comprehensive with instructions on how to authenticate, but that doesn't change the fact that Google's process is convoluted.
|
|
176
|
|
-
|
|
177
|
|
-= After all the pain I got Google Photos working yesterday, but today my galleries don't show up. Why? =
|
|
178
|
|
-
|
|
179
|
|
-Check if you have a caching plugin active. If so, exclude the page with Google Photos from the cache. Google Photos' URLs are short-lived, hence cannot be cached. This problem does not occur for other sources.
|
|
180
|
|
-
|
|
181
|
188
|
= What about other photo-sharing platforms? =
|
|
182
|
189
|
|
|
183
|
190
|
Suggestions are welcome for other photo-sharing platforms.
|
|
184
|
191
|
|
|
185
|
|
-= What about other JS libraries? =
|
|
192
|
+= What about other JS lightbox libraries? =
|
|
186
|
193
|
|
|
187
|
|
-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.
|
|
194
|
+You mean apart from the 17 that Photonic currently supports?? If you have specific suggestions please feel free to contact the plugin author, but only pure JS, GPL-compatible lightbox scripts will be supported.
|
|
188
|
195
|
|
|
189
|
|
-Note that there have been slight modifications to some of the above scripts to make them interact seamlessly with JQuery tooltips.
|
|
196
|
+Note that there have been slight modifications have been made to some of the lightboxes to make them play well with newer code.
|
|
190
|
197
|
|
|
191
|
198
|
= Are there any known issues? =
|
|
192
|
199
|
|
|
193
|
|
-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.
|
|
200
|
+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.
|
|
194
|
201
|
|
|
195
|
|
-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.
|
|
202
|
+The "Mosaic" layout may sometimes show 1px wide gaps between 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.
|
|
196
|
203
|
|
|
197
|
|
-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.
|
|
198
|
|
-
|
|
199
|
204
|
Apart from these, while the plugin can handle pretty much whatever you throw at it, Lubarsky's Law of Cybernetic Entomology states:
|
|
200
|
205
|
<blockquote>There is always one more bug.</blockquote>
|
|
201
|
206
|
|
|
202
|
207
|
Bug reports are welcome, and handled enthusiastically.
|
|
@@ -202,39 +207,11 @@ |
|
202
|
207
|
Bug reports are welcome, and handled enthusiastically.
|
|
203
|
208
|
|
|
204
|
209
|
= Are translations supported? =
|
|
205
|
210
|
|
|
206
|
|
-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.
|
|
211
|
+Yes, but only for the plugin front-end and the wizard. The Settings pages are not translated at this point. Also note that any strings included in the third-party JS scripts are not translated.
|
|
207
|
212
|
|
|
208
|
|
-== Upgrade Notice ==
|
|
209
|
|
-
|
|
210
|
|
-= 2.40 =
|
|
211
|
|
-
|
|
212
|
|
-Version 2.40 is a major update where the PHP code has been modernised to use namespaces. <strong>Only update if you are on PHP 5.6 or higher, or the plugin will break.</strong>
|
|
213
|
|
-
|
|
214
|
|
-= 2.33 =
|
|
215
|
|
-
|
|
216
|
|
-Version 2.32 eliminates support for versions of PHP older than 5.6. <strong>Only update if you are on PHP 5.6 or higher, or the plugin will break.</strong>
|
|
217
|
|
-
|
|
218
|
|
-This version also switches the Instagram module from the legacy API to the new API, <strong>because the legacy API is not going to be supported from 30th March 2020.</strong> At the time of releasing this version Photonic has been partially approved for Instagram use by Facebook. Facebook has paused approvals in the wake of COVID-19. See <a href='https://wordpress.org/support/topic/potential-disruption-for-instagram-galleries/'>here for the latest status</a>.
|
|
219
|
|
-
|
|
220
|
|
-= 2.10 =
|
|
221
|
|
-
|
|
222
|
|
-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>.
|
|
223
|
|
-
|
|
224
|
|
-= 2.00 =
|
|
225
|
|
-
|
|
226
|
|
-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>.
|
|
227
|
|
-
|
|
228
|
|
-= 1.57 =
|
|
229
|
|
-
|
|
230
|
|
-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>.
|
|
231
|
|
-
|
|
232
|
213
|
== Changelog ==
|
|
233
|
214
|
|
|
234
|
|
-= 2.42 =
|
|
215
|
+= 3.37 =
|
|
235
|
216
|
|
|
236
|
|
-* SmugMug "Load More" in the wizard was not working; fixed.
|
|
237
|
|
-* Beaver Builder integration was partially broken; fixed.
|
|
238
|
|
-* Google Photos galleries were not showing up on a dedicated page; fixed.
|
|
239
|
|
-* Just calling the Photonic shortcode without any attributes was causing an error; fixed
|
|
240
|
|
-
|
|
217
|
+* Fixed: Security hardening for galleries on dedicated pages
|
