如何在 WordPress 文章中创建内容目录

有许多免费插件可用于在 WordPress 中创建目录，比如 4个不错的WordPress文章目录插件。在这里，我们选择LuckyWP Table of Contents是因为它为我们提供了高度可定制且美观的结果。但是，这个插件有很多设置，一开始可能会让你感到困惑。因此，请按照我们的说明来节省您的时间。

LuckyWP Table of Contents 是一个免费插件，可在wordpress.org 上获得。您只需在后台上安装并激活插件。

然后，转到设置 > Table of Contents，您将看到设置屏幕。

这里有4个标签需要注意：常规 General、外观 Appearance、自动插入 Auto Insert、处理标题 Processing headings。它们是用于设置和自定义目录显示的选项卡。杂项是具有复杂且不重要的设置的选项卡，因此您可以忽略它。

在此步骤中，您只需在“常规”选项卡上工作。

本节有很多设置。为了节省时间，您应该关注以下重要部分：

记数：标题的序号。您应该从以下选项中选择一个：无编号、十进制数字（嵌套）、罗马数字（嵌套）。

我选择十进制数字（嵌套）Decimal numbers (nested)，所以我的 TOC 看起来像这样：

让我们将其余设置保留为默认值，因为这不会对您的 TOC 产生太大影响。

单击保存更改以完成。至此，我们已经完成了 TOC 的常规设置。让我们继续下一步。

第2步：在文章中插入目录

有两种方法可以在文章中插入目录：自动插入和手动插入。

自动插入意味着自动在所有文章中添加目录。这种方式可以节省大量时间和精力，但是如果您只想在某些文章中插入目录，则行不通。

手动插入意味着如果您想在文章中包含目录，您需要自己将其插入到该文章中。这可能需要更多时间。

我们将详细介绍这两种方法。您可以选择适合您的选项。

自动插入

转到选项卡Auto Insert > Enable。该插件默认选择Post（文章）。如果您不想要它，您可以更改为其他文章类型。

在“位置”部分中，选择要插入目录的位置。不要忘记单击保存更改！

至此，所选文章类型中的所有文章都有目录。

手动插入

手动插入听起来很复杂，但实际上非常简单。转到处理标题选项卡。在那里，也选择文章类型，然后点击保存更改。

然后，转到您选择的文章类型的文章的编辑器，单击启用目录。

现在，您的 TOC 基本完成。此外，我们甚至可以设置它的颜色、字体、项目大小……以使其更漂亮。按照下一步操作。

第3步：自定义目录显示

还有两种方法可以自定义目录显示：一是在所有文章中自定义，二是在每个文章中单独自定义。

自定义所有文章的目录

您可以通过转到“外观”选项卡来详细自定义所有目录。有许多设置，例如标题字体大小、项目字体大小、链接颜色……

无需注意所有设置，只需专注于您想要的。

例如，我不喜欢蓝色和当前标题字体大小。我想将颜色更改为深灰色和较小的尺寸，以便它们在文章中看起来更好。因此，我将自定义标题字体大小、项目字体大小、链接颜色并保留如下图所示的其余设置：

自定义后我的 TOC 如下所示：

现在，它看起来更加和谐。

但是，也许您希望在不同的文章中有不同的目录，只需向下滚动以阅读如何在每个文章中自定义它。

自定义每篇文章的目录

这项工作也简单快捷。首先，转到文章编辑器，选择“目录”>“自定义”。

出现自定义目录弹出窗口。你会看到一些熟悉的标签，如上。它们是常规General、外观 Appearance和杂项Misc。.

转到外观选项卡并更改一些设置，同样在插件的仪表板上进行编辑。点击保存完成！

现在，让我们看看自定义目录的最终结果。

这两种自定义方法都带来了非常漂亮和详细的目录。所以你可以自由选择你喜欢的方式。

现在，让我们看看如何使用代码来创建目录。

方法2：使用代码创建目录

第1步：为文章创建目录

转到外观>主题>编辑器>functions.php。

然后，将以下代码添加到文件中functions.php以将目录插入文章。

function wpkj_create_toc($html) {
$toc = '';
if (is_single()) {
if (!$html) return $html;
$dom = new DOMDocument();
libxml_use_internal_errors(true);
$dom->loadHTML(mb_convert_encoding($html, 'HTML-ENTITIES', 'UTF-8'));
libxml_clear_errors();
$toc = '<div class="toc-bound">
<div class="toc-ctr">
table of contents
</div>
<ul class="toc">';
$h2_status = 0;
$h3_status = 0;
$i = 1;
foreach($dom->getElementsByTagName('*') as $element) {
if($element->tagName == 'h2') {
if($h3_status){
$toc .= '</ul>';
$h3_status = 0;
}
if($h2_status){
$toc .= '</li>';
$h2_status = 0;
}
$h2_status = 1;
$toc .= '<li><a href="'%20<span%20class="pun">. get_the_permalink() . '#toc-'%20<span%20class="pun">. $i . '">'%20<span%20class="pun">. $element->textContent . '</a>';
$element->setAttribute('id', 'toc-'%20<span%20class="pun">. $i);
$i++;
}elseif($element->tagName == 'h3') {
if(!$h3_status){
$toc .= '<ul class="toc-sub">';
$h3_status = 1;
}
$toc .= '<li><a href="'%20<span%20class="pun">. get_the_permalink() . '#toc-'%20<span%20class="pun">. $i . '">'%20<span%20class="pun">. $element->textContent . '</a></li>';
$element->setAttribute('id', 'toc-'%20<span%20class="pun">. $i);
$i++;
}
}
if($h3_status){
$toc .= '</ul>';
}
if($h2_status){
$toc .= '</li>';
}
$toc .= '</ul></div>';
$html = $dom->saveHTML();
}
return $toc . $html;
}
add_filter('the_content', 'wpkj_create_toc');

注意：此代码仅将 2 个标题级别 h2、h3添加到目录中。

解释：

代码	解释
函数$toc = ‘<div class=”toc-bound”> <div class=”toc-ctr”> table of contents </div> <ul class=”toc”>	向目录添加标题并将其显示在此之上。您可以将文本“目录”替换为您希望在标题中出现的任何内容。
变量h2, h3	标题级别插入到目录中。如果您想更换H2 ，H3具有超视距呃标签，改变整个参数像H2 ，H3为标记你的代码需要。
函数 $toc .= ‘<li><a href=”‘ . get_the_permalink() . ‘#toc-‘ . $i . ‘”>’ . $element->textContent . ‘</a>’;	单击后立即创建指向文章中相应部分的跳转链接。
函数 if($h3_status){ $toc .= ‘</ul>’; } if($h2_status){ $toc .= ‘</li>’; } $toc .= ‘</ul></div>’; $html = $dom->saveHTML(); } return $toc . $html;	在目录中的每个标题前添加项目符号。