From 75d72087412221ae9f402d0afb126aa70caf0a77 Mon Sep 17 00:00:00 2001 From: John Blackbourn Date: Mon, 19 Jun 2023 18:26:01 +0000 Subject: [PATCH] General: Replace some instances of "blog" with "site" in documentation, translator comments, and user-facing text strings. This is not an exhaustive change, but it gets us closer to using "site" in place of "blog" in as many places as possible. Props NekoJonez, audrasjb, oglekler Fixes #58117 git-svn-id: https://develop.svn.wordpress.org/trunk@55942 602fd350-edb4-49c9-b593-d223f7449a82 --- src/wp-admin/edit-comments.php | 2 +- src/wp-admin/includes/export.php | 2 +- src/wp-content/themes/twentyeleven/header.php | 4 ++-- src/wp-content/themes/twentyten/header.php | 4 ++-- src/wp-includes/general-template.php | 22 +++++++++---------- src/wp-includes/ms-blogs.php | 8 +++---- src/wp-includes/ms-deprecated.php | 2 +- src/wp-includes/ms-functions.php | 12 +++++----- src/wp-includes/theme-compat/footer.php | 2 +- src/wp-signup.php | 2 +- src/wp-trackback.php | 2 +- tests/phpunit/tests/customize/manager.php | 2 +- .../phpunit/tests/general/feedLinksExtra.php | 2 +- 13 files changed, 33 insertions(+), 33 deletions(-) diff --git a/src/wp-admin/edit-comments.php b/src/wp-admin/edit-comments.php index d1960c91b4..d7f14f2cd0 100644 --- a/src/wp-admin/edit-comments.php +++ b/src/wp-admin/edit-comments.php @@ -216,7 +216,7 @@ get_current_screen()->add_help_tab( 'title' => __( 'Moderating Comments' ), 'content' => '

' . __( 'A red bar on the left means the comment is waiting for you to moderate it.' ) . '

' . - '

' . __( 'In the Author column, in addition to the author’s name, email address, and blog URL, the commenter’s IP address is shown. Clicking on this link will show you all the comments made from this IP address.' ) . '

' . + '

' . __( 'In the Author column, in addition to the author’s name, email address, and site URL, the commenter’s IP address is shown. Clicking on this link will show you all the comments made from this IP address.' ) . '

' . '

' . __( 'In the Comment column, hovering over any comment gives you options to approve, reply (and approve), quick edit, edit, spam mark, or trash that comment.' ) . '

' . '

' . __( 'In the In response to column, there are three elements. The text is the name of the post that inspired the comment, and links to the post editor for that entry. The View Post link leads to that post on your live site. The small bubble with the number in it shows the number of approved comments that post has received. If there are pending comments, a red notification circle with the number of pending comments is displayed. Clicking the notification circle will filter the comments screen to show only pending comments on that post.' ) . '

' . '

' . __( 'In the Submitted on column, the date and time the comment was left on your site appears. Clicking on the date/time link will take you to that comment on your live site.' ) . '

