Ticket #42923: 42923.patch

class-plugin-installer-skin.php

@@ -16 +16 @@
  * @see WP_Upgrader_Skin
  */
 class Plugin_Installer_Skin extends WP_Upgrader_Skin {
+
+        /**
+         * Holds the plugin data returned from WordPress.org API.
+         *
+         * @since 2.8.0
+         *
+         * @var array|object
+         */
         public $api;
+
+        /**
+         * Holds the installer type.
+         *
+         * @since 2.8.0
+         *
+         * @var string
+         */
         public $type;
 
         /**
-         * @param array $args
+         * Constructor.
+         *
+         * Sets up the plugin installer skin.
+         *
+         * @since 2.8.0
+         *
+         * @param array $args Optional. The plugin installer skin arguments to
+         *                    override default options. Default is an empty array.
          */
         public function __construct( $args = array() ) {
                 $defaults = array(

class-plugin-upgrader-skin.php

@@ -16 +16 @@
  * @see WP_Upgrader_Skin
  */
 class Plugin_Upgrader_Skin extends WP_Upgrader_Skin {
-        public $plugin                = '';
-        public $plugin_active         = false;
+
+        /**
+         * Holds the plugin slug in the Plugin Directory.
+         *
+         * @since 2.8.0
+         *
+         * @var object
+         */
+        public $plugin = '';
+
+        /**
+         * Whether the plugin is active.
+         *
+         * @since 2.8.0
+         *
+         * @var bool
+         */
+        public $plugin_active = false;
+
+        /**
+         * Whether the plugin is active for the entire network.
+         *
+         * @since 2.8.0
+         *
+         * @var bool
+         */
         public $plugin_network_active = false;
 
         /**
-         * @param array $args
+         * Constructor.
+         *
+         * Sets up the plugin upgrader skin.
+         *
+         * @since 2.8.0
+         *
+         * @param array $args Optional. The plugin upgrader skin arguments to
+         *                    override default options. Default is an empty array.
          */
         public function __construct( $args = array() ) {
                 $defaults = array(

class-theme-installer-skin.php

@@ -16 +16 @@
  * @see WP_Upgrader_Skin
  */
 class Theme_Installer_Skin extends WP_Upgrader_Skin {
+
+        /**
+         * Holds the theme data returned from WordPress.org API.
+         *
+         * @since 2.8.0
+         *
+         * @var array|object
+         */
         public $api;
+
+        /**
+         * Holds the installer type.
+         *
+         * @since 2.8.0
+         *
+         * @var string
+         */
         public $type;
 
         /**
-         * @param array $args
+         * Constructor.
+         *
+         * Sets up the theme installer skin.
+         *
+         * @since 2.8.0
+         *
+         * @param array $args Optional. The theme installer skin arguments to
+         *                    override default options. Default is an empty array.
          */
         public function __construct( $args = array() ) {
                 $defaults = array(

class-theme-upgrader-skin.php

@@ -16 +16 @@
  * @see WP_Upgrader_Skin
  */
 class Theme_Upgrader_Skin extends WP_Upgrader_Skin {
+
+        /**
+         * Holds the theme slug in the Theme Directory.
+         *
+         * @since 2.8.0
+         *
+         * @var object
+         */
         public $theme = '';
 
         /**
-         * @param array $args
+         * Constructor.
+         *
+         * Sets up the theme upgrader skin.
+         *
+         * @since 2.8.0
+         *
+         * @param array $args Optional. The theme upgrader skin arguments to
+         *                    override default options. Default is an empty array.
          */
         public function __construct( $args = array() ) {
                 $defaults = array(

class-wp-ajax-upgrader-skin.php

@@ -22 +22 @@
          * Holds the WP_Error object.
          *
          * @since 4.6.0
+         *
          * @var null|WP_Error
          */
         protected $errors = null;
@@ -29 +30 @@
         /**
          * Constructor.
          *
+         * Sets up the WordPress Ajax upgrader skin.
+         *
          * @since 4.6.0
          *
-         * @param array $args Options for the upgrader, see WP_Upgrader_Skin::__construct().
+         * @param array $args Optional. The WordPress Ajax upgrader skin arguments to
+         *                    override default options. Default is an empty array.
          */
         public function __construct( $args = array() ) {
                 parent::__construct( $args );

class-wp-upgrader-skin.php

@@ -15 +15 @@
  */
 class WP_Upgrader_Skin {
 
+        /**
+         * Holds the upgrader data.
+         *
+         * @since 2.8.0
+         *
+         * @var object
+         */
         public $upgrader;
+
+        /**
+         * Whether to header is done.
+         *
+         * @since 2.8.0
+         *
+         * @var bool
+         */
         public $done_header = false;
+
+        /**
+         * Whether to footer is done.
+         *
+         * @since 2.8.0
+         *
+         * @var bool
+         */
         public $done_footer = false;
 
         /**
@@ -23 +46 @@
          * Holds the result of an upgrade.
          *
          * @since 2.8.0
+         *
          * @var string|bool|WP_Error
          */
-        public $result  = false;
+        public $result = false;
+
+        /**
+         * Holds the options of an upgrade.
+         *
+         * @since 2.8.0
+         *
+         * @var array
+         */
         public $options = array();
 
         /**
-         * @param array $args
+         * Constructor.
+         *
+         * Sets up the generic skin for the WordPress Upgrader classes.
+         *
+         * @since 2.8.0
+         *
+         * @param array $args Optional. The WordPress upgrader skin arguments to
+         *                    override default options. Default is an empty array.
          */
         public function __construct( $args = array() ) {
                 $defaults      = array(