在 WordPress 中返回短代码内的函数时出现问题

Question

我在编写主题简码时遇到一些麻烦。我希望代码显示一个带有视图计数器功能的 div，然后显示一个以 shotcodes 内容作为 url 的链接。

view_count();在主题文件内部调用时，函数工作正常，我实际上设法让它显示，但随后它显示在 the_content(); 之前当我想要将其包含在元素下的内容中时，该帖子（灰色条）的位置。

（1）这是我得到的：

function video_block( $atts, $content = null ) { 
    return '<div class="video-block"><span class="ViewCount"><?php the_views(); ?></span> <a class="dl-source" href="' . $content . '">Link</a></div>';
}

（2）这是在页面顶部显示的代码：

function video_block( $atts, $content = null ) { ?>
    <div class="video-block"><span class="ViewCount"><?php the_views(); ?></span> <a class="dl-source" href="<?php echo $content; ?>">Link</a></div>
<?php }

（3）此代码显示内容上方的视图，以及正确位置的链接：

function video_block( $atts, $content = null ) {
    $views = the_views();
    return '<div class="video-block"><span class="ViewCount"><?php $views; ?></span> <a class="dl-source" href="<?php echo $content; ?>">Link</a></div>';
}

我在 WordPress 论坛的某处读到你应该在函数中返回（而不是回显）值，但这会破坏它，显示视图计数，跳过 html 并吐出 $content。

以下是相关页面的链接：http://nvrt.me/4Qf1（当前使用来自第 2 块）

我的夜灯快用完了。如果有人能帮助我，我将非常感激。

---

编辑：

这是 the_views() 的代码；功能。我可以看到它是回显的，但是当更改为返回时，它根本不显示。

### Function: Display The Post Views
function the_views($display = true, $prefix = '', $postfix = '', $always = false) {
    $post_views = intval(post_custom('views'));
    $views_options = get_option('views_options');
    if ($always || should_views_be_displayed($views_options)) {
        $output = $prefix.str_replace('%VIEW_COUNT%', number_format_i18n($post_views), $views_options['template']).$postfix;
        if($display) {
            echo apply_filters('the_views', $output);
        } else {
            return apply_filters('the_views', $output);
        }
    }
    elseif (!$display) {
        return '';
    }
}

Answer 1

尽管在 WordPress 中建议使用返回值的函数，但并不总是可行，特别是当您调用另一个将其输出直接写入到溪流。

当组件将其输出直接写入流时，您需要编码以适应该行为，除非您想重写 who 组件（我不会这样做;-)）。

在这种情况下， the_views() 函数实际上为您提供了这两个选项。如果您查看 $display 参数并遵循代码，则该函数可以以两种方式运行。如果 $display 设置为 True（默认值），它将回显该函数的结果。如果 $display 设置为 False 它将返回输出。

因此，您有两个选项，这两个选项都应该有效：

选项 1，返回一个值

请注意，当我调用 the_views() 时，我向它传递了一个错误参数，如下所示： the_views (false)

<?php

function video_block( $atts, $content = null ) { 
  return "<div class=\"video-block\"><span class=\"ViewCount\">" . the_views(false) .  "</span><a class=\"dl-source\" href=\"$content\">Link</a></div>";
}

?>

*选项 2：回显您的输出 *

请注意，当我调用 the_views() 时，没有传递给它的参数。

<?php

function video_block( $atts, $content = null ) { 
  echo "<div class=\"video-block\"><span class=\"ViewCount\">";
  the_views();
  echo "</span><a class=\"dl-source\" href=\"$content\">Link</a></div>";
}

?>

哦，另外，当您返回字符串时，不要忘记转义引号。

Answer 2

无法添加代码块作为对 @BLewis 响应的评论，但根据他所说的内容，我做了这样的事情：

function my_shortcode() {
  ob_start();
  a_function_to_display();
  $data = ob_get_clean();
  return $data;
}
add_shortcode( 'shortcode_name', 'my_shortcode' );

Answer 3

我想在这里贡献一个新的答案。

我正在努力扩展一个插件，发现作者就是这样做的，对我来说这更有意义。

如果您要输出大量 HTML，则不应使用 echo，这是不好的做法，难以阅读，而且使用 echo 保持输出格式良好也很痛苦。即使您使用它的对应部分，使用 echo_r 或 print 或 var_dump 仍然不如使用纯 HTML 干净。

由于 PHP 仅在包装标签 和 ?> 内运行，因此您应该充分利用这一点。

但是，由于我们不能只在这里执行此操作，因为您可能会丢失内容顺序，因此您可以使用一些对象存储。基本上在开始 HTML 块之前（可能在短代码函数的开头会很好），只需添加 ob_start(); 来存储您的代码。然后，在结束函数之前，您可以使用 $data = ob_get_clean(); 和 return $data; 返回数据。

祝您在更多 WordPress 工作中好运。