-
Notifications
You must be signed in to change notification settings - Fork 7
/
readme.txt
1009 lines (569 loc) · 31.4 KB
/
readme.txt
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
257
258
259
260
261
262
263
264
265
266
267
268
269
270
271
272
273
274
275
276
277
278
279
280
281
282
283
284
285
286
287
288
289
290
291
292
293
294
295
296
297
298
299
300
301
302
303
304
305
306
307
308
309
310
311
312
313
314
315
316
317
318
319
320
321
322
323
324
325
326
327
328
329
330
331
332
333
334
335
336
337
338
339
340
341
342
343
344
345
346
347
348
349
350
351
352
353
354
355
356
357
358
359
360
361
362
363
364
365
366
367
368
369
370
371
372
373
374
375
376
377
378
379
380
381
382
383
384
385
386
387
388
389
390
391
392
393
394
395
396
397
398
399
400
401
402
403
404
405
406
407
408
409
410
411
412
413
414
415
416
417
418
419
420
421
422
423
424
425
426
427
428
429
430
431
432
433
434
435
436
437
438
439
440
441
442
443
444
445
446
447
448
449
450
451
452
453
454
455
456
457
458
459
460
461
462
463
464
465
466
467
468
469
470
471
472
473
474
475
476
477
478
479
480
481
482
483
484
485
486
487
488
489
490
491
492
493
494
495
496
497
498
499
500
501
502
503
504
505
506
507
508
509
510
511
512
513
514
515
516
517
518
519
520
521
522
523
524
525
526
527
528
529
530
531
532
533
534
535
536
537
538
539
540
541
542
543
544
545
546
547
548
549
550
551
552
553
554
555
556
557
558
559
560
561
562
563
564
565
566
567
568
569
570
571
572
573
574
575
576
577
578
579
580
581
582
583
584
585
586
587
588
589
590
591
592
593
594
595
596
597
598
599
600
601
602
603
604
605
606
607
608
609
610
611
612
613
614
615
616
617
618
619
620
621
622
623
624
625
626
627
628
629
630
631
632
633
634
635
636
637
638
639
640
641
642
643
644
645
646
647
648
649
650
651
652
653
654
655
656
657
658
659
660
661
662
663
664
665
666
667
668
669
670
671
672
673
674
675
676
677
678
679
680
681
682
683
684
685
686
687
688
689
690
691
692
693
694
695
696
697
698
699
700
701
702
703
704
705
706
707
708
709
710
711
712
713
714
715
716
717
718
719
720
721
722
723
724
725
726
727
728
729
730
731
732
733
734
735
736
737
738
739
740
741
742
743
744
745
746
747
748
749
750
751
752
753
754
755
756
757
758
759
760
761
762
763
764
765
766
767
768
769
770
771
772
773
774
775
776
777
778
779
780
781
782
783
784
785
786
787
788
789
790
791
792
793
794
795
796
797
798
799
800
801
802
803
804
805
806
807
808
809
810
811
812
813
814
815
816
817
818
819
820
821
822
823
824
825
826
827
828
829
830
831
832
833
834
835
836
837
838
839
840
841
842
843
844
845
846
847
848
849
850
851
852
853
854
855
856
857
858
859
860
861
862
863
864
865
866
867
868
869
870
871
872
873
874
875
876
877
878
879
880
881
882
883
884
885
886
887
888
889
890
891
892
893
894
895
896
897
898
899
900
901
902
903
904
905
906
907
908
909
910
911
912
913
914
915
916
917
918
919
920
921
922
923
924
925
926
927
928
929
930
931
932
933
934
935
936
937
938
939
940
941
942
943
944
945
946
947
948
949
950
951
952
953
954
955
956
957
958
959
960
961
962
963
964
965
966
967
968
969
970
971
972
973
974
975
976
977
978
979
980
981
982
983
984
985
986
987
988
989
990
991
992
993
994
995
996
997
998
999
1000
=== Lightbox with PhotoSwipe ===
Contributors: awelzel
Tags: lightbox, photoswipe, attachments, images, gallery
Requires at least: 5.3
Tested up to: 6.7
Stable tag: 5.5.1
Donate link: https://paypal.me/ArnoWelzel
License: GPLv2
License URI: http://www.gnu.org/licenses/gpl-2.0.html
Integration of PhotoSwipe (http://photoswipe.com) for WordPress.
== Description ==
This plugin integrates PhotoSwipe to WordPress. All linked images in a post or page will be displayed using PhotoSwipe, regardless if they are part of a gallery or single images. Just make sure that you link the image or gallery directly to the media and not the attachment page (in galleries the option `link=file` should be set).
More about the original version of PhotoSwipe see here: [http://photoswipe.com](http://photoswipe.com)
You can also display EXIF data from JPEG and WEBP images.
As of version 4.0.0 this plugin requires at least WordPress 5.3 and PHP 7.0. Older PHP version will cause problems. In this case you have to upgrade your PHP version or ask your hoster to do so. Please note that WordPress itself also recommends at least PHP 7.4 - see [https://wordpress.org/about/requirements/](https://wordpress.org/about/requirements/).
== Installation ==
1. Extract the contents of the package to the `/wp-content/plugins/lightbox-photoswipe` directory
2. Activate the plugin through the 'Plugins' menu in WordPress
== Frequently Asked Questions ==
= Issues with "optimizing" plugins =
The plugin uses JavaScript modules for PhotoSwipe 5. This will not work, if you use any kind of "JavaScript optimizing" with a WordPress plugin which combines all frontend scripts into one single file. Make sure that Lightbox with PhotoSwipe is excluded from any kind of "optimization", otherwise the plugin may not work.
= Using the plugin =
All linked images in a post or page will be displayed using PhotoSwipe, regardless if they are part of a gallery or single images.
Make sure that you link the image or gallery directly to the media and not the attachment page (in galleries the option `link=file` should be set).
If you want to display an image in it's own lightbox which does not display other images from the same post or page, you can add the attribute `data-lbwps-gid` to the link element with a unique value for this image. This value must not be a number since numbers are already used internally. For example you could the file name of the image like this:
`<a href="myimage.jpg" data-lbwps-gid="myimage.jpg"><img src="myimage-300x300.jpg" alt="My Image" /></a>`
You can also add the same `data-lbwps-gid` attribute to multiple single images to combine them in the same lightbox.
Note: the parameter was renamed from `data-gallery-id` to `data-lbwps-gid` in version 2.97 to avoid conflicts with existing themes or plugins!
Starting with release 3.1.14 this is also supported for Elementor image widgets and Elementor image carousel widgets.
= How to disable the plugin in certain pages/posts =
Please note: the order of the parameters have changed in version 1.90.
Some other plugins use PhotoSwipe as well and it may be neccessary to disable Lightbox with PhotoSwipe on some pages or posts - for example on the product pages of WooCommerce.
You can either configure the pages/posts manually in the settings or you can use the filter `lbwps_enabled`. This filter gets the ID of the current page/post and if the lightbox is currently enabled (`true` or `false`). If the filter returns `true`, the lightbox will be used, if it returns `false` the lightbox will be disabled - which means, no scripts and stylesheets will be included at all on the current page/post.
Example:
`
// Disable Lightbox with PhotoSwipe on WooCommerce product pages
function my_lbwps_enabled($enabled, $id)
{
if (function_exists('is_product')) {
if (is_product()) return false;
}
return $enabled;
}
add_filter('lbwps_enabled', 'my_lbwps_enabled', 10, 2);
`
= How to modify the caption =
The individual parts of the caption can be modified using the following filters. Each filter gets the ID of the current page/post and the original text to be used. You can either return the text as it is or modify it if needed.
`
lbwps_caption_caption
lbwps_caption_title
lbwps_caption_description
lbwps_caption_filename
lbwps_caption_exif
`
Example:
`
// Add copyright notice to caption title
function my_lbwps_caption_title($title, $id)
{
return sprintf('%s<br>Copyright (c) %s Foobar', $title, date('Y'));
}
add_filter('lbwps_caption_title', 'my_lbwps_caption_title', 10, 2);
`
= Changes with PhotoSwipe 5 =
PhotoSwipe 5 improves the overall performance and compatibility with newer mobile devices like the iPhone 13. However, some features are no longer supported by that version:
1) Customizing the display of image counter and zoom button (this may be added in future updates).
2) All mobile specific options (some options may return in future updates).
3) Sharing options (some options may return in future updates).
= How to style the caption =
Which styles are available depends on which PhotoSwipe version you use and what kind of caption.
Please use the web developer tools of your browser to examine the caption elements and to learn which CSS classes
are used.
= Why is there no "zoom animation" when opening the lightbox? =
PhotoSwipe has the option to create a zoom animation from the thumbnail to the final image when opening the lightbox. However, this does not work well with square thumbnails since the thumbnail is just enlarged to the final image size without keeping its aspect ratio. This would result in a quite weird image display where a square thumbnail gets stretched to a portrait or landscape image before the final image is loaded. Just having a fade-in animation is the better solution.
= Conflict with PublishPress Blocks (Advanced Gutenberg Blocks) =
Lightbox with PhotoSwipe works fine with Gutenberg gallery blocks as well. However when you use the "PublishPress Blocks" plugin it brings its own lightbox script which can cause conflicts. To avoid any problems, you should disable the Advanced Gutenberg lightbox in the settings. Disable the option "Open galleries in lightbox" in the backend configuration of PublishPress Blocks.
= How to change the order of the images in the lightbox? =
If you want to display the images not in the order in which they are in the source code you can use the attribute `tabindex` in the image links. Also see [https://developer.mozilla.org/en-US/docs/Web/HTML/Global_attributes/tabindex](https://developer.mozilla.org/en-US/docs/Web/HTML/Global_attributes/tabindex) on how to use this attribute.
= Why are my SVG images not displayed properly in the lightbox or not displayed at all? =
SVG is a vector based format and SVG images can be displayed at any size. However PhotoSwipe needs to know the size of an image to be able to display it in the lightbox.
Lightbox with PhotoSwipe tries to determine the size based on the width/height attribute of the root element in the SVG structure. If these attributes are not available, the viewbox is used. If none of these values are present, the SVG can not be displayed in the lightbox.
Reading SVG files also requires the SimpleXML extension for PHP to be available. Without this extension SVG files can not be displayed at all.
= Licensing =
To avoid any confusion: this plugin was published with the agreement of Dmytro Semenov.
= Notes for developers =
If you change any of the stylesheets or frontend scripts in `src/js` or `src/lib` you need to run `make build` to generate new compressed frontend assets.
== Screenshots ==
1. Example for the use in the frontend
2. General options in the backend
3. Theme options in the backend
4. Options for captions in the backend
5. Desktop options in the backend
== Changelog ==
= 5.5.1 =
PhotoSwipe 5 integration:
* Fixed some issues with URL navigation when opening an image the link created by the lightbox frontend.
= 5.5.0 =
PhotoSwipe 5 integration:
* Implemented URL navigation to support the option "Update browser history" again. Going forward in the browser history after closing the lightbox will also open it again.
= 5.4.1 =
* Updated compatibility information for WordPress 6.7.
= 5.4.0 =
* Added option to use file name for captions.
= 5.3.2 =
* Updated compatibility information for WordPress 6.6.
= 5.3.1 =
* Modified f-stop symbol for EXIF display.
* Added optional lens name display for EXIF display.
* Reorganized backend options for EXIF display.
= 5.2.6 =
* Additional workarounds to deal with image links and captions in JetPack tiled galleries.
= 5.2.5 =
* Fixed handling of image rotation when using original size images using the option.
= 5.2.4 =
* Reverted EXIF handling back to native PHP EXIF extension due to performance reasons.
= 5.2.0 =
* EXIF data is now supported without the PHP EXIF extension and also for WEBP images and not only JPEG.
= 5.1.8 =
* Refactor EXIF helper and fix deprecation warning in PHP 8.3.
* Prepare EXIF support for WebP in future versions (not yet supported by PHP).
= 5.1.7 =
* Added option to disable image meta data caching in transients for special cases or debugging.
= 5.1.6 =
* Make sure, that displaying SVG images in the lightbox is supported even if WordPress does not report it as allowed file type for upload (for example when not logged in as administrator).
= 5.1.5 =
* Fixed handling of tabindex attribute in image links with Bricks image slider: if image links contain a tabindex attribute "-1", this was not treated as "no tabindex set" and could cause confusing image ordering when using image sliders which use the tabindex attribute to "hide" invisible images from keyboard navigation.
= 5.1.4 =
* Updated WordPress compatibility information.
= 5.1.3 =
* Additional handling of post content to avoid issues with dynamic page loading.
= 5.1.2 =
* Updated handling of EXIF data shutter speed for fractional values with more than 1s.
= 5.1.1 =
* Fix output of EXIF data shutter speed: instead of "123/1s" it will now be displayed as "123s" without "/1".
* Use EXIF field "FocalLength" by default and not "FocalLengthIn35mmFilm".
= 5.1.0 =
PhotoSwipe 5 integration:
* Updated PhtooSwipe to version 5.4.2.
* Added desktop sliding similar to PhotoSwipe 4.
= 5.0.44 =
* Fixed a compatibility issue with WPML. Images should now also be recognized as "local" when they are used on a translated version of the website.
= 5.0.43 =
* Fixed typo in German translation
= 5.0.42 =
PhotoSwipe 5 integration:
* Updated PhotoSwipe 5 to version 5.3.8.
* Mouse wheel is now used for scrolling by default while zooming is done by holding the Ctrl key.
* Zoom levels changed: initial zoom level is 'fit', secondary zoom level is 'fill' and maximum zoom level is 2.
= 5.0.41 =
* Updated WordPress compatibility information.
= 5.0.40 =
* Implemented backwards compatibility so PHP 5 won't break the plugin.
* Added PHP version to the info page including warnings about outdated versions.
= 5.0.34 =
* Removed hooks for creating/deleting blogs as they are not needed any longer.
= 5.0.34 =
* Fixed a problem using the WordPress API which could lead to issues with qTranslate-XT (thanks to Herr Vigg for the hint).
* Optimized backend code.
= 5.0.33 =
PhotoSwipe 5 integration:
* Adjusted style for overlay captions (`.pswp__dynamic-caption--overlay`) so they are easier to read on front of bright images.
= 5.0.32 =
* Fixed a problem for sites which have a different URLs for site and frontend (thanks to Chris Whitford for the hint).
= 5.0.31 =
* Added support for [Multiple Domain Mapping on Single Site](https://wordpress.org/plugins/multiple-domain-mapping-on-single-site/) to process images on mapped domains correctly.
= 5.0.30 =
* Added options for maximum image width/height.
= 5.0.23 =
* Fixed missing header in backend settings.
= 5.0.22 =
* Update translations.
PhotoSwipe 5 integration:
* Added options to change background opacity and image padding.
= 5.0.21 =
* Fix image width and height for images with EXIF rotation recorded in the IFD0 group.
= 5.0.20 =
* Fixed checks for smaller image sizes if image is in portrait format.
* Added explanation about opening transitions and image sizes in the "Info" tab.
* Making translation easier by adding the translation domain as string and as plugin constant.
* Backend settings with a more readable layout by using a limited maximum text width.
= 5.0.19 =
PhotoSwipe 4 integration:
* Fixed a problem when using an URL fragment to open an image.
= 5.0.18 =
PhotoSwipe 5 integration:
* Updated "fullscreen" plugin to use the updated UI handler registration.
= 5.0.17 =
* Added filters for caption text parts.
PhotoSwipe 5 integration:
* Updated "fullscreen" plugin to support iPad.
= 5.0.16 =
PhotoSwipe 5 integration:
* Added translations for UI tooltip labels.
* Updated plugins for "auto hide UI" and "fullscreen" to fix potential bugs and add translations.
= 5.0.15 =
PhotoSwipe 5 integration:
* Reverted background click in desktop to the original "close lightbox" behaviour and made UI elements clickable even if hidden - as it was implemented in PhotoSwipe 4 - to avoid confusion when UI hides automatically in desktop mode.
* Optimized frontend styles to include only one minimized file.
= 5.0.14 =
PhotoSwipe 5 integration:
* Change background click action in desktop mode to "toggle controls" to avoid confusion when UI hides automatically in desktop mode.
= 5.0.13 =
* Fix meta data handling for "external" images.
= 5.0.12 =
* Using PhotoSwipe 5 with "overlay" caption by default.
* Keep URL parameters in image links when reading image information for external images.
* Fix bug when using image URLs with hash.
= 5.0.8 - 5.0.11 =
* Several fixes in EXIF data handling.
= 5.0.8 =
* Internal code refactoring.
PhotoSwipe 5 integration:
* Updated dynamic caption plugin to version 1.2.6.
* Hide dynamic caption if it is using "mobile" view instead of "aside" or "below" and the controls are hidden.
= 5.0.7 =
* Fix wrong URL for smaller preview images if they exist.
= 5.0.6 =
PhotoSwipe 5 integration:
* Do not display fullscreen button if the device does not support that.
= 5.0.5 =
PhotoSwipe 5 integration:
* Create modules for fullscreen mode and automatic hiding the UI.
* Keep dynamic caption always visible.
= 5.0.4 =
PhotoSwipe 5 integration:
* Fixed caption hiding if there is nothing to display.
* Fixed display of captions in "overlay" mode on mobile devices.
* Added automatic hiding of captions in desktop mode.
= 5.0.3 =
* Fixed a possible warning if an image has no preview size.
= 5.0.2 =
* Minimum required WordPress version is now 5.3.
* Added official release of PhotoSwipe 5 (thanks to Dmitry Semenov for his support!).
* Added option to fix links to scaled images.
* If possible PhotoSwipe will now be opened with lower resolution preview images for better performance.
= 4.0.8 =
* Restore focus to the opening image after closing the lightbox.
= 4.0.7 =
* Fixed calculation of fstop value in EXIF data for non apex values.
= 4.0.6 =
* Fixed a potential problem when deleting a blog.
= 4.0.5 =
* Fixed a bug which caused an error when trying to remove the plugin.
= 4.0.4 =
* Removed "lazy loading" as this is not needed any longer.
* Improved compatibility with older PHP versions (7.0 and up).
= 4.0.3 =
* Removed Twig due to namespace conflicts with other plugins.
= 4.0.2 =
* Removed cache table for image details and only use WordPress caching.
= 4.0.0 =
* Changed requirements to at least WordPress 5.0 and PHP 7.4.
* Added Composer and Twig for backend and optimized backend code.
* Fixed a bug which could prevent the cache cleanup job to be scheduled.
= 3.4.3 =
* Updated compatibility for WordPress 6.0.
= 3.4.2 =
* Removed deprecated code in frontend.
= 3.4.1 =
* Updated frontend to avoid problems with galleries like Meow which trigger DOM updates and remove event handlers on image links.
= 3.3.1, 3.3.2 =
* Remove variable types in backend code to avoid problems on hosts with very old PHP version (older than PHP 7.3).
= 3.3.0 =
* Refactored backend code.
* Updated handling of captions to make it easier to understand what exactly is used for the caption.
* Increased caption width to 960px.
* Updated EXIF display styles.
= 3.2.11 =
* Add using image title as caption.
* Remove empty brackets in EXIF information where only the camera model but no other information is available.
= 3.2.10 =
* Use correct size of the original image when "fix image link" option is enabled and image links got fixed.
= 3.2.9 =
* Fix a bug which might cause image links to get removed when the "fix image link" option is enabled.
= 3.2.8 =
* Add option to fix image links which contains size parameters. This can happen in Jetpack tiled gallery blocks.
= 3.2.6 =
* Workaround to make sure that buttons styles are not changed by WP Dark Mode.
= 3.2.5 =
* Fixed a potential warning/notice for non JPEG images when support for EXIF is enabled.
= 3.2.4 =
* Added support for CDNs which use "pull mode" like ExactDN.
= 3.2.3 =
* Fixed a potential problem in PhotoSwipe which can cause it to fail when RequireJS is present.
= 3.2.2 =
* Removed support for Internet Explorer 9 or older in frontend script to avoid issues with current browsers.
= 3.2.1 =
* Fixed a bug which caused the plugin to not work any longer when using the WordPress cache.
= 3.2.0 =
* Add support for SVG images.
= 3.1.16 =
* Image modification time is not checked any longer for external images to avoid warning messages in certain setups.
= 3.1.15 =
* Updated skins to make sure that themes or plugins which include global styles for `button` don't cause problems with the UI of PhotoSwipe.
= 3.1.14 =
* Added support to use the `data-lbwps-gid` attribute in Elementor image widgets and image carousel widgets to put images in their own lightbox (development sponsored by [https://oestreich-design.de](https://oestreich-design.de))
= 3.1.12 =
* Added a workaround to avoid warnings when image sizes can not be determined properly.
= 3.1.11 =
* Added translation for "German formal".
* Fullscreen view hides navigation on mobile devices if possible.
= 3.1.10 =
* Fixed opening images in lightbox directly via URL.
= 3.1.9 =
* Fixed an issue with multiple clickable links to the same image which got introduced with version 3.0.7.
= 3.1.8 =
* Uppercase image extension like JPG instead of jpg are no longer ignored.
= 3.1.7 =
* Images which are not located in the WordPress upload folder work again (this was a bug introduced by the Flywheel fix)
= 3.1.6 =
* Removed use of ABSPATH to determine the path of image files to avoid problems with sites hosted by Flywheel
* Fixed filter handling
= 3.1.5 =
* Hiding of scrollbars can now be turned off in case it does not work properly with theme of the site
= 3.1.4 =
* Added support for SCRIPT_DEBUG (thanks to Hristo Hristov for the suggestion)
* Optimized frontend scripts to be only one minimized file and in the footer in production mode
* Optimized stylesheets to be minimized and only one file in production mode
= 3.1.3 =
* Scrollbars will be restored after lightbox has closed and not during closing.
= 3.1.2 =
* Hiding scrollbars of the document body when opening the lightbox.
* Removed alt attribute from images inside the lightbox since this is not really useful and may cause problems with captions which contain HTML.
* Fixed missing captions for images which got scaled or rotated with the WordPress image editor (thanks to Emmanuel Liron for the fix).
= 3.1.1 =
* Reverted internal code change which caused some images not to get detected any longer properly.
= 3.1.0 =
* Added detection for DOM changes so also galleries added via JavaScript should work.
* Changed handling with relative URLs to avoid problems with Bedrock (thanks to Smeedijzer Internet for pointing this out).
= 3.0.8 =
* Fixed a bug which caused wrong sort order for links with `tabindex` (1, 2, 3, 10, 11 and not 1, 10, 11, 2, 3 etc.).
= 3.0.7 =
* Refactored naming of functions and variables.
* Made PhotoSwipe gallery instance available globally as `window.lbwpsPhotoSwipe` for other plugins (thanks to Thomas Biering for the suggestion).
* Added support for relative image URLs.
* Added support for `tabindex` attribute in image links.
* Multiple links to the same image created by some "lazy loading" solutions will be ignored.
* Native lazy loading will only be added to an image if the attribute is not set already.
= 3.0.6 =
* New option to use the WordPress caching instead of a custom database table (thanks to B-e-n-G).
* New option to ignore links to images on external sites.
* New option to ignore links to images which contain a hash.
* New option to handle custom CDN URLs.
= 3.0.5 =
* Captions are now used including HTML code.
= 3.0.4 =
* Added missing translation.
* Changed frontend initialization to be faster and more compatible.
= 3.0.3 =
* Fixed invalid HTML in the backend settings.
= 3.0.2 =
* Fixed a bug which caused the lightbox not to work when there are links to images without visible thumbnails inside.
= 3.0.1 =
* Fixed a PHP warning if the size of an image could not be determined.
= 3.0 =
* New backend interface with tabs.
* Added option to exclude by post type.
* The lightbox will no longer be disabled on the home page, archive pages or search results if it is disabled in one or more pages/posts.
* Updated frontend code to improve compatibility with older browsers.
* Fixed redundant database updates which might cause a performance issue.
= 2.100 =
* Fix in caption handling for images with captions referred using `aria-describedby` which was broken since 2.94.
= 2.99 =
* Fix in caption handling for images with `data-caption-title` and `data-caption-desc` attributes.
= 2.97 =
* Images will now show during the opening transition of the lightbox.
* Renamed data attributes to avoid conflicts with existing themes or plugins.
= 2.96 =
* Editor meta box can be disabled in the backend settings.
= 2.94 =
* Removed jQuery again after some code refactoring.
* Added editor meta box, so you can disable the lightbox in pages/posts itself.
= 2.92 =
* Fix in database cleanup.
= 2.90 =
* Added more options for using the mouse wheel in desktop view: zoom and switching images.
* Added sharing options.
* Fixed captions when EXIF output is enabled and EXIF data is missing in an image.
= 2.81 =
* Fixed an issue with the database.
= 2.80 =
* Added optional display of EXIF date.
* Fixed another bug for adding lazy loading attributes for images.
= 2.77 =
* Adding of lazy loading turned off by default since this may cause problems with certain themes and plugins. You can enable it again manually in the backend settings, if you want to keep this feature.
= 2.76 =
* Fixed a bug for adding lazy loading attributes for images.
= 2.75 =
* Additional checks for output buffering.
* New option to configure the timeout before controls will hide automatically in desktop view.
* New option to add native lazy loading to images.
* Added support for image descriptions.
= 2.70 =
* Restored use of jQuery to fix compatibility issues with some themes and plugins.
= 2.66 =
* Fixed a bug in caption handling to use alt attributes if no other caption source is available.
= 2.65 =
* Change enqueue handle names for scripts to avoid compatibility issues with some themes.
* Refactored frontend script to remove jQuery.
* Added CSS rule to automatically rotate images based on EXIF data.
= 2.64 =
* Common caption for Gutenberg gallery blocks is now recognized as well.
= 2.63 =
* Slide animation for using the arrows in desktop view can be disabled.
= 2.62 =
* Additional changes to improve compatibility with Borlabs Cookie.
= 2.60, 2.61 =
* Added slide animation for changing images using the arrow buttons or keyboard.
* Fixed direct opening of images using gid/pid parameter in the URL.
= 2.51 =
* Changed buffer handling again to avoid problems with images created outside the main content.
= 2.50 =
* Use browser history modification by default (you can turn this off in the settings if you don't want this).
* Added a workaround for a bug in the CSS rule for buttons in Twenty Twenty to avoid the wrong background color for UI elements.
* Added option to display WordPress galleries and Gutenberg gallery blocks in separate lightboxes.
* Changed handling of output buffering to avoid potential problems with CDNs and caching plugins.
= 2.13 =
* Fixed handling of images with URL parameters.
= 2.12 =
* Fixed WordPress 5.3 compatibility in backend.
= 2.10, 2.11 =
* Fixed incorrect handling of external images which are not served by the website itself.
* Better error handling if EXIF data can not be read.
= 2.9 =
* Fix for a bug when displaying only two images on a page and the second image is opened first.
= 2.7, 2.8 =
* Additional option to display EXIF information as caption.
= 2.6 =
* Full screen mode can now also be activated by pressing the key "F" on the keyboard.
* Set maximum possible priority for the output filter so it will be called at the latest possible moment.
= 2.5 =
* If images links contain attributes `data-caption-title` and `data-caption-desc` these attributes will be used as separate elements in the caption.
= 2.4 =
* Fixed a bug when using full picture size in desktop view.
* Endless loop is now also supported with only two images.
* Added an option to use the alternative text in the image as caption if needed.
= 2.3 =
* Clicking images will no longer close them.
= 2.2 =
* Added option to show pictures in full size in desktop view.
= 2.1 =
* Closing the lightbox by clicking the background enabled again and made configurable.
= 2.0 =
* The lightbox will not close any longer when clicking the background.
* Fix to avoid PHP notices because of using dynamic methods as static ones.
* Changed experimental feature "return on close" to "open URL on close".
= 1.99 =
* Modified "return on close" option to return to the previous URL without closing animation.
* Added option to select between image or lightbox URL when sharing on Facebook or Twitter.
* Added missing translations.
= 1.98 =
* Added backend option to enable or disable "tap to toggle UI controls" gesture on mobile devices.
* Added experimental support for "return on close" (see the description how to use this).
* Internal links without domain part (`/wp-content/...` instead of `http://domain.example/wp-content/...`) now also work.
* Code refactoring: frontend script is now called "js/scripts.js".
* Improved support for captions in Meow Gallery.
= 1.97 =
* Added WebP as supported image format.
= 1.96 =
* Fixed a bug when the size of an image could not be determined.
= 1.95 =
* Sharing on Facebook or Twitter will now use the image URL.
= 1.94 =
* PhotoSwipe with Lightbox will now also be included on error pages with status HTTP 404.
= 1.93 =
* Direct links to images using URL parameters `gid` and `pid` work again.
= 1.92 =
* Added support for reading caption from figcaption (thanks to Maciej Majewski contributing this feature).
* Added support for captions in Gutenberg gallery blocks.
* Fixed database upgrade behaviour for new installations to make sure all defaults and cleanup job are set properly.
* When deleting the plugin in the backend, plugin options will now also get removed from the WordPress database.
= 1.91 =
* Fixed some CSS issues with some themes which could cause the lightbox buttons not to show properly.
= 1.90 =
* Fixed wrong order in `lbwps_enabled` filter.
= 1.84 =
* Added option to enable or disable the fullscreen button in PhotoSwipe (thanks to Thomas Biering contributing this feature).
= 1.83 =
* Removed visible grey placeholder when opening the lightbox.
= 1.82 =
* Code refactoring
= 1.81 =
* Improved handling of linked images in certain galleries.
= 1.80 =
* Added support for remote images outside the domain of the website.
* Added scheduled internal cleanup of cached image sizes.
= 1.74 =
* Fixed potential performance issue and improved handling of linked images with line breaks or spaces/tabs between link and image tag.
= 1.73 =
* Fixed non working option for "allow infinite loop".
= 1.72 =
* Fixed non working option for "pinch to close".
= 1.71 =
* Reading captions from the database can be disabled.
* Captions from the database are now texturized to have proper curly quotes, dashes etc..
* Additional option to enable or disable pinch to close gesture.
* Additional option to enable or disable infinite loop.
* Change in PhotoSwipe: disabling loop option now also applies to the desktop view.
= 1.70 =
* Using client side captions from the gallery, if image meta data can not be loaded using its URL.
= 1.69 =
* Fixed supressing of lightbox UI if the plugin is disabled by a setting or the `lbwps_enabled` filter.
= 1.68 =
* Fixed supressing of script output if the plugin is disabled by a setting or the `lbwps_enabled` filter.
= 1.67 =
* Fixed missing captions if images got added using HTTPS and served via HTTP or vice versa
* Improved handling of multilined captions
= 1.65 =
* Fixed caption handling: captions should now always be displayed if enabled
= 1.64 =
* Zoom button can be disabled
* Captions can be disabled
* Spacing between pictures can be adjusted
* Refactoring for better PSR compliance
* Fix in PhotoSwipe: images will now fade out, when closing them by dragging them vertically up or down.
= 1.63 =
* Fixed missing captions in lightbox for "Cleaner Gallery".
* Added documentation about the local changes in PhotoSwipe.
= 1.61 =
* Added filter to modify the PhotoSwipe markup, if needed.
= 1.60 =
* Added selectable skins and new "share" symbol in PhotoSwipe.
* Added filter for disabling the lightbox if needed.
= 1.52 =
* Fixed an issue with opening images using URL parameters.
= 1.51 =
* Improved handling of browser history: URLs which refer to specific images will open the lightbox as well.
* Some frontend code refactoring.
= 1.50 =
* Added more customization options for PhotoSwipe.
= 1.40 =
* Fixed an issue with "will-change" CSS hints.
* Fixed a potential issue with internal options names.
* Renamed JavaScript object which is used by WordPress to pass translated labels in the frontend from `object_name` to `lightbox_photoswipe`.
* Sharing options can now be configured.
* Layout modifications for the sharing menu.
= 1.30 =
* Added "share" button in frontend.
= 1.20 =
* Added a setting in the backend to exclude the lightbox on certain pages or posts.
= 1.14 =
* Fixed an issue with additional attributes in the surrounding anchor element of pictures (thanks to user conducivedata for the suggestion).
= 1.13 =
* Fixed a problem which may occur when activating the plugin after an older version already had been in use.
= 1.11 =
* Fix in PhotoSwipe: when closing an image by zooming out, the image will not be displayed once again to fade out.
= 1.10 =
* Fixed problems with Firefox for Android which needs `button` elements to handle the UI properly.
= 1.9 =
* Modified CSS rules to make sure that the lightbox is not covered by other elements.
= 1.8 =
* Change UI elements from `button` to `div` to avoid layout problems with certain themes (Hamilton, Oria).
= 1.7 =
* Fix in PhotoSwipe: when closing an image by a vertical drag, the image was displayed again once to fade out, even though it was already moved out of the view. Now the image will just be closed and not be faded out after dragging it up or down.
= 1.6 =
* Added workaround for pictures served by Jetpack Photon.
* Code refactoring.
= 1.5 =
* Changed multisite handling.
= 1.4 =
* Fixed an upgrade/installation issue.
= 1.3 =
* Fixed an upgrade issue.
= 1.2 =