Make WordPress Core

Changeset 55014


Ignore:
Timestamp:
12/23/2022 11:36:13 AM (16 months ago)
Author:
SergeyBiryukov
Message:

Code Modernization: Rename parameters that use reserved keywords in wp-includes/theme.php.

While using reserved PHP keywords as parameter name labels is allowed, in the context of function calls using named parameters in PHP 8.0+, this will easily lead to confusion. To avoid that, it is recommended not to use reserved keywords as function parameter names.

This commit:

  • Renames the $default parameter to $default_value in get_theme_mod().
  • Renames the $include parameter to $file in require_if_theme_supports().

Follow-up to [52946], [52996], [52997], [52998], [53003], [53014], [53029], [53039], [53116], [53117], [53137], [53174], [53184], [53185], [53192], [53193], [53198], [53203], [53207], [53215], [53216], [53220], [53230], [53232], [53236], [53239], [53240], [53242], [53243], [53245], [53246], [53257], [53269], [53270], [53271], [53272], [53273], [53274], [53275], [53276], [53277], [53281], [53283], [53284], [53285], [53287], [53364], [53365], [54927], [54929], [54930], [54931], [54932], [54933], [54938], [54943], [54944], [54945], [54946], [54947], [54948], [54950], [54951], [54952], [54956], [54959], [54960], [54961], [54962], [54964], [54965], [54969], [54970], [54971], [54972], [54996], [55000], [55011], [55013].

Props jrf, aristath, poena, justinahinon, SergeyBiryukov.
See #56788.

File:
1 edited

Legend:

Unmodified
Added
Removed
  • trunk/src/wp-includes/theme.php

    r54891 r55014  
    992992 * Retrieves theme modification value for the active theme.
    993993 *
    994  * If the modification name does not exist and `$default` is a string, then the
     994 * If the modification name does not exist and `$default_value` is a string, then the
    995995 * default will be passed through the {@link https://www.php.net/sprintf sprintf()}
    996996 * PHP function with the template directory URI as the first value and the
     
    999999 * @since 2.1.0
    10001000 *
    1001  * @param string $name    Theme modification name.
    1002  * @param mixed  $default Optional. Theme modification default value. Default false.
     1001 * @param string $name          Theme modification name.
     1002 * @param mixed  $default_value Optional. Theme modification default value. Default false.
    10031003 * @return mixed Theme modification value.
    10041004 */
    1005 function get_theme_mod( $name, $default = false ) {
     1005function get_theme_mod( $name, $default_value = false ) {
    10061006    $mods = get_theme_mods();
    10071007
     
    10211021    }
    10221022
    1023     if ( is_string( $default ) ) {
     1023    if ( is_string( $default_value ) ) {
    10241024        // Only run the replacement if an sprintf() string format pattern was found.
    1025         if ( preg_match( '#(?<!%)%(?:\d+\$?)?s#', $default ) ) {
     1025        if ( preg_match( '#(?<!%)%(?:\d+\$?)?s#', $default_value ) ) {
    10261026            // Remove a single trailing percent sign.
    1027             $default = preg_replace( '#(?<!%)%$#', '', $default );
    1028             $default = sprintf( $default, get_template_directory_uri(), get_stylesheet_directory_uri() );
     1027            $default_value = preg_replace( '#(?<!%)%$#', '', $default_value );
     1028            $default_value = sprintf( $default_value, get_template_directory_uri(), get_stylesheet_directory_uri() );
    10291029        }
    10301030    }
    10311031
    10321032    /** This filter is documented in wp-includes/theme.php */
    1033     return apply_filters( "theme_mod_{$name}", $default );
     1033    return apply_filters( "theme_mod_{$name}", $default_value );
    10341034}
    10351035
     
    31263126 * @param string $feature The feature being checked. See add_theme_support() for the list
    31273127 *                        of possible values.
    3128  * @param string $include Path to the file.
     3128 * @param string $file    Path to the file.
    31293129 * @return bool True if the active theme supports the supplied feature, false otherwise.
    31303130 */
    3131 function require_if_theme_supports( $feature, $include ) {
     3131function require_if_theme_supports( $feature, $file ) {
    31323132    if ( current_theme_supports( $feature ) ) {
    3133         require $include;
     3133        require $file;
    31343134        return true;
    31353135    }
Note: See TracChangeset for help on using the changeset viewer.