Merge branch 'master' into svenkaptein-feature-plugin-delete-all

Author: schlessera

README.md

@@ -451,6 +451,7 @@ search query.
     **icons**: Plugin's Icon Image Link
     **active_installs**: Plugin's Number of Active Installs
     **contributors**: Plugin's List of Contributors
+    **url**: Plugin's URL on wordpress.org
 
 	[--format=<format>]
 		Render output in a particular format.
@@ -1206,6 +1207,7 @@ search query.
     **num_ratings**: Number of Theme Ratings
     **homepage**: Theme Author's Homepage
     **description**: Theme Description
+    **url**: Theme's URL on wordpress.org
 
 	[--format=<format>]
 		Render output in a particular format.
@@ -1341,6 +1343,44 @@ wp theme update [<theme>...] [--all] [--exclude=<theme-names>] [--format=<format
     # Update all themes
     $ wp theme update --all
 
+
+
+### wp theme mod list
+
+Gets a list of theme mods.
+
+~~~
+wp theme mod list [--field=<field>] [--format=<format>]
+~~~
+
+**OPTIONS**
+
+	[--field=<field>]
+		Returns the value of a single field.
+
+	[--format=<format>]
+		Render output in a particular format.
+		---
+		default: table
+		options:
+		  - table
+		  - json
+		  - csv
+		  - yaml
+		---
+
+**EXAMPLES**
+
+    # Gets a list of theme mods.
+    $ wp theme mod list
+    +------------------+---------+
+    | key              | value   |
+    +------------------+---------+
+    | background_color | dd3333  |
+    | link_color       | #dd9933 |
+    | main_text_color  | #8224e3 |
+    +------------------+---------+
+
 ## Installing
 
 This package is included with WP-CLI itself, no additional installation necessary.

features/theme.feature

@@ -231,73 +231,73 @@ Feature: Manage WordPress themes
 
   Scenario: Enabling and disabling a theme
   	Given a WP multisite install
-    And I run `wp theme install jolene`
-    And I run `wp theme install biker`
+    And I run `wp theme install stargazer`
+    And I run `wp theme install buntu`
 
     When I try `wp option get allowedthemes`
     Then the return code should be 1
     # STDERR may or may not be empty, depending on WP-CLI version.
     And STDOUT should be empty
 
-    When I run `wp theme enable biker`
+    When I run `wp theme enable buntu`
     Then STDOUT should contain:
        """
-       Success: Enabled the 'Biker' theme.
+       Success: Enabled the 'Buntu' theme.
        """
 
     When I run `wp option get allowedthemes`
     Then STDOUT should contain:
        """
-       'biker' => true
+       'buntu' => true
        """
 
-    When I run `wp theme disable biker`
+    When I run `wp theme disable buntu`
     Then STDOUT should contain:
        """
-       Success: Disabled the 'Biker' theme.
+       Success: Disabled the 'Buntu' theme.
        """
 
     When I run `wp option get allowedthemes`
     Then STDOUT should not contain:
        """
-       'biker' => true
+       'buntu' => true
        """
 
-    When I run `wp theme enable biker --activate`
+    When I run `wp theme enable buntu --activate`
     Then STDOUT should contain:
        """
-       Success: Enabled the 'Biker' theme.
-       Success: Switched to 'Biker' theme.
+       Success: Enabled the 'Buntu' theme.
+       Success: Switched to 'Buntu' theme.
        """
 
     When I run `wp network-meta get 1 allowedthemes`
     Then STDOUT should not contain:
        """
-       'biker' => true
+       'buntu' => true
        """
 
-    When I run `wp theme enable biker --network`
+    When I run `wp theme enable buntu --network`
     Then STDOUT should contain:
        """
-       Success: Network enabled the 'Biker' theme.
+       Success: Network enabled the 'Buntu' theme.
        """
 
     When I run `wp network-meta get 1 allowedthemes`
     Then STDOUT should contain:
        """
-       'biker' => true
+       'buntu' => true
        """
 
-    When I run `wp theme disable biker --network`
+    When I run `wp theme disable buntu --network`
     Then STDOUT should contain:
        """
-       Success: Network disabled the 'Biker' theme.
+       Success: Network disabled the 'Buntu' theme.
        """
 
     When I run `wp network-meta get 1 allowedthemes`
     Then STDOUT should not contain:
        """
-       'biker' => true
+       'buntu' => true
        """
 
   Scenario: Enabling and disabling a theme without multisite
@@ -335,27 +335,27 @@ Feature: Manage WordPress themes
 
   Scenario: Install and attempt to activate a child theme without its parent
     Given a WP install
-    And I run `wp theme install biker`
-    And I run `rm -rf wp-content/themes/jolene`
+    And I run `wp theme install buntu`
+    And I run `rm -rf wp-content/themes/stargazer`
 
-    When I try `wp theme activate biker`
+    When I try `wp theme activate buntu`
     Then STDERR should contain:
       """
-      Error: The parent theme is missing. Please install the "jolene" parent theme.
+      Error: The parent theme is missing. Please install the "stargazer" parent theme.
       """
     And STDOUT should be empty
     And the return code should be 1
 
   Scenario: List an active theme with its parent
     Given a WP install
-    And I run `wp theme install jolene`
-    And I run `wp theme install --activate biker`
+    And I run `wp theme install stargazer`
+    And I run `wp theme install --activate buntu`
 
     When I run `wp theme list --fields=name,status`
     Then STDOUT should be a table containing rows:
       | name          | status   |
-      | biker         | active   |
-      | jolene        | parent   |
+      | buntu         | active   |
+      | stargazer     | parent   |
 
   Scenario: When updating a theme --format should be the same when using --dry-run
     Given a WP install

features/upgradables.feature

@@ -13,6 +13,11 @@ Feature: Manage WordPress themes and plugins
     And STDERR should be empty
     And STDOUT should be empty
 
+    When I try `wp <type> is-active <item>`
+    Then the return code should be 1
+    And STDERR should be empty
+    And STDOUT should be empty
+
     When I try `wp <type> get <item>`
     Then the return code should be 1
     And STDERR should not be empty

src/Plugin_Command.php

@@ -152,6 +152,7 @@ public function status( $args ) {
 	 *     **icons**: Plugin's Icon Image Link
 	 *     **active_installs**: Plugin's Number of Active Installs
 	 *     **contributors**: Plugin's List of Contributors
+	 *     **url**: Plugin's URL on wordpress.org
 	 *
 	 * [--format=<format>]
 	 * : Render output in a particular format.
@@ -198,7 +199,7 @@ protected function status_single( $args ) {
 		if ( $this->has_update( $file ) )
 			$version .= ' (%gUpdate available%n)';
 
-		echo WP_CLI::colorize( \WP_CLI\Utils\mustache_render( 'plugin-status.mustache', array(
+		echo WP_CLI::colorize( \WP_CLI\Utils\mustache_render( self::get_template_path( 'plugin-status.mustache' ), array(
 			'slug' => Utils\get_plugin_name( $file ),
 			'status' => $status,
 			'version' => $version,
@@ -899,6 +900,37 @@ public function is_installed( $args, $assoc_args = array() ) {
 		}
 	}
 
+	/**
+	 * Checks if a given plugin is active.
+	 *
+	 * Returns exit code 0 when active, 1 when not active.
+	 *
+	 * ## OPTIONS
+	 *
+	 * <plugin>
+	 * : The plugin to check.
+	 *
+	 * ## EXAMPLES
+	 *
+	 *     # Check whether plugin is Active; exit status 0 if active, otherwise 1
+	 *     $ wp plugin is-active hello
+	 *     $ echo $?
+	 *     1
+	 *
+	 * @subcommand is-active
+	 */
+	public function is_active( $args, $assoc_args = array() ) {
+		$network_wide = \WP_CLI\Utils\get_flag_value( $assoc_args, 'network' );
+
+		$plugin = $this->fetcher->get( $args[0] );
+
+		if ( ! $plugin ) {
+			WP_CLI::halt( 1 );
+		}
+
+		$this->check_active( $plugin->file, $network_wide ) ? WP_CLI::halt( 0 ) : WP_CLI::halt( 1 );
+	}
+
 	/**
 	 * Deletes plugin files without deactivating or uninstalling.
 	 *
@@ -1058,6 +1090,20 @@ protected function get_status( $file ) {
 		return 'inactive';
 	}
 
+	/**
+	 * Gets the template path based on installation type.
+	 */	 
+	private static function get_template_path( $template ) {
+		$command_root = Utils\phar_safe_path( dirname( __DIR__ ) );
+		$template_path = "{$command_root}/templates/{$template}";
+		
+		if ( ! file_exists( $template_path ) ) {
+			WP_CLI::error( "Couldn't find {$template}" );
+		}
+		
+		return $template_path;
+	}
+
 	/**
 	 * Gets the details of a plugin.
 	 *

src/Theme_Command.php

@@ -125,6 +125,7 @@ public function status( $args ) {
 	 *     **num_ratings**: Number of Theme Ratings
 	 *     **homepage**: Theme Author's Homepage
 	 *     **description**: Theme Description
+	 *     **url**: Theme's URL on wordpress.org
 	 *
 	 * [--format=<format>]
 	 * : Render output in a particular format.
@@ -166,7 +167,7 @@ protected function status_single( $args ) {
 		if ( $this->has_update( $theme->get_stylesheet() ) )
 			$version .= ' (%gUpdate available%n)';
 
-		echo WP_CLI::colorize( \WP_CLI\Utils\mustache_render( 'theme-status.mustache', array(
+		echo WP_CLI::colorize( \WP_CLI\Utils\mustache_render( self::get_template_path( 'theme-status.mustache' ), array(
 			'slug' => $theme->get_stylesheet(),
 			'status' => $status,
 			'version' => $version,
@@ -597,7 +598,7 @@ public function get( $args, $assoc_args ) {
 	 *
 	 * [--all]
 	 * : If set, all themes that have updates will be updated.
-	 * 
+	 *
 	 * [--exclude=<theme-names>]
 	 * : Comma separated list of theme names that should be excluded from updating.
 	 *
@@ -639,7 +640,7 @@ public function get( $args, $assoc_args ) {
 	 *     | twentysixteen | 1.1         | 1.2         | Updated |
 	 *     +---------------+-------------+-------------+---------+
 	 *     Success: Updated 2 of 2 themes.
-	 * 
+	 *
 	 *     # Exclude themes updates when bulk updating the themes
 	 *     $ wp theme update --all --exclude=twentyfifteen
 	 *     Downloading update from https://downloads.wordpress.org/theme/astra.1.0.5.1.zip...
@@ -716,6 +717,35 @@ public function is_installed( $args, $assoc_args = array() ) {
 		}
 	}
 
+	/**
+	 * Checks if a given theme is active.
+	 *
+	 * Returns exit code 0 when active, 1 when not active.
+	 *
+	 * ## OPTIONS
+	 *
+	 * <theme>
+	 * : The plugin to check.
+	 *
+	 * ## EXAMPLES
+	 *
+	 *     # Check whether theme is Active; exit status 0 if active, otherwise 1
+	 *     $ wp theme is-active twentyfifteen
+	 *     $ echo $?
+	 *     1
+	 *
+	 * @subcommand is-active
+	 */
+	public function is_active( $args, $assoc_args = array() ) {
+		$theme = wp_get_theme( $args[0] );
+
+		if ( ! $theme->exists() ) {
+			WP_CLI::halt( 1 );
+		}
+
+		$this->is_active_theme( $theme ) ? WP_CLI::halt( 0 ) : WP_CLI::halt( 1 );
+	}
+
 	/**
 	 * Deletes one or more themes.
 	 *
@@ -840,4 +870,18 @@ private function check_optional_args_and_all( $args, $all ) {
 
 		return $args;
 	}
+	
+	/**
+	 * Gets the template path based on installation type.
+	 */
+	private static function get_template_path( $template ) {
+		$command_root = Utils\phar_safe_path( dirname( __DIR__ ) );
+		$template_path = "{$command_root}/templates/{$template}";
+		
+		if ( ! file_exists( $template_path ) ) {
+			WP_CLI::error( "Couldn't find {$template}" );
+		}
+		
+		return $template_path;
+	}
 }

src/WP_CLI/CommandWithUpgrade.php

@@ -613,6 +613,13 @@ protected function _search( $args, $assoc_args ) {
 
 		$items = $api->$plural;
 
+		// Add `url` for plugin or theme on wordpress.org.
+		foreach ( $items as $index => $item_object ) {
+			if ( $item_object instanceof \stdClass ) {
+				$item_object->url = "https://wordpress.org/{$plural}/{$item_object->slug}/";
+			}
+		}
+
 		if ( 'table' === $format ) {
 			$count = \WP_CLI\Utils\get_flag_value( $api->info, 'results', 'unknown' );
 			\WP_CLI::success( sprintf( 'Showing %s of %s %s.', count( $items ), $count, $plural ) );

templates/plugin-status.mustache

@@ -0,0 +1,6 @@
+Plugin %9{{slug}}%n details:
+    Name: {{name}}
+    Status: {{status}}%n
+    Version: {{version}}
+    Author: {{author}}
+    Description: {{description}}

templates/theme-status.mustache

@@ -0,0 +1,5 @@
+Theme %9{{slug}}%n details:
+    Name: {{name}}
+    Status: {{status}}%n
+    Version: {{version}}
+    Author: {{author}}