WordPress.org
Get WordPress

Make WordPress Core


Ignore:
Timestamp:
11/30/2017 11:09:33 PM (8 years ago)
Author:
pento
Message:

Code is Poetry.
WordPress' code just... wasn't.
This is now dealt with.

Props jrf, pento, netweb, GaryJ, jdgrimes, westonruter, Greg Sherwood from PHPCS, and everyone who's ever contributed to WPCS and PHPCS.
Fixes #41057.

File:
1 edited

Legend:

Unmodified
Added
Removed

  • trunk/src/wp-includes/option.php

    r42228 r42343  
    3232
    3333    $option = trim( $option );
    34     if ( empty( $option ) )
     34    if ( empty( $option ) ) {
    3535        return false;
     36    }
    3637
    3738    /**
    … …  
    4647     * @since 4.4.0 The `$option` parameter was added.
    4748     * @since 4.9.0 The `$default` parameter was added.
    48      *
    4949     *
    5050     * @param bool|mixed $pre_option The value to return instead of the option value. This differs from
    … …  
    5858    $pre = apply_filters( "pre_option_{$option}", false, $option, $default );
    5959
    60     if ( false !== $pre )
     60    if ( false !== $pre ) {
    6161        return $pre;
    62 
    63     if ( defined( 'WP_SETUP_CONFIG' ) )
     62    }
     63
     64    if ( defined( 'WP_SETUP_CONFIG' ) ) {
    6465        return false;
     66    }
    6567
    6668    // Distinguish between `false` as a default, and not passing one.
    … …  
    9092        $alloptions = wp_load_alloptions();
    9193
    92         if ( isset( $alloptions[$option] ) ) {
    93             $value = $alloptions[$option];
     94        if ( isset( $alloptions[ $option ] ) ) {
     95            $value = $alloptions[ $option ];
    9496        } else {
    9597            $value = wp_cache_get( $option, 'options' );
    … …  
    106108                        $notoptions = array();
    107109                    }
    108                     $notoptions[$option] = true;
     110                    $notoptions[ $option ] = true;
    109111                    wp_cache_set( 'notoptions', $notoptions, 'options' );
    110112
    … …  
    116118    } else {
    117119        $suppress = $wpdb->suppress_errors();
    118         $row = $wpdb->get_row( $wpdb->prepare( "SELECT option_value FROM $wpdb->options WHERE option_name = %s LIMIT 1", $option ) );
     120        $row      = $wpdb->get_row( $wpdb->prepare( "SELECT option_value FROM $wpdb->options WHERE option_name = %s LIMIT 1", $option ) );
    119121        $wpdb->suppress_errors( $suppress );
    120122        if ( is_object( $row ) ) {
    … …  
    127129
    128130    // If home is not set use siteurl.
    129     if ( 'home' == $option && '' == $value )
     131    if ( 'home' == $option && '' == $value ) {
    130132        return get_option( 'siteurl' );
    131 
    132     if ( in_array( $option, array('siteurl', 'home', 'category_base', 'tag_base') ) )
     133    }
     134
     135    if ( in_array( $option, array( 'siteurl', 'home', 'category_base', 'tag_base' ) ) ) {
    133136        $value = untrailingslashit( $value );
     137    }
    134138
    135139    /**
    … …  
    160164 */
    161165function wp_protect_special_option( $option ) {
    162     if ( 'alloptions' === $option || 'notoptions' === $option )
     166    if ( 'alloptions' === $option || 'notoptions' === $option ) {
    163167        wp_die( sprintf( __( '%s is a protected WP option and may not be modified' ), esc_html( $option ) ) );
     168    }
    164169}
    165170
    … …  
    202207        $alloptions = array();
    203208        foreach ( (array) $alloptions_db as $o ) {
    204             $alloptions[$o->option_name] = $o->option_value;
     209            $alloptions[ $o->option_name ] = $o->option_value;
    205210        }
    206211
    … …  
    240245    global $wpdb;
    241246
    242     if ( ! is_multisite() || wp_using_ext_object_cache() || wp_installing() )
     247    if ( ! is_multisite() || wp_using_ext_object_cache() || wp_installing() ) {
    243248        return;
    244 
    245     if ( empty($network_id) )
     249    }
     250
     251    if ( empty( $network_id ) ) {
    246252        $network_id = get_current_network_id();
    247 
    248     $core_options = array('site_name', 'siteurl', 'active_sitewide_plugins', '_site_transient_timeout_theme_roots', '_site_transient_theme_roots', 'site_admins', 'can_compress_scripts', 'global_terms_enabled', 'ms_files_rewriting' );
    249 
    250     $core_options_in = "'" . implode("', '", $core_options) . "'";
    251     $options = $wpdb->get_results( $wpdb->prepare( "SELECT meta_key, meta_value FROM $wpdb->sitemeta WHERE meta_key IN ($core_options_in) AND site_id = %d", $network_id ) );
     253    }
     254
     255    $core_options = array( 'site_name', 'siteurl', 'active_sitewide_plugins', '_site_transient_timeout_theme_roots', '_site_transient_theme_roots', 'site_admins', 'can_compress_scripts', 'global_terms_enabled', 'ms_files_rewriting' );
     256
     257    $core_options_in = "'" . implode( "', '", $core_options ) . "'";
     258    $options         = $wpdb->get_results( $wpdb->prepare( "SELECT meta_key, meta_value FROM $wpdb->sitemeta WHERE meta_key IN ($core_options_in) AND site_id = %d", $network_id ) );
    252259
    253260    foreach ( $options as $option ) {
    254         $key = $option->meta_key;
    255         $cache_key = "{$network_id}:$key";
     261        $key                = $option->meta_key;
     262        $cache_key          = "{$network_id}:$key";
    256263        $option->meta_value = maybe_unserialize( $option->meta_value );
    257264
    … …  
    286293    global $wpdb;
    287294
    288     $option = trim($option);
    289     if ( empty($option) )
     295    $option = trim( $option );
     296    if ( empty( $option ) ) {
    290297        return false;
     298    }
    291299
    292300    wp_protect_special_option( $option );
    293301
    294     if ( is_object( $value ) )
     302    if ( is_object( $value ) ) {
    295303        $value = clone $value;
    296 
    297     $value = sanitize_option( $option, $value );
     304    }
     305
     306    $value     = sanitize_option( $option, $value );
    298307    $old_value = get_option( $option );
    299308
    … …  
    368377
    369378    $result = $wpdb->update( $wpdb->options, $update_args, array( 'option_name' => $option ) );
    370     if ( ! $result )
     379    if ( ! $result ) {
    371380        return false;
     381    }
    372382
    373383    $notoptions = wp_cache_get( 'notoptions', 'options' );
    374     if ( is_array( $notoptions ) && isset( $notoptions[$option] ) ) {
    375         unset( $notoptions[$option] );
     384    if ( is_array( $notoptions ) && isset( $notoptions[ $option ] ) ) {
     385        unset( $notoptions[ $option ] );
    376386        wp_cache_set( 'notoptions', $notoptions, 'options' );
    377387    }
    … …  
    379389    if ( ! wp_installing() ) {
    380390        $alloptions = wp_load_alloptions();
    381         if ( isset( $alloptions[$option] ) ) {
     391        if ( isset( $alloptions[ $option ] ) ) {
    382392            $alloptions[ $option ] = $serialized_value;
    383393            wp_cache_set( 'alloptions', $alloptions, 'options' );
    … …  
    440450    global $wpdb;
    441451
    442     if ( !empty( $deprecated ) )
     452    if ( ! empty( $deprecated ) ) {
    443453        _deprecated_argument( __FUNCTION__, '2.3.0' );
    444 
    445     $option = trim($option);
    446     if ( empty($option) )
     454    }
     455
     456    $option = trim( $option );
     457    if ( empty( $option ) ) {
    447458        return false;
     459    }
    448460
    449461    wp_protect_special_option( $option );
    450462
    451     if ( is_object($value) )
     463    if ( is_object( $value ) ) {
    452464        $value = clone $value;
     465    }
    453466
    454467    $value = sanitize_option( $option, $value );
    … …  
    456469    // Make sure the option doesn't already exist. We can check the 'notoptions' cache before we ask for a db query
    457470    $notoptions = wp_cache_get( 'notoptions', 'options' );
    458     if ( !is_array( $notoptions ) || !isset( $notoptions[$option] ) )
     471    if ( ! is_array( $notoptions ) || ! isset( $notoptions[ $option ] ) ) {
    459472        /** This filter is documented in wp-includes/option.php */
    460         if ( apply_filters( "default_option_{$option}", false, $option, false ) !== get_option( $option ) )
     473        if ( apply_filters( "default_option_{$option}", false, $option, false ) !== get_option( $option ) ) {
    461474            return false;
     475        }
     476    }
    462477
    463478    $serialized_value = maybe_serialize( $value );
    464     $autoload = ( 'no' === $autoload || false === $autoload ) ? 'no' : 'yes';
     479    $autoload         = ( 'no' === $autoload || false === $autoload ) ? 'no' : 'yes';
    465480
    466481    /**
    … …  
    475490
    476491    $result = $wpdb->query( $wpdb->prepare( "INSERT INTO `$wpdb->options` (`option_name`, `option_value`, `autoload`) VALUES (%s, %s, %s) ON DUPLICATE KEY UPDATE `option_name` = VALUES(`option_name`), `option_value` = VALUES(`option_value`), `autoload` = VALUES(`autoload`)", $option, $serialized_value, $autoload ) );
    477     if ( ! $result )
     492    if ( ! $result ) {
    478493        return false;
     494    }
    479495
    480496    if ( ! wp_installing() ) {
    481497        if ( 'yes' == $autoload ) {
    482             $alloptions = wp_load_alloptions();
     498            $alloptions            = wp_load_alloptions();
    483499            $alloptions[ $option ] = $serialized_value;
    484500            wp_cache_set( 'alloptions', $alloptions, 'options' );
    … …  
    490506    // This option exists now
    491507    $notoptions = wp_cache_get( 'notoptions', 'options' ); // yes, again... we need it to be fresh
    492     if ( is_array( $notoptions ) && isset( $notoptions[$option] ) ) {
    493         unset( $notoptions[$option] );
     508    if ( is_array( $notoptions ) && isset( $notoptions[ $option ] ) ) {
     509        unset( $notoptions[ $option ] );
    494510        wp_cache_set( 'notoptions', $notoptions, 'options' );
    495511    }
    … …  
    534550
    535551    $option = trim( $option );
    536     if ( empty( $option ) )
     552    if ( empty( $option ) ) {
    537553        return false;
     554    }
    538555
    539556    wp_protect_special_option( $option );
    … …  
    541558    // Get the ID, if no ID then return
    542559    $row = $wpdb->get_row( $wpdb->prepare( "SELECT autoload FROM $wpdb->options WHERE option_name = %s", $option ) );
    543     if ( is_null( $row ) )
     560    if ( is_null( $row ) ) {
    544561        return false;
     562    }
    545563
    546564    /**
    … …  
    557575        if ( 'yes' == $row->autoload ) {
    558576            $alloptions = wp_load_alloptions();
    559             if ( is_array( $alloptions ) && isset( $alloptions[$option] ) ) {
    560                 unset( $alloptions[$option] );
     577            if ( is_array( $alloptions ) && isset( $alloptions[ $option ] ) ) {
     578                unset( $alloptions[ $option ] );
    561579                wp_cache_set( 'alloptions', $alloptions, 'options' );
    562580            }
    … …  
    616634    } else {
    617635        $option_timeout = '_transient_timeout_' . $transient;
    618         $option = '_transient_' . $transient;
    619         $result = delete_option( $option );
    620         if ( $result )
     636        $option         = '_transient_' . $transient;
     637        $result         = delete_option( $option );
     638        if ( $result ) {
    621639            delete_option( $option_timeout );
     640        }
    622641    }
    623642
    … …  
    667686     */
    668687    $pre = apply_filters( "pre_transient_{$transient}", false, $transient );
    669     if ( false !== $pre )
     688    if ( false !== $pre ) {
    670689        return $pre;
     690    }
    671691
    672692    if ( wp_using_ext_object_cache() ) {
    … …  
    677697            // If option is not in alloptions, it is not autoloaded and thus has a timeout
    678698            $alloptions = wp_load_alloptions();
    679             if ( !isset( $alloptions[$transient_option] ) ) {
     699            if ( ! isset( $alloptions[ $transient_option ] ) ) {
    680700                $transient_timeout = '_transient_timeout_' . $transient;
    681                 $timeout = get_option( $transient_timeout );
     701                $timeout           = get_option( $transient_timeout );
    682702                if ( false !== $timeout && $timeout < time() ) {
    683                     delete_option( $transient_option  );
     703                    delete_option( $transient_option );
    684704                    delete_option( $transient_timeout );
    685705                    $value = false;
    … …  
    688708        }
    689709
    690         if ( ! isset( $value ) )
     710        if ( ! isset( $value ) ) {
    691711            $value = get_option( $transient_option );
     712        }
    692713    }
    693714
    … …  
    757778    } else {
    758779        $transient_timeout = '_transient_timeout_' . $transient;
    759         $transient_option = '_transient_' . $transient;
     780        $transient_option  = '_transient_' . $transient;
    760781        if ( false === get_option( $transient_option ) ) {
    761782            $autoload = 'yes';
    … …  
    834855    }
    835856
    836     $wpdb->query( $wpdb->prepare(
    837         "DELETE a, b FROM {$wpdb->options} a, {$wpdb->options} b
     857    $wpdb->query(
     858        $wpdb->prepare(
     859            "DELETE a, b FROM {$wpdb->options} a, {$wpdb->options} b
    838860            WHERE a.option_name LIKE %s
    839861            AND a.option_name NOT LIKE %s
    840862            AND b.option_name = CONCAT( '_transient_timeout_', SUBSTRING( a.option_name, 12 ) )
    841863            AND b.option_value < %d",
    842         $wpdb->esc_like( '_transient_' ) . '%',
    843         $wpdb->esc_like( '_transient_timeout_' ) . '%',
    844         time()
    845     ) );
     864            $wpdb->esc_like( '_transient_' ) . '%',
     865            $wpdb->esc_like( '_transient_timeout_' ) . '%',
     866            time()
     867        )
     868    );
    846869
    847870    if ( ! is_multisite() ) {
    848871        // non-Multisite stores site transients in the options table.
    849         $wpdb->query( $wpdb->prepare(
    850             "DELETE a, b FROM {$wpdb->options} a, {$wpdb->options} b
     872        $wpdb->query(
     873            $wpdb->prepare(
     874                "DELETE a, b FROM {$wpdb->options} a, {$wpdb->options} b
    851875                WHERE a.option_name LIKE %s
    852876                AND a.option_name NOT LIKE %s
    853877                AND b.option_name = CONCAT( '_site_transient_timeout_', SUBSTRING( a.option_name, 17 ) )
    854878                AND b.option_value < %d",
    855             $wpdb->esc_like( '_site_transient_' ) . '%',
    856             $wpdb->esc_like( '_site_transient_timeout_' ) . '%',
    857             time()
    858         ) );
     879                $wpdb->esc_like( '_site_transient_' ) . '%',
     880                $wpdb->esc_like( '_site_transient_timeout_' ) . '%',
     881                time()
     882            )
     883        );
    859884    } elseif ( is_multisite() && is_main_site() && is_main_network() ) {
    860885        // Multisite stores site transients in the sitemeta table.
    861         $wpdb->query( $wpdb->prepare(
    862             "DELETE a, b FROM {$wpdb->sitemeta} a, {$wpdb->sitemeta} b
     886        $wpdb->query(
     887            $wpdb->prepare(
     888                "DELETE a, b FROM {$wpdb->sitemeta} a, {$wpdb->sitemeta} b
    863889                WHERE a.meta_key LIKE %s
    864890                AND a.meta_key NOT LIKE %s
    865891                AND b.meta_key = CONCAT( '_site_transient_timeout_', SUBSTRING( a.meta_key, 17 ) )
    866892                AND b.meta_value < %d",
    867             $wpdb->esc_like( '_site_transient_' ) . '%',
    868             $wpdb->esc_like( '_site_transient_timeout_' ) . '%',
    869             time()
    870         ) );
     893                $wpdb->esc_like( '_site_transient_' ) . '%',
     894                $wpdb->esc_like( '_site_transient_timeout_' ) . '%',
     895                time()
     896            )
     897        );
    871898    }
    872899}
    … …  
    897924    $settings = (string) get_user_option( 'user-settings', $user_id );
    898925
    899     if ( isset( $_COOKIE['wp-settings-' . $user_id] ) ) {
    900         $cookie = preg_replace( '/[^A-Za-z0-9=&_]/', '', $_COOKIE['wp-settings-' . $user_id] );
     926    if ( isset( $_COOKIE[ 'wp-settings-' . $user_id ] ) ) {
     927        $cookie = preg_replace( '/[^A-Za-z0-9=&_]/', '', $_COOKIE[ 'wp-settings-' . $user_id ] );
    901928
    902929        // No change or both empty
    903         if ( $cookie == $settings )
     930        if ( $cookie == $settings ) {
    904931            return;
     932        }
    905933
    906934        $last_saved = (int) get_user_option( 'user-settings-time', $user_id );
    907         $current = isset( $_COOKIE['wp-settings-time-' . $user_id]) ? preg_replace( '/[^0-9]/', '', $_COOKIE['wp-settings-time-' . $user_id] ) : 0;
     935        $current    = isset( $_COOKIE[ 'wp-settings-time-' . $user_id ] ) ? preg_replace( '/[^0-9]/', '', $_COOKIE[ 'wp-settings-time-' . $user_id ] ) : 0;
    908936
    909937        // The cookie is newer than the saved value. Update the user_option and leave the cookie as-is
    … …  
    919947    setcookie( 'wp-settings-' . $user_id, $settings, time() + YEAR_IN_SECONDS, SITECOOKIEPATH, null, $secure );
    920948    setcookie( 'wp-settings-time-' . $user_id, time(), time() + YEAR_IN_SECONDS, SITECOOKIEPATH, null, $secure );
    921     $_COOKIE['wp-settings-' . $user_id] = $settings;
     949    $_COOKIE[ 'wp-settings-' . $user_id ] = $settings;
    922950}
    923951
    … …  
    934962    $all_user_settings = get_all_user_settings();
    935963
    936     return isset( $all_user_settings[$name] ) ? $all_user_settings[$name] : $default;
     964    return isset( $all_user_settings[ $name ] ) ? $all_user_settings[ $name ] : $default;
    937965}
    938966
    … …  
    955983    }
    956984
    957     $all_user_settings = get_all_user_settings();
    958     $all_user_settings[$name] = $value;
     985    $all_user_settings          = get_all_user_settings();
     986    $all_user_settings[ $name ] = $value;
    959987
    960988    return wp_set_all_user_settings( $all_user_settings );
    … …  
    9791007
    9801008    $all_user_settings = get_all_user_settings();
    981     $names = (array) $names;
    982     $deleted = false;
     1009    $names             = (array) $names;
     1010    $deleted           = false;
    9831011
    9841012    foreach ( $names as $name ) {
    985         if ( isset( $all_user_settings[$name] ) ) {
    986             unset( $all_user_settings[$name] );
     1013        if ( isset( $all_user_settings[ $name ] ) ) {
     1014            unset( $all_user_settings[ $name ] );
    9871015            $deleted = true;
    9881016        }
    … …  
    10181046    $user_settings = array();
    10191047
    1020     if ( isset( $_COOKIE['wp-settings-' . $user_id] ) ) {
    1021         $cookie = preg_replace( '/[^A-Za-z0-9=&_-]/', '', $_COOKIE['wp-settings-' . $user_id] );
     1048    if ( isset( $_COOKIE[ 'wp-settings-' . $user_id ] ) ) {
     1049        $cookie = preg_replace( '/[^A-Za-z0-9=&_-]/', '', $_COOKIE[ 'wp-settings-' . $user_id ] );
    10221050
    10231051        if ( strpos( $cookie, '=' ) ) { // '=' cannot be 1st char
    … …  
    10611089    $settings = '';
    10621090    foreach ( $user_settings as $name => $value ) {
    1063         $_name = preg_replace( '/[^A-Za-z0-9_-]+/', '', $name );
     1091        $_name  = preg_replace( '/[^A-Za-z0-9_-]+/', '', $name );
    10641092        $_value = preg_replace( '/[^A-Za-z0-9_-]+/', '', $value );
    10651093
    … …  
    12181246    // prevent non-existent options from triggering multiple queries
    12191247    $notoptions_key = "$network_id:notoptions";
    1220     $notoptions = wp_cache_get( $notoptions_key, 'site-options' );
     1248    $notoptions     = wp_cache_get( $notoptions_key, 'site-options' );
    12211249
    12221250    if ( isset( $notoptions[ $option ] ) ) {
    … …  
    12421270        /** This filter is documented in wp-includes/option.php */
    12431271        $default = apply_filters( 'default_site_option_' . $option, $default, $option, $network_id );
    1244         $value = get_option( $option, $default );
     1272        $value   = get_option( $option, $default );
    12451273    } else {
    12461274        $cache_key = "$network_id:$option";
    1247         $value = wp_cache_get( $cache_key, 'site-options' );
     1275        $value     = wp_cache_get( $cache_key, 'site-options' );
    12481276
    12491277        if ( ! isset( $value ) || false === $value ) {
    … …  
    13511379
    13521380        $serialized_value = maybe_serialize( $value );
    1353         $result = $wpdb->insert( $wpdb->sitemeta, array( 'site_id'    => $network_id, 'meta_key'   => $option, 'meta_value' => $serialized_value ) );
     1381        $result           = $wpdb->insert(
     1382            $wpdb->sitemeta, array(
     1383                'site_id'    => $network_id,
     1384                'meta_key'   => $option,
     1385                'meta_value' => $serialized_value,
     1386            )
     1387        );
    13541388
    13551389        if ( ! $result ) {
    … …  
    14531487        wp_cache_delete( $cache_key, 'site-options' );
    14541488
    1455         $result = $wpdb->delete( $wpdb->sitemeta, array( 'meta_key' => $option, 'site_id' => $network_id ) );
     1489        $result = $wpdb->delete(
     1490            $wpdb->sitemeta, array(
     1491                'meta_key' => $option,
     1492                'site_id'  => $network_id,
     1493            )
     1494        );
    14561495    }
    14571496
    … …  
    15471586
    15481587    $notoptions_key = "$network_id:notoptions";
    1549     $notoptions = wp_cache_get( $notoptions_key, 'site-options' );
     1588    $notoptions     = wp_cache_get( $notoptions_key, 'site-options' );
    15501589    if ( is_array( $notoptions ) && isset( $notoptions[ $option ] ) ) {
    15511590        unset( $notoptions[ $option ] );
    … …  
    15591598
    15601599        $serialized_value = maybe_serialize( $value );
    1561         $result = $wpdb->update( $wpdb->sitemeta, array( 'meta_value' => $serialized_value ), array( 'site_id' => $network_id, 'meta_key' => $option ) );
     1600        $result           = $wpdb->update(
     1601            $wpdb->sitemeta, array( 'meta_value' => $serialized_value ), array(
     1602                'site_id'  => $network_id,
     1603                'meta_key' => $option,
     1604            )
     1605        );
    15621606
    15631607        if ( $result ) {
    … …  
    16291673    } else {
    16301674        $option_timeout = '_site_transient_timeout_' . $transient;
    1631         $option = '_site_transient_' . $transient;
    1632         $result = delete_site_option( $option );
    1633         if ( $result )
     1675        $option         = '_site_transient_' . $transient;
     1676        $result         = delete_site_option( $option );
     1677        if ( $result ) {
    16341678            delete_site_option( $option_timeout );
     1679        }
    16351680    }
    16361681    if ( $result ) {
    … …  
    16821727    $pre = apply_filters( "pre_site_transient_{$transient}", false, $transient );
    16831728
    1684     if ( false !== $pre )
     1729    if ( false !== $pre ) {
    16851730        return $pre;
     1731    }
    16861732
    16871733    if ( wp_using_ext_object_cache() ) {
    … …  
    16891735    } else {
    16901736        // Core transients that do not have a timeout. Listed here so querying timeouts can be avoided.
    1691         $no_timeout = array('update_core', 'update_plugins', 'update_themes');
     1737        $no_timeout       = array( 'update_core', 'update_plugins', 'update_themes' );
    16921738        $transient_option = '_site_transient_' . $transient;
    16931739        if ( ! in_array( $transient, $no_timeout ) ) {
    16941740            $transient_timeout = '_site_transient_timeout_' . $transient;
    1695             $timeout = get_site_option( $transient_timeout );
     1741            $timeout           = get_site_option( $transient_timeout );
    16961742            if ( false !== $timeout && $timeout < time() ) {
    1697                 delete_site_option( $transient_option  );
     1743                delete_site_option( $transient_option );
    16981744                delete_site_option( $transient_timeout );
    16991745                $value = false;
    … …  
    17011747        }
    17021748
    1703         if ( ! isset( $value ) )
     1749        if ( ! isset( $value ) ) {
    17041750            $value = get_site_option( $transient_option );
     1751        }
    17051752    }
    17061753
    … …  
    17691816    } else {
    17701817        $transient_timeout = '_site_transient_timeout_' . $transient;
    1771         $option = '_site_transient_' . $transient;
     1818        $option            = '_site_transient_' . $transient;
    17721819        if ( false === get_site_option( $option ) ) {
    1773             if ( $expiration )
     1820            if ( $expiration ) {
    17741821                add_site_option( $transient_timeout, time() + $expiration );
     1822            }
    17751823            $result = add_site_option( $option, $value );
    17761824        } else {
    1777             if ( $expiration )
     1825            if ( $expiration ) {
    17781826                update_site_option( $transient_timeout, time() + $expiration );
     1827            }
    17791828            $result = update_site_option( $option, $value );
    17801829        }
    … …  
    18191868 */
    18201869function register_initial_settings() {
    1821     register_setting( 'general', 'blogname', array(
    1822         'show_in_rest' => array(
    1823             'name' => 'title',
    1824         ),
    1825         'type'         => 'string',
    1826         'description'  => __( 'Site title.' ),
    1827     ) );
    1828 
    1829     register_setting( 'general', 'blogdescription', array(
    1830         'show_in_rest' => array(
    1831             'name' => 'description',
    1832         ),
    1833         'type'         => 'string',
    1834         'description'  => __( 'Site tagline.' ),
    1835     ) );
     1870    register_setting(
     1871        'general', 'blogname', array(
     1872            'show_in_rest' => array(
     1873                'name' => 'title',
     1874            ),
     1875            'type'         => 'string',
     1876            'description'  => __( 'Site title.' ),
     1877        )
     1878    );
     1879
     1880    register_setting(
     1881        'general', 'blogdescription', array(
     1882            'show_in_rest' => array(
     1883                'name' => 'description',
     1884            ),
     1885            'type'         => 'string',
     1886            'description'  => __( 'Site tagline.' ),
     1887        )
     1888    );
    18361889
    18371890    if ( ! is_multisite() ) {
    1838         register_setting( 'general', 'siteurl', array(
     1891        register_setting(
     1892            'general', 'siteurl', array(
     1893                'show_in_rest' => array(
     1894                    'name'   => 'url',
     1895                    'schema' => array(
     1896                        'format' => 'uri',
     1897                    ),
     1898                ),
     1899                'type'         => 'string',
     1900                'description'  => __( 'Site URL.' ),
     1901            )
     1902        );
     1903    }
     1904
     1905    if ( ! is_multisite() ) {
     1906        register_setting(
     1907            'general', 'admin_email', array(
     1908                'show_in_rest' => array(
     1909                    'name'   => 'email',
     1910                    'schema' => array(
     1911                        'format' => 'email',
     1912                    ),
     1913                ),
     1914                'type'         => 'string',
     1915                'description'  => __( 'This address is used for admin purposes, like new user notification.' ),
     1916            )
     1917        );
     1918    }
     1919
     1920    register_setting(
     1921        'general', 'timezone_string', array(
    18391922            'show_in_rest' => array(
    1840                 'name'    => 'url',
    1841                 'schema'  => array(
    1842                     'format' => 'uri',
     1923                'name' => 'timezone',
     1924            ),
     1925            'type'         => 'string',
     1926            'description'  => __( 'A city in the same timezone as you.' ),
     1927        )
     1928    );
     1929
     1930    register_setting(
     1931        'general', 'date_format', array(
     1932            'show_in_rest' => true,
     1933            'type'         => 'string',
     1934            'description'  => __( 'A date format for all date strings.' ),
     1935        )
     1936    );
     1937
     1938    register_setting(
     1939        'general', 'time_format', array(
     1940            'show_in_rest' => true,
     1941            'type'         => 'string',
     1942            'description'  => __( 'A time format for all time strings.' ),
     1943        )
     1944    );
     1945
     1946    register_setting(
     1947        'general', 'start_of_week', array(
     1948            'show_in_rest' => true,
     1949            'type'         => 'integer',
     1950            'description'  => __( 'A day number of the week that the week should start on.' ),
     1951        )
     1952    );
     1953
     1954    register_setting(
     1955        'general', 'WPLANG', array(
     1956            'show_in_rest' => array(
     1957                'name' => 'language',
     1958            ),
     1959            'type'         => 'string',
     1960            'description'  => __( 'WordPress locale code.' ),
     1961            'default'      => 'en_US',
     1962        )
     1963    );
     1964
     1965    register_setting(
     1966        'writing', 'use_smilies', array(
     1967            'show_in_rest' => true,
     1968            'type'         => 'boolean',
     1969            'description'  => __( 'Convert emoticons like :-) and :-P to graphics on display.' ),
     1970            'default'      => true,
     1971        )
     1972    );
     1973
     1974    register_setting(
     1975        'writing', 'default_category', array(
     1976            'show_in_rest' => true,
     1977            'type'         => 'integer',
     1978            'description'  => __( 'Default post category.' ),
     1979        )
     1980    );
     1981
     1982    register_setting(
     1983        'writing', 'default_post_format', array(
     1984            'show_in_rest' => true,
     1985            'type'         => 'string',
     1986            'description'  => __( 'Default post format.' ),
     1987        )
     1988    );
     1989
     1990    register_setting(
     1991        'reading', 'posts_per_page', array(
     1992            'show_in_rest' => true,
     1993            'type'         => 'integer',
     1994            'description'  => __( 'Blog pages show at most.' ),
     1995            'default'      => 10,
     1996        )
     1997    );
     1998
     1999    register_setting(
     2000        'discussion', 'default_ping_status', array(
     2001            'show_in_rest' => array(
     2002                'schema' => array(
     2003                    'enum' => array( 'open', 'closed' ),
    18432004                ),
    18442005            ),
    18452006            'type'         => 'string',
    1846             'description'  => __( 'Site URL.' ),
    1847         ) );
    1848     }
    1849 
    1850     if ( ! is_multisite() ) {
    1851         register_setting( 'general', 'admin_email', array(
     2007            'description'  => __( 'Allow link notifications from other blogs (pingbacks and trackbacks) on new articles.' ),
     2008        )
     2009    );
     2010
     2011    register_setting(
     2012        'discussion', 'default_comment_status', array(
    18522013            'show_in_rest' => array(
    1853                 'name'    => 'email',
    1854                 'schema'  => array(
    1855                     'format' => 'email',
     2014                'schema' => array(
     2015                    'enum' => array( 'open', 'closed' ),
    18562016                ),
    18572017            ),
    18582018            'type'         => 'string',
    1859             'description'  => __( 'This address is used for admin purposes, like new user notification.' ),
    1860         ) );
    1861     }
    1862 
    1863     register_setting( 'general', 'timezone_string', array(
    1864         'show_in_rest' => array(
    1865             'name' => 'timezone',
    1866         ),
    1867         'type'         => 'string',
    1868         'description'  => __( 'A city in the same timezone as you.' ),
    1869     ) );
    1870 
    1871     register_setting( 'general', 'date_format', array(
    1872         'show_in_rest' => true,
    1873         'type'         => 'string',
    1874         'description'  => __( 'A date format for all date strings.' ),
    1875     ) );
    1876 
    1877     register_setting( 'general', 'time_format', array(
    1878         'show_in_rest' => true,
    1879         'type'         => 'string',
    1880         'description'  => __( 'A time format for all time strings.' ),
    1881     ) );
    1882 
    1883     register_setting( 'general', 'start_of_week', array(
    1884         'show_in_rest' => true,
    1885         'type'         => 'integer',
    1886         'description'  => __( 'A day number of the week that the week should start on.' ),
    1887     ) );
    1888 
    1889     register_setting( 'general', 'WPLANG', array(
    1890         'show_in_rest' => array(
    1891             'name' => 'language',
    1892         ),
    1893         'type'         => 'string',
    1894         'description'  => __( 'WordPress locale code.' ),
    1895         'default'      => 'en_US',
    1896     ) );
    1897 
    1898     register_setting( 'writing', 'use_smilies', array(
    1899         'show_in_rest' => true,
    1900         'type'         => 'boolean',
    1901         'description'  => __( 'Convert emoticons like :-) and :-P to graphics on display.' ),
    1902         'default'      => true,
    1903     ) );
    1904 
    1905     register_setting( 'writing', 'default_category', array(
    1906         'show_in_rest' => true,
    1907         'type'         => 'integer',
    1908         'description'  => __( 'Default post category.' ),
    1909     ) );
    1910 
    1911     register_setting( 'writing', 'default_post_format', array(
    1912         'show_in_rest' => true,
    1913         'type'         => 'string',
    1914         'description'  => __( 'Default post format.' ),
    1915     ) );
    1916 
    1917     register_setting( 'reading', 'posts_per_page', array(
    1918         'show_in_rest' => true,
    1919         'type'         => 'integer',
    1920         'description'  => __( 'Blog pages show at most.' ),
    1921         'default'      => 10,
    1922     ) );
    1923 
    1924     register_setting( 'discussion', 'default_ping_status', array(
    1925         'show_in_rest' => array(
    1926             'schema'   => array(
    1927                 'enum' => array( 'open', 'closed' ),
    1928             ),
    1929         ),
    1930         'type'         => 'string',
    1931         'description'  => __( 'Allow link notifications from other blogs (pingbacks and trackbacks) on new articles.' ),
    1932     ) );
    1933 
    1934     register_setting( 'discussion', 'default_comment_status', array(
    1935         'show_in_rest' => array(
    1936             'schema'   => array(
    1937                 'enum' => array( 'open', 'closed' ),
    1938             ),
    1939         ),
    1940         'type'         => 'string',
    1941         'description'  => __( 'Allow people to post comments on new articles.' ),
    1942     ) );
     2019            'description'  => __( 'Allow people to post comments on new articles.' ),
     2020        )
     2021    );
    19432022
    19442023}
    … …  
    19542033 *
    19552034 * @param string $option_group A settings group name. Should correspond to a whitelisted option key name.
    1956  *  Default whitelisted option key names include "general," "discussion," and "reading," among others.
     2035 *  Default whitelisted option key names include "general," "discussion," and "reading," among others.
    19572036 * @param string $option_name The name of an option to sanitize and save.
    19582037 * @param array  $args {
    … …  
    20032082
    20042083    if ( 'misc' == $option_group ) {
    2005         _deprecated_argument( __FUNCTION__, '3.0.0',
     2084        _deprecated_argument(
     2085            __FUNCTION__, '3.0.0',
    20062086            /* translators: %s: misc */
    2007             sprintf( __( 'The "%s" options group has been removed. Use another settings group.' ),
     2087            sprintf(
     2088                __( 'The "%s" options group has been removed. Use another settings group.' ),
    20082089                'misc'
    20092090            )
    … …  
    20132094
    20142095    if ( 'privacy' == $option_group ) {
    2015         _deprecated_argument( __FUNCTION__, '3.5.0',
     2096        _deprecated_argument(
     2097            __FUNCTION__, '3.5.0',
    20162098            /* translators: %s: privacy */
    2017             sprintf( __( 'The "%s" options group has been removed. Use another settings group.' ),
     2099            sprintf(
     2100                __( 'The "%s" options group has been removed. Use another settings group.' ),
    20182101                'privacy'
    20192102            )
    … …  
    20492132
    20502133    if ( 'misc' == $option_group ) {
    2051         _deprecated_argument( __FUNCTION__, '3.0.0',
     2134        _deprecated_argument(
     2135            __FUNCTION__, '3.0.0',
    20522136            /* translators: %s: misc */
    2053             sprintf( __( 'The "%s" options group has been removed. Use another settings group.' ),
     2137            sprintf(
     2138                __( 'The "%s" options group has been removed. Use another settings group.' ),
    20542139                'misc'
    20552140            )
    … …  
    20592144
    20602145    if ( 'privacy' == $option_group ) {
    2061         _deprecated_argument( __FUNCTION__, '3.5.0',
     2146        _deprecated_argument(
     2147            __FUNCTION__, '3.5.0',
    20622148            /* translators: %s: privacy */
    2063             sprintf( __( 'The "%s" options group has been removed. Use another settings group.' ),
     2149            sprintf(
     2150                __( 'The "%s" options group has been removed. Use another settings group.' ),
    20642151                'privacy'
    20652152            )
    … …  
    20732160    }
    20742161    if ( '' !== $deprecated ) {
    2075         _deprecated_argument( __FUNCTION__, '4.7.0',
     2162        _deprecated_argument(
     2163            __FUNCTION__, '4.7.0',
    20762164            /* translators: 1: $sanitize_callback, 2: register_setting() */
    2077             sprintf( __( '%1$s is deprecated. The callback from %2$s is used instead.' ),
     2165            sprintf(
     2166                __( '%1$s is deprecated. The callback from %2$s is used instead.' ),
    20782167                '<code>$sanitize_callback</code>',
    20792168                '<code>register_setting()</code>'
Note: See TracChangeset for help on using the changeset viewer.