Changeset 41289 for trunk/src/wp-admin/includes/plugin-install.php

Timestamp:

08/22/2017 11:51:11 AM (9 years ago)

Author:

johnbillion

Message:

General: Improve terminology used when referring to installations of WordPress and its extensions.

"Install" is not a noun, and while it might be acceptable to use the verb as a noun, it is not correct. Using the correct
noun, "installation", increases clarity, especially for non-native English speakers.

This change fixes the usage in user-facing text and in developer documentation.

Fixes #41620

File:

• trunk/src/wp-admin/includes/plugin-install.php (modified) (8 diffs)

trunk/src/wp-admin/includes/plugin-install.php

@@ -20 +20 @@
  *
  * The second filter, {@see 'plugins_api'}, allows a plugin to override the WordPress.org
- * Plugin Install API entirely. If `$action` is 'query_plugins' or 'plugin_information',
+ * Plugin Installation API entirely. If `$action` is 'query_plugins' or 'plugin_information',
  * an object MUST be passed. If `$action` is 'hot_tags' or 'hot_categories', an array MUST
  * be passed.
@@ -90 +90 @@
  *         @type bool $banners           Whether to return the banner images links. Default false.
  *         @type bool $icons             Whether to return the icon links. Default false.
- *         @type bool $active_installs   Whether to return the number of active installs. Default false.
+ *         @type bool $active_installs   Whether to return the number of active installations. Default false.
  *         @type bool $group             Whether to return the assigned group. Default false.
  *         @type bool $contributors      Whether to return the list of contributors. Default false.
@@ -114 +114 @@
 
         /**
-         * Filters the WordPress.org Plugin Install API arguments.
+         * Filters the WordPress.org Plugin Installation API arguments.
          *
          * Important: An object MUST be returned to this filter.
@@ -121 +121 @@
          *
          * @param object $args   Plugin API arguments.
-         * @param string $action The type of information being requested from the Plugin Install API.
+         * @param string $action The type of information being requested from the Plugin Installation API.
          */
         $args = apply_filters( 'plugins_api_args', $args, $action );
 
         /**
-         * Filters the response for the current WordPress.org Plugin Install API request.
+         * Filters the response for the current WordPress.org Plugin Installation API request.
          *
          * Passing a non-false value will effectively short-circuit the WordPress.org API request.
@@ -136 +136 @@
          *
          * @param false|object|array $result The result object or array. Default false.
-         * @param string             $action The type of information being requested from the Plugin Install API.
+         * @param string             $action The type of information being requested from the Plugin Installation API.
          * @param object             $args   Plugin API arguments.
          */
@@ -194 +194 @@
 
         /**
-         * Filters the Plugin Install API response results.
+         * Filters the Plugin Installation API response results.
          *
          * @since 2.7.0
          *
          * @param object|WP_Error $res    Response object or WP_Error.
-         * @param string          $action The type of information being requested from the Plugin Install API.
+         * @param string          $action The type of information being requested from the Plugin Installation API.
          * @param object          $args   Plugin API arguments.
          */
@@ -516 +516 @@
         }
 
-        iframe_header( __( 'Plugin Install' ) );
+        iframe_header( __( 'Plugin Installation' ) );
 
         $_with_banner = '';
@@ -588 +588 @@
                                 <li><strong><?php _e( 'Compatible up to:' ); ?></strong> <?php echo $api->tested; ?></li>
                         <?php } if ( isset( $api->active_installs ) ) { ?>
-                                <li><strong><?php _e( 'Active Installs:' ); ?></strong> <?php
+                                <li><strong><?php _e( 'Active Installations:' ); ?></strong> <?php
                                         if ( $api->active_installs >= 1000000 ) {
-                                                _ex( '1+ Million', 'Active plugin installs' );
+                                                _ex( '1+ Million', 'Active plugin installations' );
                                         } elseif ( 0 == $api->active_installs ) {
-                                                _ex( 'Less Than 10', 'Active plugin installs' );
+                                                _ex( 'Less Than 10', 'Active plugin installations' );
                                         } else {
                                                 echo number_format_i18n( $api->active_installs ) . '+';