WordPress.org

What does this plugin do, exactly?

a. For any image contained in a post that has been specified as linked to the image source (the default, e.g. a large image resized to 'medium' and linked to the larger version), add a rel attribute with the value facebox. This is accomplished as a filter on the_content.

b. Any linked content inside a shortcode gallery will demonstrate identical behaviour to those linked images in posts; viz., when clicked they will giggle and squee in delight, emitting sunshine and rainbow glitter.

Or, you know, a Facebook-style lightbox appears with the linked content.

What does this plugin not do?

This plugin does not allow for you to select image files or file directories for turning into a gallery...yet! If the demand and support for this plugin increases I may add this functionality. In the meantime, plugins such as NextGen Gallery has the functionality you are looking for.

How do I add title's & captions to my images?

a. The title is pulled from the image title attribute. Using WordPress's insert image or edit image, the Title field.

b. The description / caption is pulled from the image alt attribute. Using WordPress's insert image, use the Alternate Text field. When editing an existing image in wordpress, select Advanced Settings at the top to find the Edit Alternate Text field.

Note: The fields mentioned in a & b will inlude the title and alt attributes in the proper place without having to manually edit html.

How do I add title's & captions to inline content?

At this time, the plugin is incapable of adding title's and caption for inline content calls. It is on my todo list and of course popularity, ratings and donation incentives go a long way here.

What version of jQuery does it use?

WP Facebox Gallery uses the same version and instance of jQuery installed with WordPress and is used by the WordPress dashboard. The WordPress included version is typically not the latest version and is updated periodically.

What else can it do?

a. You can link to Divs, ex. <a href="#mydiv" rel="facebox">text</a>

b. You can link to pages via AJAX, ex. <a href="remote.html" rel="facebox">text</a>

Does this plugin work with all WordPress versions?

This plugin has been tested to work with 2.8 and newer. If you are using an older version, it is highly recommended to upgrade for your sites own security.

The plugin installed correctly but nothing happens

a. I have found the plugin wp-minify destroys the jQuery reference which is essential for this plugin to work correctly.

b. You may have another plugin installed that is trying to do something very similiar. I suggest disabling all other plugins, and check to see if it begins working. If it does, re-enable each plugin one by one and checking inbetween. Once you have found the culprit, please post a comment at my blog letting me know and I will add it to a list of plugin that can cause it to break until I find a solution for it.

c. You may not be linking correctly to an image file or content. Linking to content requires you manually add the attribute to re="facebox" while linking to images does this automatically.

What plugins are known to break WP Facebox Gallery

a. WP Minify: Corrupts jQuery reference