WP_CLI::line( "\t" . str_pad( $option, 30 ) . 'Array - Use "get <option>" to read option array.' );
}
}
$option_text = '{' . _x( 'option', 'a variable command that a user can write, provided in the printed instructions', 'jetpack' ) . '}';
$value_text = '{' . _x( 'value', 'the value that they want to update the option to', 'jetpack' ) . '}';
WP_CLI::success(
_x( "Above are your options. You may 'get', 'delete', and 'update' them.", "'get', 'delete', and 'update' are commands - do not translate.", 'jetpack' ) . "\n" .
WP_CLI::log( sprintf( __( 'Reset Full Sync Queue on %s', 'jetpack' ), get_site_url() ) );
break;
default:
WP_CLI::error( __( 'Please specify what type of queue do you want to reset: `full` or `regular`.', 'jetpack' ) );
break;
}
}
break;
case 'start':
if ( ! Actions::sync_allowed() ) {
if ( Settings::get_setting( 'disable' ) ) {
WP_CLI::error( __( 'Jetpack sync is not currently allowed for this site. It is currently disabled. Run `wp jetpack sync enable` to enable it.', 'jetpack' ) );
return;
}
$connection = new Connection_Manager();
if ( ! $connection->is_connected() ) {
if ( ! doing_action( 'jetpack_site_registered' ) ) {
WP_CLI::error( __( 'Jetpack sync is not currently allowed for this site. Jetpack is not connected.', 'jetpack' ) );
return;
}
}
$status = new Status();
if ( $status->is_offline_mode() ) {
WP_CLI::error( __( 'Jetpack sync is not currently allowed for this site. The site is in offline mode.', 'jetpack' ) );
return;
}
if ( $status->is_staging_site() ) {
WP_CLI::error( __( 'Jetpack sync is not currently allowed for this site. The site is in staging mode.', 'jetpack' ) );
return;
}
}
// Get the original settings so that we can restore them later
$original_settings = Settings::get_settings();
// Initialize sync settigns so we can sync as quickly as possible
* --purge : if set, will remove all existing sitemap data before rebuilding
*
* ## EXAMPLES
*
* wp jetpack sitemap rebuild
*
* @subcommand sitemap
* @synopsis <rebuild> [--purge]
*/
public function sitemap( $args, $assoc_args ) {
if ( ! Jetpack::is_connection_ready() ) {
WP_CLI::error( __( 'Jetpack is not currently connected to WordPress.com', 'jetpack' ) );
}
if ( ! Jetpack::is_module_active( 'sitemaps' ) ) {
WP_CLI::error( __( 'Jetpack Sitemaps module is not currently active. Activate it first if you want to work with sitemaps.', 'jetpack' ) );
}
if ( ! class_exists( 'Jetpack_Sitemap_Builder' ) ) {
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' ) );
}
if ( isset( $assoc_args['purge'] ) && $assoc_args['purge'] ) {
$librarian = new Jetpack_Sitemap_Librarian();
$librarian->delete_all_stored_sitemap_data();
}
$sitemap_builder = new Jetpack_Sitemap_Builder();
$sitemap_builder->update_sitemap();
}
/**
* Allows authorizing a user via the command line and will activate
* API wrapper for getting stats from the WordPress.com API for the current site.
*
* ## OPTIONS
*
* [--quantity=<quantity>]
* : The number of units to include.
* ---
* default: 30
* ---
*
* [--period=<period>]
* : The unit of time to query stats for.
* ---
* default: day
* options:
* - day
* - week
* - month
* - year
* ---
*
* [--date=<date>]
* : The latest date to return stats for. Ex. - 2018-01-01.
*
* [--pretty]
* : Will pretty print the results of a successful API call.
*
* [--strip-success]
* : Will remove the green success label from successful API calls.
*
* ## EXAMPLES
*
* wp jetpack get_stats
*/
public function get_stats( $args, $named_args ) {
$selected_args = array_intersect_key(
$named_args,
array_flip(
array(
'quantity',
'date',
)
)
);
// The API expects unit, but period seems to be more correct.
$selected_args['unit'] = $named_args['period'];
$command = sprintf(
'jetpack call_api --resource=/sites/%d/stats/%s',
Jetpack_Options::get_option( 'id' ),
add_query_arg( $selected_args, 'visits' )
);
if ( isset( $named_args['pretty'] ) ) {
$command .= ' --pretty';
}
if ( isset( $named_args['strip-success'] ) ) {
$command .= ' --strip-success';
}
WP_CLI::runcommand(
$command,
array(
'launch' => false, // Use the current process.
)
);
}
/**
* Allows management of publicize connections.
*
* ## OPTIONS
*
* <list|disconnect>
* : The action to perform.
* ---
* options:
* - list
* - disconnect
* ---
*
* [<identifier>]
* : The connection ID or service to perform an action on.
*
* [--format=<format>]
* : Allows overriding the output of the command when listing connections.
* ---
* default: table
* options:
* - table
* - json
* - csv
* - yaml
* - ids
* - count
* ---
*
* ## EXAMPLES
*
* # List all publicize connections.
* $ wp jetpack publicize list
*
* # List publicize connections for a given service.
* $ wp jetpack publicize list twitter
*
* # List all publicize connections for a given user.
* $ wp --user=1 jetpack publicize list
*
* # List all publicize connections for a given user and service.
* $ wp --user=1 jetpack publicize list twitter
*
* # Display details for a given connection.
* $ wp jetpack publicize list 123456
*
* # Diconnection a given connection.
* $ wp jetpack publicize disconnect 123456
*
* # Disconnect all connections.
* $ wp jetpack publicize disconnect all
*
* # Disconnect all connections for a given service.
* $ wp jetpack publicize disconnect twitter
*/
public function publicize( $args, $named_args ) {
if ( ! Jetpack::connection()->has_connected_owner() ) {
WP_CLI::error( __( 'Publicize requires a user-level connection to WordPress.com', 'jetpack' ) );
}
if ( ! Jetpack::is_module_active( 'publicize' ) ) {
WP_CLI::error( __( 'The publicize module is not active.', 'jetpack' ) );
}
if ( ( new Status() )->is_offline_mode() ) {
if (
! defined( 'JETPACK_DEV_DEBUG' ) &&
! has_filter( 'jetpack_development_mode' ) &&
! has_filter( 'jetpack_offline_mode' ) &&
false === strpos( site_url(), '.' )
) {
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 publicize module will not load.", 'jetpack' ) );
}
WP_CLI::error( __( 'Jetpack is currently in offline mode, so the publicize module will not load.', 'jetpack' ) );
}
if ( ! class_exists( 'Publicize' ) ) {
WP_CLI::error( __( 'The publicize module is not loaded.', 'jetpack' ) );
private function partner_provision_error( $error ) {
WP_CLI::log(
json_encode(
array(
'success' => false,
'error_code' => $error->get_error_code(),
'error_message' => $error->get_error_message(),
)
)
);
exit( 1 );
}
/**
* Creates the essential files in Jetpack to start building a Gutenberg block or plugin.
*
* ## TYPES
*
* block: it creates a Jetpack block. All files will be created in a directory under extensions/blocks named based on the block title or a specific given slug.
*
* ## BLOCK TYPE OPTIONS
*
* The first parameter is the block title and it's not associative. Add it wrapped in quotes.
* The title is also used to create the slug and the edit PHP class name. If it's something like "Logo gallery", the slug will be 'logo-gallery' and the class name will be LogoGalleryEdit.
* --slug: Specific slug to identify the block that overrides the one generated based on the title.
* --description: Allows to provide a text description of the block.
* --keywords: Provide up to three keywords separated by comma so users can find this block when they search in Gutenberg's inserter.
* --variation: Allows to decide whether the block should be a production block, experimental, or beta. Defaults to Beta when arg not provided.
*
* ## BLOCK TYPE EXAMPLES
*
* wp jetpack scaffold block "Cool Block"
* wp jetpack scaffold block "Amazing Rock" --slug="good-music" --description="Rock the best music on your site"
if ( ! preg_match( '/^[a-z][a-z0-9\-]*$/', $slug ) ) {
WP_CLI::error( esc_html__( 'Invalid block slug. They can contain only lowercase alphanumeric characters or dashes, and start with a letter', 'jetpack' ) . ' 👻' );
* Standard "ask for permission to continue" function.
* If action cancelled, ask if they need help.
*
* Written outside of the class so it's not listed as an executable command w/ 'wp jetpack'
*
* @param $flagged bool false = normal option | true = flagged by get_jetpack_options_for_reset()
* @param $error_msg string (optional)
*/
function jetpack_cli_are_you_sure( $flagged = false, $error_msg = false ) {
$cli = new Jetpack_CLI();
// Default cancellation message
if ( ! $error_msg ) {
$error_msg =
__( 'Action cancelled. Have a question?', 'jetpack' )
. ' '
. $cli->green_open
. 'jetpack.com/support'
. $cli->color_close;
}
if ( ! $flagged ) {
$prompt_message = _x( 'Are you sure? This cannot be undone. Type "yes" to continue:', '"yes" is a command - do not translate.', 'jetpack' );
} else {
$prompt_message = _x( 'Are you sure? Modifying this option may disrupt your Jetpack connection. Type "yes" to continue.', '"yes" is a command - do not translate.', 'jetpack' );