Add the wp site meta sub-command, with tests

Author: Jonny Harris

entity-command.php

@@ -27,6 +27,19 @@
 WP_CLI::add_command( 'post term', 'Post_Term_Command' );
 WP_CLI::add_command( 'post-type', 'Post_Type_Command' );
 WP_CLI::add_command( 'site', 'Site_Command' );
+WP_CLI::add_command( 'site meta', 'Site_Meta_Command', array(
+	'before_invoke' => function() {
+		if ( !is_multisite() ) {
+			WP_CLI::error( 'This is not a multisite installation.' );
+		}
+		if ( \WP_CLI\Utils\wp_version_compare( '5.0', '<' ) ) {
+			WP_CLI::error( "Requires WordPress 5.0 or greater." );
+		}
+		if( function_exists('is_site_meta_supported') && !is_site_meta_supported() ){
+			WP_CLI::error( sprintf( 'The %s table is not installed. Please run the network database upgrade.', $GLOBALS['wpdb']->blogmeta ) );
+		}
+	}
+) );
 WP_CLI::add_command( 'site option', 'Site_Option_Command', array(
 	'before_invoke' => function() {
 		if ( !is_multisite() ) {

features/site-meta.feature

@@ -0,0 +1,19 @@
+Feature: Manage site-wide custom fields.
+
+  @require-wp-5.0
+  Scenario: Non-multisite
+    Given a WP install
+
+    When I run `wp site-meta`
+    Then STDOUT should contain:
+      """
+      usage: wp site meta
+      """
+
+    When I try `wp site-meta get 1 test`
+    Then STDOUT should be empty
+    And STDERR should contain:
+      """
+      This is not a multisite install.
+      """
+    And the return code should be 1

src/Site_Meta_Command.php

@@ -0,0 +1,38 @@
+<?php
+
+/**
+ * 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 \WP_CLI\CommandWithMeta {
+	protected $meta_type = 'blog';
+
+	/**
+	 * Check that the site ID exists
+	 *
+	 * @param int
+	 */
+	protected function check_object_id( $object_id ) {
+		$fetcher = new \WP_CLI\Fetchers\Site;
+		$site = $fetcher->get_check( $object_id );
+		return $site->blog_id;
+	}
+
+}