1/**
2 * Functions for ajaxified updates, deletions and installs inside the WordPress admin.
3 *
4 * @version 4.2.0
5 * @output wp-admin/js/updates.js
6 */
7
8/* global pagenow, _wpThemeSettings */
9
10/**
11 * @param {jQuery} $ jQuery object.
12 * @param {object} wp WP object.
13 * @param {object} settings WP Updates settings.
14 * @param {string} settings.ajax_nonce Ajax nonce.
15 * @param {object=} settings.plugins Base names of plugins in their different states.
16 * @param {Array} settings.plugins.all Base names of all plugins.
17 * @param {Array} settings.plugins.active Base names of active plugins.
18 * @param {Array} settings.plugins.inactive Base names of inactive plugins.
19 * @param {Array} settings.plugins.upgrade Base names of plugins with updates available.
20 * @param {Array} settings.plugins.recently_activated Base names of recently activated plugins.
21 * @param {Array} settings.plugins['auto-update-enabled'] Base names of plugins set to auto-update.
22 * @param {Array} settings.plugins['auto-update-disabled'] Base names of plugins set to not auto-update.
23 * @param {object=} settings.themes Slugs of themes in their different states.
24 * @param {Array} settings.themes.all Slugs of all themes.
25 * @param {Array} settings.themes.upgrade Slugs of themes with updates available.
26 * @param {Arrat} settings.themes.disabled Slugs of disabled themes.
27 * @param {Array} settings.themes['auto-update-enabled'] Slugs of themes set to auto-update.
28 * @param {Array} settings.themes['auto-update-disabled'] Slugs of themes set to not auto-update.
29 * @param {object=} settings.totals Combined information for available update counts.
30 * @param {number} settings.totals.count Holds the amount of available updates.
31 */
32(function( $, wp, settings ) {
33 var $document = $( document ),
34 __ = wp.i18n.__,
35 _x = wp.i18n._x,
36 _n = wp.i18n._n,
37 _nx = wp.i18n._nx,
38 sprintf = wp.i18n.sprintf;
39
40 wp = wp || {};
41
42 /**
43 * The WP Updates object.
44 *
45 * @since 4.2.0
46 *
47 * @namespace wp.updates
48 */
49 wp.updates = {};
50
51 /**
52 * Removed in 5.5.0, needed for back-compatibility.
53 *
54 * @since 4.2.0
55 * @deprecated 5.5.0
56 *
57 * @type {object}
58 */
59 wp.updates.l10n = {
60 searchResults: '',
61 searchResultsLabel: '',
62 noPlugins: '',
63 noItemsSelected: '',
64 updating: '',
65 pluginUpdated: '',
66 themeUpdated: '',
67 update: '',
68 updateNow: '',
69 pluginUpdateNowLabel: '',
70 updateFailedShort: '',
71 updateFailed: '',
72 pluginUpdatingLabel: '',
73 pluginUpdatedLabel: '',
74 pluginUpdateFailedLabel: '',
75 updatingMsg: '',
76 updatedMsg: '',
77 updateCancel: '',
78 beforeunload: '',
79 installNow: '',
80 pluginInstallNowLabel: '',
81 installing: '',
82 pluginInstalled: '',
83 themeInstalled: '',
84 installFailedShort: '',
85 installFailed: '',
86 pluginInstallingLabel: '',
87 themeInstallingLabel: '',
88 pluginInstalledLabel: '',
89 themeInstalledLabel: '',
90 pluginInstallFailedLabel: '',
91 themeInstallFailedLabel: '',
92 installingMsg: '',
93 installedMsg: '',
94 importerInstalledMsg: '',
95 aysDelete: '',
96 aysDeleteUninstall: '',
97 aysBulkDelete: '',
98 aysBulkDeleteThemes: '',
99 deleting: '',
100 deleteFailed: '',
101 pluginDeleted: '',
102 themeDeleted: '',
103 livePreview: '',
104 activatePlugin: '',
105 activateTheme: '',
106 activatePluginLabel: '',
107 activateThemeLabel: '',
108 activateImporter: '',
109 activateImporterLabel: '',
110 unknownError: '',
111 connectionError: '',
112 nonceError: '',
113 pluginsFound: '',
114 noPluginsFound: '',
115 autoUpdatesEnable: '',
116 autoUpdatesEnabling: '',
117 autoUpdatesEnabled: '',
118 autoUpdatesDisable: '',
119 autoUpdatesDisabling: '',
120 autoUpdatesDisabled: '',
121 autoUpdatesError: ''
122 };
123
124 wp.updates.l10n = window.wp.deprecateL10nObject( 'wp.updates.l10n', wp.updates.l10n, '5.5.0' );
125
126 /**
127 * User nonce for ajax calls.
128 *
129 * @since 4.2.0
130 *
131 * @type {string}
132 */
133 wp.updates.ajaxNonce = settings.ajax_nonce;
134
135 /**
136 * Current search term.
137 *
138 * @since 4.6.0
139 *
140 * @type {string}
141 */
142 wp.updates.searchTerm = '';
143
144 /**
145 * Minimum number of characters before an ajax search is fired.
146 *
147 * @since 6.7.0
148 *
149 * @type {number}
150 */
151 wp.updates.searchMinCharacters = 2;
152
153 /**
154 * Whether filesystem credentials need to be requested from the user.
155 *
156 * @since 4.2.0
157 *
158 * @type {bool}
159 */
160 wp.updates.shouldRequestFilesystemCredentials = false;
161
162 /**
163 * Filesystem credentials to be packaged along with the request.
164 *
165 * @since 4.2.0
166 * @since 4.6.0 Added `available` property to indicate whether credentials have been provided.
167 *
168 * @type {Object}
169 * @property {Object} filesystemCredentials.ftp Holds FTP credentials.
170 * @property {string} filesystemCredentials.ftp.host FTP host. Default empty string.
171 * @property {string} filesystemCredentials.ftp.username FTP user name. Default empty string.
172 * @property {string} filesystemCredentials.ftp.password FTP password. Default empty string.
173 * @property {string} filesystemCredentials.ftp.connectionType Type of FTP connection. 'ssh', 'ftp', or 'ftps'.
174 * Default empty string.
175 * @property {Object} filesystemCredentials.ssh Holds SSH credentials.
176 * @property {string} filesystemCredentials.ssh.publicKey The public key. Default empty string.
177 * @property {string} filesystemCredentials.ssh.privateKey The private key. Default empty string.
178 * @property {string} filesystemCredentials.fsNonce Filesystem credentials form nonce.
179 * @property {bool} filesystemCredentials.available Whether filesystem credentials have been provided.
180 * Default 'false'.
181 */
182 wp.updates.filesystemCredentials = {
183 ftp: {
184 host: '',
185 username: '',
186 password: '',
187 connectionType: ''
188 },
189 ssh: {
190 publicKey: '',
191 privateKey: ''
192 },
193 fsNonce: '',
194 available: false
195 };
196
197 /**
198 * Whether we're waiting for an Ajax request to complete.
199 *
200 * @since 4.2.0
201 * @since 4.6.0 More accurately named `ajaxLocked`.
202 *
203 * @type {bool}
204 */
205 wp.updates.ajaxLocked = false;
206
207 /**
208 * Admin notice template.
209 *
210 * @since 4.6.0
211 *
212 * @type {function}
213 */
214 wp.updates.adminNotice = wp.template( 'wp-updates-admin-notice' );
215
216 /**
217 * Update queue.
218 *
219 * If the user tries to update a plugin while an update is
220 * already happening, it can be placed in this queue to perform later.
221 *
222 * @since 4.2.0
223 * @since 4.6.0 More accurately named `queue`.
224 *
225 * @type {Array.object}
226 */
227 wp.updates.queue = [];
228
229 /**
230 * Holds a jQuery reference to return focus to when exiting the request credentials modal.
231 *
232 * @since 4.2.0
233 *
234 * @type {jQuery}
235 */
236 wp.updates.$elToReturnFocusToFromCredentialsModal = undefined;
237
238 /**
239 * Adds or updates an admin notice.
240 *
241 * @since 4.6.0
242 *
243 * @param {Object} data
244 * @param {*=} data.selector Optional. Selector of an element to be replaced with the admin notice.
245 * @param {string=} data.id Optional. Unique id that will be used as the notice's id attribute.
246 * @param {string=} data.className Optional. Class names that will be used in the admin notice.
247 * @param {string=} data.message Optional. The message displayed in the notice.
248 * @param {number=} data.successes Optional. The amount of successful operations.
249 * @param {number=} data.errors Optional. The amount of failed operations.
250 * @param {Array=} data.errorMessages Optional. Error messages of failed operations.
251 *
252 */
253 wp.updates.addAdminNotice = function( data ) {
254 var $notice = $( data.selector ),
255 $headerEnd = $( '.wp-header-end' ),
256 $adminNotice;
257
258 delete data.selector;
259 $adminNotice = wp.updates.adminNotice( data );
260
261 // Check if this admin notice already exists.
262 if ( ! $notice.length ) {
263 $notice = $( '#' + data.id );
264 }
265
266 if ( $notice.length ) {
267 $notice.replaceWith( $adminNotice );
268 } else if ( $headerEnd.length ) {
269 $headerEnd.after( $adminNotice );
270 } else {
271 if ( 'customize' === pagenow ) {
272 $( '.customize-themes-notifications' ).append( $adminNotice );
273 } else {
274 $( '.wrap' ).find( '> h1' ).after( $adminNotice );
275 }
276 }
277
278 $document.trigger( 'wp-updates-notice-added' );
279 };
280
281 /**
282 * Handles Ajax requests to WordPress.
283 *
284 * @since 4.6.0
285 *
286 * @param {string} action The type of Ajax request ('update-plugin', 'install-theme', etc).
287 * @param {Object} data Data that needs to be passed to the ajax callback.
288 * @return {$.promise} A jQuery promise that represents the request,
289 * decorated with an abort() method.
290 */
291 wp.updates.ajax = function( action, data ) {
292 var options = {};
293
294 if ( wp.updates.ajaxLocked ) {
295 wp.updates.queue.push( {
296 action: action,
297 data: data
298 } );
299
300 // Return a Deferred object so callbacks can always be registered.
301 return $.Deferred();
302 }
303
304 wp.updates.ajaxLocked = true;
305
306 if ( data.success ) {
307 options.success = data.success;
308 delete data.success;
309 }
310
311 if ( data.error ) {
312 options.error = data.error;
313 delete data.error;
314 }
315
316 options.data = _.extend( data, {
317 action: action,
318 _ajax_nonce: wp.updates.ajaxNonce,
319 _fs_nonce: wp.updates.filesystemCredentials.fsNonce,
320 username: wp.updates.filesystemCredentials.ftp.username,
321 password: wp.updates.filesystemCredentials.ftp.password,
322 hostname: wp.updates.filesystemCredentials.ftp.hostname,
323 connection_type: wp.updates.filesystemCredentials.ftp.connectionType,
324 public_key: wp.updates.filesystemCredentials.ssh.publicKey,
325 private_key: wp.updates.filesystemCredentials.ssh.privateKey
326 } );
327
328 return wp.ajax.send( options ).always( wp.updates.ajaxAlways );
329 };
330
331 /**
332 * Actions performed after every Ajax request.
333 *
334 * @since 4.6.0
335 *
336 * @param {Object} response
337 * @param {Array=} response.debug Optional. Debug information.
338 * @param {string=} response.errorCode Optional. Error code for an error that occurred.
339 */
340 wp.updates.ajaxAlways = function( response ) {
341 if ( ! response.errorCode || 'unable_to_connect_to_filesystem' !== response.errorCode ) {
342 wp.updates.ajaxLocked = false;
343 wp.updates.queueChecker();
344 }
345
346 if ( 'undefined' !== typeof response.debug && window.console && window.console.log ) {
347 _.map( response.debug, function( message ) {
348 // Remove all HTML tags and write a message to the console.
349 window.console.log( wp.sanitize.stripTagsAndEncodeText( message ) );
350 } );
351 }
352 };
353
354 /**
355 * Refreshes update counts everywhere on the screen.
356 *
357 * @since 4.7.0
358 */
359 wp.updates.refreshCount = function() {
360 var $adminBarUpdates = $( '#wp-admin-bar-updates' ),
361 $dashboardNavMenuUpdateCount = $( 'a[href="update-core.php"] .update-plugins' ),
362 $pluginsNavMenuUpdateCount = $( 'a[href="plugins.php"] .update-plugins' ),
363 $appearanceNavMenuUpdateCount = $( 'a[href="themes.php"] .update-plugins' ),
364 itemCount;
365
366 $adminBarUpdates.find( '.ab-label' ).text( settings.totals.counts.total );
367 $adminBarUpdates.find( '.updates-available-text' ).text(
368 sprintf(
369 /* translators: %s: Total number of updates available. */
370 _n( '%s update available', '%s updates available', settings.totals.counts.total ),
371 settings.totals.counts.total
372 )
373 );
374
375 // Remove the update count from the toolbar if it's zero.
376 if ( 0 === settings.totals.counts.total ) {
377 $adminBarUpdates.find( '.ab-label' ).parents( 'li' ).remove();
378 }
379
380 // Update the "Updates" menu item.
381 $dashboardNavMenuUpdateCount.each( function( index, element ) {
382 element.className = element.className.replace( /count-\d+/, 'count-' + settings.totals.counts.total );
383 } );
384 if ( settings.totals.counts.total > 0 ) {
385 $dashboardNavMenuUpdateCount.find( '.update-count' ).text( settings.totals.counts.total );
386 } else {
387 $dashboardNavMenuUpdateCount.remove();
388 }
389
390 // Update the "Plugins" menu item.
391 $pluginsNavMenuUpdateCount.each( function( index, element ) {
392 element.className = element.className.replace( /count-\d+/, 'count-' + settings.totals.counts.plugins );
393 } );
394 if ( settings.totals.counts.total > 0 ) {
395 $pluginsNavMenuUpdateCount.find( '.plugin-count' ).text( settings.totals.counts.plugins );
396 } else {
397 $pluginsNavMenuUpdateCount.remove();
398 }
399
400 // Update the "Appearance" menu item.
401 $appearanceNavMenuUpdateCount.each( function( index, element ) {
402 element.className = element.className.replace( /count-\d+/, 'count-' + settings.totals.counts.themes );
403 } );
404 if ( settings.totals.counts.total > 0 ) {
405 $appearanceNavMenuUpdateCount.find( '.theme-count' ).text( settings.totals.counts.themes );
406 } else {
407 $appearanceNavMenuUpdateCount.remove();
408 }
409
410 // Update list table filter navigation.
411 if ( 'plugins' === pagenow || 'plugins-network' === pagenow ) {
412 itemCount = settings.totals.counts.plugins;
413 } else if ( 'themes' === pagenow || 'themes-network' === pagenow ) {
414 itemCount = settings.totals.counts.themes;
415 }
416
417 if ( itemCount > 0 ) {
418 $( '.subsubsub .upgrade .count' ).text( '(' + itemCount + ')' );
419 } else {
420 $( '.subsubsub .upgrade' ).remove();
421 $( '.subsubsub li:last' ).html( function() { return $( this ).children(); } );
422 }
423 };
424
425 /**
426 * Sends a message from a modal to the main screen to update buttons in plugin cards.
427 *
428 * @since 6.5.0
429 *
430 * @param {Object} data An object of data to use for the button.
431 * @param {string} data.slug The plugin's slug.
432 * @param {string} data.text The text to use for the button.
433 * @param {string} data.ariaLabel The value for the button's aria-label attribute. An empty string removes the attribute.
434 * @param {string=} data.status Optional. An identifier for the status.
435 * @param {string=} data.removeClasses Optional. A space-separated list of classes to remove from the button.
436 * @param {string=} data.addClasses Optional. A space-separated list of classes to add to the button.
437 * @param {string=} data.href Optional. The button's URL.
438 * @param {string=} data.pluginName Optional. The plugin's name.
439 * @param {string=} data.plugin Optional. The plugin file, relative to the plugins directory.
440 */
441 wp.updates.setCardButtonStatus = function( data ) {
442 var target = window.parent === window ? null : window.parent;
443
444 $.support.postMessage = !! window.postMessage;
445 if ( false !== $.support.postMessage && null !== target && -1 === window.parent.location.pathname.indexOf( 'index.php' ) ) {
446 target.postMessage( JSON.stringify( data ), window.location.origin );
447 }
448 };
449
450 /**
451 * Decrements the update counts throughout the various menus.
452 *
453 * This includes the toolbar, the "Updates" menu item and the menu items
454 * for plugins and themes.
455 *
456 * @since 3.9.0
457 *
458 * @param {string} type The type of item that was updated or deleted.
459 * Can be 'plugin', 'theme'.
460 */
461 wp.updates.decrementCount = function( type ) {
462 settings.totals.counts.total = Math.max( --settings.totals.counts.total, 0 );
463
464 if ( 'plugin' === type ) {
465 settings.totals.counts.plugins = Math.max( --settings.totals.counts.plugins, 0 );
466 } else if ( 'theme' === type ) {
467 settings.totals.counts.themes = Math.max( --settings.totals.counts.themes, 0 );
468 }
469
470 wp.updates.refreshCount( type );
471 };
472
473 /**
474 * Sends an Ajax request to the server to update a plugin.
475 *
476 * @since 4.2.0
477 * @since 4.6.0 More accurately named `updatePlugin`.
478 *
479 * @param {Object} args Arguments.
480 * @param {string} args.plugin Plugin basename.
481 * @param {string} args.slug Plugin slug.
482 * @param {updatePluginSuccess=} args.success Optional. Success callback. Default: wp.updates.updatePluginSuccess
483 * @param {updatePluginError=} args.error Optional. Error callback. Default: wp.updates.updatePluginError
484 * @return {$.promise} A jQuery promise that represents the request,
485 * decorated with an abort() method.
486 */
487 wp.updates.updatePlugin = function( args ) {
488 var $updateRow, $card, $message, message,
489 $adminBarUpdates = $( '#wp-admin-bar-updates' ),
490 buttonText = __( 'Updating...' ),
491 isPluginInstall = 'plugin-install' === pagenow || 'plugin-install-network' === pagenow;
492
493 args = _.extend( {
494 success: wp.updates.updatePluginSuccess,
495 error: wp.updates.updatePluginError
496 }, args );
497
498 if ( 'plugins' === pagenow || 'plugins-network' === pagenow ) {
499 $updateRow = $( 'tr[data-plugin="' + args.plugin + '"]' );
500 $message = $updateRow.find( '.update-message' ).removeClass( 'notice-error' ).addClass( 'updating-message notice-warning' ).find( 'p' );
501 message = sprintf(
502 /* translators: %s: Plugin name and version. */
503 _x( 'Updating %s...', 'plugin' ),
504 $updateRow.find( '.plugin-title strong' ).text()
505 );
506 } else if ( isPluginInstall ) {
507 $card = $( '.plugin-card-' + args.slug + ', #plugin-information-footer' );
508 $message = $card.find( '.update-now' ).addClass( 'updating-message' );
509 message = sprintf(
510 /* translators: %s: Plugin name and version. */
511 _x( 'Updating %s...', 'plugin' ),
512 $message.data( 'name' )
513 );
514
515 // Remove previous error messages, if any.
516 $card.removeClass( 'plugin-card-update-failed' ).find( '.notice.notice-error' ).remove();
517 }
518
519 $adminBarUpdates.addClass( 'spin' );
520
521 if ( $message.html() !== __( 'Updating...' ) ) {
522 $message.data( 'originaltext', $message.html() );
523 }
524
525 $message
526 .attr( 'aria-label', message )
527 .text( buttonText );
528
529 $document.trigger( 'wp-plugin-updating', args );
530
531 if ( isPluginInstall && 'plugin-information-footer' === $card.attr( 'id' ) ) {
532 wp.updates.setCardButtonStatus(
533 {
534 status: 'updating-plugin',
535 slug: args.slug,
536 addClasses: 'updating-message',
537 text: buttonText,
538 ariaLabel: message
539 }
540 );
541 }
542
543 return wp.updates.ajax( 'update-plugin', args );
544 };
545
546 /**
547 * Updates the UI appropriately after a successful plugin update.
548 *
549 * @since 4.2.0
550 * @since 4.6.0 More accurately named `updatePluginSuccess`.
551 * @since 5.5.0 Auto-update "time to next update" text cleared.
552 *
553 * @param {Object} response Response from the server.
554 * @param {string} response.slug Slug of the plugin to be updated.
555 * @param {string} response.plugin Basename of the plugin to be updated.
556 * @param {string} response.pluginName Name of the plugin to be updated.
557 * @param {string} response.oldVersion Old version of the plugin.
558 * @param {string} response.newVersion New version of the plugin.
559 */
560 wp.updates.updatePluginSuccess = function( response ) {
561 var $pluginRow, $updateMessage, newText,
562 $adminBarUpdates = $( '#wp-admin-bar-updates' ),
563 buttonText = _x( 'Updated!', 'plugin' ),
564 ariaLabel = sprintf(
565 /* translators: %s: Plugin name and version. */
566 _x( '%s updated!', 'plugin' ),
567 response.pluginName
568 );
569
570 if ( 'plugins' === pagenow || 'plugins-network' === pagenow ) {
571 $pluginRow = $( 'tr[data-plugin="' + response.plugin + '"]' )
572 .removeClass( 'update is-enqueued' )
573 .addClass( 'updated' );
574 $updateMessage = $pluginRow.find( '.update-message' )
575 .removeClass( 'updating-message notice-warning' )
576 .addClass( 'updated-message notice-success' ).find( 'p' );
577
578 // Update the version number in the row.
579 newText = $pluginRow.find( '.plugin-version-author-uri' ).html().replace( response.oldVersion, response.newVersion );
580 $pluginRow.find( '.plugin-version-author-uri' ).html( newText );
581
582 // Clear the "time to next auto-update" text.
583 $pluginRow.find( '.auto-update-time' ).empty();
584 } else if ( 'plugin-install' === pagenow || 'plugin-install-network' === pagenow ) {
585 $updateMessage = $( '.plugin-card-' + response.slug + ', #plugin-information-footer' ).find( '.update-now' )
586 .removeClass( 'updating-message' )
587 .addClass( 'button-disabled updated-message' );
588 }
589
590 $adminBarUpdates.removeClass( 'spin' );
591
592 $updateMessage
593 .attr( 'aria-label', ariaLabel )
594 .text( buttonText );
595
596 wp.a11y.speak( __( 'Update completed successfully.' ) );
597
598 if ( 'plugin_install_from_iframe' !== $updateMessage.attr( 'id' ) ) {
599 wp.updates.decrementCount( 'plugin' );
600 } else {
601 wp.updates.setCardButtonStatus(
602 {
603 status: 'updated-plugin',
604 slug: response.slug,
605 removeClasses: 'updating-message',
606 addClasses: 'button-disabled updated-message',
607 text: buttonText,
608 ariaLabel: ariaLabel
609 }
610 );
611 }
612
613 $document.trigger( 'wp-plugin-update-success', response );
614 };
615
616 /**
617 * Updates the UI appropriately after a failed plugin update.
618 *
619 * @since 4.2.0
620 * @since 4.6.0 More accurately named `updatePluginError`.
621 *
622 * @param {Object} response Response from the server.
623 * @param {string} response.slug Slug of the plugin to be updated.
624 * @param {string} response.plugin Basename of the plugin to be updated.
625 * @param {string=} response.pluginName Optional. Name of the plugin to be updated.
626 * @param {string} response.errorCode Error code for the error that occurred.
627 * @param {string} response.errorMessage The error that occurred.
628 */
629 wp.updates.updatePluginError = function( response ) {
630 var $pluginRow, $card, $message, errorMessage, buttonText, ariaLabel,
631 $adminBarUpdates = $( '#wp-admin-bar-updates' );
632
633 if ( ! wp.updates.isValidResponse( response, 'update' ) ) {
634 return;
635 }
636
637 if ( wp.updates.maybeHandleCredentialError( response, 'update-plugin' ) ) {
638 return;
639 }
640
641 errorMessage = sprintf(
642 /* translators: %s: Error string for a failed update. */
643 __( 'Update failed: %s' ),
644 response.errorMessage
645 );
646
647 if ( 'plugins' === pagenow || 'plugins-network' === pagenow ) {
648 $pluginRow = $( 'tr[data-plugin="' + response.plugin + '"]' ).removeClass( 'is-enqueued' );
649
650 if ( response.plugin ) {
651 $message = $( 'tr[data-plugin="' + response.plugin + '"]' ).find( '.update-message' );
652 } else {
653 $message = $( 'tr[data-slug="' + response.slug + '"]' ).find( '.update-message' );
654 }
655 $message.removeClass( 'updating-message notice-warning' ).addClass( 'notice-error' ).find( 'p' ).html( errorMessage );
656
657 if ( response.pluginName ) {
658 $message.find( 'p' )
659 .attr(
660 'aria-label',
661 sprintf(
662 /* translators: %s: Plugin name and version. */
663 _x( '%s update failed.', 'plugin' ),
664 response.pluginName
665 )
666 );
667 } else {
668 $message.find( 'p' ).removeAttr( 'aria-label' );
669 }
670 } else if ( 'plugin-install' === pagenow || 'plugin-install-network' === pagenow ) {
671 buttonText = __( 'Update failed.' );
672
673 $card = $( '.plugin-card-' + response.slug + ', #plugin-information-footer' )
674 .append( wp.updates.adminNotice( {
675 className: 'update-message notice-error notice-alt is-dismissible',
676 message: errorMessage
677 } ) );
678
679 if ( $card.hasClass( 'plugin-card-' + response.slug ) ) {
680 $card.addClass( 'plugin-card-update-failed' );
681 }
682
683 $card.find( '.update-now' )
684 .text( buttonText )
685 .removeClass( 'updating-message' );
686
687 if ( response.pluginName ) {
688 ariaLabel = sprintf(
689 /* translators: %s: Plugin name and version. */
690 _x( '%s update failed.', 'plugin' ),
691 response.pluginName
692 );
693
694 $card.find( '.update-now' ).attr( 'aria-label', ariaLabel );
695 } else {
696 ariaLabel = '';
697 $card.find( '.update-now' ).removeAttr( 'aria-label' );
698 }
699
700 $card.on( 'click', '.notice.is-dismissible .notice-dismiss', function() {
701
702 // Use same delay as the total duration of the notice fadeTo + slideUp animation.
703 setTimeout( function() {
704 $card
705 .removeClass( 'plugin-card-update-failed' )
706 .find( '.column-name a' ).trigger( 'focus' );
707
708 $card.find( '.update-now' )
709 .attr( 'aria-label', false )
710 .text( __( 'Update Now' ) );
711 }, 200 );
712 } );
713 }
714
715 $adminBarUpdates.removeClass( 'spin' );
716
717 wp.a11y.speak( errorMessage, 'assertive' );
718
719 if ( 'plugin-information-footer' === $card.attr('id' ) ) {
720 wp.updates.setCardButtonStatus(
721 {
722 status: 'plugin-update-failed',
723 slug: response.slug,
724 removeClasses: 'updating-message',
725 text: buttonText,
726 ariaLabel: ariaLabel
727 }
728 );
729 }
730
731 $document.trigger( 'wp-plugin-update-error', response );
732 };
733
734 /**
735 * Sends an Ajax request to the server to install a plugin.
736 *
737 * @since 4.6.0
738 *
739 * @param {Object} args Arguments.
740 * @param {string} args.slug Plugin identifier in the WordPress.org Plugin repository.
741 * @param {installPluginSuccess=} args.success Optional. Success callback. Default: wp.updates.installPluginSuccess
742 * @param {installPluginError=} args.error Optional. Error callback. Default: wp.updates.installPluginError
743 * @return {$.promise} A jQuery promise that represents the request,
744 * decorated with an abort() method.
745 */
746 wp.updates.installPlugin = function( args ) {
747 var $card = $( '.plugin-card-' + args.slug + ', #plugin-information-footer' ),
748 $message = $card.find( '.install-now' ),
749 buttonText = __( 'Installing...' ),
750 ariaLabel;
751
752 args = _.extend( {
753 success: wp.updates.installPluginSuccess,
754 error: wp.updates.installPluginError
755 }, args );
756
757 if ( 'import' === pagenow ) {
758 $message = $( '[data-slug="' + args.slug + '"]' );
759 }
760
761 if ( $message.html() !== __( 'Installing...' ) ) {
762 $message.data( 'originaltext', $message.html() );
763 }
764
765 ariaLabel = sprintf(
766 /* translators: %s: Plugin name and version. */
767 _x( 'Installing %s...', 'plugin' ),
768 $message.data( 'name' )
769 );
770
771 $message
772 .addClass( 'updating-message' )
773 .attr( 'aria-label', ariaLabel )
774 .text( buttonText );
775
776 wp.a11y.speak( __( 'Installing... please wait.' ) );
777
778 // Remove previous error messages, if any.
779 $card.removeClass( 'plugin-card-install-failed' ).find( '.notice.notice-error' ).remove();
780
781 $document.trigger( 'wp-plugin-installing', args );
782
783 if ( 'plugin-information-footer' === $message.parent().attr( 'id' ) ) {
784 wp.updates.setCardButtonStatus(
785 {
786 status: 'installing-plugin',
787 slug: args.slug,
788 addClasses: 'updating-message',
789 text: buttonText,
790 ariaLabel: ariaLabel
791 }
792 );
793 }
794
795 return wp.updates.ajax( 'install-plugin', args );
796 };
797
798 /**
799 * Updates the UI appropriately after a successful plugin install.
800 *
801 * @since 4.6.0
802 *
803 * @param {Object} response Response from the server.
804 * @param {string} response.slug Slug of the installed plugin.
805 * @param {string} response.pluginName Name of the installed plugin.
806 * @param {string} response.activateUrl URL to activate the just installed plugin.
807 */
808 wp.updates.installPluginSuccess = function( response ) {
809 var $message = $( '.plugin-card-' + response.slug + ', #plugin-information-footer' ).find( '.install-now' ),
810 buttonText = _x( 'Installed!', 'plugin' ),
811 ariaLabel = sprintf(
812 /* translators: %s: Plugin name and version. */
813 _x( '%s installed!', 'plugin' ),
814 response.pluginName
815 );
816
817 $message
818 .removeClass( 'updating-message' )
819 .addClass( 'updated-message installed button-disabled' )
820 .attr( 'aria-label', ariaLabel )
821 .text( buttonText );
822
823 wp.a11y.speak( __( 'Installation completed successfully.' ) );
824
825 $document.trigger( 'wp-plugin-install-success', response );
826
827 if ( response.activateUrl ) {
828 setTimeout( function() {
829 wp.updates.checkPluginDependencies( {
830 slug: response.slug
831 } );
832 }, 1000 );
833 }
834
835 if ( 'plugin-information-footer' === $message.parent().attr( 'id' ) ) {
836 wp.updates.setCardButtonStatus(
837 {
838 status: 'installed-plugin',
839 slug: response.slug,
840 removeClasses: 'updating-message',
841 addClasses: 'updated-message installed button-disabled',
842 text: buttonText,
843 ariaLabel: ariaLabel
844 }
845 );
846 }
847 };
848
849 /**
850 * Updates the UI appropriately after a failed plugin install.
851 *
852 * @since 4.6.0
853 *
854 * @param {Object} response Response from the server.
855 * @param {string} response.slug Slug of the plugin to be installed.
856 * @param {string=} response.pluginName Optional. Name of the plugin to be installed.
857 * @param {string} response.errorCode Error code for the error that occurred.
858 * @param {string} response.errorMessage The error that occurred.
859 */
860 wp.updates.installPluginError = function( response ) {
861 var $card = $( '.plugin-card-' + response.slug + ', #plugin-information-footer' ),
862 $button = $card.find( '.install-now' ),
863 buttonText = __( 'Installation failed.' ),
864 ariaLabel = sprintf(
865 /* translators: %s: Plugin name and version. */
866 _x( '%s installation failed', 'plugin' ),
867 $button.data( 'name' )
868 ),
869 errorMessage;
870
871 if ( ! wp.updates.isValidResponse( response, 'install' ) ) {
872 return;
873 }
874
875 if ( wp.updates.maybeHandleCredentialError( response, 'install-plugin' ) ) {
876 return;
877 }
878
879 errorMessage = sprintf(
880 /* translators: %s: Error string for a failed installation. */
881 __( 'Installation failed: %s' ),
882 response.errorMessage
883 );
884
885 $card
886 .addClass( 'plugin-card-update-failed' )
887 .append( '<div class="notice notice-error notice-alt is-dismissible" role="alert"><p>' + errorMessage + '</p></div>' );
888
889 $card.on( 'click', '.notice.is-dismissible .notice-dismiss', function() {
890
891 // Use same delay as the total duration of the notice fadeTo + slideUp animation.
892 setTimeout( function() {
893 $card
894 .removeClass( 'plugin-card-update-failed' )
895 .find( '.column-name a' ).trigger( 'focus' );
896 }, 200 );
897 } );
898
899 $button
900 .removeClass( 'updating-message' ).addClass( 'button-disabled' )
901 .attr( 'aria-label', ariaLabel )
902 .text( buttonText );
903
904 wp.a11y.speak( errorMessage, 'assertive' );
905
906 wp.updates.setCardButtonStatus(
907 {
908 status: 'plugin-install-failed',
909 slug: response.slug,
910 removeClasses: 'updating-message',
911 addClasses: 'button-disabled',
912 text: buttonText,
913 ariaLabel: ariaLabel
914 }
915 );
916
917 $document.trigger( 'wp-plugin-install-error', response );
918 };
919
920 /**
921 * Sends an Ajax request to the server to check a plugin's dependencies.
922 *
923 * @since 6.5.0
924 *
925 * @param {Object} args Arguments.
926 * @param {string} args.slug Plugin identifier in the WordPress.org Plugin repository.
927 * @param {checkPluginDependenciesSuccess=} args.success Optional. Success callback. Default: wp.updates.checkPluginDependenciesSuccess
928 * @param {checkPluginDependenciesError=} args.error Optional. Error callback. Default: wp.updates.checkPluginDependenciesError
929 * @return {$.promise} A jQuery promise that represents the request,
930 * decorated with an abort() method.
931 */
932 wp.updates.checkPluginDependencies = function( args ) {
933 args = _.extend( {
934 success: wp.updates.checkPluginDependenciesSuccess,
935 error: wp.updates.checkPluginDependenciesError
936 }, args );
937
938 wp.a11y.speak( __( 'Checking plugin dependencies... please wait.' ) );
939 $document.trigger( 'wp-checking-plugin-dependencies', args );
940
941 return wp.updates.ajax( 'check_plugin_dependencies', args );
942 };
943
944 /**
945 * Updates the UI appropriately after a successful plugin dependencies check.
946 *
947 * @since 6.5.0
948 *
949 * @param {Object} response Response from the server.
950 * @param {string} response.slug Slug of the checked plugin.
951 * @param {string} response.pluginName Name of the checked plugin.
952 * @param {string} response.plugin The plugin file, relative to the plugins directory.
953 * @param {string} response.activateUrl URL to activate the just checked plugin.
954 */
955 wp.updates.checkPluginDependenciesSuccess = function( response ) {
956 var $message = $( '.plugin-card-' + response.slug + ', #plugin-information-footer' ).find( '.install-now' ),
957 buttonText, ariaLabel;
958
959 // Transform the 'Install' button into an 'Activate' button.
960 $message
961 .removeClass( 'install-now installed button-disabled updated-message' )
962 .addClass( 'activate-now button-primary' )
963 .attr( 'href', response.activateUrl );
964
965 wp.a11y.speak( __( 'Plugin dependencies check completed successfully.' ) );
966 $document.trigger( 'wp-check-plugin-dependencies-success', response );
967
968 if ( 'plugins-network' === pagenow || 'plugin-install-network' === pagenow ) {
969 buttonText = _x( 'Network Activate', 'plugin' );
970 ariaLabel = sprintf(
971 /* translators: %s: Plugin name. */
972 _x( 'Network Activate %s', 'plugin' ),
973 response.pluginName
974 );
975
976 $message
977 .attr( 'aria-label', ariaLabel )
978 .text( buttonText );
979 } else {
980 buttonText = _x( 'Activate', 'plugin' );
981 ariaLabel = sprintf(
982 /* translators: %s: Plugin name. */
983 _x( 'Activate %s', 'plugin' ),
984 response.pluginName
985 );
986
987 $message
988 .attr( 'aria-label', ariaLabel )
989 .attr( 'data-name', response.pluginName )
990 .attr( 'data-slug', response.slug )
991 .attr( 'data-plugin', response.plugin )
992 .text( buttonText );
993 }
994
995 if ( 'plugin-information-footer' === $message.parent().attr( 'id' ) ) {
996 wp.updates.setCardButtonStatus(
997 {
998 status: 'dependencies-check-success',
999 slug: response.slug,
1000 removeClasses: 'install-now installed button-disabled updated-message',
1001 addClasses: 'activate-now button-primary',
1002 text: buttonText,
1003 ariaLabel: ariaLabel,
1004 pluginName: response.pluginName,
1005 plugin: response.plugin,
1006 href: response.activateUrl
1007 }
1008 );
1009 }
1010 };
1011
1012 /**
1013 * Updates the UI appropriately after a failed plugin dependencies check.
1014 *
1015 * @since 6.5.0
1016 *
1017 * @param {Object} response Response from the server.
1018 * @param {string} response.slug Slug of the plugin to be checked.
1019 * @param {string=} response.pluginName Optional. Name of the plugin to be checked.
1020 * @param {string} response.errorCode Error code for the error that occurred.
1021 * @param {string} response.errorMessage The error that occurred.
1022 */
1023 wp.updates.checkPluginDependenciesError = function( response ) {
1024 var $message = $( '.plugin-card-' + response.slug + ', #plugin-information-footer' ).find( '.install-now' ),
1025 buttonText = _x( 'Activate', 'plugin' ),
1026 ariaLabel = sprintf(
1027 /* translators: 1: Plugin name, 2. The reason the plugin cannot be activated. */
1028 _x( 'Cannot activate %1$s. %2$s', 'plugin' ),
1029 response.pluginName,
1030 response.errorMessage
1031 ),
1032 errorMessage;
1033
1034 if ( ! wp.updates.isValidResponse( response, 'check-dependencies' ) ) {
1035 return;
1036 }
1037
1038 errorMessage = sprintf(
1039 /* translators: %s: Error string for a failed activation. */
1040 __( 'Activation failed: %s' ),
1041 response.errorMessage
1042 );
1043
1044 wp.a11y.speak( errorMessage, 'assertive' );
1045 $document.trigger( 'wp-check-plugin-dependencies-error', response );
1046
1047 $message
1048 .removeClass( 'install-now installed updated-message' )
1049 .addClass( 'activate-now button-primary' )
1050 .attr( 'aria-label', ariaLabel )
1051 .text( buttonText );
1052
1053 if ( 'plugin-information-footer' === $message.parent().attr('id' ) ) {
1054 wp.updates.setCardButtonStatus(
1055 {
1056 status: 'dependencies-check-failed',
1057 slug: response.slug,
1058 removeClasses: 'install-now installed updated-message',
1059 addClasses: 'activate-now button-primary',
1060 text: buttonText,
1061 ariaLabel: ariaLabel
1062 }
1063 );
1064 }
1065 };
1066
1067 /**
1068 * Sends an Ajax request to the server to activate a plugin.
1069 *
1070 * @since 6.5.0
1071 *
1072 * @param {Object} args Arguments.
1073 * @param {string} args.name The name of the plugin.
1074 * @param {string} args.slug Plugin identifier in the WordPress.org Plugin repository.
1075 * @param {string} args.plugin The plugin file, relative to the plugins directory.
1076 * @param {activatePluginSuccess=} args.success Optional. Success callback. Default: wp.updates.activatePluginSuccess
1077 * @param {activatePluginError=} args.error Optional. Error callback. Default: wp.updates.activatePluginError
1078 * @return {$.promise} A jQuery promise that represents the request,
1079 * decorated with an abort() method.
1080 */
1081 wp.updates.activatePlugin = function( args ) {
1082 var $message = $( '.plugin-card-' + args.slug + ', #plugin-information-footer' ).find( '.activate-now, .activating-message' );
1083
1084 args = _.extend( {
1085 success: wp.updates.activatePluginSuccess,
1086 error: wp.updates.activatePluginError
1087 }, args );
1088
1089 wp.a11y.speak( __( 'Activating... please wait.' ) );
1090 $document.trigger( 'wp-activating-plugin', args );
1091
1092 if ( 'plugin-information-footer' === $message.parent().attr( 'id' ) ) {
1093 wp.updates.setCardButtonStatus(
1094 {
1095 status: 'activating-plugin',
1096 slug: args.slug,
1097 removeClasses: 'installed updated-message button-primary',
1098 addClasses: 'activating-message',
1099 text: __( 'Activating...' ),
1100 ariaLabel: sprintf(
1101 /* translators: %s: Plugin name. */
1102 _x( 'Activating %s', 'plugin' ),
1103 args.name
1104 )
1105 }
1106 );
1107 }
1108
1109 return wp.updates.ajax( 'activate-plugin', args );
1110 };
1111
1112 /**
1113 * Updates the UI appropriately after a successful plugin activation.
1114 *
1115 * @since 6.5.0
1116 *
1117 * @param {Object} response Response from the server.
1118 * @param {string} response.slug Slug of the activated plugin.
1119 * @param {string} response.pluginName Name of the activated plugin.
1120 * @param {string} response.plugin The plugin file, relative to the plugins directory.
1121 */
1122 wp.updates.activatePluginSuccess = function( response ) {
1123 var $message = $( '.plugin-card-' + response.slug + ', #plugin-information-footer' ).find( '.activating-message' ),
1124 buttonText = _x( 'Activated!', 'plugin' ),
1125 ariaLabel = sprintf(
1126 /* translators: %s: The plugin name. */
1127 '%s activated successfully.',
1128 response.pluginName
1129 );
1130
1131 wp.a11y.speak( __( 'Activation completed successfully.' ) );
1132 $document.trigger( 'wp-plugin-activate-success', response );
1133
1134 $message
1135 .removeClass( 'activating-message' )
1136 .addClass( 'activated-message button-disabled' )
1137 .attr( 'aria-label', ariaLabel )
1138 .text( buttonText );
1139
1140 if ( 'plugin-information-footer' === $message.parent().attr( 'id' ) ) {
1141 wp.updates.setCardButtonStatus(
1142 {
1143 status: 'activated-plugin',
1144 slug: response.slug,
1145 removeClasses: 'activating-message',
1146 addClasses: 'activated-message button-disabled',
1147 text: buttonText,
1148 ariaLabel: ariaLabel
1149 }
1150 );
1151 }
1152
1153 setTimeout( function() {
1154 $message.removeClass( 'activated-message' )
1155 .text( _x( 'Active', 'plugin' ) );
1156
1157 if ( 'plugin-information-footer' === $message.parent().attr( 'id' ) ) {
1158 wp.updates.setCardButtonStatus(
1159 {
1160 status: 'plugin-active',
1161 slug: response.slug,
1162 removeClasses: 'activated-message',
1163 text: _x( 'Active', 'plugin' ),
1164 ariaLabel: sprintf(
1165 /* translators: %s: The plugin name. */
1166 '%s is active.',
1167 response.pluginName
1168 )
1169 }
1170 );
1171 }
1172 }, 1000 );
1173 };
1174
1175 /**
1176 * Updates the UI appropriately after a failed plugin activation.
1177 *
1178 * @since 6.5.0
1179 *
1180 * @param {Object} response Response from the server.
1181 * @param {string} response.slug Slug of the plugin to be activated.
1182 * @param {string=} response.pluginName Optional. Name of the plugin to be activated.
1183 * @param {string} response.errorCode Error code for the error that occurred.
1184 * @param {string} response.errorMessage The error that occurred.
1185 */
1186 wp.updates.activatePluginError = function( response ) {
1187 var $message = $( '.plugin-card-' + response.slug + ', #plugin-information-footer' ).find( '.activating-message' ),
1188 buttonText = __( 'Activation failed.' ),
1189 ariaLabel = sprintf(
1190 /* translators: %s: Plugin name. */
1191 _x( '%s activation failed', 'plugin' ),
1192 response.pluginName
1193 ),
1194 errorMessage;
1195
1196 if ( ! wp.updates.isValidResponse( response, 'activate' ) ) {
1197 return;
1198 }
1199
1200 errorMessage = sprintf(
1201 /* translators: %s: Error string for a failed activation. */
1202 __( 'Activation failed: %s' ),
1203 response.errorMessage
1204 );
1205
1206 wp.a11y.speak( errorMessage, 'assertive' );
1207 $document.trigger( 'wp-plugin-activate-error', response );
1208
1209 $message
1210 .removeClass( 'install-now installed activating-message' )
1211 .addClass( 'button-disabled' )
1212 .attr( 'aria-label', ariaLabel )
1213 .text( buttonText );
1214
1215 if ( 'plugin-information-footer' === $message.parent().attr( 'id' ) ) {
1216 wp.updates.setCardButtonStatus(
1217 {
1218 status: 'plugin-activation-failed',
1219 slug: response.slug,
1220 removeClasses: 'install-now installed activating-message',
1221 addClasses: 'button-disabled',
1222 text: buttonText,
1223 ariaLabel: ariaLabel
1224 }
1225 );
1226 }
1227 };
1228
1229 /**
1230 * Updates the UI appropriately after a successful importer install.
1231 *
1232 * @since 4.6.0
1233 *
1234 * @param {Object} response Response from the server.
1235 * @param {string} response.slug Slug of the installed plugin.
1236 * @param {string} response.pluginName Name of the installed plugin.
1237 * @param {string} response.activateUrl URL to activate the just installed plugin.
1238 */
1239 wp.updates.installImporterSuccess = function( response ) {
1240 wp.updates.addAdminNotice( {
1241 id: 'install-success',
1242 className: 'notice-success is-dismissible',
1243 message: sprintf(
1244 /* translators: %s: Activation URL. */
1245 __( 'Importer installed successfully. <a href="%s">Run importer</a>' ),
1246 response.activateUrl + '&from=import'
1247 )
1248 } );
1249
1250 $( '[data-slug="' + response.slug + '"]' )
1251 .removeClass( 'install-now updating-message' )
1252 .addClass( 'activate-now' )
1253 .attr({
1254 'href': response.activateUrl + '&from=import',
1255 'aria-label':sprintf(
1256 /* translators: %s: Importer name. */
1257 __( 'Run %s' ),
1258 response.pluginName
1259 )
1260 })
1261 .text( __( 'Run Importer' ) );
1262
1263 wp.a11y.speak( __( 'Installation completed successfully.' ) );
1264
1265 $document.trigger( 'wp-importer-install-success', response );
1266 };
1267
1268 /**
1269 * Updates the UI appropriately after a failed importer install.
1270 *
1271 * @since 4.6.0
1272 *
1273 * @param {Object} response Response from the server.
1274 * @param {string} response.slug Slug of the plugin to be installed.
1275 * @param {string=} response.pluginName Optional. Name of the plugin to be installed.
1276 * @param {string} response.errorCode Error code for the error that occurred.
1277 * @param {string} response.errorMessage The error that occurred.
1278 */
1279 wp.updates.installImporterError = function( response ) {
1280 var errorMessage = sprintf(
1281 /* translators: %s: Error string for a failed installation. */
1282 __( 'Installation failed: %s' ),
1283 response.errorMessage
1284 ),
1285 $installLink = $( '[data-slug="' + response.slug + '"]' ),
1286 pluginName = $installLink.data( 'name' );
1287
1288 if ( ! wp.updates.isValidResponse( response, 'install' ) ) {
1289 return;
1290 }
1291
1292 if ( wp.updates.maybeHandleCredentialError( response, 'install-plugin' ) ) {
1293 return;
1294 }
1295
1296 wp.updates.addAdminNotice( {
1297 id: response.errorCode,
1298 className: 'notice-error is-dismissible',
1299 message: errorMessage
1300 } );
1301
1302 $installLink
1303 .removeClass( 'updating-message' )
1304 .attr(
1305 'aria-label',
1306 sprintf(
1307 /* translators: %s: Plugin name. */
1308 _x( 'Install %s now', 'plugin' ),
1309 pluginName
1310 )
1311 )
1312 .text( _x( 'Install Now', 'plugin' ) );
1313
1314 wp.a11y.speak( errorMessage, 'assertive' );
1315
1316 $document.trigger( 'wp-importer-install-error', response );
1317 };
1318
1319 /**
1320 * Sends an Ajax request to the server to delete a plugin.
1321 *
1322 * @since 4.6.0
1323 *
1324 * @param {Object} args Arguments.
1325 * @param {string} args.plugin Basename of the plugin to be deleted.
1326 * @param {string} args.slug Slug of the plugin to be deleted.
1327 * @param {deletePluginSuccess=} args.success Optional. Success callback. Default: wp.updates.deletePluginSuccess
1328 * @param {deletePluginError=} args.error Optional. Error callback. Default: wp.updates.deletePluginError
1329 * @return {$.promise} A jQuery promise that represents the request,
1330 * decorated with an abort() method.
1331 */
1332 wp.updates.deletePlugin = function( args ) {
1333 var $link = $( '[data-plugin="' + args.plugin + '"]' ).find( '.row-actions a.delete' );
1334
1335 args = _.extend( {
1336 success: wp.updates.deletePluginSuccess,
1337 error: wp.updates.deletePluginError
1338 }, args );
1339
1340 if ( $link.html() !== __( 'Deleting...' ) ) {
1341 $link
1342 .data( 'originaltext', $link.html() )
1343 .text( __( 'Deleting...' ) );
1344 }
1345
1346 wp.a11y.speak( __( 'Deleting...' ) );
1347
1348 $document.trigger( 'wp-plugin-deleting', args );
1349
1350 return wp.updates.ajax( 'delete-plugin', args );
1351 };
1352
1353 /**
1354 * Updates the UI appropriately after a successful plugin deletion.
1355 *
1356 * @since 4.6.0
1357 *
1358 * @param {Object} response Response from the server.
1359 * @param {string} response.slug Slug of the plugin that was deleted.
1360 * @param {string} response.plugin Base name of the plugin that was deleted.
1361 * @param {string} response.pluginName Name of the plugin that was deleted.
1362 */
1363 wp.updates.deletePluginSuccess = function( response ) {
1364
1365 // Removes the plugin and updates rows.
1366 $( '[data-plugin="' + response.plugin + '"]' ).css( { backgroundColor: '#faafaa' } ).fadeOut( 350, function() {
1367 var $form = $( '#bulk-action-form' ),
1368 $views = $( '.subsubsub' ),
1369 $pluginRow = $( this ),
1370 $currentView = $views.find( '[aria-current="page"]' ),
1371 $itemsCount = $( '.displaying-num' ),
1372 columnCount = $form.find( 'thead th:not(.hidden), thead td' ).length,
1373 pluginDeletedRow = wp.template( 'item-deleted-row' ),
1374 /**
1375 * Plugins Base names of plugins in their different states.
1376 *
1377 * @type {Object}
1378 */
1379 plugins = settings.plugins,
1380 remainingCount;
1381
1382 // Add a success message after deleting a plugin.
1383 if ( ! $pluginRow.hasClass( 'plugin-update-tr' ) ) {
1384 $pluginRow.after(
1385 pluginDeletedRow( {
1386 slug: response.slug,
1387 plugin: response.plugin,
1388 colspan: columnCount,
1389 name: response.pluginName
1390 } )
1391 );
1392 }
1393
1394 $pluginRow.remove();
1395
1396 // Remove plugin from update count.
1397 if ( -1 !== _.indexOf( plugins.upgrade, response.plugin ) ) {
1398 plugins.upgrade = _.without( plugins.upgrade, response.plugin );
1399 wp.updates.decrementCount( 'plugin' );
1400 }
1401
1402 // Remove from views.
1403 if ( -1 !== _.indexOf( plugins.inactive, response.plugin ) ) {
1404 plugins.inactive = _.without( plugins.inactive, response.plugin );
1405 if ( plugins.inactive.length ) {
1406 $views.find( '.inactive .count' ).text( '(' + plugins.inactive.length + ')' );
1407 } else {
1408 $views.find( '.inactive' ).remove();
1409 }
1410 }
1411
1412 if ( -1 !== _.indexOf( plugins.active, response.plugin ) ) {
1413 plugins.active = _.without( plugins.active, response.plugin );
1414 if ( plugins.active.length ) {
1415 $views.find( '.active .count' ).text( '(' + plugins.active.length + ')' );
1416 } else {
1417 $views.find( '.active' ).remove();
1418 }
1419 }
1420
1421 if ( -1 !== _.indexOf( plugins.recently_activated, response.plugin ) ) {
1422 plugins.recently_activated = _.without( plugins.recently_activated, response.plugin );
1423 if ( plugins.recently_activated.length ) {
1424 $views.find( '.recently_activated .count' ).text( '(' + plugins.recently_activated.length + ')' );
1425 } else {
1426 $views.find( '.recently_activated' ).remove();
1427 }
1428 }
1429
1430 if ( -1 !== _.indexOf( plugins['auto-update-enabled'], response.plugin ) ) {
1431 plugins['auto-update-enabled'] = _.without( plugins['auto-update-enabled'], response.plugin );
1432 if ( plugins['auto-update-enabled'].length ) {
1433 $views.find( '.auto-update-enabled .count' ).text( '(' + plugins['auto-update-enabled'].length + ')' );
1434 } else {
1435 $views.find( '.auto-update-enabled' ).remove();
1436 }
1437 }
1438
1439 if ( -1 !== _.indexOf( plugins['auto-update-disabled'], response.plugin ) ) {
1440 plugins['auto-update-disabled'] = _.without( plugins['auto-update-disabled'], response.plugin );
1441 if ( plugins['auto-update-disabled'].length ) {
1442 $views.find( '.auto-update-disabled .count' ).text( '(' + plugins['auto-update-disabled'].length + ')' );
1443 } else {
1444 $views.find( '.auto-update-disabled' ).remove();
1445 }
1446 }
1447
1448 plugins.all = _.without( plugins.all, response.plugin );
1449
1450 if ( plugins.all.length ) {
1451 $views.find( '.all .count' ).text( '(' + plugins.all.length + ')' );
1452 } else {
1453 $form.find( '.tablenav' ).css( { visibility: 'hidden' } );
1454 $views.find( '.all' ).remove();
1455
1456 if ( ! $form.find( 'tr.no-items' ).length ) {
1457 $form.find( '#the-list' ).append( '<tr class="no-items"><td class="colspanchange" colspan="' + columnCount + '">' + __( 'No plugins are currently available.' ) + '</td></tr>' );
1458 }
1459 }
1460
1461 if ( $itemsCount.length && $currentView.length ) {
1462 remainingCount = plugins[ $currentView.parent( 'li' ).attr('class') ].length;
1463 $itemsCount.text(
1464 sprintf(
1465 /* translators: %s: The remaining number of plugins. */
1466 _nx( '%s item', '%s items', remainingCount, 'plugin/plugins' ),
1467 remainingCount
1468 )
1469 );
1470 }
1471 } );
1472
1473 wp.a11y.speak( _x( 'Deleted!', 'plugin' ) );
1474
1475 $document.trigger( 'wp-plugin-delete-success', response );
1476 };
1477
1478 /**
1479 * Updates the UI appropriately after a failed plugin deletion.
1480 *
1481 * @since 4.6.0
1482 *
1483 * @param {Object} response Response from the server.
1484 * @param {string} response.slug Slug of the plugin to be deleted.
1485 * @param {string} response.plugin Base name of the plugin to be deleted
1486 * @param {string=} response.pluginName Optional. Name of the plugin to be deleted.
1487 * @param {string} response.errorCode Error code for the error that occurred.
1488 * @param {string} response.errorMessage The error that occurred.
1489 */
1490 wp.updates.deletePluginError = function( response ) {
1491 var $plugin, $pluginUpdateRow,
1492 pluginUpdateRow = wp.template( 'item-update-row' ),
1493 noticeContent = wp.updates.adminNotice( {
1494 className: 'update-message notice-error notice-alt',
1495 message: response.errorMessage
1496 } );
1497
1498 if ( response.plugin ) {
1499 $plugin = $( 'tr.inactive[data-plugin="' + response.plugin + '"]' );
1500 $pluginUpdateRow = $plugin.siblings( '[data-plugin="' + response.plugin + '"]' );
1501 } else {
1502 $plugin = $( 'tr.inactive[data-slug="' + response.slug + '"]' );
1503 $pluginUpdateRow = $plugin.siblings( '[data-slug="' + response.slug + '"]' );
1504 }
1505
1506 if ( ! wp.updates.isValidResponse( response, 'delete' ) ) {
1507 return;
1508 }
1509
1510 if ( wp.updates.maybeHandleCredentialError( response, 'delete-plugin' ) ) {
1511 return;
1512 }
1513
1514 // Add a plugin update row if it doesn't exist yet.
1515 if ( ! $pluginUpdateRow.length ) {
1516 $plugin.addClass( 'update' ).after(
1517 pluginUpdateRow( {
1518 slug: response.slug,
1519 plugin: response.plugin || response.slug,
1520 colspan: $( '#bulk-action-form' ).find( 'thead th:not(.hidden), thead td' ).length,
1521 content: noticeContent
1522 } )
1523 );
1524 } else {
1525
1526 // Remove previous error messages, if any.
1527 $pluginUpdateRow.find( '.notice-error' ).remove();
1528
1529 $pluginUpdateRow.find( '.plugin-update' ).append( noticeContent );
1530 }
1531
1532 $document.trigger( 'wp-plugin-delete-error', response );
1533 };
1534
1535 /**
1536 * Sends an Ajax request to the server to update a theme.
1537 *
1538 * @since 4.6.0
1539 *
1540 * @param {Object} args Arguments.
1541 * @param {string} args.slug Theme stylesheet.
1542 * @param {updateThemeSuccess=} args.success Optional. Success callback. Default: wp.updates.updateThemeSuccess
1543 * @param {updateThemeError=} args.error Optional. Error callback. Default: wp.updates.updateThemeError
1544 * @return {$.promise} A jQuery promise that represents the request,
1545 * decorated with an abort() method.
1546 */
1547 wp.updates.updateTheme = function( args ) {
1548 var $notice;
1549
1550 args = _.extend( {
1551 success: wp.updates.updateThemeSuccess,
1552 error: wp.updates.updateThemeError
1553 }, args );
1554
1555 if ( 'themes-network' === pagenow ) {
1556 $notice = $( '[data-slug="' + args.slug + '"]' ).find( '.update-message' ).removeClass( 'notice-error' ).addClass( 'updating-message notice-warning' ).find( 'p' );
1557
1558 } else if ( 'customize' === pagenow ) {
1559
1560 // Update the theme details UI.
1561 $notice = $( '[data-slug="' + args.slug + '"].notice' ).removeClass( 'notice-large' );
1562
1563 $notice.find( 'h3' ).remove();
1564
1565 // Add the top-level UI, and update both.
1566 $notice = $notice.add( $( '#customize-control-installed_theme_' + args.slug ).find( '.update-message' ) );
1567 $notice = $notice.addClass( 'updating-message' ).find( 'p' );
1568
1569 } else {
1570 $notice = $( '#update-theme' ).closest( '.notice' ).removeClass( 'notice-large' );
1571
1572 $notice.find( 'h3' ).remove();
1573
1574 $notice = $notice.add( $( '[data-slug="' + args.slug + '"]' ).find( '.update-message' ) );
1575 $notice = $notice.addClass( 'updating-message' ).find( 'p' );
1576 }
1577
1578 if ( $notice.html() !== __( 'Updating...' ) ) {
1579 $notice.data( 'originaltext', $notice.html() );
1580 }
1581
1582 wp.a11y.speak( __( 'Updating... please wait.' ) );
1583 $notice.text( __( 'Updating...' ) );
1584
1585 $document.trigger( 'wp-theme-updating', args );
1586
1587 return wp.updates.ajax( 'update-theme', args );
1588 };
1589
1590 /**
1591 * Updates the UI appropriately after a successful theme update.
1592 *
1593 * @since 4.6.0
1594 * @since 5.5.0 Auto-update "time to next update" text cleared.
1595 *
1596 * @param {Object} response
1597 * @param {string} response.slug Slug of the theme to be updated.
1598 * @param {Object} response.theme Updated theme.
1599 * @param {string} response.oldVersion Old version of the theme.
1600 * @param {string} response.newVersion New version of the theme.
1601 */
1602 wp.updates.updateThemeSuccess = function( response ) {
1603 var isModalOpen = $( 'body.modal-open' ).length,
1604 $theme = $( '[data-slug="' + response.slug + '"]' ),
1605 updatedMessage = {
1606 className: 'updated-message notice-success notice-alt',
1607 message: _x( 'Updated!', 'theme' )
1608 },
1609 $notice, newText;
1610
1611 if ( 'customize' === pagenow ) {
1612 $theme = $( '.updating-message' ).siblings( '.theme-name' );
1613
1614 if ( $theme.length ) {
1615
1616 // Update the version number in the row.
1617 newText = $theme.html().replace( response.oldVersion, response.newVersion );
1618 $theme.html( newText );
1619 }
1620
1621 $notice = $( '.theme-info .notice' ).add( wp.customize.control( 'installed_theme_' + response.slug ).container.find( '.theme' ).find( '.update-message' ) );
1622 } else if ( 'themes-network' === pagenow ) {
1623 $notice = $theme.find( '.update-message' );
1624
1625 // Update the version number in the row.
1626 newText = $theme.find( '.theme-version-author-uri' ).html().replace( response.oldVersion, response.newVersion );
1627 $theme.find( '.theme-version-author-uri' ).html( newText );
1628
1629 // Clear the "time to next auto-update" text.
1630 $theme.find( '.auto-update-time' ).empty();
1631 } else {
1632 $notice = $( '.theme-info .notice' ).add( $theme.find( '.update-message' ) );
1633
1634 // Focus on Customize button after updating.
1635 if ( isModalOpen ) {
1636 $( '.load-customize:visible' ).trigger( 'focus' );
1637 $( '.theme-info .theme-autoupdate' ).find( '.auto-update-time' ).empty();
1638 } else {
1639 $theme.find( '.load-customize' ).trigger( 'focus' );
1640 }
1641 }
1642
1643 wp.updates.addAdminNotice( _.extend( { selector: $notice }, updatedMessage ) );
1644 wp.a11y.speak( __( 'Update completed successfully.' ) );
1645
1646 wp.updates.decrementCount( 'theme' );
1647
1648 $document.trigger( 'wp-theme-update-success', response );
1649
1650 // Show updated message after modal re-rendered.
1651 if ( isModalOpen && 'customize' !== pagenow ) {
1652 $( '.theme-info .theme-author' ).after( wp.updates.adminNotice( updatedMessage ) );
1653 }
1654 };
1655
1656 /**
1657 * Updates the UI appropriately after a failed theme update.
1658 *
1659 * @since 4.6.0
1660 *
1661 * @param {Object} response Response from the server.
1662 * @param {string} response.slug Slug of the theme to be updated.
1663 * @param {string} response.errorCode Error code for the error that occurred.
1664 * @param {string} response.errorMessage The error that occurred.
1665 */
1666 wp.updates.updateThemeError = function( response ) {
1667 var $theme = $( '[data-slug="' + response.slug + '"]' ),
1668 errorMessage = sprintf(
1669 /* translators: %s: Error string for a failed update. */
1670 __( 'Update failed: %s' ),
1671 response.errorMessage
1672 ),
1673 $notice;
1674
1675 if ( ! wp.updates.isValidResponse( response, 'update' ) ) {
1676 return;
1677 }
1678
1679 if ( wp.updates.maybeHandleCredentialError( response, 'update-theme' ) ) {
1680 return;
1681 }
1682
1683 if ( 'customize' === pagenow ) {
1684 $theme = wp.customize.control( 'installed_theme_' + response.slug ).container.find( '.theme' );
1685 }
1686
1687 if ( 'themes-network' === pagenow ) {
1688 $notice = $theme.find( '.update-message ' );
1689 } else {
1690 $notice = $( '.theme-info .notice' ).add( $theme.find( '.notice' ) );
1691
1692 $( 'body.modal-open' ).length ? $( '.load-customize:visible' ).trigger( 'focus' ) : $theme.find( '.load-customize' ).trigger( 'focus');
1693 }
1694
1695 wp.updates.addAdminNotice( {
1696 selector: $notice,
1697 className: 'update-message notice-error notice-alt is-dismissible',
1698 message: errorMessage
1699 } );
1700
1701 wp.a11y.speak( errorMessage );
1702
1703 $document.trigger( 'wp-theme-update-error', response );
1704 };
1705
1706 /**
1707 * Sends an Ajax request to the server to install a theme.
1708 *
1709 * @since 4.6.0
1710 *
1711 * @param {Object} args
1712 * @param {string} args.slug Theme stylesheet.
1713 * @param {installThemeSuccess=} args.success Optional. Success callback. Default: wp.updates.installThemeSuccess
1714 * @param {installThemeError=} args.error Optional. Error callback. Default: wp.updates.installThemeError
1715 * @return {$.promise} A jQuery promise that represents the request,
1716 * decorated with an abort() method.
1717 */
1718 wp.updates.installTheme = function( args ) {
1719 var $message = $( '.theme-install[data-slug="' + args.slug + '"]' );
1720
1721 args = _.extend( {
1722 success: wp.updates.installThemeSuccess,
1723 error: wp.updates.installThemeError
1724 }, args );
1725
1726 $message.addClass( 'updating-message' );
1727 $message.parents( '.theme' ).addClass( 'focus' );
1728 if ( $message.html() !== __( 'Installing...' ) ) {
1729 $message.data( 'originaltext', $message.html() );
1730 }
1731
1732 $message
1733 .attr(
1734 'aria-label',
1735 sprintf(
1736 /* translators: %s: Theme name and version. */
1737 _x( 'Installing %s...', 'theme' ),
1738 $message.data( 'name' )
1739 )
1740 )
1741 .text( __( 'Installing...' ) );
1742
1743 wp.a11y.speak( __( 'Installing... please wait.' ) );
1744
1745 // Remove previous error messages, if any.
1746 $( '.install-theme-info, [data-slug="' + args.slug + '"]' ).removeClass( 'theme-install-failed' ).find( '.notice.notice-error' ).remove();
1747
1748 $document.trigger( 'wp-theme-installing', args );
1749
1750 return wp.updates.ajax( 'install-theme', args );
1751 };
1752
1753 /**
1754 * Updates the UI appropriately after a successful theme install.
1755 *
1756 * @since 4.6.0
1757 *
1758 * @param {Object} response Response from the server.
1759 * @param {string} response.slug Slug of the theme to be installed.
1760 * @param {string} response.customizeUrl URL to the Customizer for the just installed theme.
1761 * @param {string} response.activateUrl URL to activate the just installed theme.
1762 */
1763 wp.updates.installThemeSuccess = function( response ) {
1764 var $card = $( '.wp-full-overlay-header, [data-slug=' + response.slug + ']' ),
1765 $message;
1766
1767 $document.trigger( 'wp-theme-install-success', response );
1768
1769 $message = $card.find( '.button-primary' )
1770 .removeClass( 'updating-message' )
1771 .addClass( 'updated-message disabled' )
1772 .attr(
1773 'aria-label',
1774 sprintf(
1775 /* translators: %s: Theme name and version. */
1776 _x( '%s installed!', 'theme' ),
1777 response.themeName
1778 )
1779 )
1780 .text( _x( 'Installed!', 'theme' ) );
1781
1782 wp.a11y.speak( __( 'Installation completed successfully.' ) );
1783
1784 setTimeout( function() {
1785
1786 if ( response.activateUrl ) {
1787
1788 // Transform the 'Install' button into an 'Activate' button.
1789 $message
1790 .attr( 'href', response.activateUrl )
1791 .removeClass( 'theme-install updated-message disabled' )
1792 .addClass( 'activate' );
1793
1794 if ( 'themes-network' === pagenow ) {
1795 $message
1796 .attr(
1797 'aria-label',
1798 sprintf(
1799 /* translators: %s: Theme name. */
1800 _x( 'Network Activate %s', 'theme' ),
1801 response.themeName
1802 )
1803 )
1804 .text( __( 'Network Enable' ) );
1805 } else {
1806 $message
1807 .attr(
1808 'aria-label',
1809 sprintf(
1810 /* translators: %s: Theme name. */
1811 _x( 'Activate %s', 'theme' ),
1812 response.themeName
1813 )
1814 )
1815 .text( _x( 'Activate', 'theme' ) );
1816 }
1817 }
1818
1819 if ( response.customizeUrl ) {
1820
1821 // Transform the 'Preview' button into a 'Live Preview' button.
1822 $message.siblings( '.preview' ).replaceWith( function () {
1823 return $( '<a>' )
1824 .attr( 'href', response.customizeUrl )
1825 .addClass( 'button load-customize' )
1826 .text( __( 'Live Preview' ) );
1827 } );
1828 }
1829 }, 1000 );
1830 };
1831
1832 /**
1833 * Updates the UI appropriately after a failed theme install.
1834 *
1835 * @since 4.6.0
1836 *
1837 * @param {Object} response Response from the server.
1838 * @param {string} response.slug Slug of the theme to be installed.
1839 * @param {string} response.errorCode Error code for the error that occurred.
1840 * @param {string} response.errorMessage The error that occurred.
1841 */
1842 wp.updates.installThemeError = function( response ) {
1843 var $card, $button,
1844 errorMessage = sprintf(
1845 /* translators: %s: Error string for a failed installation. */
1846 __( 'Installation failed: %s' ),
1847 response.errorMessage
1848 ),
1849 $message = wp.updates.adminNotice( {
1850 className: 'update-message notice-error notice-alt',
1851 message: errorMessage
1852 } );
1853
1854 if ( ! wp.updates.isValidResponse( response, 'install' ) ) {
1855 return;
1856 }
1857
1858 if ( wp.updates.maybeHandleCredentialError( response, 'install-theme' ) ) {
1859 return;
1860 }
1861
1862 if ( 'customize' === pagenow ) {
1863 if ( $document.find( 'body' ).hasClass( 'modal-open' ) ) {
1864 $button = $( '.theme-install[data-slug="' + response.slug + '"]' );
1865 $card = $( '.theme-overlay .theme-info' ).prepend( $message );
1866 } else {
1867 $button = $( '.theme-install[data-slug="' + response.slug + '"]' );
1868 $card = $button.closest( '.theme' ).addClass( 'theme-install-failed' ).append( $message );
1869 }
1870 wp.customize.notifications.remove( 'theme_installing' );
1871 } else {
1872 if ( $document.find( 'body' ).hasClass( 'full-overlay-active' ) ) {
1873 $button = $( '.theme-install[data-slug="' + response.slug + '"]' );
1874 $card = $( '.install-theme-info' ).prepend( $message );
1875 } else {
1876 $card = $( '[data-slug="' + response.slug + '"]' ).removeClass( 'focus' ).addClass( 'theme-install-failed' ).append( $message );
1877 $button = $card.find( '.theme-install' );
1878 }
1879 }
1880
1881 $button
1882 .removeClass( 'updating-message' )
1883 .attr(
1884 'aria-label',
1885 sprintf(
1886 /* translators: %s: Theme name and version. */
1887 _x( '%s installation failed', 'theme' ),
1888 $button.data( 'name' )
1889 )
1890 )
1891 .text( __( 'Installation failed.' ) );
1892
1893 wp.a11y.speak( errorMessage, 'assertive' );
1894
1895 $document.trigger( 'wp-theme-install-error', response );
1896 };
1897
1898 /**
1899 * Sends an Ajax request to the server to delete a theme.
1900 *
1901 * @since 4.6.0
1902 *
1903 * @param {Object} args
1904 * @param {string} args.slug Theme stylesheet.
1905 * @param {deleteThemeSuccess=} args.success Optional. Success callback. Default: wp.updates.deleteThemeSuccess
1906 * @param {deleteThemeError=} args.error Optional. Error callback. Default: wp.updates.deleteThemeError
1907 * @return {$.promise} A jQuery promise that represents the request,
1908 * decorated with an abort() method.
1909 */
1910 wp.updates.deleteTheme = function( args ) {
1911 var $button;
1912
1913 if ( 'themes' === pagenow ) {
1914 $button = $( '.theme-actions .delete-theme' );
1915 } else if ( 'themes-network' === pagenow ) {
1916 $button = $( '[data-slug="' + args.slug + '"]' ).find( '.row-actions a.delete' );
1917 }
1918
1919 args = _.extend( {
1920 success: wp.updates.deleteThemeSuccess,
1921 error: wp.updates.deleteThemeError
1922 }, args );
1923
1924 if ( $button && $button.html() !== __( 'Deleting...' ) ) {
1925 $button
1926 .data( 'originaltext', $button.html() )
1927 .text( __( 'Deleting...' ) );
1928 }
1929
1930 wp.a11y.speak( __( 'Deleting...' ) );
1931
1932 // Remove previous error messages, if any.
1933 $( '.theme-info .update-message' ).remove();
1934
1935 $document.trigger( 'wp-theme-deleting', args );
1936
1937 return wp.updates.ajax( 'delete-theme', args );
1938 };
1939
1940 /**
1941 * Updates the UI appropriately after a successful theme deletion.
1942 *
1943 * @since 4.6.0
1944 *
1945 * @param {Object} response Response from the server.
1946 * @param {string} response.slug Slug of the theme that was deleted.
1947 */
1948 wp.updates.deleteThemeSuccess = function( response ) {
1949 var $themeRows = $( '[data-slug="' + response.slug + '"]' );
1950
1951 if ( 'themes-network' === pagenow ) {
1952
1953 // Removes the theme and updates rows.
1954 $themeRows.css( { backgroundColor: '#faafaa' } ).fadeOut( 350, function() {
1955 var $views = $( '.subsubsub' ),
1956 $themeRow = $( this ),
1957 themes = settings.themes,
1958 deletedRow = wp.template( 'item-deleted-row' );
1959
1960 if ( ! $themeRow.hasClass( 'plugin-update-tr' ) ) {
1961 $themeRow.after(
1962 deletedRow( {
1963 slug: response.slug,
1964 colspan: $( '#bulk-action-form' ).find( 'thead th:not(.hidden), thead td' ).length,
1965 name: $themeRow.find( '.theme-title strong' ).text()
1966 } )
1967 );
1968 }
1969
1970 $themeRow.remove();
1971
1972 // Remove theme from update count.
1973 if ( -1 !== _.indexOf( themes.upgrade, response.slug ) ) {
1974 themes.upgrade = _.without( themes.upgrade, response.slug );
1975 wp.updates.decrementCount( 'theme' );
1976 }
1977
1978 // Remove from views.
1979 if ( -1 !== _.indexOf( themes.disabled, response.slug ) ) {
1980 themes.disabled = _.without( themes.disabled, response.slug );
1981 if ( themes.disabled.length ) {
1982 $views.find( '.disabled .count' ).text( '(' + themes.disabled.length + ')' );
1983 } else {
1984 $views.find( '.disabled' ).remove();
1985 }
1986 }
1987
1988 if ( -1 !== _.indexOf( themes['auto-update-enabled'], response.slug ) ) {
1989 themes['auto-update-enabled'] = _.without( themes['auto-update-enabled'], response.slug );
1990 if ( themes['auto-update-enabled'].length ) {
1991 $views.find( '.auto-update-enabled .count' ).text( '(' + themes['auto-update-enabled'].length + ')' );
1992 } else {
1993 $views.find( '.auto-update-enabled' ).remove();
1994 }
1995 }
1996
1997 if ( -1 !== _.indexOf( themes['auto-update-disabled'], response.slug ) ) {
1998 themes['auto-update-disabled'] = _.without( themes['auto-update-disabled'], response.slug );
1999 if ( themes['auto-update-disabled'].length ) {
2000 $views.find( '.auto-update-disabled .count' ).text( '(' + themes['auto-update-disabled'].length + ')' );
2001 } else {
2002 $views.find( '.auto-update-disabled' ).remove();
2003 }
2004 }
2005
2006 themes.all = _.without( themes.all, response.slug );
2007
2008 // There is always at least one theme available.
2009 $views.find( '.all .count' ).text( '(' + themes.all.length + ')' );
2010 } );
2011 }
2012
2013 // DecrementCount from update count.
2014 if ( 'themes' === pagenow ) {
2015 var theme = _.find( _wpThemeSettings.themes, { id: response.slug } );
2016 if ( theme.hasUpdate ) {
2017 wp.updates.decrementCount( 'theme' );
2018 }
2019 }
2020
2021 wp.a11y.speak( _x( 'Deleted!', 'theme' ) );
2022
2023 $document.trigger( 'wp-theme-delete-success', response );
2024 };
2025
2026 /**
2027 * Updates the UI appropriately after a failed theme deletion.
2028 *
2029 * @since 4.6.0
2030 *
2031 * @param {Object} response Response from the server.
2032 * @param {string} response.slug Slug of the theme to be deleted.
2033 * @param {string} response.errorCode Error code for the error that occurred.
2034 * @param {string} response.errorMessage The error that occurred.
2035 */
2036 wp.updates.deleteThemeError = function( response ) {
2037 var $themeRow = $( 'tr.inactive[data-slug="' + response.slug + '"]' ),
2038 $button = $( '.theme-actions .delete-theme' ),
2039 updateRow = wp.template( 'item-update-row' ),
2040 $updateRow = $themeRow.siblings( '#' + response.slug + '-update' ),
2041 errorMessage = sprintf(
2042 /* translators: %s: Error string for a failed deletion. */
2043 __( 'Deletion failed: %s' ),
2044 response.errorMessage
2045 ),
2046 $message = wp.updates.adminNotice( {
2047 className: 'update-message notice-error notice-alt',
2048 message: errorMessage
2049 } );
2050
2051 if ( wp.updates.maybeHandleCredentialError( response, 'delete-theme' ) ) {
2052 return;
2053 }
2054
2055 if ( 'themes-network' === pagenow ) {
2056 if ( ! $updateRow.length ) {
2057 $themeRow.addClass( 'update' ).after(
2058 updateRow( {
2059 slug: response.slug,
2060 colspan: $( '#bulk-action-form' ).find( 'thead th:not(.hidden), thead td' ).length,
2061 content: $message
2062 } )
2063 );
2064 } else {
2065 // Remove previous error messages, if any.
2066 $updateRow.find( '.notice-error' ).remove();
2067 $updateRow.find( '.plugin-update' ).append( $message );
2068 }
2069 } else {
2070 $( '.theme-info .theme-description' ).before( $message );
2071 }
2072
2073 $button.html( $button.data( 'originaltext' ) );
2074
2075 wp.a11y.speak( errorMessage, 'assertive' );
2076
2077 $document.trigger( 'wp-theme-delete-error', response );
2078 };
2079
2080 /**
2081 * Adds the appropriate callback based on the type of action and the current page.
2082 *
2083 * @since 4.6.0
2084 * @private
2085 *
2086 * @param {Object} data Ajax payload.
2087 * @param {string} action The type of request to perform.
2088 * @return {Object} The Ajax payload with the appropriate callbacks.
2089 */
2090 wp.updates._addCallbacks = function( data, action ) {
2091 if ( 'import' === pagenow && 'install-plugin' === action ) {
2092 data.success = wp.updates.installImporterSuccess;
2093 data.error = wp.updates.installImporterError;
2094 }
2095
2096 return data;
2097 };
2098
2099 /**
2100 * Pulls available jobs from the queue and runs them.
2101 *
2102 * @since 4.2.0
2103 * @since 4.6.0 Can handle multiple job types.
2104 */
2105 wp.updates.queueChecker = function() {
2106 var job;
2107
2108 if ( wp.updates.ajaxLocked || ! wp.updates.queue.length ) {
2109 return;
2110 }
2111
2112 job = wp.updates.queue.shift();
2113
2114 // Handle a queue job.
2115 switch ( job.action ) {
2116 case 'install-plugin':
2117 wp.updates.installPlugin( job.data );
2118 break;
2119
2120 case 'update-plugin':
2121 wp.updates.updatePlugin( job.data );
2122 break;
2123
2124 case 'delete-plugin':
2125 wp.updates.deletePlugin( job.data );
2126 break;
2127
2128 case 'install-theme':
2129 wp.updates.installTheme( job.data );
2130 break;
2131
2132 case 'update-theme':
2133 wp.updates.updateTheme( job.data );
2134 break;
2135
2136 case 'delete-theme':
2137 wp.updates.deleteTheme( job.data );
2138 break;
2139
2140 default:
2141 break;
2142 }
2143 };
2144
2145 /**
2146 * Requests the users filesystem credentials if they aren't already known.
2147 *
2148 * @since 4.2.0
2149 *
2150 * @param {Event=} event Optional. Event interface.
2151 */
2152 wp.updates.requestFilesystemCredentials = function( event ) {
2153 if ( false === wp.updates.filesystemCredentials.available ) {
2154 /*
2155 * After exiting the credentials request modal,
2156 * return the focus to the element triggering the request.
2157 */
2158 if ( event && ! wp.updates.$elToReturnFocusToFromCredentialsModal ) {
2159 wp.updates.$elToReturnFocusToFromCredentialsModal = $( event.target );
2160 }
2161
2162 wp.updates.ajaxLocked = true;
2163 wp.updates.requestForCredentialsModalOpen();
2164 }
2165 };
2166
2167 /**
2168 * Requests the users filesystem credentials if needed and there is no lock.
2169 *
2170 * @since 4.6.0
2171 *
2172 * @param {Event=} event Optional. Event interface.
2173 */
2174 wp.updates.maybeRequestFilesystemCredentials = function( event ) {
2175 if ( wp.updates.shouldRequestFilesystemCredentials && ! wp.updates.ajaxLocked ) {
2176 wp.updates.requestFilesystemCredentials( event );
2177 }
2178 };
2179
2180 /**
2181 * Keydown handler for the request for credentials modal.
2182 *
2183 * Closes the modal when the escape key is pressed and
2184 * constrains keyboard navigation to inside the modal.
2185 *
2186 * @since 4.2.0
2187 *
2188 * @param {Event} event Event interface.
2189 */
2190 wp.updates.keydown = function( event ) {
2191 if ( 27 === event.keyCode ) {
2192 wp.updates.requestForCredentialsModalCancel();
2193 } else if ( 9 === event.keyCode ) {
2194
2195 // #upgrade button must always be the last focus-able element in the dialog.
2196 if ( 'upgrade' === event.target.id && ! event.shiftKey ) {
2197 $( '#hostname' ).trigger( 'focus' );
2198
2199 event.preventDefault();
2200 } else if ( 'hostname' === event.target.id && event.shiftKey ) {
2201 $( '#upgrade' ).trigger( 'focus' );
2202
2203 event.preventDefault();
2204 }
2205 }
2206 };
2207
2208 /**
2209 * Opens the request for credentials modal.
2210 *
2211 * @since 4.2.0
2212 */
2213 wp.updates.requestForCredentialsModalOpen = function() {
2214 var $modal = $( '#request-filesystem-credentials-dialog' );
2215
2216 $( 'body' ).addClass( 'modal-open' );
2217 $modal.show();
2218 $modal.find( 'input:enabled:first' ).trigger( 'focus' );
2219 $modal.on( 'keydown', wp.updates.keydown );
2220 };
2221
2222 /**
2223 * Closes the request for credentials modal.
2224 *
2225 * @since 4.2.0
2226 */
2227 wp.updates.requestForCredentialsModalClose = function() {
2228 $( '#request-filesystem-credentials-dialog' ).hide();
2229 $( 'body' ).removeClass( 'modal-open' );
2230
2231 if ( wp.updates.$elToReturnFocusToFromCredentialsModal ) {
2232 wp.updates.$elToReturnFocusToFromCredentialsModal.trigger( 'focus' );
2233 }
2234 };
2235
2236 /**
2237 * Takes care of the steps that need to happen when the modal is canceled out.
2238 *
2239 * @since 4.2.0
2240 * @since 4.6.0 Triggers an event for callbacks to listen to and add their actions.
2241 */
2242 wp.updates.requestForCredentialsModalCancel = function() {
2243
2244 // Not ajaxLocked and no queue means we already have cleared things up.
2245 if ( ! wp.updates.ajaxLocked && ! wp.updates.queue.length ) {
2246 return;
2247 }
2248
2249 _.each( wp.updates.queue, function( job ) {
2250 $document.trigger( 'credential-modal-cancel', job );
2251 } );
2252
2253 // Remove the lock, and clear the queue.
2254 wp.updates.ajaxLocked = false;
2255 wp.updates.queue = [];
2256
2257 wp.updates.requestForCredentialsModalClose();
2258 };
2259
2260 /**
2261 * Displays an error message in the request for credentials form.
2262 *
2263 * @since 4.2.0
2264 *
2265 * @param {string} message Error message.
2266 */
2267 wp.updates.showErrorInCredentialsForm = function( message ) {
2268 var $filesystemForm = $( '#request-filesystem-credentials-form' );
2269
2270 // Remove any existing error.
2271 $filesystemForm.find( '.notice' ).remove();
2272 $filesystemForm.find( '#request-filesystem-credentials-title' ).after( '<div class="notice notice-alt notice-error" role="alert"><p>' + message + '</p></div>' );
2273 };
2274
2275 /**
2276 * Handles credential errors and runs events that need to happen in that case.
2277 *
2278 * @since 4.2.0
2279 *
2280 * @param {Object} response Ajax response.
2281 * @param {string} action The type of request to perform.
2282 */
2283 wp.updates.credentialError = function( response, action ) {
2284
2285 // Restore callbacks.
2286 response = wp.updates._addCallbacks( response, action );
2287
2288 wp.updates.queue.unshift( {
2289 action: action,
2290
2291 /*
2292 * Not cool that we're depending on response for this data.
2293 * This would feel more whole in a view all tied together.
2294 */
2295 data: response
2296 } );
2297
2298 wp.updates.filesystemCredentials.available = false;
2299 wp.updates.showErrorInCredentialsForm( response.errorMessage );
2300 wp.updates.requestFilesystemCredentials();
2301 };
2302
2303 /**
2304 * Handles credentials errors if it could not connect to the filesystem.
2305 *
2306 * @since 4.6.0
2307 *
2308 * @param {Object} response Response from the server.
2309 * @param {string} response.errorCode Error code for the error that occurred.
2310 * @param {string} response.errorMessage The error that occurred.
2311 * @param {string} action The type of request to perform.
2312 * @return {boolean} Whether there is an error that needs to be handled or not.
2313 */
2314 wp.updates.maybeHandleCredentialError = function( response, action ) {
2315 if ( wp.updates.shouldRequestFilesystemCredentials && response.errorCode && 'unable_to_connect_to_filesystem' === response.errorCode ) {
2316 wp.updates.credentialError( response, action );
2317 return true;
2318 }
2319
2320 return false;
2321 };
2322
2323 /**
2324 * Validates an Ajax response to ensure it's a proper object.
2325 *
2326 * If the response deems to be invalid, an admin notice is being displayed.
2327 *
2328 * @param {(Object|string)} response Response from the server.
2329 * @param {function=} response.always Optional. Callback for when the Deferred is resolved or rejected.
2330 * @param {string=} response.statusText Optional. Status message corresponding to the status code.
2331 * @param {string=} response.responseText Optional. Request response as text.
2332 * @param {string} action Type of action the response is referring to. Can be 'delete',
2333 * 'update' or 'install'.
2334 */
2335 wp.updates.isValidResponse = function( response, action ) {
2336 var error = __( 'An error occurred during the update process. Please try again.' ),
2337 errorMessage;
2338
2339 // Make sure the response is a valid data object and not a Promise object.
2340 if ( _.isObject( response ) && ! _.isFunction( response.always ) ) {
2341 return true;
2342 }
2343
2344 if ( _.isString( response ) && '-1' === response ) {
2345 error = __( 'An error has occurred. Please reload the page and try again.' );
2346 } else if ( _.isString( response ) ) {
2347 error = response;
2348 } else if ( 'undefined' !== typeof response.readyState && 0 === response.readyState ) {
2349 error = __( 'Connection lost or the server is busy. Please try again later.' );
2350 } else if ( _.isString( response.responseText ) && '' !== response.responseText ) {
2351 error = response.responseText;
2352 } else if ( _.isString( response.statusText ) ) {
2353 error = response.statusText;
2354 }
2355
2356 switch ( action ) {
2357 case 'update':
2358 /* translators: %s: Error string for a failed update. */
2359 errorMessage = __( 'Update failed: %s' );
2360 break;
2361
2362 case 'install':
2363 /* translators: %s: Error string for a failed installation. */
2364 errorMessage = __( 'Installation failed: %s' );
2365 break;
2366
2367 case 'check-dependencies':
2368 /* translators: %s: Error string for a failed dependencies check. */
2369 errorMessage = __( 'Dependencies check failed: %s' );
2370 break;
2371
2372 case 'activate':
2373 /* translators: %s: Error string for a failed activation. */
2374 errorMessage = __( 'Activation failed: %s' );
2375 break;
2376
2377 case 'delete':
2378 /* translators: %s: Error string for a failed deletion. */
2379 errorMessage = __( 'Deletion failed: %s' );
2380 break;
2381 }
2382
2383 // Messages are escaped, remove HTML tags to make them more readable.
2384 error = error.replace( /<[\/a-z][^<>]*>/gi, '' );
2385 errorMessage = errorMessage.replace( '%s', error );
2386
2387 // Add admin notice.
2388 wp.updates.addAdminNotice( {
2389 id: 'unknown_error',
2390 className: 'notice-error is-dismissible',
2391 message: _.escape( errorMessage )
2392 } );
2393
2394 // Remove the lock, and clear the queue.
2395 wp.updates.ajaxLocked = false;
2396 wp.updates.queue = [];
2397
2398 // Change buttons of all running updates.
2399 $( '.button.updating-message' )
2400 .removeClass( 'updating-message' )
2401 .removeAttr( 'aria-label' )
2402 .prop( 'disabled', true )
2403 .text( __( 'Update failed.' ) );
2404
2405 $( '.updating-message:not(.button):not(.thickbox)' )
2406 .removeClass( 'updating-message notice-warning' )
2407 .addClass( 'notice-error' )
2408 .find( 'p' )
2409 .removeAttr( 'aria-label' )
2410 .text( errorMessage );
2411
2412 wp.a11y.speak( errorMessage, 'assertive' );
2413
2414 return false;
2415 };
2416
2417 /**
2418 * Potentially adds an AYS to a user attempting to leave the page.
2419 *
2420 * If an update is on-going and a user attempts to leave the page,
2421 * opens an "Are you sure?" alert.
2422 *
2423 * @since 4.2.0
2424 */
2425 wp.updates.beforeunload = function() {
2426 if ( wp.updates.ajaxLocked ) {
2427 return __( 'Updates may not complete if you navigate away from this page.' );
2428 }
2429 };
2430
2431 $( function() {
2432 var $pluginFilter = $( '#plugin-filter, #plugin-information-footer' ),
2433 $bulkActionForm = $( '#bulk-action-form' ),
2434 $filesystemForm = $( '#request-filesystem-credentials-form' ),
2435 $filesystemModal = $( '#request-filesystem-credentials-dialog' ),
2436 $pluginSearch = $( '.plugins-php .wp-filter-search' ),
2437 $pluginInstallSearch = $( '.plugin-install-php .wp-filter-search' );
2438
2439 settings = _.extend( settings, window._wpUpdatesItemCounts || {} );
2440
2441 if ( settings.totals ) {
2442 wp.updates.refreshCount();
2443 }
2444
2445 /*
2446 * Whether a user needs to submit filesystem credentials.
2447 *
2448 * This is based on whether the form was output on the page server-side.
2449 *
2450 * @see {wp_print_request_filesystem_credentials_modal() in PHP}
2451 */
2452 wp.updates.shouldRequestFilesystemCredentials = $filesystemModal.length > 0;
2453
2454 /**
2455 * File system credentials form submit noop-er / handler.
2456 *
2457 * @since 4.2.0
2458 */
2459 $filesystemModal.on( 'submit', 'form', function( event ) {
2460 event.preventDefault();
2461
2462 // Persist the credentials input by the user for the duration of the page load.
2463 wp.updates.filesystemCredentials.ftp.hostname = $( '#hostname' ).val();
2464 wp.updates.filesystemCredentials.ftp.username = $( '#username' ).val();
2465 wp.updates.filesystemCredentials.ftp.password = $( '#password' ).val();
2466 wp.updates.filesystemCredentials.ftp.connectionType = $( 'input[name="connection_type"]:checked' ).val();
2467 wp.updates.filesystemCredentials.ssh.publicKey = $( '#public_key' ).val();
2468 wp.updates.filesystemCredentials.ssh.privateKey = $( '#private_key' ).val();
2469 wp.updates.filesystemCredentials.fsNonce = $( '#_fs_nonce' ).val();
2470 wp.updates.filesystemCredentials.available = true;
2471
2472 // Unlock and invoke the queue.
2473 wp.updates.ajaxLocked = false;
2474 wp.updates.queueChecker();
2475
2476 wp.updates.requestForCredentialsModalClose();
2477 } );
2478
2479 /**
2480 * Closes the request credentials modal when clicking the 'Cancel' button or outside of the modal.
2481 *
2482 * @since 4.2.0
2483 */
2484 $filesystemModal.on( 'click', '[data-js-action="close"], .notification-dialog-background', wp.updates.requestForCredentialsModalCancel );
2485
2486 /**
2487 * Hide SSH fields when not selected.
2488 *
2489 * @since 4.2.0
2490 */
2491 $filesystemForm.on( 'change', 'input[name="connection_type"]', function() {
2492 $( '#ssh-keys' ).toggleClass( 'hidden', ( 'ssh' !== $( this ).val() ) );
2493 } ).trigger( 'change' );
2494
2495 /**
2496 * Handles events after the credential modal was closed.
2497 *
2498 * @since 4.6.0
2499 *
2500 * @param {Event} event Event interface.
2501 * @param {string} job The install/update.delete request.
2502 */
2503 $document.on( 'credential-modal-cancel', function( event, job ) {
2504 var $updatingMessage = $( '.updating-message' ),
2505 $message, originalText;
2506
2507 if ( 'import' === pagenow ) {
2508 $updatingMessage.removeClass( 'updating-message' );
2509 } else if ( 'plugins' === pagenow || 'plugins-network' === pagenow ) {
2510 if ( 'update-plugin' === job.action ) {
2511 $message = $( 'tr[data-plugin="' + job.data.plugin + '"]' ).find( '.update-message' );
2512 } else if ( 'delete-plugin' === job.action ) {
2513 $message = $( '[data-plugin="' + job.data.plugin + '"]' ).find( '.row-actions a.delete' );
2514 }
2515 } else if ( 'themes' === pagenow || 'themes-network' === pagenow ) {
2516 if ( 'update-theme' === job.action ) {
2517 $message = $( '[data-slug="' + job.data.slug + '"]' ).find( '.update-message' );
2518 } else if ( 'delete-theme' === job.action && 'themes-network' === pagenow ) {
2519 $message = $( '[data-slug="' + job.data.slug + '"]' ).find( '.row-actions a.delete' );
2520 } else if ( 'delete-theme' === job.action && 'themes' === pagenow ) {
2521 $message = $( '.theme-actions .delete-theme' );
2522 }
2523 } else {
2524 $message = $updatingMessage;
2525 }
2526
2527 if ( $message && $message.hasClass( 'updating-message' ) ) {
2528 originalText = $message.data( 'originaltext' );
2529
2530 if ( 'undefined' === typeof originalText ) {
2531 originalText = $( '<p>' ).html( $message.find( 'p' ).data( 'originaltext' ) );
2532 }
2533
2534 $message
2535 .removeClass( 'updating-message' )
2536 .html( originalText );
2537
2538 if ( 'plugin-install' === pagenow || 'plugin-install-network' === pagenow ) {
2539 if ( 'update-plugin' === job.action ) {
2540 $message.attr(
2541 'aria-label',
2542 sprintf(
2543 /* translators: %s: Plugin name and version. */
2544 _x( 'Update %s now', 'plugin' ),
2545 $message.data( 'name' )
2546 )
2547 );
2548 } else if ( 'install-plugin' === job.action ) {
2549 $message.attr(
2550 'aria-label',
2551 sprintf(
2552 /* translators: %s: Plugin name. */
2553 _x( 'Install %s now', 'plugin' ),
2554 $message.data( 'name' )
2555 )
2556 );
2557 }
2558 }
2559 }
2560
2561 wp.a11y.speak( __( 'Update canceled.' ) );
2562 } );
2563
2564 /**
2565 * Click handler for plugin updates in List Table view.
2566 *
2567 * @since 4.2.0
2568 *
2569 * @param {Event} event Event interface.
2570 */
2571 $bulkActionForm.on( 'click', '[data-plugin] .update-link', function( event ) {
2572 var $message = $( event.target ),
2573 $pluginRow = $message.parents( 'tr' );
2574
2575 event.preventDefault();
2576
2577 if ( $message.hasClass( 'updating-message' ) || $message.hasClass( 'button-disabled' ) ) {
2578 return;
2579 }
2580
2581 wp.updates.maybeRequestFilesystemCredentials( event );
2582
2583 // Return the user to the input box of the plugin's table row after closing the modal.
2584 wp.updates.$elToReturnFocusToFromCredentialsModal = $pluginRow.find( '.check-column input' );
2585 wp.updates.updatePlugin( {
2586 plugin: $pluginRow.data( 'plugin' ),
2587 slug: $pluginRow.data( 'slug' )
2588 } );
2589 } );
2590
2591 /**
2592 * Click handler for plugin updates in plugin install view.
2593 *
2594 * @since 4.2.0
2595 *
2596 * @param {Event} event Event interface.
2597 */
2598 $pluginFilter.on( 'click', '.update-now', function( event ) {
2599 var $button = $( event.target );
2600 event.preventDefault();
2601
2602 if ( $button.hasClass( 'updating-message' ) || $button.hasClass( 'button-disabled' ) ) {
2603 return;
2604 }
2605
2606 wp.updates.maybeRequestFilesystemCredentials( event );
2607
2608 wp.updates.updatePlugin( {
2609 plugin: $button.data( 'plugin' ),
2610 slug: $button.data( 'slug' )
2611 } );
2612 } );
2613
2614 /**
2615 * Click handler for plugin installs in plugin install view.
2616 *
2617 * @since 4.6.0
2618 *
2619 * @param {Event} event Event interface.
2620 */
2621 $pluginFilter.on( 'click', '.install-now', function( event ) {
2622 var $button = $( event.target );
2623 event.preventDefault();
2624
2625 if ( $button.hasClass( 'updating-message' ) || $button.hasClass( 'button-disabled' ) ) {
2626 return;
2627 }
2628
2629 if ( wp.updates.shouldRequestFilesystemCredentials && ! wp.updates.ajaxLocked ) {
2630 wp.updates.requestFilesystemCredentials( event );
2631
2632 $document.on( 'credential-modal-cancel', function() {
2633 var $message = $( '.install-now.updating-message' );
2634
2635 $message
2636 .removeClass( 'updating-message' )
2637 .text( _x( 'Install Now', 'plugin' ) );
2638
2639 wp.a11y.speak( __( 'Update canceled.' ) );
2640 } );
2641 }
2642
2643 wp.updates.installPlugin( {
2644 slug: $button.data( 'slug' )
2645 } );
2646 } );
2647
2648 /**
2649 * Click handler for plugin activations in plugin activation modal view.
2650 *
2651 * @since 6.5.0
2652 * @since 6.5.4 Redirect the parent window to the activation URL.
2653 *
2654 * @param {Event} event Event interface.
2655 */
2656 $document.on( 'click', '#plugin-information-footer .activate-now', function( event ) {
2657 event.preventDefault();
2658 window.parent.location.href = $( event.target ).attr( 'href' );
2659 });
2660
2661 /**
2662 * Click handler for importer plugins installs in the Import screen.
2663 *
2664 * @since 4.6.0
2665 *
2666 * @param {Event} event Event interface.
2667 */
2668 $document.on( 'click', '.importer-item .install-now', function( event ) {
2669 var $button = $( event.target ),
2670 pluginName = $( this ).data( 'name' );
2671
2672 event.preventDefault();
2673
2674 if ( $button.hasClass( 'updating-message' ) ) {
2675 return;
2676 }
2677
2678 if ( wp.updates.shouldRequestFilesystemCredentials && ! wp.updates.ajaxLocked ) {
2679 wp.updates.requestFilesystemCredentials( event );
2680
2681 $document.on( 'credential-modal-cancel', function() {
2682
2683 $button
2684 .removeClass( 'updating-message' )
2685 .attr(
2686 'aria-label',
2687 sprintf(
2688 /* translators: %s: Plugin name. */
2689 _x( 'Install %s now', 'plugin' ),
2690 pluginName
2691 )
2692 )
2693 .text( _x( 'Install Now', 'plugin' ) );
2694
2695 wp.a11y.speak( __( 'Update canceled.' ) );
2696 } );
2697 }
2698
2699 wp.updates.installPlugin( {
2700 slug: $button.data( 'slug' ),
2701 pagenow: pagenow,
2702 success: wp.updates.installImporterSuccess,
2703 error: wp.updates.installImporterError
2704 } );
2705 } );
2706
2707 /**
2708 * Click handler for plugin deletions.
2709 *
2710 * @since 4.6.0
2711 *
2712 * @param {Event} event Event interface.
2713 */
2714 $bulkActionForm.on( 'click', '[data-plugin] a.delete', function( event ) {
2715 var $pluginRow = $( event.target ).parents( 'tr' ),
2716 confirmMessage;
2717
2718 if ( $pluginRow.hasClass( 'is-uninstallable' ) ) {
2719 confirmMessage = sprintf(
2720 /* translators: %s: Plugin name. */
2721 __( 'Are you sure you want to delete %s and its data?' ),
2722 $pluginRow.find( '.plugin-title strong' ).text()
2723 );
2724 } else {
2725 confirmMessage = sprintf(
2726 /* translators: %s: Plugin name. */
2727 __( 'Are you sure you want to delete %s?' ),
2728 $pluginRow.find( '.plugin-title strong' ).text()
2729 );
2730 }
2731
2732 event.preventDefault();
2733
2734 if ( ! window.confirm( confirmMessage ) ) {
2735 return;
2736 }
2737
2738 wp.updates.maybeRequestFilesystemCredentials( event );
2739
2740 wp.updates.deletePlugin( {
2741 plugin: $pluginRow.data( 'plugin' ),
2742 slug: $pluginRow.data( 'slug' )
2743 } );
2744
2745 } );
2746
2747 /**
2748 * Click handler for theme updates.
2749 *
2750 * @since 4.6.0
2751 *
2752 * @param {Event} event Event interface.
2753 */
2754 $document.on( 'click', '.themes-php.network-admin .update-link', function( event ) {
2755 var $message = $( event.target ),
2756 $themeRow = $message.parents( 'tr' );
2757
2758 event.preventDefault();
2759
2760 if ( $message.hasClass( 'updating-message' ) || $message.hasClass( 'button-disabled' ) ) {
2761 return;
2762 }
2763
2764 wp.updates.maybeRequestFilesystemCredentials( event );
2765
2766 // Return the user to the input box of the theme's table row after closing the modal.
2767 wp.updates.$elToReturnFocusToFromCredentialsModal = $themeRow.find( '.check-column input' );
2768 wp.updates.updateTheme( {
2769 slug: $themeRow.data( 'slug' )
2770 } );
2771 } );
2772
2773 /**
2774 * Click handler for theme deletions.
2775 *
2776 * @since 4.6.0
2777 *
2778 * @param {Event} event Event interface.
2779 */
2780 $document.on( 'click', '.themes-php.network-admin a.delete', function( event ) {
2781 var $themeRow = $( event.target ).parents( 'tr' ),
2782 confirmMessage = sprintf(
2783 /* translators: %s: Theme name. */
2784 __( 'Are you sure you want to delete %s?' ),
2785 $themeRow.find( '.theme-title strong' ).text()
2786 );
2787
2788 event.preventDefault();
2789
2790 if ( ! window.confirm( confirmMessage ) ) {
2791 return;
2792 }
2793
2794 wp.updates.maybeRequestFilesystemCredentials( event );
2795
2796 wp.updates.deleteTheme( {
2797 slug: $themeRow.data( 'slug' )
2798 } );
2799 } );
2800
2801 /**
2802 * Bulk action handler for plugins and themes.
2803 *
2804 * Handles both deletions and updates.
2805 *
2806 * @since 4.6.0
2807 *
2808 * @param {Event} event Event interface.
2809 */
2810 $bulkActionForm.on( 'click', '[type="submit"]:not([name="clear-recent-list"])', function( event ) {
2811 var bulkAction = $( event.target ).siblings( 'select' ).val(),
2812 itemsSelected = $bulkActionForm.find( 'input[name="checked[]"]:checked' ),
2813 success = 0,
2814 error = 0,
2815 errorMessages = [],
2816 type, action;
2817
2818 // Determine which type of item we're dealing with.
2819 switch ( pagenow ) {
2820 case 'plugins':
2821 case 'plugins-network':
2822 type = 'plugin';
2823 break;
2824
2825 case 'themes-network':
2826 type = 'theme';
2827 break;
2828
2829 default:
2830 return;
2831 }
2832
2833 // Bail if there were no items selected.
2834 if ( ! itemsSelected.length ) {
2835 bulkAction = false;
2836 }
2837
2838 // Determine the type of request we're dealing with.
2839 switch ( bulkAction ) {
2840 case 'update-selected':
2841 action = bulkAction.replace( 'selected', type );
2842 break;
2843
2844 case 'delete-selected':
2845 var confirmMessage = 'plugin' === type ?
2846 __( 'Are you sure you want to delete the selected plugins and their data?' ) :
2847 __( 'Caution: These themes may be active on other sites in the network. Are you sure you want to proceed?' );
2848
2849 if ( ! window.confirm( confirmMessage ) ) {
2850 event.preventDefault();
2851 return;
2852 }
2853
2854 action = bulkAction.replace( 'selected', type );
2855 break;
2856
2857 default:
2858 return;
2859 }
2860
2861 wp.updates.maybeRequestFilesystemCredentials( event );
2862
2863 event.preventDefault();
2864
2865 // Un-check the bulk checkboxes.
2866 $bulkActionForm.find( '.manage-column [type="checkbox"]' ).prop( 'checked', false );
2867
2868 $document.trigger( 'wp-' + type + '-bulk-' + bulkAction, itemsSelected );
2869
2870 // Find all the checkboxes which have been checked.
2871 itemsSelected.each( function( index, element ) {
2872 var $checkbox = $( element ),
2873 $itemRow = $checkbox.parents( 'tr' );
2874
2875 // Only add update-able items to the update queue.
2876 if ( 'update-selected' === bulkAction && ( ! $itemRow.hasClass( 'update' ) || $itemRow.find( 'notice-error' ).length ) ) {
2877
2878 // Un-check the box.
2879 $checkbox.prop( 'checked', false );
2880 return;
2881 }
2882
2883 // Don't add items to the update queue again, even if the user clicks the update button several times.
2884 if ( 'update-selected' === bulkAction && $itemRow.hasClass( 'is-enqueued' ) ) {
2885 return;
2886 }
2887
2888 $itemRow.addClass( 'is-enqueued' );
2889
2890 // Add it to the queue.
2891 wp.updates.queue.push( {
2892 action: action,
2893 data: {
2894 plugin: $itemRow.data( 'plugin' ),
2895 slug: $itemRow.data( 'slug' )
2896 }
2897 } );
2898 } );
2899
2900 // Display bulk notification for updates of any kind.
2901 $document.on( 'wp-plugin-update-success wp-plugin-update-error wp-theme-update-success wp-theme-update-error', function( event, response ) {
2902 var $itemRow = $( '[data-slug="' + response.slug + '"]' ),
2903 $bulkActionNotice, itemName;
2904
2905 if ( 'wp-' + response.update + '-update-success' === event.type ) {
2906 success++;
2907 } else {
2908 itemName = response.pluginName ? response.pluginName : $itemRow.find( '.column-primary strong' ).text();
2909
2910 error++;
2911 errorMessages.push( itemName + ': ' + response.errorMessage );
2912 }
2913
2914 $itemRow.find( 'input[name="checked[]"]:checked' ).prop( 'checked', false );
2915
2916 wp.updates.adminNotice = wp.template( 'wp-bulk-updates-admin-notice' );
2917
2918 var successMessage = null;
2919
2920 if ( success ) {
2921 if ( 'plugin' === response.update ) {
2922 successMessage = sprintf(
2923 /* translators: %s: Number of plugins. */
2924 _n( '%s plugin successfully updated.', '%s plugins successfully updated.', success ),
2925 success
2926 );
2927 } else {
2928 successMessage = sprintf(
2929 /* translators: %s: Number of themes. */
2930 _n( '%s theme successfully updated.', '%s themes successfully updated.', success ),
2931 success
2932 );
2933 }
2934 }
2935
2936 var errorMessage = null;
2937
2938 if ( error ) {
2939 errorMessage = sprintf(
2940 /* translators: %s: Number of failed updates. */
2941 _n( '%s update failed.', '%s updates failed.', error ),
2942 error
2943 );
2944 }
2945
2946 wp.updates.addAdminNotice( {
2947 id: 'bulk-action-notice',
2948 className: 'bulk-action-notice',
2949 successMessage: successMessage,
2950 errorMessage: errorMessage,
2951 errorMessages: errorMessages,
2952 type: response.update
2953 } );
2954
2955 $bulkActionNotice = $( '#bulk-action-notice' ).on( 'click', 'button', function() {
2956 // $( this ) is the clicked button, no need to get it again.
2957 $( this )
2958 .toggleClass( 'bulk-action-errors-collapsed' )
2959 .attr( 'aria-expanded', ! $( this ).hasClass( 'bulk-action-errors-collapsed' ) );
2960 // Show the errors list.
2961 $bulkActionNotice.find( '.bulk-action-errors' ).toggleClass( 'hidden' );
2962 } );
2963
2964 if ( error > 0 && ! wp.updates.queue.length ) {
2965 $( 'html, body' ).animate( { scrollTop: 0 } );
2966 }
2967 } );
2968
2969 // Reset admin notice template after #bulk-action-notice was added.
2970 $document.on( 'wp-updates-notice-added', function() {
2971 wp.updates.adminNotice = wp.template( 'wp-updates-admin-notice' );
2972 } );
2973
2974 // Check the queue, now that the event handlers have been added.
2975 wp.updates.queueChecker();
2976 } );
2977
2978 if ( $pluginInstallSearch.length ) {
2979 $pluginInstallSearch.attr( 'aria-describedby', 'live-search-desc' );
2980 }
2981
2982 // Track the previous search string length.
2983 var previousSearchStringLength = 0;
2984 wp.updates.shouldSearch = function( searchStringLength ) {
2985 var shouldSearch = searchStringLength >= wp.updates.searchMinCharacters ||
2986 previousSearchStringLength > wp.updates.searchMinCharacters;
2987 previousSearchStringLength = searchStringLength;
2988 return shouldSearch;
2989 };
2990
2991 /**
2992 * Handles changes to the plugin search box on the new-plugin page,
2993 * searching the repository dynamically.
2994 *
2995 * @since 4.6.0
2996 */
2997 $pluginInstallSearch.on( 'keyup input', _.debounce( function( event, eventtype ) {
2998 var $searchTab = $( '.plugin-install-search' ), data, searchLocation,
2999 searchStringLength = $pluginInstallSearch.val().length;
3000
3001 data = {
3002 _ajax_nonce: wp.updates.ajaxNonce,
3003 s: encodeURIComponent( event.target.value ),
3004 tab: 'search',
3005 type: $( '#typeselector' ).val(),
3006 pagenow: pagenow
3007 };
3008 searchLocation = location.href.split( '?' )[ 0 ] + '?' + $.param( _.omit( data, [ '_ajax_nonce', 'pagenow' ] ) );
3009
3010 // Set the autocomplete attribute, turning off autocomplete 1 character before ajax search kicks in.
3011 if ( wp.updates.shouldSearch( searchStringLength ) ) {
3012 $pluginInstallSearch.attr( 'autocomplete', 'off' );
3013 } else {
3014 $pluginInstallSearch.attr( 'autocomplete', 'on' );
3015 return;
3016 }
3017
3018 // Clear on escape.
3019 if ( 'keyup' === event.type && 27 === event.which ) {
3020 event.target.value = '';
3021 }
3022
3023 if ( wp.updates.searchTerm === data.s && 'typechange' !== eventtype ) {
3024 return;
3025 } else {
3026 $pluginFilter.empty();
3027 wp.updates.searchTerm = data.s;
3028 }
3029
3030 if ( window.history && window.history.replaceState ) {
3031 window.history.replaceState( null, '', searchLocation );
3032 }
3033
3034 if ( ! $searchTab.length ) {
3035 $searchTab = $( '<li class="plugin-install-search" />' )
3036 .append( $( '<a />', {
3037 'class': 'current',
3038 'href': searchLocation,
3039 'text': __( 'Search Results' )
3040 } ) );
3041
3042 $( '.wp-filter .filter-links .current' )
3043 .removeClass( 'current' )
3044 .parents( '.filter-links' )
3045 .prepend( $searchTab );
3046
3047 $pluginFilter.prev( 'p' ).remove();
3048 $( '.plugins-popular-tags-wrapper' ).remove();
3049 }
3050
3051 if ( 'undefined' !== typeof wp.updates.searchRequest ) {
3052 wp.updates.searchRequest.abort();
3053 }
3054 $( 'body' ).addClass( 'loading-content' );
3055
3056 wp.updates.searchRequest = wp.ajax.post( 'search-install-plugins', data ).done( function( response ) {
3057 $( 'body' ).removeClass( 'loading-content' );
3058 $pluginFilter.append( response.items );
3059 delete wp.updates.searchRequest;
3060
3061 if ( 0 === response.count ) {
3062 wp.a11y.speak( __( 'You do not appear to have any plugins available at this time.' ) );
3063 } else {
3064 wp.a11y.speak(
3065 sprintf(
3066 /* translators: %s: Number of plugins. */
3067 __( 'Number of plugins found: %d' ),
3068 response.count
3069 )
3070 );
3071 }
3072 } );
3073 }, 1000 ) );
3074
3075 if ( $pluginSearch.length ) {
3076 $pluginSearch.attr( 'aria-describedby', 'live-search-desc' );
3077
3078 }
3079
3080 /**
3081 * Handles changes to the plugin search box on the Installed Plugins screen,
3082 * searching the plugin list dynamically.
3083 *
3084 * @since 4.6.0
3085 */
3086 $pluginSearch.on( 'keyup input', _.debounce( function( event ) {
3087 var data = {
3088 _ajax_nonce: wp.updates.ajaxNonce,
3089 s: encodeURIComponent( event.target.value ),
3090 pagenow: pagenow,
3091 plugin_status: 'all'
3092 },
3093 queryArgs,
3094 searchStringLength = $pluginSearch.val().length;
3095
3096 // Set the autocomplete attribute, turning off autocomplete 1 character before ajax search kicks in.
3097 if ( wp.updates.shouldSearch( searchStringLength ) ) {
3098 $pluginSearch.attr( 'autocomplete', 'off' );
3099 } else {
3100 $pluginSearch.attr( 'autocomplete', 'on' );
3101 return;
3102 }
3103
3104 // Clear on escape.
3105 if ( 'keyup' === event.type && 27 === event.which ) {
3106 event.target.value = '';
3107 }
3108
3109 if ( wp.updates.searchTerm === data.s ) {
3110 return;
3111 } else {
3112 wp.updates.searchTerm = data.s;
3113 }
3114
3115 queryArgs = _.object( _.compact( _.map( location.search.slice( 1 ).split( '&' ), function( item ) {
3116 if ( item ) return item.split( '=' );
3117 } ) ) );
3118
3119 data.plugin_status = queryArgs.plugin_status || 'all';
3120
3121 if ( window.history && window.history.replaceState ) {
3122 window.history.replaceState( null, '', location.href.split( '?' )[ 0 ] + '?s=' + data.s + '&plugin_status=' + data.plugin_status );
3123 }
3124
3125 if ( 'undefined' !== typeof wp.updates.searchRequest ) {
3126 wp.updates.searchRequest.abort();
3127 }
3128
3129 $bulkActionForm.empty();
3130 $( 'body' ).addClass( 'loading-content' );
3131 $( '.subsubsub .current' ).removeClass( 'current' );
3132
3133 wp.updates.searchRequest = wp.ajax.post( 'search-plugins', data ).done( function( response ) {
3134
3135 // Can we just ditch this whole subtitle business?
3136 var $subTitle = $( '<span />' ).addClass( 'subtitle' ).html(
3137 sprintf(
3138 /* translators: %s: Search query. */
3139 __( 'Search results for: %s' ),
3140 '<strong>' + _.escape( decodeURIComponent( data.s ) ) + '</strong>'
3141 ) ),
3142 $oldSubTitle = $( '.wrap .subtitle' );
3143
3144 if ( ! data.s.length ) {
3145 $oldSubTitle.remove();
3146 $( '.subsubsub .' + data.plugin_status + ' a' ).addClass( 'current' );
3147 } else if ( $oldSubTitle.length ) {
3148 $oldSubTitle.replaceWith( $subTitle );
3149 } else {
3150 $( '.wp-header-end' ).before( $subTitle );
3151 }
3152
3153 $( 'body' ).removeClass( 'loading-content' );
3154 $bulkActionForm.append( response.items );
3155 delete wp.updates.searchRequest;
3156
3157 if ( 0 === response.count ) {
3158 wp.a11y.speak( __( 'No plugins found. Try a different search.' ) );
3159 } else {
3160 wp.a11y.speak(
3161 sprintf(
3162 /* translators: %s: Number of plugins. */
3163 __( 'Number of plugins found: %d' ),
3164 response.count
3165 )
3166 );
3167 }
3168 } );
3169 }, 500 ) );
3170
3171 /**
3172 * Trigger a search event when the search form gets submitted.
3173 *
3174 * @since 4.6.0
3175 */
3176 $document.on( 'submit', '.search-plugins', function( event ) {
3177 event.preventDefault();
3178
3179 $( 'input.wp-filter-search' ).trigger( 'input' );
3180 } );
3181
3182 /**
3183 * Trigger a search event when the "Try Again" button is clicked.
3184 *
3185 * @since 4.9.0
3186 */
3187 $document.on( 'click', '.try-again', function( event ) {
3188 event.preventDefault();
3189 $pluginInstallSearch.trigger( 'input' );
3190 } );
3191
3192 /**
3193 * Trigger a search event when the search type gets changed.
3194 *
3195 * @since 4.6.0
3196 */
3197 $( '#typeselector' ).on( 'change', function() {
3198 var $search = $( 'input[name="s"]' );
3199
3200 if ( $search.val().length ) {
3201 $search.trigger( 'input', 'typechange' );
3202 }
3203 } );
3204
3205 /**
3206 * Click handler for updating a plugin from the details modal on `plugin-install.php`.
3207 *
3208 * @since 4.2.0
3209 *
3210 * @param {Event} event Event interface.
3211 */
3212 $( '#plugin_update_from_iframe' ).on( 'click', function( event ) {
3213 var target = window.parent === window ? null : window.parent,
3214 update;
3215
3216 $.support.postMessage = !! window.postMessage;
3217
3218 if ( false === $.support.postMessage || null === target || -1 !== window.parent.location.pathname.indexOf( 'update-core.php' ) ) {
3219 return;
3220 }
3221
3222 event.preventDefault();
3223
3224 update = {
3225 action: 'update-plugin',
3226 data: {
3227 plugin: $( this ).data( 'plugin' ),
3228 slug: $( this ).data( 'slug' )
3229 }
3230 };
3231
3232 target.postMessage( JSON.stringify( update ), window.location.origin );
3233 } );
3234
3235 /**
3236 * Handles postMessage events.
3237 *
3238 * @since 4.2.0
3239 * @since 4.6.0 Switched `update-plugin` action to use the queue.
3240 *
3241 * @param {Event} event Event interface.
3242 */
3243 $( window ).on( 'message', function( event ) {
3244 var originalEvent = event.originalEvent,
3245 expectedOrigin = document.location.protocol + '//' + document.location.host,
3246 message;
3247
3248 if ( originalEvent.origin !== expectedOrigin ) {
3249 return;
3250 }
3251
3252 try {
3253 message = JSON.parse( originalEvent.data );
3254 } catch ( e ) {
3255 return;
3256 }
3257
3258 if ( ! message ) {
3259 return;
3260 }
3261
3262 if (
3263 'undefined' !== typeof message.status &&
3264 'undefined' !== typeof message.slug &&
3265 'undefined' !== typeof message.text &&
3266 'undefined' !== typeof message.ariaLabel
3267 ) {
3268 var $card = $( '.plugin-card-' + message.slug ),
3269 $message = $card.find( '[data-slug="' + message.slug + '"]' );
3270
3271 if ( 'undefined' !== typeof message.removeClasses ) {
3272 $message.removeClass( message.removeClasses );
3273 }
3274
3275 if ( 'undefined' !== typeof message.addClasses ) {
3276 $message.addClass( message.addClasses );
3277 }
3278
3279 if ( '' === message.ariaLabel ) {
3280 $message.removeAttr( 'aria-label' );
3281 } else {
3282 $message.attr( 'aria-label', message.ariaLabel );
3283 }
3284
3285 if ( 'dependencies-check-success' === message.status ) {
3286 $message
3287 .attr( 'data-name', message.pluginName )
3288 .attr( 'data-slug', message.slug )
3289 .attr( 'data-plugin', message.plugin )
3290 .attr( 'href', message.href );
3291 }
3292
3293 $message.text( message.text );
3294 }
3295
3296 if ( 'undefined' === typeof message.action ) {
3297 return;
3298 }
3299
3300 switch ( message.action ) {
3301
3302 // Called from `wp-admin/includes/class-wp-upgrader-skins.php`.
3303 case 'decrementUpdateCount':
3304 /** @property {string} message.upgradeType */
3305 wp.updates.decrementCount( message.upgradeType );
3306 break;
3307
3308 case 'install-plugin':
3309 case 'update-plugin':
3310 if ( 'undefined' === typeof message.data || 'undefined' === typeof message.data.slug ) {
3311 return;
3312 }
3313
3314 message.data = wp.updates._addCallbacks( message.data, message.action );
3315
3316 wp.updates.queue.push( message );
3317 wp.updates.queueChecker();
3318 break;
3319 }
3320 } );
3321
3322 /**
3323 * Adds a callback to display a warning before leaving the page.
3324 *
3325 * @since 4.2.0
3326 */
3327 $( window ).on( 'beforeunload', wp.updates.beforeunload );
3328
3329 /**
3330 * Prevents the page form scrolling when activating auto-updates with the Spacebar key.
3331 *
3332 * @since 5.5.0
3333 */
3334 $document.on( 'keydown', '.column-auto-updates .toggle-auto-update, .theme-overlay .toggle-auto-update', function( event ) {
3335 if ( 32 === event.which ) {
3336 event.preventDefault();
3337 }
3338 } );
3339
3340 /**
3341 * Click and keyup handler for enabling and disabling plugin and theme auto-updates.
3342 *
3343 * These controls can be either links or buttons. When JavaScript is enabled,
3344 * we want them to behave like buttons. An ARIA role `button` is added via
3345 * the JavaScript that targets elements with the CSS class `aria-button-if-js`.
3346 *
3347 * @since 5.5.0
3348 */
3349 $document.on( 'click keyup', '.column-auto-updates .toggle-auto-update, .theme-overlay .toggle-auto-update', function( event ) {
3350 var data, asset, type, $parent,
3351 $toggler = $( this ),
3352 action = $toggler.attr( 'data-wp-action' ),
3353 $label = $toggler.find( '.label' );
3354
3355 if ( 'keyup' === event.type && 32 !== event.which ) {
3356 return;
3357 }
3358
3359 if ( 'themes' !== pagenow ) {
3360 $parent = $toggler.closest( '.column-auto-updates' );
3361 } else {
3362 $parent = $toggler.closest( '.theme-autoupdate' );
3363 }
3364
3365 event.preventDefault();
3366
3367 // Prevent multiple simultaneous requests.
3368 if ( $toggler.attr( 'data-doing-ajax' ) === 'yes' ) {
3369 return;
3370 }
3371
3372 $toggler.attr( 'data-doing-ajax', 'yes' );
3373
3374 switch ( pagenow ) {
3375 case 'plugins':
3376 case 'plugins-network':
3377 type = 'plugin';
3378 asset = $toggler.closest( 'tr' ).attr( 'data-plugin' );
3379 break;
3380 case 'themes-network':
3381 type = 'theme';
3382 asset = $toggler.closest( 'tr' ).attr( 'data-slug' );
3383 break;
3384 case 'themes':
3385 type = 'theme';
3386 asset = $toggler.attr( 'data-slug' );
3387 break;
3388 }
3389
3390 // Clear any previous errors.
3391 $parent.find( '.notice.notice-error' ).addClass( 'hidden' );
3392
3393 // Show loading status.
3394 if ( 'enable' === action ) {
3395 $label.text( __( 'Enabling...' ) );
3396 } else {
3397 $label.text( __( 'Disabling...' ) );
3398 }
3399
3400 $toggler.find( '.dashicons-update' ).removeClass( 'hidden' );
3401
3402 data = {
3403 action: 'toggle-auto-updates',
3404 _ajax_nonce: settings.ajax_nonce,
3405 state: action,
3406 type: type,
3407 asset: asset
3408 };
3409
3410 $.post( window.ajaxurl, data )
3411 .done( function( response ) {
3412 var $enabled, $disabled, enabledNumber, disabledNumber, errorMessage,
3413 href = $toggler.attr( 'href' );
3414
3415 if ( ! response.success ) {
3416 // if WP returns 0 for response (which can happen in a few cases),
3417 // output the general error message since we won't have response.data.error.
3418 if ( response.data && response.data.error ) {
3419 errorMessage = response.data.error;
3420 } else {
3421 errorMessage = __( 'The request could not be completed.' );
3422 }
3423
3424 $parent.find( '.notice.notice-error' ).removeClass( 'hidden' ).find( 'p' ).text( errorMessage );
3425 wp.a11y.speak( errorMessage, 'assertive' );
3426 return;
3427 }
3428
3429 // Update the counts in the enabled/disabled views if on a screen
3430 // with a list table.
3431 if ( 'themes' !== pagenow ) {
3432 $enabled = $( '.auto-update-enabled span' );
3433 $disabled = $( '.auto-update-disabled span' );
3434 enabledNumber = parseInt( $enabled.text().replace( /[^\d]+/g, '' ), 10 ) || 0;
3435 disabledNumber = parseInt( $disabled.text().replace( /[^\d]+/g, '' ), 10 ) || 0;
3436
3437 switch ( action ) {
3438 case 'enable':
3439 ++enabledNumber;
3440 --disabledNumber;
3441 break;
3442 case 'disable':
3443 --enabledNumber;
3444 ++disabledNumber;
3445 break;
3446 }
3447
3448 enabledNumber = Math.max( 0, enabledNumber );
3449 disabledNumber = Math.max( 0, disabledNumber );
3450
3451 $enabled.text( '(' + enabledNumber + ')' );
3452 $disabled.text( '(' + disabledNumber + ')' );
3453 }
3454
3455 if ( 'enable' === action ) {
3456 // The toggler control can be either a link or a button.
3457 if ( $toggler[ 0 ].hasAttribute( 'href' ) ) {
3458 href = href.replace( 'action=enable-auto-update', 'action=disable-auto-update' );
3459 $toggler.attr( 'href', href );
3460 }
3461 $toggler.attr( 'data-wp-action', 'disable' );
3462
3463 $label.text( __( 'Disable auto-updates' ) );
3464 $parent.find( '.auto-update-time' ).removeClass( 'hidden' );
3465 wp.a11y.speak( __( 'Auto-updates enabled' ) );
3466 } else {
3467 // The toggler control can be either a link or a button.
3468 if ( $toggler[ 0 ].hasAttribute( 'href' ) ) {
3469 href = href.replace( 'action=disable-auto-update', 'action=enable-auto-update' );
3470 $toggler.attr( 'href', href );
3471 }
3472 $toggler.attr( 'data-wp-action', 'enable' );
3473
3474 $label.text( __( 'Enable auto-updates' ) );
3475 $parent.find( '.auto-update-time' ).addClass( 'hidden' );
3476 wp.a11y.speak( __( 'Auto-updates disabled' ) );
3477 }
3478
3479 $document.trigger( 'wp-auto-update-setting-changed', { state: action, type: type, asset: asset } );
3480 } )
3481 .fail( function() {
3482 $parent.find( '.notice.notice-error' )
3483 .removeClass( 'hidden' )
3484 .find( 'p' )
3485 .text( __( 'The request could not be completed.' ) );
3486
3487 wp.a11y.speak( __( 'The request could not be completed.' ), 'assertive' );
3488 } )
3489 .always( function() {
3490 $toggler.removeAttr( 'data-doing-ajax' ).find( '.dashicons-update' ).addClass( 'hidden' );
3491 } );
3492 }
3493 );
3494 } );
3495})( jQuery, window.wp, window._wpUpdatesSettings );
3496