' . diff --git a/src/wp-admin/includes/export.php b/src/wp-admin/includes/export.php index 0707b25db1..9610ac8c9f 100644 --- a/src/wp-admin/includes/export.php +++ b/src/wp-admin/includes/export.php @@ -218,7 +218,7 @@ function export_wp( $args = array() ) { // Multisite: the base URL. return network_home_url(); } else { - // WordPress (single site): the blog URL. + // WordPress (single site): the site URL. return get_bloginfo_rss( 'url' ); } } diff --git a/src/wp-content/themes/twentyeleven/header.php b/src/wp-content/themes/twentyeleven/header.php index 62d9b344dd..dc404ab0b0 100644 --- a/src/wp-content/themes/twentyeleven/header.php +++ b/src/wp-content/themes/twentyeleven/header.php @@ -31,10 +31,10 @@ wp_title( '|', true, 'right' ); - // Add the blog name. + // Add the site name. bloginfo( 'name' ); - // Add the blog description for the home/front page. + // Add the site description for the home/front page. $site_description = get_bloginfo( 'description', 'display' ); if ( $site_description && ( is_home() || is_front_page() ) ) { echo " | $site_description"; diff --git a/src/wp-content/themes/twentyten/header.php b/src/wp-content/themes/twentyten/header.php index 10bd5922fc..7a4aca16f0 100644 --- a/src/wp-content/themes/twentyten/header.php +++ b/src/wp-content/themes/twentyten/header.php @@ -21,10 +21,10 @@ wp_title( '|', true, 'right' ); - // Add the blog name. + // Add the site name. bloginfo( 'name' ); - // Add the blog description for the home/front page. + // Add the site description for the home/front page. $site_description = get_bloginfo( 'description', 'display' ); if ( $site_description && ( is_home() || is_front_page() ) ) { echo " | $site_description"; diff --git a/src/wp-includes/general-template.php b/src/wp-includes/general-template.php index 39c2c84c0a..698c5fcace 100644 --- a/src/wp-includes/general-template.php +++ b/src/wp-includes/general-template.php @@ -3096,11 +3096,11 @@ function feed_links( $args = array() ) { } $defaults = array( - /* translators: Separator between blog name and feed type in feed links. */ + /* translators: Separator between site name and feed type in feed links. */ 'separator' => _x( '»', 'feed link' ), - /* translators: 1: Blog title, 2: Separator (raquo). */ + /* translators: 1: Site title, 2: Separator (raquo). */ 'feedtitle' => __( '%1$s %2$s Feed' ), - /* translators: 1: Blog title, 2: Separator (raquo). */ + /* translators: 1: Site title, 2: Separator (raquo). */ 'comstitle' => __( '%1$s %2$s Comments Feed' ), ); @@ -3148,21 +3148,21 @@ function feed_links( $args = array() ) { */ function feed_links_extra( $args = array() ) { $defaults = array( - /* translators: Separator between blog name and feed type in feed links. */ + /* translators: Separator between site name and feed type in feed links. */ 'separator' => _x( '»', 'feed link' ), - /* translators: 1: Blog name, 2: Separator (raquo), 3: Post title. */ + /* translators: 1: Site name, 2: Separator (raquo), 3: Post title. */ 'singletitle' => __( '%1$s %2$s %3$s Comments Feed' ), - /* translators: 1: Blog name, 2: Separator (raquo), 3: Category name. */ + /* translators: 1: Site name, 2: Separator (raquo), 3: Category name. */ 'cattitle' => __( '%1$s %2$s %3$s Category Feed' ), - /* translators: 1: Blog name, 2: Separator (raquo), 3: Tag name. */ + /* translators: 1: Site name, 2: Separator (raquo), 3: Tag name. */ 'tagtitle' => __( '%1$s %2$s %3$s Tag Feed' ), - /* translators: 1: Blog name, 2: Separator (raquo), 3: Term name, 4: Taxonomy singular name. */ + /* translators: 1: Site name, 2: Separator (raquo), 3: Term name, 4: Taxonomy singular name. */ 'taxtitle' => __( '%1$s %2$s %3$s %4$s Feed' ), - /* translators: 1: Blog name, 2: Separator (raquo), 3: Author name. */ + /* translators: 1: Site name, 2: Separator (raquo), 3: Author name. */ 'authortitle' => __( '%1$s %2$s Posts by %3$s Feed' ), - /* translators: 1: Blog name, 2: Separator (raquo), 3: Search query. */ + /* translators: 1: Site name, 2: Separator (raquo), 3: Search query. */ 'searchtitle' => __( '%1$s %2$s Search Results for “%3$s” Feed' ), - /* translators: 1: Blog name, 2: Separator (raquo), 3: Post type name. */ + /* translators: 1: Site name, 2: Separator (raquo), 3: Post type name. */ 'posttypetitle' => __( '%1$s %2$s %3$s Feed' ), ); diff --git a/src/wp-includes/ms-blogs.php b/src/wp-includes/ms-blogs.php index 94e037f754..035b93e9da 100644 --- a/src/wp-includes/ms-blogs.php +++ b/src/wp-includes/ms-blogs.php @@ -31,12 +31,12 @@ function wpmu_update_blogs_date() { } /** - * Gets a full blog URL, given a blog ID. + * Gets a full site URL, given a site ID. * * @since MU (3.0.0) * - * @param int $blog_id Blog ID. - * @return string Full URL of the blog if found. Empty string if not. + * @param int $blog_id Site ID. + * @return string Full site URL if found. Empty string if not. */ function get_blogaddress_by_id( $blog_id ) { $bloginfo = get_site( (int) $blog_id ); @@ -52,7 +52,7 @@ function get_blogaddress_by_id( $blog_id ) { } /** - * Gets a full blog URL, given a blog name. + * Gets a full site URL, given a site name. * * @since MU (3.0.0) * diff --git a/src/wp-includes/ms-deprecated.php b/src/wp-includes/ms-deprecated.php index e526c88419..87ecfdf5c9 100644 --- a/src/wp-includes/ms-deprecated.php +++ b/src/wp-includes/ms-deprecated.php @@ -355,7 +355,7 @@ function get_user_id_from_string( $email_or_login ) { } /** - * Get a full blog URL, given a domain and a path. + * Get a full site URL, given a domain and a path. * * @since MU (3.0.0) * @deprecated 3.7.0 diff --git a/src/wp-includes/ms-functions.php b/src/wp-includes/ms-functions.php index 3ecbf7691f..7bd74f2e36 100644 --- a/src/wp-includes/ms-functions.php +++ b/src/wp-includes/ms-functions.php @@ -604,12 +604,12 @@ function wpmu_validate_user_signup( $user_name, $user_email ) { * @global wpdb $wpdb WordPress database abstraction object. * @global string $domain * - * @param string $blogname The blog name provided by the user. Must be unique. - * @param string $blog_title The blog title provided by the user. + * @param string $blogname The site name provided by the user. Must be unique. + * @param string $blog_title The site title provided by the user. * @param WP_User|string $user Optional. The user object to check against the new site name. * Default empty string. * @return array { - * Array of domain, path, blog name, blog title, user and error messages. + * Array of domain, path, site name, site title, user and error messages. * * @type string $domain Domain for the site. * @type string $path Path for the site. Used in subdirectory installations. @@ -752,12 +752,12 @@ function wpmu_validate_blog_signup( $blogname, $blog_title, $user = '' ) { * @since MU (3.0.0) * * @param array $result { - * Array of domain, path, blog name, blog title, user and error messages. + * Array of domain, path, site name, site title, user and error messages. * * @type string $domain Domain for the site. * @type string $path Path for the site. Used in subdirectory installations. * @type string $blogname The unique site name (slug). - * @type string $blog_title Blog title. + * @type string $blog_title Site title. * @type string|WP_User $user By default, an empty string. A user object if provided. * @type WP_Error $errors WP_Error containing any errors found. * } @@ -2387,7 +2387,7 @@ function force_ssl_content( $force = '' ) { */ function filter_SSL( $url ) { // phpcs:ignore WordPress.NamingConventions.ValidFunctionName.FunctionNameInvalid if ( ! is_string( $url ) ) { - return get_bloginfo( 'url' ); // Return home blog URL with proper scheme. + return get_bloginfo( 'url' ); // Return home site URL with proper scheme. } if ( force_ssl_content() && is_ssl() ) { diff --git a/src/wp-includes/theme-compat/footer.php b/src/wp-includes/theme-compat/footer.php index 53f6d31373..2a719e18f0 100644 --- a/src/wp-includes/theme-compat/footer.php +++ b/src/wp-includes/theme-compat/footer.php @@ -22,7 +22,7 @@ _deprecated_file(

