Changeset 48715 for trunk/src/wp-admin/includes/credits.php

Timestamp:

08/03/2020 12:51:22 PM (4 years ago)

Author:

SergeyBiryukov

Message:

Administration: Allow wp_credits() to accept $version and $locale parameters.

This can be helpful for plugin developers to get credits information for older versions or different locales.

Props ramiy.
Fixes #35910.

File:

• trunk/src/wp-admin/includes/credits.php (modified) (1 diff)

trunk/src/wp-admin/includes/credits.php

@@ -12 +12 @@
  *
  * @since 3.2.0
+ * @since 5.6.0 Added the `$version` and `$locale` parameters.
  *
+ * @param string $version WordPress version. Defaults to the current version.
+ * @param string $locale  WordPress locale. Defaults to the current user's locale.
  * @return array|false A list of all of the contributors, or false on error.
  */
-function wp_credits() {
-    // Include an unmodified $wp_version.
-    require ABSPATH . WPINC . '/version.php';
+function wp_credits( $version = '', $locale = '' ) {
+    if ( ! $version ) {
+        // Include an unmodified $wp_version.
+        require ABSPATH . WPINC . '/version.php';
 
-    $locale = get_user_locale();
+        $version = $wp_version;
+    }
+
+    if ( ! $locale ) {
+        $locale = get_user_locale();
+    }
 
     $results = get_site_transient( 'wordpress_credits_' . $locale );
 
     if ( ! is_array( $results )
-        || false !== strpos( $wp_version, '-' )
-        || ( isset( $results['data']['version'] ) && strpos( $wp_version, $results['data']['version'] ) !== 0 )
+        || false !== strpos( $version, '-' )
+        || ( isset( $results['data']['version'] ) && strpos( $version, $results['data']['version'] ) !== 0 )
     ) {
-        $url     = "http://api.wordpress.org/core/credits/1.1/?version={$wp_version}&locale={$locale}";
-        $options = array( 'user-agent' => 'WordPress/' . $wp_version . '; ' . home_url( '/' ) );
+        $url     = "http://api.wordpress.org/core/credits/1.1/?version={$version}&locale={$locale}";
+        $options = array( 'user-agent' => 'WordPress/' . $version . '; ' . home_url( '/' ) );
 
         if ( wp_http_supports( array( 'ssl' ) ) ) {