=== Shadowbox JS === Contributors: sivel Donate Link: https://www.paypal.com/cgi-bin/webscr?cmd=_donations&business=C3UA7TDWM4NLQ&lc=US&item_name=Donations%20for%20Sivel%2enet%20WordPress%20Plugins&cn=Add%20special%20instructions%20to%20the%20seller&no_shipping=1&rm=1&return=http%3a%2f%2fsivel%2enet%2fthanks¤cy_code=USD&bn=PP%2dDonationsBF%3abtn_donateCC_LG%2egif%3aNonHosted Tags: shadowbox-js, shadowbox, js, javascript, overlay, images, movies, audio, youtube, formatting, links, post, posts, lightbox, thickbox, lightview Requires at least: 2.6 Tested up to: 2.8 Stable tag: 2.0.4.1 A javascript media viewer similar to Lightbox and Thickbox only better. Supports all types of media, not just images. == Description == A javascript media viewer similar to Lightbox and Thickbox only better. Supports all types of media, not just images. This plugin uses [Shadowbox.js](http://mjijackson.com/shadowbox/) written by [Michael J. I. Jackson](http://mjijackson.com). Javascript libraries supported are: None, YUI, Prototype, jQuery, Ext, Dojo and MooTools. Ext is included with the plugin, Prototype and jQuery are used from the Javascript libraries included with Wordpress, YUI is loaded from Yahoo APIs, Dojo and Mootools are loaded from Google APIs. This plugin can also be used as a drop in lightbox replacement, without requiring you to edit posts already using lightbox. By default this plugin will use Shadowbox for all image links, movie links, audio links and YouTube/Google Video links including those generated by the [gallery] shortcode. Please use the Shadowbox JS [support forum](http://forum.sivel.net/viewforum.php?id=4) for problems or questions with this plugin. Support questions will be ignored if left in the WordPress.org support forums, as comments on my site, through my contact form or by email. The only supported location for support questions is [http://forum.sivel.net/](http://forum.sivel.net). == Installation == 1. Upload the `shadowbox-js` folder to the `/wp-content/plugins/` directory 1. Activate the plugin through the 'Plugins' menu in WordPress 1. Optional: Visit the settings page in the Admin at `Settings>Shadowbox JS` NOTE: See "Other Notes" for Upgrade and Usage Instructions as well as other pertinent topics. == Frequently Asked Questions == = What image file types will this plugin automatically add Shadowbox to? = bmp, gif, png, jpg, and jpeg = What movie file types will this plugin automatically add Shadowbox to? = swf, flv, f4v, dv, mov, moov, movie, mp4, asf, wm, wmv, avi, mpg and mpeg = What audio file types will this plugin automatically add Shadowbox to? = mp3 and aac = When I click on my YouTube links I see the full YouTube web site and not just my video. What is wrong? = You have probably used the wrong form of the YouTube URL. If you used something like `http://www.youtube.com/watch?v=3D3kFn_3xRY` that will disaply the YouTube website and not just the video. To just get the video use a link that looks like `http://www.youtube.com/v/3D3kFn_3xRY`. = Why does fullscreen in YouTube videos or similar does not work? = Shadowbox.js does not currently support fullscreen in SWF video players. There is a fix that should be included in the next release of shadowbox.js by Michael J. I. Jackson. = How can I make Shadowbox.js work with Microsoft Internet Explorer 8? = Currently Shadowbox.js does not support IE8. However, using the compatibility meta tag to force IE8 to render as IE7 will allow Shadowbox.js to work correctly. To enable IE8 support visit `Settings->Shadowbox` JS in the WordPress admin and set `Internet Explorer 8 Hack` to `true`. = Is there a way to make Shadowbox start working before the page has completely finished loading? = Yes. On the Settings page for Shadowbox JS change the Javascript Library to something other than 'None'. Doing so will use the DOMReady event for that specific Javascript Library instead of waiting for window.onload to be completed. = How can I use a custom Shadowbox skin without having to worry about it being deleted during the upgrade process? = Place your custom skin in a location where it will not get removed. For example in your current themes directory. Below is an example: `wp-content/themes/yourthemename/shadowbox-custom-skin` Once you have placed the skin in this directory you will need to add a few lines to your themes functions.php file. Below is some sample code: ` function shadowbox_custom_skin($skin) { $skin = 'http://example.org/wp-content/themes/yourthemename/shadowbox-custom-skin'; return $skin; } add_filter('shadowbox_skin', 'shadowbox_custom_skin'); ` = Why isn't this plugin working? = Check to make sure that you have `` in your themes header.php and `` in your themes fotoer.php. See the default WordPress theme for examples. Also see the FAQ below. = This plugin has stopped working since I installed another plugin or another plugin has stopped working since I installed this plugin. What can I do? = Try changing the Javascript Library used by this plugin to something other than 'None' on the Shadowbox JS settings page in the WordPress admin. == Screenshots == 1. An Image 2. A Website 3. A YouTube Video == Upgrade == 1. Deactivate the Shadowbox JS plugin 1. Delete the previous `shadowbox-js` folder from the `/wp-content/plugins/` directory 1. Upload the new `shadowbox-js` folder to the `/wp-content/plugins/` directory 1. Activate the Shadowbox JS plugin 1. Optional: Visit the settings page in the WordPress admin at `Settings>Shadowbox JS` == Usage == 1. By default this plugin will add the activator attributes to all image links, movie links, audio links and YouTube/Google Video links that do not already have the activator attribute. Meaning basically, by default all images in the posts on your site will automatically be displayed using Shadowbox. If you want more fine grain control over the links continue with the next steps. 1. Create a link in your post in the following format (This link can be to pretty much anything including websites, video files, YouTube, Google Video and inline content): `<a href="http://domain.tld/directory/to/image.jpg" rel="shadowbox[album]">Image</a>` 1. Be sure to include `rel="shadowbox"` as this activates the plugin. 1. If `rel="shadowbox[album]"` is included the portion listed here as `[album]` will group multiple pictures into an album called album. Do not use `[gallery]` to define an album as WordPress has a shortcode that will interfere. 1. If you are using this as a lightbox replacement you do not need to change `rel="lightbox"` to `rel="shadowbox"`. Shadowbox.js supports `rel="lightbox"` natively. 1. If you want to make a gallery/album and only want one link to display you can use `class="hidden"` to hide the additional links. 1. See [http://mjijackson.com/shadowbox/doc/usage.html#markup](http://mjijackson.com/shadowbox/doc/usage.html#markup) for detailed markup instructions. 1. If you are using using Shadowbox globally for all images but have an image you do not wish to use Shadowbox on use `rel="nobox"` in your image link. = NOTE: = Do not use the visual editor for doing the above. Use the code editor. When modifying this post in the future do not use the visual editor; please use the code editor always. To disable the visual editor for all users see the [http://wordpress.org/extend/plugins/easy-disable-visual-editor/](Easy Disable Visual Editor) plugin. == File Payloads == = None: = `450B 1 HTML/Text 5KB 6 Images 66KB 5 Javascript Files 6KB 2 Stylesheet Files 47KB 13 All` = YUI: = `576B 1 HTML/Text 5KB 6 Images 36KB 4 Javascript Files 6KB 2 Stylesheet Files 56KB 14 All` = Dojo: = `569B 1 HTML/Text 5KB 6 Images 64KB 5 Javascript Files 6KB 2 Stylesheet Files 74KB 14 All` = jQuery: = `565B 1 HTML/Text 5KB 6 Images 37KB 4 Javascript Files 6KB 2 Stylesheet Files 76KB 14 All` = MooTools: = `533B 1 HTML/Text 5KB 6 Images 77KB 5 Javascript Files 6KB 2 Stylesheet Files 86KB 14 All` = Ext: = `698B 1 HTML/Text 5KB 6 Images 154KB 6 Javascript Files 6KB 2 Stylesheet Files 164KB 15 All` = Prototype: = `564B 1 HTML/Text 5KB 6 Images 157KB 5 Javascript Files 6KB 2 Stylesheet Files 167KB 14 All` == Change Log == = 2.0.4.1 (2009-03-24): = * Add IE8 support by way of the X-UA-Compatibile meta tag = 2.0.4.0 (2009-03-18): = * Use domready events for javascript libraries other than None for intialization of shadowbox so that shadowbox works before the page is completely loaded * Initial support for WordPress 2.8, more updates will finalized as WordPress 2.8 is finalized * Bulgarian translation for shadowbox.js added (Thanks [Method-X](http://method-x.net/) for the translation) * Code cleanup * Change default size for Youtube videos * Add automation to the_excerpt so links in custom excerpts can utilize shadowbox * Support for custom skins using a filter (see the FAQ) = 2.0.3.3 (2009-01-23): = * Fix issue where replacement was trying to be done when no replacements were necessary * Add feature to attempt to automatically set Shadowbox language based on defined WordPress language * Only load the required javascript in the admin when on the shadowbox-js settings page * Clean up code = 2.0.3.2 (2008-12-26): = * Fix animate and animateFade select options, were true/true, now true/false * Fix PHP warnings about non-existent $_POST array indexes = 2.0.3.1 (2008-12-23): = * Updated invalid php start tag = 2.0.3.0 (2008-12-23): = * Added options page to admin interface * Added support to automatically use Shadowbox for movie, audio and YouTube/Google Video links. = 2.0.2.1 (2008-09-22): = * Fixed typo in variable name containing the previous rel attribute of the link = 2.0.2 (2008-09-22): = * Added support to automatically use Shadowbox to display all images in your posts including those generated by the [gallery] shortcode. * Added deactivator rel attribute. Use rel="nobox" to not use Shadowbox to display an image when global activation is configured. = 2.0.1 (2008-08-25): = * updated code for readability * Added support for [gallery] shortcode = 2.0 (2008-08-11): = * Updated shadowbox.js to version 2.0 * Added various options and changes to support shadowbox.js version 2.0 * Updated javascript library locations to use Google APIs and Yahoo APIs where applicable. * Changed versioning of the plugin to match that of the shadowbox.js version = 0.4 (2008-04-10): = * Updated to use assetURL for location to shadowbox files * Cleaned up code and added extended comments * Added extras.css with support for hidden class * Added support to not include javascript libraries = 0.3 (2008-02-26): = * Updated Shadowbox.js to version 1.0 Final * Added support for Ext, Dojo and MooTools Javascript Libraries * Removed lightbox2shadowbox function/filter as Shadowbox.js now natively supports rel="lightbox" * Consolidated repetitive code * Removed images that were not in use * Selected MooTools as the default as it contains the smallest payload = 0.2 (2008-02-22): = * Initial Public Release