enmi-conf.org: comparison wp/wp-admin/js/common.js

Mercurial Mercurial > enmi-conf.org / comparison

summary | shortlog | changelog | graph | tags | bookmarks | branches | files | changeset | file | latest | revisions | annotate | diff | comparison | raw | help

wp/wp-admin/js/common.js

changeset 16	a86126ab1dd4
parent 9	177826044cd9
child 18	be944660c56a

equal deleted inserted replaced

-:3d4e9c994f10
+:a86126ab1dd4
 /**
 * @output wp-admin/js/common.js
 */
-/* global setUserSetting, ajaxurl, commonL10n, alert, confirm, pagenow */
+/* global setUserSetting, ajaxurl, alert, confirm, pagenow */
 /* global columns, screenMeta */
 /**
 *  Adds common WordPress functionality to the window.
 *
 *  @param {mixed} undefined Unused.
 */
 ( function( $, window, undefined ) {
 	var $document = $( document ),
 		$window = $( window ),
-		$body = $( document.body );
+		$body = $( document.body ),
+		__ = wp.i18n.__,
+		sprintf = wp.i18n.sprintf;
+/**
+* Throws an error for a deprecated property.
+*
+* @since 5.5.1
+*
+* @param {string} propName    The property that was used.
+* @param {string} version     The version of WordPress that deprecated the property.
+* @param {string} replacement The property that should have been used.
+*/
+function deprecatedProperty( propName, version, replacement ) {
+	var message;
+	if ( 'undefined' !== typeof replacement ) {
+		message = sprintf(
+			/* translators: 1: Deprecated property name, 2: Version number, 3: Alternative property name. */
+			__( '%1$s is deprecated since version %2$s! Use %3$s instead.' ),
+			propName,
+			version,
+			replacement
+		);
+	} else {
+		message = sprintf(
+			/* translators: 1: Deprecated property name, 2: Version number. */
+			__( '%1$s is deprecated since version %2$s with no alternative available.' ),
+			propName,
+			version
+		);
+	}
+	window.console.warn( message );
+}
+/**
+* Deprecate all properties on an object.
+*
+* @since 5.5.1
+*
+* @param {string} name       The name of the object, i.e. commonL10n.
+* @param {object} l10nObject The object to deprecate the properties on.
+*
+* @return {object} The object with all its properties deprecated.
+*/
+function deprecateL10nObject( name, l10nObject ) {
+	var deprecatedObject = {};
+	Object.keys( l10nObject ).forEach( function( key ) {
+		var prop = l10nObject[ key ];
+		var propName = name + '.' + key;
+		if ( 'object' === typeof prop ) {
+			Object.defineProperty( deprecatedObject, key, { get: function() {
+				deprecatedProperty( propName, '5.5.0', prop.alternative );
+				return prop.func();
+			} } );
+		} else {
+			Object.defineProperty( deprecatedObject, key, { get: function() {
+				deprecatedProperty( propName, '5.5.0', 'wp.i18n' );
+				return prop;
+			} } );
+		}
+	} );
+	return deprecatedObject;
+}
+window.wp.deprecateL10nObject = deprecateL10nObject;
+/**
+* Removed in 5.5.0, needed for back-compatibility.
+*
+* @since 2.6.0
+* @deprecated 5.5.0
+*/
+window.commonL10n = window.commonL10n || {
+	warnDelete: '',
+	dismiss: '',
+	collapseMenu: '',
+	expandMenu: ''
+};
+window.commonL10n = deprecateL10nObject( 'commonL10n', window.commonL10n );
+/**
+* Removed in 5.5.0, needed for back-compatibility.
+*
+* @since 3.3.0
+* @deprecated 5.5.0
+*/
+window.wpPointerL10n = window.wpPointerL10n || {
+	dismiss: ''
+};
+window.wpPointerL10n = deprecateL10nObject( 'wpPointerL10n', window.wpPointerL10n );
+/**
+* Removed in 5.5.0, needed for back-compatibility.
+*
+* @since 4.3.0
+* @deprecated 5.5.0
+*/
+window.userProfileL10n = window.userProfileL10n || {
+	warn: '',
+	warnWeak: '',
+	show: '',
+	hide: '',
+	cancel: '',
+	ariaShow: '',
+	ariaHide: ''
+};
+window.userProfileL10n = deprecateL10nObject( 'userProfileL10n', window.userProfileL10n );
+/**
+* Removed in 5.5.0, needed for back-compatibility.
+*
+* @since 4.9.6
+* @deprecated 5.5.0
+*/
+window.privacyToolsL10n = window.privacyToolsL10n || {
+	noDataFound: '',
+	foundAndRemoved: '',
+	noneRemoved: '',
+	someNotRemoved: '',
+	removalError: '',
+	emailSent: '',
+	noExportFile: '',
+	exportError: ''
+};
+window.privacyToolsL10n = deprecateL10nObject( 'privacyToolsL10n', window.privacyToolsL10n );
+/**
+* Removed in 5.5.0, needed for back-compatibility.
+*
+* @since 3.6.0
+* @deprecated 5.5.0
+*/
+window.authcheckL10n = {
+	beforeunload: ''
+};
+window.authcheckL10n = window.authcheckL10n || deprecateL10nObject( 'authcheckL10n', window.authcheckL10n );
+/**
+* Removed in 5.5.0, needed for back-compatibility.
+*
+* @since 2.8.0
+* @deprecated 5.5.0
+*/
+window.tagsl10n = {
+	noPerm: '',
+	broken: ''
+};
+window.tagsl10n = window.tagsl10n || deprecateL10nObject( 'tagsl10n', window.tagsl10n );
+/**
+* Removed in 5.5.0, needed for back-compatibility.
+*
+* @since 2.5.0
+* @deprecated 5.5.0
+*/
+window.adminCommentsL10n = window.adminCommentsL10n || {
+	hotkeys_highlight_first: {
+		alternative: 'window.adminCommentsSettings.hotkeys_highlight_first',
+		func: function() { return window.adminCommentsSettings.hotkeys_highlight_first; }
+	},
+	hotkeys_highlight_last: {
+		alternative: 'window.adminCommentsSettings.hotkeys_highlight_last',
+		func: function() { return window.adminCommentsSettings.hotkeys_highlight_last; }
+	},
+	replyApprove: '',
+	reply: '',
+	warnQuickEdit: '',
+	warnCommentChanges: '',
+	docTitleComments: '',
+	docTitleCommentsCount: ''
+};
+window.adminCommentsL10n = deprecateL10nObject( 'adminCommentsL10n', window.adminCommentsL10n );
+/**
+* Removed in 5.5.0, needed for back-compatibility.
+*
+* @since 2.5.0
+* @deprecated 5.5.0
+*/
+window.tagsSuggestL10n = window.tagsSuggestL10n || {
+	tagDelimiter: '',
+	removeTerm: '',
+	termSelected: '',
+	termAdded: '',
+	termRemoved: ''
+};
+window.tagsSuggestL10n = deprecateL10nObject( 'tagsSuggestL10n', window.tagsSuggestL10n );
+/**
+* Removed in 5.5.0, needed for back-compatibility.
+*
+* @since 3.5.0
+* @deprecated 5.5.0
+*/
+window.wpColorPickerL10n = window.wpColorPickerL10n || {
+	clear: '',
+	clearAriaLabel: '',
+	defaultString: '',
+	defaultAriaLabel: '',
+	pick: '',
+	defaultLabel: ''
+};
+window.wpColorPickerL10n = deprecateL10nObject( 'wpColorPickerL10n', window.wpColorPickerL10n );
+/**
+* Removed in 5.5.0, needed for back-compatibility.
+*
+* @since 2.7.0
+* @deprecated 5.5.0
+*/
+window.attachMediaBoxL10n = window.attachMediaBoxL10n || {
+	error: ''
+};
+window.attachMediaBoxL10n = deprecateL10nObject( 'attachMediaBoxL10n', window.attachMediaBoxL10n );
+/**
+* Removed in 5.5.0, needed for back-compatibility.
+*
+* @since 2.5.0
+* @deprecated 5.5.0
+*/
+window.postL10n = window.postL10n || {
+	ok: '',
+	cancel: '',
+	publishOn: '',
+	publishOnFuture: '',
+	publishOnPast: '',
+	dateFormat: '',
+	showcomm: '',
+	endcomm: '',
+	publish: '',
+	schedule: '',
+	update: '',
+	savePending: '',
+	saveDraft: '',
+	'private': '',
+	'public': '',
+	publicSticky: '',
+	password: '',
+	privatelyPublished: '',
+	published: '',
+	saveAlert: '',
+	savingText: '',
+	permalinkSaved: ''
+};
+window.postL10n = deprecateL10nObject( 'postL10n', window.postL10n );
+/**
+* Removed in 5.5.0, needed for back-compatibility.
+*
+* @since 2.7.0
+* @deprecated 5.5.0
+*/
+window.inlineEditL10n = window.inlineEditL10n || {
+	error: '',
+	ntdeltitle: '',
+	notitle: '',
+	comma: '',
+	saved: ''
+};
+window.inlineEditL10n = deprecateL10nObject( 'inlineEditL10n', window.inlineEditL10n );
+/**
+* Removed in 5.5.0, needed for back-compatibility.
+*
+* @since 2.7.0
+* @deprecated 5.5.0
+*/
+window.plugininstallL10n = window.plugininstallL10n || {
+	plugin_information: '',
+	plugin_modal_label: '',
+	ays: ''
+};
+window.plugininstallL10n = deprecateL10nObject( 'plugininstallL10n', window.plugininstallL10n );
+/**
+* Removed in 5.5.0, needed for back-compatibility.
+*
+* @since 3.0.0
+* @deprecated 5.5.0
+*/
+window.navMenuL10n = window.navMenuL10n || {
+	noResultsFound: '',
+	warnDeleteMenu: '',
+	saveAlert: '',
+	untitled: ''
+};
+window.navMenuL10n = deprecateL10nObject( 'navMenuL10n', window.navMenuL10n );
+/**
+* Removed in 5.5.0, needed for back-compatibility.
+*
+* @since 2.5.0
+* @deprecated 5.5.0
+*/
+window.commentL10n = window.commentL10n || {
+	submittedOn: '',
+	dateFormat: ''
+};
+window.commentL10n = deprecateL10nObject( 'commentL10n', window.commentL10n );
+/**
+* Removed in 5.5.0, needed for back-compatibility.
+*
+* @since 2.9.0
+* @deprecated 5.5.0
+*/
+window.setPostThumbnailL10n = window.setPostThumbnailL10n || {
+	setThumbnail: '',
+	saving: '',
+	error: '',
+	done: ''
+};
+window.setPostThumbnailL10n = deprecateL10nObject( 'setPostThumbnailL10n', window.setPostThumbnailL10n );
 /**
 * Removed in 3.3.0, needed for back-compatibility.
 *
 * @since 2.7.0
 	 * Binds an onClick event to the checkboxes to show or hide the table columns
 	 * based on their toggled state. And persists the toggled state.
 	 *
 	 * @since 2.7.0
 	 *
-	 * @returns {void}
+	 * @return {void}
 	 */
 	init : function() {
 		var that = this;
 		$('.hide-column-tog', '#adv-settings').click( function() {
 			var $t = $(this), column = $t.val();
 	 *
 	 * Saves whether the columns should be shown or hidden on a page.
 	 *
 	 * @since 3.0.0
 	 *
-	 * @returns {void}
+	 * @return {void}
 	 */
 	saveManageColumnsState : function() {
 		var hidden = this.hidden();
 		$.post(ajaxurl, {
 			action: 'hidden-columns',
 	 * Makes a column visible and adjusts the column span for the table.
 	 *
 	 * @since 3.0.0
 	 * @param {string} column The column name.
 	 *
-	 * @returns {void}
+	 * @return {void}
 	 */
 	checked : function(column) {
 		$('.column-' + column).removeClass( 'hidden' );
 		this.colSpanChange(+1);
 	},
 	 * Hides a column and adjusts the column span for the table.
 	 *
 	 * @since 3.0.0
 	 * @param {string} column The column name.
 	 *
-	 * @returns {void}
+	 * @return {void}
 	 */
 	unchecked : function(column) {
 		$('.column-' + column).addClass( 'hidden' );
 		this.colSpanChange(-1);
 	},
 	/**
 	 * Gets all hidden columns.
 	 *
 	 * @since 3.0.0
 	 *
-	 * @returns {string} The hidden column names separated by a comma.
+	 * @return {string} The hidden column names separated by a comma.
 	 */
 	hidden : function() {
 		return $( '.manage-column[id]' ).filter( '.hidden' ).map(function() {
 			return this.id;
 		}).get().join( ',' );
 	/**
 	 * Gets the checked column toggles from the screen options.
 	 *
 	 * @since 3.0.0
 	 *
-	 * @returns {string} String containing the checked column names.
+	 * @return {string} String containing the checked column names.
 	 */
 	useCheckboxesForHidden : function() {
 		this.hidden = function(){
 			return $('.hide-column-tog').not(':checked').map(function() {
 				var id = this.id;
 	/**
 	 * Adjusts the column span for the table.
 	 *
 	 * @since 3.1.0
 	 *
-	 * @param {int} diff The modifier for the column span.
+	 * @param {number} diff The modifier for the column span.
 	 */
 	colSpanChange : function(diff) {
 		var $t = $('table').find('.colspanchange'), n;
 		if ( !$t.length )
 			return;
 *
 * @since 2.9.0
 *
 * @param {jQuery} form The form to validate.
 *
-* @returns {boolean} Returns true if all required fields are not an empty string.
+* @return {boolean} Returns true if all required fields are not an empty string.
 */
 window.validateForm = function( form ) {
 	return !$( form )
 		.find( '.form-required' )
 		.filter( function() { return $( ':input:visible', this ).val() === ''; } )
 		.find( ':input:visible' )
 		.change( function() { $( this ).closest( '.form-invalid' ).removeClass( 'form-invalid' ); } )
 		.length;
 };
-// stub for doing better warnings
+// Stub for doing better warnings.
 /**
 * Shows message pop-up notice or confirmation message.
 *
 * @since 2.7.0
 *
 * @type {{warn: showNotice.warn, note: showNotice.note}}
 *
-* @returns {void}
+* @return {void}
 */
 window.showNotice = {
 	/**
 	 * Shows a delete confirmation pop-up message.
 	 *
 	 * @since 2.7.0
 	 *
-	 * @returns {boolean} Returns true if the message is confirmed.
+	 * @return {boolean} Returns true if the message is confirmed.
 	 */
 	warn : function() {
-		var msg = commonL10n.warnDelete || '';
+		if ( confirm( __( 'You are about to permanently delete these items from your site.\nThis action cannot be undone.\n\'Cancel\' to stop, \'OK\' to delete.' ) ) ) {
-		if ( confirm(msg) ) {
 			return true;
 		}
 		return false;
 	},
 *
 * @type {{element: null, toggles: null, page: null, init: screenMeta.init,
 *         toggleEvent: screenMeta.toggleEvent, open: screenMeta.open,
 *         close: screenMeta.close}}
 *
-* @returns {void}
+* @return {void}
 */
 window.screenMeta = {
 	element: null, // #screen-meta
 	toggles: null, // .screen-meta-toggle
 	page:    null, // #wpcontent
 	/**
 	 * Initializes the screen meta options panel.
 	 *
 	 * @since 3.2.0
 	 *
-	 * @returns {void}
+	 * @return {void}
 	 */
 	init: function() {
 		this.element = $('#screen-meta');
 		this.toggles = $( '#screen-meta-links' ).find( '.show-settings' );
 		this.page    = $('#wpcontent');
 	/**
 	 * Toggles the screen meta options panel.
 	 *
 	 * @since 3.2.0
 	 *
-	 * @returns {void}
+	 * @return {void}
 	 */
 	toggleEvent: function() {
 		var panel = $( '#' + $( this ).attr( 'aria-controls' ) );
 		if ( !panel.length )
 	 * @since 3.2.0
 	 *
 	 * @param {jQuery} panel  The screen meta options panel div.
 	 * @param {jQuery} button The toggle button.
 	 *
-	 * @returns {void}
+	 * @return {void}
 	 */
 	open: function( panel, button ) {
 		$( '#screen-meta-links' ).find( '.screen-meta-toggle' ).not( button.parent() ).css( 'visibility', 'hidden' );
 		/**
 		 * Sets the focus to the meta options panel and adds the necessary CSS classes.
 		 *
 		 * @since 3.2.0
 		 *
-		 * @returns {void}
+		 * @return {void}
 		 */
 		panel.slideDown( 'fast', function() {
 			panel.focus();
 			button.addClass( 'screen-meta-active' ).attr( 'aria-expanded', true );
 		});
 	 * @since 3.2.0
 	 *
 	 * @param {jQuery} panel  The screen meta options panel div.
 	 * @param {jQuery} button The toggle button.
 	 *
-	 * @returns {void}
+	 * @return {void}
 	 */
 	close: function( panel, button ) {
 		/**
 		 * Hides the screen meta options panel.
 		 *
 		 * @since 3.2.0
 		 *
-		 * @returns {void}
+		 * @return {void}
 		 */
 		panel.slideUp( 'fast', function() {
 			button.removeClass( 'screen-meta-active' ).attr( 'aria-expanded', false );
 			$('.screen-meta-toggle').css('visibility', '');
 			panel.parent().hide();
 /**
 * Initializes the help tabs in the help panel.
 *
 * @param {Event} e The event object.
 *
-* @returns {void}
+* @return {void}
 */
 $('.contextual-help-tabs').delegate('a', 'click', function(e) {
 	var link = $(this),
 		panel;
 	// Don't do anything if the click is for the tab already showing.
 	if ( link.is('.active a') )
 		return false;
-	// Links
+	// Links.
 	$('.contextual-help-tabs .active').removeClass('active');
 	link.parent('li').addClass('active');
 	panel = $( link.attr('href') );
-	// Panels
+	// Panels.
 	$('.help-tab-content').not( panel ).removeClass('active').hide();
 	panel.addClass('active').show();
 });
 /**
 * Enables or disables a structure tag button depending on its usage.
 *
 * If the structure is already used in the custom permalink structure,
 * it will be disabled.
 *
-* @param {object} button Button jQuery object.
+* @param {Object} button Button jQuery object.
 */
 function changeStructureTagButtonState( button ) {
 	if ( -1 !== $permalinkStructure.val().indexOf( button.text().trim() ) ) {
 		button.attr( 'data-label', button.attr( 'aria-label' ) );
 		button.attr( 'aria-label', button.attr( 'data-used' ) );
 		lastClicked = false,
 		pageInput = $('input.current-page'),
 		currentPage = pageInput.val(),
 		isIOS = /iPhone|iPad|iPod/.test( navigator.userAgent ),
 		isAndroid = navigator.userAgent.indexOf( 'Android' ) !== -1,
-		isIE8 = $( document.documentElement ).hasClass( 'ie8' ),
 		$adminMenuWrap = $( '#adminmenuwrap' ),
 		$wpwrap = $( '#wpwrap' ),
 		$adminmenu = $( '#adminmenu' ),
 		$overlay = $( '#wp-responsive-overlay' ),
 		$toolbar = $( '#wp-toolbar' ),
 	/**
 	 * Makes the fly-out submenu header clickable, when the menu is folded.
 	 *
 	 * @param {Event} e The event object.
 	 *
-	 * @returns {void}
+	 * @return {void}
 	 */
 	$adminmenu.on('click.wp-submenu-head', '.wp-submenu-head', function(e){
 		$(e.target).parent().siblings('a').get(0).click();
 	});
 	/**
 	 * Collapses the admin menu.
 	 *
-	 * @returns {void}
+	 * @return {void}
 	 */
 	$( '#collapse-button' ).on( 'click.collapse-menu', function() {
 		var viewportWidth = getViewportWidth() || 961;
-		// reset any compensation for submenus near the bottom of the screen
+		// Reset any compensation for submenus near the bottom of the screen.
 		$('#adminmenu div.wp-submenu').css('margin-top', '');
 		if ( viewportWidth < 960 ) {
 			if ( $body.hasClass('auto-fold') ) {
 				$body.removeClass('auto-fold').removeClass('folded');
 	/**
 	 * Handles the `aria-haspopup` attribute on the current menu item when it has a submenu.
 	 *
 	 * @since 4.4.0
 	 *
-	 * @returns {void}
+	 * @return {void}
 	 */
 	function currentMenuItemHasPopup() {
 		var $current = $( 'a.wp-has-current-submenu' );
 		if ( 'folded' === menuState ) {
 	 *
 	 * @since 4.1.0
 	 *
 	 * @param {jQuery} $menuItem The parent menu item containing the submenu.
 	 *
-	 * @returns {void}
+	 * @return {void}
 	 */
 	function adjustSubmenu( $menuItem ) {
 		var bottomOffset, pageHeight, adjustment, theFold, menutop, wintop, maxtop,
 			$submenu = $menuItem.find( '.wp-submenu' );
 		menutop = $menuItem.offset().top;
 		wintop = $window.scrollTop();
-		maxtop = menutop - wintop - 30; // max = make the top of the sub almost touch admin bar
+		maxtop = menutop - wintop - 30; // max = make the top of the sub almost touch admin bar.
-		bottomOffset = menutop + $submenu.height() + 1; // Bottom offset of the menu
+		bottomOffset = menutop + $submenu.height() + 1; // Bottom offset of the menu.
-		pageHeight = $wpwrap.height(); // Height of the entire page
+		pageHeight = $wpwrap.height();                  // Height of the entire page.
 		adjustment = 60 + bottomOffset - pageHeight;
-		theFold = $window.height() + wintop - 50; // The fold
+		theFold = $window.height() + wintop - 50;       // The fold.
 		if ( theFold < ( bottomOffset - adjustment ) ) {
 			adjustment = bottomOffset - theFold;
 		}
 		} else {
 			$submenu.css( 'margin-top', '' );
 		}
 	}
-	if ( 'ontouchstart' in window || /IEMobile\/[1-9]/.test(navigator.userAgent) ) { // touch screen device
+	if ( 'ontouchstart' in window || /IEMobile\/[1-9]/.test(navigator.userAgent) ) { // Touch screen device.
-		// iOS Safari works with touchstart, the rest work with click
+		// iOS Safari works with touchstart, the rest work with click.
 		mobileEvent = isIOS ? 'touchstart' : 'click';
 		/**
 		 * Closes any open submenus when touch/click is not on the menu.
 		 *
 		 * @param {Event} e The event object.
 		 *
-		 * @returns {void}
+		 * @return {void}
 		 */
 		$body.on( mobileEvent+'.wp-mobile-hover', function(e) {
 			if ( $adminmenu.data('wp-responsive') ) {
 				return;
 			}
 		/**
 		 * Handles the opening or closing the submenu based on the mobile click|touch event.
 		 *
 		 * @param {Event} event The event object.
 		 *
-		 * @returns {void}
+		 * @return {void}
 		 */
 		$adminmenu.find( 'a.wp-has-submenu' ).on( mobileEvent + '.wp-mobile-hover', function( event ) {
 			var $menuItem = $(this).parent();
 			if ( $adminmenu.data( 'wp-responsive' ) ) {
 				return;
 			}
-			// Show the sub instead of following the link if:
+			/*
-			//	- the submenu is not open
+			 * Show the sub instead of following the link if:
-			//	- the submenu is not shown inline or the menu is not folded
+			 * 	- the submenu is not open.
+			 * 	- the submenu is not shown inline or the menu is not folded.
+			 */
 			if ( ! $menuItem.hasClass( 'opensub' ) && ( ! $menuItem.hasClass( 'wp-menu-open' ) || $menuItem.width() < 40 ) ) {
 				event.preventDefault();
 				adjustSubmenu( $menuItem );
 				$adminmenu.find( 'li.opensub' ).removeClass( 'opensub' );
 				$menuItem.addClass('opensub');
 		$adminmenu.find( 'li.wp-has-submenu' ).hoverIntent({
 			/**
 			 * Opens the submenu when hovered over the menu item for desktops.
 			 *
-			 * @returns {void}
+			 * @return {void}
 			 */
 			over: function() {
 				var $menuItem = $( this ),
 					$submenu = $menuItem.find( '.wp-submenu' ),
 					top = parseInt( $submenu.css( 'top' ), 10 );
-				if ( isNaN( top ) || top > -5 ) { // the submenu is visible
+				if ( isNaN( top ) || top > -5 ) { // The submenu is visible.
 					return;
 				}
 				if ( $adminmenu.data( 'wp-responsive' ) ) {
-					// The menu is in responsive mode, bail
+					// The menu is in responsive mode, bail.
 					return;
 				}
 				adjustSubmenu( $menuItem );
 				$adminmenu.find( 'li.opensub' ).removeClass( 'opensub' );
 			},
 			/**
 			 * Closes the submenu when no longer hovering the menu item.
 			 *
-			 * @returns {void}
+			 * @return {void}
 			 */
 			out: function(){
 				if ( $adminmenu.data( 'wp-responsive' ) ) {
-					// The menu is in responsive mode, bail
+					// The menu is in responsive mode, bail.
 					return;
 				}
 				$( this ).removeClass( 'opensub' ).find( '.wp-submenu' ).css( 'margin-top', '' );
 			},
 		/**
 		 * Opens the submenu on when focused on the menu item.
 		 *
 		 * @param {Event} event The event object.
 		 *
-		 * @returns {void}
+		 * @return {void}
 		 */
 		$adminmenu.on( 'focus.adminmenu', '.wp-submenu a', function( event ) {
 			if ( $adminmenu.data( 'wp-responsive' ) ) {
-				// The menu is in responsive mode, bail
+				// The menu is in responsive mode, bail.
 				return;
 			}
 			$( event.target ).closest( 'li.menu-top' ).addClass( 'opensub' );
 			/**
 			 * Closes the submenu on blur from the menu item.
 			 *
 			 * @param {Event} event The event object.
 			 *
-			 * @returns {void}
+			 * @return {void}
 			 */
 		}).on( 'blur.adminmenu', '.wp-submenu a', function( event ) {
 			if ( $adminmenu.data( 'wp-responsive' ) ) {
 				return;
 			}
 			$( event.target ).closest( 'li.menu-top' ).removeClass( 'opensub' );
 			/**
 			 * Adjusts the size for the submenu.
 			 *
-			 * @returns {void}
+			 * @return {void}
 			 */
 		}).find( 'li.wp-has-submenu.wp-not-current-submenu' ).on( 'focusin.adminmenu', function() {
 			adjustSubmenu( $( this ) );
 		});
 	}
 	/**
 	 * Makes notices dismissible.
 	 *
 	 * @since 4.4.0
 	 *
-	 * @returns {void}
+	 * @return {void}
 	 */
 	function makeNoticesDismissible() {
 		$( '.notice.is-dismissible' ).each( function() {
 			var $el = $( this ),
-				$button = $( '<button type="button" class="notice-dismiss"><span class="screen-reader-text"></span></button>' ),
+				$button = $( '<button type="button" class="notice-dismiss"><span class="screen-reader-text"></span></button>' );
-				btnText = commonL10n.dismiss || '';
+			// Ensure plain text.
-			// Ensure plain text
+			$button.find( '.screen-reader-text' ).text( __( 'Dismiss this notice.' ) );
-			$button.find( '.screen-reader-text' ).text( btnText );
 			$button.on( 'click.wp-dismiss-notice', function( event ) {
 				event.preventDefault();
 				$el.fadeTo( 100, 0, function() {
 					$el.slideUp( 100, function() {
 						$el.remove();
 		});
 	}
 	$document.on( 'wp-updates-notice-added wp-plugin-install-error wp-plugin-update-error wp-plugin-delete-error wp-theme-install-error wp-theme-delete-error', makeNoticesDismissible );
-	// Init screen meta
+	// Init screen meta.
 	screenMeta.init();
 	/**
 	 * Checks a checkbox.
 	 *
 	 * This event needs to be delegated. Ticket #37973.
 	 *
-	 * @returns {boolean} Returns whether a checkbox is checked or not.
+	 * @return {boolean} Returns whether a checkbox is checked or not.
 	 */
 	$body.on( 'click', 'tbody > tr > .check-column :checkbox', function( event ) {
 		// Shift click to select a range of checkboxes.
 		if ( 'undefined' == event.shiftKey ) { return true; }
 		if ( event.shiftKey ) {
 		var unchecked = $(this).closest('tbody').find(':checkbox').filter(':visible:enabled').not(':checked');
 		/**
 		 * Determines if all checkboxes are checked.
 		 *
-		 * @returns {boolean} Returns true if there are no unchecked checkboxes.
+		 * @return {boolean} Returns true if there are no unchecked checkboxes.
 		 */
 		$(this).closest('table').children('thead, tfoot').find(':checkbox').prop('checked', function() {
 			return ( 0 === unchecked.length );
 		});
 	 *
 	 * This event needs to be delegated. Ticket #37973.
 	 *
 	 * @param {Event} event The event object.
 	 *
-	 * @returns {boolean}
+	 * @return {boolean}
 	 */
 	$body.on( 'click.wp-toggle-checkboxes', 'thead .check-column :checkbox, tfoot .check-column :checkbox', function( event ) {
 		var $this = $(this),
 			$table = $this.closest( 'table' ),
 			controlChecked = $this.prop('checked'),
 		$table.children( 'tbody' ).filter(':visible')
 			.children().children('.check-column').find(':checkbox')
 			/**
 			 * Updates the checked state on the checkbox in the table.
 			 *
-			 * @returns {boolean} True checks the checkbox, False unchecks the checkbox.
+			 * @return {boolean} True checks the checkbox, False unchecks the checkbox.
 			 */
 			.prop('checked', function() {
 				if ( $(this).is(':hidden,:disabled') ) {
 					return false;
 				}
 			.children().children('.check-column').find(':checkbox')
 			/**
 			 * Syncs the bulk checkboxes on the top and bottom of the table.
 			 *
-			 * @returns {boolean} True checks the checkbox, False unchecks the checkbox.
+			 * @return {boolean} True checks the checkbox, False unchecks the checkbox.
 			 */
 			.prop('checked', function() {
 				if ( toggle ) {
 					return false;
 				} else if ( controlChecked ) {
 	});
 	/**
 	 * Shows row actions on focus of its parent container element or any other elements contained within.
 	 *
-	 * @returns {void}
+	 * @return {void}
 	 */
 	$( '#wpbody-content' ).on({
 		focusin: function() {
 			clearTimeout( transitionTimeout );
 			focusedRowActions = $( this ).find( '.row-actions' );
 				focusedRowActions.removeClass( 'visible' );
 			}, 30 );
 		}
 	}, '.has-row-actions' );
-	// Toggle list table rows on small screens
+	// Toggle list table rows on small screens.
 	$( 'tbody' ).on( 'click', '.toggle-row', function() {
 		$( this ).closest( 'tr' ).toggleClass( 'is-expanded' );
 	});
 	$('#default-password-nag-no').click( function() {
 	/**
 	 * Handles tab keypresses in theme and plugin editor textareas.
 	 *
 	 * @param {Event} e The event object.
 	 *
-	 * @returns {void}
+	 * @return {void}
 	 */
 	$('#newcontent').bind('keydown.wpevent_InsertTab', function(e) {
 		var el = e.target, selStart, selEnd, val, scroll, sel;
 		// After pressing escape key (keyCode: 27), the tab key should tab out of the textarea.
 		if ( e.keyCode == 27 ) {
-			// when pressing Escape: Opera 12 and 27 blur form fields, IE 8 clears them
+			// When pressing Escape: Opera 12 and 27 blur form fields, IE 8 clears them.
 			e.preventDefault();
 			$(el).data('tab-out', true);
 			return;
 		}
 		 *
 		 * The pagination argument should not be touched when the bulk action dropdowns are set to do anything.
 		 *
 		 * The form closest to the pageInput is the post-filter form.
 		 *
-		 * @returns {void}
+		 * @return {void}
 		 */
 		pageInput.closest('form').submit( function() {
 			/*
 			 * action = bulk action dropdown at the top of the table
 			 * action2 = bulk action dropdow at the bottom of the table
 	}
 	/**
 	 * Resets the bulk actions when the search button is clicked.
 	 *
-	 * @returns {void}
+	 * @return {void}
 	 */
 	$('.search-box input[type="search"], .search-box input[type="submit"]').mousedown(function () {
 		$('select[name^="action"]').val('-1');
 	});
 	/**
 	 * Scrolls into view when focus.scroll-into-view is triggered.
 	 *
 	 * @param {Event} e The event object.
 	 *
-	 * @returns {void}
+	 * @return {void}
 	 */
 	$('#contextual-help-link, #show-settings-link').on( 'focus.scroll-into-view', function(e){
 		if ( e.target.scrollIntoView )
 			e.target.scrollIntoView(false);
 	});
 	/**
 	 * Disables the submit upload buttons when no data is entered.
 	 *
-	 * @returns {void}
+	 * @return {void}
 	 */
 	(function(){
 		var button, input, form = $('form.wp-upload-form');
 		// Exit when no upload form is found.
 		/**
 		 * Determines if any data is entered in any file upload input.
 		 *
 		 * @since 3.5.0
 		 *
-		 * @returns {void}
+		 * @return {void}
 		 */
 		function toggleUploadButton() {
 			// When no inputs have a value, disable the upload buttons.
 			button.prop('disabled', '' === input.map( function() {
 				return $(this).val();
 	 *
 	 * @param {Event} event Event data.
 	 *
 	 * @since 4.1.0
 	 *
-	 * @returns {void}
+	 * @return {void}
 	 */
 	function pinMenu( event ) {
 		var windowPos = $window.scrollTop(),
 			resizing = ! event || event.type !== 'scroll';
-		if ( isIOS || isIE8 || $adminmenu.data( 'wp-responsive' ) ) {
+		if ( isIOS || $adminmenu.data( 'wp-responsive' ) ) {
 			return;
 		}
 		/*
 		 * When the menu is higher than the window and smaller than the entire page.
 	/**
 	 * Determines the height of certain elements.
 	 *
 	 * @since 4.1.0
 	 *
-	 * @returns {void}
+	 * @return {void}
 	 */
 	function resetHeights() {
 		height = {
 			window: $window.height(),
 			wpwrap: $wpwrap.height(),
 	/**
 	 * Unpins the menu.
 	 *
 	 * @since 4.1.0
 	 *
-	 * @returns {void}
+	 * @return {void}
 	 */
 	function unpinMenu() {
 		if ( isIOS || ! menuIsPinned ) {
 			return;
 		}
 	/**
 	 * Pins and unpins the menu when applicable.
 	 *
 	 * @since 4.1.0
 	 *
-	 * @returns {void}
+	 * @return {void}
 	 */
 	function setPinMenu() {
 		resetHeights();
 		if ( $adminmenu.data('wp-responsive') ) {
 	/**
 	 * Changes the sortables and responsiveness of metaboxes.
 	 *
 	 * @since 3.8.0
 	 *
-	 *@returns {void}
+	 * @return {void}
 	 */
 	window.wpResponsive = {
 		/**
 		 * Initializes the wpResponsive object.
 		 *
 		 * @since 3.8.0
 		 *
-		 * @returns {void}
+		 * @return {void}
 		 */
 		init: function() {
 			var self = this;
-			// Modify functionality based on custom activate/deactivate event
+			this.maybeDisableSortables = this.maybeDisableSortables.bind( this );
+			// Modify functionality based on custom activate/deactivate event.
 			$document.on( 'wp-responsive-activate.wp-responsive', function() {
 				self.activate();
 			}).on( 'wp-responsive-deactivate.wp-responsive', function() {
 				self.deactivate();
 			});
 			// Toggle sidebar when toggle is clicked.
 			$( '#wp-admin-bar-menu-toggle' ).on( 'click.wp-responsive', function( event ) {
 				event.preventDefault();
-				// close any open toolbar submenus.
+				// Close any open toolbar submenus.
 				$adminbar.find( '.hover' ).removeClass( 'hover' );
 				$wpwrap.toggleClass( 'wp-responsive-open' );
 				if ( $wpwrap.hasClass( 'wp-responsive-open' ) ) {
 					$(this).find('a').attr( 'aria-expanded', 'true' );
 			self.trigger();
 			$document.on( 'wp-window-resized.wp-responsive', $.proxy( this.trigger, this ) );
 			// This needs to run later as UI Sortable may be initialized later on $(document).ready().
-			$window.on( 'load.wp-responsive', function() {
+			$window.on( 'load.wp-responsive', this.maybeDisableSortables );
-				var width = navigator.userAgent.indexOf('AppleWebKit/') > -1 ? $window.width() : window.innerWidth;
+			$document.on( 'postbox-toggled', this.maybeDisableSortables );
-				if ( width <= 782 ) {
+			// When the screen columns are changed, potentially disable sortables.
-					self.disableSortables();
+			$( '#screen-options-wrap input' ).on( 'click', this.maybeDisableSortables );
-				}
+		},
-			});
+		/**
+		 * Disable sortables if there is only one metabox, or the screen is in one column mode. Otherwise, enable sortables.
+		 *
+		 * @since 5.3.0
+		 *
+		 * @return {void}
+		 */
+		maybeDisableSortables: function() {
+			var width = navigator.userAgent.indexOf('AppleWebKit/') > -1 ? $window.width() : window.innerWidth;
+			if (
+				( width <= 782 ) ||
+				( 1 >= $sortables.find( '.ui-sortable-handle:visible' ).length && jQuery( '.columns-prefs-1 input' ).prop( 'checked' ) )
+			) {
+				this.disableSortables();
+			} else {
+				this.enableSortables();
+			}
 		},
 		/**
 		 * Changes properties of body and admin menu.
 		 *
 		 * Pins and unpins the menu and adds the auto-fold class to the body.
 		 * Makes the admin menu responsive and disables the metabox sortables.
 		 *
 		 * @since 3.8.0
 		 *
-		 * @returns {void}
+		 * @return {void}
 		 */
 		activate: function() {
 			setPinMenu();
 			if ( ! $body.hasClass( 'auto-fold' ) ) {
 		 * Pin and unpin the menu.
 		 * Removes the responsiveness of the admin menu and enables the metabox sortables.
 		 *
 		 * @since 3.8.0
 		 *
-		 * @returns {void}
+		 * @return {void}
 		 */
 		deactivate: function() {
 			setPinMenu();
 			$adminmenu.removeData('wp-responsive');
-			this.enableSortables();
+			this.maybeDisableSortables();
 		},
 		/**
 		 * Sets the responsiveness and enables the overlay based on the viewport width.
 		 *
 		 * @since 3.8.0
 		 *
-		 * @returns {void}
+		 * @return {void}
 		 */
 		trigger: function() {
 			var viewportWidth = getViewportWidth();
 			// Exclude IE < 9, it doesn't support @media CSS rules.
 			if ( viewportWidth <= 480 ) {
 				this.enableOverlay();
 			} else {
 				this.disableOverlay();
 			}
+			this.maybeDisableSortables();
 		},
 		/**
 		 * Inserts a responsive overlay and toggles the window.
 		 *
 		 * @since 3.8.0
 		 *
-		 * @returns {void}
+		 * @return {void}
 		 */
 		enableOverlay: function() {
 			if ( $overlay.length === 0 ) {
 				$overlay = $( '<div id="wp-responsive-overlay"></div>' )
 					.insertAfter( '#wpcontent' )
 		/**
 		 * Disables the responsive overlay and removes the overlay.
 		 *
 		 * @since 3.8.0
 		 *
-		 * @returns {void}
+		 * @return {void}
 		 */
 		disableOverlay: function() {
 			$toolbarPopups.off( 'click.wp-responsive' );
 			$overlay.hide();
 		},
 		/**
 		 * Disables sortables.
 		 *
 		 * @since 3.8.0
 		 *
-		 * @returns {void}
+		 * @return {void}
 		 */
 		disableSortables: function() {
 			if ( $sortables.length ) {
 				try {
 					$sortables.sortable( 'disable' );
+					$sortables.find( '.ui-sortable-handle' ).addClass( 'is-non-sortable' );
 				} catch ( e ) {}
 			}
 		},
 		/**
 		 * Enables sortables.
 		 *
 		 * @since 3.8.0
 		 *
-		 * @returns {void}
+		 * @return {void}
 		 */
 		enableSortables: function() {
 			if ( $sortables.length ) {
 				try {
 					$sortables.sortable( 'enable' );
+					$sortables.find( '.ui-sortable-handle' ).removeClass( 'is-non-sortable' );
 				} catch ( e ) {}
 			}
 		}
 	};
 	/**
 	 * Add an ARIA role `button` to elements that behave like UI controls when JavaScript is on.
 	 *
 	 * @since 4.5.0
 	 *
-	 * @returns {void}
+	 * @return {void}
 	 */
 	function aria_button_if_js() {
 		$( '.aria-button-if-js' ).attr( 'role', 'button' );
 	}
 	/**
 	 * Get the viewport width.
 	 *
 	 * @since 4.7.0
 	 *
-	 * @returns {number|boolean} The current viewport width or false if the
+	 * @return {number|boolean} The current viewport width or false if the
-	 *                           browser doesn't support innerWidth (IE < 9).
+	 *                          browser doesn't support innerWidth (IE < 9).
 	 */
 	function getViewportWidth() {
 		var viewportWidth = false;
 		if ( window.innerWidth ) {
 	 * Sets the global variable `menuState` and triggers a custom event passing
 	 * the current menu state.
 	 *
 	 * @since 4.7.0
 	 *
-	 * @returns {void}
+	 * @return {void}
 	 */
 	function setMenuState() {
 		var viewportWidth = getViewportWidth() || 961;
 		if ( viewportWidth <= 782  ) {
 	 * `aria-label` attributes of the button to give feedback to assistive
 	 * technologies. In the responsive view, the button is always hidden.
 	 *
 	 * @since 4.7.0
 	 *
-	 * @returns {void}
+	 * @return {void}
 	 */
 	$document.on( 'wp-menu-state-set wp-collapse-menu', function( event, eventData ) {
 		var $collapseButton = $( '#collapse-button' ),
-			ariaExpanded = 'true',
+			ariaExpanded, ariaLabelText;
-			ariaLabelText = commonL10n.collapseMenu;
 		if ( 'folded' === eventData.state ) {
 			ariaExpanded = 'false';
-			ariaLabelText = commonL10n.expandMenu;
+			ariaLabelText = __( 'Expand Main menu' );
+		} else {
+			ariaExpanded = 'true';
+			ariaLabelText = __( 'Collapse Main menu' );
 		}
 		$collapseButton.attr({
 			'aria-expanded': ariaExpanded,
 			'aria-label': ariaLabelText
 		// Toggle the Show Details button expanded state.
 		$( this ).attr( 'aria-expanded', $progressDiv.is( ':visible' ) );
 	});
 });
+/**
+* Hides the update button for expired plugin or theme uploads.
+*
+* On the "Update plugin/theme from uploaded zip" screen, once the upload has expired,
+* hides the "Replace current with uploaded" button and displays a warning.
+*
+* @since 5.5.0
+*/
+$document.ready( function( $ ) {
+	var $overwrite, $warning;
+	if ( ! $body.hasClass( 'update-php' ) ) {
+		return;
+	}
+	$overwrite = $( 'a.update-from-upload-overwrite' );
+	$warning   = $( '.update-from-upload-expired' );
+	if ( ! $overwrite.length || ! $warning.length ) {
+		return;
+	}
+	window.setTimeout(
+		function() {
+			$overwrite.hide();
+			$warning.removeClass( 'hidden' );
+			if ( window.wp && window.wp.a11y ) {
+				window.wp.a11y.speak( $warning.text() );
+			}
+		},
+		7140000 // 119 minutes. The uploaded file is deleted after 2 hours.
+	);
+} );
 // Fire a custom jQuery event at the end of window resize.
 ( function() {
 	var timeout;
 	/**
 	 * Triggers the WP window-resize event.
 	 *
 	 * @since 3.8.0
 	 *
-	 * @returns {void}
+	 * @return {void}
 	 */
 	function triggerEvent() {
 		$document.trigger( 'wp-window-resized' );
 	}
 	/**
 	 * Fires the trigger event again after 200 ms.
 	 *
 	 * @since 3.8.0
 	 *
-	 * @returns {void}
+	 * @return {void}
 	 */
 	function fireOnce() {
 		window.clearTimeout( timeout );
 		timeout = window.setTimeout( triggerEvent, 200 );
 	}

enmi-conf.org