基于其他短代码的WordPress短代码

Question

我有2个WordPress短代码正在使用：

1. 一章。[章节名称="开始"]...内容...[/章]
2. 目录[toc][/toc]。toc需要显示章节的简单列表。

规范：

• 一篇文章可以有很多章节。
• 帖子中可以有一个、两个或没有toc短代码。
• toc可以在章节之前或之后，也可以在章节之前和之后。这取决于帖子作者，所以我事先不知道。
• 我不能使用嵌套的简码，因为这些对作者来说很难使用。

我想到了使用静态toc数组在每个章节标记处添加章节，然后在toc短代码中输出。唉，toc短代码可以出现在章节之前，然后数组将是空的。

以下post html将不显示toc：

[toc][/toc]
Here is some content
[chapter name="hello"]xxx[/chapter]
In between content may come here
[chapter name="world"]yyy[/chapter]
Some more stuff

这是我的起始代码（嵌入到类中）：

public static function register_chapter_shortcode($atts, $content=null){
    $atts = shortcode_atts (
        array (
            'name'       => '',
        ), $atts );

    $name = $atts["name"];
    if (self::$toc == null){
        self::$toc = array ($name);
    } else {
        array_push(self::$toc, $name);
    }
    return '
        <h2>'.$atts["name"].'</h2>
        <div>'.do_shortcode($content).'</div>'
    ;
}

public static function register_toc_shortcode($atts, $content=null){
    $items = "";
    foreach (self::$toc as $item){
        $items = $items. '<li><a href="#">'.$item.'</a></li>';
    }
    return '
        <ul>'.$items.'</ul>            
    ';
}

Answer 1

问题是函数运行的顺序：register_toc_shortcode在register_chapter_shortcode设置self::$toc之前运行，所以它没有任何显示。这意味着[toc]必须在[章节]简码之后。这样做的问题是，您需要在列出章节之前显示TOC。

正如我在评论中提到的，我可以看到两种解决方法——一种是使用javascript将TOC插入DOM，但如果可能的话，我会避免这样做。

另一种方法是使用register_chapter_shortcode将所有内容存储在self::$toc中，而不输出任何内容。然后register_toc_shortcode可以显示所有内容。

这没有经过测试，但其背后的基本逻辑应该是正确的：

public static function register_chapter_shortcode($atts, $content=null){
    $atts = shortcode_atts (
        array (
            'name'       => '',
        ), $atts );

    if (self::$toc == null)
        self::$toc = array ();

    /* add ALL info to self::$toc in an array */
    array_push(self::$toc, array("name" => $atts["name"], "content" => $content));
}

public static function register_toc_shortcode($atts, $content=null){
    /* add the ability to pass in the position of the toc, as required in your comment */
    $atts = shortcode_atts (
        array (
            'position' => 'top', /* e.g. "top" (default), "bottom", "both" */
        ), $atts );

    /* generate the HTML for the TOC */
    $toc_html = "<ul>";
    foreach (self::$toc as $item){
        $toc_html .= '<li><a href="#">'.$item["name"].'</a></li>';
    }
    $toc_html .= "</ul>";

    /* generate the HTML for the chapters */
    $chapters = "";
    foreach (self::$toc as $item){
        $chapters .= '<h2>'.$item["name"].'</h2>
        <div>'.do_shortcode($item["content").'</div>';
    }

    /* generate the output, putting the TOC at the top or bottom as required */
    $html = "";
    if ($position == "top" || $position == "both") $html .= $toc_html;
    $html .= $chapters;
    if ($position == "bottom" || $position == "both") $html .= $toc_html;

    return $html;
}

然后您可以按如下方式使用它：

[chapter name="hello"]xxx[/chapter]
[chapter name="world"]yyy[/chapter]
[toc position="top"][/toc]

注意：[toc]始终必须在章节之后，以便为[toc]设置它们来显示详细信息。