FancyBox plugin

FancyBox is a combination of JavaScript, CSS and some images that allow you to create a modal effect using the JavaScript framework jQuery. This Joomla! plugin integrates FancyBox in your favorite CMS Joomla!.

Screenshots

About FancyBox

FancyBox is written and maintained on the website fancybox.net. All credits go to the original creators of FancyBox. If you like FancyBox, you can donate. Please do not donate to us, but to creators of FancyBox instead.

All work of FancyBox itself is the work of Janis Skarnelis, and holds his copyright.

Installation

1. To install this plugin, download it from this page to your computer.
2. Then install the ZIP file from within the Joomla! Administrator as a normal extension.
3. Next go to the Plugin Manager to enable this system-plugin. It is listed as "System - FancyBox".

You do not need to download FancyBox from the FancyBox website.

Basic parameters

The plugin is ment for webdesigners and therefor requires knowledge of HTML. Within the plugin parameters you can find the following options:

• HTML elements: List of elements that Fancybox should be applied on (required)
• Hide on click: When enabled, the Fancybox modal box can be closed through a mouse-click (optional)
• Enable mousewheel: When enabled, you can scroll the Fancybox modal box with the mousewheel (optional)
• Transition: Which effect to apply on the appearance of the modal box (optional)
• Speed: Which speed to apply on the appearance of the modal box (optional)

Instead of relying on specific HTML markup like a rel-attribute (which is used by many other modal effects), the FancyBox plugin allows you to configure specific HTML elements. You'll need to review your own HTML source-code to see which elements should be identified. In most cases, the FancyBox-effect needs an anchor-tag with a title and a link to be activated:

a.lightbox, a.product_image, a#my_image, a.simplelists_link, a[rel=lightbox]

For each element, a new jQuery-line is added to the source-code of the page.

Advanced parameters

Within the plugin settings, you can also find the following advanced parameters:

• Use Google API: Use the Google network to serve the jQuery library
• Load CSS: Disable this, if you want to include the Fancybox CSS in your own template instead
• Load jQuery: Disable this, if jQuery is already loaded by another extension
• Load Fancybox
• Load Mousewheel
• Load Easing
• Exclude components: List of components that Fancybox should not be applied on
• jQuery namespace: Set to $j by default. Modify this, if this plugin conflicts with another jQuery-enabled
• Content-type: Allowing you to load AJAX, movies and such as well

Why FancyBox?

The main reason for us to integrate FancyBox in a Joomla! plugin, is to offer a simple Lightbox-like effect for MageBridge, our bridge extension that integrates Magento in Joomla!. As an effort to bypass JavaScript-conflicts between MooTools and ProtoType, a third framework - jQuery - is introduced which does not conflict with neither MooTools nor ProtoType. jQuery is loaded in the compatibility mode.

So, the FancyBox was primarily designed to work with MageBridge, but it might serve other purposes as well.

Help us with your feedback, by adding a review in the Joomla! Extensions Directory.

Changelog
version 0.2.3 [November 2011]	New option Content-Type
version 0.2.2 [October 2011]	Update jQuery 1.4.2 to 1.6.4 Update Fancybox 1.3.1 to 1.3.4 Fix of "Hide on click" option

This Fancybox plugin was first created in early 2010. Previous changelogs are not available.

More extensions