Easy FancyBox plugin for WordPress websites gives you a flexible and aesthetic light box solution for just about all media links on your website. Easy FancyBox uses an updated version of the traditional FancyBox jQuery extension and is WP 3+ Multi-Site compatible. After activation you can find a new section FancyBox on your Settings > Media admin page where you can manage the media light box options.
After activation, all links to JPG, GIF and PNG images are automatically opened in the FancyBox Mac/Gnome-style lightbox that floats over the web page.
GDPR / EU Privacy
This plugin does not collect any data and does not set any browser cookies. However, the PRO version offers an option to disable the automatic popup after the first visit, which needs a browser cookie. This cookie stores the visitors first website visit timestamp and path on the client side. It is not shared nor is any data stored server side or elsewhere.
Supported media and content types:
- All common image formats including webp
- Hosted video on Youtube, Vimeo and Dailmotion
- PDF files (embed with object tag, in iframe or in external Google Docs Viewer)
- SVG media images (thanks to Simon Maillard)
- Inline HTML content (see instructions in the FAQs)
- External web pages (see instructions in the FAQs)
- WordPress Galleries (option “Link to” must be set to “Media File”)
- NextGEN galleries (see instructions)
- Image maps (see instructions)
- WordPress menu items (see instructions in the FAQs)
- Jetpack Infinite Scroll
- WordPress Multsite (see Installation instructions)
- Modal window option (see instructions in the FAQs)
- Automatic detection of media file links
- Automatic detection of galleries
- Popup on page load optional (see instructions in the FAQs)
- Fade or Elastic popup effects
- Styling options for light box overlay (colour and opacity) and window (border size and colour)
For advanced options and priority support, there is a Pro extension available. See Pro features below.
See FAQ’s for instructions to manage YouTube, Dailymotion and Vimeo movies (and similar services) and tips to make inline content display in a FancyBox overlay.
Get support on the Easy FancyBox web page or WordPress forum.
Visit FancyBox for more information and examples.
- Priority support on dedicated forum
- Slideshow effect for galleries (autorotation)
- Spotlight effect for the light box overlay
- FacetWP, Gravity Forms and TablePress compatibility
- More styling options: rounded corners, inline content background and text colours
- More automatic popup options: triggered by URL hash, first link by media type, hide popup after first visit
- Pass dedicated light box setting per media link via link class (see Metadata instructions in the FAQs)
- More elastic (easing) popup effects on open and close
- Show/hide image title on mouse hover
- Fine-tune media link and gallery autodetection to match your theme source markup to allow galleries per post for example
For these additional features, you need to install the Pro extension alongside this free plugin.
If you’re happy with this plugin as it is, please consider writing a quick rating or helping other users out on the support forum.
If you wish to help build this plugin, you’re very welcome to translate Easy FancyBox into your language or contribute bug reports, feature suggestions and/or code on Github.
Known conflicts & issues
Quick installation: Install now !
… OR …
Search for “easy fancybox” and install with that slick Plugins > Add New back-end page.
… OR …
Follow these steps:
Upload the zip file via the Plugins > Add New > Upload page … OR … unpack and upload with your favourite FTP client to the /plugins/ folder.
Activate the plugin on the Plugins page.
Done! By default, any images that are linked to directly (not to a WordPress page) from within your posts and pages, should now be opening in a FancyBox overlay 🙂
Not happy with the default settings? Check out the new options under Settings > Media.
WordPress MU / WordPress 3+ in Multi Site mode
Install as above. You can activate the plugin per site, or network wide.
When activating the plugin per site, each site will have the Images media type activated and Easy FancyBox will immediately try opening image links in the light box.
When activated network wide with Network Activate, each sub-site will not have any media type activated. The options will be there for individual site admins, ready to either activate or leave deactivated.
Basically, it is a fancy way of presenting images, movies, portable documents and inline content on your website. For example, if you have scaled-down images in your posts which are linked to the original large version, instead of opening them on a blank page, FancyBox opens those in a smooth overlay. Visit FancyBox for more information and examples.
Which version of FancyBox does this plugin use?
This plugin uses an updated version of the original FancyBox 1.3.4, better adapted to the mobile era.
I installed the plugin. What now?
First, make sure that image thumbnails in your posts and pages are linked to their full size counterpart directly. Open any post with thumbnail images in it for editing and select the first thumbnail. Click the Edit Image button that appears and choose Link To: Media File. From now on, clicking that thumbnail should open the full size version in FancyBox.
The same thing goes for WordPress Galleries. Choose Link To: Media File when inserting a gallery tag.
Where is the settings page?
There is no new settings page but there are many options you can change. You will find a new FancyBox section on Settings > Media. To see the default, check out the example under Screenshots …
Help! It does not work…
Please follow the trouble shooting steps to determine the cause. If that fails, ask for support on the Easy FancyBox WordPress forum or go to the development site
I have another question…
See the advanced Easy FancyBox FAQ’s.
Contributors & Developers
“Easy FancyBox” is open source software. The following people have contributed to this plugin.Contributors
“Easy FancyBox” has been translated into 14 locales. Thank you to the translators for their contributions.
Translate “Easy FancyBox” into your language.
Interested in development?
Browse the code, check out the SVN repository, or subscribe to the development log by RSS.
* FIX: ARIA attributes
* FIX: jQuery.fn.click() shorthand deprecated
- FIX: Classic large content scroll
- FIX: Classic gallery overflow flicker
- FIX: Legacy float title position
- FIX: upgrade notice
- FIX: overlay opacity ignored (classic)
- FIX: onStart not a function (legacy)
- FIX: Passing event parameters failing
- FIX: Case insesitive selectors failing
- FIX: Admin message display issue
- NEW: Swipe support
- NEW: Optional fancyBox 2 or Legacy scripts
- Fixed background
- Dropped IE6-8 support
- Dropped SWF support (only availbale in Legacy)
- Accessibility improvements
- Admin settings links
- Pro compatibility message for VideoPress
- NEW: Exclude selector option
- FIX: border 0 ignored sometimes
- FIX: Jetpack Tiled Gallery block compatibility
- Don’t include mousewheel script by default
- SECURITY: fixed failing color value sanitization + added inline styles output filter, issue reported by Jakob Hagl sba-research.org
- Pro compatibility messages
- Support forum link
- FIX: Trying to get property ‘ID’ of non-object
- mark WordPress 5.2 compatible
- FIX: inline wrapper nesting issue
- Revert to file names without version
- FIX: version constant issue
- Prepare Visual Composer Masonry Grid Gallery compatibility option
- FIX: Vimeo player direct links breaking
- Force default autoselector for galleries
- Prevent gallery next/prev links to show dud target
- FIX: allow youtube url parameters before v=
- Autoplay Youtube/Vimeo/Dailymotion
- FIX: Exclude Vimeo user pages from autodetect
- FIX: Exclude facebook/twitter share link
- FIX: PDF embed tag
- Gutenberg file block download button compatibility
- Gutenberg gallery block compatibility
- FIX: Missing argument in easyFancyBox::add_video_wmode_opaque()
- Remove version URL parameters
- FIX: jQuery 3+ e.indexOf is not a function
- FIX: prevent Inline content title
- Improved centre on scroll behaviour with title outside
- FIX: Pro options compatibility
- FIX: AutoScale option restored
- FIX: outline issue in Firefox
- Prevent SiteGround Optimizer warning about break outside loop
- FIX: main method not returning true in some cases
- Force all hosted video to https
- FIX: video iframe needs allow=”autoplay” on modern browsers
- FIX: default enqueue priority not 10
- FIX: possible infinite loop in prev/next and image preloader
- Move main method (back) to init, position 9
- Introducing easy_fancybox_enqueue_scripts action hook
- NEW: Google Docs Viewer for PDF
- NEW: Youtube privacy-enhanced embed
- NEW: Compatibility options: late script inclusion, jquery exclusion, no wp_add_inline_script
- FancyBox: Improved mobile viewport height detection
- FancyBox: now skips subsequent double links in gallery
- FancyBox: new PDF content type
- FancyBox: improved error messages
- Dedicated IE8 stylesheet
- jQuery Easing update to 1.4.1
- NEW: Aspect ratio for video frames on smaller screens
- NEW: Global minimum screen size
- NEW: Loading icon for video/iframe content
- NEW: Resize light box on device orientation or browser window size change
- NEW: Modal window class and close button class
- FIX: pre PHP 5.4 compatibility
- FIX: iPhone iframe scrolling
- FIX: Autoptimize compatibility
- Switch to wp_add_inline_script() script printing, thanks @szepeviktor
- FIX: inline js minification incompatibility, thanks @alexiswilke
- FIX: line breaks hidden on options media admin page since WP 4.9, thanks @garrett-eclipse
- Nolightbox class in menu also for other media types than images
- FIX: CSS colour code
- Spelling fixes, thanks @garrett-eclipse
- FIX: Pinterest button compatibility
- FIX: Double load plugin text domain
- Add webp to default Autodetect image types
- Exclude more rel attribute values from galleries
- BUGFIX: gallery preload
- Update jquery.easing.js and jquery.mousewheel.js
- BUGFIX: use dirname(FILE) instead of relying on DIR to be available
- Explicit transparency for gallery navigation links
- FIX: variable variable php 7 compat
- FIX: obj undefined in minified js
- FIX: nofancybox in menu ignored, thanks Trishah
- Colour value sanitize
- NEW: auto popup delay
- NEW: pro extension version compatibility check routine
- NEW: margin option
- NEW: iFrame alow full screen option
- Dropped mu-plugins support
- Added support for universal nolightbox class
- Set focus on iframe after load
- FIX: No centre on scroll on touch devices
- FIX: Allow fullscreen videos
- FIX: Pro extension link update
- NEW: WebP support and class=’image’ to force image media type
- IE 6-8 css rules optional
- iframe embed for Youtube, Vimeo and Dailymotion
- Croation translation
- HTML5 players allowfullscreen default
- iPad positioning patch
- Don’t unregister scripts that are not ours even for conflict prevention
- box-sizing: border-box issue in Firefox fixed
- Allow mousewheel scrolling page in the background again
- Prevent mousewheel scrolling page in the background
- New stylesheet IE alphaimageloader path fix approach
- Czech translation added
- Updated Indonesian translation
- BUGFIX: easy_fancybox_handler() in combo with trigger(‘click’) causes Uncaught Exception script error
- FIX: jQuery 1.9+ compatibility
- Dropping support for gForms again — “Cannot convert ‘c’ to object” error in combination with some older gForms version 🙁
- NEW: support for Infinite Scroll by Jetpack
- FIX: CSS3 box-sizing issue (Twenty Thirteen) misplacing close button
- NEW: Added SVG support. Thanks to Simon Maillard.
- Pre WP 3.6: jQuery 1.9+ compatibility
- JQuery Mousewheel extension update to 3.1.3
- NEW: Elegant Themes compatibility
- Some small Touch device compatibility improvement hacks to the 1.3.4 script
- Major plugin overhaul: Class implementation
- NEW: Disable hide on overlay click
- NEW: Allow automatic resizing to large image size set on Settings > Media during media upload via the hidden WordPress function media_upload_max_image_resize()
- NEW Options: iFrame scrolling, autoScale, key navigation/close, cyclic galleries
- Metadata custom parameters and Mousewheel gallery scrolling scripts optional
- Basic RTL languages/text direction support (gallery navigation inversion, title position)
- BUGFIX: https in stylesheet on Windows IIS
- Improved W3TC compatibility: query string issue
- Gravity Forms in ajax mode compatibility
- Use jQuery’s bind(‘ready’) for better ajax content compatibility
- Dynamic stylesheet response headers to allow browser caching
- Minified version of jquery.metadata.js
- Auto-detect on image map areas
- nolightbox class for menu items
- SECURITY: Settings sanitization
- BUGFIX: load_textdomain firing after the main settings array is loaded, leaving text strings in it untranslated.
- BUGFIX: missing signs in Youtube url regular expression
- BUGFIX: unquoted rel attribute selectors in jquery.fancybox-1.3.4.js
- BUGFIX: broken url path in IE stylesheet when missing $_SERVER[‘SERVER_NAME’]
- BUGFIX: easing extension not needed on linear easing
- NEW: Lithuanian translation
- NEW: Hindi translation
- NEW: Indonesian translation
- NEW: Romanian translation
- NEW: Polish translation
- NEW: Spanish translation
- NEW: jQuery Metadata support
- NEW: Image map AREA support for all content types
- NEW: new iFrame/HTML5 embed code for YouTube, Vimeo and Dailymotion
- NEW: fix WordPress Dailymotion auto-embed code missing wmode
- Some changes to default settings
- Updated Dutch translation
- BUGFIX: Opening speed
- NEW: Advanced option: Gallery auto-rotation
- NEW: Spotlight effect
- Improved auto-enable and auto-gallery settings
- BIGFIX: CSS IE6 hack
- BIGFIX: PDF object in IE7
- PDF embed compatibility improvement
- NEW: Show/hide title on mouse hover action
- NEW: Auto-gallery modes (Disabled, page/post images only, all)
- NEW: Dailymotion support
- Links with id fancybox-auto will be triggered on page load
- Anything with class fancybox-hidden” will be hidden
- Support for menu items in iframe
- Added class nofancybox for exclusion when auto-enabling
- FancyBox script version 1.3.4 (2010/11/11 – http://fancybox.net/changelog/)
- NEW: Support for PDF
- NEW: Easing options
- YouTube, Vimeo and iFrame options adjustable
- lots and lots of more options!
- BIGFIX: work-around for missing wmode in WordPress (auto-)embedded movies (credits: Crantea Mihaita)
- BIGFIX: iframe width
- BIGFIX: image overlay size in Google Chrome browser issue (FancyBox 1.3.3)
- BIGFIX: fancybox-swf
- FancyBox script version 1.3.3 (2010/11/4 – http://fancybox.net/changelog/)
- Vimeo support
- YouTube Short URL support (disabled by default)
- Auto-recognition and seperate class
- Auto-recognition and seperate class
- FancyBox script version 1.3.2 (2010/10/10 – http://fancybox.net/changelog/)
- translation .pot file available
- Dutch translation
- NEW: YouTube and Flash movie support
- NEW: Iframe support
- added option Auto-enable for…
- added option titlePosition : over / inside / outside
- added option transitionIn : elastic / fade / none
- added option transitionOut : elastic / fade / none
- small jQuery speed improvement by chaining object calls
- Using FancyBox version 1.3.1