描述
The main purpose of the ‘Lightbox Images for Divi’ plugin is to extend Divi’s native lightbox functionality to all auto-linked images, not just Divi galleries.
Requirements:
This plugin requires ONE of the following to be installed and active:
* Divi Theme (version 4.10 or higher)
* Divi Builder Plugin (version 4.10 or higher)
The plugin will automatically check for these requirements during activation and will not activate if they are not met.
Main features:
- Full Divi 5 Support: Works with Divi 5 pages, including backwards compatibility mode. No jQuery required — the plugin works in vanilla JavaScript with an elegant built-in lightbox when Magnific Popup is not available
- Attachment Page Links: Now handles images linked to WordPress attachment pages (not just direct image URLs), resolving the full-size image automatically
- Dependency Checking: Automatically verifies Divi theme or Divi Builder plugin is active before allowing activation
- Extended Compatibility: Works with the Divi or Divi Builder theme, compatible with Divi 4.10+ and Divi 5
- Native Integration: Uses Divi’s Magnific Popup when available, falls back to a lightweight built-in lightbox otherwise
- Easy to Use: Simply install and activate the plugin. No additional configuration is required
- Optimized Performance: Vanilla JavaScript with no hard dependencies. CSS and JS loaded conditionally
- Ready for the Future: Works in both Divi 4 (jQuery/Magnific Popup) and Divi 5 (vanilla JS fallback) environments
- Extensible: Includes a filter (
ayudawp_lightbox_selectors) that allows developers to customize CSS selectors to include or exclude specific elements
This plugin enhances the user experience on websites built with Divi, ensuring that any image linked to itself (i.e., clicking on it opens the image in its full size) is displayed in a lightbox effect.
Unlike Divi’s default functionality, which often restricts this effect to galleries, this plugin extends it to all individual images, providing a consistent and engaging visual experience.
The plugin is ideal for photographers, bloggers, and any Divi user who wants to offer a more polished and professional image viewing experience without the need for complex configurations or additional gallery plugins.
Support
Need help or have suggestions?
Love the plugin? Please leave us a 5-star review and help spread the word!
About AyudaWP
We are specialists in WordPress security, SEO, and performance optimization plugins. We create tools that solve real problems for WordPress site owners while maintaining the highest coding standards and accessibility requirements.
屏幕截图
安装
- Important: Make sure you have either Divi theme active OR Divi Builder plugin installed and active before proceeding
- Upload the
lightbox-images-for-divi-enhancedfolder to/wp-content/plugins/directory - Activate the plugin via the ‘Plugins’ menu in WordPress
- The plugin will automatically check for Divi compatibility and prevent activation if requirements are not met
- That’s it! All your auto-linked images will now open in a lightbox
常见问题
-
What happens if I don’t have Divi installed?
-
The plugin will not activate and will show an error message explaining that either Divi theme or Divi Builder plugin is required.
-
Can I use this plugin with other themes?
-
No, this plugin is specifically designed to work only with the Divi ecosystem (Divi theme or Divi Builder plugin). It will not function with other WordPress themes.
-
What happens if I deactivate Divi after installing this plugin?
-
The plugin will automatically deactivate itself and show an admin notice explaining why it was deactivated.
-
Is it compatible with Divi 5?
-
Yes, the plugin fully supports Divi 5. It works both in backwards compatibility mode (using Magnific Popup) and in native Divi 5 pages (using a lightweight built-in lightbox). No jQuery is required.
-
Does it work with images linked to attachment pages?
-
Yes, since version 2.2.0 the plugin handles both direct image URLs (e.g. photo.jpg) and WordPress attachment page links. The full-size image is resolved automatically from the embedded image element.
-
How can I customize the image selectors?
-
For advanced users and developers, the plugin provides an
ayudawp_lightbox_selectorsfilter. You can use this filter in your child theme’sfunctions.phpfile to add or modify the CSS selectors that the plugin uses to identify images. For example:php add_filter( 'ayudawp_lightbox_selectors', 'my_custom_lightbox_selectors' ); function my_custom_lightbox_selectors( $selectors ) { $selectors[] = '.my-custom-module a'; // Add selector for custom module return $selectors; } -
Does this plugin work with Divi Builder plugin on non-Divi themes?
-
Yes, as long as you have the Divi Builder plugin installed and active, the plugin will work regardless of your active theme.
评价
贡献者及开发者
更新日志
2.2.3
- Fixed lightbox not working on images in the WordPress classic/block editor post content field when rendered by Divi’s Post Content module
- The Post Content module container (
.et_pb_post_content) is now correctly recognized as an allowed content area
2.2.2
- Replaced exclusion-based (blacklist) approach with a whitelist strategy for maximum compatibility with third-party modules
- The plugin now only acts inside Divi text modules, blurb content, and plain WordPress editor content, leaving all other modules untouched
- Fixes interference with third-party modules like Divi Blog Extra, Divi Machine, and any future modules
2.2.1
- Fixed lightbox being applied to unintended elements like menu logos, blog thumbnails, third-party module images, and CTA images
- Removed overly broad
.et_pb_module aCSS selector from defaults to prevent interference with non-content modules - Added exclusion list for Divi modules that handle their own click behavior (menus, blogs, portfolios, sliders, shop, headers, etc.)
- Fixed direct image URL links not opening in lightbox because Magnific Popup was not being initialized directly by the plugin
2.2.0
- Full Divi 5 compatibility: rewritten JavaScript in vanilla JS without jQuery dependency
- Added support for images linked to WordPress attachment pages (not just direct image URLs)
- New built-in fallback lightbox for environments where Magnific Popup is not available
- Improved image URL resolution: extracts full-size image from srcset or strips WordPress size suffix
- Added debounced MutationObserver for better performance with dynamically loaded content
- Added accessibility attributes (role, aria-modal, aria-label) to the fallback lightbox
- New CSS file for fallback lightbox styles
- jQuery is now an optional dependency (used if available, not required)
- Keyboard support: Escape key closes the lightbox
- Added new FAQ entries about Divi 5 and attachment page links
- Tested up to WordPress 7.0
2.1.1
- Tested up to WordPress 6.9
2.1 – 2025-09-11
- Improved user experience during plugin activation with friendly admin notices instead of error pages
- Enhanced dependency checking system with automatic plugin deactivation
- Added comprehensive compatibility verification during plugin activation
- Improved error messages with clear requirements explanation
- Added automatic deactivation if Divi is removed after plugin activation
- Better detection of Divi Builder plugin vs Divi theme
- Added support link in plugin action links
- Improved version detection for better compatibility checking
- Enhanced admin notices for better user experience
- Removed deprecated load_plugin_textdomain() function call
2.0 – 2025-08-04
- Complete refactoring of the code to a class structure (Singleton)
- Migration of the JavaScript script to an external file (
assets/js/lightbox-images-for-divi.js) - Use of
wp_enqueue_scriptfor more efficient script loading and following WordPress best practices - Optimization of CSS/jQuery selectors for greater robustness and compatibility with future versions of Divi (including Divi 5)
- Implementation of a filter (
ayudawp_lightbox_selectors) to allow customization of selectors - Improved verification of compatibility with Divi and its version
- Added uninstall hook for cleaning options
- Updated plugin information (version, author, etc.)
- Improved internal documentation and the
readme.txtfile
1.0.7 – 2024-07-18
- Initial version