从WordPress 2.3.0开始,redirect_guess_404_permalink()
功能就可以根据可用的查询变量尝试猜测所需的网址。当文章的父级更改(对于分层文章类型)或文章的slug别名更改时,此功能特别有用。
换句话说,如果用户访问的网址不存在,WordPress会相对智能地寻找比较接近用户请求的网址,而不是直接返回404错误页面,这样有利于提高用户体验。
对于大多数WordPress网站而言,这种做法是很好的,但是站长、开发人员可能希望对猜测逻辑进行更精细的控制。这个功能请求在9年前就提交了,而WordPress 5.5就可以实现了。
短路默认猜测逻辑
从WordPress 5.5开始,可使用新的pre_redirect_guess_404_permalink
过滤钩子绕过默认的猜测逻辑来使功能短路(Short-circuiting)。这对于执行自定义逻辑非常有用,该自定义逻辑可以更好地满足每个站点的需求,从而做出更准确的猜测。
向过滤器返回非假(non-false)值将使函数尽早返回过滤后的值。
例子
function mysite_pre_redirect_guess_404_permalink() {
// Custom redirect URL guessing logic.
return $new_redirect_url;
}
add_filter( 'pre_redirect_guess_404_permalink', 'mysite_pre_redirect_guess_404_permalink' );
控制“严格”与“宽松”比较
可以使用strict_redirect_guess_404_permalink
钩子来设置使用“严格”还是“宽松”比较规则。
当钩子返回值为true
,为“严格”规则,仅当post_name
找到完全匹配的内容时,才会执行重定向的猜测建议。
当钩子返回值为false
,为“宽松”规则,这个是默认选项,将在post_name
上执行LIKE
查询。
例子
以下示例将在redirect_guess_404_permalink()
中启用“严格”比较:
add_filter( 'strict_redirect_guess_404_permalink', '__return_true' );
禁用404重定向猜测
通过do_redirect_guess_404_permalink
过滤器返回false
,可以完全禁用重定向猜测。
例如
add_filter( 'do_redirect_guess_404_permalink', '__return_false' );
有关这些更改的更多信息,请参考相关的Trac工单:#16557。