WordPress用.html作为url后缀时的分页链接问题

  • 酉灿
  • WordPress
  • Jul 26, 2021

固定链接设为/archives/%postname%.html时可以让页面看起来像静态页,同时会使分页链接变得十分奇怪,比如评论的分页链接会变成"hello-world.html/comment-page-1#comments",html既然是后缀就应该一直在最后,本文介绍如何实现。

 

目标

假设页面链接为hello-world.html

当在文章中插入分页时,希望分页链接格式为hello-world/page-2.html

评论分页链接则为hello-world/comment-page-2.html

实现方法

  1. 通过filter将分页链接改成希望的格式,分别用到wp_link_pages_link和get_comments_pagenum_link。
  2. 添加自定义跳转规则,利用filter rewrite_rules_array
  3. 取消Canonical URL(标准链接)跳转,否则使用新链接访问时WordPress会强制跳转到原来的链接

代码

下面这段代码放在主题的functions.php中,保存后需要到设置中重新保存一下固定链接。

如果你接受插件,也可下载插件版,激活即可。

[download id=60]

 

本代码适用于固定链接格式为/archives/%postname%.html,若固定格式不同需要作相应修改,修改方法见下文。插件版也一样要改。

若固定链接格式为/%postname%.html,请修改规则,将

1
2
$this->post_rule = 'archives/([^/]+)('.$this->separator.'([0-9]+))?.html/?$';
$this->comment_rule = 'archives/([^/]+)/comment-page-([0-9]{1,}).html(#[^s])?$';

改为

1
2
$this->post_rule = '([^/]+)('.$this->separator.'([0-9]+))?.html/?$';
$this->comment_rule = '([^/]+)/comment-page-([0-9]{1,}).html(#[^s])?$';

实现代码

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
class Rewrite_Inner_Page_Links{
 
    var $separator;
 
    var $post_rule;
 
    var $comment_rule;
 
    function __construct(){
 
        $this->separator = '/page-';
 
        $this->post_rule = 'archives/([^/]+)('.$this->separator.'([0-9]+))?.html/?$';
 
        $this->comment_rule = 'archives/([^/]+)/comment-page-([0-9]{1,}).html(#[^s])?$';
 
        if( !is_admin() || defined( 'DOING_AJAX' ) ) :
            add_filter( 'wp_link_pages_link', array( $this, 'inner_page_link_format' ), 10, 2 ); // for inner pages
            add_filter( 'get_comments_pagenum_link', array( $this, 'comment_page_link_format' ) );     
            add_filter( 'redirect_canonical', array( $this, 'cancel_redirect_for_paged_posts' ), 10, 2 );
        endif;
 
        if( is_admin() ) :
            add_filter( 'rewrite_rules_array', array( $this, 'pagelink_rewrite_rules' ) );
        endif;
    }
    
    /**
     * 修改post分页链接的格式
     * @param string $link
     * @param int $number
     * @return string
     */
    function inner_page_link_format( $link, $number ){
        if( $number > 1 ){
            if( preg_match( '%<a href=".*.html/d*"%', $link ) ){
                $link = preg_replace( "%(.html)/(d*)%", $this->separator."$2$1", $link );
            }
        }
        return $link;
    }
 
    /**
     * 修改评论分页链接
     * @param string $result
     * @return string
     */
    function comment_page_link_format( $result ){
        // From hello-world.html/comment-page-1#comments to hello-world/comment-page-1.html#comments
        if( strpos( $result, '.html/' ) !== false ){
            $result = preg_replace( '=([^/]+)(.html)/comment-page-([0-9]{1,})=', "$1/comment-page-$3$2" ,$result );
        }
        return $result;
    }
 
    /**
     * 为新的链接格式增加重定向规则,移除原始分页链接的重定向规则,防止重复收录
     *
     * 访问原始链接将返回404
     * @param array $rules
     * @return array
     */
    function pagelink_rewrite_rules( $rules ){
 
        foreach ($rules as $rule => $rewrite) {
            if ( $rule == '([^/]+).html(/[0-9]+)?/?$' || $rule == '([^/]+).html/comment-page-([0-9]{1,})/?$' ) {
                unset($rules[$rule]);
            }
        }
 
        $new_rule[ $this->post_rule ] = 'index.php?name=$matches[1]&page=$matches[3]';
        $new_rule[ $this->comment_rule ] = 'index.php?name=$matches[1]&cpage=$matches[2]';
 
        return $new_rule + $rules;
    }
 
    /**
     * 禁止WordPress将页面分页链接跳转到原来的格式
     * @param string $redirect_url
     * @param string $requested_url
     * @return bool
     */
    function cancel_redirect_for_paged_posts( $redirect_url, $requested_url ){
        global $wp_query;
        if( is_single() && $wp_query->get( 'page' ) > 1 ){
            return false;
        }
        return true;
    }
}
 
new Rewrite_Inner_Page_Links();

本文介绍的方法演示了修改固定链接格式、并添加新Rewrite rules的方法,适用于其他情况。例如修改custom post type的固定链接,不同的是用哪个filter来修改链接输出格式。

打赏