PluginProbe
Jetpack – WP Security, Backup, Speed, & Growth / 16.3-a.5
Jetpack – WP Security, Backup, Speed, & Growth v16.3-a.5
16.3-a.5 16.3-a.7 16.3-a.3 16.3-a.1 16.2 16.2-beta 12.0.3 12.1.3 12.2.3 12.3.2 12.4.2 12.5.2 12.6.4 12.7.3 12.8.3 12.9.5 13.0.2 13.1.5 13.2.4 13.3.3 13.4.5 13.5.2 13.6.2 13.7.2 13.8.3 All 506 releases
← All changes | class.jetpack-cli.php +170 -126 12.0.3 → 16.3-a.5 View file →
@@ -9,8 +9,10 @@
9 9 use Automattic\Jetpack\Connection\Manager as Connection_Manager;
10 10 use Automattic\Jetpack\Connection\Tokens;
11 11 use Automattic\Jetpack\Identity_Crisis;
12 12 use Automattic\Jetpack\IP\Utils as IP_Utils;
13 +use Automattic\Jetpack\Publicize\Connections;
14 +use Automattic\Jetpack\Publicize\Publicize;
13 15 use Automattic\Jetpack\Status;
14 16 use Automattic\Jetpack\Sync\Actions;
15 17 use Automattic\Jetpack\Sync\Listener;
16 18 use Automattic\Jetpack\Sync\Modules;
@@ -84,9 +86,9 @@
84 86 }
85 87
86 88 $master_user_email = Jetpack::get_master_user_email();
87 89
88 - $cxntests = new Jetpack_Cxn_Tests();
90 + $cxntests = new Automattic\Jetpack\Connection\Connection_Health_Tests();
89 91
90 92 if ( $cxntests->pass() ) {
91 93 $cxntests->output_results_for_cli();
92 94
@@ -223,14 +225,15 @@
223 225 * @param array $args Positional args.
224 226 * @param array $assoc_args Named args.
225 227 */
226 228 public function disconnect( $args, $assoc_args ) {
229 + $user = null;
227 230 if ( ! Jetpack::is_connection_ready() ) {
228 231 WP_CLI::success( __( 'The site is not currently connected, so nothing to do!', 'jetpack' ) );
229 232 return;
230 233 }
231 234
232 - $action = isset( $args[0] ) ? $args[0] : 'prompt';
235 + $action = $args[0] ?? 'prompt';
233 236 if ( ! in_array( $action, array( 'blog', 'user', 'prompt' ), true ) ) {
234 237 /* translators: %s is a command like "prompt" */
235 238 WP_CLI::error( sprintf( __( '%s is not a valid command.', 'jetpack' ), $action ) );
236 239 }
@@ -322,9 +325,9 @@
322 325 * @param array $args Positional args.
323 326 * @param array $assoc_args Named args.
324 327 */
325 328 public function reset( $args, $assoc_args ) {
326 - $action = isset( $args[0] ) ? $args[0] : 'prompt';
329 + $action = $args[0] ?? 'prompt';
327 330 if ( ! in_array( $action, array( 'options', 'modules', 'sync-checksum' ), true ) ) {
328 331 /* translators: %s is a command like "prompt" */
329 332 WP_CLI::error( sprintf( __( '%s is not a valid command.', 'jetpack' ), $action ) );
330 333 }
@@ -542,9 +545,10 @@
542 545 * @param array $args Positional args.
543 546 * @param array $assoc_args Named args.
544 547 */
545 548 public function module( $args, $assoc_args ) {
546 - $action = isset( $args[0] ) ? $args[0] : 'list';
549 + $module_slug = null;
550 + $action = $args[0] ?? 'list';
547 551
548 552 if ( isset( $args[1] ) ) {
549 553 $module_slug = $args[1];
550 554 if ( 'all' !== $module_slug && ! Jetpack::is_module( $module_slug ) ) {
@@ -587,8 +591,12 @@
587 591 case 'activate':
588 592 $module = Jetpack::get_module( $module_slug );
589 593 Jetpack::log( 'activate', $module_slug );
590 594 if ( Jetpack::activate_module( $module_slug, false, false ) ) {
595 + if ( ! Jetpack::is_module_active( $module_slug ) ) {
596 + /* translators: %s is the name of a Jetpack module */
597 + WP_CLI::error( sprintf( __( '%s is disabled by your host or site administrator, so it stays off.', 'jetpack' ), $module['name'] ) );
598 + }
591 599 /* translators: %s is the name of a Jetpack module */
592 600 WP_CLI::success( sprintf( __( '%s has been activated.', 'jetpack' ), $module['name'] ) );
593 601 } else {
594 602 /* translators: %s is the name of a Jetpack module */
@@ -603,8 +611,12 @@
603 611 case 'deactivate':
604 612 $module = Jetpack::get_module( $module_slug );
605 613 Jetpack::log( 'deactivate', $module_slug );
606 614 Jetpack::deactivate_module( $module_slug );
615 + if ( Jetpack::is_module_active( $module_slug ) ) {
616 + /* translators: %s is the name of a Jetpack module */
617 + WP_CLI::error( sprintf( __( '%s is enabled by your host or site administrator, so it stays on.', 'jetpack' ), $module['name'] ) );
618 + }
607 619 /* translators: %s is the name of a Jetpack module */
608 620 WP_CLI::success( sprintf( __( '%s has been deactivated.', 'jetpack' ), $module['name'] ) );
609 621 break;
610 622 case 'deactivate_all':
@@ -635,9 +647,9 @@
635 647 *
636 648 * @param array $args Positional args.
637 649 */
638 650 public function protect( $args ) {
639 - $action = isset( $args[0] ) ? $args[0] : 'prompt';
651 + $action = $args[0] ?? 'prompt';
640 652 if ( ! in_array( $action, array( 'whitelist', 'allow' ), true ) ) { // Still allow "whitelist" for legacy support.
641 653 /* translators: %s is a command like "prompt" */
642 654 WP_CLI::error( sprintf( __( '%s is not a valid command.', 'jetpack' ), $action ) );
643 655 }
@@ -764,9 +776,9 @@
764 776 *
765 777 * @param array $args Positional args.
766 778 */
767 779 public function options( $args ) {
768 - $action = isset( $args[0] ) ? $args[0] : 'list';
780 + $action = $args[0] ?? 'list';
769 781 $safe_to_modify = Jetpack_Options::get_options_for_reset();
770 782
771 783 // Is the option flagged as unsafe?
772 784 $flagged = ! in_array( $args[1], $safe_to_modify, true );
@@ -890,9 +902,9 @@
890 902 * @param array $assoc_args Named args.
891 903 */
892 904 public function sync( $args, $assoc_args ) {
893 905
894 - $action = isset( $args[0] ) ? $args[0] : 'status';
906 + $action = $args[0] ?? 'status';
895 907
896 908 switch ( $action ) {
897 909 case 'status':
898 910 $status = Actions::get_sync_status();
@@ -899,9 +911,9 @@
899 911 $collection = array();
900 912 foreach ( $status as $key => $item ) {
901 913 $collection[] = array(
902 914 'option' => $key,
903 - 'value' => is_scalar( $item ) ? $item : wp_json_encode( $item ),
915 + 'value' => is_scalar( $item ) ? $item : wp_json_encode( $item, JSON_UNESCAPED_SLASHES ),
904 916 );
905 917 }
906 918 WP_CLI::log( __( 'Sync Status:', 'jetpack' ) );
907 919 WP_CLI\Utils\format_items( 'table', $collection, array( 'option', 'value' ) );
@@ -911,9 +923,9 @@
911 923 $settings = array();
912 924 foreach ( Settings::get_settings() as $setting => $item ) {
913 925 $settings[] = array(
914 926 'setting' => $setting,
915 - 'value' => is_scalar( $item ) ? $item : wp_json_encode( $item ),
927 + 'value' => is_scalar( $item ) ? $item : wp_json_encode( $item, JSON_UNESCAPED_SLASHES ),
916 928 );
917 929 }
918 930 WP_CLI\Utils\format_items( 'table', $settings, array( 'setting', 'value' ) );
919 931 break;
@@ -981,10 +993,10 @@
981 993 if ( $status->is_offline_mode() ) {
982 994 WP_CLI::error( __( 'Jetpack sync is not currently allowed for this site. The site is in offline mode.', 'jetpack' ) );
983 995 return;
984 996 }
985 - if ( $status->is_staging_site() ) {
986 - WP_CLI::error( __( 'Jetpack sync is not currently allowed for this site. The site is in staging mode.', 'jetpack' ) );
997 + if ( $status->in_safe_mode() ) {
998 + WP_CLI::error( __( 'Jetpack sync is not currently allowed for this site. The site is in safe mode.', 'jetpack' ) );
987 999 return;
988 1000 }
989 1001 }
990 1002 // Get the original settings so that we can restore them later.
@@ -1020,9 +1032,9 @@
1020 1032 ) {
1021 1033 $modules['users'] = 'initial';
1022 1034 } elseif ( isset( $assoc_args[ $module_name ] ) ) {
1023 1035 $ids = explode( ',', $assoc_args[ $module_name ] );
1024 - if ( count( $ids ) > 0 ) {
1036 + if ( $ids !== array() ) {
1025 1037 $modules[ $module_name ] = $ids;
1026 1038 }
1027 1039 }
1028 1040 }
@@ -1031,12 +1043,12 @@
1031 1043 $modules = null;
1032 1044 }
1033 1045
1034 1046 // Kick off a full sync.
1035 - if ( Actions::do_full_sync( $modules ) ) {
1047 + if ( Actions::do_full_sync( $modules, 'jetpack_cli' ) ) {
1036 1048 if ( $modules ) {
1037 - /* translators: %s is a comma separated list of Jetpack modules */
1038 - WP_CLI::log( sprintf( __( 'Initialized a new full sync with modules: %s', 'jetpack' ), join( ', ', array_keys( $modules ) ) ) );
1049 + /* translators: %s is a comma-separated list of Jetpack modules */
1050 + WP_CLI::log( sprintf( __( 'Initialized a new full sync with modules: %s', 'jetpack' ), implode( ', ', array_keys( $modules ) ) ) );
1039 1051 } else {
1040 1052 WP_CLI::log( __( 'Initialized a new full sync', 'jetpack' ) );
1041 1053 }
1042 1054 } else {
@@ -1044,10 +1056,10 @@
1044 1056 // Reset sync settings to original.
1045 1057 Settings::update_settings( $original_settings );
1046 1058
1047 1059 if ( $modules ) {
1048 - /* translators: %s is a comma separated list of Jetpack modules */
1049 - WP_CLI::error( sprintf( __( 'Could not start a new full sync with modules: %s', 'jetpack' ), join( ', ', $modules ) ) );
1060 + /* translators: %s is a comma-separated list of Jetpack modules */
1061 + WP_CLI::error( sprintf( __( 'Could not start a new full sync with modules: %s', 'jetpack' ), implode( ', ', $modules ) ) );
1050 1062 } else {
1051 1063 WP_CLI::error( __( 'Could not start a new full sync', 'jetpack' ) );
1052 1064 }
1053 1065 }
@@ -1069,9 +1081,9 @@
1069 1081 WP_CLI::log( __( 'Sent more data to WordPress.com', 'jetpack' ) );
1070 1082 }
1071 1083
1072 1084 // Immediate Full Sync does not wait for WP.com to process data so we need to enforce a wait.
1073 - if ( false !== strpos( get_class( Modules::get_module( 'full-sync' ) ), 'Full_Sync_Immediately' ) ) {
1085 + if ( Modules::get_module( 'full-sync' ) instanceof \Automattic\Jetpack\Sync\Modules\Full_Sync_Immediately ) {
1074 1086 sleep( 15 );
1075 1087 }
1076 1088 }
1077 1089 ++$i;
@@ -1104,10 +1116,10 @@
1104 1116 if ( ! Actions::sync_allowed() ) {
1105 1117 WP_CLI::error( __( 'Jetpack sync is not currently allowed for this site.', 'jetpack' ) );
1106 1118 }
1107 1119
1108 - $queue_name = isset( $args[0] ) ? $args[0] : 'sync';
1109 - $action = isset( $args[1] ) ? $args[1] : 'peek';
1120 + $queue_name = $args[0] ?? 'sync';
1121 + $action = $args[1] ?? 'peek';
1110 1122
1111 1123 // We map the queue name that way we can support more friendly queue names in the commands, but still use
1112 1124 // the queue name that the code expects.
1113 1125 $allowed_queues = array(
@@ -1114,9 +1126,9 @@
1114 1126 'incremental' => 'sync',
1115 1127 'full' => 'full_sync',
1116 1128 );
1117 1129 $queue_name_map = $allowed_queues;
1118 - $mapped_queue_name = isset( $queue_name_map[ $queue_name ] ) ? $queue_name_map[ $queue_name ] : $queue_name;
1130 + $mapped_queue_name = $queue_name_map[ $queue_name ] ?? $queue_name;
1119 1131
1120 1132 switch ( $action ) {
1121 1133 case 'peek':
1122 1134 $queue = new Queue( $mapped_queue_name );
@@ -1129,9 +1141,9 @@
1129 1141 $collection = array();
1130 1142 foreach ( $items as $item ) {
1131 1143 $collection[] = array(
1132 1144 'action' => $item[0],
1133 - 'args' => wp_json_encode( $item[1] ),
1145 + 'args' => wp_json_encode( $item[1], JSON_UNESCAPED_SLASHES ),
1134 1146 'current_user_id' => $item[2],
1135 1147 'microtime' => $item[3],
1136 1148 'importing' => (string) $item[4],
1137 1149 );
@@ -1187,9 +1199,9 @@
1187 1199 if ( Identity_Crisis::validate_sync_error_idc_option() ) {
1188 1200 $this->partner_provision_error(
1189 1201 new WP_Error(
1190 1202 'site_in_safe_mode',
1191 - esc_html__( 'Can not cancel a plan while in safe mode. See: https://jetpack.com/support/safe-mode/', 'jetpack' )
1203 + esc_html__( 'Cannot cancel a plan while in safe mode. See: https://jetpack.com/support/safe-mode/', 'jetpack' )
1192 1204 )
1193 1205 );
1194 1206 }
1195 1207
@@ -1213,12 +1225,11 @@
1213 1225 if ( ! empty( $named_args ) && ! empty( $named_args['partner_tracking_id'] ) ) {
1214 1226 $url = esc_url_raw( add_query_arg( 'partner_tracking_id', $named_args['partner_tracking_id'], $url ) );
1215 1227 }
1216 1228
1229 + // @phan-suppress-next-line PhanAccessMethodInternal -- Phan is correct, but the usage is intentional.
1217 1230 $result = Client::_wp_remote_request( $url, $request );
1218 1231
1219 - Jetpack_Options::delete_option( 'onboarding' );
1220 -
1221 1232 if ( is_wp_error( $result ) ) {
1222 1233 $this->partner_provision_error( $result );
1223 1234 }
1224 1235
@@ -1239,10 +1250,8 @@
1239 1250 * [--wpcom_user_id=<user_id>]
1240 1251 * : WordPress.com ID of user to connect as (must be whitelisted against partner key)
1241 1252 * [--wpcom_user_email=<wpcom_user_email>]
1242 1253 * : Override the email we send to WordPress.com for registration
1243 - * [--onboarding=<onboarding>]
1244 - * : Guide the user through an onboarding wizard
1245 1254 * [--force_register=<register>]
1246 1255 * : Whether to force a site to register
1247 1256 * [--force_connect=<force_connect>]
1248 1257 * : Force JPS to not reuse existing credentials
@@ -1257,9 +1266,9 @@
1257 1266 *
1258 1267 * $ wp jetpack partner_provision '{ some: "json" }' premium 1
1259 1268 * { success: true }
1260 1269 *
1261 - * @synopsis <token_json> [--wpcom_user_id=<user_id>] [--plan=<plan_name>] [--onboarding=<onboarding>] [--force_register=<register>] [--force_connect=<force_connect>] [--home_url=<home_url>] [--site_url=<site_url>] [--wpcom_user_email=<wpcom_user_email>] [--partner_tracking_id=<partner_tracking_id>]
1270 + * @synopsis <token_json> [--wpcom_user_id=<user_id>] [--plan=<plan_name>] [--force_register=<register>] [--force_connect=<force_connect>] [--home_url=<home_url>] [--site_url=<site_url>] [--wpcom_user_email=<wpcom_user_email>] [--partner_tracking_id=<partner_tracking_id>]
1262 1271 *
1263 1272 * @param array $args Positional args.
1264 1273 * @param array $named_args Named args.
1265 1274 */
@@ -1272,11 +1281,9 @@
1272 1281 $this->partner_provision_error( new WP_Error( 'missing_access_token', sprintf( __( 'Invalid token JSON: %s', 'jetpack' ), $token_json ) ) );
1273 1282 }
1274 1283
1275 1284 if ( isset( $token->error ) ) {
1276 - $message = isset( $token->message )
1277 - ? $token->message
1278 - : '';
1285 + $message = $token->message ?? '';
1279 1286 $this->partner_provision_error( new WP_Error( $token->error, $message ) );
1280 1287 }
1281 1288
1282 1289 if ( ! isset( $token->access_token ) ) {
@@ -1293,15 +1300,16 @@
1293 1300 array(
1294 1301 'success' => false,
1295 1302 'error_code' => $body_json->get_error_code(),
1296 1303 'error_message' => $body_json->get_error_message(),
1297 - )
1304 + ),
1305 + JSON_UNESCAPED_SLASHES
1298 1306 )
1299 1307 );
1300 1308 exit( 1 );
1301 1309 }
1302 1310
1303 - WP_CLI::log( wp_json_encode( $body_json ) );
1311 + WP_CLI::log( wp_json_encode( $body_json, JSON_UNESCAPED_SLASHES ) );
1304 1312 }
1305 1313
1306 1314 /**
1307 1315 * Manages your Jetpack sitemap
@@ -1309,23 +1317,23 @@
1309 1317 * ## OPTIONS
1310 1318 *
1311 1319 * rebuild : Rebuild all sitemaps
1312 1320 * --purge : if set, will remove all existing sitemap data before rebuilding
1321 + * --monitor : if set, will output elapsed time, peak memory usage, CPU time (user/system), and average CPU utilization
1322 + * --suspend-cache-addition : if set, will suspend cache additions during sitemap generation
1313 1323 *
1314 1324 * ## EXAMPLES
1315 1325 *
1316 1326 * wp jetpack sitemap rebuild
1327 + * wp jetpack sitemap rebuild --monitor
1317 1328 *
1318 1329 * @subcommand sitemap
1319 - * @synopsis <rebuild> [--purge]
1330 + * @synopsis <rebuild> [--purge] [--monitor] [--suspend-cache-addition]
1320 1331 *
1321 1332 * @param array $args Positional args.
1322 1333 * @param array $assoc_args Named args.
1323 1334 */
1324 1335 public function sitemap( $args, $assoc_args ) {
1325 - if ( ! Jetpack::is_connection_ready() ) {
1326 - WP_CLI::error( __( 'Jetpack is not currently connected to WordPress.com', 'jetpack' ) );
1327 - }
1328 1336 if ( ! Jetpack::is_module_active( 'sitemaps' ) ) {
1329 1337 WP_CLI::error( __( 'Jetpack Sitemaps module is not currently active. Activate it first if you want to work with sitemaps.', 'jetpack' ) );
1330 1338 }
1331 1339 if ( ! class_exists( 'Jetpack_Sitemap_Builder' ) ) {
@@ -1331,15 +1339,65 @@
1331 1339 if ( ! class_exists( 'Jetpack_Sitemap_Builder' ) ) {
1332 1340 WP_CLI::error( __( 'Jetpack Sitemaps module is active, but unavailable. This can happen if your site is set to discourage search engine indexing. Please enable search engine indexing to allow sitemap generation.', 'jetpack' ) );
1333 1341 }
1334 1342
1343 + if ( isset( $assoc_args['suspend-cache-addition'] ) && $assoc_args['suspend-cache-addition'] ) {
1344 + add_filter( 'jetpack_sitemap_suspend_cache_addition', '__return_true' );
1345 + WP_CLI::success( 'Suspending cache addition.' );
1346 + }
1347 +
1348 + $monitor = isset( $assoc_args['monitor'] ) && $assoc_args['monitor'];
1349 +
1350 + if ( $monitor ) {
1351 + $start_time = microtime( true );
1352 + $rusage_start = function_exists( 'getrusage' ) ? getrusage() : null;
1353 + }
1354 +
1335 1355 if ( isset( $assoc_args['purge'] ) && $assoc_args['purge'] ) {
1336 1356 $librarian = new Jetpack_Sitemap_Librarian();
1337 1357 $librarian->delete_all_stored_sitemap_data();
1358 +
1359 + // Clear sitemap-related transients
1360 + delete_transient( 'jetpack_news_sitemap_xml' );
1361 + delete_transient( 'jetpack-sitemap-state-lock' );
1362 + WP_CLI::success( __( 'Purged all sitemap data and cleared sitemap transients.', 'jetpack' ) );
1338 1363 }
1339 1364
1340 1365 $sitemap_builder = new Jetpack_Sitemap_Builder();
1341 1366 $sitemap_builder->update_sitemap();
1367 +
1368 + WP_CLI::success( __( 'Sitemap rebuilt successfully.', 'jetpack' ) );
1369 +
1370 + if ( $monitor && isset( $start_time ) ) {
1371 + $end_time = microtime( true );
1372 + $peak_memory = memory_get_peak_usage();
1373 + $elapsed_time = $end_time - $start_time;
1374 + $rusage_end = function_exists( 'getrusage' ) ? getrusage() : null;
1375 +
1376 + WP_CLI::log( '----------------------------------' );
1377 + WP_CLI::log( __( 'Performance Metrics:', 'jetpack' ) );
1378 + /* translators: %s is a float representing seconds */
1379 + WP_CLI::log( sprintf( __( 'Elapsed Time: %.4f seconds', 'jetpack' ), $elapsed_time ) );
1380 + /* translators: %s is a human-readable memory size (e.g., 128MB) */
1381 + WP_CLI::log( sprintf( __( 'Peak Memory Usage: %s', 'jetpack' ), size_format( $peak_memory ) ) );
1382 +
1383 + if ( ! empty( $rusage_start ) && ! empty( $rusage_end ) ) {
1384 + $user_cpu_time = ( $rusage_end['ru_utime.tv_sec'] * 1e6 + $rusage_end['ru_utime.tv_usec'] ) - ( $rusage_start['ru_utime.tv_sec'] * 1e6 + $rusage_start['ru_utime.tv_usec'] );
1385 + $system_cpu_time = ( $rusage_end['ru_stime.tv_sec'] * 1e6 + $rusage_end['ru_stime.tv_usec'] ) - ( $rusage_start['ru_stime.tv_sec'] * 1e6 + $rusage_start['ru_stime.tv_usec'] );
1386 +
1387 + /* translators: %d is an integer representing microseconds */
1388 + WP_CLI::log( sprintf( __( 'CPU time (user): %d microseconds', 'jetpack' ), $user_cpu_time ) );
1389 + /* translators: %d is an integer representing microseconds */
1390 + WP_CLI::log( sprintf( __( 'CPU time (system): %d microseconds', 'jetpack' ), $system_cpu_time ) );
1391 +
1392 + // Average CPU utilization over the elapsed wall time.
1393 + $total_cpu_sec = ( $user_cpu_time + $system_cpu_time ) / 1e6;
1394 + $avg_cpu_pct = $elapsed_time > 0 ? ( $total_cpu_sec / $elapsed_time ) * 100 : 0.0;
1395 + /* translators: %s is a percentage like 83.4 */
1396 + WP_CLI::log( sprintf( __( 'Average CPU Utilization: %.1f%%', 'jetpack' ), $avg_cpu_pct ) );
1397 + }
1398 + WP_CLI::log( '----------------------------------' );
1399 + }
1342 1400 }
1343 1401
1344 1402 /**
1345 1403 * Allows authorizing a user via the command line and will activate
@@ -1366,9 +1424,9 @@
1366 1424 $current_user_id = get_current_user_id();
1367 1425
1368 1426 ( new Tokens() )->update_user_token( $current_user_id, sprintf( '%s.%d', $named_args['token'], $current_user_id ), $is_connection_owner );
1369 1427
1370 - WP_CLI::log( wp_json_encode( $named_args ) );
1428 + WP_CLI::log( wp_json_encode( $named_args, JSON_UNESCAPED_SLASHES ) );
1371 1429
1372 1430 if ( $is_connection_owner ) {
1373 1431 /**
1374 1432 * Auto-enable SSO module for new Jetpack Start connections
@@ -1442,9 +1500,9 @@
1442 1500 $decoded_body = ! empty( $named_args['body'] )
1443 1501 ? json_decode( $named_args['body'], true )
1444 1502 : false;
1445 1503
1446 - $resource_url = ( false === strpos( $named_args['resource'], '%d' ) )
1504 + $resource_url = ( ! str_contains( $named_args['resource'], '%d' ) )
1447 1505 ? $named_args['resource']
1448 1506 : sprintf( $named_args['resource'], Jetpack_Options::get_option( 'id' ) );
1449 1507
1450 1508 $response = Client::wpcom_json_api_request_as_blog(
@@ -1481,9 +1539,9 @@
1481 1539 $output = wp_remote_retrieve_body( $response );
1482 1540 if ( isset( $named_args['pretty'] ) ) {
1483 1541 $decoded_output = json_decode( $output );
1484 1542 if ( $decoded_output ) {
1485 - $output = wp_json_encode( $decoded_output, JSON_PRETTY_PRINT );
1543 + $output = wp_json_encode( $decoded_output, JSON_UNESCAPED_SLASHES | JSON_PRETTY_PRINT );
1486 1544 }
1487 1545 }
1488 1546
1489 1547 if ( isset( $named_args['strip-success'] ) ) {
@@ -1569,9 +1627,9 @@
1569 1627 array(
1570 1628 'resource' => '/activity-log/%d/update-credentials',
1571 1629 'method' => 'POST',
1572 1630 'api_version' => '1.1',
1573 - 'body' => wp_json_encode( $values ),
1631 + 'body' => wp_json_encode( $values, JSON_UNESCAPED_SLASHES ),
1574 1632 'timeout' => 30,
1575 1633 ),
1576 1634 $named_args
1577 1635 );
@@ -1668,8 +1726,11 @@
1668 1726 *
1669 1727 * [<identifier>]
1670 1728 * : The connection ID or service to perform an action on.
1671 1729 *
1730 + * [--ignore-cache]
1731 + * : Whether to ignore connections cache.
1732 + *
1672 1733 * [--format=<format>]
1673 1734 * : Allows overriding the output of the command when listing connections.
1674 1735 * ---
1675 1736 * default: table
@@ -1686,16 +1747,19 @@
1686 1747 *
1687 1748 * # List all publicize connections.
1688 1749 * $ wp jetpack publicize list
1689 1750 *
1751 + * # List all publicize connections, ignoring the cache.
1752 + * $ wp jetpack publicize list --ignore-cache
1753 + *
1690 1754 * # List publicize connections for a given service.
1691 - * $ wp jetpack publicize list twitter
1755 + * $ wp jetpack publicize list linkedin
1692 1756 *
1693 1757 * # List all publicize connections for a given user.
1694 1758 * $ wp --user=1 jetpack publicize list
1695 1759 *
1696 1760 * # List all publicize connections for a given user and service.
1697 - * $ wp --user=1 jetpack publicize list twitter
1761 + * $ wp --user=1 jetpack publicize list linkedin
1698 1762 *
1699 1763 * # Display details for a given connection.
1700 1764 * $ wp jetpack publicize list 123456
1701 1765 *
@@ -1705,9 +1769,9 @@
1705 1769 * # Disconnect all connections.
1706 1770 * $ wp jetpack publicize disconnect all
1707 1771 *
1708 1772 * # Disconnect all connections for a given service.
1709 - * $ wp jetpack publicize disconnect twitter
1773 + * $ wp jetpack publicize disconnect linkedin
1710 1774 *
1711 1775 * @param array $args Positional args.
1712 1776 * @param array $named_args Named args.
1713 1777 */
@@ -1722,11 +1786,10 @@
1722 1786
1723 1787 if ( ( new Status() )->is_offline_mode() ) {
1724 1788 if (
1725 1789 ! defined( 'JETPACK_DEV_DEBUG' ) &&
1726 - ! has_filter( 'jetpack_development_mode' ) &&
1727 1790 ! has_filter( 'jetpack_offline_mode' ) &&
1728 - false === strpos( site_url(), '.' )
1791 + ! str_contains( site_url(), '.' )
1729 1792 ) {
1730 1793 WP_CLI::error( __( "Jetpack is current in offline mode because the site url does not contain a '.', which often occurs when dynamically setting the WP_SITEURL constant. While in offline mode, the Jetpack Social module will not load.", 'jetpack' ) );
1731 1794 }
1732 1795
@@ -1732,9 +1795,9 @@
1732 1795
1733 1796 WP_CLI::error( __( 'Jetpack is currently in offline mode, so the Jetpack Social module will not load.', 'jetpack' ) );
1734 1797 }
1735 1798
1736 - if ( ! class_exists( 'Publicize' ) ) {
1799 + if ( ! class_exists( Publicize::class ) ) {
1737 1800 WP_CLI::error( __( 'The Jetpack Social module is not loaded.', 'jetpack' ) );
1738 1801 }
1739 1802
1740 1803 $action = $args[0];
@@ -1744,30 +1807,23 @@
1744 1807 $id_is_service = in_array( $identifier, $services, true );
1745 1808
1746 1809 switch ( $action ) {
1747 1810 case 'list':
1748 - $connections_to_return = array();
1749 -
1811 + $_args = array(
1812 + 'ignore_cache' => $named_args['ignore-cache'] ?? false,
1813 + );
1750 1814 // For the CLI command, let's return all connections when a user isn't specified. This
1751 1815 // differs from the logic in the Publicize class.
1752 - $option_connections = is_user_logged_in()
1753 - ? (array) $publicize->get_all_connections_for_user()
1754 - : (array) $publicize->get_all_connections();
1816 + $connections_to_return = is_user_logged_in()
1817 + ? Connections::get_all_for_user( $_args )
1818 + : Connections::get_all( $_args );
1755 1819
1756 - foreach ( $option_connections as $service_name => $connections ) {
1757 - foreach ( (array) $connections as $id => $connection ) {
1758 - $connection['id'] = $id;
1759 - $connection['service'] = $service_name;
1760 - $connections_to_return[] = $connection;
1761 - }
1762 - }
1763 -
1764 1820 if ( $id_is_service && ! empty( $identifier ) && ! empty( $connections_to_return ) ) {
1765 1821 $temp_connections = $connections_to_return;
1766 1822 $connections_to_return = array();
1767 1823
1768 1824 foreach ( $temp_connections as $connection ) {
1769 - if ( $identifier === $connection['service'] ) {
1825 + if ( $identifier === $connection['service_name'] ) {
1770 1826 $connections_to_return[] = $connection;
1771 1827 }
1772 1828 }
1773 1829 }
@@ -1772,27 +1828,22 @@
1772 1828 }
1773 1829 }
1774 1830
1775 1831 if ( $identifier && ! $id_is_service && ! empty( $connections_to_return ) ) {
1776 - $connections_to_return = wp_list_filter( $connections_to_return, array( 'id' => $identifier ) );
1832 + $connections_to_return = wp_list_filter( $connections_to_return, array( 'connection_id' => $identifier ) );
1777 1833 }
1778 1834
1779 1835 $expected_keys = array(
1780 - 'id',
1781 - 'service',
1782 - 'user_id',
1783 - 'provider',
1784 - 'issued',
1785 - 'expires',
1836 + 'connection_id',
1837 + 'service_name',
1838 + 'display_name',
1786 1839 'external_id',
1787 - 'external_name',
1788 - 'external_display',
1789 - 'type',
1790 - 'connection_data',
1840 + 'wpcom_user_id',
1841 + 'shared',
1791 1842 );
1792 1843
1793 1844 // Somehow, a test site ended up in a state where $connections_to_return looked like:
1794 - // array( array( array( 'id' => 0, 'service' => 0 ) ) ) // phpcs:ignore Squiz.PHP.CommentedOutCode.Found
1845 + // array( array( array( 'id' => 0, 'service' => 0 ) ) )
1795 1846 // This caused the CLI command to error when running WP_CLI\Utils\format_items() below. So
1796 1847 // to minimize future issues, this nested loop will remove any connections that don't contain
1797 1848 // any keys that we expect.
1798 1849 foreach ( (array) $connections_to_return as $connection_key => $connection ) {
@@ -1826,27 +1877,19 @@
1826 1877 }
1827 1878
1828 1879 jetpack_cli_are_you_sure();
1829 1880
1830 - $connections = array();
1831 1881 $service = $identifier;
1882 + $connections = is_user_logged_in()
1883 + ? Connections::get_all_for_user()
1884 + : Connections::get_all();
1832 1885
1833 - $option_connections = is_user_logged_in()
1834 - ? (array) $publicize->get_all_connections_for_user()
1835 - : (array) $publicize->get_all_connections();
1836 -
1837 - if ( 'all' === $service ) {
1838 - foreach ( (array) $option_connections as $service_name => $service_connections ) {
1839 - foreach ( $service_connections as $id => $connection ) {
1840 - $connections[ $id ] = $connection;
1841 - }
1842 - }
1843 - } elseif ( ! empty( $option_connections[ $service ] ) ) {
1844 - $connections = $option_connections[ $service ];
1886 + if ( 'all' !== $service ) {
1887 + $connections = wp_list_filter( $connections, array( 'service_name' => $service ) );
1845 1888 }
1846 1889
1847 1890 if ( ! empty( $connections ) ) {
1848 - $count = count( $connections );
1891 + $count = is_countable( $connections ) ? count( $connections ) : 0;
1849 1892 $progress = \WP_CLI\Utils\make_progress_bar(
1850 1893 /* translators: %s is a lowercase string for a social network. */
1851 1894 sprintf( __( 'Disconnecting all connections to %s.', 'jetpack' ), $service ),
1852 1895 $count
@@ -1851,9 +1894,10 @@
1851 1894 sprintf( __( 'Disconnecting all connections to %s.', 'jetpack' ), $service ),
1852 1895 $count
1853 1896 );
1854 1897
1855 - foreach ( $connections as $id => $connection ) {
1898 + foreach ( $connections as $connection ) {
1899 + $id = $connection['connection_id'];
1856 1900 if ( false === $publicize->disconnect( false, $id ) ) {
1857 1901 WP_CLI::error(
1858 1902 sprintf(
1859 1903 /* translators: %1$d is a numeric ID and %2$s is a lowercase string for a social network. */
@@ -1862,11 +1906,13 @@
1862 1906 )
1863 1907 );
1864 1908 }
1865 1909
1910 + // @phan-suppress-next-line PhanUndeclaredClassMethod - Class is missing from php-stubs/wp-cli-stubs 🤷
1866 1911 $progress->tick();
1867 1912 }
1868 1913
1914 + // @phan-suppress-next-line PhanUndeclaredClassMethod - Class is missing from php-stubs/wp-cli-stubs 🤷
1869 1915 $progress->finish();
1870 1916
1871 1917 if ( 'all' === $service ) {
1872 1918 WP_CLI::success( __( 'All Jetpack Social connections were successfully disconnected.', 'jetpack' ) );
@@ -1871,9 +1917,9 @@
1871 1917 if ( 'all' === $service ) {
1872 1918 WP_CLI::success( __( 'All Jetpack Social connections were successfully disconnected.', 'jetpack' ) );
1873 1919 } else {
1874 1920 /* translators: %s is a lowercase string for a social network. */
1875 - WP_CLI::success( __( 'All Jetpack Social connections to %s were successfully disconnected.', 'jetpack' ), $service );
1921 + WP_CLI::success( sprintf( __( 'All Jetpack Social connections to %s were successfully disconnected.', 'jetpack' ), $service ) );
1876 1922 }
1877 1923 }
1878 1924 } elseif ( false !== $publicize->disconnect( false, $identifier ) ) {
1879 1925 /* translators: %d is a numeric ID. Example: 1234. */
@@ -1899,8 +1945,9 @@
1899 1945 /**
1900 1946 * Log and exit on a partner provision error.
1901 1947 *
1902 1948 * @param WP_Error $error Error.
1949 + * @return never
1903 1950 */
1904 1951 private function partner_provision_error( $error ) {
1905 1952 WP_CLI::log(
1906 1953 wp_json_encode(
@@ -1907,9 +1954,10 @@
1907 1954 array(
1908 1955 'success' => false,
1909 1956 'error_code' => $error->get_error_code(),
1910 1957 'error_message' => $error->get_error_message(),
1911 - )
1958 + ),
1959 + JSON_UNESCAPED_SLASHES
1912 1960 )
1913 1961 );
1914 1962 exit( 1 );
1915 1963 }
@@ -1962,19 +2010,19 @@
1962 2010 * @param array $args Positional parameters. Only one is used, that corresponds to the block title.
1963 2011 * @param array $assoc_args Associative parameters defined in the scaffold() method.
1964 2012 */
1965 2013 public function block( $args, $assoc_args ) {
1966 - if ( isset( $args[1] ) ) {
1967 - $title = ucwords( $args[1] );
1968 - } else {
2014 + if ( ! isset( $args[1] ) ) {
1969 2015 WP_CLI::error( esc_html__( 'The title parameter is required.', 'jetpack' ) . ' 👻' );
1970 2016 exit( 1 );
1971 2017 }
1972 2018
1973 - $slug = isset( $assoc_args['slug'] )
1974 - ? $assoc_args['slug']
1975 - : sanitize_title( $title );
2019 + $title = ucwords( $args[1] );
1976 2020
2021 + $slug = $assoc_args['slug'] ?? sanitize_title( $title );
2022 +
2023 + $next_version = "\x24\x24next-version$$"; // Escapes to hide the string from tools/replace-next-version-tag.sh
2024 +
1977 2025 $variation_options = array( 'production', 'experimental', 'beta' );
1978 2026 $variation = ( isset( $assoc_args['variation'] ) && in_array( $assoc_args['variation'], $variation_options, true ) )
1979 2027 ? $assoc_args['variation']
1980 2028 : 'beta';
@@ -2001,42 +2049,40 @@
2001 2049 }
2002 2050
2003 2051 $wp_filesystem->mkdir( $path );
2004 2052
2005 - $has_keywords = isset( $assoc_args['keywords'] );
2053 + $keywords = isset( $assoc_args['keywords'] )
2054 + ? array_map(
2055 + function ( $keyword ) {
2056 + return trim( $keyword );
2057 + },
2058 + array_slice( explode( ',', $assoc_args['keywords'] ), 0, 3 )
2059 + )
2060 + : array();
2006 2061
2007 2062 $files = array(
2008 - "$path/$slug.php" => $this->render_block_file(
2063 + "$path/block.json" => self::render_block_file(
2064 + 'block-block-json',
2065 + array(
2066 + 'slug' => $slug,
2067 + 'title' => wp_json_encode( $title, JSON_UNESCAPED_SLASHES | JSON_UNESCAPED_UNICODE ),
2068 + 'description' => isset( $assoc_args['description'] )
2069 + ? wp_json_encode( $assoc_args['description'], JSON_UNESCAPED_SLASHES | JSON_UNESCAPED_UNICODE )
2070 + : wp_json_encode( $title, JSON_UNESCAPED_SLASHES | JSON_UNESCAPED_UNICODE ),
2071 + 'nextVersion' => $next_version,
2072 + 'keywords' => wp_json_encode( $keywords, JSON_UNESCAPED_SLASHES | JSON_UNESCAPED_UNICODE ),
2073 + )
2074 + ),
2075 + "$path/$slug.php" => self::render_block_file(
2009 2076 'block-register-php',
2010 2077 array(
2011 - 'slug' => $slug,
2078 + 'nextVersion' => $next_version,
2012 2079 'title' => $title,
2013 - 'underscoredSlug' => str_replace( '-', '_', $slug ),
2014 2080 'underscoredTitle' => str_replace( ' ', '_', $title ),
2015 2081 )
2016 2082 ),
2017 - "$path/index.js" => $this->render_block_file(
2018 - 'block-index-js',
2019 - array(
2020 - 'slug' => $slug,
2021 - 'title' => $title,
2022 - 'description' => isset( $assoc_args['description'] )
2023 - ? $assoc_args['description']
2024 - : $title,
2025 - 'keywords' => $has_keywords
2026 - ? array_map(
2027 - function ( $keyword ) {
2028 - // Construction necessary for Mustache lists.
2029 - return array( 'keyword' => trim( $keyword ) );
2030 - },
2031 - explode( ',', $assoc_args['keywords'], 3 )
2032 - )
2033 - : '',
2034 - 'hasKeywords' => $has_keywords,
2035 - )
2036 - ),
2037 - "$path/editor.js" => $this->render_block_file( 'block-editor-js' ),
2038 - "$path/editor.scss" => $this->render_block_file(
2083 + "$path/editor.js" => self::render_block_file( 'block-editor-js' ),
2084 + "$path/editor.scss" => self::render_block_file(
2039 2085 'block-editor-scss',
2040 2086 array(
2041 2087 'slug' => $slug,
2042 2088 'title' => $title,
@@ -2041,9 +2087,9 @@
2041 2087 'slug' => $slug,
2042 2088 'title' => $title,
2043 2089 )
2044 2090 ),
2045 - "$path/edit.js" => $this->render_block_file(
2091 + "$path/edit.js" => self::render_block_file(
2046 2092 'block-edit-js',
2047 2093 array(
2048 2094 'title' => $title,
2049 2095 'className' => str_replace( ' ', '', ucwords( str_replace( '-', ' ', $slug ) ) ),
@@ -2048,10 +2094,8 @@
2048 2094 'title' => $title,
2049 2095 'className' => str_replace( ' ', '', ucwords( str_replace( '-', ' ', $slug ) ) ),
2050 2096 )
2051 2097 ),
2052 - "$path/icon.js" => $this->render_block_file( 'block-icon-js' ),
2053 - "$path/attributes.js" => $this->render_block_file( 'block-attributes-js' ),
2054 2098 );
2055 2099
2056 2100 $files_written = array();
2057 2101
@@ -2077,9 +2121,9 @@
2077 2121 $new_block_list = json_decode( $block_list );
2078 2122 $new_block_list->{ $variation }[] = $slug;
2079 2123
2080 2124 // Format the JSON to match our coding standards.
2081 - $new_block_list_formatted = wp_json_encode( $new_block_list, JSON_PRETTY_PRINT ) . "\n";
2125 + $new_block_list_formatted = wp_json_encode( $new_block_list, JSON_UNESCAPED_SLASHES | JSON_PRETTY_PRINT ) . "\n";
2082 2126 $new_block_list_formatted = preg_replace_callback(
2083 2127 // Find all occurrences of multiples of 4 spaces a the start of the line.
2084 2128 '/^((?: )+)/m',
2085 2129 function ( $matches ) {