Docs: Reword inline docs for better readability and clarity.
This improves the wording of the inline documentation for `redirect_guess_404_permalink()` and the related filters introduced in [47878]. Previously [47878,47885] See #16557. Built from https://develop.svn.wordpress.org/trunk@48182 git-svn-id: http://core.svn.wordpress.org/trunk@47951 1a063a9b-81f0-0310-95a4-ce76da25c4cd
This commit is contained in:
parent
81447b05ba
commit
9ebcf0922c
|
@ -835,7 +835,7 @@ function strip_fragment_from_url( $url ) {
|
||||||
}
|
}
|
||||||
|
|
||||||
/**
|
/**
|
||||||
* Attempts to guess the correct URL based on query vars.
|
* Attempts to guess the correct URL for a 404 request based on query vars.
|
||||||
*
|
*
|
||||||
* @since 2.3.0
|
* @since 2.3.0
|
||||||
*
|
*
|
||||||
|
@ -847,22 +847,22 @@ function redirect_guess_404_permalink() {
|
||||||
global $wpdb;
|
global $wpdb;
|
||||||
|
|
||||||
/**
|
/**
|
||||||
* Filters whether to do redirect guess of 404 requests.
|
* Filters whether to attempt to guess a redirect URL for a 404 request.
|
||||||
*
|
*
|
||||||
* Passing a false value to the filter will disable the URL guessing
|
* Passing a false value to the filter will disable the URL guessing
|
||||||
* and return early.
|
* and return early.
|
||||||
*
|
*
|
||||||
* @since 5.5.0
|
* @since 5.5.0
|
||||||
*
|
*
|
||||||
* @param bool $do_redirect_guess Whether to do redirect guess 404 permalink.
|
* @param bool $do_redirect_guess Whether to attempt to guess a redirect URL
|
||||||
* Default true.
|
* for a 404 request. Default is true.
|
||||||
*/
|
*/
|
||||||
if ( false === apply_filters( 'do_redirect_guess_404_permalink', true ) ) {
|
if ( false === apply_filters( 'do_redirect_guess_404_permalink', true ) ) {
|
||||||
return false;
|
return false;
|
||||||
}
|
}
|
||||||
|
|
||||||
/**
|
/**
|
||||||
* Filters whether to short-circuit redirect guess of 404 requests.
|
* Filters whether to short-circuit redirect URL guessing for 404 requests.
|
||||||
*
|
*
|
||||||
* Passing a non-null value to the filter will effectively short-circuit
|
* Passing a non-null value to the filter will effectively short-circuit
|
||||||
* the URL guessing, returning the passed value instead.
|
* the URL guessing, returning the passed value instead.
|
||||||
|
@ -878,15 +878,14 @@ function redirect_guess_404_permalink() {
|
||||||
}
|
}
|
||||||
|
|
||||||
if ( get_query_var( 'name' ) ) {
|
if ( get_query_var( 'name' ) ) {
|
||||||
|
|
||||||
/**
|
/**
|
||||||
* Filters whether to do a strict or loose guess.
|
* Filters whether to perform a strict or loose guess.
|
||||||
*
|
*
|
||||||
* Passing a truthy value to the filter will redirect only exact post_name matches.
|
* Passing a truthy value to the filter will redirect only exact post_name matches.
|
||||||
*
|
*
|
||||||
* @since 5.5.0
|
* @since 5.5.0
|
||||||
*
|
*
|
||||||
* @param bool $strict_guess Whether to do a strict/exact guess. Default false.
|
* @param bool $strict_guess Whether to perform a strict/exact guess. Default false (loose guess).
|
||||||
*/
|
*/
|
||||||
$strict_guess = apply_filters( 'strict_redirect_guess_404_permalink', false );
|
$strict_guess = apply_filters( 'strict_redirect_guess_404_permalink', false );
|
||||||
|
|
||||||
|
|
|
@ -13,7 +13,7 @@
|
||||||
*
|
*
|
||||||
* @global string $wp_version
|
* @global string $wp_version
|
||||||
*/
|
*/
|
||||||
$wp_version = '5.5-alpha-48181';
|
$wp_version = '5.5-alpha-48182';
|
||||||
|
|
||||||
/**
|
/**
|
||||||
* Holds the WordPress DB revision, increments when changes are made to the WordPress DB schema.
|
* Holds the WordPress DB revision, increments when changes are made to the WordPress DB schema.
|
||||||
|
|
Loading…
Reference in New Issue