该插件尚未通过WordPress的最新3个主要版本进行测试。 当与较新版本的WordPress一起使用时,可能不再受到维护或支持,并且可能会存在兼容性问题。

WP Featherlight – A Simple jQuery Lightbox

描述

WP Featherlight is a WordPress lightbox plugin for adding a minimal, high-performance, responsive jQuery lightbox to your WordPress website. At its core, WP Featherlight is a WordPress plugin wrapper for the Featherlight jQuery lightbox plugin. When installed, the plugin will automatically display all standard WordPress images and galleries in a simple, minimalistic lightbox popup.

In order for WordPress images and galleries to be lightboxed, you need to select the “Media File” option when choosing where the thumbnails should link. You can also select the “Custom Link” option if you make sure to link directly to an image file. This should work for any image file, even if it’s hosted on another website.

It’s also possible to lightbox videos, iframes, and ajax content with WP Featherlight by adding data attributes to your content. For more details on custom content loading, check out the featherlight documentation.

There are no settings for WP Featherlight, so you should be able to install it without needing to configure anything. In the event you don’t want a lightbox on certain pages or posts, there is an option to disable it from within the post editor screen.

If you find a display problem, it may be related to your theme but please open an support request about it so we can look into it. For more information about the Featherlight script itself, check out their GitHub plugin page.

Developer Notes

While there are no options in the plugin, there are some handy filters to modify the default behavior. As of 0.3.0 all images which use the default WordPress captions will also include a caption when the image is lightboxed. To disable this behavior, filter wp_featherlight_captions to false.

You can also disable inclusion of the CSS and JavaScript conditionally using filters which can be found in the /includes/class-scripts.php file. If you have questions about how any part of the plugin works, please don’t hesitate to open an issue on GitHub.

Contributing

If you’d like to submit code patches or contribute in any other way, please fork the plugin on GitHub.

屏幕截图

  • A view of the jQuery lightbox in action.

评价

2023年10月10日 1 回复
I have been using this "WP Featherlight - A Simple jQuery Lightbox" plugin for many years and it's my favorite. But the plugin is not updated for more then 3 years, is it safe to use?
2022年7月24日
Light weight, easy to use, no issues. Recommended!
2021年3月1日
I love minimalism, saving resources and increasing speed, so this is for sure my choice (even though I expect that a recent review was right that the closing could be better on mobiles). But I needed to extend the captions on pictures to include a copyright notice in the lightbox view (which would have been too much in page view). So I looked at the code and found that the WordPress media library is not queried at all, so no way will we get the media library description for an image. This is how to get out of that problem with some manual coding on pages: JS finds all images on the page, and gets their captions e.g. target.parent().find( '.wp-caption-text' ) So if the caption contains a <span> this can be used together with the class „featherlight“ of the outer lightbox <div> to add an extended description hidden on the page via CSS but shown in the lightbox. Thanks to all the contributors and PLEASE keep this great plugin alive!
2021年1月19日
Sure, it's not full of options, but it does it job and does it well, no bloat. When I need it, it just works. Thanks for sharing it and the continuous update.
阅读所有95条评价

贡献者及开发者

“WP Featherlight – A Simple jQuery Lightbox” 是开源软件。 以下人员对此插件做出了贡献。

贡献者

“WP Featherlight – A Simple jQuery Lightbox”插件已被翻译至4种本地话语言。 感谢所有译者为本插件所做的贡献。

将“WP Featherlight – A Simple jQuery Lightbox”翻译成您的语言。

对开发感兴趣吗?

您可以浏览代码,查看SVN仓库,或通过RSS订阅开发日志

更新日志

1.3.3

This is primarily a maintenance release, but one tweak was made.

  • Tweak: Changed name of meta box title

1.3.2

Release to downgrade Featherlight verison until all bugs are worked out.

1.3.1

This is primarily a maintenance release, but one new feature has been added. Display the option to disable the lightbox in Gutenberg!

Here’s a full list of what’s changed since the last release:

  • Feature: Add back metabox in sidebar
  • Dev: Updated Featherlight to 1.7.14

1.3.0

While primarily a maintenance release, one new feature has been added. WP Featherlight now supports Gutenberg galleries.

Here’s a full list of what’s changed since the last release:

  • Feature: Gutenberg support
  • Tweak: General code cleanup in plugin
  • Dev: Updated Featherlight to 1.7.13
  • Change of ownership

1.2.0

This is primarily a maintenance release, but one new feature has been added. HTML in captions is now supported!

Here’s a full list of what’s changed since the last release:

1.1.0

Thanks to some changes implemented in the core featherlight script, the accessibility of WP Featherlight is now significantly improved. Lightboxed elements now have more appropriate focus management for screen readers and the close button is more accessible.

This update also fixes a potential plugin compatibly problem in the WordPress admin. In version 1.0, it was possible under unusual circumstances for the plugin to throw a fatal error when attempting to add the disable checkbox to the publish metabox.

  • Tweak: Improved accessibility (accessible close button, better focus management)
  • Fix: Prevented a fatal error that could happen when another plugin unsets the WP_Post object on the publish metabox.
  • Dev: Updated Featherlight to 1.7.0

1.0.0

Even though this is a major version change, this is primarily a maintenance release. The reason for the jump to 1.0.0 is because we’ve changed some code which could break backwards compatibility with custom extensions and integrations.

If you’re just using the plugin on your site and haven’t customized it or paid anyone to customize it for you, you should be able to update without any issues.

If you’re a developer and have written custom code extending the PHP side of WP Featherlight, be sure to test your code before updating.

Under the hood, we’ve deprecated some internal methods which could potentially break custom code which extends WP Featherlight. The changes are primarily limited to class initialization, so unless you were doing something specific to that, it’s unlikely that you’ll run into issues.

  • Tweak: Improved transition between images within galleries
  • Tweak: Moved our disable lightbox checkbox into the publish meta box to streamline the admin
  • Tweak: Made styles more aggressive to ensure elements look consistent across different themes by default
  • Fix: Reduced false positives for URLs that use image extensions but don’t actually link to an image
  • Dev: Updated Featherlight to 1.5.1
  • Dev: Updated jQuery Detect Swipe to 2.1.3
  • Dev: Deprecated some internal methods
  • Dev: Reorganized how classes are instantiated and plugin actions are fired

View the full changelog on GitHub