Wala shell

Advanced PHP File Manager

Server IP: 127.0.0.1 | PHP Version: 8.3.30 | Domains Hosted: 54

Name	Size	Last Modified
📁 ..	-	2025-09-06 07:07
📄 Comment_Command.php <?php use WP_CLI\CommandWithDBObject; use WP_CLI\Fetchers\Comment as CommentFetcher; use WP_CLI\Utils; /** * Creates, updates, deletes, and moderates comments. * * ## EXAMPLES * * # Create a new comment. * $ wp comment create --comment_post_ID=15 --comment_content="hello blog" --comment_author="wp-cli" * Success: Created comment 932. * * # Update an existing comment. * $ wp comment update 123 --comment_author='That Guy' * Success: Updated comment 123. * * # Delete an existing comment. * $ wp comment delete 1337 --force * Success: Deleted comment 1337. * * # Trash all spam comments. * $ wp comment delete $(wp comment list --status=spam --format=ids) * Success: Trashed comment 264. * Success: Trashed comment 262. * * @package wp-cli / class Comment_Command extends CommandWithDBObject { protected $obj_type = 'comment'; protected $obj_id_key = 'comment_ID'; protected $obj_fields = [ 'comment_ID', 'comment_post_ID', 'comment_date', 'comment_approved', 'comment_author', 'comment_author_email', ]; private $fetcher; public function __construct() { $this->fetcher = new CommentFetcher(); } /* * Creates a new comment. * * ## OPTIONS * * [--<field>=<value>] * : Associative args for the new comment. See wp_insert_comment(). * * [--porcelain] * : Output just the new comment id. * * ## EXAMPLES * * # Create comment. * $ wp comment create --comment_post_ID=15 --comment_content="hello blog" --comment_author="wp-cli" * Success: Created comment 932. / public function create( $args, $assoc_args ) { $assoc_args = wp_slash( $assoc_args ); parent::_create( $args, $assoc_args, function ( $params ) { if ( isset( $params['comment_post_ID'] ) ) { $post_id = $params['comment_post_ID']; $post = get_post( $post_id ); if ( ! $post ) { return new WP_Error( 'no_post', "Can't find post {$post_id}." ); } } else { // Make sure it's set for older WP versions else get undefined PHP notice. $params['comment_post_ID'] = 0; } // We use wp_insert_comment() instead of wp_new_comment() to stay at a low level and // avoid wp_die() formatted messages or notifications $comment_id = wp_insert_comment( $params ); if ( ! $comment_id ) { return new WP_Error( 'db_error', 'Could not create comment.' ); } return $comment_id; } ); } /* * Updates one or more comments. * * ## OPTIONS * * <id>... * : One or more IDs of comments to update. * * --<field>=<value> * : One or more fields to update. See wp_update_comment(). * * ## EXAMPLES * * # Update comment. * $ wp comment update 123 --comment_author='That Guy' * Success: Updated comment 123. / public function update( $args, $assoc_args ) { $assoc_args = wp_slash( $assoc_args ); parent::_update( $args, $assoc_args, function ( $params ) { if ( ! wp_update_comment( $params ) ) { return new WP_Error( 'db_error', 'Could not update comment.' ); } return true; } ); } /* * Generates some number of new dummy comments. * * Creates a specified number of new comments with dummy data. * * ## OPTIONS * * [--count=<number>] * : How many comments to generate? * --- * default: 100 * --- * * [--post_id=<post-id>] * : Assign comments to a specific post. * * [--format=<format>] * : Render output in a particular format. * --- * default: progress * options: * - progress * - ids * --- * * ## EXAMPLES * * # Generate comments for the given post. * $ wp comment generate --format=ids --count=3 --post_id=123 * 138 139 140 * * # Add meta to every generated comment. * $ wp comment generate --format=ids --count=3 \| xargs -d ' ' -I % wp comment meta add % foo bar * Success: Added custom field. * Success: Added custom field. * Success: Added custom field. / public function generate( $args, $assoc_args ) { $defaults = [ 'count' => 100, 'post_id' => 0, ]; $assoc_args = array_merge( $defaults, $assoc_args ); $format = Utils\get_flag_value( $assoc_args, 'format', 'progress' ); $notify = false; if ( 'progress' === $format ) { $notify = Utils\make_progress_bar( 'Generating comments', $assoc_args['count'] ); } $comment_count = wp_count_comments(); $total = (int) $comment_count->total_comments; $limit = $total + $assoc_args['count']; for ( $index = $total; $index < $limit; $index++ ) { $comment_id = wp_insert_comment( [ 'comment_content' => "Comment {$index}", 'comment_post_ID' => $assoc_args['post_id'], ] ); if ( 'progress' === $format ) { $notify->tick(); } elseif ( 'ids' === $format ) { echo $comment_id; if ( $index < $limit - 1 ) { echo ' '; } } } if ( 'progress' === $format ) { $notify->finish(); } } /* * Gets the data of a single comment. * * ## OPTIONS * * <id> * : The comment to get. * * [--field=<field>] * : Instead of returning the whole comment, returns the value of a single field. * * [--fields=<fields>] * : Limit the output to specific fields. Defaults to all fields. * * [--format=<format>] * : Render output in a particular format. * --- * default: table * options: * - table * - csv * - json * - yaml * --- * * ## EXAMPLES * * # Get comment. * $ wp comment get 21 --field=content * Thanks for all the comments, everyone! / public function get( $args, $assoc_args ) { $comment_id = (int) $args[0]; $comment = get_comment( $comment_id ); if ( empty( $comment ) ) { WP_CLI::error( 'Invalid comment ID.' ); } if ( ! isset( $comment->url ) ) { $comment->url = get_comment_link( $comment ); } if ( empty( $assoc_args['fields'] ) ) { $comment_array = get_object_vars( $comment ); $assoc_args['fields'] = array_keys( $comment_array ); } $formatter = $this->get_formatter( $assoc_args ); $formatter->display_item( $comment ); } /* * Gets a list of comments. * * Display comments based on all arguments supported by * [WP_Comment_Query()](https://developer.wordpress.org/reference/classes/WP_Comment_Query/__construct/). * * ## OPTIONS * * [--<field>=<value>] * : One or more args to pass to WP_Comment_Query. * * [--field=<field>] * : Prints the value of a single field for each comment. * * [--fields=<fields>] * : Limit the output to specific object fields. * * [--format=<format>] * : Render output in a particular format. * --- * default: table * options: * - table * - ids * - csv * - json * - count * - yaml * --- * * ## AVAILABLE FIELDS * * These fields will be displayed by default for each comment: * * * comment_ID * * comment_post_ID * * comment_date * * comment_approved * * comment_author * * comment_author_email * * These fields are optionally available: * * * comment_author_url * * comment_author_IP * * comment_date_gmt * * comment_content * * comment_karma * * comment_agent * * comment_type * * comment_parent * * user_id * * url * * ## EXAMPLES * * # List comment IDs. * $ wp comment list --field=ID * 22 * 23 * 24 * * # List comments of a post. * $ wp comment list --post_id=1 --fields=ID,comment_date,comment_author * +------------+---------------------+----------------+ * \| comment_ID \| comment_date \| comment_author \| * +------------+---------------------+----------------+ * \| 1 \| 2015-06-20 09:00:10 \| Mr WordPress \| * +------------+---------------------+----------------+ * * # List approved comments. * $ wp comment list --number=3 --status=approve --fields=ID,comment_date,comment_author * +------------+---------------------+----------------+ * \| comment_ID \| comment_date \| comment_author \| * +------------+---------------------+----------------+ * \| 1 \| 2015-06-20 09:00:10 \| Mr WordPress \| * \| 30 \| 2013-03-14 12:35:07 \| John Doe \| * \| 29 \| 2013-03-14 11:56:08 \| Jane Doe \| * +------------+---------------------+----------------+ * * # List unapproved comments. * $ wp comment list --number=3 --status=hold --fields=ID,comment_date,comment_author * +------------+---------------------+----------------+ * \| comment_ID \| comment_date \| comment_author \| * +------------+---------------------+----------------+ * \| 8 \| 2023-11-10 13:13:06 \| John Doe \| * \| 7 \| 2023-11-10 13:09:55 \| Mr WordPress \| * \| 9 \| 2023-11-10 11:22:31 \| Jane Doe \| * +------------+---------------------+----------------+ * * # List comments marked as spam. * $ wp comment list --status=spam --fields=ID,comment_date,comment_author * +------------+---------------------+----------------+ * \| comment_ID \| comment_date \| comment_author \| * +------------+---------------------+----------------+ * \| 2 \| 2023-11-10 11:22:31 \| Jane Doe \| * +------------+---------------------+----------------+ * * # List comments in trash. * $ wp comment list --status=trash --fields=ID,comment_date,comment_author * +------------+---------------------+----------------+ * \| comment_ID \| comment_date \| comment_author \| * +------------+---------------------+----------------+ * \| 3 \| 2023-11-10 11:22:31 \| John Doe \| * +------------+---------------------+----------------+ * * @subcommand list / public function list_( $args, $assoc_args ) { $formatter = $this->get_formatter( $assoc_args ); if ( 'ids' === $formatter->format ) { $assoc_args['fields'] = 'comment_ID'; } $assoc_args = self::process_csv_arguments_to_arrays( $assoc_args ); if ( 'count' === $formatter->format ) { $assoc_args['count'] = true; } if ( ! empty( $assoc_args['comment__in'] ) && ! empty( $assoc_args['orderby'] ) && 'comment__in' === $assoc_args['orderby'] && Utils\wp_version_compare( '4.4', '<' ) ) { $comments = []; foreach ( $assoc_args['comment__in'] as $comment_id ) { $comment = get_comment( $comment_id ); if ( $comment ) { $comments[] = $comment; } else { WP_CLI::warning( "Invalid comment {$comment_id}." ); } } } else { $query = new WP_Comment_Query(); $comments = $query->query( $assoc_args ); } if ( 'count' === $formatter->format ) { echo $comments; } else { if ( 'ids' === $formatter->format ) { $comments = wp_list_pluck( $comments, 'comment_ID' ); } elseif ( is_array( $comments ) ) { $comments = array_map( function ( $comment ) { $comment->url = get_comment_link( $comment->comment_ID ); return $comment; }, $comments ); } $formatter->display_items( $comments ); } } /* * Deletes a comment. * * ## OPTIONS * * <id>... * : One or more IDs of comments to delete. * * [--force] * : Skip the trash bin. * * ## EXAMPLES * * # Delete comment. * $ wp comment delete 1337 --force * Success: Deleted comment 1337. * * # Delete multiple comments. * $ wp comment delete 1337 2341 --force * Success: Deleted comment 1337. * Success: Deleted comment 2341. / public function delete( $args, $assoc_args ) { parent::_delete( $args, $assoc_args, function ( $comment_id, $assoc_args ) { $force = Utils\get_flag_value( $assoc_args, 'force' ); $status = wp_get_comment_status( $comment_id ); $result = wp_delete_comment( $comment_id, $force ); if ( ! $result ) { return [ 'error', "Failed deleting comment {$comment_id}." ]; } $verb = ( $force \|\| 'trash' === $status ) ? 'Deleted' : 'Trashed'; return [ 'success', "{$verb} comment {$comment_id}." ]; } ); } private function call( $args, $status, $success, $failure ) { $comment_id = absint( $args ); $func = "wp_{$status}_comment"; if ( ! $func( $comment_id ) ) { WP_CLI::error( sprintf( $failure, "comment {$comment_id}" ) ); } WP_CLI::success( sprintf( $success, "comment {$comment_id}" ) ); } private function set_status( $args, $status, $success ) { $comment = $this->fetcher->get_check( $args ); $result = wp_set_comment_status( $comment->comment_ID, $status, true ); if ( is_wp_error( $result ) ) { WP_CLI::error( $result ); } WP_CLI::success( "{$success} comment {$comment->comment_ID}." ); } /* * Warns if `$_SERVER['SERVER_NAME']` not set as used in email from-address sent to post author in `wp_notify_postauthor()`. / private function check_server_name() { if ( empty( $_SERVER['SERVER_NAME'] ) ) { WP_CLI::warning( 'Site url not set - defaulting to \'example.com\'. Any notification emails sent to post author may appear to come from \'example.com\'.' ); $_SERVER['SERVER_NAME'] = 'example.com'; } } /* * Trashes a comment. * * ## OPTIONS * * <id>... * : The IDs of the comments to trash. * * ## EXAMPLES * * # Trash comment. * $ wp comment trash 1337 * Success: Trashed comment 1337. / public function trash( $args, $assoc_args ) { foreach ( $args as $id ) { $this->call( $id, __FUNCTION__, 'Trashed %s.', 'Failed trashing %s.' ); } } /* * Untrashes a comment. * * ## OPTIONS * * <id>... * : The IDs of the comments to untrash. * * ## EXAMPLES * * # Untrash comment. * $ wp comment untrash 1337 * Success: Untrashed comment 1337. / public function untrash( $args, $assoc_args ) { $this->check_server_name(); foreach ( $args as $id ) { $this->call( $id, __FUNCTION__, 'Untrashed %s.', 'Failed untrashing %s.' ); } } /* * Marks a comment as spam. * * ## OPTIONS * * <id>... * : The IDs of the comments to mark as spam. * * ## EXAMPLES * * # Spam comment. * $ wp comment spam 1337 * Success: Marked as spam comment 1337. / public function spam( $args, $assoc_args ) { foreach ( $args as $id ) { $this->call( $id, __FUNCTION__, 'Marked %s as spam.', 'Failed marking %s as spam.' ); } } /* * Unmarks a comment as spam. * * ## OPTIONS * * <id>... * : The IDs of the comments to unmark as spam. * * ## EXAMPLES * * # Unspam comment. * $ wp comment unspam 1337 * Success: Unspammed comment 1337. / public function unspam( $args, $assoc_args ) { $this->check_server_name(); foreach ( $args as $id ) { $this->call( $id, __FUNCTION__, 'Unspammed %s.', 'Failed unspamming %s.' ); } } /* * Approves a comment. * * ## OPTIONS * * <id>... * : The IDs of the comments to approve. * * ## EXAMPLES * * # Approve comment. * $ wp comment approve 1337 * Success: Approved comment 1337. / public function approve( $args, $assoc_args ) { $this->check_server_name(); foreach ( $args as $id ) { $this->set_status( $id, 'approve', 'Approved' ); } } /* * Unapproves a comment. * * ## OPTIONS * * <id>... * : The IDs of the comments to unapprove. * * ## EXAMPLES * * # Unapprove comment. * $ wp comment unapprove 1337 * Success: Unapproved comment 1337. / public function unapprove( $args, $assoc_args ) { $this->check_server_name(); foreach ( $args as $id ) { $this->set_status( $id, 'hold', 'Unapproved' ); } } /* * Counts comments, on whole blog or on a given post. * * ## OPTIONS * * [<post-id>] * : The ID of the post to count comments in. * * ## EXAMPLES * * # Count comments on whole blog. * $ wp comment count * approved: 33 * spam: 3 * trash: 1 * post-trashed: 0 * all: 34 * moderated: 1 * total_comments: 37 * * # Count comments in a post. * $ wp comment count 42 * approved: 19 * spam: 0 * trash: 0 * post-trashed: 0 * all: 19 * moderated: 0 * total_comments: 19 / public function count( $args, $assoc_args ) { $post_id = Utils\get_flag_value( $args, 0, 0 ); $count = wp_count_comments( $post_id ); // Move total_comments to the end of the object $total = $count->total_comments; unset( $count->total_comments ); $count->total_comments = $total; foreach ( $count as $status => $count ) { WP_CLI::line( str_pad( "$status:", 17 ) . $count ); } } /* * Recalculates the comment_count value for one or more posts. * * ## OPTIONS * * <id>... * : IDs for one or more posts to update. * * ## EXAMPLES * * # Recount comment for the post. * $ wp comment recount 123 * Updated post 123 comment count to 67. / public function recount( $args ) { foreach ( $args as $id ) { if ( wp_update_comment_count( $id ) ) { $post = get_post( $id ); WP_CLI::log( "Updated post {$post->ID} comment count to {$post->comment_count}." ); } else { WP_CLI::warning( "Post {$id} doesn't exist." ); } } } /* * Gets the status of a comment. * * ## OPTIONS * * <id> * : The ID of the comment to check. * * ## EXAMPLES * * # Get status of comment. * $ wp comment status 1337 * approved / public function status( $args, $assoc_args ) { list( $comment_id ) = $args; $status = wp_get_comment_status( $comment_id ); if ( false === $status ) { WP_CLI::error( "Could not check status of comment {$comment_id}." ); } else { WP_CLI::line( $status ); } } /* * Verifies whether a comment exists. * * Displays a success message if the comment does exist. * * ## OPTIONS * * <id> * : The ID of the comment to check. * * ## EXAMPLES * * # Check whether comment exists. * $ wp comment exists 1337 * Success: Comment with ID 1337 exists. */ public function exists( $args ) { if ( $this->fetcher->get( $args[0] ) ) { WP_CLI::success( "Comment with ID {$args[0]} exists." ); } } }	18 KB	2025-09-06 07:07
📄 Comment_Meta_Command.php <?php use WP_CLI\CommandWithMeta; use WP_CLI\Fetchers\Comment as CommentFetcher; /** * Adds, updates, deletes, and lists comment custom fields. * * ## EXAMPLES * * # Set comment meta * $ wp comment meta set 123 description "Mary is a WordPress developer." * Success: Updated custom field 'description'. * * # Get comment meta * $ wp comment meta get 123 description * Mary is a WordPress developer. * * # Update comment meta * $ wp comment meta update 123 description "Mary is an awesome WordPress developer." * Success: Updated custom field 'description'. * * # Delete comment meta * $ wp comment meta delete 123 description * Success: Deleted custom field. / class Comment_Meta_Command extends CommandWithMeta { protected $meta_type = 'comment'; /* * Wrapper method for add_metadata that can be overridden in sub classes. * * @param int $object_id ID of the object the metadata is for. * @param string $meta_key Metadata key to use. * @param mixed $meta_value Metadata value. Must be serializable if * non-scalar. * @param bool $unique Optional, default is false. Whether the * specified metadata key should be unique for the * object. If true, and the object already has a * value for the specified metadata key, no change * will be made. * * @return int\|false The meta ID on success, false on failure. / protected function add_metadata( $object_id, $meta_key, $meta_value, $unique = false ) { return add_comment_meta( $object_id, $meta_key, $meta_value, $unique ); } /* * Wrapper method for update_metadata that can be overridden in sub classes. * * @param int $object_id ID of the object the metadata is for. * @param string $meta_key Metadata key to use. * @param mixed $meta_value Metadata value. Must be serializable if * non-scalar. * @param mixed $prev_value Optional. If specified, only update existing * metadata entries with the specified value. * Otherwise, update all entries. * * @return int\|bool Meta ID if the key didn't exist, true on successful * update, false on failure. / protected function update_metadata( $object_id, $meta_key, $meta_value, $prev_value = '' ) { return update_comment_meta( $object_id, $meta_key, $meta_value, $prev_value ); } /* * Wrapper method for get_metadata that can be overridden in sub classes. * * @param int $object_id ID of the object the metadata is for. * @param string $meta_key Optional. Metadata key. If not specified, * retrieve all metadata for the specified object. * @param bool $single Optional, default is false. If true, return only * the first value of the specified meta_key. This * parameter has no effect if meta_key is not * specified. * * @return mixed Single metadata value, or array of values. / protected function get_metadata( $object_id, $meta_key = '', $single = false ) { return get_comment_meta( $object_id, $meta_key, $single ); } /* * Wrapper method for delete_metadata that can be overridden in sub classes. * * @param int $object_id ID of the object metadata is for * @param string $meta_key Metadata key * @param mixed $meta_value Optional. Metadata value. Must be serializable * if non-scalar. If specified, only delete * metadata entries with this value. Otherwise, * delete all entries with the specified meta_key. * Pass `null, `false`, or an empty string to skip * this check. For backward compatibility, it is * not possible to pass an empty string to delete * those entries with an empty string for a value. * * @return bool True on successful delete, false on failure. / protected function delete_metadata( $object_id, $meta_key, $meta_value = '' ) { return delete_comment_meta( $object_id, $meta_key, $meta_value ); } /* * Check that the comment ID exists * * @param int */ protected function check_object_id( $object_id ) { $fetcher = new CommentFetcher(); $comment = $fetcher->get_check( $object_id ); return $comment->comment_ID; } }	4.5 KB	2025-05-25 12:40
📄 Menu_Command.php <?php use WP_CLI\Formatter; use WP_CLI\Utils; /** * Lists, creates, assigns, and deletes the active theme's navigation menus. * * See the [Navigation Menus](https://developer.wordpress.org/themes/functionality/navigation-menus/) reference in the Theme Handbook. * * ## EXAMPLES * * # Create a new menu * $ wp menu create "My Menu" * Success: Created menu 200. * * # List existing menus * $ wp menu list * +---------+----------+----------+-----------+-------+ * \| term_id \| name \| slug \| locations \| count \| * +---------+----------+----------+-----------+-------+ * \| 200 \| My Menu \| my-menu \| \| 0 \| * \| 177 \| Top Menu \| top-menu \| primary \| 7 \| * +---------+----------+----------+-----------+-------+ * * # Create a new menu link item * $ wp menu item add-custom my-menu Apple http://apple.com --porcelain * 1922 * * # Assign the 'my-menu' menu to the 'primary' location * $ wp menu location assign my-menu primary * Success: Assigned location primary to menu my-menu. * * @package wp-cli / class Menu_Command extends WP_CLI_Command { protected $obj_type = 'nav_menu'; protected $obj_fields = [ 'term_id', 'name', 'slug', 'locations', 'count', ]; /* * Creates a new menu. * * ## OPTIONS * * <menu-name> * : A descriptive name for the menu. * * [--porcelain] * : Output just the new menu id. * * ## EXAMPLES * * $ wp menu create "My Menu" * Success: Created menu 200. / public function create( $args, $assoc_args ) { $menu_id = wp_create_nav_menu( $args[0] ); if ( is_wp_error( $menu_id ) ) { WP_CLI::error( $menu_id->get_error_message() ); } elseif ( Utils\get_flag_value( $assoc_args, 'porcelain' ) ) { WP_CLI::line( $menu_id ); } else { WP_CLI::success( "Created menu {$menu_id}." ); } } /* * Deletes one or more menus. * * ## OPTIONS * * <menu>... * : The name, slug, or term ID for the menu(s). * * ## EXAMPLES * * $ wp menu delete "My Menu" * Deleted menu 'My Menu'. * Success: Deleted 1 of 1 menus. / public function delete( $args, $assoc_args ) { $count = 0; $errors = 0; foreach ( $args as $arg ) { $ret = wp_delete_nav_menu( $arg ); if ( ! $ret \|\| is_wp_error( $ret ) ) { WP_CLI::warning( "Couldn't delete menu '{$arg}'." ); ++$errors; } else { WP_CLI::log( "Deleted menu '{$arg}'." ); ++$count; } } Utils\report_batch_operation_results( 'menu', 'delete', count( $args ), $count, $errors ); } /* * Gets a list of menus. * * ## OPTIONS * * [--fields=<fields>] * : Limit the output to specific object fields. * * [--format=<format>] * : Render output in a particular format. * --- * default: table * options: * - table * - csv * - json * - count * - ids * - yaml * --- * * ## AVAILABLE FIELDS * * These fields will be displayed by default for each menu: * * * term_id * * name * * slug * * count * * These fields are optionally available: * * * term_group * * term_taxonomy_id * * taxonomy * * description * * parent * * locations * * ## EXAMPLES * * $ wp menu list * +---------+----------+----------+-----------+-------+ * \| term_id \| name \| slug \| locations \| count \| * +---------+----------+----------+-----------+-------+ * \| 200 \| My Menu \| my-menu \| \| 0 \| * \| 177 \| Top Menu \| top-menu \| primary \| 7 \| * +---------+----------+----------+-----------+-------+ * * @subcommand list */ public function list_( $args, $assoc_args ) { $menus = wp_get_nav_menus(); $menu_locations = get_nav_menu_locations(); foreach ( $menus as &$menu ) { $menu->locations = []; foreach ( $menu_locations as $location => $term_id ) { if ( $term_id === $menu->term_id ) { $menu->locations[] = $location; } } // Normalize the data for some output formats. if ( ! isset( $assoc_args['format'] ) \|\| in_array( $assoc_args['format'], [ 'csv', 'table' ], true ) ) { $menu->locations = implode( ',', $menu->locations ); } } $formatter = $this->get_formatter( $assoc_args ); if ( 'ids' === $formatter->format ) { $ids = array_map( function ( $o ) { return $o->term_id; }, $menus ); $formatter->display_items( $ids ); } else { $formatter->display_items( $menus ); } } protected function get_formatter( &$assoc_args ) { return new Formatter( $assoc_args, $this->obj_fields, $this->obj_type ); } }	4.55 KB	2025-05-25 12:40
📄 Menu_Item_Command.php <?php use WP_CLI\Formatter; use WP_CLI\Utils; /** * List, add, and delete items associated with a menu. * * ## EXAMPLES * * # Add an existing post to an existing menu * $ wp menu item add-post sidebar-menu 33 --title="Custom Test Post" * Success: Menu item added. * * # Create a new menu link item * $ wp menu item add-custom sidebar-menu Apple http://apple.com * Success: Menu item added. * * # Delete menu item * $ wp menu item delete 45 * Success: Deleted 1 of 1 menu items. / class Menu_Item_Command extends WP_CLI_Command { protected $obj_fields = [ 'db_id', 'type', 'title', 'link', 'position', ]; /* * Gets a list of items associated with a menu. * * ## OPTIONS * * <menu> * : The name, slug, or term ID for the menu. * * [--fields=<fields>] * : Limit the output to specific object fields. * * [--format=<format>] * : Render output in a particular format. * --- * default: table * options: * - table * - csv * - json * - count * - ids * - yaml * --- * * ## AVAILABLE FIELDS * * These fields will be displayed by default for each menu item: * * * db_id * * type * * title * * link * * position * * These fields are optionally available: * * * menu_item_parent * * object_id * * object * * type * * type_label * * target * * attr_title * * description * * classes * * xfn * * ## EXAMPLES * * $ wp menu item list main-menu * +-------+-----------+-------------+---------------------------------+----------+ * \| db_id \| type \| title \| link \| position \| * +-------+-----------+-------------+---------------------------------+----------+ * \| 5 \| custom \| Home \| http://example.com \| 1 \| * \| 6 \| post_type \| Sample Page \| http://example.com/sample-page/ \| 2 \| * +-------+-----------+-------------+---------------------------------+----------+ * * @subcommand list / public function list_( $args, $assoc_args ) { $items = wp_get_nav_menu_items( $args[0] ); if ( false === $items \|\| is_wp_error( $items ) ) { WP_CLI::error( 'Invalid menu.' ); } // Correct position inconsistency and // protected `url` param in WP-CLI $items = array_map( function ( $item ) { $item->position = $item->menu_order; $item->link = $item->url; return $item; }, $items ); if ( ! empty( $assoc_args['format'] ) && 'ids' === $assoc_args['format'] ) { $items = array_map( function ( $item ) { return $item->db_id; }, $items ); } $formatter = $this->get_formatter( $assoc_args ); $formatter->display_items( $items ); } /* * Adds a post as a menu item. * * ## OPTIONS * * <menu> * : The name, slug, or term ID for the menu. * * <post-id> * : Post ID to add to the menu. * * [--title=<title>] * : Set a custom title for the menu item. * * [--link=<link>] * : Set a custom url for the menu item. * * [--description=<description>] * : Set a custom description for the menu item. * * [--attr-title=<attr-title>] * : Set a custom title attribute for the menu item. * * [--target=<target>] * : Set a custom link target for the menu item. * * [--classes=<classes>] * : Set a custom link classes for the menu item. * * [--position=<position>] * : Specify the position of this menu item. * * [--parent-id=<parent-id>] * : Make this menu item a child of another menu item. * * [--porcelain] * : Output just the new menu item id. * * ## EXAMPLES * * $ wp menu item add-post sidebar-menu 33 --title="Custom Test Post" * Success: Menu item added. * * @subcommand add-post / public function add_post( $args, $assoc_args ) { $assoc_args['object-id'] = $args[1]; unset( $args[1] ); $post = get_post( $assoc_args['object-id'] ); if ( ! $post ) { WP_CLI::error( 'Invalid post.' ); } $assoc_args['object'] = $post->post_type; $this->add_or_update_item( 'add', 'post_type', $args, $assoc_args ); } /* * Adds a taxonomy term as a menu item. * * ## OPTIONS * * <menu> * : The name, slug, or term ID for the menu. * * <taxonomy> * : Taxonomy of the term to be added. * * <term-id> * : Term ID of the term to be added. * * [--title=<title>] * : Set a custom title for the menu item. * * [--link=<link>] * : Set a custom url for the menu item. * * [--description=<description>] * : Set a custom description for the menu item. * * [--attr-title=<attr-title>] * : Set a custom title attribute for the menu item. * * [--target=<target>] * : Set a custom link target for the menu item. * * [--classes=<classes>] * : Set a custom link classes for the menu item. * * [--position=<position>] * : Specify the position of this menu item. * * [--parent-id=<parent-id>] * : Make this menu item a child of another menu item. * * [--porcelain] * : Output just the new menu item id. * * ## EXAMPLES * * $ wp menu item add-term sidebar-menu post_tag 24 * Success: Menu item added. * * @subcommand add-term / public function add_term( $args, $assoc_args ) { $assoc_args['object'] = $args[1]; unset( $args[1] ); $assoc_args['object-id'] = $args[2]; unset( $args[2] ); if ( ! get_term_by( 'id', $assoc_args['object-id'], $assoc_args['object'] ) ) { WP_CLI::error( 'Invalid term.' ); } $this->add_or_update_item( 'add', 'taxonomy', $args, $assoc_args ); } /* * Adds a custom menu item. * * ## OPTIONS * * <menu> * : The name, slug, or term ID for the menu. * * <title> * : Title for the link. * * <link> * : Target URL for the link. * * [--description=<description>] * : Set a custom description for the menu item. * * [--attr-title=<attr-title>] * : Set a custom title attribute for the menu item. * * [--target=<target>] * : Set a custom link target for the menu item. * * [--classes=<classes>] * : Set a custom link classes for the menu item. * * [--position=<position>] * : Specify the position of this menu item. * * [--parent-id=<parent-id>] * : Make this menu item a child of another menu item. * * [--porcelain] * : Output just the new menu item id. * * ## EXAMPLES * * $ wp menu item add-custom sidebar-menu Apple http://apple.com * Success: Menu item added. * * @subcommand add-custom / public function add_custom( $args, $assoc_args ) { $assoc_args['title'] = $args[1]; unset( $args[1] ); $assoc_args['link'] = $args[2]; unset( $args[2] ); $this->add_or_update_item( 'add', 'custom', $args, $assoc_args ); } /* * Updates a menu item. * * ## OPTIONS * * <db-id> * : Database ID for the menu item. * * [--title=<title>] * : Set a custom title for the menu item. * * [--link=<link>] * : Set a custom url for the menu item. * * [--description=<description>] * : Set a custom description for the menu item. * * [--attr-title=<attr-title>] * : Set a custom title attribute for the menu item. * * [--target=<target>] * : Set a custom link target for the menu item. * * [--classes=<classes>] * : Set a custom link classes for the menu item. * * [--position=<position>] * : Specify the position of this menu item. * * [--parent-id=<parent-id>] * : Make this menu item a child of another menu item. * * ## EXAMPLES * * $ wp menu item update 45 --title=WordPress --link='http://wordpress.org' --target=_blank --position=2 * Success: Menu item updated. * * @subcommand update / public function update( $args, $assoc_args ) { // Shuffle the position of these. $args[1] = $args[0]; $terms = get_the_terms( $args[1], 'nav_menu' ); if ( $terms && ! is_wp_error( $terms ) ) { $args[0] = (int) $terms[0]->term_id; } else { $args[0] = 0; } $type = get_post_meta( $args[1], '_menu_item_type', true ); $this->add_or_update_item( 'update', $type, $args, $assoc_args ); } /* * Deletes one or more items from a menu. * * ## OPTIONS * * <db-id>... * : Database ID for the menu item(s). * * ## EXAMPLES * * $ wp menu item delete 45 * Success: Deleted 1 of 1 menu items. * * @subcommand delete / public function delete( $args, $assoc_args ) { global $wpdb; $count = 0; $errors = 0; foreach ( $args as $arg ) { $post = get_post( $arg ); $menu_term = get_the_terms( $arg, 'nav_menu' ); $parent_menu_id = (int) get_post_meta( $arg, '_menu_item_menu_item_parent', true ); $result = wp_delete_post( $arg, true ); if ( ! $result ) { WP_CLI::warning( "Couldn't delete menu item {$arg}." ); ++$errors; } else { if ( is_array( $menu_term ) && ! empty( $menu_term ) && $post ) { $this->reorder_menu_items( $menu_term[0]->term_id, $post->menu_order, -1, 0 ); } if ( $parent_menu_id ) { $children = $wpdb->get_results( $wpdb->prepare( "SELECT post_id FROM $wpdb->postmeta WHERE meta_key='_menu_item_menu_item_parent' AND meta_value=%s", (int) $arg ) ); if ( $children ) { $children_query = $wpdb->prepare( "UPDATE $wpdb->postmeta SET meta_value = %d WHERE meta_key = '_menu_item_menu_item_parent' AND meta_value=%s", $parent_menu_id, (int) $arg ); // phpcs:ignore WordPress.DB.PreparedSQL.NotPrepared -- $children_query is already prepared above. $wpdb->query( $children_query ); foreach ( $children as $child ) { clean_post_cache( $child ); } } } } // phpcs:ignore Universal.Operators.StrictComparisons.LooseNotEqual -- Will increase count for non existent menu. if ( false != $result ) { ++$count; } } Utils\report_batch_operation_results( 'menu item', 'delete', count( $args ), $count, $errors ); } /* * Worker method to create new items or update existing ones. / private function add_or_update_item( $method, $type, $args, $assoc_args ) { $menu = $args[0]; $menu_item_db_id = Utils\get_flag_value( $args, 1, 0 ); $menu = wp_get_nav_menu_object( $menu ); if ( ! $menu \|\| is_wp_error( $menu ) ) { WP_CLI::error( 'Invalid menu.' ); } // `url` is protected in WP-CLI, so we use `link` instead $assoc_args['url'] = Utils\get_flag_value( $assoc_args, 'link' ); // Need to persist the menu item data. See https://core.trac.wordpress.org/ticket/28138 if ( 'update' === $method ) { $menu_item_obj = get_post( $menu_item_db_id ); $menu_item_obj = wp_setup_nav_menu_item( $menu_item_obj ); // Correct the menu position if this was the first item. See https://core.trac.wordpress.org/ticket/28140 $position = ( 0 === $menu_item_obj->menu_order ) ? 1 : $menu_item_obj->menu_order; $default_args = [ 'position' => $position, 'title' => $menu_item_obj->title, 'url' => $menu_item_obj->url, 'description' => $menu_item_obj->description, 'object' => $menu_item_obj->object, 'object-id' => $menu_item_obj->object_id, 'parent-id' => $menu_item_obj->menu_item_parent, 'attr-title' => $menu_item_obj->attr_title, 'target' => $menu_item_obj->target, 'classes' => implode( ' ', $menu_item_obj->classes ), // stored in the database as array 'xfn' => $menu_item_obj->xfn, 'status' => $menu_item_obj->post_status, ]; } else { $default_args = [ 'position' => 0, 'title' => '', 'url' => '', 'description' => '', 'object' => '', 'object-id' => 0, 'parent-id' => 0, 'attr-title' => '', 'target' => '', 'classes' => '', 'xfn' => '', // Core oddly defaults to 'draft' for create, // and 'publish' for update // Easiest to always work with publish 'status' => 'publish', ]; } $menu_item_args = []; foreach ( $default_args as $key => $default_value ) { // wp_update_nav_menu_item() has a weird argument prefix $new_key = 'menu-item-' . $key; $menu_item_args[ $new_key ] = Utils\get_flag_value( $assoc_args, $key, $default_value ); } $menu_item_args['menu-item-type'] = $type; $result = wp_update_nav_menu_item( $menu->term_id, $menu_item_db_id, $menu_item_args ); if ( is_wp_error( $result ) ) { WP_CLI::error( $result->get_error_message() ); } elseif ( ! $result ) { if ( 'add' === $method ) { WP_CLI::error( "Couldn't add menu item." ); } elseif ( 'update' === $method ) { WP_CLI::error( "Couldn't update menu item." ); } } else { if ( ( 'add' === $method ) && $menu_item_args['menu-item-position'] ) { $this->reorder_menu_items( $menu->term_id, $menu_item_args['menu-item-position'], +1, $result ); } /* * Set the menu * * wp_update_nav_menu_item() should take care of this, but * depends on wp_insert_post()'s "tax_input" argument, which * is ignored if the user can't edit the taxonomy * * @see https://core.trac.wordpress.org/ticket/27113 / if ( ! is_object_in_term( $result, 'nav_menu', (int) $menu->term_id ) ) { wp_set_object_terms( $result, [ (int) $menu->term_id ], 'nav_menu' ); } if ( 'add' === $method && ! empty( $assoc_args['porcelain'] ) ) { WP_CLI::line( $result ); } elseif ( 'add' === $method ) { WP_CLI::success( 'Menu item added.' ); } elseif ( 'update' === $method ) { WP_CLI::success( 'Menu item updated.' ); } } } /* * Move block of items in one nav_menu up or down by incrementing/decrementing their menu_order field. * Expects the menu items to have proper menu_orders (i.e. doesn't fix errors from previous incorrect operations). * * @param int $menu_id ID of the nav_menu * @param int $min_position minimal menu_order to touch * @param int $increment how much to change menu_order: +1 to move down, -1 to move up * @param int $ignore_item_id menu item that should be ignored by the change (e.g. newly created menu item) * @return int number of rows affected */ private function reorder_menu_items( $menu_id, $min_position, $increment, $ignore_item_id = 0 ) { global $wpdb; return $wpdb->query( $wpdb->prepare( "UPDATE $wpdb->posts SET `menu_order`=`menu_order`+(%d) WHERE `menu_order`>=%d AND ID IN (SELECT object_id FROM $wpdb->term_relationships WHERE term_taxonomy_id=%d) AND ID<>%d", (int) $increment, (int) $min_position, (int) $menu_id, (int) $ignore_item_id ) ); } protected function get_formatter( &$assoc_args ) { return new Formatter( $assoc_args, $this->obj_fields ); } }	14.4 KB	2025-05-25 12:40
📄 Menu_Location_Command.php <?php use WP_CLI\Formatter; use WP_CLI\Utils; /** * Assigns, removes, and lists a menu's locations. * * ## EXAMPLES * * # List available menu locations * $ wp menu location list * +----------+-------------------+ * \| location \| description \| * +----------+-------------------+ * \| primary \| Primary Menu \| * \| social \| Social Links Menu \| * +----------+-------------------+ * * # Assign the 'primary-menu' menu to the 'primary' location * $ wp menu location assign primary-menu primary * Success: Assigned location primary to menu primary-menu. * * # Remove the 'primary-menu' menu from the 'primary' location * $ wp menu location remove primary-menu primary * Success: Removed location from menu. / class Menu_Location_Command extends WP_CLI_Command { /* * Lists locations for the current theme. * * ## OPTIONS * * [--format=<format>] * : Render output in a particular format. * --- * default: table * options: * - table * - csv * - json * - count * - yaml * - ids * --- * * ## AVAILABLE FIELDS * * These fields will be displayed by default for each location: * * * name * * description * * ## EXAMPLES * * $ wp menu location list * +----------+-------------------+ * \| location \| description \| * +----------+-------------------+ * \| primary \| Primary Menu \| * \| social \| Social Links Menu \| * +----------+-------------------+ * * @subcommand list / public function list_( $args, $assoc_args ) { $locations = get_registered_nav_menus(); $location_objs = []; foreach ( $locations as $location => $description ) { $location_obj = new stdClass(); $location_obj->location = $location; $location_obj->description = $description; $location_objs[] = $location_obj; } $formatter = new Formatter( $assoc_args, [ 'location', 'description' ] ); if ( 'ids' === $formatter->format ) { $ids = array_map( function ( $o ) { return $o->location; }, $location_objs ); $formatter->display_items( $ids ); } else { $formatter->display_items( $location_objs ); } } /* * Assigns a location to a menu. * * ## OPTIONS * * <menu> * : The name, slug, or term ID for the menu. * * <location> * : Location's slug. * * ## EXAMPLES * * $ wp menu location assign primary-menu primary * Success: Assigned location primary to menu primary-menu. * * @subcommand assign / public function assign( $args, $assoc_args ) { list( $menu, $location ) = $args; $menu_obj = wp_get_nav_menu_object( $menu ); if ( ! $menu_obj ) { WP_CLI::error( "Invalid menu {$menu}." ); } $locations = get_registered_nav_menus(); if ( ! array_key_exists( $location, $locations ) ) { WP_CLI::error( "Invalid location {$location}." ); } $locations = get_nav_menu_locations(); $locations[ $location ] = $menu_obj->term_id; set_theme_mod( 'nav_menu_locations', $locations ); WP_CLI::success( "Assigned location {$location} to menu {$menu}." ); } /* * Removes a location from a menu. * * ## OPTIONS * * <menu> * : The name, slug, or term ID for the menu. * * <location> * : Location's slug. * * ## EXAMPLES * * $ wp menu location remove primary-menu primary * Success: Removed location from menu. * * @subcommand remove */ public function remove( $args, $assoc_args ) { list( $menu, $location ) = $args; $menu = wp_get_nav_menu_object( $menu ); if ( ! $menu \|\| is_wp_error( $menu ) ) { WP_CLI::error( 'Invalid menu.' ); } $locations = get_nav_menu_locations(); if ( Utils\get_flag_value( $locations, $location ) !== $menu->term_id ) { WP_CLI::error( "Menu isn't assigned to location." ); } $locations[ $location ] = 0; set_theme_mod( 'nav_menu_locations', $locations ); WP_CLI::success( 'Removed location from menu.' ); } }	3.95 KB	2025-05-25 12:40
📄 Network_Meta_Command.php <?php use WP_CLI\CommandWithMeta; /** * Gets, adds, updates, deletes, and lists network custom fields. * * ## EXAMPLES * * # Get a list of super-admins * $ wp network meta get 1 site_admins * array ( * 0 => 'supervisor', * ) */ class Network_Meta_Command extends CommandWithMeta { protected $meta_type = 'site'; }	349 B	2025-05-25 12:40
📄 Network_Namespace.php <?php use WP_CLI\Dispatcher\CommandNamespace; /** * Perform network-wide operations. * * ## EXAMPLES * * # Get a list of super-admins * $ wp network meta get 1 site_admins * array ( * 0 => 'supervisor', * ) */ class Network_Namespace extends CommandNamespace { }	298 B	2025-05-25 12:40
📄 Option_Command.php <?php use WP_CLI\Formatter; use WP_CLI\Traverser\RecursiveDataStructureTraverser; use WP_CLI\Utils; /** * Retrieves and sets site options, including plugin and WordPress settings. * * See the [Plugin Settings API](https://developer.wordpress.org/plugins/settings/settings-api/) and the [Theme Options](https://developer.wordpress.org/themes/customize-api/) for more information on adding customized options. * * ## EXAMPLES * * # Get site URL. * $ wp option get siteurl * http://example.com * * # Add option. * $ wp option add my_option foobar * Success: Added 'my_option' option. * * # Update option. * $ wp option update my_option '{"foo": "bar"}' --format=json * Success: Updated 'my_option' option. * * # Delete option. * $ wp option delete my_option * Success: Deleted 'my_option' option. * * @package wp-cli / class Option_Command extends WP_CLI_Command { /* * Gets the value for an option. * * ## OPTIONS * * <key> * : Key for the option. * * [--format=<format>] * : Get value in a particular format. * --- * default: var_export * options: * - var_export * - json * - yaml * --- * * ## EXAMPLES * * # Get option. * $ wp option get home * http://example.com * * # Get blog description. * $ wp option get blogdescription * A random blog description * * # Get blog name * $ wp option get blogname * A random blog name * * # Get admin email. * $ wp option get admin_email * someone@example.com * * # Get option in JSON format. * $ wp option get active_plugins --format=json * {"0":"dynamically-dynamic-sidebar\/dynamically-dynamic-sidebar.php","1":"monster-widget\/monster-widget.php","2":"show-current-template\/show-current-template.php","3":"theme-check\/theme-check.php","5":"wordpress-importer\/wordpress-importer.php"} / public function get( $args, $assoc_args ) { list( $key ) = $args; $value = get_option( $key ); if ( false === $value ) { WP_CLI::error( "Could not get '{$key}' option. Does it exist?" ); } WP_CLI::print_value( $value, $assoc_args ); } /* * Adds a new option value. * * Errors if the option already exists. * * ## OPTIONS * * <key> * : The name of the option to add. * * [<value>] * : The value of the option to add. If omitted, the value is read from STDIN. * * [--format=<format>] * : The serialization format for the value. * --- * default: plaintext * options: * - plaintext * - json * --- * * [--autoload=<autoload>] * : Should this option be automatically loaded. * --- * options: * - 'on' * - 'off' * - 'yes' * - 'no' * --- * * ## EXAMPLES * * # Create an option by reading a JSON file. * $ wp option add my_option --format=json < config.json * Success: Added 'my_option' option. / public function add( $args, $assoc_args ) { $key = $args[0]; $value = WP_CLI::get_value_from_arg_or_stdin( $args, 1 ); $value = WP_CLI::read_value( $value, $assoc_args ); if ( in_array( Utils\get_flag_value( $assoc_args, 'autoload' ), [ 'no', 'off' ], true ) ) { $autoload = 'no'; } else { $autoload = 'yes'; } if ( ! add_option( $key, $value, '', $autoload ) ) { WP_CLI::error( "Could not add option '{$key}'. Does it already exist?" ); } else { WP_CLI::success( "Added '{$key}' option." ); } } /* * Lists options and their values. * * ## OPTIONS * * [--search=<pattern>] * : Use wildcards ( * and ? ) to match option name. * * [--exclude=<pattern>] * : Pattern to exclude. Use wildcards ( * and ? ) to match option name. * * [--autoload=<value>] * : Match only autoload options when value is on, and only not-autoload option when off. * * [--transients] * : List only transients. Use `--no-transients` to ignore all transients. * * [--unserialize] * : Unserialize option values in output. * * [--field=<field>] * : Prints the value of a single field. * * [--fields=<fields>] * : Limit the output to specific object fields. * * [--format=<format>] * : The serialization format for the value. total_bytes displays the total size of matching options in bytes. * --- * default: table * options: * - table * - json * - csv * - count * - yaml * - total_bytes * --- * * [--orderby=<fields>] * : Set orderby which field. * --- * default: option_id * options: * - option_id * - option_name * - option_value * --- * * [--order=<order>] * : Set ascending or descending order. * --- * default: asc * options: * - asc * - desc * --- * * ## AVAILABLE FIELDS * * This field will be displayed by default for each matching option: * * * option_name * * option_value * * These fields are optionally available: * * * autoload * * size_bytes * * ## EXAMPLES * * # Get the total size of all autoload options. * $ wp option list --autoload=on --format=total_bytes * 33198 * * # Find biggest transients. * $ wp option list --search="_transient_" --fields=option_name,size_bytes \| sort -n -k 2 \| tail * option_name size_bytes * _site_transient_timeout_theme_roots 10 * _site_transient_theme_roots 76 * _site_transient_update_themes 181 * _site_transient_update_core 808 * _site_transient_update_plugins 6645 * * # List all options beginning with "i2f_". * $ wp option list --search="i2f_" +-------------+--------------+ * \| option_name \| option_value \| * +-------------+--------------+ * \| i2f_version \| 0.1.0 \| * +-------------+--------------+ * * # Delete all options beginning with "theme_mods_". * $ wp option list --search="theme_mods_" --field=option_name \| xargs -I % wp option delete % Success: Deleted 'theme_mods_twentysixteen' option. * Success: Deleted 'theme_mods_twentyfifteen' option. * Success: Deleted 'theme_mods_twentyfourteen' option. * * @subcommand list / public function list_( $args, $assoc_args ) { global $wpdb; $pattern = '%'; $exclude = ''; $fields = array( 'option_name', 'option_value' ); $size_query = ',LENGTH(option_value) AS `size_bytes`'; $autoload_query = ''; if ( isset( $assoc_args['search'] ) ) { $pattern = self::esc_like( $assoc_args['search'] ); // substitute wildcards $pattern = str_replace( '', '%', $pattern ); $pattern = str_replace( '?', '_', $pattern ); } if ( isset( $assoc_args['exclude'] ) ) { $exclude = self::esc_like( $assoc_args['exclude'] ); $exclude = str_replace( '', '%', $exclude ); $exclude = str_replace( '?', '_', $exclude ); } if ( isset( $assoc_args['fields'] ) ) { $fields = explode( ',', $assoc_args['fields'] ); } if ( Utils\get_flag_value( $assoc_args, 'format' ) === 'total_bytes' ) { $fields = array( 'size_bytes' ); $size_query = ',SUM(LENGTH(option_value)) AS `size_bytes`'; } if ( isset( $assoc_args['autoload'] ) ) { $autoload = $assoc_args['autoload']; if ( 'on' === $autoload \|\| 'yes' === $autoload ) { $autoload_query = " AND (autoload='on') OR (autoload='yes')"; } elseif ( 'off' === $autoload \|\| 'no' === $autoload ) { $autoload_query = " AND (autoload='off') OR (autoload='no')"; } else { WP_CLI::error( "Value of '--autoload' should be 'on', 'off', 'yes', or 'no'." ); } } // By default we don't want to display transients. $show_transients = Utils\get_flag_value( $assoc_args, 'transients', false ); if ( $show_transients ) { $transients_query = " AND option_name LIKE '\_transient\_%' OR option_name LIKE '\_site\_transient\_%'"; } else { $transients_query = " AND option_name NOT LIKE '\_transient\_%' AND option_name NOT LIKE '\_site\_transient\_%'"; } $where = ''; if ( $pattern ) { $where .= $wpdb->prepare( 'WHERE `option_name` LIKE %s', $pattern ); } if ( $exclude ) { $where .= $wpdb->prepare( ' AND `option_name` NOT LIKE %s', $exclude ); } $where .= $autoload_query . $transients_query; // phpcs:disable WordPress.DB.PreparedSQL -- Hardcoded query parts without user input. $results = $wpdb->get_results( 'SELECT `option_name`,`option_value`,`autoload`' . $size_query . " FROM `$wpdb->options` {$where}" ); // phpcs:enable $orderby = Utils\get_flag_value( $assoc_args, 'orderby' ); $order = Utils\get_flag_value( $assoc_args, 'order' ); // Sort result. if ( 'option_id' !== $orderby ) { usort( $results, function ( $a, $b ) use ( $orderby, $order ) { // Sort array. return 'asc' === $order ? $a->$orderby > $b->$orderby : $a->$orderby < $b->$orderby; } ); } elseif ( 'option_id' === $orderby && 'desc' === $order ) { // Sort by default descending. krsort( $results ); } if ( true === Utils\get_flag_value( $assoc_args, 'unserialize', null ) ) { foreach ( $results as $k => &$v ) { if ( ! empty( $v->option_value ) ) { $v->option_value = maybe_unserialize( $v->option_value ); } } } if ( Utils\get_flag_value( $assoc_args, 'format' ) === 'total_bytes' ) { WP_CLI::line( $results[0]->size_bytes ); } else { $formatter = new Formatter( $assoc_args, $fields ); $formatter->display_items( $results ); } } /* * Updates an option value. * * ## OPTIONS * * <key> * : The name of the option to update. * * [<value>] * : The new value. If omitted, the value is read from STDIN. * * [--autoload=<autoload>] * : Requires WP 4.2. Should this option be automatically loaded. * --- * options: * - 'on' * - 'off' * - 'yes' * - 'no' * --- * * [--format=<format>] * : The serialization format for the value. * --- * default: plaintext * options: * - plaintext * - json * --- * * ## EXAMPLES * * # Update an option by reading from a file. * $ wp option update my_option < value.txt * Success: Updated 'my_option' option. * * # Update one option on multiple sites using xargs. * $ wp site list --field=url \| xargs -n1 -I {} sh -c 'wp --url={} option update my_option my_value' * Success: Updated 'my_option' option. * Success: Updated 'my_option' option. * * # Update site blog name. * $ wp option update blogname "Random blog name" * Success: Updated 'blogname' option. * * # Update site blog description. * $ wp option update blogdescription "Some random blog description" * Success: Updated 'blogdescription' option. * * # Update admin email address. * $ wp option update admin_email someone@example.com * Success: Updated 'admin_email' option. * * # Set the default role. * $ wp option update default_role author * Success: Updated 'default_role' option. * * # Set the timezone string. * $ wp option update timezone_string "America/New_York" * Success: Updated 'timezone_string' option. * * @alias set / public function update( $args, $assoc_args ) { $key = $args[0]; $value = WP_CLI::get_value_from_arg_or_stdin( $args, 1 ); $value = WP_CLI::read_value( $value, $assoc_args ); $autoload = Utils\get_flag_value( $assoc_args, 'autoload' ); if ( ! in_array( $autoload, [ 'on', 'off', 'yes', 'no' ], true ) ) { $autoload = null; } $value = sanitize_option( $key, $value ); // Sanitization WordPress normally performs when getting an option if ( in_array( $key, [ 'siteurl', 'home', 'category_base', 'tag_base' ], true ) ) { $value = untrailingslashit( $value ); } $old_value = sanitize_option( $key, get_option( $key ) ); if ( $value === $old_value && null === $autoload ) { WP_CLI::success( "Value passed for '{$key}' option is unchanged." ); } elseif ( update_option( $key, $value, $autoload ) ) { WP_CLI::success( "Updated '{$key}' option." ); } else { WP_CLI::error( "Could not update option '{$key}'." ); } } /* * Gets the 'autoload' value for an option. * * ## OPTIONS * * <key> * : The name of the option to get 'autoload' of. * * ## EXAMPLES * * # Get the 'autoload' value for an option. * $ wp option get-autoload blogname * yes * * @subcommand get-autoload / public function get_autoload( $args ) { global $wpdb; list( $option ) = $args; $existing = $wpdb->get_row( $wpdb->prepare( "SELECT autoload FROM $wpdb->options WHERE option_name=%s", $option ) ); if ( ! $existing ) { WP_CLI::error( "Could not get '{$option}' option. Does it exist?" ); } WP_CLI::log( $existing->autoload ); } /* * Sets the 'autoload' value for an option. * * ## OPTIONS * * <key> * : The name of the option to set 'autoload' for. * * <autoload> * : Should this option be automatically loaded. * --- * options: * - 'on' * - 'off' * - 'yes' * - 'no' * --- * * ## EXAMPLES * * # Set the 'autoload' value for an option. * $ wp option set-autoload abc_options no * Success: Updated autoload value for 'abc_options' option. * * @subcommand set-autoload / public function set_autoload( $args ) { global $wpdb; list( $option, $autoload ) = $args; $previous = $wpdb->get_row( $wpdb->prepare( "SELECT autoload, option_value FROM $wpdb->options WHERE option_name=%s", $option ) ); if ( ! $previous ) { WP_CLI::error( "Could not get '{$option}' option. Does it exist?" ); } if ( $previous->autoload === $autoload ) { WP_CLI::success( "Autoload value passed for '{$option}' option is unchanged." ); return; } $wpdb->update( $wpdb->options, array( 'autoload' => $autoload ), array( 'option_name' => $option ) ); // Recreate cache refreshing from update_option(). $notoptions = wp_cache_get( 'notoptions', 'options' ); if ( is_array( $notoptions ) && isset( $notoptions[ $option ] ) ) { unset( $notoptions[ $option ] ); wp_cache_set( 'notoptions', $notoptions, 'options' ); } if ( ! defined( 'WP_INSTALLING' ) ) { $alloptions = wp_load_alloptions( true ); if ( isset( $alloptions[ $option ] ) ) { $alloptions[ $option ] = $previous->option_value; wp_cache_set( 'alloptions', $alloptions, 'options' ); } else { wp_cache_set( $option, $previous->option_value, 'options' ); } } WP_CLI::success( "Updated autoload value for '{$option}' option." ); } /* * Deletes an option. * * ## OPTIONS * * <key>... * : Key for the option. * * ## EXAMPLES * * # Delete an option. * $ wp option delete my_option * Success: Deleted 'my_option' option. * * # Delete multiple options. * $ wp option delete option_one option_two option_three * Success: Deleted 'option_one' option. * Success: Deleted 'option_two' option. * Warning: Could not delete 'option_three' option. Does it exist? / public function delete( $args ) { foreach ( $args as $arg ) { if ( ! delete_option( $arg ) ) { WP_CLI::warning( "Could not delete '{$arg}' option. Does it exist?" ); } else { WP_CLI::success( "Deleted '{$arg}' option." ); } } } /* * Gets a nested value from an option. * * ## OPTIONS * * <key> * : The option name. * * <key-path>... * : The name(s) of the keys within the value to locate the value to pluck. * * [--format=<format>] * : The output format of the value. * --- * default: plaintext * options: * - plaintext * - json * - yaml * --- / public function pluck( $args, $assoc_args ) { list( $key ) = $args; $value = get_option( $key ); if ( false === $value ) { WP_CLI::halt( 1 ); } $key_path = array_map( function ( $key ) { if ( is_numeric( $key ) && ( (string) intval( $key ) === $key ) ) { return (int) $key; } return $key; }, array_slice( $args, 1 ) ); $traverser = new RecursiveDataStructureTraverser( $value ); try { $value = $traverser->get( $key_path ); } catch ( Exception $exception ) { die( 1 ); } WP_CLI::print_value( $value, $assoc_args ); } /* * Updates a nested value in an option. * * ## OPTIONS * * <action> * : Patch action to perform. * --- * options: * - insert * - update * - delete * --- * * <key> * : The option name. * * <key-path>... * : The name(s) of the keys within the value to locate the value to patch. * * [<value>] * : The new value. If omitted, the value is read from STDIN. * * [--format=<format>] * : The serialization format for the value. * --- * default: plaintext * options: * - plaintext * - json * --- * * ## EXAMPLES * * # Add 'bar' to the 'foo' key on an option with name 'option_name' * $ wp option patch insert option_name foo bar * Success: Updated 'option_name' option. * * # Update the value of 'foo' key to 'new' on an option with name 'option_name' * $ wp option patch update option_name foo new * Success: Updated 'option_name' option. * * # Set nested value of 'bar' key to value we have in the patch file on an option with name 'option_name'. * $ wp option patch update option_name foo bar < patch * Success: Updated 'option_name' option. * * # Update the value for the key 'not-a-key' which is not exist on an option with name 'option_name'. * $ wp option patch update option_name foo not-a-key new-value * Error: No data exists for key "not-a-key" * * # Update the value for the key 'foo' without passing value on an option with name 'option_name'. * $ wp option patch update option_name foo * Error: Please provide value to update. * * # Delete the nested key 'bar' under 'foo' key on an option with name 'option_name'. * $ wp option patch delete option_name foo bar * Success: Updated 'option_name' option. / public function patch( $args, $assoc_args ) { list( $action, $key ) = $args; $key_path = array_map( function ( $key ) { if ( is_numeric( $key ) && ( (string) intval( $key ) === $key ) ) { return (int) $key; } return $key; }, array_slice( $args, 2 ) ); if ( 'delete' === $action ) { $patch_value = null; } else { $stdin_value = Utils\has_stdin() ? trim( WP_CLI::get_value_from_arg_or_stdin( $args, -1 ) ) : null; if ( ! empty( $stdin_value ) ) { $patch_value = WP_CLI::read_value( $stdin_value, $assoc_args ); } elseif ( count( $key_path ) > 1 ) { $patch_value = WP_CLI::read_value( array_pop( $key_path ), $assoc_args ); } else { $patch_value = null; } if ( null === $patch_value ) { WP_CLI::error( 'Please provide value to update.' ); } } / Need to make a copy of $current_value here as it is modified by reference */ $old_value = sanitize_option( $key, get_option( $key ) ); $current_value = $old_value; if ( is_object( $current_value ) ) { $old_value = clone $current_value; } $traverser = new RecursiveDataStructureTraverser( $current_value ); try { $traverser->$action( $key_path, $patch_value ); } catch ( Exception $exception ) { WP_CLI::error( $exception->getMessage() ); } $patched_value = sanitize_option( $key, $traverser->value() ); if ( $patched_value === $old_value ) { WP_CLI::success( "Value passed for '{$key}' option is unchanged." ); } elseif ( update_option( $key, $patched_value ) ) { WP_CLI::success( "Updated '{$key}' option." ); } else { WP_CLI::error( "Could not update option '{$key}'." ); } } private static function esc_like( $old ) { global $wpdb; // Remove notices in 4.0 and support backwards compatibility if ( method_exists( $wpdb, 'esc_like' ) ) { // 4.0 $old = $wpdb->esc_like( $old ); } else { // phpcs:ignore WordPress.WP.DeprecatedFunctions.like_escapeFound -- called in WordPress 3.9 or less. $old = like_escape( esc_sql( $old ) ); } return $old; } }	19.75 KB	2025-09-06 07:07
📄 Post_Command.php <?php use WP_CLI\CommandWithDBObject; use WP_CLI\Fetchers\Post as PostFetcher; use WP_CLI\Fetchers\User as UserFetcher; use WP_CLI\Utils; /** * Manages posts, content, and meta. * * ## EXAMPLES * * # Create a new post. * $ wp post create --post_type=post --post_title='A sample post' * Success: Created post 123. * * # Update an existing post. * $ wp post update 123 --post_status=draft * Success: Updated post 123. * * # Delete an existing post. * $ wp post delete 123 * Success: Trashed post 123. * * @package wp-cli / class Post_Command extends CommandWithDBObject { protected $obj_type = 'post'; protected $obj_fields = [ 'ID', 'post_title', 'post_name', 'post_date', 'post_status', ]; private $fetcher; public function __construct() { $this->fetcher = new PostFetcher(); } /* * Creates a new post. * * ## OPTIONS * * [--post_author=<post_author>] * : The ID of the user who added the post. Default is the current user ID. * * [--post_date=<post_date>] * : The date of the post. Default is the current time. * * [--post_date_gmt=<post_date_gmt>] * : The date of the post in the GMT timezone. Default is the value of $post_date. * * [--post_content=<post_content>] * : The post content. Default empty. * * [--post_content_filtered=<post_content_filtered>] * : The filtered post content. Default empty. * * [--post_title=<post_title>] * : The post title. Default empty. * * [--post_excerpt=<post_excerpt>] * : The post excerpt. Default empty. * * [--post_status=<post_status>] * : The post status. Default 'draft'. * * [--post_type=<post_type>] * : The post type. Default 'post'. * * [--comment_status=<comment_status>] * : Whether the post can accept comments. Accepts 'open' or 'closed'. Default is the value of 'default_comment_status' option. * * [--ping_status=<ping_status>] * : Whether the post can accept pings. Accepts 'open' or 'closed'. Default is the value of 'default_ping_status' option. * * [--post_password=<post_password>] * : The password to access the post. Default empty. * * [--post_name=<post_name>] * : The post name. Default is the sanitized post title when creating a new post. * * [--from-post=<post_id>] * : Post id of a post to be duplicated. * * [--to_ping=<to_ping>] * : Space or carriage return-separated list of URLs to ping. Default empty. * * [--pinged=<pinged>] * : Space or carriage return-separated list of URLs that have been pinged. Default empty. * * [--post_modified=<post_modified>] * : The date when the post was last modified. Default is the current time. * * [--post_modified_gmt=<post_modified_gmt>] * : The date when the post was last modified in the GMT timezone. Default is the current time. * * [--post_parent=<post_parent>] * : Set this for the post it belongs to, if any. Default 0. * * [--menu_order=<menu_order>] * : The order the post should be displayed in. Default 0. * * [--post_mime_type=<post_mime_type>] * : The mime type of the post. Default empty. * * [--guid=<guid>] * : Global Unique ID for referencing the post. Default empty. * * [--post_category=<post_category>] * : Array of category names, slugs, or IDs. Defaults to value of the 'default_category' option. * * [--tags_input=<tags_input>] * : Array of tag names, slugs, or IDs. Default empty. * * [--tax_input=<tax_input>] * : Array of taxonomy terms keyed by their taxonomy name. Default empty. * * [--meta_input=<meta_input>] * : Array in JSON format of post meta values keyed by their post meta key. Default empty. * * [<file>] * : Read post content from <file>. If this value is present, the * `--post_content` argument will be ignored. * * Passing `-` as the filename will cause post content to * be read from STDIN. * * [--<field>=<value>] * : Associative args for the new post. See wp_insert_post(). * * [--edit] * : Immediately open system's editor to write or edit post content. * * If content is read from a file, from STDIN, or from the `--post_content` * argument, that text will be loaded into the editor. * * [--porcelain] * : Output just the new post id. * * * ## EXAMPLES * * # Create post and schedule for future * $ wp post create --post_type=post --post_title='A future post' --post_status=future --post_date='2030-12-01 07:00:00' * Success: Created post 1921. * * # Create post with content from given file * $ wp post create ./post-content.txt --post_category=201,345 --post_title='Post from file' * Success: Created post 1922. * * # Create a post with multiple meta values. * $ wp post create --post_title='A post' --post_content='Just a small post.' --meta_input='{"key1":"value1","key2":"value2"}' * Success: Created post 1923. * * # Create a duplicate post from existing posts. * $ wp post create --from-post=123 --post_title='Different Title' * Success: Created post 2350. / public function create( $args, $assoc_args ) { if ( ! empty( $args[0] ) ) { $assoc_args['post_content'] = $this->read_from_file_or_stdin( $args[0] ); } if ( Utils\get_flag_value( $assoc_args, 'edit' ) ) { $input = Utils\get_flag_value( $assoc_args, 'post_content', '' ); $output = $this->_edit( $input, 'WP-CLI: New Post' ); if ( $output ) { $assoc_args['post_content'] = $output; } else { $assoc_args['post_content'] = $input; } } if ( isset( $assoc_args['post_category'] ) ) { $assoc_args['post_category'] = $this->get_category_ids( $assoc_args['post_category'] ); } if ( isset( $assoc_args['meta_input'] ) && Utils\wp_version_compare( '4.4', '<' ) ) { WP_CLI::warning( "The 'meta_input' field was only introduced in WordPress 4.4 so will have no effect." ); } $array_arguments = [ 'meta_input' ]; $assoc_args = Utils\parse_shell_arrays( $assoc_args, $array_arguments ); if ( isset( $assoc_args['from-post'] ) ) { $post = $this->fetcher->get_check( $assoc_args['from-post'] ); $post_arr = get_object_vars( $post ); $post_id = $post_arr['ID']; unset( $post_arr['post_date'] ); unset( $post_arr['post_date_gmt'] ); unset( $post_arr['guid'] ); unset( $post_arr['ID'] ); if ( empty( $assoc_args['meta_input'] ) ) { $assoc_args['meta_input'] = $this->get_metadata( $post_id ); } if ( empty( $assoc_args['post_category'] ) ) { $post_arr['post_category'] = $this->get_category( $post_id ); } if ( empty( $assoc_args['tags_input'] ) ) { $post_arr['tags_input'] = $this->get_tags( $post_id ); } $assoc_args = array_merge( $post_arr, $assoc_args ); } $assoc_args = wp_slash( $assoc_args ); parent::_create( $args, $assoc_args, function ( $params ) { return wp_insert_post( $params, true ); } ); } /* * Updates one or more existing posts. * * ## OPTIONS * * <id>... * : One or more IDs of posts to update. * * [--post_author=<post_author>] * : The ID of the user who added the post. Default is the current user ID. * * [--post_date=<post_date>] * : The date of the post. Default is the current time. * * [--post_date_gmt=<post_date_gmt>] * : The date of the post in the GMT timezone. Default is the value of $post_date. * * [--post_content=<post_content>] * : The post content. Default empty. * * [--post_content_filtered=<post_content_filtered>] * : The filtered post content. Default empty. * * [--post_title=<post_title>] * : The post title. Default empty. * * [--post_excerpt=<post_excerpt>] * : The post excerpt. Default empty. * * [--post_status=<post_status>] * : The post status. Default 'draft'. * * [--post_type=<post_type>] * : The post type. Default 'post'. * * [--comment_status=<comment_status>] * : Whether the post can accept comments. Accepts 'open' or 'closed'. Default is the value of 'default_comment_status' option. * * [--ping_status=<ping_status>] * : Whether the post can accept pings. Accepts 'open' or 'closed'. Default is the value of 'default_ping_status' option. * * [--post_password=<post_password>] * : The password to access the post. Default empty. * * [--post_name=<post_name>] * : The post name. Default is the sanitized post title when creating a new post. * * [--to_ping=<to_ping>] * : Space or carriage return-separated list of URLs to ping. Default empty. * * [--pinged=<pinged>] * : Space or carriage return-separated list of URLs that have been pinged. Default empty. * * [--post_modified=<post_modified>] * : The date when the post was last modified. Default is the current time. * * [--post_modified_gmt=<post_modified_gmt>] * : The date when the post was last modified in the GMT timezone. Default is the current time. * * [--post_parent=<post_parent>] * : Set this for the post it belongs to, if any. Default 0. * * [--menu_order=<menu_order>] * : The order the post should be displayed in. Default 0. * * [--post_mime_type=<post_mime_type>] * : The mime type of the post. Default empty. * * [--guid=<guid>] * : Global Unique ID for referencing the post. Default empty. * * [--post_category=<post_category>] * : Array of category names, slugs, or IDs. Defaults to value of the 'default_category' option. * * [--tags_input=<tags_input>] * : Array of tag names, slugs, or IDs. Default empty. * * [--tax_input=<tax_input>] * : Array of taxonomy terms keyed by their taxonomy name. Default empty. * * [--meta_input=<meta_input>] * : Array in JSON format of post meta values keyed by their post meta key. Default empty. * * [<file>] * : Read post content from <file>. If this value is present, the * `--post_content` argument will be ignored. * * Passing `-` as the filename will cause post content to * be read from STDIN. * * --<field>=<value> * : One or more fields to update. See wp_insert_post(). * * [--defer-term-counting] * : Recalculate term count in batch, for a performance boost. * * ## EXAMPLES * * $ wp post update 123 --post_name=something --post_status=draft * Success: Updated post 123. * * # Update a post with multiple meta values. * $ wp post update 123 --meta_input='{"key1":"value1","key2":"value2"}' * Success: Updated post 123. * * # Update multiple posts at once. * $ wp post update 123 456 --post_author=789 * Success: Updated post 123. * Success: Updated post 456. * * # Update all posts of a given post type at once. * $ wp post update $(wp post list --post_type=page --format=ids) --post_author=123 * Success: Updated post 123. * Success: Updated post 456. / public function update( $args, $assoc_args ) { foreach ( $args as $key => $arg ) { if ( is_numeric( $arg ) ) { continue; } $assoc_args['post_content'] = $this->read_from_file_or_stdin( $arg ); unset( $args[ $key ] ); break; } if ( isset( $assoc_args['post_category'] ) ) { $assoc_args['post_category'] = $this->get_category_ids( $assoc_args['post_category'] ); } if ( isset( $assoc_args['meta_input'] ) && Utils\wp_version_compare( '4.4', '<' ) ) { WP_CLI::warning( "The 'meta_input' field was only introduced in WordPress 4.4 so will have no effect." ); } $array_arguments = [ 'meta_input' ]; $assoc_args = Utils\parse_shell_arrays( $assoc_args, $array_arguments ); $assoc_args = wp_slash( $assoc_args ); parent::_update( $args, $assoc_args, function ( $params ) { return wp_update_post( $params, true ); } ); } /* * Launches system editor to edit post content. * * ## OPTIONS * * <id> * : The ID of the post to edit. * * ## EXAMPLES * * # Launch system editor to edit post * $ wp post edit 123 / public function edit( $args, $assoc_args ) { $post = $this->fetcher->get_check( $args[0] ); $result = $this->_edit( $post->post_content, "WP-CLI post {$post->ID}" ); if ( false === $result ) { WP_CLI::warning( 'No change made to post content.', 'Aborted' ); } else { $this->update( $args, [ 'post_content' => $result ] ); } } // phpcs:ignore PSR2.Methods.MethodDeclaration.Underscore -- Whitelisting to provide backward compatibility to classes possibly extending this class. protected function _edit( $content, $title ) { // phpcs:ignore WordPress.NamingConventions.PrefixAllGlobals.NonPrefixedHooknameFound -- Calling native WordPress hook. $content = apply_filters( 'the_editor_content', $content ); $output = Utils\launch_editor_for_input( $content, $title ); // phpcs:ignore WordPress.NamingConventions.PrefixAllGlobals.NonPrefixedHooknameFound -- Calling native WordPress hook. return ( is_string( $output ) ) ? apply_filters( 'content_save_pre', $output ) : $output; } /* * Gets details about a post. * * ## OPTIONS * * <id> * : The ID of the post to get. * * [--field=<field>] * : Instead of returning the whole post, returns the value of a single field. * * [--fields=<fields>] * : Limit the output to specific fields. Defaults to all fields. * * [--format=<format>] * : Render output in a particular format. * --- * default: table * options: * - table * - csv * - json * - yaml * --- * * ## EXAMPLES * * # Save the post content to a file * $ wp post get 123 --field=content > file.txt / public function get( $args, $assoc_args ) { $post = $this->fetcher->get_check( $args[0] ); $post_arr = get_object_vars( $post ); unset( $post_arr['filter'] ); if ( ! isset( $post_arr['url'] ) ) { $post_arr['url'] = get_permalink( $post->ID ); } if ( empty( $assoc_args['fields'] ) ) { $assoc_args['fields'] = array_keys( $post_arr ); } $formatter = $this->get_formatter( $assoc_args ); $formatter->display_item( $post_arr ); } /* * Deletes an existing post. * * ## OPTIONS * * <id>... * : One or more IDs of posts to delete. * * [--force] * : Skip the trash bin. * * [--defer-term-counting] * : Recalculate term count in batch, for a performance boost. * * ## EXAMPLES * * # Delete post skipping trash * $ wp post delete 123 --force * Success: Deleted post 123. * * # Delete multiple posts * $ wp post delete 123 456 789 * Success: Trashed post 123. * Success: Trashed post 456. * Success: Trashed post 789. * * # Delete all pages * $ wp post delete $(wp post list --post_type='page' --format=ids) * Success: Trashed post 1164. * Success: Trashed post 1186. * * # Delete all posts in the trash * $ wp post delete $(wp post list --post_status=trash --format=ids) * Success: Deleted post 1268. * Success: Deleted post 1294. / public function delete( $args, $assoc_args ) { $defaults = [ 'force' => false ]; $assoc_args = array_merge( $defaults, $assoc_args ); parent::_delete( $args, $assoc_args, [ $this, 'delete_callback' ] ); } /* * Callback used to delete a post. * * @param $post_id * @param $assoc_args * @return array / protected function delete_callback( $post_id, $assoc_args ) { $status = get_post_status( $post_id ); $post_type = get_post_type( $post_id ); if ( ! $assoc_args['force'] && ( 'post' !== $post_type && 'page' !== $post_type ) ) { return [ 'error', "Posts of type '{$post_type}' do not support being sent to trash.\n" . 'Please use the --force flag to skip trash and delete them permanently.', ]; } if ( ! wp_delete_post( $post_id, $assoc_args['force'] ) ) { return [ 'error', "Failed deleting post {$post_id}." ]; } $action = $assoc_args['force'] \|\| 'trash' === $status \|\| 'revision' === $post_type ? 'Deleted' : 'Trashed'; return [ 'success', "{$action} post {$post_id}." ]; } /* * Gets a list of posts. * * Display posts based on all arguments supported by [WP_Query()](https://developer.wordpress.org/reference/classes/wp_query/). * Only shows post types marked as post by default. * * ## OPTIONS * * [--<field>=<value>] * : One or more args to pass to WP_Query. * * [--field=<field>] * : Prints the value of a single field for each post. * * [--fields=<fields>] * : Limit the output to specific object fields. * * [--format=<format>] * : Render output in a particular format. * --- * default: table * options: * - table * - csv * - ids * - json * - count * - yaml * --- * * ## AVAILABLE FIELDS * * These fields will be displayed by default for each post: * * * ID * * post_title * * post_name * * post_date * * post_status * * These fields are optionally available: * * * post_author * * post_date_gmt * * post_content * * post_excerpt * * comment_status * * ping_status * * post_password * * to_ping * * pinged * * post_modified * * post_modified_gmt * * post_content_filtered * * post_parent * * guid * * menu_order * * post_type * * post_mime_type * * comment_count * * filter * * url * * ## EXAMPLES * * # List post * $ wp post list --field=ID * 568 * 829 * 1329 * 1695 * * # List posts in JSON * $ wp post list --post_type=post --posts_per_page=5 --format=json * [{"ID":1,"post_title":"Hello world!","post_name":"hello-world","post_date":"2015-06-20 09:00:10","post_status":"publish"},{"ID":1178,"post_title":"Markup: HTML Tags and Formatting","post_name":"markup-html-tags-and-formatting","post_date":"2013-01-11 20:22:19","post_status":"draft"}] * * # List all pages * $ wp post list --post_type=page --fields=post_title,post_status * +-------------+-------------+ * \| post_title \| post_status \| * +-------------+-------------+ * \| Sample Page \| publish \| * +-------------+-------------+ * * # List ids of all pages and posts * $ wp post list --post_type=page,post --format=ids * 15 25 34 37 198 * * # List given posts * $ wp post list --post__in=1,3 * +----+--------------+-------------+---------------------+-------------+ * \| ID \| post_title \| post_name \| post_date \| post_status \| * +----+--------------+-------------+---------------------+-------------+ * \| 3 \| Lorem Ipsum \| lorem-ipsum \| 2016-06-01 14:34:36 \| publish \| * \| 1 \| Hello world! \| hello-world \| 2016-06-01 14:31:12 \| publish \| * +----+--------------+-------------+---------------------+-------------+ * * # List given post by a specific author * $ wp post list --author=2 * +----+-------------------+-------------------+---------------------+-------------+ * \| ID \| post_title \| post_name \| post_date \| post_status \| * +----+-------------------+-------------------+---------------------+-------------+ * \| 14 \| New documentation \| new-documentation \| 2021-06-18 21:05:11 \| publish \| * +----+-------------------+-------------------+---------------------+-------------+ * * @subcommand list / public function list_( $args, $assoc_args ) { $formatter = $this->get_formatter( $assoc_args ); $defaults = [ 'posts_per_page' => -1, 'post_status' => 'any', ]; $array_arguments = [ 'date_query', 'tax_query', 'meta_query' ]; $assoc_args = Utils\parse_shell_arrays( $assoc_args, $array_arguments ); $query_args = array_merge( $defaults, $assoc_args ); $query_args = self::process_csv_arguments_to_arrays( $query_args ); if ( isset( $query_args['post_type'] ) && 'any' !== $query_args['post_type'] ) { $query_args['post_type'] = explode( ',', $query_args['post_type'] ); } if ( 'ids' === $formatter->format ) { $query_args['fields'] = 'ids'; $query = new WP_Query( $query_args ); echo implode( ' ', $query->posts ); } elseif ( 'count' === $formatter->format ) { $query_args['fields'] = 'ids'; $query = new WP_Query( $query_args ); $formatter->display_items( $query->posts ); } else { $query = new WP_Query( $query_args ); $posts = array_map( function ( $post ) { $post->url = get_permalink( $post->ID ); return $post; }, $query->posts ); $formatter->display_items( $posts ); } } /* * Generates some posts. * * Creates a specified number of new posts with dummy data. * * ## OPTIONS * * [--count=<number>] * : How many posts to generate? * --- * default: 100 * --- * * [--post_type=<type>] * : The type of the generated posts. * --- * default: post * --- * * [--post_status=<status>] * : The status of the generated posts. * --- * default: publish * --- * * [--post_title=<post_title>] * : The post title. * --- * default: * --- * * [--post_author=<login>] * : The author of the generated posts. * --- * default: * --- * * [--post_date=<yyyy-mm-dd-hh-ii-ss>] * : The date of the post. Default is the current time. * * [--post_date_gmt=<yyyy-mm-dd-hh-ii-ss>] * : The date of the post in the GMT timezone. Default is the value of --post_date. * * [--post_content] * : If set, the command reads the post_content from STDIN. * * [--max_depth=<number>] * : For hierarchical post types, generate child posts down to a certain depth. * --- * default: 1 * --- * * [--format=<format>] * : Render output in a particular format. * --- * default: progress * options: * - progress * - ids * --- * * ## EXAMPLES * * # Generate posts. * $ wp post generate --count=10 --post_type=page --post_date=1999-01-04 * Generating posts 100% [================================================] 0:01 / 0:04 * * # Generate posts with fetched content. * $ curl -N https://loripsum.net/api/5 \| wp post generate --post_content --count=10 * % Total % Received % Xferd Average Speed Time Time Time Current * Dload Upload Total Spent Left Speed * 100 2509 100 2509 0 0 616 0 0:00:04 0:00:04 --:--:-- 616 * Generating posts 100% [================================================] 0:01 / 0:04 * * # Add meta to every generated posts. * $ wp post generate --format=ids \| xargs -d ' ' -I % wp post meta add % foo bar * Success: Added custom field. * Success: Added custom field. * Success: Added custom field. / public function generate( $args, $assoc_args ) { global $wpdb; $defaults = [ 'count' => 100, 'max_depth' => 1, 'post_type' => 'post', 'post_status' => 'publish', 'post_author' => false, 'post_date' => '', 'post_date_gmt' => '', 'post_content' => '', 'post_title' => '', ]; $post_data = array_merge( $defaults, $assoc_args ); $post_data['post_date'] = $this->maybe_convert_hyphenated_date_format( $post_data['post_date'] ); $post_data['post_date_gmt'] = $this->maybe_convert_hyphenated_date_format( $post_data['post_date_gmt'] ); // Add time if the string is a valid date without time. $date = DateTime::createFromFormat( 'Y-m-d', $post_data['post_date'] ); $date = DateTime::createFromFormat( 'Y-m-d', $post_data['post_date'] ); if ( $date && $date->format( 'Y-m-d' ) === $post_data['post_date'] ) { $post_data['post_date'] .= ' 00:00:00'; } $date_gmt = DateTime::createFromFormat( 'Y-m-d', $post_data['post_date_gmt'] ); if ( $date_gmt && $date_gmt->format( 'Y-m-d' ) === $post_data['post_date_gmt'] ) { $post_data['post_date_gmt'] .= ' 00:00:00'; } // In older WordPress versions, wp_insert_post post dates default to the current time when a value is absent. We need to send a value for post_date_gmt if post_date is set and vice versa. if ( ! empty( $post_data['post_date'] ) && empty( $post_data['post_date_gmt'] ) ) { $post_data['post_date_gmt'] = get_gmt_from_date( $post_data['post_date'] ); } if ( ! empty( $post_data['post_date_gmt'] ) && empty( $post_data['post_date'] ) ) { $post_data['post_date'] = get_date_from_gmt( $post_data['post_date_gmt'] ); } if ( ! post_type_exists( $post_data['post_type'] ) ) { WP_CLI::error( "'{$post_data['post_type']}' is not a registered post type." ); } if ( $post_data['post_author'] ) { $user_fetcher = new UserFetcher(); $post_data['post_author'] = $user_fetcher->get_check( $post_data['post_author'] )->ID; } if ( Utils\get_flag_value( $assoc_args, 'post_content' ) ) { if ( ! Utils\has_stdin() ) { WP_CLI::error( 'The parameter `post_content` reads from STDIN.' ); } $post_data['post_content'] = file_get_contents( 'php://stdin' ); } // Get the total number of posts. $total = $wpdb->get_var( $wpdb->prepare( "SELECT COUNT() FROM $wpdb->posts WHERE post_type = %s", $post_data['post_type'] ) ); $label = ! empty( $post_data['post_title'] ) ? $post_data['post_title'] : get_post_type_object( $post_data['post_type'] )->labels->singular_name; $hierarchical = get_post_type_object( $post_data['post_type'] )->hierarchical; $limit = $post_data['count'] + $total; $format = Utils\get_flag_value( $assoc_args, 'format', 'progress' ); $notify = false; if ( 'progress' === $format ) { $notify = Utils\make_progress_bar( 'Generating posts', $post_data['count'] ); } $previous_post_id = 0; $current_depth = 1; $current_parent = 0; for ( $index = $total; $index < $limit; $index++ ) { if ( $hierarchical ) { if ( $this->maybe_make_child() && $current_depth < $post_data['max_depth'] ) { $current_parent = $previous_post_id; ++$current_depth; } elseif ( $this->maybe_reset_depth() ) { $current_depth = 1; $current_parent = 0; } } $args = [ 'post_type' => $post_data['post_type'], 'post_title' => ( ! empty( $post_data['post_title'] ) && $index === $total ) ? $label : "{$label} {$index}", 'post_status' => $post_data['post_status'], 'post_author' => $post_data['post_author'], 'post_parent' => $current_parent, 'post_name' => ! empty( $post_data['post_title'] ) ? sanitize_title( $post_data['post_title'] . ( $index === $total ? '' : "-{$index}" ) ) : "post-{$index}", 'post_date' => $post_data['post_date'], 'post_date_gmt' => $post_data['post_date_gmt'], 'post_content' => $post_data['post_content'], ]; $post_id = wp_insert_post( $args, true ); if ( is_wp_error( $post_id ) ) { WP_CLI::warning( $post_id ); } else { $previous_post_id = $post_id; if ( 'ids' === $format ) { echo $post_id; if ( $index < $limit - 1 ) { echo ' '; } } } if ( 'progress' === $format ) { $notify->tick(); } } if ( 'progress' === $format ) { $notify->finish(); } } /** * Gets the post ID for a given URL. * * ## OPTIONS * * <url> * : The URL of the post to get. * * ## EXAMPLES * * # Get post ID by URL * $ wp post url-to-id https://example.com/?p=1 * 1 * * @subcommand url-to-id / public function url_to_id( $args, $assoc_args ) { $post_id = url_to_postid( $args[0] ); $post = get_post( $post_id ); if ( null === $post ) { WP_CLI::error( "Could not get post with url $args[0]." ); } WP_CLI::print_value( $post_id, $assoc_args ); } private function maybe_make_child() { // 50% chance of making child post. return ( wp_rand( 1, 2 ) === 1 ); } private function maybe_reset_depth() { // 10% chance of resetting to root depth, return ( wp_rand( 1, 10 ) === 7 ); } /* * Read post content from file or STDIN * * @param string $arg Supplied argument * @return string / private function read_from_file_or_stdin( $arg ) { if ( '-' !== $arg ) { $readfile = $arg; if ( ! file_exists( $readfile ) \|\| ! is_file( $readfile ) ) { WP_CLI::error( "Unable to read content from '{$readfile}'." ); } } else { $readfile = 'php://stdin'; } return file_get_contents( $readfile ); } /* * Resolves post_category arg into an array of category ids. * * @param string $arg Supplied argument. * @return array / private function get_category_ids( $arg ) { $categories = explode( ',', $arg ); $category_ids = []; foreach ( $categories as $post_category ) { if ( trim( $post_category ) ) { if ( is_numeric( $post_category ) && (int) $post_category ) { $category_id = category_exists( (int) $post_category ); } else { $category_id = category_exists( $post_category ); } if ( ! $category_id ) { WP_CLI::error( "No such post category '{$post_category}'." ); } $category_ids[] = $category_id; } } // If no category ids found, return exploded array for compat with previous WP-CLI versions. return $category_ids ?: $categories; } /* * Get post metadata. * * @param $post_id ID of the post. * * @return array / private function get_metadata( $post_id ) { $metadata = get_metadata( 'post', $post_id ); $items = []; foreach ( $metadata as $key => $values ) { foreach ( $values as $item_value ) { $item_value = maybe_unserialize( $item_value ); $items[ $key ] = $item_value; } } return $items; } /* * Get Categories of a post. * * @param $post_id ID of the post. * * @return array / private function get_category( $post_id ) { $category_data = get_the_category( $post_id ); $category_arr = []; foreach ( $category_data as $cat ) { array_push( $category_arr, $cat->term_id ); } return $category_arr; } /* * Get Tags of a post. * * @param $post_id ID of the post. * * @return array / private function get_tags( $post_id ) { $tag_data = get_the_tags( $post_id ); $tag_arr = []; if ( $tag_data ) { foreach ( $tag_data as $tag ) { array_push( $tag_arr, $tag->slug ); } } return $tag_arr; } /* * Verifies whether a post exists. * * Displays a success message if the post does exist. * * ## OPTIONS * * <id> * : The ID of the post to check. * * ## EXAMPLES * * # The post exists. * $ wp post exists 1337 * Success: Post with ID 1337 exists. * $ echo $? * 0 * * # The post does not exist. * $ wp post exists 10000 * $ echo $? * 1 / public function exists( $args ) { if ( $this->fetcher->get( $args[0] ) ) { WP_CLI::success( "Post with ID {$args[0]} exists." ); } else { WP_CLI::halt( 1 ); } } /* * Convert a date-time string with a hyphen separator to a space separator. * * @param string $date_string The date-time string to convert. * @return string The converted date-time string. * * Example: * maybe_convert_hyphenated_date_format( "2018-07-05-17:17:17" ); * Returns: "2018-07-05 17:17:17" */ private function maybe_convert_hyphenated_date_format( $date_string ) { // Check if the date string matches the format with the hyphen between date and time. if ( preg_match( '/^(\d{4}-\d{2}-\d{2})-(\d{2}:\d{2}:\d{2})$/', $date_string, $matches ) ) { return $matches[1] . ' ' . $matches[2]; } return $date_string; } }	30.78 KB	2025-09-06 07:07
📄 Post_Meta_Command.php <?php use WP_CLI\CommandWithMeta; use WP_CLI\Fetchers\Post as PostFetcher; /** * Adds, updates, deletes, and lists post custom fields. * * ## EXAMPLES * * # Set post meta * $ wp post meta set 123 _wp_page_template about.php * Success: Updated custom field '_wp_page_template'. * * # Get post meta * $ wp post meta get 123 _wp_page_template * about.php * * # Update post meta * $ wp post meta update 123 _wp_page_template contact.php * Success: Updated custom field '_wp_page_template'. * * # Delete post meta * $ wp post meta delete 123 _wp_page_template * Success: Deleted custom field. / class Post_Meta_Command extends CommandWithMeta { protected $meta_type = 'post'; /* * Check that the post ID exists * * @param int / protected function check_object_id( $object_id ) { $fetcher = new PostFetcher(); $post = $fetcher->get_check( $object_id ); return $post->ID; } /* * Wrapper method for add_metadata that can be overridden in sub classes. * * @param int $object_id ID of the object the metadata is for. * @param string $meta_key Metadata key to use. * @param mixed $meta_value Metadata value. Must be serializable if * non-scalar. * @param bool $unique Optional, default is false. Whether the * specified metadata key should be unique for the * object. If true, and the object already has a * value for the specified metadata key, no change * will be made. * * @return int\|false The meta ID on success, false on failure. / protected function add_metadata( $object_id, $meta_key, $meta_value, $unique = false ) { return add_post_meta( $object_id, $meta_key, $meta_value, $unique ); } /* * Wrapper method for update_metadata that can be overridden in sub classes. * * @param int $object_id ID of the object the metadata is for. * @param string $meta_key Metadata key to use. * @param mixed $meta_value Metadata value. Must be serializable if * non-scalar. * @param mixed $prev_value Optional. If specified, only update existing * metadata entries with the specified value. * Otherwise, update all entries. * * @return int\|bool Meta ID if the key didn't exist, true on successful * update, false on failure. / protected function update_metadata( $object_id, $meta_key, $meta_value, $prev_value = '' ) { return update_post_meta( $object_id, $meta_key, $meta_value, $prev_value ); } /* * Wrapper method for get_metadata that can be overridden in sub classes. * * @param int $object_id ID of the object the metadata is for. * @param string $meta_key Optional. Metadata key. If not specified, * retrieve all metadata for the specified object. * @param bool $single Optional, default is false. If true, return only * the first value of the specified meta_key. This * parameter has no effect if meta_key is not * specified. * * @return mixed Single metadata value, or array of values. / protected function get_metadata( $object_id, $meta_key = '', $single = false ) { return get_post_meta( $object_id, $meta_key, $single ); } /* * Wrapper method for delete_metadata that can be overridden in sub classes. * * @param int $object_id ID of the object metadata is for * @param string $meta_key Metadata key * @param mixed $meta_value Optional. Metadata value. Must be serializable * if non-scalar. If specified, only delete * metadata entries with this value. Otherwise, * delete all entries with the specified meta_key. * Pass `null, `false`, or an empty string to skip * this check. For backward compatibility, it is * not possible to pass an empty string to delete * those entries with an empty string for a value. * * @return bool True on successful delete, false on failure. / protected function delete_metadata( $object_id, $meta_key, $meta_value = '' ) { return delete_post_meta( $object_id, $meta_key, $meta_value ); } /* * Cleans up duplicate post meta values on a post. * * ## OPTIONS * * <id> * : ID of the post to clean. * * <key> * : Meta key to clean up. * * ## EXAMPLES * * # Delete duplicate post meta. * wp post meta clean-duplicates 1234 enclosure * Success: Cleaned up duplicate 'enclosure' meta values. * * @subcommand clean-duplicates / public function clean_duplicates( $args, $assoc_args ) { global $wpdb; list( $post_id, $key ) = $args; $metas = $wpdb->get_results( $wpdb->prepare( "SELECT FROM {$wpdb->postmeta} WHERE meta_key=%s AND post_id=%d", $key, $post_id ) ); if ( empty( $metas ) ) { WP_CLI::error( sprintf( 'No meta values found for \'%s\'.', $key ) ); } $uniq_metas = array(); $dupe_metas = array(); foreach ( $metas as $meta ) { if ( ! isset( $uniq_metas[ $meta->meta_value ] ) ) { $uniq_metas[ $meta->meta_value ] = (int) $meta->meta_id; } else { $dupe_metas[] = (int) $meta->meta_id; } } if ( count( $dupe_metas ) ) { WP_CLI::confirm( sprintf( 'Are you sure you want to delete %d duplicate meta values and keep %d valid meta value?', count( $dupe_metas ), count( $uniq_metas ) ) ); foreach ( $dupe_metas as $meta_id ) { delete_metadata_by_mid( 'post', $meta_id ); WP_CLI::log( sprintf( 'Deleted meta id %d.', $meta_id ) ); } WP_CLI::success( sprintf( 'Cleaned up duplicate \'%s\' meta values.', $key ) ); } else { WP_CLI::success( sprintf( 'Nothing to clean up: found %d valid meta value and %d duplicates.', count( $uniq_metas ), count( $dupe_metas ) ) ); } } }	6.03 KB	2025-05-25 12:40
📄 Post_Term_Command.php <?php use WP_CLI\CommandWithTerms; use WP_CLI\Fetchers\Post as PostFetcher; /** * Adds, updates, removes, and lists post terms. * * ## EXAMPLES * * # Set category post term `test` to the post ID 123 * $ wp post term set 123 test category * Success: Set term. * * # Set category post terms `test` and `apple` to the post ID 123 * $ wp post term set 123 test apple category * Success: Set terms. * * # List category post terms for the post ID 123 * $ wp post term list 123 category --fields=term_id,slug * +---------+-------+ * \| term_id \| slug \| * +---------+-------+ * \| 2 \| apple \| * \| 3 \| test \| * +----------+------+ * * # Remove category post terms `test` and `apple` for the post ID 123 * $ wp post term remove 123 category test apple * Success: Removed terms. * */ class Post_Term_Command extends CommandWithTerms { protected $obj_type = 'post'; private $fetcher; public function __construct() { $this->fetcher = new PostFetcher(); } protected function get_object_type() { $post = $this->fetcher->get_check( $this->get_obj_id() ); return $post->post_type; } }	1.16 KB	2025-05-25 12:40
📄 Post_Type_Command.php <?php use WP_CLI\Formatter; /** * Retrieves details on the site's registered post types. * * Get information on WordPress' built-in and the site's [custom post types](https://developer.wordpress.org/plugins/post-types/). * * ## EXAMPLES * * # Get details about a post type * $ wp post-type get page --fields=name,label,hierarchical --format=json * {"name":"page","label":"Pages","hierarchical":true} * * # List post types with 'post' capability type * $ wp post-type list --capability_type=post --fields=name,public * +---------------+--------+ * \| name \| public \| * +---------------+--------+ * \| post \| 1 \| * \| attachment \| 1 \| * \| revision \| \| * \| nav_menu_item \| \| * +---------------+--------+ * * @package wp-cli / class Post_Type_Command extends WP_CLI_Command { private $fields = array( 'name', 'label', 'description', 'hierarchical', 'public', 'capability_type', ); /* * Gets the post counts for each supplied post type. * * @param array $post_types Post types to fetch counts for. * @return array Associative array of post counts keyed by post type. / protected function get_counts( $post_types ) { global $wpdb; if ( count( $post_types ) <= 0 ) { return []; } $query = $wpdb->prepare( "SELECT `post_type`, COUNT() AS `count` FROM $wpdb->posts WHERE `post_type` IN (" . implode( ',', array_fill( 0, count( $post_types ), '%s' ) ) . ') GROUP BY `post_type`', $post_types ); // phpcs:ignore WordPress.DB.PreparedSQL.NotPrepared -- $query is already prepared above. $counts = $wpdb->get_results( $query ); // Make sure there's a count for every item. $counts = array_merge( array_fill_keys( $post_types, 0 ), wp_list_pluck( $counts, 'count', 'post_type' ) ); return $counts; } /** * Lists registered post types. * * ## OPTIONS * * [--<field>=<value>] * : Filter by one or more fields (see get_post_types() first parameter for a list of available fields). * * [--field=<field>] * : Prints the value of a single field for each post type. * * [--fields=<fields>] * : Limit the output to specific post type fields. * * [--format=<format>] * : Render output in a particular format. * --- * default: table * options: * - table * - csv * - json * - count * - yaml * --- * * ## AVAILABLE FIELDS * * These fields will be displayed by default for each post type: * * * name * * label * * description * * hierarchical * * public * * capability_type * * These fields are optionally available: * * * count * * ## EXAMPLES * * # List registered post types * $ wp post-type list --format=csv * name,label,description,hierarchical,public,capability_type * post,Posts,,,1,post * page,Pages,,1,1,page * attachment,Media,,,1,post * revision,Revisions,,,,post * nav_menu_item,"Navigation Menu Items",,,,post * * # List post types with 'post' capability type * $ wp post-type list --capability_type=post --fields=name,public * +---------------+--------+ * \| name \| public \| * +---------------+--------+ * \| post \| 1 \| * \| attachment \| 1 \| * \| revision \| \| * \| nav_menu_item \| \| * +---------------+--------+ * * @subcommand list / public function list_( $args, $assoc_args ) { $formatter = $this->get_formatter( $assoc_args ); $fields = $formatter->fields; $types = get_post_types( $assoc_args, 'objects' ); $counts = []; if ( count( $types ) > 0 && in_array( 'count', $fields, true ) ) { $counts = $this->get_counts( wp_list_pluck( $types, 'name' ) ); } $types = array_map( function ( $type ) use ( $counts ) { $type->count = isset( $counts[ $type->name ] ) ? $counts[ $type->name ] : 0; return $type; }, $types ); $formatter->display_items( $types ); } /* * Gets details about a registered post type. * * ## OPTIONS * * <post-type> * : Post type slug * * [--field=<field>] * : Instead of returning the whole taxonomy, returns the value of a single field. * * [--fields=<fields>] * : Limit the output to specific fields. Defaults to all fields. * * [--format=<format>] * : Render output in a particular format. * --- * default: table * options: * - table * - csv * - json * - yaml * --- * * ## AVAILABLE FIELDS * * These fields will be displayed by default for the specified post type: * * * name * * label * * description * * hierarchical * * public * * capability_type * * labels * * cap * * supports * * These fields are optionally available: * * * count * * ## EXAMPLES * * # Get details about the 'page' post type. * $ wp post-type get page --fields=name,label,hierarchical --format=json * {"name":"page","label":"Pages","hierarchical":true} */ public function get( $args, $assoc_args ) { $post_type = get_post_type_object( $args[0] ); if ( ! $post_type ) { WP_CLI::error( "Post type {$args[0]} doesn't exist." ); } if ( empty( $assoc_args['fields'] ) ) { $default_fields = array_merge( $this->fields, array( 'labels', 'cap', 'supports', ) ); $assoc_args['fields'] = $default_fields; } $formatter = $this->get_formatter( $assoc_args ); $fields = $formatter->fields; $count = 0; if ( in_array( 'count', $fields, true ) ) { $count = $this->get_counts( [ $post_type->name ] ); $count = $count[ $post_type->name ]; } $data = array( 'name' => $post_type->name, 'label' => $post_type->label, 'description' => $post_type->description, 'hierarchical' => $post_type->hierarchical, 'public' => $post_type->public, 'capability_type' => $post_type->capability_type, 'labels' => $post_type->labels, 'cap' => $post_type->cap, 'supports' => get_all_post_type_supports( $post_type->name ), 'count' => $count, ); $formatter->display_item( $data ); } private function get_formatter( &$assoc_args ) { return new Formatter( $assoc_args, $this->fields, 'post-type' ); } }	6.23 KB	2025-05-25 12:40
📄 Signup_Command.php <?php use WP_CLI\CommandWithDBObject; use WP_CLI\Utils; use WP_CLI\Fetchers\Signup as SignupFetcher; /** * Manages signups on a multisite installation. * * ## EXAMPLES * * # List signups. * $ wp user signup list * +-----------+------------+---------------------+---------------------+--------+------------------+ * \| signup_id \| user_login \| user_email \| registered \| active \| activation_key \| * +-----------+------------+---------------------+---------------------+--------+------------------+ * \| 1 \| bobuser \| bobuser@example.com \| 2024-03-13 05:46:53 \| 1 \| 7320b2f009266618 \| * \| 2 \| johndoe \| johndoe@example.com \| 2024-03-13 06:24:44 \| 0 \| 9068d859186cd0b5 \| * +-----------+------------+---------------------+---------------------+--------+------------------+ * * # Activate signup. * $ wp user signup activate 2 * Signup 2 activated. Password: bZFSGsfzb9xs * Success: Activated 1 of 1 signups. * * # Delete signup. * $ wp user signup delete 3 * Signup 3 deleted. * Success: Deleted 1 of 1 signups. * * @package wp-cli / class Signup_Command extends CommandWithDBObject { protected $obj_type = 'signup'; protected $obj_id_key = 'signup_id'; protected $obj_fields = [ 'signup_id', 'user_login', 'user_email', 'registered', 'active', 'activation_key', ]; private $fetcher; public function __construct() { $this->fetcher = new SignupFetcher(); } /* * Lists signups. * * ## OPTIONS * * [--<field>=<value>] * : Filter the list by a specific field. * * [--field=<field>] * : Prints the value of a single field for each signup. * * [--fields=<fields>] * : Limit the output to specific object fields. * * [--format=<format>] * : Render output in a particular format. * --- * default: table * options: * - table * - csv * - ids * - json * - count * - yaml * --- * * [--per_page=<per_page>] * : Limits the signups to the given number. Defaults to none. * * ## AVAILABLE FIELDS * * These fields will be displayed by default for each signup: * * * signup_id * * user_login * * user_email * * registered * * active * * activation_key * * These fields are optionally available: * * * domain * * path * * title * * activated * * meta * * ## EXAMPLES * * # List signup IDs. * $ wp user signup list --field=signup_id * 1 * * # List all signups. * $ wp user signup list * +-----------+------------+---------------------+---------------------+--------+------------------+ * \| signup_id \| user_login \| user_email \| registered \| active \| activation_key \| * +-----------+------------+---------------------+---------------------+--------+------------------+ * \| 1 \| bobuser \| bobuser@example.com \| 2024-03-13 05:46:53 \| 1 \| 7320b2f009266618 \| * \| 2 \| johndoe \| johndoe@example.com \| 2024-03-13 06:24:44 \| 0 \| 9068d859186cd0b5 \| * +-----------+------------+---------------------+---------------------+--------+------------------+ * * @subcommand list * * @package wp-cli / public function list_( $args, $assoc_args ) { global $wpdb; if ( isset( $assoc_args['fields'] ) ) { $assoc_args['fields'] = explode( ',', $assoc_args['fields'] ); } else { $assoc_args['fields'] = $this->obj_fields; } $signups = array(); $per_page = (int) Utils\get_flag_value( $assoc_args, 'per_page' ); $limit = $per_page ? $wpdb->prepare( 'LIMIT %d', $per_page ) : ''; $query = "SELECT FROM $wpdb->signups {$limit}"; // phpcs:ignore WordPress.DB.PreparedSQL.NotPrepared -- Prepared properly above. $results = $wpdb->get_results( $query, ARRAY_A ); if ( $results ) { foreach ( $results as $item ) { // Support features like --active=0. foreach ( array_keys( $item ) as $field ) { if ( isset( $assoc_args[ $field ] ) && $assoc_args[ $field ] !== $item[ $field ] ) { continue 2; } } $signups[] = $item; } } $format = Utils\get_flag_value( $assoc_args, 'format', 'table' ); $formatter = $this->get_formatter( $assoc_args ); if ( 'ids' === $format ) { WP_CLI::line( implode( ' ', wp_list_pluck( $signups, 'signup_id' ) ) ); } else { $formatter->display_items( $signups ); } } /** * Gets details about a signup. * * ## OPTIONS * * <signup> * : The signup ID, user login, user email, or activation key. * * [--field=<field>] * : Instead of returning the whole signup, returns the value of a single field. * * [--fields=<fields>] * : Limit the output to specific fields. Defaults to all fields. * * [--format=<format>] * : Render output in a particular format. * --- * default: table * options: * - table * - csv * - json * - yaml * --- * * ## EXAMPLES * * # Get signup. * $ wp user signup get 1 --field=user_login * bobuser * * # Get signup and export to JSON file. * $ wp user signup get bobuser --format=json > bobuser.json * * @package wp-cli / public function get( $args, $assoc_args ) { $signup = $this->fetcher->get_check( $args[0] ); if ( empty( $assoc_args['fields'] ) ) { $assoc_args['fields'] = array_keys( (array) $signup ); } $formatter = $this->get_formatter( $assoc_args ); $formatter->display_items( array( $signup ) ); } /* * Activates one or more signups. * * ## OPTIONS * * <signup>... * : The signup ID, user login, user email, or activation key of the signup(s) to activate. * * ## EXAMPLES * * # Activate signup. * $ wp user signup activate 2 * Signup 2 activated. Password: bZFSGsfzb9xs * Success: Activated 1 of 1 signups. * * @package wp-cli / public function activate( $args, $assoc_args ) { $signups = $this->fetcher->get_many( $args ); $successes = 0; $errors = 0; foreach ( $signups as $signup ) { $result = wpmu_activate_signup( $signup->activation_key ); if ( is_wp_error( $result ) ) { WP_CLI::warning( "Failed activating signup {$signup->signup_id}." ); ++$errors; } else { WP_CLI::log( "Signup {$signup->signup_id} activated. Password: {$result['password']}" ); ++$successes; } } Utils\report_batch_operation_results( 'signup', 'activate', count( $args ), $successes, $errors ); } /* * Deletes one or more signups. * * ## OPTIONS * * [<signup>...] * : The signup ID, user login, user email, or activation key of the signup(s) to delete. * * [--all] * : If set, all signups will be deleted. * * ## EXAMPLES * * # Delete signup. * $ wp user signup delete 3 * Signup 3 deleted. * Success: Deleted 1 of 1 signups. * * @package wp-cli / public function delete( $args, $assoc_args ) { $count = count( $args ); $all = Utils\get_flag_value( $assoc_args, 'all', false ); if ( ( 0 < $count && true === $all ) \|\| ( 0 === $count && true !== $all ) ) { WP_CLI::error( 'You need to specify either one or more signups or provide the --all flag.' ); } if ( true === $all ) { if ( ! $this->delete_all_signups() ) { WP_CLI::error( 'Error deleting signups.' ); } WP_CLI::success( 'Deleted all signups.' ); WP_CLI::halt( 0 ); } $signups = $this->fetcher->get_many( $args ); $successes = 0; $errors = 0; foreach ( $signups as $signup ) { if ( $this->delete_signup( $signup ) ) { WP_CLI::log( "Signup {$signup->signup_id} deleted." ); ++$successes; } else { WP_CLI::warning( "Failed deleting signup {$signup->signup_id}." ); ++$errors; } } Utils\report_batch_operation_results( 'signup', 'delete', $count, $successes, $errors ); } /* * Deletes signup. * * @param stdClasss $signup * @return bool True if success; otherwise false. / private function delete_signup( $signup ) { global $wpdb; $signup_id = $signup->signup_id; $result = $wpdb->delete( $wpdb->signups, array( 'signup_id' => $signup_id ), array( '%d' ) ); return $result ? true : false; } /* * Deletes all signup. * * @return bool True if success; otherwise false. */ private function delete_all_signups() { global $wpdb; $results = $wpdb->query( 'DELETE FROM ' . $wpdb->signups ); return $results ? true : false; } }	8.26 KB	2025-05-25 12:40
📄 Site_Command.php <?php use WP_CLI\CommandWithDBObject; use WP_CLI\ExitException; use WP_CLI\Fetchers\Site as SiteFetcher; use WP_CLI\Iterators\Query as QueryIterator; use WP_CLI\Iterators\Table as TableIterator; use WP_CLI\Utils; use WP_CLI\Formatter; use WP_CLI\Fetchers\User as UserFetcher; /** * Creates, deletes, empties, moderates, and lists one or more sites on a multisite installation. * * ## EXAMPLES * * # Create site * $ wp site create --slug=example * Success: Site 3 created: www.example.com/example/ * * # Output a simple list of site URLs * $ wp site list --field=url * http://www.example.com/ * http://www.example.com/subdir/ * * # Delete site * $ wp site delete 123 * Are you sure you want to delete the 'http://www.example.com/example' site? [y/n] y * Success: The site at 'http://www.example.com/example' was deleted. * * @package wp-cli / class Site_Command extends CommandWithDBObject { protected $obj_type = 'site'; protected $obj_id_key = 'blog_id'; private $fetcher; public function __construct() { $this->fetcher = new SiteFetcher(); } /* * Delete comments. / private function empty_comments() { global $wpdb; // Empty comments and comment cache $comment_ids = $wpdb->get_col( "SELECT comment_ID FROM $wpdb->comments" ); foreach ( $comment_ids as $comment_id ) { wp_cache_delete( $comment_id, 'comment' ); wp_cache_delete( $comment_id, 'comment_meta' ); } $wpdb->query( "TRUNCATE TABLE $wpdb->comments" ); $wpdb->query( "TRUNCATE TABLE $wpdb->commentmeta" ); } /* * Delete all posts. / private function empty_posts() { global $wpdb; // Empty posts and post cache $posts_query = "SELECT ID FROM $wpdb->posts"; $posts = new QueryIterator( $posts_query, 10000 ); $taxonomies = get_taxonomies(); while ( $posts->valid() ) { $post_id = $posts->current()->ID; wp_cache_delete( $post_id, 'posts' ); wp_cache_delete( $post_id, 'post_meta' ); foreach ( $taxonomies as $taxonomy ) { wp_cache_delete( $post_id, "{$taxonomy}_relationships" ); } wp_cache_delete( $wpdb->blogid . '-' . $post_id, 'global-posts' ); $posts->next(); } $wpdb->query( "TRUNCATE TABLE $wpdb->posts" ); $wpdb->query( "TRUNCATE TABLE $wpdb->postmeta" ); } /* * Delete terms, taxonomies, and tax relationships. / private function empty_taxonomies() { global $wpdb; // Empty taxonomies and terms $terms = $wpdb->get_results( "SELECT term_id, taxonomy FROM $wpdb->term_taxonomy" ); $taxonomies = []; foreach ( (array) $terms as $term ) { $taxonomies[] = $term->taxonomy; wp_cache_delete( $term->term_id, $term->taxonomy ); } $taxonomies = array_unique( $taxonomies ); $cleaned = []; foreach ( $taxonomies as $taxonomy ) { if ( isset( $cleaned[ $taxonomy ] ) ) { continue; } $cleaned[ $taxonomy ] = true; wp_cache_delete( 'all_ids', $taxonomy ); wp_cache_delete( 'get', $taxonomy ); delete_option( "{$taxonomy}_children" ); } $wpdb->query( "TRUNCATE TABLE $wpdb->terms" ); $wpdb->query( "TRUNCATE TABLE $wpdb->term_taxonomy" ); $wpdb->query( "TRUNCATE TABLE $wpdb->term_relationships" ); if ( ! empty( $wpdb->termmeta ) ) { $wpdb->query( "TRUNCATE TABLE $wpdb->termmeta" ); } } /* * Delete all links, link_category terms, and related cache. / private function empty_links() { global $wpdb; // Remove links and related cached data. $links_query = "SELECT link_id FROM {$wpdb->links}"; $links = new QueryIterator( $links_query, 10000 ); // Remove bookmarks cache group. wp_cache_delete( 'get_bookmarks', 'bookmark' ); while ( $links->valid() ) { $link_id = $links->current()->link_id; // Remove cache for the link. wp_delete_object_term_relationships( $link_id, 'link_category' ); wp_cache_delete( $link_id, 'bookmark' ); clean_object_term_cache( $link_id, 'link' ); $links->next(); } // Empty the table once link related cache and term is removed. $wpdb->query( "TRUNCATE TABLE {$wpdb->links}" ); } /* * Insert default terms. / private function insert_default_terms() { global $wpdb; // Default category $cat_name = __( 'Uncategorized' ); / translators: Default category slug / $cat_slug = sanitize_title( _x( 'Uncategorized', 'Default category slug' ) ); // phpcs:ignore WordPress.WP.DeprecatedFunctions.global_terms_enabledFound -- Required for backwards compatibility. if ( global_terms_enabled() ) { $cat_id = $wpdb->get_var( $wpdb->prepare( "SELECT cat_ID FROM {$wpdb->sitecategories} WHERE category_nicename = %s", $cat_slug ) ); if ( null === $cat_id ) { $wpdb->insert( $wpdb->sitecategories, [ 'cat_ID' => 0, 'cat_name' => $cat_name, 'category_nicename' => $cat_slug, 'last_updated' => current_time( 'mysql', true ), ] ); $cat_id = $wpdb->insert_id; } update_option( 'default_category', $cat_id ); } else { $cat_id = 1; } $wpdb->insert( $wpdb->terms, [ 'term_id' => $cat_id, 'name' => $cat_name, 'slug' => $cat_slug, 'term_group' => 0, ] ); $wpdb->insert( $wpdb->term_taxonomy, [ 'term_id' => $cat_id, 'taxonomy' => 'category', 'description' => '', 'parent' => 0, 'count' => 0, ] ); } /* * Reset option values to default. / private function reset_options() { // Reset Privacy Policy value to prevent error. update_option( 'wp_page_for_privacy_policy', 0 ); // Reset sticky posts option. update_option( 'sticky_posts', [] ); } /* * Empties a site of its content (posts, comments, terms, and meta). * * Truncates posts, comments, and terms tables to empty a site of its * content. Doesn't affect site configuration (options) or users. * * If running a persistent object cache, make sure to flush the cache * after emptying the site, as the cache values will be invalid otherwise. * * To also empty custom database tables, you'll need to hook into command * execution: * * ``` * WP_CLI::add_hook( 'after_invoke:site empty', function(){ * global $wpdb; * foreach( array( 'p2p', 'p2pmeta' ) as $table ) { * $table = $wpdb->$table; * $wpdb->query( "TRUNCATE $table" ); * } * }); * ``` * * ## OPTIONS * * [--uploads] * : Also delete all files in the site's uploads directory. * * [--yes] * : Proceed to empty the site without a confirmation prompt. * * ## EXAMPLES * * $ wp site empty * Are you sure you want to empty the site at http://www.example.com of all posts, links, comments, and terms? [y/n] y * Success: The site at 'http://www.example.com' was emptied. * * @subcommand empty / public function empty_( $args, $assoc_args ) { $upload_message = ''; if ( Utils\get_flag_value( $assoc_args, 'uploads' ) ) { $upload_message = ', and delete its uploads directory'; } WP_CLI::confirm( "Are you sure you want to empty the site at '" . site_url() . "' of all posts, links, comments, and terms" . $upload_message . '?', $assoc_args ); $this->empty_posts(); $this->empty_links(); $this->empty_comments(); $this->empty_taxonomies(); $this->insert_default_terms(); $this->reset_options(); if ( ! empty( $upload_message ) ) { $upload_dir = wp_upload_dir(); $files = new RecursiveIteratorIterator( new RecursiveDirectoryIterator( $upload_dir['basedir'], RecursiveDirectoryIterator::SKIP_DOTS ), RecursiveIteratorIterator::CHILD_FIRST ); $files_to_unlink = []; $directories_to_delete = []; $is_main_site = is_main_site(); foreach ( $files as $fileinfo ) { $realpath = $fileinfo->getRealPath(); // Don't clobber subsites when operating on the main site if ( $is_main_site && false !== stripos( $realpath, '/sites/' ) ) { continue; } if ( $fileinfo->isDir() ) { $directories_to_delete[] = $realpath; } else { $files_to_unlink[] = $realpath; } } foreach ( $files_to_unlink as $file ) { unlink( $file ); } foreach ( $directories_to_delete as $directory ) { // Directory could be main sites directory '/sites' which may be non-empty. @rmdir( $directory ); } // May be non-empty if '/sites' still around. @rmdir( $upload_dir['basedir'] ); } WP_CLI::success( "The site at '" . site_url() . "' was emptied." ); } /* * Deletes a site in a multisite installation. * * ## OPTIONS * * [<site-id>] * : The id of the site to delete. If not provided, you must set the --slug parameter. * * [--slug=<slug>] * : Path of the site to be deleted. Subdomain on subdomain installs, directory on subdirectory installs. * * [--yes] * : Answer yes to the confirmation message. * * [--keep-tables] * : Delete the blog from the list, but don't drop its tables. * * ## EXAMPLES * * $ wp site delete 123 * Are you sure you want to delete the http://www.example.com/example site? [y/n] y * Success: The site at 'http://www.example.com/example' was deleted. / public function delete( $args, $assoc_args ) { if ( ! is_multisite() ) { WP_CLI::error( 'This is not a multisite installation.' ); } if ( isset( $assoc_args['slug'] ) ) { $blog_id = get_id_from_blogname( $assoc_args['slug'] ); if ( null === $blog_id ) { WP_CLI::error( sprintf( 'Could not find site with slug \'%s\'.', $assoc_args['slug'] ) ); } $blog = get_blog_details( $blog_id ); } else { if ( empty( $args ) ) { WP_CLI::error( 'Need to specify a blog id.' ); } $blog_id = $args[0]; if ( is_main_site( $blog_id ) ) { WP_CLI::error( 'You cannot delete the root site.' ); } $blog = get_blog_details( $blog_id ); } if ( ! $blog ) { WP_CLI::error( 'Site not found.' ); } $site_url = trailingslashit( $blog->siteurl ); WP_CLI::confirm( "Are you sure you want to delete the '{$site_url}' site?", $assoc_args ); wpmu_delete_blog( $blog->blog_id, ! Utils\get_flag_value( $assoc_args, 'keep-tables' ) ); WP_CLI::success( "The site at '{$site_url}' was deleted." ); } /* * Creates a site in a multisite installation. * * ## OPTIONS * * --slug=<slug> * : Path for the new site. Subdomain on subdomain installs, directory on subdirectory installs. * * [--title=<title>] * : Title of the new site. Default: prettified slug. * * [--email=<email>] * : Email for admin user. User will be created if none exists. Assignment to super admin if not included. * * [--network_id=<network-id>] * : Network to associate new site with. Defaults to current network (typically 1). * * [--private] * : If set, the new site will be non-public (not indexed) * * [--porcelain] * : If set, only the site id will be output on success. * * ## EXAMPLES * * $ wp site create --slug=example * Success: Site 3 created: http://www.example.com/example/ / public function create( $args, $assoc_args ) { if ( ! is_multisite() ) { WP_CLI::error( 'This is not a multisite installation.' ); } global $wpdb, $current_site; $base = $assoc_args['slug']; $title = Utils\get_flag_value( $assoc_args, 'title', ucfirst( $base ) ); $email = empty( $assoc_args['email'] ) ? '' : $assoc_args['email']; // Network if ( ! empty( $assoc_args['network_id'] ) ) { $network = $this->get_network( $assoc_args['network_id'] ); if ( false === $network ) { WP_CLI::error( "Network with id {$assoc_args['network_id']} does not exist." ); } } else { $network = $current_site; } $public = ! Utils\get_flag_value( $assoc_args, 'private' ); // Sanitize if ( preg_match( '\|^([a-zA-Z0-9-])+$\|', $base ) ) { $base = strtolower( $base ); } // If not a subdomain install, make sure the domain isn't a reserved word if ( ! is_subdomain_install() ) { $subdirectory_reserved_names = $this->get_subdirectory_reserved_names(); if ( in_array( $base, $subdirectory_reserved_names, true ) ) { WP_CLI::error( 'The following words are reserved and cannot be used as blog names: ' . implode( ', ', $subdirectory_reserved_names ) ); } } // Check for valid email, if not, use the first super admin found // Probably a more efficient way to do this so we dont query for the // User twice if super admin $email = sanitize_email( $email ); if ( empty( $email ) \|\| ! is_email( $email ) ) { $super_admins = get_super_admins(); $email = ''; if ( ! empty( $super_admins ) && is_array( $super_admins ) ) { // Just get the first one $super_login = reset( $super_admins ); $super_user = get_user_by( 'login', $super_login ); if ( $super_user ) { $email = $super_user->user_email; } } } if ( is_subdomain_install() ) { $newdomain = $base . '.' . preg_replace( '\|^www\.\|', '', $current_site->domain ); $path = $current_site->path; } else { $newdomain = $current_site->domain; $path = $current_site->path . $base . '/'; } $user_id = email_exists( $email ); if ( ! $user_id ) { // Create a new user with a random password $password = wp_generate_password( 24, false ); $user_id = wpmu_create_user( $base, $password, $email ); if ( false === $user_id ) { WP_CLI::error( "Can't create user." ); } else { User_Command::wp_new_user_notification( $user_id, $password ); } } $wpdb->hide_errors(); $title = wp_slash( $title ); $id = wpmu_create_blog( $newdomain, $path, $title, $user_id, [ 'public' => $public ], $network->id ); $wpdb->show_errors(); if ( ! is_wp_error( $id ) ) { if ( ! is_super_admin( $user_id ) && ! get_user_option( 'primary_blog', $user_id ) ) { update_user_option( $user_id, 'primary_blog', $id, true ); } } else { WP_CLI::error( $id->get_error_message() ); } if ( Utils\get_flag_value( $assoc_args, 'porcelain' ) ) { WP_CLI::line( $id ); } else { $site_url = trailingslashit( get_site_url( $id ) ); WP_CLI::success( "Site {$id} created: {$site_url}" ); } } /* * Generate some sites. * * Creates a specified number of new sites. * * ## OPTIONS * * [--count=<number>] * : How many sites to generates? * --- * default: 100 * --- * * [--slug=<slug>] * : Path for the new site. Subdomain on subdomain installs, directory on subdirectory installs. * * [--email=<email>] * : Email for admin user. User will be created if none exists. Assignment to super admin if not included. * * [--network_id=<network-id>] * : Network to associate new site with. Defaults to current network (typically 1). * * [--private] * : If set, the new site will be non-public (not indexed) * * [--format=<format>] * : Render output in a particular format. * --- * default: progress * options: * - progress * - ids * --- * * ## EXAMPLES * * # Generate 10 sites. * $ wp site generate --count=10 * Generating sites 100% [================================================] 0:01 / 0:04 / public function generate( $args, $assoc_args ) { if ( ! is_multisite() ) { WP_CLI::error( 'This is not a multisite installation.' ); } global $wpdb, $current_site; $defaults = [ 'count' => 100, 'email' => '', 'network_id' => 1, 'slug' => 'site', ]; $assoc_args = array_merge( $defaults, $assoc_args ); // Base. $base = $assoc_args['slug']; if ( preg_match( '\|^([a-zA-Z0-9-])+$\|', $base ) ) { $base = strtolower( $base ); } $is_subdomain_install = is_subdomain_install(); // If not a subdomain install, make sure the domain isn't a reserved word if ( ! $is_subdomain_install ) { $subdirectory_reserved_names = $this->get_subdirectory_reserved_names(); if ( in_array( $base, $subdirectory_reserved_names, true ) ) { WP_CLI::error( 'The following words are reserved and cannot be used as blog names: ' . implode( ', ', $subdirectory_reserved_names ) ); } } // Network. if ( ! empty( $assoc_args['network_id'] ) ) { $network = $this->get_network( $assoc_args['network_id'] ); if ( false === $network ) { WP_CLI::error( "Network with id {$assoc_args['network_id']} does not exist." ); } } else { $network = $current_site; } // Public. $public = ! Utils\get_flag_value( $assoc_args, 'private' ); // Limit. $limit = $assoc_args['count']; // Email. $email = sanitize_email( $assoc_args['email'] ); if ( empty( $email ) \|\| ! is_email( $email ) ) { $super_admins = get_super_admins(); $email = ''; if ( ! empty( $super_admins ) && is_array( $super_admins ) ) { $super_login = reset( $super_admins ); $super_user = get_user_by( 'login', $super_login ); if ( $super_user ) { $email = $super_user->user_email; } } } $user_id = email_exists( $email ); if ( ! $user_id ) { $password = wp_generate_password( 24, false ); $user_id = wpmu_create_user( $base . '-admin', $password, $email ); if ( false === $user_id ) { WP_CLI::error( "Can't create user." ); } else { User_Command::wp_new_user_notification( $user_id, $password ); } } $format = Utils\get_flag_value( $assoc_args, 'format', 'progress' ); $notify = false; if ( 'progress' === $format ) { $notify = Utils\make_progress_bar( 'Generating sites', $limit ); } for ( $index = 1; $index <= $limit; $index++ ) { $current_base = $base . $index; $title = ucfirst( $base ) . ' ' . $index; if ( $is_subdomain_install ) { $new_domain = $current_base . '.' . preg_replace( '\|^www\.\|', '', $network->domain ); $path = $network->path; } else { $new_domain = $network->domain; $path = $network->path . $current_base . '/'; } $wpdb->hide_errors(); $title = wp_slash( $title ); $id = wpmu_create_blog( $new_domain, $path, $title, $user_id, [ 'public' => $public ], $network->id ); $wpdb->show_errors(); if ( ! is_wp_error( $id ) ) { if ( ! is_super_admin( $user_id ) && ! get_user_option( 'primary_blog', $user_id ) ) { update_user_option( $user_id, 'primary_blog', $id, true ); } } else { WP_CLI::error( $id->get_error_message() ); } if ( 'progress' === $format ) { $notify->tick(); } else { echo $id; if ( $index < $limit - 1 ) { echo ' '; } } } if ( 'progress' === $format ) { $notify->finish(); } } /* * Retrieves a list of reserved site on a sub-directory Multisite installation. * * Works on older WordPress versions where get_subdirectory_reserved_names() does not exist. * * @return string[] Array of reserved names. / private function get_subdirectory_reserved_names() { if ( function_exists( 'get_subdirectory_reserved_names' ) ) { return get_subdirectory_reserved_names(); } $names = array( 'page', 'comments', 'blog', 'files', 'feed', 'wp-admin', 'wp-content', 'wp-includes', 'wp-json', 'embed', ); // phpcs:ignore WordPress.NamingConventions.PrefixAllGlobals.NonPrefixedHooknameFound -- Calling WordPress native hook. return apply_filters( 'subdirectory_reserved_names', $names ); } /* * Gets network data for a given id. * * @param int $network_id * @return bool\|array False if no network found with given id, array otherwise / private function get_network( $network_id ) { global $wpdb; // Load network data $networks = $wpdb->get_results( $wpdb->prepare( "SELECT FROM $wpdb->site WHERE id = %d", $network_id ) ); if ( ! empty( $networks ) ) { // Only care about domain and path which are set here return $networks[0]; } return false; } /** * Lists all sites in a multisite installation. * * ## OPTIONS * * [--network=<id>] * : The network to which the sites belong. * * [--<field>=<value>] * : Filter by one or more fields (see "Available Fields" section). However, * 'url' isn't an available filter, as it comes from 'home' in wp_options. * * [--site__in=<value>] * : Only list the sites with these blog_id values (comma-separated). * * [--site_user=<value>] * : Only list the sites with this user. * * [--field=<field>] * : Prints the value of a single field for each site. * * [--fields=<fields>] * : Comma-separated list of fields to show. * * [--format=<format>] * : Render output in a particular format. * --- * default: table * options: * - table * - csv * - count * - ids * - json * - yaml * --- * * ## AVAILABLE FIELDS * * These fields will be displayed by default for each site: * * * blog_id * * url * * last_updated * * registered * * These fields are optionally available: * * * site_id * * domain * * path * * public * * archived * * mature * * spam * * deleted * * lang_id * * ## EXAMPLES * * # Output a simple list of site URLs * $ wp site list --field=url * http://www.example.com/ * http://www.example.com/subdir/ * * @subcommand list / public function list_( $args, $assoc_args ) { if ( ! is_multisite() ) { WP_CLI::error( 'This is not a multisite installation.' ); } global $wpdb; if ( isset( $assoc_args['fields'] ) ) { $assoc_args['fields'] = preg_split( '/,[ \t]/', $assoc_args['fields'] ); } $defaults = [ 'format' => 'table', 'fields' => [ 'blog_id', 'url', 'last_updated', 'registered' ], ]; $assoc_args = array_merge( $defaults, $assoc_args ); $where = []; $append = ''; $site_cols = [ 'blog_id', 'last_updated', 'registered', 'site_id', 'domain', 'path', 'public', 'archived', 'mature', 'spam', 'deleted', 'lang_id' ]; foreach ( $site_cols as $col ) { if ( isset( $assoc_args[ $col ] ) ) { $where[ $col ] = $assoc_args[ $col ]; } } if ( isset( $assoc_args['site__in'] ) ) { $where['blog_id'] = explode( ',', $assoc_args['site__in'] ); $append = 'ORDER BY FIELD( blog_id, ' . implode( ',', array_map( 'intval', $where['blog_id'] ) ) . ' )'; } if ( isset( $assoc_args['network'] ) ) { $where['site_id'] = $assoc_args['network']; } if ( isset( $assoc_args['site_user'] ) ) { $user = ( new UserFetcher() )->get_check( $assoc_args['site_user'] ); if ( $user ) { $blogs = get_blogs_of_user( $user->ID ); foreach ( $blogs as $blog ) { $where['blog_id'][] = $blog->userblog_id; } } if ( ! isset( $where['blog_id'] ) \|\| empty( $where['blog_id'] ) ) { $formatter = new Formatter( $assoc_args, [], 'site' ); $formatter->display_items( [] ); return; } $append = 'ORDER BY FIELD( blog_id, ' . implode( ',', array_map( 'intval', $where['blog_id'] ) ) . ' )'; } $iterator_args = [ 'table' => $wpdb->blogs, 'where' => $where, 'append' => $append, ]; $iterator = new TableIterator( $iterator_args ); $iterator = Utils\iterator_map( $iterator, function ( $blog ) { $blog->url = trailingslashit( get_home_url( $blog->blog_id ) ); return $blog; } ); if ( ! empty( $assoc_args['format'] ) && 'ids' === $assoc_args['format'] ) { $sites = iterator_to_array( $iterator ); $ids = wp_list_pluck( $sites, 'blog_id' ); $formatter = new Formatter( $assoc_args, null, 'site' ); $formatter->display_items( $ids ); } else { $formatter = new Formatter( $assoc_args, null, 'site' ); $formatter->display_items( $iterator ); } } /** * Archives one or more sites. * * ## OPTIONS * * [<id>...] * : One or more IDs of sites to archive. If not provided, you must set the --slug parameter. * * [--slug=<slug>] * : Path of the site to archive. Subdomain on subdomain installs, directory on subdirectory installs. * * ## EXAMPLES * * $ wp site archive 123 * Success: Site 123 archived. * * $ wp site archive --slug=demo * Success: Site 123 archived. / public function archive( $args, $assoc_args ) { if ( ! $this->check_site_ids_and_slug( $args, $assoc_args ) ) { return; } $ids = $this->get_sites_ids( $args, $assoc_args ); $this->update_site_status( $ids, 'archived', 1 ); } /* * Unarchives one or more sites. * * ## OPTIONS * * [<id>...] * : One or more IDs of sites to unarchive. If not provided, you must set the --slug parameter. * * [--slug=<slug>] * : Path of the site to unarchive. Subdomain on subdomain installs, directory on subdirectory installs. * * ## EXAMPLES * * $ wp site unarchive 123 * Success: Site 123 unarchived. * * $ wp site unarchive --slug=demo * Success: Site 123 unarchived. / public function unarchive( $args, $assoc_args ) { if ( ! $this->check_site_ids_and_slug( $args, $assoc_args ) ) { return; } $ids = $this->get_sites_ids( $args, $assoc_args ); $this->update_site_status( $ids, 'archived', 0 ); } /* * Activates one or more sites. * * ## OPTIONS * * [<id>...] * : One or more IDs of sites to activate. If not provided, you must set the --slug parameter. * * [--slug=<slug>] * : Path of the site to be activated. Subdomain on subdomain installs, directory on subdirectory installs. * * ## EXAMPLES * * $ wp site activate 123 * Success: Site 123 activated. * * $ wp site activate --slug=demo * Success: Site 123 marked as activated. / public function activate( $args, $assoc_args ) { if ( ! $this->check_site_ids_and_slug( $args, $assoc_args ) ) { return; } $ids = $this->get_sites_ids( $args, $assoc_args ); $this->update_site_status( $ids, 'deleted', 0 ); } /* * Deactivates one or more sites. * * ## OPTIONS * * [<id>...] * : One or more IDs of sites to deactivate. If not provided, you must set the --slug parameter. * * [--slug=<slug>] * : Path of the site to be deactivated. Subdomain on subdomain installs, directory on subdirectory installs. * * ## EXAMPLES * * $ wp site deactivate 123 * Success: Site 123 deactivated. * * $ wp site deactivate --slug=demo * Success: Site 123 deactivated. / public function deactivate( $args, $assoc_args ) { if ( ! $this->check_site_ids_and_slug( $args, $assoc_args ) ) { return; } $ids = $this->get_sites_ids( $args, $assoc_args ); $this->update_site_status( $ids, 'deleted', 1 ); } /* * Marks one or more sites as spam. * * ## OPTIONS * * [<id>...] * : One or more IDs of sites to be marked as spam. If not provided, you must set the --slug parameter. * * [--slug=<slug>] * : Path of the site to be marked as spam. Subdomain on subdomain installs, directory on subdirectory installs. * * ## EXAMPLES * * $ wp site spam 123 * Success: Site 123 marked as spam. / public function spam( $args, $assoc_args ) { if ( ! $this->check_site_ids_and_slug( $args, $assoc_args ) ) { return; } $ids = $this->get_sites_ids( $args, $assoc_args ); $this->update_site_status( $ids, 'spam', 1 ); } /* * Removes one or more sites from spam. * * ## OPTIONS * * [<id>...] * : One or more IDs of sites to remove from spam. If not provided, you must set the --slug parameter. * * [--slug=<slug>] * : Path of the site to be removed from spam. Subdomain on subdomain installs, directory on subdirectory installs. * * ## EXAMPLES * * $ wp site unspam 123 * Success: Site 123 removed from spam. * * @subcommand unspam / public function unspam( $args, $assoc_args ) { if ( ! $this->check_site_ids_and_slug( $args, $assoc_args ) ) { return; } $ids = $this->get_sites_ids( $args, $assoc_args ); $this->update_site_status( $ids, 'spam', 0 ); } /* * Sets one or more sites as mature. * * ## OPTIONS * * [<id>...] * : One or more IDs of sites to set as mature. If not provided, you must set the --slug parameter. * * [--slug=<slug>] * : Path of the site to be set as mature. Subdomain on subdomain installs, directory on subdirectory installs. * * ## EXAMPLES * * $ wp site mature 123 * Success: Site 123 marked as mature. * * $ wp site mature --slug=demo * Success: Site 123 marked as mature. / public function mature( $args, $assoc_args ) { if ( ! $this->check_site_ids_and_slug( $args, $assoc_args ) ) { return; } $ids = $this->get_sites_ids( $args, $assoc_args ); $this->update_site_status( $ids, 'mature', 1 ); } /* * Sets one or more sites as immature. * * ## OPTIONS * * [<id>...] * : One or more IDs of sites to set as unmature. If not provided, you must set the --slug parameter. * * [--slug=<slug>] * : Path of the site to be set as unmature. Subdomain on subdomain installs, directory on subdirectory installs. * * ## EXAMPLES * * $ wp site unmature 123 * Success: Site 123 marked as unmature. * * $ wp site unmature --slug=demo * Success: Site 123 marked as unmature. / public function unmature( $args, $assoc_args ) { if ( ! $this->check_site_ids_and_slug( $args, $assoc_args ) ) { return; } $ids = $this->get_sites_ids( $args, $assoc_args ); $this->update_site_status( $ids, 'mature', 0 ); } /* * Sets one or more sites as public. * * ## OPTIONS * * [<id>...] * : One or more IDs of sites to set as public. If not provided, you must set the --slug parameter. * * [--slug=<slug>] * : Path of the site to be set as public. Subdomain on subdomain installs, directory on subdirectory installs. * * ## EXAMPLES * * $ wp site public 123 * Success: Site 123 marked as public. * * $ wp site public --slug=demo * Success: Site 123 marked as public. * * @subcommand public / public function set_public( $args, $assoc_args ) { if ( ! $this->check_site_ids_and_slug( $args, $assoc_args ) ) { return; } $ids = $this->get_sites_ids( $args, $assoc_args ); $this->update_site_status( $ids, 'public', 1 ); } /* * Sets one or more sites as private. * * ## OPTIONS * * [<id>...] * : One or more IDs of sites to set as private. If not provided, you must set the --slug parameter. * * [--slug=<slug>] * : Path of the site to be set as private. Subdomain on subdomain installs, directory on subdirectory installs. * * ## EXAMPLES * * $ wp site private 123 * Success: Site 123 marked as private. * * $ wp site private --slug=demo * Success: Site 123 marked as private. * * @subcommand private / public function set_private( $args, $assoc_args ) { if ( ! $this->check_site_ids_and_slug( $args, $assoc_args ) ) { return; } $ids = $this->get_sites_ids( $args, $assoc_args ); $this->update_site_status( $ids, 'public', 0 ); } private function update_site_status( $ids, $pref, $value ) { $value = (int) $value; switch ( $pref ) { case 'archived': $action = $value ? 'archived' : 'unarchived'; break; case 'deleted': $action = $value ? 'deactivated' : 'activated'; break; case 'mature': $action = $value ? 'marked as mature' : 'marked as unmature'; break; case 'public': $action = $value ? 'marked as public' : 'marked as private'; break; case 'spam': $action = $value ? 'marked as spam' : 'removed from spam'; break; } foreach ( $ids as $site_id ) { $site = $this->fetcher->get_check( $site_id ); if ( is_main_site( $site->blog_id ) ) { WP_CLI::warning( 'You are not allowed to change the main site.' ); continue; } $old_value = (int) get_blog_status( $site->blog_id, $pref ); if ( $value === $old_value ) { WP_CLI::warning( "Site {$site->blog_id} already {$action}." ); continue; } update_blog_status( $site->blog_id, $pref, $value ); WP_CLI::success( "Site {$site->blog_id} {$action}." ); } } /* * Get an array of site IDs from the passed-in arguments or slug parameter. * * @param array $args Passed-in arguments. * @param array $assoc_args Passed-in parameters. * * @return array Site IDs. * @throws ExitException / private function get_sites_ids( $args, $assoc_args ) { $slug = Utils\get_flag_value( $assoc_args, 'slug', false ); if ( $slug ) { $blog_id = get_id_from_blogname( trim( $slug, '/' ) ); if ( null === $blog_id ) { WP_CLI::error( sprintf( 'Could not find site with slug \'%s\'.', $slug ) ); } return [ $blog_id ]; } return $args; } /* * Check that the site IDs or slug are provided. * * @param array $args Passed-in arguments. * @param array $assoc_args Passed-in parameters. * * @return bool * @throws ExitException If neither site ids nor site slug using --slug were provided. */ private function check_site_ids_and_slug( $args, $assoc_args ) { if ( ( empty( $args ) && empty( $assoc_args['slug'] ) ) \|\| ( ! empty( $args ) && ! empty( $assoc_args['slug'] ) ) ) { WP_CLI::error( 'Please specify one or more IDs of sites, or pass the slug for a single site using --slug.' ); } return true; } }	32.41 KB	2025-05-25 12:40
📄 Site_Meta_Command.php <?php use WP_CLI\CommandWithMeta; use WP_CLI\Fetchers\Site as SiteFetcher; /** * Adds, updates, deletes, and lists site custom fields. * * ## EXAMPLES * * # Set site meta * $ wp site meta set 123 bio "Mary is a WordPress developer." * Success: Updated custom field 'bio'. * * # Get site meta * $ wp site meta get 123 bio * Mary is a WordPress developer. * * # Update site meta * $ wp site meta update 123 bio "Mary is an awesome WordPress developer." * Success: Updated custom field 'bio'. * * # Delete site meta * $ wp site meta delete 123 bio * Success: Deleted custom field. / class Site_Meta_Command extends CommandWithMeta { protected $meta_type = 'blog'; /* * Check that the site ID exists * * @param int / protected function check_object_id( $object_id ) { $fetcher = new SiteFetcher(); $site = $fetcher->get_check( $object_id ); return $site->blog_id; } /* * Wrapper method for add_metadata that can be overridden in sub classes. * * @param int $object_id ID of the object the metadata is for. * @param string $meta_key Metadata key to use. * @param mixed $meta_value Metadata value. Must be serializable if * non-scalar. * @param bool $unique Optional, default is false. Whether the * specified metadata key should be unique for the * object. If true, and the object already has a * value for the specified metadata key, no change * will be made. * * @return int\|false The meta ID on success, false on failure. / protected function add_metadata( $object_id, $meta_key, $meta_value, $unique = false ) { return add_site_meta( $object_id, $meta_key, $meta_value, $unique ); } /* * Wrapper method for update_metadata that can be overridden in sub classes. * * @param int $object_id ID of the object the metadata is for. * @param string $meta_key Metadata key to use. * @param mixed $meta_value Metadata value. Must be serializable if * non-scalar. * @param mixed $prev_value Optional. If specified, only update existing * metadata entries with the specified value. * Otherwise, update all entries. * * @return int\|bool Meta ID if the key didn't exist, true on successful * update, false on failure. / protected function update_metadata( $object_id, $meta_key, $meta_value, $prev_value = '' ) { return update_site_meta( $object_id, $meta_key, $meta_value, $prev_value ); } /* * Wrapper method for get_metadata that can be overridden in sub classes. * * @param int $object_id ID of the object the metadata is for. * @param string $meta_key Optional. Metadata key. If not specified, * retrieve all metadata for the specified object. * @param bool $single Optional, default is false. If true, return only * the first value of the specified meta_key. This * parameter has no effect if meta_key is not * specified. * * @return mixed Single metadata value, or array of values. / protected function get_metadata( $object_id, $meta_key = '', $single = false ) { return get_site_meta( $object_id, $meta_key, $single ); } /* * Wrapper method for delete_metadata that can be overridden in sub classes. * * @param int $object_id ID of the object metadata is for * @param string $meta_key Metadata key * @param mixed $meta_value Optional. Metadata value. Must be serializable * if non-scalar. If specified, only delete * metadata entries with this value. Otherwise, * delete all entries with the specified meta_key. * Pass `null, `false`, or an empty string to skip * this check. For backward compatibility, it is * not possible to pass an empty string to delete * those entries with an empty string for a value. * * @return bool True on successful delete, false on failure. */ protected function delete_metadata( $object_id, $meta_key, $meta_value = '' ) { return delete_site_meta( $object_id, $meta_key, $meta_value ); } }	4.39 KB	2025-05-25 12:40
📄 Site_Option_Command.php <?php use WP_CLI\Formatter; use WP_CLI\Traverser\RecursiveDataStructureTraverser; use WP_CLI\Utils; /** * Adds, updates, deletes, and lists site options in a multisite installation. * * ## EXAMPLES * * # Get site registration * $ wp site option get registration * none * * # Add site option * $ wp site option add my_option foobar * Success: Added 'my_option' site option. * * # Update site option * $ wp site option update my_option '{"foo": "bar"}' --format=json * Success: Updated 'my_option' site option. * * # Delete site option * $ wp site option delete my_option * Success: Deleted 'my_option' site option. / class Site_Option_Command extends WP_CLI_Command { /* * Gets a site option. * * ## OPTIONS * * <key> * : Key for the site option. * * [--format=<format>] * : Get value in a particular format. * --- * default: var_export * options: * - var_export * - json * - yaml * --- * * ## EXAMPLES * * # Get site upload filetypes * $ wp site option get upload_filetypes * jpg jpeg png gif mov avi mpg / public function get( $args, $assoc_args ) { list( $key ) = $args; $value = get_site_option( $key ); if ( false === $value ) { WP_CLI::halt( 1 ); } WP_CLI::print_value( $value, $assoc_args ); } /* * Adds a site option. * * ## OPTIONS * * <key> * : The name of the site option to add. * * [<value>] * : The value of the site option to add. If omitted, the value is read from STDIN. * * [--format=<format>] * : The serialization format for the value. * --- * default: plaintext * options: * - plaintext * - json * --- * * ## EXAMPLES * * # Create a site option by reading a JSON file * $ wp site option add my_option --format=json < config.json * Success: Added 'my_option' site option. / public function add( $args, $assoc_args ) { $key = $args[0]; $value = WP_CLI::get_value_from_arg_or_stdin( $args, 1 ); $value = WP_CLI::read_value( $value, $assoc_args ); if ( ! add_site_option( $key, $value ) ) { WP_CLI::error( "Could not add site option '{$key}'. Does it already exist?" ); } else { WP_CLI::success( "Added '{$key}' site option." ); } } /* * Lists site options. * * ## OPTIONS * * [--search=<pattern>] * : Use wildcards ( * and ? ) to match option name. * * [--site_id=<id>] * : Limit options to those of a particular site id. * * [--field=<field>] * : Prints the value of a single field. * * [--fields=<fields>] * : Limit the output to specific object fields. * * [--format=<format>] * : The serialization format for the value. total_bytes displays the total size of matching options in bytes. * --- * default: table * options: * - table * - json * - csv * - count * - yaml * - total_bytes * --- * * ## AVAILABLE FIELDS * * This field will be displayed by default for each matching option: * * * meta_key * * meta_value * * These fields are optionally available: * * * meta_id * * site_id * * size_bytes * * ## EXAMPLES * * # List all site options beginning with "i2f_" * $ wp site option list --search="i2f_" +-------------+--------------+ * \| meta_key \| meta_value \| * +-------------+--------------+ * \| i2f_version \| 0.1.0 \| * +-------------+--------------+ * * @subcommand list / public function list_( $args, $assoc_args ) { global $wpdb; $pattern = '%'; $fields = [ 'meta_key', 'meta_value' ]; $size_query = ',LENGTH(meta_value) AS `size_bytes`'; if ( isset( $assoc_args['search'] ) ) { $pattern = self::esc_like( $assoc_args['search'] ); // substitute wildcards $pattern = str_replace( '', '%', $pattern ); $pattern = str_replace( '?', '_', $pattern ); } if ( isset( $assoc_args['fields'] ) ) { $fields = explode( ',', $assoc_args['fields'] ); } if ( Utils\get_flag_value( $assoc_args, 'format' ) === 'total_bytes' ) { $fields = [ 'size_bytes' ]; $size_query = ',SUM(LENGTH(meta_value)) AS `size_bytes`'; } $query = $wpdb->prepare( 'SELECT `meta_id`, `site_id`, `meta_key`,`meta_value`' . $size_query // phpcs:ignore WordPress.DB.PreparedSQL.NotPrepared -- Hard-coded partial query without user input. . " FROM `$wpdb->sitemeta` WHERE `meta_key` LIKE %s", $pattern ); $site_id = Utils\get_flag_value( $assoc_args, 'site_id' ); if ( $site_id ) { $query .= $wpdb->prepare( ' AND site_id=%d', $site_id ); } // phpcs:ignore WordPress.DB.PreparedSQL.NotPrepared -- $query is already prepared above. $results = $wpdb->get_results( $query ); if ( Utils\get_flag_value( $assoc_args, 'format' ) === 'total_bytes' ) { WP_CLI::line( $results[0]->size_bytes ); } else { $formatter = new Formatter( $assoc_args, $fields ); $formatter->display_items( $results ); } } /** * Updates a site option. * * ## OPTIONS * * <key> * : The name of the site option to update. * * [<value>] * : The new value. If omitted, the value is read from STDIN. * * [--format=<format>] * : The serialization format for the value. * --- * default: plaintext * options: * - plaintext * - json * --- * * ## EXAMPLES * * # Update a site option by reading from a file * $ wp site option update my_option < value.txt * Success: Updated 'my_option' site option. * * @alias set / public function update( $args, $assoc_args ) { $key = $args[0]; $value = WP_CLI::get_value_from_arg_or_stdin( $args, 1 ); $value = WP_CLI::read_value( $value, $assoc_args ); $value = sanitize_option( $key, $value ); $old_value = sanitize_option( $key, get_site_option( $key ) ); if ( $value === $old_value ) { WP_CLI::success( "Value passed for '{$key}' site option is unchanged." ); } elseif ( update_site_option( $key, $value ) ) { WP_CLI::success( "Updated '{$key}' site option." ); } else { WP_CLI::error( "Could not update site option '{$key}'." ); } } /* * Deletes a site option. * * ## OPTIONS * * <key> * : Key for the site option. * * ## EXAMPLES * * $ wp site option delete my_option * Success: Deleted 'my_option' site option. / public function delete( $args ) { list( $key ) = $args; if ( ! delete_site_option( $key ) ) { WP_CLI::error( "Could not delete '{$key}' site option. Does it exist?" ); } else { WP_CLI::success( "Deleted '{$key}' site option." ); } } /* * Gets a nested value from an option. * * ## OPTIONS * * <key> * : The option name. * * <key-path>... * : The name(s) of the keys within the value to locate the value to pluck. * * [--format=<format>] * : The output format of the value. * --- * default: plaintext * options: * - plaintext * - json * - yaml / public function pluck( $args, $assoc_args ) { list( $key ) = $args; $value = get_site_option( $key ); if ( false === $value ) { WP_CLI::halt( 1 ); } $key_path = array_map( function ( $key ) { if ( is_numeric( $key ) && ( (string) intval( $key ) === $key ) ) { return (int) $key; } return $key; }, array_slice( $args, 1 ) ); $traverser = new RecursiveDataStructureTraverser( $value ); try { $value = $traverser->get( $key_path ); } catch ( Exception $exception ) { die( 1 ); } WP_CLI::print_value( $value, $assoc_args ); } /* * Updates a nested value in an option. * * ## OPTIONS * * <action> * : Patch action to perform. * --- * options: * - insert * - update * - delete * --- * * <key> * : The option name. * * <key-path>... * : The name(s) of the keys within the value to locate the value to patch. * * [<value>] * : The new value. If omitted, the value is read from STDIN. * * [--format=<format>] * : The serialization format for the value. * --- * default: plaintext * options: * - plaintext * - json * --- / public function patch( $args, $assoc_args ) { list( $action, $key ) = $args; $key_path = array_map( function ( $key ) { if ( is_numeric( $key ) && ( (string) intval( $key ) === $key ) ) { return (int) $key; } return $key; }, array_slice( $args, 2 ) ); if ( 'delete' === $action ) { $patch_value = null; } else { $stdin_value = Utils\has_stdin() ? trim( WP_CLI::get_value_from_arg_or_stdin( $args, -1 ) ) : null; $patch_value = ! empty( $stdin_value ) ? WP_CLI::read_value( $stdin_value, $assoc_args ) : WP_CLI::read_value( array_pop( $key_path ), $assoc_args ); } / Need to make a copy of $current_value here as it is modified by reference */ $old_value = sanitize_option( $key, get_site_option( $key ) ); $current_value = $old_value; if ( is_object( $current_value ) ) { $old_value = clone $current_value; } $traverser = new RecursiveDataStructureTraverser( $current_value ); try { $traverser->$action( $key_path, $patch_value ); } catch ( Exception $exception ) { WP_CLI::error( $exception->getMessage() ); } $patched_value = sanitize_option( $key, $traverser->value() ); if ( $patched_value === $old_value ) { WP_CLI::success( "Value passed for '{$key}' site option is unchanged." ); } elseif ( update_site_option( $key, $patched_value ) ) { WP_CLI::success( "Updated '{$key}' site option." ); } else { WP_CLI::error( "Could not update site option '{$key}'." ); } } private static function esc_like( $old ) { global $wpdb; // Remove notices in 4.0 and support backwards compatibility if ( method_exists( $wpdb, 'esc_like' ) ) { // 4.0 $old = $wpdb->esc_like( $old ); } else { // phpcs:ignore WordPress.WP.DeprecatedFunctions.like_escapeFound -- called in WordPress 3.9 or less. $old = like_escape( esc_sql( $old ) ); } return $old; } }	9.81 KB	2025-05-25 12:40
📄 Taxonomy_Command.php <?php use WP_CLI\Formatter; use WP_CLI\Utils; /** * Retrieves information about registered taxonomies. * * See references for [built-in taxonomies](https://developer.wordpress.org/themes/basics/categories-tags-custom-taxonomies/) and [custom taxonomies](https://developer.wordpress.org/plugins/taxonomies/working-with-custom-taxonomies/). * * ## EXAMPLES * * # List all taxonomies with 'post' object type. * $ wp taxonomy list --object_type=post --fields=name,public * +-------------+--------+ * \| name \| public \| * +-------------+--------+ * \| category \| 1 \| * \| post_tag \| 1 \| * \| post_format \| 1 \| * +-------------+--------+ * * # Get capabilities of 'post_tag' taxonomy. * $ wp taxonomy get post_tag --field=cap * {"manage_terms":"manage_categories","edit_terms":"manage_categories","delete_terms":"manage_categories","assign_terms":"edit_posts"} * * @package wp-cli / class Taxonomy_Command extends WP_CLI_Command { private $fields = array( 'name', 'label', 'description', 'object_type', 'show_tagcloud', 'hierarchical', 'public', ); public function __construct() { if ( Utils\wp_version_compare( 3.7, '<' ) ) { // remove description for wp <= 3.7 $this->fields = array_values( array_diff( $this->fields, array( 'description' ) ) ); } parent::__construct(); } /* * Gets the term counts for each supplied taxonomy. * * @param array $taxonomies Taxonomies to fetch counts for. * @return array Associative array of term counts keyed by taxonomy. / protected function get_counts( $taxonomies ) { global $wpdb; if ( count( $taxonomies ) <= 0 ) { return []; } $query = $wpdb->prepare( "SELECT `taxonomy`, COUNT() AS `count` FROM $wpdb->term_taxonomy WHERE `taxonomy` IN (" . implode( ',', array_fill( 0, count( $taxonomies ), '%s' ) ) . ') GROUP BY `taxonomy`', $taxonomies ); // phpcs:ignore WordPress.DB.PreparedSQL.NotPrepared -- $query is already prepared above. $counts = $wpdb->get_results( $query ); // Make sure there's a count for every item. $counts = array_merge( array_fill_keys( $taxonomies, 0 ), wp_list_pluck( $counts, 'count', 'taxonomy' ) ); return $counts; } /** * Lists registered taxonomies. * * ## OPTIONS * * [--<field>=<value>] * : Filter by one or more fields (see get_taxonomies() first parameter for a list of available fields). * * [--field=<field>] * : Prints the value of a single field for each taxonomy. * * [--fields=<fields>] * : Limit the output to specific taxonomy fields. * * [--format=<format>] * : Render output in a particular format. * --- * default: table * options: * - table * - csv * - json * - count * - yaml * --- * * ## AVAILABLE FIELDS * * These fields will be displayed by default for each term: * * * name * * label * * description * * object_type * * show_tagcloud * * hierarchical * * public * * These fields are optionally available: * * * count * * ## EXAMPLES * * # List all taxonomies. * $ wp taxonomy list --format=csv * name,label,description,object_type,show_tagcloud,hierarchical,public * category,Categories,,post,1,1,1 * post_tag,Tags,,post,1,,1 * nav_menu,"Navigation Menus",,nav_menu_item,,, * link_category,"Link Categories",,link,1,, * post_format,Format,,post,,,1 * * # List all taxonomies with 'post' object type. * $ wp taxonomy list --object_type=post --fields=name,public * +-------------+--------+ * \| name \| public \| * +-------------+--------+ * \| category \| 1 \| * \| post_tag \| 1 \| * \| post_format \| 1 \| * +-------------+--------+ * * @subcommand list / public function list_( $args, $assoc_args ) { $formatter = $this->get_formatter( $assoc_args ); // Check if it's strict mode or not. $strict = Utils\get_flag_value( $assoc_args, 'strict', false ); unset( $assoc_args['strict'] ); if ( isset( $assoc_args['object_type'] ) ) { $assoc_args['object_type'] = array( $assoc_args['object_type'] ); $taxonomy_object = $assoc_args['object_type']; } else { $taxonomy_object = get_post_types(); } $fields = $formatter->fields; $taxonomies = ( isset( $taxonomy_object ) && ! $strict ) ? get_object_taxonomies( $taxonomy_object, 'objects' ) : get_taxonomies( $assoc_args, 'objects' ); $counts = []; if ( count( $taxonomies ) > 0 && in_array( 'count', $fields, true ) ) { $counts = $this->get_counts( wp_list_pluck( $taxonomies, 'name' ) ); } $taxonomies = array_map( function ( $taxonomy ) use ( $counts ) { $taxonomy->object_type = implode( ', ', $taxonomy->object_type ); $taxonomy->count = isset( $counts[ $taxonomy->name ] ) ? $counts[ $taxonomy->name ] : 0; return $taxonomy; }, $taxonomies ); $formatter->display_items( $taxonomies ); } /* * Gets details about a registered taxonomy. * * ## OPTIONS * * <taxonomy> * : Taxonomy slug. * * [--field=<field>] * : Instead of returning the whole taxonomy, returns the value of a single field. * * [--fields=<fields>] * : Limit the output to specific fields. Defaults to all fields. * * [--format=<format>] * : Render output in a particular format. * --- * default: table * options: * - table * - csv * - json * - yaml * --- * * ## AVAILABLE FIELDS * * These fields will be displayed by default for the specified taxonomy: * * * name * * label * * description * * object_type * * show_tagcloud * * hierarchical * * public * * labels * * cap * * These fields are optionally available: * * * count * * ## EXAMPLES * * # Get details of `category` taxonomy. * $ wp taxonomy get category --fields=name,label,object_type * +-------------+------------+ * \| Field \| Value \| * +-------------+------------+ * \| name \| category \| * \| label \| Categories \| * \| object_type \| ["post"] \| * +-------------+------------+ * * # Get capabilities of 'post_tag' taxonomy. * $ wp taxonomy get post_tag --field=cap * {"manage_terms":"manage_categories","edit_terms":"manage_categories","delete_terms":"manage_categories","assign_terms":"edit_posts"} */ public function get( $args, $assoc_args ) { $taxonomy = get_taxonomy( $args[0] ); if ( ! $taxonomy ) { WP_CLI::error( "Taxonomy {$args[0]} doesn't exist." ); } if ( empty( $assoc_args['fields'] ) ) { $default_fields = array_merge( $this->fields, array( 'labels', 'cap', ) ); $assoc_args['fields'] = $default_fields; } $formatter = $this->get_formatter( $assoc_args ); $fields = $formatter->fields; $count = 0; if ( in_array( 'count', $fields, true ) ) { $count = $this->get_counts( [ $taxonomy->name ] ); $count = $count[ $taxonomy->name ]; } $data = array( 'name' => $taxonomy->name, 'label' => $taxonomy->label, 'description' => $taxonomy->description, 'object_type' => $taxonomy->object_type, 'show_tagcloud' => $taxonomy->show_tagcloud, 'hierarchical' => $taxonomy->hierarchical, 'public' => $taxonomy->public, 'labels' => $taxonomy->labels, 'cap' => $taxonomy->cap, 'count' => $count, ); $formatter->display_item( $data ); } private function get_formatter( &$assoc_args ) { return new Formatter( $assoc_args, $this->fields, 'taxonomy' ); } }	7.52 KB	2025-05-25 12:40
📄 Term_Command.php <?php use WP_CLI\Formatter; use WP_CLI\Utils; /** * Manages taxonomy terms and term meta, with create, delete, and list commands. * * See reference for [taxonomies and their terms](https://codex.wordpress.org/Taxonomies). * * ## EXAMPLES * * # Create a new term. * $ wp term create category Apple --description="A type of fruit" * Success: Created category 199. * * # Get details about a term. * $ wp term get category 199 --format=json --fields=term_id,name,slug,count * {"term_id":199,"name":"Apple","slug":"apple","count":1} * * # Update an existing term. * $ wp term update category 15 --name=Apple * Success: Term updated. * * # Get the term's URL. * $ wp term list post_tag --include=123 --field=url * http://example.com/tag/tips-and-tricks * * # Delete post category * $ wp term delete category 15 * Success: Deleted category 15. * * # Recount posts assigned to each categories and tags * $ wp term recount category post_tag * Success: Updated category term count * Success: Updated post_tag term count * * @package wp-cli / class Term_Command extends WP_CLI_Command { private $fields = [ 'term_id', 'term_taxonomy_id', 'name', 'slug', 'description', 'parent', 'count', ]; /* * Lists terms in a taxonomy. * * ## OPTIONS * * <taxonomy>... * : List terms of one or more taxonomies * * [--<field>=<value>] * : Filter by one or more fields (see get_terms() $args parameter for a list of fields). * * [--field=<field>] * : Prints the value of a single field for each term. * * [--fields=<fields>] * : Limit the output to specific object fields. * * [--format=<format>] * : Render output in a particular format. * --- * default: table * options: * - table * - csv * - ids * - json * - count * - yaml * --- * * ## AVAILABLE FIELDS * * These fields will be displayed by default for each term: * * * term_id * * term_taxonomy_id * * name * * slug * * description * * parent * * count * * These fields are optionally available: * * * url * * ## EXAMPLES * * # List post categories * $ wp term list category --format=csv * term_id,term_taxonomy_id,name,slug,description,parent,count * 2,2,aciform,aciform,,0,1 * 3,3,antiquarianism,antiquarianism,,0,1 * 4,4,arrangement,arrangement,,0,1 * 5,5,asmodeus,asmodeus,,0,1 * * # List post tags * $ wp term list post_tag --fields=name,slug * +-----------+-------------+ * \| name \| slug \| * +-----------+-------------+ * \| 8BIT \| 8bit \| * \| alignment \| alignment-2 \| * \| Articles \| articles \| * \| aside \| aside \| * +-----------+-------------+ * * @subcommand list / public function list_( $args, $assoc_args ) { foreach ( $args as $taxonomy ) { if ( ! taxonomy_exists( $taxonomy ) ) { WP_CLI::error( "Taxonomy {$taxonomy} doesn't exist." ); } } $formatter = $this->get_formatter( $assoc_args ); $defaults = [ 'hide_empty' => false, ]; $assoc_args = array_merge( $defaults, $assoc_args ); if ( ! empty( $assoc_args['term_id'] ) ) { $term = get_term_by( 'id', $assoc_args['term_id'], $args[0] ); $terms = [ $term ]; } elseif ( ! empty( $assoc_args['include'] ) && ! empty( $assoc_args['orderby'] ) && 'include' === $assoc_args['orderby'] && Utils\wp_version_compare( '4.7', '<' ) ) { $terms = []; $term_ids = explode( ',', $assoc_args['include'] ); foreach ( $term_ids as $term_id ) { $term = get_term_by( 'id', $term_id, $args[0] ); if ( $term && ! is_wp_error( $term ) ) { $terms[] = $term; } else { WP_CLI::warning( "Invalid term {$term_id}." ); } } } else { // phpcs:ignore WordPress.WP.DeprecatedParameters.Get_termsParam2Found -- Required for backward compatibility. $terms = get_terms( $args, $assoc_args ); } $terms = array_map( function ( $term ) { $term->count = (int) $term->count; $term->parent = (int) $term->parent; $term->url = get_term_link( $term ); return $term; }, $terms ); if ( 'ids' === $formatter->format ) { $terms = wp_list_pluck( $terms, 'term_id' ); echo implode( ' ', $terms ); } else { $formatter->display_items( $terms ); } } /* * Creates a new term. * * ## OPTIONS * * <taxonomy> * : Taxonomy for the new term. * * <term> * : A name for the new term. * * [--slug=<slug>] * : A unique slug for the new term. Defaults to sanitized version of name. * * [--description=<description>] * : A description for the new term. * * [--parent=<term-id>] * : A parent for the new term. * * [--porcelain] * : Output just the new term id. * * ## EXAMPLES * * # Create a new category "Apple" with a description. * $ wp term create category Apple --description="A type of fruit" * Success: Created category 199. / public function create( $args, $assoc_args ) { list( $taxonomy, $term ) = $args; $defaults = [ 'slug' => sanitize_title( $term ), 'description' => '', 'parent' => 0, ]; $assoc_args = wp_parse_args( $assoc_args, $defaults ); $porcelain = Utils\get_flag_value( $assoc_args, 'porcelain' ); unset( $assoc_args['porcelain'] ); // Compatibility for < WP 4.0 if ( $assoc_args['parent'] > 0 && ! term_exists( (int) $assoc_args['parent'] ) ) { WP_CLI::error( 'Parent term does not exist.' ); } $assoc_args = wp_slash( $assoc_args ); $term = wp_slash( $term ); $result = wp_insert_term( $term, $taxonomy, $assoc_args ); if ( is_wp_error( $result ) ) { WP_CLI::error( $result->get_error_message() ); } elseif ( $porcelain ) { WP_CLI::line( $result['term_id'] ); } else { WP_CLI::success( "Created {$taxonomy} {$result['term_id']}." ); } } /* * Gets details about a term. * * ## OPTIONS * * <taxonomy> * : Taxonomy of the term to get * * <term> * : ID or slug of the term to get * * [--by=<field>] * : Explicitly handle the term value as a slug or id. * --- * default: id * options: * - slug * - id * --- * * [--field=<field>] * : Instead of returning the whole term, returns the value of a single field. * * [--fields=<fields>] * : Limit the output to specific fields. Defaults to all fields. * * [--format=<format>] * : Render output in a particular format. * --- * default: table * options: * - table * - csv * - json * - yaml * --- * * ## EXAMPLES * * # Get details about a category with id 199. * $ wp term get category 199 --format=json * {"term_id":199,"name":"Apple","slug":"apple","term_group":0,"term_taxonomy_id":199,"taxonomy":"category","description":"A type of fruit","parent":0,"count":0,"filter":"raw"} * * # Get details about a category with slug apple. * $ wp term get category apple --by=slug --format=json * {"term_id":199,"name":"Apple","slug":"apple","term_group":0,"term_taxonomy_id":199,"taxonomy":"category","description":"A type of fruit","parent":0,"count":0,"filter":"raw"} / public function get( $args, $assoc_args ) { list( $taxonomy, $term ) = $args; $term = get_term_by( Utils\get_flag_value( $assoc_args, 'by' ), $term, $taxonomy ); if ( ! $term ) { WP_CLI::error( "Term doesn't exist." ); } if ( ! isset( $term->url ) ) { $term->url = get_term_link( $term ); } if ( empty( $assoc_args['fields'] ) ) { $term_array = get_object_vars( $term ); $assoc_args['fields'] = array_keys( $term_array ); } $term->count = (int) $term->count; $term->parent = (int) $term->parent; $formatter = $this->get_formatter( $assoc_args ); $formatter->display_item( $term ); } /* * Updates an existing term. * * ## OPTIONS * * <taxonomy> * : Taxonomy of the term to update. * * <term> * : ID or slug for the term to update. * * [--by=<field>] * : Explicitly handle the term value as a slug or id. * --- * default: id * options: * - slug * - id * --- * * [--name=<name>] * : A new name for the term. * * [--slug=<slug>] * : A new slug for the term. * * [--description=<description>] * : A new description for the term. * * [--parent=<term-id>] * : A new parent for the term. * * ## EXAMPLES * * # Change category with id 15 to use the name "Apple" * $ wp term update category 15 --name=Apple * Success: Term updated. * * # Change category with slug apple to use the name "Apple" * $ wp term update category apple --by=slug --name=Apple * Success: Term updated. / public function update( $args, $assoc_args ) { list( $taxonomy, $term ) = $args; $defaults = [ 'name' => null, 'slug' => null, 'description' => null, 'parent' => null, ]; $assoc_args = wp_parse_args( $assoc_args, $defaults ); foreach ( $assoc_args as $key => $value ) { if ( null === $value ) { unset( $assoc_args[ $key ] ); } } $assoc_args = wp_slash( $assoc_args ); $term = get_term_by( Utils\get_flag_value( $assoc_args, 'by' ), $term, $taxonomy ); if ( ! $term ) { WP_CLI::error( "Term doesn't exist." ); } // Update term. $result = wp_update_term( $term->term_id, $taxonomy, $assoc_args ); if ( is_wp_error( $result ) ) { WP_CLI::error( $result->get_error_message() ); } else { WP_CLI::success( 'Term updated.' ); } } /* * Deletes an existing term. * * Errors if the term doesn't exist, or there was a problem in deleting it. * * ## OPTIONS * * <taxonomy> * : Taxonomy of the term to delete. * * <term>... * : One or more IDs or slugs of terms to delete. * * [--by=<field>] * : Explicitly handle the term value as a slug or id. * --- * default: id * options: * - slug * - id * --- * * ## EXAMPLES * * # Delete post category by id * $ wp term delete category 15 * Deleted category 15. * Success: Deleted 1 of 1 terms. * * # Delete post category by slug * $ wp term delete category apple --by=slug * Deleted category 15. * Success: Deleted 1 of 1 terms. * * # Delete all post tags * $ wp term list post_tag --field=term_id \| xargs wp term delete post_tag * Deleted post_tag 159. * Deleted post_tag 160. * Deleted post_tag 161. * Success: Deleted 3 of 3 terms. / public function delete( $args, $assoc_args ) { $taxonomy = array_shift( $args ); $successes = 0; $errors = 0; foreach ( $args as $term_id ) { $term = $term_id; // Get term by specified argument otherwise get term by id. $field = Utils\get_flag_value( $assoc_args, 'by' ); if ( 'slug' === $field ) { // Get term by slug. $term = get_term_by( $field, $term, $taxonomy ); // If term not found, then show error message and skip the iteration. if ( ! $term ) { WP_CLI::warning( "{$taxonomy} {$term_id} doesn't exist." ); continue; } // Get the term id; $term_id = $term->term_id; } $result = wp_delete_term( $term_id, $taxonomy ); if ( is_wp_error( $result ) ) { WP_CLI::warning( $result ); ++$errors; } elseif ( $result ) { WP_CLI::log( "Deleted {$taxonomy} {$term_id}." ); ++$successes; } else { WP_CLI::warning( "{$taxonomy} {$term_id} doesn't exist." ); } } Utils\report_batch_operation_results( 'term', 'delete', count( $args ), $successes, $errors ); } /* * Generates some terms. * * Creates a specified number of new terms with dummy data. * * ## OPTIONS * * <taxonomy> * : The taxonomy for the generated terms. * * [--count=<number>] * : How many terms to generate? * --- * default: 100 * --- * * [--max_depth=<number>] * : Generate child terms down to a certain depth. * --- * default: 1 * --- * * [--format=<format>] * : Render output in a particular format. * --- * default: progress * options: * - progress * - ids * --- * * ## EXAMPLES * * # Generate post categories. * $ wp term generate category --count=10 * Generating terms 100% [=========] 0:02 / 0:02 * * # Add meta to every generated term. * $ wp term generate category --format=ids --count=3 \| xargs -d ' ' -I % wp term meta add % foo bar * Success: Added custom field. * Success: Added custom field. * Success: Added custom field. / public function generate( $args, $assoc_args ) { global $wpdb; list ( $taxonomy ) = $args; $defaults = [ 'count' => 100, 'max_depth' => 1, ]; $final_args = array_merge( $defaults, $assoc_args ); $count = $final_args['count']; $max_depth = $final_args['max_depth']; if ( ! taxonomy_exists( $taxonomy ) ) { WP_CLI::error( "'{$taxonomy}' is not a registered taxonomy." ); } $label = get_taxonomy( $taxonomy )->labels->singular_name; $slug = sanitize_title_with_dashes( $label ); $hierarchical = get_taxonomy( $taxonomy )->hierarchical; $format = Utils\get_flag_value( $assoc_args, 'format', 'progress' ); $notify = false; if ( 'progress' === $format ) { $notify = Utils\make_progress_bar( 'Generating terms', $count ); } $previous_term_id = 0; $current_parent = 0; $current_depth = 1; $max_id = (int) $wpdb->get_var( "SELECT term_taxonomy_id FROM {$wpdb->term_taxonomy} ORDER BY term_taxonomy_id DESC LIMIT 1" ); $suspend_cache_invalidation = wp_suspend_cache_invalidation( true ); $created = []; for ( $index = $max_id + 1; $index <= $max_id + $count; $index++ ) { if ( $hierarchical ) { if ( $previous_term_id && $this->maybe_make_child() && $current_depth < $max_depth ) { $current_parent = $previous_term_id; ++$current_depth; } elseif ( $this->maybe_reset_depth() ) { $current_parent = 0; $current_depth = 1; } } $args = [ 'parent' => $current_parent, 'slug' => $slug . "-{$index}", ]; $name = "{$label} {$index}"; $term = wp_insert_term( $name, $taxonomy, $args ); if ( is_wp_error( $term ) ) { WP_CLI::warning( $term ); } else { $created[] = $term['term_id']; $previous_term_id = $term['term_id']; if ( 'ids' === $format ) { echo $term['term_id']; if ( $index < $max_id + $count ) { echo ' '; } } } if ( 'progress' === $format ) { $notify->tick(); } } wp_suspend_cache_invalidation( $suspend_cache_invalidation ); clean_term_cache( $created, $taxonomy ); if ( 'progress' === $format ) { $notify->finish(); } } /* * Recalculates number of posts assigned to each term. * * In instances where manual updates are made to the terms assigned to * posts in the database, the number of posts associated with a term * can become out-of-sync with the actual number of posts. * * This command runs wp_update_term_count() on the taxonomy's terms * to bring the count back to the correct value. * * ## OPTIONS * * <taxonomy>... * : One or more taxonomies to recalculate. * * ## EXAMPLES * * # Recount posts assigned to each categories and tags * $ wp term recount category post_tag * Success: Updated category term count. * Success: Updated post_tag term count. * * # Recount all listed taxonomies * $ wp taxonomy list --field=name \| xargs wp term recount * Success: Updated category term count. * Success: Updated post_tag term count. * Success: Updated nav_menu term count. * Success: Updated link_category term count. * Success: Updated post_format term count. / public function recount( $args ) { foreach ( $args as $taxonomy ) { if ( ! taxonomy_exists( $taxonomy ) ) { WP_CLI::warning( "Taxonomy {$taxonomy} does not exist." ); } else { // phpcs:ignore WordPress.WP.DeprecatedParameters.Get_termsParam2Found -- Required for backward compatibility. $terms = get_terms( $taxonomy, [ 'hide_empty' => false ] ); $term_taxonomy_ids = wp_list_pluck( $terms, 'term_taxonomy_id' ); wp_update_term_count( $term_taxonomy_ids, $taxonomy ); WP_CLI::success( "Updated {$taxonomy} term count." ); } } } /* * Migrate a term of a taxonomy to another taxonomy. * * ## OPTIONS * * <term> * : Slug or ID of the term to migrate. * * [--by=<field>] * : Explicitly handle the term value as a slug or id. * --- * default: id * options: * - slug * - id * --- * * [--from=<taxonomy>] * : Taxonomy slug of the term to migrate. * * [--to=<taxonomy>] * : Taxonomy slug to migrate to. * * ## EXAMPLES * * # Migrate a category's term (video) to tag taxonomy. * $ wp term migrate 9190 --from=category --to=post_tag * Term 'video' assigned to post 1155. * Term 'video' migrated. * Old instance of term 'video' removed from its original taxonomy. * Success: Migrated the term 'video' from taxonomy 'category' to taxonomy 'post_tag' for 1 post. */ public function migrate( $args, $assoc_args ) { $term_reference = $args[0]; $original_taxonomy = Utils\get_flag_value( $assoc_args, 'from' ); $destination_taxonomy = Utils\get_flag_value( $assoc_args, 'to' ); $term = get_term_by( Utils\get_flag_value( $assoc_args, 'by' ), $term_reference, $original_taxonomy ); if ( ! $term ) { WP_CLI::error( "Taxonomy term '{$term_reference}' for taxonomy '{$original_taxonomy}' doesn't exist." ); } $original_taxonomy = get_taxonomy( $original_taxonomy ); $id = wp_insert_term( $term->name, $destination_taxonomy, [ 'slug' => $term->slug, 'parent' => 0, 'description' => $term->description, ] ); if ( is_wp_error( $id ) ) { WP_CLI::error( $id->get_error_message() ); } $post_ids = get_objects_in_term( $term->term_id, $original_taxonomy->name ); foreach ( $post_ids as $post_id ) { $type = get_post_type( $post_id ); if ( in_array( $type, $original_taxonomy->object_type, true ) ) { $term_taxonomy_id = wp_set_object_terms( $post_id, $id['term_id'], $destination_taxonomy, true ); if ( is_wp_error( $term_taxonomy_id ) ) { WP_CLI::error( "Failed to assign the term '{$term->slug}' to the post {$post_id}. Reason: " . $term_taxonomy_id->get_error_message() ); } WP_CLI::log( "Term '{$term->slug}' assigned to post {$post_id}." ); } clean_post_cache( $post_id ); } clean_term_cache( $term->term_id ); WP_CLI::log( "Term '{$term->slug}' migrated." ); $del = wp_delete_term( $term->term_id, $original_taxonomy->name ); if ( is_wp_error( $del ) ) { WP_CLI::error( "Failed to delete the term '{$term->slug}'. Reason: " . $del->get_error_message() ); } WP_CLI::log( "Old instance of term '{$term->slug}' removed from its original taxonomy." ); $post_count = count( $post_ids ); $post_plural = Utils\pluralize( 'post', $post_count ); WP_CLI::success( "Migrated the term '{$term->slug}' from taxonomy '{$original_taxonomy->name}' to taxonomy '{$destination_taxonomy}' for {$post_count} {$post_plural}." ); } private function maybe_make_child() { // 50% chance of making child term. return ( wp_rand( 1, 2 ) === 1 ); } private function maybe_reset_depth() { // 10% chance of resetting to root depth. return ( wp_rand( 1, 10 ) === 7 ); } private function get_formatter( &$assoc_args ) { return new Formatter( $assoc_args, $this->fields, 'term' ); } }	19.27 KB	2025-05-25 12:40
📄 Term_Meta_Command.php <?php use WP_CLI\CommandWithMeta; /** * Adds, updates, deletes, and lists term custom fields. * * ## EXAMPLES * * # Set term meta * $ wp term meta set 123 bio "Mary is a WordPress developer." * Success: Updated custom field 'bio'. * * # Get term meta * $ wp term meta get 123 bio * Mary is a WordPress developer. * * # Update term meta * $ wp term meta update 123 bio "Mary is an awesome WordPress developer." * Success: Updated custom field 'bio'. * * # Delete term meta * $ wp term meta delete 123 bio * Success: Deleted custom field. / class Term_Meta_Command extends CommandWithMeta { protected $meta_type = 'term'; /* * Check that the term ID exists * * @param int / protected function check_object_id( $object_id ) { $term = get_term( $object_id ); if ( ! $term ) { WP_CLI::error( "Could not find the term with ID {$object_id}." ); } return $term->term_id; } /* * Wrapper method for add_metadata that can be overridden in sub classes. * * @param int $object_id ID of the object the metadata is for. * @param string $meta_key Metadata key to use. * @param mixed $meta_value Metadata value. Must be serializable if * non-scalar. * @param bool $unique Optional, default is false. Whether the * specified metadata key should be unique for the * object. If true, and the object already has a * value for the specified metadata key, no change * will be made. * * @return int\|false The meta ID on success, false on failure. / protected function add_metadata( $object_id, $meta_key, $meta_value, $unique = false ) { return add_term_meta( $object_id, $meta_key, $meta_value, $unique ); } /* * Wrapper method for update_metadata that can be overridden in sub classes. * * @param int $object_id ID of the object the metadata is for. * @param string $meta_key Metadata key to use. * @param mixed $meta_value Metadata value. Must be serializable if * non-scalar. * @param mixed $prev_value Optional. If specified, only update existing * metadata entries with the specified value. * Otherwise, update all entries. * * @return int\|bool Meta ID if the key didn't exist, true on successful * update, false on failure. / protected function update_metadata( $object_id, $meta_key, $meta_value, $prev_value = '' ) { return update_term_meta( $object_id, $meta_key, $meta_value, $prev_value ); } /* * Wrapper method for get_metadata that can be overridden in sub classes. * * @param int $object_id ID of the object the metadata is for. * @param string $meta_key Optional. Metadata key. If not specified, * retrieve all metadata for the specified object. * @param bool $single Optional, default is false. If true, return only * the first value of the specified meta_key. This * parameter has no effect if meta_key is not * specified. * * @return mixed Single metadata value, or array of values. / protected function get_metadata( $object_id, $meta_key = '', $single = false ) { return get_term_meta( $object_id, $meta_key, $single ); } /* * Wrapper method for delete_metadata that can be overridden in sub classes. * * @param int $object_id ID of the object metadata is for * @param string $meta_key Metadata key * @param mixed $meta_value Optional. Metadata value. Must be serializable * if non-scalar. If specified, only delete * metadata entries with this value. Otherwise, * delete all entries with the specified meta_key. * Pass `null, `false`, or an empty string to skip * this check. For backward compatibility, it is * not possible to pass an empty string to delete * those entries with an empty string for a value. * * @return bool True on successful delete, false on failure. */ protected function delete_metadata( $object_id, $meta_key, $meta_value = '' ) { return delete_term_meta( $object_id, $meta_key, $meta_value ); } }	4.39 KB	2025-05-25 12:40
📄 User_Application_Password_Command.php <?php use WP_CLI\ExitException; use WP_CLI\Fetchers\User as UserFetcher; use WP_CLI\Formatter; use WP_CLI\Utils; /** * Creates, updates, deletes, lists and retrieves application passwords. * * ## EXAMPLES * * # List user application passwords and only show app name and password hash * $ wp user application-password list 123 --fields=name,password * +--------+------------------------------------+ * \| name \| password \| * +--------+------------------------------------+ * \| myapp \| $P$BVGeou1CUot114YohIemgpwxQCzb8O/ \| * +--------+------------------------------------+ * * # Get a specific application password and only show app name and created timestamp * $ wp user application-password get 123 6633824d-c1d7-4f79-9dd5-4586f734d69e --fields=name,created * +--------+------------+ * \| name \| created \| * +--------+------------+ * \| myapp \| 1638395611 \| * +--------+------------+ * * # Create user application password * $ wp user application-password create 123 myapp * Success: Created application password. * Password: ZG1bxdxdzjTwhsY8vK8l1C65 * * # Only print the password without any chrome * $ wp user application-password create 123 myapp --porcelain * ZG1bxdxdzjTwhsY8vK8l1C65 * * # Update an existing application password * $ wp user application-password update 123 6633824d-c1d7-4f79-9dd5-4586f734d69e --name=newappname * Success: Updated application password. * * # Delete an existing application password * $ wp user application-password delete 123 6633824d-c1d7-4f79-9dd5-4586f734d69e * Success: Deleted 1 of 1 application password. * * # Check if an application password for a given application exists * $ wp user application-password exists 123 myapp * $ echo $? * 1 * * # Bash script for checking whether an application password exists and creating one if not * if ! wp user application-password exists 123 myapp; then * PASSWORD=$(wp user application-password create 123 myapp --porcelain) * fi / final class User_Application_Password_Command { /* * List of application password fields. * * @var array<string> / const APPLICATION_PASSWORD_FIELDS = [ 'uuid', 'app_id', 'name', 'password', 'created', 'last_used', 'last_ip', ]; /* * Lists all application passwords associated with a user. * * ## OPTIONS * * <user> * : The user login, user email, or user ID of the user to get application passwords for. * * [--<field>=<value>] * : Filter the list by a specific field. * * [--field=<field>] * : Prints the value of a single field for each application password. * * [--fields=<fields>] * : Limit the output to specific fields. * * [--format=<format>] * : Render output in a particular format. * --- * default: table * options: * - table * - csv * - json * - count * - yaml * - ids * --- * * [--orderby=<fields>] * : Set orderby which field. * --- * default: created * options: * - uuid * - app_id * - name * - password * - created * - last_used * - last_ip * --- * * [--order=<order>] * : Set ascending or descending order. * --- * default: desc * options: * - asc * - desc * --- * * ## EXAMPLES * * # List user application passwords and only show app name and password hash * $ wp user application-password list 123 --fields=name,password * +--------+------------------------------------+ * \| name \| password \| * +--------+------------------------------------+ * \| myapp \| $P$BVGeou1CUot114YohIemgpwxQCzb8O/ \| * +--------+------------------------------------+ * * @subcommand list * * @param array $args Indexed array of positional arguments. * @param array $assoc_args Associative array of associative arguments. * @throws ExitException If the user could not be found/parsed. * @throws ExitException If the application passwords could not be retrieved. / public function list_( $args, $assoc_args ) { $args = $this->replace_login_with_user_id( $args ); list( $user_id ) = $args; $application_passwords = WP_Application_Passwords::get_user_application_passwords( $user_id ); if ( $application_passwords instanceof WP_Error ) { WP_CLI::error( $application_passwords ); } if ( empty( $application_passwords ) ) { $application_passwords = []; } $order = Utils\get_flag_value( $assoc_args, 'order' ); $orderby = Utils\get_flag_value( $assoc_args, 'orderby' ); usort( $application_passwords, static function ( $a, $b ) use ( $orderby, $order ) { // Sort array. return 'asc' === $order ? $a[ $orderby ] > $b[ $orderby ] : $a[ $orderby ] < $b[ $orderby ]; } ); $fields = self::APPLICATION_PASSWORD_FIELDS; // Avoid confusion regarding the dash/underscore usage. foreach ( [ 'app-id', 'last-used', 'last-ip' ] as $flag ) { if ( array_key_exists( $flag, $assoc_args ) ) { $underscored_flag = str_replace( '-', '_', $flag ); $assoc_args[ $underscored_flag ] = $assoc_args[ $flag ]; unset( $assoc_args[ $flag ] ); } } foreach ( $fields as $field ) { if ( ! array_key_exists( $field, $assoc_args ) ) { continue; } $value = Utils\get_flag_value( $assoc_args, $field ); $application_passwords = array_filter( $application_passwords, static function ( $application_password ) use ( $field, $value ) { return $application_password[ $field ] === $value; } ); } if ( ! empty( $assoc_args['fields'] ) ) { $fields = explode( ',', $assoc_args['fields'] ); } $format = Utils\get_flag_value( $assoc_args, 'format', 'table' ); $formatter = new Formatter( $assoc_args, $fields ); if ( 'ids' === $format ) { $formatter->display_items( wp_list_pluck( $application_passwords, 'uuid' ) ); } else { $formatter->display_items( $application_passwords ); } } /* * Gets a specific application password. * * ## OPTIONS * * <user> * : The user login, user email, or user ID of the user to get the application password for. * * <uuid> * : The universally unique ID of the application password. * * [--field=<field>] * : Prints the value of a single field for the application password. * * [--fields=<fields>] * : Limit the output to specific fields. * * [--format=<format>] * : Render output in a particular format. * --- * default: table * options: * - table * - csv * - json * - yaml * --- * * ## EXAMPLES * * # Get a specific application password and only show app name and created timestamp * $ wp user application-password get 123 6633824d-c1d7-4f79-9dd5-4586f734d69e --fields=name,created * +--------+------------+ * \| name \| created \| * +--------+------------+ * \| myapp \| 1638395611 \| * +--------+------------+ * * @param array $args Indexed array of positional arguments. * @param array $assoc_args Associative array of associative arguments. * @throws ExitException If the application passwords could not be retrieved. / public function get( $args, $assoc_args ) { $args = $this->replace_login_with_user_id( $args ); list( $user_id, $uuid ) = $args; $application_password = WP_Application_Passwords::get_user_application_password( $user_id, $uuid ); if ( $application_password instanceof WP_Error ) { WP_CLI::error( $application_password ); } if ( null === $application_password ) { WP_CLI::error( 'No application password found for this user ID and UUID.' ); } $fields = self::APPLICATION_PASSWORD_FIELDS; if ( ! empty( $assoc_args['fields'] ) ) { $fields = explode( ',', $assoc_args['fields'] ); } $formatter = new Formatter( $assoc_args, $fields ); $formatter->display_items( [ $application_password ] ); } /* * Creates a new application password. * * ## OPTIONS * * <user> * : The user login, user email, or user ID of the user to create a new application password for. * * <app-name> * : Unique name of the application to create an application password for. * * [--app-id=<app-id>] * : Application ID to attribute to the application password. * * [--porcelain] * : Output just the new password. * * ## EXAMPLES * * # Create user application password * $ wp user application-password create 123 myapp * Success: Created application password. * Password: ZG1bxdxdzjTwhsY8vK8l1C65 * * # Only print the password without any chrome * $ wp user application-password create 123 myapp --porcelain * ZG1bxdxdzjTwhsY8vK8l1C65 * * # Create user application with a custom application ID for internal tracking * $ wp user application-password create 123 myapp --app-id=42 --porcelain * ZG1bxdxdzjTwhsY8vK8l1C65 * * @param array $args Indexed array of positional arguments. * @param array $assoc_args Associative array of associative arguments. * @throws ExitException If the application password could not be created. / public function create( $args, $assoc_args ) { $args = $this->replace_login_with_user_id( $args ); list( $user_id, $app_name ) = $args; $app_id = Utils\get_flag_value( $assoc_args, 'app-id', '' ); $arguments = [ 'name' => $app_name, 'app_id' => $app_id, ]; $result = WP_Application_Passwords::create_new_application_password( $user_id, $arguments ); if ( $result instanceof WP_Error ) { WP_CLI::error( $result ); } if ( Utils\get_flag_value( $assoc_args, 'porcelain', false ) ) { WP_CLI::line( $result[0] ); WP_CLI::halt( 0 ); } WP_CLI::success( 'Created application password.' ); WP_CLI::line( "Password: {$result[0]}" ); } /* * Updates an existing application password. * * ## OPTIONS * * <user> * : The user login, user email, or user ID of the user to update the application password for. * * <uuid> * : The universally unique ID of the application password. * * [--<field>=<value>] * : Update the <field> with a new <value>. Currently supported fields: name. * * ## EXAMPLES * * # Update an existing application password * $ wp user application-password update 123 6633824d-c1d7-4f79-9dd5-4586f734d69e --name=newappname * Success: Updated application password. * * @param array $args Indexed array of positional arguments. * @param array $assoc_args Associative array of associative arguments. * @throws ExitException If the application password could not be created. / public function update( $args, $assoc_args ) { $args = $this->replace_login_with_user_id( $args ); list( $user_id, $uuid ) = $args; $result = WP_Application_Passwords::update_application_password( $user_id, $uuid, $assoc_args ); if ( $result instanceof WP_Error ) { WP_CLI::error( $result ); } WP_CLI::success( 'Updated application password.' ); } /* * Record usage of an application password. * * ## OPTIONS * * <user> * : The user login, user email, or user ID of the user to update the application password for. * * <uuid> * : The universally unique ID of the application password. * * ## EXAMPLES * * # Record usage of an application password * $ wp user application-password record-usage 123 6633824d-c1d7-4f79-9dd5-4586f734d69e * Success: Recorded application password usage. * * @subcommand record-usage * * @param array $args Indexed array of positional arguments. * @param array $assoc_args Associative array of associative arguments. * @throws ExitException If the application password could not be created. / public function record_usage( $args, $assoc_args ) { // phpcs:ignore Generic.CodeAnalysis.UnusedFunctionParameter.FoundAfterLastUsed $args = $this->replace_login_with_user_id( $args ); list( $user_id, $uuid ) = $args; $result = WP_Application_Passwords::record_application_password_usage( $user_id, $uuid ); if ( $result instanceof WP_Error ) { WP_CLI::error( $result ); } WP_CLI::success( 'Recorded application password usage.' ); } /* * Delete an existing application password. * * ## OPTIONS * * <user> * : The user login, user email, or user ID of the user to delete the application password for. * * [<uuid>...] * : Comma-separated list of UUIDs of the application passwords to delete. * * [--all] * : Delete all of the user's application password. * * ## EXAMPLES * * # Delete an existing application password * $ wp user application-password delete 123 6633824d-c1d7-4f79-9dd5-4586f734d69e * Success: Deleted 1 of 1 application password. * * # Delete all of the user's application passwords * $ wp user application-password delete 123 --all * Success: Deleted all application passwords. * * @param array $args Indexed array of positional arguments. * @param array $assoc_args Associative array of associative arguments. * @throws ExitException If the application password could not be created. / public function delete( $args, $assoc_args ) { $args = $this->replace_login_with_user_id( $args ); $user_id = array_shift( $args ); $all = Utils\get_flag_value( $assoc_args, 'all', false ); $count = count( $args ); if ( ( 0 < $count && true === $all ) \|\| ( 0 === $count && true !== $all ) ) { WP_CLI::error( 'You need to specify either one or more UUIDS or provide the --all flag' ); } if ( true === $all ) { $result = WP_Application_Passwords::delete_all_application_passwords( $user_id ); if ( $result instanceof WP_Error ) { WP_CLI::error( $result ); } WP_CLI::success( 'Deleted all application passwords.' ); WP_CLI::halt( 0 ); } $errors = 0; foreach ( $args as $uuid ) { $result = WP_Application_Passwords::delete_application_password( $user_id, $uuid ); if ( $result instanceof WP_Error ) { WP_CLI::warning( "Failed to delete UUID {$uuid}: " . $result->get_error_message() ); ++$errors; } } WP_CLI::success( sprintf( 'Deleted %d of %d application %s.', $count - $errors, $count, Utils\pluralize( 'password', $count ) ) ); WP_CLI::halt( 0 === $errors ? 0 : 1 ); } /* * Checks whether an application password for a given application exists. * * ## OPTIONS * * <user> * : The user login, user email, or user ID of the user to check the existence of an application password for. * * <app-name> * : Name of the application to check the existence of an application password for. * * ## EXAMPLES * * # Check if an application password for a given application exists * $ wp user application-password exists 123 myapp * $ echo $? * 1 * * # Bash script for checking whether an application password exists and creating one if not * if ! wp user application-password exists 123 myapp; then * PASSWORD=$(wp user application-password create 123 myapp --porcelain) * fi * * @param array $args Indexed array of positional arguments. * @param array $assoc_args Associative array of associative arguments. * @throws ExitException If the application password could not be created. / public function exists( $args, $assoc_args ) { // phpcs:ignore Generic.CodeAnalysis.UnusedFunctionParameter.FoundAfterLastUsed $args = $this->replace_login_with_user_id( $args ); list( $user_id, $app_name ) = $args; $result = $this->application_name_exists_for_user( $user_id, $app_name ); if ( $result instanceof WP_Error ) { WP_CLI::error( $result ); } WP_CLI::halt( $result ? 0 : 1 ); } /* * Replaces user_login value with user ID. * * @param array $args Associative array of arguments. * @return array Associative array of arguments with the user login replaced with an ID. * @throws ExitException If the user is not found. / private function replace_login_with_user_id( $args ) { $user = ( new UserFetcher() )->get_check( $args[0] ); $args[0] = $user->ID; return $args; } /* * Checks if application name exists for the given user. * * This is a polyfill for WP_Application_Passwords::get_user_application_passwords(), which was only added for * WordPress 5.7+, but we're already supporting application passwords for WordPress 5.6+. * * @param int $user_id User ID to check the application passwords for. * @param string $app_name Application name to look for. * @return bool */ private function application_name_exists_for_user( $user_id, $app_name ) { if ( Utils\wp_version_compare( '5.7', '<' ) ) { $passwords = WP_Application_Passwords::get_user_application_passwords( $user_id ); foreach ( $passwords as $password ) { if ( strtolower( $password['name'] ) === strtolower( $app_name ) ) { return true; } } return false; } return WP_Application_Passwords::application_name_exists_for_user( $user_id, $app_name ); } }	16.77 KB	2025-05-25 12:40
📄 User_Command.php <?php use WP_CLI\CommandWithDBObject; use WP_CLI\Fetchers\User as UserFetcher; use WP_CLI\Formatter; use WP_CLI\Iterators\CSV as CsvIterator; use WP_CLI\Utils; /** * Manages users, along with their roles, capabilities, and meta. * * See references for [Roles and Capabilities](https://codex.wordpress.org/Roles_and_Capabilities) and [WP User class](https://codex.wordpress.org/Class_Reference/WP_User). * * ## EXAMPLES * * # List user IDs * $ wp user list --field=ID * 1 * * # Create a new user. * $ wp user create bob bob@example.com --role=author * Success: Created user 3. * Password: k9*&I4vNH(& * # Update an existing user. * $ wp user update 123 --display_name=Mary --user_pass=marypass * Success: Updated user 123. * * # Delete user 123 and reassign posts to user 567 * $ wp user delete 123 --reassign=567 * Success: Removed user 123 from http://example.com. * * @package wp-cli / class User_Command extends CommandWithDBObject { protected $obj_type = 'user'; protected $obj_fields = [ 'ID', 'user_login', 'display_name', 'user_email', 'user_registered', 'roles', ]; private $cap_fields = [ 'name', ]; private $fetcher; public function __construct() { $this->fetcher = new UserFetcher(); } /* * Lists users. * * Display WordPress users based on all arguments supported by * [WP_User_Query()](https://developer.wordpress.org/reference/classes/wp_user_query/prepare_query/). * * ## OPTIONS * * [--role=<role>] * : Only display users with a certain role. * * [--<field>=<value>] * : Control output by one or more arguments of WP_User_Query(). * * [--network] * : List all users in the network for multisite. * * [--field=<field>] * : Prints the value of a single field for each user. * * [--fields=<fields>] * : Limit the output to specific object fields. * * [--format=<format>] * : Render output in a particular format. * --- * default: table * options: * - table * - csv * - ids * - json * - count * - yaml * --- * * ## AVAILABLE FIELDS * * These fields will be displayed by default for each user: * * * ID * * user_login * * display_name * * user_email * * user_registered * * roles * * These fields are optionally available: * * * user_pass * * user_nicename * * user_url * * user_activation_key * * user_status * * spam * * deleted * * caps * * cap_key * * allcaps * * filter * * url * * ## EXAMPLES * * # List user IDs * $ wp user list --field=ID * 1 * * # List users with administrator role * $ wp user list --role=administrator --format=csv * ID,user_login,display_name,user_email,user_registered,roles * 1,supervisor,supervisor,supervisor@gmail.com,"2016-06-03 04:37:00",administrator * * # List users with only given fields * $ wp user list --fields=display_name,user_email --format=json * [{"display_name":"supervisor","user_email":"supervisor@gmail.com"}] * * # List users ordered by the 'last_activity' meta value. * $ wp user list --meta_key=last_activity --orderby=meta_value_num * * @subcommand list / public function list_( $args, $assoc_args ) { if ( Utils\get_flag_value( $assoc_args, 'network' ) ) { if ( ! is_multisite() ) { WP_CLI::error( 'This is not a multisite installation.' ); } $assoc_args['blog_id'] = 0; if ( isset( $assoc_args['fields'] ) ) { $fields = explode( ',', $assoc_args['fields'] ); $assoc_args['fields'] = array_diff( $fields, [ 'roles' ] ); } else { $assoc_args['fields'] = array_diff( $this->obj_fields, [ 'roles' ] ); } } $formatter = $this->get_formatter( $assoc_args ); if ( in_array( $formatter->format, [ 'ids', 'count' ], true ) ) { $assoc_args['fields'] = 'ids'; } else { $assoc_args['fields'] = 'all_with_meta'; } $assoc_args['count_total'] = false; $assoc_args = self::process_csv_arguments_to_arrays( $assoc_args ); if ( ! empty( $assoc_args['role'] ) && 'none' === $assoc_args['role'] ) { $norole_user_ids = wp_get_users_with_no_role(); if ( ! empty( $norole_user_ids ) ) { $assoc_args['include'] = $norole_user_ids; unset( $assoc_args['role'] ); } } $users = get_users( $assoc_args ); if ( 'ids' === $formatter->format ) { echo implode( ' ', $users ); } elseif ( 'count' === $formatter->format ) { $formatter->display_items( $users ); } else { $iterator = Utils\iterator_map( $users, function ( $user ) { if ( ! is_object( $user ) ) { return $user; } $user->roles = implode( ',', $user->roles ); $user->url = get_author_posts_url( $user->ID, $user->user_nicename ); return $user; } ); $formatter->display_items( $iterator ); } } /* * Gets details about a user. * * ## OPTIONS * * <user> * : User ID, user email, or user login. * * [--field=<field>] * : Instead of returning the whole user, returns the value of a single field. * * [--fields=<fields>] * : Get a specific subset of the user's fields. * * [--format=<format>] * : Render output in a particular format. * --- * default: table * options: * - table * - csv * - json * - yaml * --- * * ## EXAMPLES * * # Get user * $ wp user get 12 --field=login * supervisor * * # Get user and export to JSON file * $ wp user get bob --format=json > bob.json / public function get( $args, $assoc_args ) { $user = $this->fetcher->get_check( $args[0] ); $user_data = $user->to_array(); $user_data['roles'] = implode( ', ', $user->roles ); $formatter = $this->get_formatter( $assoc_args ); $formatter->display_item( $user_data ); } /* * Deletes one or more users from the current site. * * On multisite, `wp user delete` only removes the user from the current * site. Include `--network` to also remove the user from the database, but * make sure to reassign their posts prior to deleting the user. * * ## OPTIONS * * <user>... * : The user login, user email, or user ID of the user(s) to delete. * * [--network] * : On multisite, delete the user from the entire network. * * [--reassign=<user-id>] * : User ID to reassign the posts to. * * [--yes] * : Answer yes to any confirmation prompts. * * ## EXAMPLES * * # Delete user 123 and reassign posts to user 567 * $ wp user delete 123 --reassign=567 * Success: Removed user 123 from http://example.com. * * # Delete all contributors and reassign their posts to user 2 * $ wp user delete $(wp user list --role=contributor --field=ID) --reassign=2 * Success: Removed user 813 from http://example.com. * Success: Removed user 578 from http://example.com. * * # Delete all contributors in batches of 100 (avoid error: argument list too long: wp) * $ wp user delete $(wp user list --role=contributor --field=ID \| head -n 100) / public function delete( $args, $assoc_args ) { $network = Utils\get_flag_value( $assoc_args, 'network' ) && is_multisite(); $reassign = Utils\get_flag_value( $assoc_args, 'reassign' ); if ( $network && $reassign ) { WP_CLI::error( 'Reassigning content to a different user is not supported on multisite.' ); } $is_reassign_valid = ( $reassign && false === get_userdata( $reassign ) ) ? false : true; if ( ! $reassign ) { WP_CLI::confirm( '--reassign parameter not passed. All associated posts will be deleted. Proceed?', $assoc_args ); } elseif ( ! $is_reassign_valid ) { WP_CLI::confirm( '--reassign parameter is invalid. All associated posts will be deleted. Proceed?', $assoc_args ); } $users = $this->fetcher->get_many( $args ); parent::_delete( $users, $assoc_args, function ( $user ) use ( $network, $reassign ) { $user_id = $user->ID; if ( $network ) { $result = wpmu_delete_user( $user_id ); $message = "Deleted user {$user_id}."; } elseif ( is_multisite() && empty( $user->roles ) ) { $message = "No roles found for user {$user_id} on " . home_url() . ', no users deleted.'; return [ 'error', $message ]; } else { $result = wp_delete_user( $user_id, $reassign ); $message = "Removed user {$user_id} from " . home_url() . '.'; } if ( ! $result ) { $message = "Failed deleting user {$user_id}."; if ( is_multisite() && is_super_admin( $user_id ) ) { $message .= ' The user is a super admin.'; } return [ 'error', $message ]; } return [ 'success', $message ]; } ); } /* * Creates a new user. * * ## OPTIONS * * <user-login> * : The login of the user to create. * * <user-email> * : The email address of the user to create. * * [--role=<role>] * : The role of the user to create. Default: default role. Possible values * include 'administrator', 'editor', 'author', 'contributor', 'subscriber'. * * [--user_pass=<password>] * : The user password. Default: randomly generated. * * [--user_registered=<yyyy-mm-dd-hh-ii-ss>] * : The date the user registered. Default: current date. * * [--display_name=<name>] * : The display name. * * [--user_nicename=<nice_name>] * : A string that contains a URL-friendly name for the user. The default is the user's username. * * [--user_url=<url>] * : A string containing the user's URL for the user's web site. * * [--nickname=<nickname>] * : The user's nickname, defaults to the user's username. * * [--first_name=<first_name>] * : The user's first name. * * [--last_name=<last_name>] * : The user's last name. * * [--description=<description>] * : A string containing content about the user. * * [--rich_editing=<rich_editing>] * : A string for whether to enable the rich editor or not. False if not empty. * * [--send-email] * : Send an email to the user with their new account details. * * [--porcelain] * : Output just the new user id. * * ## EXAMPLES * * # Create user * $ wp user create bob bob@example.com --role=author * Success: Created user 3. * Password: k9*&I4vNH(& * # Create user without showing password upon success * $ wp user create ann ann@example.com --porcelain * 4 / public function create( $args, $assoc_args ) { $user = new stdClass(); list( $user->user_login, $user->user_email ) = $args; $assoc_args = wp_slash( $assoc_args ); if ( username_exists( $user->user_login ) ) { WP_CLI::error( "The '{$user->user_login}' username is already registered." ); } if ( ! is_email( $user->user_email ) ) { WP_CLI::error( "The '{$user->user_email}' email address is invalid." ); } $user->user_registered = Utils\get_flag_value( $assoc_args, 'user_registered', current_time( 'mysql', true ) ); $user->display_name = Utils\get_flag_value( $assoc_args, 'display_name', false ); $user->nickname = Utils\get_flag_value( $assoc_args, 'nickname', false ); $user->first_name = Utils\get_flag_value( $assoc_args, 'first_name', false ); $user->last_name = Utils\get_flag_value( $assoc_args, 'last_name', false ); $user->description = Utils\get_flag_value( $assoc_args, 'description', false ); $user->user_url = Utils\get_flag_value( $assoc_args, 'user_url', false ); if ( isset( $assoc_args['user_pass'] ) ) { $user->user_pass = $assoc_args['user_pass']; } else { $user->user_pass = wp_generate_password( 24 ); $generated_pass = true; } $user->role = Utils\get_flag_value( $assoc_args, 'role', get_option( 'default_role' ) ); self::validate_role( $user->role ); if ( ! Utils\get_flag_value( $assoc_args, 'send-email' ) ) { add_filter( 'send_password_change_email', '__return_false' ); add_filter( 'send_email_change_email', '__return_false' ); } if ( is_multisite() ) { $result = wpmu_validate_user_signup( $user->user_login, $user->user_email ); if ( is_wp_error( $result['errors'] ) && ! empty( $result['errors']->errors ) ) { WP_CLI::error( $result['errors'] ); } $user_id = wpmu_create_user( $user->user_login, $user->user_pass, $user->user_email ); if ( ! $user_id ) { WP_CLI::error( 'Unknown error creating new user.' ); } $user->ID = $user_id; $user_id = wp_update_user( $user ); if ( is_wp_error( $user_id ) ) { WP_CLI::error( $user_id ); } } else { $user_id = wp_insert_user( $user ); } if ( ! $user_id \|\| is_wp_error( $user_id ) ) { if ( ! $user_id ) { $user_id = 'Unknown error creating new user.'; } WP_CLI::error( $user_id ); } elseif ( false === $user->role ) { delete_user_option( $user_id, 'capabilities' ); delete_user_option( $user_id, 'user_level' ); } if ( Utils\get_flag_value( $assoc_args, 'send-email' ) ) { self::wp_new_user_notification( $user_id, $user->user_pass ); } if ( Utils\get_flag_value( $assoc_args, 'porcelain' ) ) { WP_CLI::line( $user_id ); } else { WP_CLI::success( "Created user {$user_id}." ); if ( isset( $generated_pass ) ) { WP_CLI::line( "Password: {$user->user_pass}" ); } } } /* * Updates an existing user. * * ## OPTIONS * * <user>... * : The user login, user email or user ID of the user(s) to update. * * [--user_pass=<password>] * : A string that contains the plain text password for the user. * * [--user_nicename=<nice_name>] * : A string that contains a URL-friendly name for the user. The default is the user's username. * * [--user_url=<url>] * : A string containing the user's URL for the user's web site. * * [--user_email=<email>] * : A string containing the user's email address. * * [--display_name=<display_name>] * : A string that will be shown on the site. Defaults to user's username. * * [--nickname=<nickname>] * : The user's nickname, defaults to the user's username. * * [--first_name=<first_name>] * : The user's first name. * * [--last_name=<last_name>] * : The user's last name. * * [--description=<description>] * : A string containing content about the user. * * [--rich_editing=<rich_editing>] * : A string for whether to enable the rich editor or not. False if not empty. * * [--user_registered=<yyyy-mm-dd-hh-ii-ss>] * : The date the user registered. * * [--role=<role>] * : A string used to set the user's role. * * --<field>=<value> * : One or more fields to update. For accepted fields, see wp_update_user(). * * [--skip-email] * : Don't send an email notification to the user. * * ## EXAMPLES * * # Update user * $ wp user update 123 --display_name=Mary --user_pass=marypass * Success: Updated user 123. / public function update( $args, $assoc_args ) { if ( isset( $assoc_args['user_login'] ) ) { WP_CLI::warning( "User logins can't be changed." ); unset( $assoc_args['user_login'] ); } if ( isset( $assoc_args['role'] ) ) { self::validate_role( $assoc_args['role'], true ); } $user_ids = []; foreach ( $this->fetcher->get_many( $args ) as $user ) { $user_ids[] = $user->ID; } if ( empty( $user_ids ) ) { WP_CLI::error( 'No valid users found.' ); } $skip_email = Utils\get_flag_value( $assoc_args, 'skip-email' ); if ( $skip_email ) { add_filter( 'send_email_change_email', '__return_false' ); add_filter( 'send_password_change_email', '__return_false' ); } $assoc_args = wp_slash( $assoc_args ); parent::_update( $user_ids, $assoc_args, 'wp_update_user' ); if ( $skip_email ) { remove_filter( 'send_email_change_email', '__return_false' ); remove_filter( 'send_password_change_email', '__return_false' ); } } /* * Generates some users. * * Creates a specified number of new users with dummy data. * * ## OPTIONS * * [--count=<number>] * : How many users to generate? * --- * default: 100 * --- * * [--role=<role>] * : The role of the generated users. Default: default role from WP * * [--format=<format>] * : Render output in a particular format. * --- * default: progress * options: * - progress * - ids * --- * * ## EXAMPLES * * # Add meta to every generated users. * $ wp user generate --format=ids --count=3 \| xargs -d ' ' -I % wp user meta add % foo bar * Success: Added custom field. * Success: Added custom field. * Success: Added custom field. / public function generate( $args, $assoc_args ) { global $blog_id; $defaults = [ 'count' => 100, 'role' => get_option( 'default_role' ), ]; $assoc_args = array_merge( $defaults, $assoc_args ); $role = $assoc_args['role']; if ( ! empty( $role ) ) { self::validate_role( $role ); } $user_count = count_users(); $total = $user_count['total_users']; $limit = $assoc_args['count'] + $total; $format = Utils\get_flag_value( $assoc_args, 'format', 'progress' ); $notify = false; if ( 'progress' === $format ) { $notify = Utils\make_progress_bar( 'Generating users', $assoc_args['count'] ); } for ( $index = $total; $index < $limit; $index++ ) { $login = "user_{$blog_id}_{$index}"; $name = "User {$index}"; $user_id = wp_insert_user( [ 'user_login' => $login, 'user_pass' => $login, 'nickname' => $name, 'display_name' => $name, 'role' => $role, ] ); if ( false === $role ) { delete_user_option( $user_id, 'capabilities' ); delete_user_option( $user_id, 'user_level' ); } if ( 'progress' === $format ) { $notify->tick(); } elseif ( 'ids' === $format ) { echo $user_id; if ( $index < $limit - 1 ) { echo ' '; } } } if ( 'progress' === $format ) { $notify->finish(); } } /* * Verifies whether a user exists. * * Displays a success message if the user does exist. * * ## OPTIONS * * <id> * : The ID of the user to check. * * ## EXAMPLES * * # The user exists. * $ wp user exists 1337 * Success: User with ID 1337 exists. * $ echo $? * 0 * * # The user does not exist. * $ wp user exists 10000 * $ echo $? * 1 / public function exists( $args ) { if ( $this->fetcher->get( $args[0] ) ) { WP_CLI::success( "User with ID {$args[0]} exists." ); } else { WP_CLI::halt( 1 ); } } /* * Sets the user role. * * ## OPTIONS * * <user> * : User ID, user email, or user login. * * [<role>] * : Make the user have the specified role. If not passed, the default role is * used. * * ## EXAMPLES * * $ wp user set-role 12 author * Success: Added johndoe (12) to http://example.com as author. * * @subcommand set-role / public function set_role( $args, $assoc_args ) { $user = $this->fetcher->get_check( $args[0] ); $role = Utils\get_flag_value( $args, 1, get_option( 'default_role' ) ); self::validate_role( $role ); // Multisite if ( function_exists( 'add_user_to_blog' ) ) { add_user_to_blog( get_current_blog_id(), $user->ID, $role ); } else { $user->set_role( $role ); } WP_CLI::success( "Added {$user->user_login} ({$user->ID}) to " . site_url() . " as {$role}." ); } /* * Adds a role for a user. * * ## OPTIONS * * <user> * : User ID, user email, or user login. * * [<role>...] * : Add the specified role(s) to the user. * * ## EXAMPLES * * $ wp user add-role 12 author * Success: Added 'author' role for johndoe (12). * * $ wp user add-role 12 author editor * Success: Added 'author', 'editor' roles for johndoe (12). * * @subcommand add-role / public function add_role( $args, $assoc_args ) { $user = $this->fetcher->get_check( $args[0] ); $roles = $args; array_shift( $roles ); if ( empty( $roles ) ) { WP_CLI::error( 'Please specify at least one role to add.' ); } foreach ( $roles as $role ) { self::validate_role( $role ); } foreach ( $roles as $role ) { $user->add_role( $role ); } $message = implode( "', '", $roles ); $label = count( $roles ) > 1 ? 'roles' : 'role'; WP_CLI::success( "Added '{$message}' {$label} for {$user->user_login} ({$user->ID})." ); } /* * Removes a user's role. * * ## OPTIONS * * <user> * : User ID, user email, or user login. * * [<role>...] * : Remove the specified role(s) from the user. * * ## EXAMPLES * * $ wp user remove-role 12 author * Success: Removed 'author' role for johndoe (12). * * $ wp user remove-role 12 author editor * Success: Removed 'author', 'editor' roles for johndoe (12). * * @subcommand remove-role / public function remove_role( $args, $assoc_args ) { $user = $this->fetcher->get_check( $args[0] ); if ( isset( $args[1] ) ) { $roles = $args; array_shift( $roles ); foreach ( $roles as $role ) { self::validate_role( $role ); } foreach ( $roles as $role ) { $user->remove_role( $role ); } $message = implode( "', '", $roles ); $label = count( $roles ) > 1 ? 'roles' : 'role'; WP_CLI::success( "Removed '{$message}' {$label} from {$user->user_login} ({$user->ID})." ); } else { // Multisite if ( function_exists( 'remove_user_from_blog' ) ) { remove_user_from_blog( $user->ID, get_current_blog_id() ); } else { $user->remove_all_caps(); } WP_CLI::success( "Removed {$user->user_login} ({$user->ID}) from " . site_url() . '.' ); } } /* * Adds a capability to a user. * * ## OPTIONS * * <user> * : User ID, user email, or user login. * * <cap> * : The capability to add. * * ## EXAMPLES * * # Add a capability for a user * $ wp user add-cap john create_premium_item * Success: Added 'create_premium_item' capability for john (16). * * # Add a capability for a user * $ wp user add-cap 15 edit_product * Success: Added 'edit_product' capability for johndoe (15). * * @subcommand add-cap / public function add_cap( $args, $assoc_args ) { $user = $this->fetcher->get_check( $args[0] ); if ( $user ) { $cap = $args[1]; $user->add_cap( $cap ); WP_CLI::success( "Added '{$cap}' capability for {$user->user_login} ({$user->ID})." ); } } /* * Removes a user's capability. * * ## OPTIONS * * <user> * : User ID, user email, or user login. * * <cap> * : The capability to be removed. * * [--force] * : Forcefully remove a capability. * * ## EXAMPLES * * $ wp user remove-cap 11 publish_newsletters * Success: Removed 'publish_newsletters' cap for supervisor (11). * * $ wp user remove-cap 11 publish_posts * Error: The 'publish_posts' cap for supervisor (11) is inherited from a role. * * $ wp user remove-cap 11 nonexistent_cap * Error: No such 'nonexistent_cap' cap for supervisor (11). * * $ wp user remove-cap 11 publish_newsletters --force * Success: Removed 'publish_newsletters' cap for supervisor (11). * * @subcommand remove-cap / public function remove_cap( $args, $assoc_args ) { $user = $this->fetcher->get_check( $args[0] ); if ( $user ) { $cap = $args[1]; if ( ! isset( $user->caps[ $cap ] ) ) { if ( isset( $user->allcaps[ $cap ] ) ) { WP_CLI::error( "The '{$cap}' cap for {$user->user_login} ({$user->ID}) is inherited from a role." ); } WP_CLI::error( "No such '{$cap}' cap for {$user->user_login} ({$user->ID})." ); } $user_roles = $user->roles; if ( ! empty( $user_roles ) && in_array( $cap, $user_roles, true ) && ! Utils\get_flag_value( $assoc_args, 'force' ) ) { WP_CLI::error( "Aborting because a role has the same name as '{$cap}'. Use `wp user remove-cap {$user->ID} {$cap} --force` to proceed with the removal." ); } $user->remove_cap( $cap ); WP_CLI::success( "Removed '{$cap}' cap for {$user->user_login} ({$user->ID})." ); } } /* * Lists all capabilities for a user. * * ## OPTIONS * * <user> * : User ID, user email, or login. * * [--format=<format>] * : Render output in a particular format. * --- * default: list * options: * - list * - table * - csv * - json * - count * - yaml * --- * * [--origin=<origin>] * : Render output in a particular format. * --- * default: all * options: * - all * - user * - role * --- * * [--exclude-role-names] * : Exclude capabilities that match role names from output. * * ## EXAMPLES * * $ wp user list-caps 21 * edit_product * create_premium_item * * @subcommand list-caps / public function list_caps( $args, $assoc_args ) { $user = $this->fetcher->get_check( $args[0] ); $exclude_role_names = Utils\get_flag_value( $assoc_args, 'exclude-role-names' ); $active_user_cap_list = []; $user_roles = $user->roles; switch ( $assoc_args['origin'] ) { case 'all': $user->get_role_caps(); $user_caps_list = $user->allcaps; foreach ( $user_caps_list as $capability => $active ) { if ( $exclude_role_names && in_array( $capability, $user_roles, true ) ) { continue; } if ( $active ) { $active_user_cap_list[] = $capability; } } break; case 'user': // Get the user's capabilities $user_capabilities = get_user_meta( $user->ID, 'wp_capabilities', true ); // Loop through each capability and only return the non-inherited ones foreach ( $user_capabilities as $capability => $active ) { if ( true === $active && ! in_array( $capability, $user_roles, true ) ) { $active_user_cap_list[] = $capability; } } break; case 'role': // Get the user's capabilities $user_capabilities = get_user_meta( $user->ID, 'wp_capabilities', true ); // Loop through each capability and only return the inherited ones (including the role name) foreach ( $user->get_role_caps() as $capability => $active ) { if ( true === $active && ! isset( $user_capabilities[ $capability ] ) ) { $active_user_cap_list[] = $capability; } if ( true === $active && ! $exclude_role_names && in_array( $capability, $user_roles, true ) ) { $active_user_cap_list[] = $capability; } } break; } if ( 'list' === $assoc_args['format'] ) { foreach ( $active_user_cap_list as $cap ) { WP_CLI::line( $cap ); } } else { $output_caps = []; foreach ( $active_user_cap_list as $cap ) { $output_cap = new stdClass(); $output_cap->name = $cap; $output_caps[] = $output_cap; } $formatter = new Formatter( $assoc_args, $this->cap_fields ); $formatter->display_items( $output_caps ); } } /* * Imports users from a CSV file. * * If the user already exists (matching the email address or login), then * the user is updated unless the `--skip-update` flag is used. * * ## OPTIONS * * <file> * : The local or remote CSV file of users to import. If '-', then reads from STDIN. * * [--send-email] * : Send an email to new users with their account details. * * [--skip-update] * : Don't update users that already exist. * * ## EXAMPLES * * # Import users from local CSV file * $ wp user import-csv /path/to/users.csv * Success: bobjones created. * Success: newuser1 created. * Success: existinguser created. * * # Import users from remote CSV file * $ wp user import-csv http://example.com/users.csv * * Sample users.csv file: * * user_login,user_email,display_name,role * bobjones,bobjones@example.com,Bob Jones,contributor * newuser1,newuser1@example.com,New User,author * existinguser,existinguser@example.com,Existing User,administrator * * @subcommand import-csv / public function import_csv( $args, $assoc_args ) { $blog_users = get_users(); $filename = $args[0]; if ( 0 === stripos( $filename, 'http://' ) \|\| 0 === stripos( $filename, 'https://' ) ) { $response = wp_remote_head( $filename ); $response_code = (string) wp_remote_retrieve_response_code( $response ); if ( in_array( (int) $response_code[0], [ 4, 5 ], true ) ) { WP_CLI::error( "Couldn't access remote CSV file (HTTP {$response_code} response)." ); } } elseif ( '-' === $filename ) { if ( ! Utils\has_stdin() ) { WP_CLI::error( 'Unable to read content from STDIN.' ); } } elseif ( ! file_exists( $filename ) ) { WP_CLI::error( "Missing file: {$filename}" ); } // Don't send core's emails during the creation / update process add_filter( 'send_password_change_email', '__return_false' ); add_filter( 'send_email_change_email', '__return_false' ); if ( '-' === $filename ) { $file_object = new NoRewindIterator( new SplFileObject( 'php://stdin' ) ); $file_object->setFlags( SplFileObject::READ_CSV ); $csv_data = []; $indexes = []; foreach ( $file_object as $line ) { if ( empty( $line[0] ) ) { continue; } if ( empty( $indexes ) ) { $indexes = $line; continue; } foreach ( $indexes as $n => $key ) { $data[ $key ] = $line[ $n ]; } $csv_data[] = $data; } } else { $csv_data = new CsvIterator( $filename ); } foreach ( $csv_data as $new_user ) { $defaults = [ 'role' => get_option( 'default_role' ), 'user_pass' => wp_generate_password( 24 ), 'user_registered' => current_time( 'mysql', true ), 'display_name' => false, ]; $new_user = array_merge( $defaults, $new_user ); $secondary_roles = []; if ( ! empty( $new_user['roles'] ) ) { $roles = array_map( 'trim', explode( ',', $new_user['roles'] ) ); $invalid_role = false; foreach ( $roles as $role ) { if ( null === get_role( $role ) ) { WP_CLI::warning( "{$new_user['user_login']} has an invalid role." ); $invalid_role = true; break; } } if ( $invalid_role ) { continue; } $new_user['role'] = array_shift( $roles ); $secondary_roles = $roles; } elseif ( 'none' === $new_user['role'] ) { $new_user['role'] = false; } elseif ( null === get_role( $new_user['role'] ) ) { WP_CLI::warning( "{$new_user['user_login']} has an invalid role." ); continue; } // User already exists and we just need to add them to the site if they aren't already there $existing_user = get_user_by( 'email', $new_user['user_email'] ); if ( ! $existing_user ) { $existing_user = get_user_by( 'login', $new_user['user_login'] ); } if ( $existing_user && Utils\get_flag_value( $assoc_args, 'skip-update' ) ) { WP_CLI::log( "{$existing_user->user_login} exists and has been skipped." ); continue; } if ( $existing_user ) { $new_user['ID'] = $existing_user->ID; $user_id = wp_update_user( $new_user ); if ( ! in_array( $existing_user->user_login, wp_list_pluck( $blog_users, 'user_login' ), true ) && is_multisite() && $new_user['role'] ) { add_user_to_blog( get_current_blog_id(), $existing_user->ID, $new_user['role'] ); WP_CLI::log( "{$existing_user->user_login} added as {$new_user['role']}." ); } // Create the user } else { unset( $new_user['ID'] ); // Unset else it will just return the ID if ( is_multisite() ) { $result = wpmu_validate_user_signup( $new_user['user_login'], $new_user['user_email'] ); if ( is_wp_error( $result['errors'] ) && ! empty( $result['errors']->errors ) ) { WP_CLI::warning( $result['errors'] ); continue; } $user_id = wpmu_create_user( $new_user['user_login'], $new_user['user_pass'], $new_user['user_email'] ); if ( ! $user_id ) { WP_CLI::warning( 'Unknown error creating new user.' ); continue; } $new_user['ID'] = $user_id; $user_id = wp_update_user( $new_user ); if ( is_wp_error( $user_id ) ) { WP_CLI::warning( $user_id ); continue; } } else { $user_id = wp_insert_user( $new_user ); } if ( Utils\get_flag_value( $assoc_args, 'send-email' ) ) { self::wp_new_user_notification( $user_id, $new_user['user_pass'] ); } } if ( is_wp_error( $user_id ) ) { WP_CLI::warning( $user_id ); continue; } if ( false === $new_user['role'] ) { delete_user_option( $user_id, 'capabilities' ); delete_user_option( $user_id, 'user_level' ); } $user = get_user_by( 'id', $user_id ); foreach ( $secondary_roles as $secondary_role ) { $user->add_role( $secondary_role ); } if ( ! empty( $existing_user ) ) { WP_CLI::success( $new_user['user_login'] . ' updated.' ); } else { WP_CLI::success( $new_user['user_login'] . ' created.' ); } } } /* * Resets the password for one or more users. * * ## OPTIONS * * <user>... * : one or more user logins or IDs. * * [--skip-email] * : Don't send an email notification to the affected user(s). * * [--show-password] * : Show the new password(s). * * [--porcelain] * : Output only the new password(s). * * ## EXAMPLES * * # Reset the password for two users and send them the change email. * $ wp user reset-password admin editor * Reset password for admin. * Reset password for editor. * Success: Passwords reset for 2 users. * * # Reset and display the password. * $ wp user reset-password editor --show-password * Reset password for editor. * Password: N6hAau0fXZMN#rLCIirdEGOh * Success: Password reset for 1 user. * * # Reset the password for one user, displaying only the new password, and not sending the change email. * $ wp user reset-password admin --skip-email --porcelain * yV6BP!d70wg * # Reset password for all users. * $ wp user reset-password $(wp user list --format=ids) * Reset password for admin. * Reset password for editor. * Reset password for subscriber. * Success: Passwords reset for 3 users. * * # Reset password for all users with a particular role. * $ wp user reset-password $(wp user list --format=ids --role=administrator) * Reset password for admin. * Success: Password reset for 1 user. * * @subcommand reset-password / public function reset_password( $args, $assoc_args ) { $porcelain = Utils\get_flag_value( $assoc_args, 'porcelain' ); $skip_email = Utils\get_flag_value( $assoc_args, 'skip-email' ); $show_new_pass = Utils\get_flag_value( $assoc_args, 'show-password' ); if ( $skip_email ) { add_filter( 'send_password_change_email', '__return_false' ); } $fetcher = new UserFetcher(); $users = $fetcher->get_many( $args ); foreach ( $users as $user ) { $new_pass = wp_generate_password( 24 ); wp_update_user( [ 'ID' => $user->ID, 'user_pass' => $new_pass, ] ); if ( $porcelain ) { WP_CLI::line( "$new_pass" ); } else { WP_CLI::log( "Reset password for {$user->user_login}." ); if ( $show_new_pass ) { WP_CLI::line( "Password: $new_pass" ); } } } $reset_user_count = count( $users ); if ( ! $porcelain ) { if ( 1 === $reset_user_count ) { WP_CLI::success( "Password reset for {$reset_user_count} user." ); } elseif ( $reset_user_count > 1 ) { WP_CLI::success( "Passwords reset for {$reset_user_count} users." ); } else { WP_CLI::error( 'No user found to reset password.' ); } } } /* * Checks whether the role is valid * * @param $role string * @param $warn_user_only bool / private static function validate_role( $role, $warn_user_only = false ) { if ( ! empty( $role ) && null === get_role( $role ) ) { if ( $warn_user_only ) { WP_CLI::warning( "Role doesn't exist: {$role}" ); } else { WP_CLI::error( "Role doesn't exist: {$role}" ); } } } /* * Accommodates three different behaviors for wp_new_user_notification() * - 4.3.1 and above: expect second argument to be deprecated * - 4.3: Second argument was repurposed as $notify * - Below 4.3: Send the password in the notification * * @param string $user_id * @param string $password / public static function wp_new_user_notification( $user_id, $password ) { if ( Utils\wp_version_compare( '4.3.1', '>=' ) ) { wp_new_user_notification( $user_id, null, 'both' ); } elseif ( Utils\wp_version_compare( '4.3', '>=' ) ) { // phpcs:ignore WordPress.WP.DeprecatedParameters.Wp_new_user_notificationParam2Found -- Only called in valid conditions. wp_new_user_notification( $user_id, 'both' ); } else { // phpcs:ignore WordPress.WP.DeprecatedParameters.Wp_new_user_notificationParam2Found -- Only called in valid conditions. wp_new_user_notification( $user_id, $password ); } } /* * Marks one or more users as spam on multisite. * * ## OPTIONS * * <user>... * : The user login, user email, or user ID of the user(s) to mark as spam. * * ## EXAMPLES * * # Mark user as spam. * $ wp user spam 123 * User 123 marked as spam. * Success: Spammed 1 of 1 users. / public function spam( $args ) { $this->update_msuser_status( $args, 'spam', '1' ); } /* * Removes one or more users from spam on multisite. * * ## OPTIONS * * <user>... * : The user login, user email, or user ID of the user(s) to remove from spam. * * ## EXAMPLES * * # Remove user from spam. * $ wp user unspam 123 * User 123 removed from spam. * Success: Unspamed 1 of 1 users. / public function unspam( $args ) { $this->update_msuser_status( $args, 'spam', '0' ); } /* * Common command for updating user data. / private function update_msuser_status( $user_ids, $pref, $value ) { // If site is not multisite, then stop execution. if ( ! is_multisite() ) { WP_CLI::error( 'This is not a multisite installation.' ); } if ( 'spam' === $pref ) { $action = (int) $value ? 'marked as spam' : 'removed from spam'; $verb = (int) $value ? 'spam' : 'unspam'; } $successes = 0; $errors = 0; $users = $this->fetcher->get_many( $user_ids ); if ( count( $users ) < count( $user_ids ) ) { $errors = count( $user_ids ) - count( $users ); } foreach ( $users as $user ) { $user_id = $user->ID; // Super admin should not be marked as spam. if ( is_super_admin( $user->ID ) ) { WP_CLI::warning( "User cannot be modified. The user {$user->ID} is a network administrator." ); continue; } // Skip if user is already marked as spam and show warning. if ( $value === $user->spam ) { WP_CLI::warning( "User {$user_id} already {$action}." ); continue; } // Make that user's blog as spam too. $blogs = (array) get_blogs_of_user( $user_id, true ); foreach ( $blogs as $details ) { // Only mark site as spam if not main site. if ( ! is_main_site( $details->userblog_id, $details->site_id ) ) { update_blog_status( $details->userblog_id, $pref, $value ); } } if ( Utils\wp_version_compare( '5.3', '<' ) ) { // phpcs:ignore WordPress.WP.DeprecatedFunctions.update_user_statusFound -- Fallback for older versions. update_user_status( $user_id, $pref, $value ); } else { wp_update_user( [ 'ID' => $user_id, $pref => $value, ] ); } WP_CLI::log( "User {$user_id} {$action}." ); ++$successes; } Utils\report_batch_operation_results( 'user', $verb, count( $user_ids ), $successes, $errors ); } /* * Checks if a user's password is valid or not. * * ## OPTIONS * * <user> * : The user login, user email or user ID of the user to check credentials for. * * <user_pass> * : A string that contains the plain text password for the user. * * [--escape-chars] * : Escape password with `wp_slash()` to mimic the same behavior as `wp-login.php`. * * ## EXAMPLES * * # Check whether given credentials are valid; exit status 0 if valid, otherwise 1 * $ wp user check-password admin adminpass * $ echo $? * 1 * * # Bash script for checking whether given credentials are valid or not * if ! $(wp user check-password admin adminpass); then * notify-send "Invalid Credentials"; * fi * * @subcommand check-password */ public function check_password( $args, $assoc_args ) { $escape_chars = Utils\get_flag_value( $assoc_args, 'escape-chars', false ); if ( ! $escape_chars && wp_slash( wp_unslash( $args[1] ) ) !== $args[1] ) { WP_CLI::warning( 'Password contains characters that need to be escaped. Please escape them manually or use the `--escape-chars` option.' ); } $user = $this->fetcher->get_check( $args[0] ); $user_pass = $escape_chars ? wp_slash( $args[1] ) : $args[1]; if ( wp_check_password( $user_pass, $user->data->user_pass, $user->ID ) ) { WP_CLI::halt( 0 ); } else { WP_CLI::halt( 1 ); } } }	40.19 KB	2025-09-06 07:07
📄 User_Meta_Command.php <?php use WP_CLI\CommandWithMeta; use WP_CLI\Fetchers\User as UserFetcher; /** * Adds, updates, deletes, and lists user custom fields. * * ## EXAMPLES * * # Add user meta * $ wp user meta add 123 bio "Mary is an WordPress developer." * Success: Added custom field. * * # List user meta * $ wp user meta list 123 --keys=nickname,description,wp_capabilities * +---------+-----------------+--------------------------------+ * \| user_id \| meta_key \| meta_value \| * +---------+-----------------+--------------------------------+ * \| 123 \| nickname \| supervisor \| * \| 123 \| description \| Mary is a WordPress developer. \| * \| 123 \| wp_capabilities \| {"administrator":true} \| * +---------+-----------------+--------------------------------+ * * # Update user meta * $ wp user meta update 123 bio "Mary is an awesome WordPress developer." * Success: Updated custom field 'bio'. * * # Delete user meta * $ wp user meta delete 123 bio * Success: Deleted custom field. / class User_Meta_Command extends CommandWithMeta { protected $meta_type = 'user'; private $fetcher; public function __construct() { $this->fetcher = new UserFetcher(); } /* * Lists all metadata associated with a user. * * ## OPTIONS * * <user> * : The user login, user email, or user ID of the user to get metadata for. * * [--keys=<keys>] * : Limit output to metadata of specific keys. * * [--fields=<fields>] * : Limit the output to specific row fields. Defaults to id,meta_key,meta_value. * * [--format=<format>] * : Render output in a particular format. * --- * default: table * options: * - table * - csv * - json * - count * - yaml * --- * * [--orderby=<fields>] * : Set orderby which field. * --- * default: id * options: * - id * - meta_key * - meta_value * --- * * [--order=<order>] * : Set ascending or descending order. * --- * default: asc * options: * - asc * - desc * --- * * [--unserialize] * : Unserialize meta_value output. * * ## EXAMPLES * * # List user meta * $ wp user meta list 123 --keys=nickname,description,wp_capabilities * +---------+-----------------+--------------------------------+ * \| user_id \| meta_key \| meta_value \| * +---------+-----------------+--------------------------------+ * \| 123 \| nickname \| supervisor \| * \| 123 \| description \| Mary is a WordPress developer. \| * \| 123 \| wp_capabilities \| {"administrator":true} \| * +---------+-----------------+--------------------------------+ * * @subcommand list / public function list_( $args, $assoc_args ) { $args = $this->replace_login_with_user_id( $args ); parent::list_( $args, $assoc_args ); } /* * Gets meta field value. * * ## OPTIONS * * <user> * : The user login, user email, or user ID of the user to get metadata for. * * <key> * : The metadata key. * * [--format=<format>] * : Render output in a particular format. * --- * default: table * options: * - table * - csv * - json * - yaml * --- * * ## EXAMPLES * * # Get user meta * $ wp user meta get 123 bio * Mary is an WordPress developer. * * # Get the primary site of a user (for multisite) * $ wp user meta get 2 primary_blog * 3 / public function get( $args, $assoc_args ) { $args = $this->replace_login_with_user_id( $args ); parent::get( $args, $assoc_args ); } /* * Deletes a meta field. * * ## OPTIONS * * <user> * : The user login, user email, or user ID of the user to delete metadata from. * * <key> * : The metadata key. * * [<value>] * : The value to delete. If omitted, all rows with key will deleted. * * ## EXAMPLES * * # Delete user meta * $ wp user meta delete 123 bio * Success: Deleted custom field. / public function delete( $args, $assoc_args ) { $args = $this->replace_login_with_user_id( $args ); parent::delete( $args, $assoc_args ); } /* * Adds a meta field. * * ## OPTIONS * * <user> * : The user login, user email, or user ID of the user to add metadata for. * * <key> * : The metadata key. * * <value> * : The new metadata value. * * [--format=<format>] * : The serialization format for the value. * --- * default: plaintext * options: * - plaintext * - json * --- * * ## EXAMPLES * * # Add user meta * $ wp user meta add 123 bio "Mary is an WordPress developer." * Success: Added custom field. / public function add( $args, $assoc_args ) { $args = $this->replace_login_with_user_id( $args ); parent::add( $args, $assoc_args ); } /* * Updates a meta field. * * ## OPTIONS * * <user> * : The user login, user email, or user ID of the user to update metadata for. * * <key> * : The metadata key. * * <value> * : The new metadata value. * * [--format=<format>] * : The serialization format for the value. * --- * default: plaintext * options: * - plaintext * - json * --- * * ## EXAMPLES * * # Update user meta * $ wp user meta update 123 bio "Mary is an awesome WordPress developer." * Success: Updated custom field 'bio'. * * @alias set / public function update( $args, $assoc_args ) { $args = $this->replace_login_with_user_id( $args ); parent::update( $args, $assoc_args ); } /* * Wrapper method for add_metadata that can be overridden in sub classes. * * @param int $object_id ID of the object the metadata is for. * @param string $meta_key Metadata key to use. * @param mixed $meta_value Metadata value. Must be serializable if * non-scalar. * @param bool $unique Optional, default is false. Whether the * specified metadata key should be unique for the * object. If true, and the object already has a * value for the specified metadata key, no change * will be made. * * @return int\|false The meta ID on success, false on failure. / protected function add_metadata( $object_id, $meta_key, $meta_value, $unique = false ) { return add_user_meta( $object_id, $meta_key, $meta_value, $unique ); } /* * Wrapper method for update_metadata that can be overridden in sub classes. * * @param int $object_id ID of the object the metadata is for. * @param string $meta_key Metadata key to use. * @param mixed $meta_value Metadata value. Must be serializable if * non-scalar. * @param mixed $prev_value Optional. If specified, only update existing * metadata entries with the specified value. * Otherwise, update all entries. * * @return int\|bool Meta ID if the key didn't exist, true on successful * update, false on failure. / protected function update_metadata( $object_id, $meta_key, $meta_value, $prev_value = '' ) { return update_user_meta( $object_id, $meta_key, $meta_value, $prev_value ); } /* * Wrapper method for get_metadata that can be overridden in sub classes. * * @param int $object_id ID of the object the metadata is for. * @param string $meta_key Optional. Metadata key. If not specified, * retrieve all metadata for the specified object. * @param bool $single Optional, default is false. If true, return only * the first value of the specified meta_key. This * parameter has no effect if meta_key is not * specified. * * @return mixed Single metadata value, or array of values. / protected function get_metadata( $object_id, $meta_key = '', $single = false ) { return get_user_meta( $object_id, $meta_key, $single ); } /* * Wrapper method for delete_metadata that can be overridden in sub classes. * * @param int $object_id ID of the object metadata is for * @param string $meta_key Metadata key * @param mixed $meta_value Optional. Metadata value. Must be serializable * if non-scalar. If specified, only delete * metadata entries with this value. Otherwise, * delete all entries with the specified meta_key. * Pass `null, `false`, or an empty string to skip * this check. For backward compatibility, it is * not possible to pass an empty string to delete * those entries with an empty string for a value. * * @return bool True on successful delete, false on failure. / protected function delete_metadata( $object_id, $meta_key, $meta_value = '' ) { return delete_user_meta( $object_id, $meta_key, $meta_value ); } /* * Replaces user_login value with user ID * user meta is a special case that also supports user_login * * @param array * @return array */ private function replace_login_with_user_id( $args ) { $user = $this->fetcher->get_check( $args[0] ); $args[0] = $user->ID; return $args; } }	9.31 KB	2025-05-25 12:40
📄 User_Session_Command.php <?php use WP_CLI\Fetchers\User as UserFetcher; use WP_CLI\Formatter; use WP_CLI\Utils; /** * Destroys and lists a user's sessions. * * ## EXAMPLES * * # List a user's sessions. * $ wp user session list admin@example.com --format=csv * login_time,expiration_time,ip,ua * "2016-01-01 12:34:56","2016-02-01 12:34:56",127.0.0.1,"Mozilla/5.0..." * * # Destroy the most recent session of the given user. * $ wp user session destroy admin * Success: Destroyed session. 3 sessions remaining. * * @package wp-cli / class User_Session_Command extends WP_CLI_Command { private $fields = [ 'token', 'login_time', 'expiration_time', 'ip', 'ua', ]; private $fetcher; public function __construct() { $this->fetcher = new UserFetcher(); } /* * Destroy a session for the given user. * * ## OPTIONS * * <user> * : User ID, user email, or user login. * * [<token>] * : The token of the session to destroy. Defaults to the most recently created session. * * [--all] * : Destroy all of the user's sessions. * * ## EXAMPLES * * # Destroy the most recent session of the given user. * $ wp user session destroy admin * Success: Destroyed session. 3 sessions remaining. * * # Destroy a specific session of the given user. * $ wp user session destroy admin e073ad8540a9c2... * Success: Destroyed session. 2 sessions remaining. * * # Destroy all the sessions of the given user. * $ wp user session destroy admin --all * Success: Destroyed all sessions. * * # Destroy all sessions for all users. * $ wp user list --field=ID \| xargs -n 1 wp user session destroy --all * Success: Destroyed all sessions. * Success: Destroyed all sessions. / public function destroy( $args, $assoc_args ) { $user = $this->fetcher->get_check( $args[0] ); $token = Utils\get_flag_value( $args, 1, null ); $all = Utils\get_flag_value( $assoc_args, 'all', false ); $manager = WP_Session_Tokens::get_instance( $user->ID ); if ( $token && $all ) { WP_CLI::error( 'The --all flag cannot be specified along with a session token.' ); } if ( $all ) { $manager->destroy_all(); WP_CLI::success( 'Destroyed all sessions.' ); return; } $sessions = $this->get_all_sessions( $manager ); if ( ! $token ) { if ( empty( $sessions ) ) { WP_CLI::success( 'No sessions to destroy.' ); } $last = end( $sessions ); $token = $last['token']; } if ( ! isset( $sessions[ $token ] ) ) { WP_CLI::error( 'Session not found.' ); } $this->destroy_session( $manager, $token ); $remaining = count( $manager->get_all() ); WP_CLI::success( "Destroyed session. {$remaining} remaining." ); } /* * List sessions for the given user. * * Note: The `token` field does not return the actual token, but a hash of * it. The real token is not persisted and can only be found in the * corresponding cookies on the client side. * * ## OPTIONS * * <user> * : User ID, user email, or user login. * * [--fields=<fields>] * : Limit the output to specific fields. * * [--format=<format>] * : Render output in a particular format. * --- * default: table * options: * - table * - csv * - json * - yaml * - count * - ids * --- * * ## AVAILABLE FIELDS * * These fields will be displayed by default for each session: * * * token * * login_time * * expiration_time * * ip * * ua * * These fields are optionally available: * * * expiration * * login * * ## EXAMPLES * * # List a user's sessions. * $ wp user session list admin@example.com --format=csv * login_time,expiration_time,ip,ua * "2016-01-01 12:34:56","2016-02-01 12:34:56",127.0.0.1,"Mozilla/5.0..." * * @subcommand list */ public function list_( $args, $assoc_args ) { $user = $this->fetcher->get_check( $args[0] ); $formatter = $this->get_formatter( $assoc_args ); $manager = WP_Session_Tokens::get_instance( $user->ID ); $sessions = $this->get_all_sessions( $manager ); if ( 'ids' === $formatter->format ) { echo implode( ' ', array_keys( $sessions ) ); } else { $formatter->display_items( $sessions ); } } protected function get_all_sessions( WP_Session_Tokens $manager ) { // Make the private session data accessible to WP-CLI $get_sessions = new ReflectionMethod( $manager, 'get_sessions' ); $get_sessions->setAccessible( true ); $sessions = $get_sessions->invoke( $manager ); array_walk( $sessions, function ( &$session, $token ) { $session['token'] = $token; $session['login_time'] = date( 'Y-m-d H:i:s', $session['login'] ); // phpcs:ignore WordPress.DateTime.RestrictedFunctions.date_date $session['expiration_time'] = date( 'Y-m-d H:i:s', $session['expiration'] ); // phpcs:ignore WordPress.DateTime.RestrictedFunctions.date_date } ); return $sessions; } protected function destroy_session( WP_Session_Tokens $manager, $token ) { $update_session = new ReflectionMethod( $manager, 'update_session' ); $update_session->setAccessible( true ); return $update_session->invoke( $manager, $token, null ); } private function get_formatter( &$assoc_args ) { return new Formatter( $assoc_args, $this->fields ); } }	5.24 KB	2025-05-25 12:40
📄 User_Term_Command.php <?php use WP_CLI\CommandWithTerms; /** * Adds, updates, removes, and lists user terms. * * ## EXAMPLES * * # Set user terms * $ wp user term set 123 test category * Success: Set terms. */ class User_Term_Command extends CommandWithTerms { protected $obj_type = 'user'; }	294 B	2025-05-25 12:40
📁 WP_CLI	-	2025-09-06 07:07

Edit File:

Terminal