--- a/wp/wp-admin/js/postbox.js Mon Oct 14 18:06:33 2019 +0200
+++ b/wp/wp-admin/js/postbox.js Mon Oct 14 18:28:13 2019 +0200
@@ -2,33 +2,30 @@
* Contains the postboxes logic, opening and closing postboxes, reordering and saving
* the state and ordering to the database.
*
- * @summary Contains postboxes logic
- *
* @since 2.5.0
* @requires jQuery
+ * @output wp-admin/js/postbox.js
*/
-/* global ajaxurl, postBoxL10n */
-
-/**
- * This object contains all function to handle the behaviour of the post boxes. The post boxes are the boxes you see
- * around the content on the edit page.
- *
- * @since 2.7.0
- *
- * @namespace postboxes
- *
- * @type {Object}
- */
-var postboxes;
+/* global ajaxurl, postBoxL10n, postboxes */
(function($) {
var $document = $( document );
- postboxes = {
+ /**
+ * This object contains all function to handle the behaviour of the post boxes. The post boxes are the boxes you see
+ * around the content on the edit page.
+ *
+ * @since 2.7.0
+ *
+ * @namespace postboxes
+ *
+ * @type {Object}
+ */
+ window.postboxes = {
/**
- * @summary Handles a click on either the postbox heading or the postbox open/close icon.
+ * Handles a click on either the postbox heading or the postbox open/close icon.
*
* Opens or closes the postbox. Expects `this` to equal the clicked element.
* Calls postboxes.pbshow if the postbox has been opened, calls postboxes.pbhide
@@ -76,11 +73,13 @@
}
/**
- * @summary Fires when a postbox has been opened or closed.
+ * Fires when a postbox has been opened or closed.
*
* Contains a jQuery object with the relevant postbox element.
*
* @since 4.0.0
+ * @ignore
+ *
* @event postboxes#postbox-toggled
* @type {Object}
*/
@@ -115,7 +114,7 @@
});
/**
- * @summary Hides a postbox.
+ * Hides a postbox.
*
* Event handler for the postbox dismiss button. After clicking the button
* the postbox will be hidden.
@@ -131,12 +130,14 @@
});
/**
- * @summary Hides the postbox element
+ * Hides the postbox element
*
* Event handler for the screen options checkboxes. When a checkbox is
* clicked this function will hide or show the relevant postboxes.
*
* @since 2.7.0
+ * @ignore
+ *
* @fires postboxes#postbox-toggled
*
* @returns {void}
@@ -169,7 +170,7 @@
});
/**
- * @summary Changes the amount of columns based on the layout preferences.
+ * Changes the amount of columns based on the layout preferences.
*
* @since 2.8.0
*
@@ -186,7 +187,7 @@
},
/**
- * @summary Initializes all the postboxes, mainly their sortable behaviour.
+ * Initializes all the postboxes, mainly their sortable behaviour.
*
* @since 2.7.0
* @memberof postboxes
@@ -265,10 +266,10 @@
},
/**
- * @summary Saves the state of the postboxes to the server.
+ * Saves the state of the postboxes to the server.
*
- * Saves the state of the postboxes to the server. It sends two lists, one with
- * all the closed postboxes, one with all the hidden postboxes.
+ * It sends two lists, one with all the closed postboxes, one with all the
+ * hidden postboxes.
*
* @since 2.7.0
* @memberof postboxes
@@ -297,10 +298,9 @@
},
/**
- * @summary Saves the order of the postboxes to the server.
+ * Saves the order of the postboxes to the server.
*
- * Saves the order of the postboxes to the server. Sends a list of all postboxes
- * inside a sortable area to the server.
+ * Sends a list of all postboxes inside a sortable area to the server.
*
* @since 2.8.0
* @memberof postboxes
@@ -326,7 +326,7 @@
},
/**
- * @summary Marks empty postbox areas.
+ * Marks empty postbox areas.
*
* Adds a message to empty sortable areas on the dashboard page. Also adds a
* border around the side area on the post edit screen if there are no postboxes
@@ -362,7 +362,7 @@
},
/**
- * @summary Changes the amount of columns on the post edit page.
+ * Changes the amount of columns on the post edit page.
*
* @since 3.3.0
* @memberof postboxes
@@ -383,14 +383,16 @@
* Fires when the amount of columns on the post edit page has been changed.
*
* @since 4.0.0
+ * @ignore
+ *
* @event postboxes#postboxes-columnchange
*/
$( document ).trigger( 'postboxes-columnchange' );
},
/**
- * @summary Changes the amount of columns the postboxes are in based on the
- * current orientation of the browser.
+ * Changes the amount of columns the postboxes are in based on the current
+ * orientation of the browser.
*
* @since 3.3.0
* @memberof postboxes