WordPress文章目录插件

日期: 标签:WordPress插件
如需帮忙改代码,或者WordPress二次开发、PHP网站建设等需求,可联系我购买付费服务:  点此联系我

去过百度百科的人可能都会注意到,几乎每篇文章的开头都会有一个目录,点击这个目录中的标题可以快速到达文章中的具体内容位置,如:露兜。这样可以方便读者在篇幅较长的文章中找到他们想看的内容,这个也就相当于词典中的索引功能了。本文所介绍的插件实现的就是这样的一个功能,为文章设置了一个清晰的内容导航,读者可以在阅读之前知道这篇文章的大概意思,点击可以到达他们想看的部分,而且可以增加些内链、锚文本和关键词,对SEO也是很有帮助的。具体效果见本文右侧的文章目录。

文章目录免插件代码

其实现这样的一个功能还是比较简单的,也就是在文章内容中插进标题标签,然后弄成目录就是了,下面是我写的一个简单的代码,用文本编辑器打开当前主题目录下的functions.php,将以下代码放到 <?php 下面就可以(记得用UTF-8编码保存,否则中文会乱码):

function article_index($content) {
   /**
    * 名称:文章目录插件
    * 作者:露兜
    * 博客:https://www.ludou.org/
    * 最后修改:2015年3月20日
    */

   $matches = array();
   $ul_li = '';

   $r = "/<h3>([^<]+)<\/h3>/im";

   if(is_singular() && preg_match_all($r, $content, $matches)) {
      foreach($matches[1] as $num => $title) {
         $title = trim(strip_tags($title));
         $content = str_replace($matches[0][$num], '<h3 id="title-'.$num.'">'.$title.'</h3>', $content);
         $ul_li .= '<li><a href="#title-'.$num.'" title="'.$title.'">'.$title."</a></li>\n";
      }

      $content = "\n<div id="article-index">
                     <strong>文章目录</strong>
                     <ul id="index-ul">\n" . $ul_li . "</ul>
                  </div>\n" . $content;
   }

   return $content;
}

add_filter( 'the_content', 'article_index' );

使用说明

在编辑文章的时候,切换到HTML模式,将需要添加到目录中的标题用<h3></h3>括起来就可以了,如<h3>我是索引标题</h3>。当然你也可以用其他标签,如<h1><p>等,将以上代码第12和17行中的h3改成你自己的标签名称就可以了。

上面这段代码只是在文章显示的时候插入文章目录,并不会修改你的文章内容。以上代码也不包括样式美化代码,所以只添加以上代码,文章目录看起来一片混乱,所以你得自己添加一些css代码来美化一下这个目录。如果你不会css,可以用我写的,将以下css代码放到主题目录下的style.css中就可以了(并不是每个网站都适用):

#article-index {
    -moz-border-radius: 6px 6px 6px 6px;
    border: 1px solid #DEDFE1;
    float: right;
    margin: 0 0 15px 15px;
    padding: 0 6px;
    width: 200px;
    line-height: 23px;
}
#article-index strong {
    border-bottom: 1px dashed #DDDDDD;
    display: block;
    line-height: 30px;
    padding: 0 4px;
}
#index-ul {
    margin: 0;
    padding-bottom: 10px;
}
#index-ul li {
    background: none repeat scroll 0 0 transparent;
    list-style-type: disc;
    padding: 0;
    margin-left: 20px;
}

支持多级目录

以上代码的功能比较单一,只有单级目录,不能实现多层级的复杂而完善的索引目录功能。网友12READS对以上代码做了修改,据称可以支持多级目录,暂未测试,需要的可以看看:多级目录

功能更强大的文章目录插件

如果你需要这些功能可以试试这以下这几个插件,使用也都比较简单:

-- 完 --

本文采用 「CC BY-NC-SA 4.0」创作共享协议,转载请标注以下信息:
原文出处:露兜即刻 https://www.ludou.org/wordpress-content-index-plugin.html
露兜
kaapass@outlook.com  QQ 825533758

业余编程爱好者。

146 条留言

点此留言
1 2 3 4 252
  1. 光辉博客 光辉博客

    一会试试,感谢分享。

  2. 自由国度 自由国度

    用TOC,如何让文章目录左对齐或者右对齐呢

  3. handbye

    您好,这个很好用,但是在我的网站上,定位到目录的位置会靠下一点,该怎么调一下呢。
    谢谢!

  4. 露兜

    @handbye 这个没法调

  5. SEO博客 SEO博客

    你好。博主,请问一下,这个添加成功了,但是目录在文章内,并且还不能跟随滚动,那么这个目录基本就失去了存在的意义,请问博主,如何实现添加到侧边栏或者左侧并跟随用户滚动(指的是整个目录列表,如果能标记滚动会更好)?

  6. 露兜

    @SEO博客 本文只是提供通用的做法,不同主题排版什么都不一样,自定义的CSS或JS需要自己写了,相关代码可以上网搜索。

  7. 中国博客联盟 中国博客联盟

    中国博客联盟前来拜访,祝贵博越来越好!

  8. 4D蚂蚁 4D蚂蚁

    学到了,感谢分享

  9. 海绵宝宝

    这些插件都有一个问题,长文如果分页了,只会列出该分页的索引,而不是整篇文章的索引

1 2 3 4

发表留言