WordPress 4.7

[autoinstalls/wordpress.git] / wp-admin / js / media-gallery.js

diff --git a/wp-admin/js/media-gallery.js b/wp-admin/js/media-gallery.js
index 52da393dcc5b1a16e3e22d481a84f1b1e46b0928..a71d8fe17f5ce311367ffe8ca72e2bfafd3afa4a 100644 (file)
--- a/wp-admin/js/media-gallery.js
+++ b/wp-admin/js/media-gallery.js
@@ -1,20 +1,33 @@
 /* global ajaxurl */
-jQuery(function($){
-       $( 'body' ).bind( 'click.wp-gallery', function(e){
+
+/**
+ * This file is used on media-upload.php which has been replaced by media-new.php and upload.php
+ * Deprecated since 3.5.0
+ */
+jQuery(function($) {
+       /**
+        * Adds a click event handler to the element with a 'wp-gallery' class.
+        */
+       $( 'body' ).bind( 'click.wp-gallery', function(e) {
                var target = $( e.target ), id, img_size;
 
                if ( target.hasClass( 'wp-set-header' ) ) {
+                       // Opens the image to preview it full size.
                        ( window.dialogArguments || opener || parent || top ).location.href = target.data( 'location' );
                        e.preventDefault();
                } else if ( target.hasClass( 'wp-set-background' ) ) {
+                       // Sets the image as background of the theme.
                        id = target.data( 'attachment-id' );
                        img_size = $( 'input[name="attachments[' + id + '][image-size]"]:checked').val();
 
+                       /**
+                        * This AJAX action has been deprecated since 3.5.0, see custom-background.php
+                        */
                        jQuery.post(ajaxurl, {
                                action: 'set-background-image',
                                attachment_id: id,
                                size: img_size
-                       }, function(){
+                       }, function() {
                                var win = window.dialogArguments || opener || parent || top;
                                win.tb_remove();
                                win.location.reload();