[SPIP] +version 3.0.7
[ptitvelo/web/www.git] / www / plugins-dist / mediabox / javascript / README
diff --git a/www/plugins-dist/mediabox/javascript/README b/www/plugins-dist/mediabox/javascript/README
new file mode 100644 (file)
index 0000000..84f0d8b
--- /dev/null
@@ -0,0 +1,298 @@
+DEMONSTRATION AND INSTRUCTIONS/API:\r
+----------------------------------------------------------------------------------------------------------\r
+http://colorpowered.com/colorbox/\r
+\r
+\r
+HELP:\r
+----------------------------------------------------------------------------------------------------------\r
+Visit the ColorBox mailing list if you have any questions or problems.\r
+http://groups.google.com/group/colorbox/topics\r
+\r
+\r
+RELEASE NOTES:\r
+----------------------------------------------------------------------------------------------------------\r
+Version 1.3.6 - Jan 13 2010\r
+Files Changed: jquery.colorbox.js/jquery.colorbox-min.js\r
+* Small change to make Colorbox compatible with jQuery 1.4\r
+\r
+\r
+Version 1.3.5 - December 15 2009\r
+Files Changed: jquery.colorbox.js/jquery.colorbox-min.js\r
+* Fixed a bug introduced in 1.3.4 with IE7's display of example 2 and example 3, and auto-width in Opera.\r
+* Fixed a bug introduced in 1.3.4 where colorbox could not be launched by triggering an element's click\r
+  event through JavaScript.\r
+* Minor refinements.\r
+\r
+\r
+Version 1.3.4 - December 5 2009\r
+Files Changed: jquery.colorbox.js/jquery.colorbox-min.js\r
+* Event delegation is now used for elements that ColorBox is assigned to, rather than individual click events.\r
+* Additional callbacks have been added to represent other stages of ColorBox's lifecycle.\r
+  Available callbacks, in order of their execution: onOpen, onLoad, onComplete, onCleanup, onClosed\r
+  These take place at the same time as the event hooks, but will be better suited than the hooks for\r
+  targeting specific instances of ColorBox.\r
+* Ajax content is now immediately added to the DOM to be more compatible if that content contains script tags.\r
+* Focus is now returned to the calling element on closing.\r
+* Fixed a bug where maxHeight and maxWidth did not work for non-photo content.\r
+* Direct calls no longer need 'open:true', it is assumed.  Example: $.fn.colorbox({html:"<p>Hi</p>"});\r
+\r
+\r
+Version 1.3.3 - November 7 2009\r
+Files Changed: jquery.colorbox.js/jquery.colorbox-min.js\r
+* Changed $.fn.colorbox.element() to return a jQuery object rather the DOM element.\r
+* jQuery.colorbox-min.js is compressed with Google's Closure Compiler rather than YUI Compressor.\r
+\r
+\r
+Version 1.3.2 - October 27 2009\r
+Files Changed: jquery.colorbox.js/jquery.colorbox-min.js\r
+* Added 'innerWidth' and 'innerHeight' options to allow people to easily set the size dimensions for\r
+  ColorBox, without having to anticipate the size of the borders and buttons.\r
+* Renamed 'scrollbars' option to 'scrolling' to be in keeping with the existing HTML attribute.  The option\r
+  now also applies to iframes.\r
+* Bug fix: In Safari, positioning occassionally incorrect when using '100%' dimensions.\r
+* Bug fix: In IE6, the background overlay is briefly not full size when first viewing.\r
+* Bug fix: In Firefox, opening ColorBox causes a split second shift with a small minority of webpage layouts.\r
+* Simplified code in a few areas.\r
+\r
+\r
+Version 1.3.1 - September 16 2009\r
+Files Changed: jquery.colorbox.js/jquery.colorbox-min.js/colorbox.css/colorbox-ie.css(removed)\r
+* Removed the IE-only stylesheets and conditional comments for example styles 1 & 4.  All CSS is handled by\r
+  a single CSS file for all examples.\r
+* Removed user-agent sniffing from the js and replaced it with feature detection.  This will allow correct\r
+  rendering for visitors masking their agent type.\r
+\r
+\r
+Version 1.3.0 - September 15 2009\r
+Files Changed: jquery.colorbox.js/jquery.colorbox-min.js/colorbox.css\r
+* Added $.fn.colorbox.resize() method to allow ColorBox to resize it's height if it's contents change.\r
+* Added 'scrollbars' option to allow users to turn off scrollbars when using the resize() method.\r
+* Renamed the 'resize' option to be less ambiguous.  It's now 'scalePhotos'.\r
+* Renamed the 'cbox_close' event to be less ambiguous.  It's now 'cbox_cleanup'.  It is the first thing to\r
+  happen in the close method while the 'cbox_closed' event is the last to happen.\r
+* Fixed a bug with the slideshow mouseover graphics that appeared after ColorBox is opened a 2nd time.\r
+* Fixed a bug where ClearType may not work in IE6&7 if using the fade transition.\r
+* Minor code optimizations to increase compression.\r
+\r
+\r
+Version 1.2.9 - August 7 2009\r
+Files Changed: jquery.colorbox.js/jquery.colorbox-min.js\r
+* Minor change to enable use with $.getScript();\r
+* Minor change to the timing of the 'cbox_load' event so that it is more useful.\r
+* Added a direct link to a YouTube video to the examples.\r
+\r
+\r
+Version 1.2.8 - August 5 2009\r
+Files Changed: jquery.colorbox.js/jquery.colorbox-min.js\r
+* Fixed a bug with the overlay in IE6\r
+* Fixed a bug where left & right keypress events might be prematurely unbound.\r
+\r
+\r
+Version 1.2.7 - July 31 2009\r
+Files Changed: jquery.colorbox.js/jquery.colorbox-min.js, example stylesheets and background images\r
+(core styles have not changed and the updates will not affect existing user themes / old example themes)\r
+* Code cleanup and reduction, better organization and documentation in the full source.\r
+* Added ability to use functions in place of static values for ColorBox's options (thanks Ken!).\r
+* Added an option for straight HTML.  Example: $.fn.colorbox({html:'<p>Howdy</p>', open:true})\r
+* Added an event for the beginning of the closing process.  This is in addition to the event that already\r
+  existed for when ColorBox had completely closed.  'cbox_close' and 'cbox_closed' respectively.\r
+* Fixed a minor bug in IE6 that would cause a brief content shift in the parent document when opening ColorBox.\r
+* Fixed a minor bug in IE6 that would reveal select elements that had a hidden visibility after closing ColorBox.\r
+* The 'esc' key is unbound now when ColorBox is not open, to avoid any potential conflicts.\r
+* Used background sprites for examples 1 & 4.  Put IE-only (non-sprite) background images in a separate folder.\r
+* Example themes 1, 3, & 4 received slight visual tweaks.\r
+* Optimized pngs for smaller file size.\r
+* Added slices, grid, and correct sizing to the Adobe Illustrator file, all theme files are now export ready!\r
+\r
+\r
+Version 1.2.6 - July 15 2009\r
+Files Changed: jquery.colorbox.js/jquery.colorbox-min.js\r
+* Fixed a bug with fixed width/height images in Opera 9.64.\r
+* Fixed a bug with trying to set a value for rel during a direct call to ColorBox.\r
+  Example: $.fn.colorbox({rel:'foo', open:true});\r
+* Changed how href/rel/title settings are determined to avoid users having to manually update ColorBox\r
+  settings if they use JavaScript to update any of those attributes, after ColorBox has been defined.\r
+* Fixed a FF3 bug where the back button was disabled after closing an iframe.\r
+\r
+\r
+Version 1.2.5 - June 23 2009\r
+Files Changed: jquery.colorbox.js/jquery.colorbox-min.js\r
+* Changed the point at which iframe srcs are set (to eliminate the need to refresh the iframe once it has\r
+  been added to the DOM).\r
+* Removed unnecessary return values for a very slight code reduction.\r
+\r
+\r
+Version 1.2.4 - June 9 2009\r
+Files Changed: jquery.colorbox.js, jquery.colorbox-min.js\r
+* Fixed an issue where ColorBox may not close completely if it is closed during a transition animation.\r
+* Minor code reduction.\r
+\r
+\r
+Version 1.2.3 - June 4 2009\r
+* Fixed a png transparency stacking issue in IE.\r
+* More accurate Ajax auto-sizing if the user was depending on the #cboxLoadedContent ID for CSS styling.\r
+* Added a public function for returning the current html element that ColorBox is associated with.\r
+  Example use: var that = $.fn.colorbox.element();\r
+* Added bicubic scaling for resized images in the original IE7.\r
+* Removed the IE6 stylesheet and png files from Example 3.  It now uses the same png file for the controls\r
+  that the rest of the browsers use (an alpha transparency PNG8).  This example now only has 2 graphics\r
+  files and 1 stylesheet.\r
+\r
+\r
+Version 1.2.2 - May 28 2009\r
+* Fixed an issue with the 'resize' option.\r
+\r
+\r
+Version 1.2.1 - May 28 2009\r
+* Note: If you are upgrading, update your jquery.colorbox.js and colorbox.css files.\r
+* Added photo resizing.\r
+* Added a maximum width and maximum height. Example: {height:800, maxHeight:'100%'}, would allow the box\r
+  to be a maximum potential height of 800px, instead of a fixed height of 800px.  With maxHeight of 100%\r
+  the height of ColorBox cannot exceed the height of the browser window.\r
+* Added 'rel' setting to add the ability to set an alternative rel for any ColorBox call.  This allows the\r
+  user to group any combination of elements together for a gallery, or to override an existing rel.\r
+  attribute so those element are not grouped together, without having to alter their rel in the HTML.\r
+* Added a 'photo' setting to force ColorBox to display a link as a photo.  Use this when automatic photo detection\r
+  fails (such as using a url like 'photo.php' instead of 'photo.jpg', 'photo.jpg#1', or 'photo.jpg?pic=1')\r
+* Removed the need to ever create disposable elements to call colorbox on.  ColorBox can now be called\r
+  directly, without being associated with any existing element, by using the following format:\r
+  $.fn.colorbox({open:true, href:'yourLink.xxx'});\r
+* ColorBox settings are now persistent and unique for each element.  This allows for extremely flexible\r
+  options for individual elements.  You could use this to create a gallery in which each page in the gallery\r
+  has different settings.  One could be a photo with a fade transition, next could be an inline element\r
+  with an elastic transition with a set width and height, etc.\r
+* For user callbacks, 'this' now refers to the element colorbox was opened from.\r
+* Fixed a minor grouping issue with IE6, when transition type is set to 'none'.\r
+* Added an Adobe Illustrator file that contains the borders and buttons used in the various examples.\r
+\r
+\r
+Version 1.2 - May 13 2009\r
+* Note: If you are upgrading from a previous version of ColorBox, see the UPGRADE file.\r
+\r
+* Added a slideshow feature.\r
+* Added re-positioning on browser resize.  If the browser is resized, ColorBox will recenter itself onscreen.\r
+* Added hooks for key events: cbox_open, cbox_load, cbox_complete, cbox_closed.\r
+  Example of using the hooks to build a primitive sideshow:\r
+  $().bind('cbox_complete', function(){\r
+    setTimeout($.fn.colorbox.next, 1500);\r
+  });\r
+* Fixed an IE transparency-stacking problem, where transparent PNGs would show through to the background\r
+  overlay.\r
+* Fixed an IE iframe issue where the ifame might shift up and to the left under certain circumstances.\r
+* Fixed an IE6 bug where the loading overlay was not at full height.\r
+* Removed the delay in switching between same-sized gallery content when using transitions.\r
+* Changed how iframes are loaded to make it more compatible with iframed pages that use DOM dependent\r
+  JavaScript.\r
+* Changed how the JS is structured to be better organized and increase compression.  Increased documentation.\r
+* Changed CSS :hover states to a .hover class.  This sidesteps a minor IE8 bug with css hover states and\r
+  allows easier access to hover state user styles from the JavaScript.\r
+* Changed: elements added to the DOM have new ID's.  The naming is more consistent and less likely to cause\r
+  conflicts with existing website stylesheets.  All stylesheets have been updated.\r
+* Changed the behavior for prev/next links so that ColorBox does not get hung up on broken links.  A visitor\r
+  can now skip through broken or long-loading links by clicking prev/next buttons.\r
+* Changed the naming of variables in the parameter map to be more concise and intuitive.\r
+* Removed colorbox.css.  Combined the colorbox.css styles with jquery.colorbox.js:\r
+  the css file was not large enough to warrant being a separate file.\r
+\r
+\r
+Version 1.1.6 - April 28 2009\r
+* Prevented the default action of the next & previous anchors and the left and right keys for gallery mode.\r
+* Fixed a bug where the title element was being added back to the DOM when closing ColorBox while using\r
+  inline content.\r
+* Fixed a bug where IE7 would crash for example 2.\r
+* Smaller filesize: removed a small amount of unused code and rewrote the HTML injection with less syntax.\r
+* Added a public method for closing ColorBox: $.fn.colorbox.close().  This will allow iframe users to\r
+  add an event to close ColorBox without having to create an additional function.\r
+\r
+\r
+Version 1.1.5 - April 11 2009\r
+* Fixed minor issues with exiting ColorBox.\r
\r
+\r
+Version 1.1.4 - April 08 2009\r
+* Fixed a bug in the fade transition where ColorBox not close completely if instructed to close during the\r
+  fade-in portion of the transition.\r
+\r
+\r
+Version 1.1.3 - April 06 2009\r
+* Fixed an IE6&7 issue with using ColorBox to display animated GIFs.\r
+\r
+\r
+Version 1.1.2 - April 05 2009\r
+* Added ability to change content when ColorBox is already open.\r
+* Added vertical photo centering now works for all browsers (this feature previously excluded IE6&7).\r
+* Added namespacing to the esc-key keydown event for people who want to disable it: "keydown.colorClose"\r
+* Added 'title' setting to add the ability to set an alternative title for any ColorBox call.\r
+* Fixed rollover navigation issue with IE8. (Added JS-based rollover state due to a browser-bug.)\r
+* Fixed an overflow issue for when the fixed width/height is smaller than the size of a photo.\r
+* Fixed a bug in the fade transition where the border would still come up if ColorBox was\r
+  closed mid-transition.\r
+* Switch from JSMin to Yui Compressor for minification.  Minified code now under 7KB.\r
+\r
+\r
+Version 1.1.1 - March 31 2009\r
+* More robust image detection regex.  Now detects image file types with url fragments and/or query strings.\r
+* Added 'nofollow' exception to rel grouping.\r
+* Changed how images are loaded into the DOM to prevent premature size calculation by ColorBox.\r
+* Added timestamp to iframe name to prevent caching - this was a problem in some browsers if the user had\r
+  multiple iframes and the visitor left the page and came back, or if they refreshed the page.\r
+\r
+\r
+Version 1.1.0 - March 21 2009\r
+  Major Changes:\r
+* Animation is now much smoother and less resource intensive.\r
+* Added support for % sizing.\r
+* Callback option added.\r
+* Inline content now preserves JavaScript events, and changes made while ColorBox is open are also preserved.\r
+* Added 'href' setting to add the ability to set an alternative href for any anchor, or to assign the\r
+  ColorBox event to non-anchors. \r
+  Example: $('button').colorbox({'href':'process.php'})\r
+  Example: $('a[href='http://msn.com']).colorbox({'href':'http://google.com', iframe:true});\r
\r
+  Minor Changes:\r
+* Photos are now horizontally centered if they are smaller than the lightbox size.  Also vertically centered\r
+  for browsers newer than IE7.\r
+* Buttons in the examples are now included in the 'protected zone'.  The lightbox will never expand it's\r
+  borders or buttons beyond an accessible area of the screen.\r
+* Keypress events don't queue up by holding down the arrow keys.\r
+* Added option to close ColorBox by clicking on the background overlay.\r
+* Added 'none' transition setting.\r
+* Changed 'contentIframe' and 'contentInline' to 'inline' and 'iframe'.  Removed 'contentAjax' because it\r
+  is automatically assumed for non-image file types.\r
+* Changed 'contentWidth' and 'contentHeight' to 'fixedWidth' and 'fixedHeight'.  These sizes now reflect\r
+  the total size of the lightbox, not just the inner content.  This is so users can accurately anticipate\r
+  % sizes without fear of creating scrollbars.\r
+* Clicking on a photo will now switch to the next photo in a set.\r
+* Loading.gif is more stable in it's position.\r
+* Added a minified version.\r
+* Code passes JSLint.\r
+\r
+\r
+Version 1.0.5 - March 11 2009\r
+* Redo: Fixed a bug where IE would cut off the bottom portion of a photo, if the photo was larger than\r
+  the document dimensions.\r
+\r
+\r
+Version 1.0.4 - March 10 2009\r
+* Added an option to allow users to automatically open the lightbox. \r
+  Example usage: $(".colorbox").colorbox({open:true});\r
+* Fixed a bug where IE would cut off the bottom portion of a photo,\r
+  if the photo was larger than the document dimensions.\r
+\r
+\r
+Version 1.0.3 - March 09 2009\r
+* Fixed vertical centering for Safari 3.0.x.\r
+\r
+\r
+Version 1.0.2 - March 06 2009\r
+* Corrected a typo.\r
+* Changed the content-type check so that it does not assume all links to photos should actually\r
+  display photos.  This allows for Ajax/inline/and iframe calls on anchors linking to picture file types.\r
+\r
+\r
+Version 1.0.1 - March 05 2009\r
+* Fixed keydown events (esc, left arrow, right arrow) for Webkit browsers.\r
+\r
+\r
+Version 1.0 - March 03 2009\r
+* First release\r