WordPress' diff --git a/src/wp-signup.php b/src/wp-signup.php index 8b40dec9e5..d11f16698f 100644 --- a/src/wp-signup.php +++ b/src/wp-signup.php @@ -113,7 +113,7 @@ function show_blog_form( $blogname = '', $blog_title = '', $errors = '' ) { } $current_network = get_network(); - // Blog name. + // Site name. if ( ! is_subdomain_install() ) { echo ''; } else { diff --git a/src/wp-trackback.php b/src/wp-trackback.php index 7512e33fb4..1e4ec3c993 100644 --- a/src/wp-trackback.php +++ b/src/wp-trackback.php @@ -106,7 +106,7 @@ if ( ! empty( $trackback_url ) && ! empty( $title ) ) { * @param string $charset Character set. * @param string $title Trackback title. * @param string $excerpt Trackback excerpt. - * @param string $blog_name Blog name. + * @param string $blog_name Site name. */ do_action( 'pre_trackback_post', $post_id, $trackback_url, $charset, $title, $excerpt, $blog_name ); diff --git a/tests/phpunit/tests/customize/manager.php b/tests/phpunit/tests/customize/manager.php index a3b19dd294..f9b9b49cec 100644 --- a/tests/phpunit/tests/customize/manager.php +++ b/tests/phpunit/tests/customize/manager.php @@ -764,7 +764,7 @@ class Tests_WP_Customize_Manager extends WP_UnitTestCase { /* * Test that adding blogname starter content is ignored now that it is modified, - * but updating a non-modified starter content blog description passes. + * but updating a non-modified starter content site description passes. */ $previous_blogname = $changeset_data['blogname']['value']; $previous_blogdescription = $changeset_data['blogdescription']['value']; diff --git a/tests/phpunit/tests/general/feedLinksExtra.php b/tests/phpunit/tests/general/feedLinksExtra.php index d6a688da0d..ee7f93640f 100644 --- a/tests/phpunit/tests/general/feedLinksExtra.php +++ b/tests/phpunit/tests/general/feedLinksExtra.php @@ -172,7 +172,7 @@ class Tests_General_FeedLinksExtra extends WP_UnitTestCase { * @param array $args { * Optional arguments. Default empty. * - * @type string $separator The separator between blog name and feed type. + * @type string $separator The separator between site name and feed type. * @type string $singletitle The title of the comments feed. * @type string $cattitle The title of the category feed. * @type string $tagtitle The title of the tag feed.