wordpress 导入数据

WordPress 5.5+ 可将参数传递给模板文件

在 WordPress 5.5 及更高版本中，开发者可以通过将参数传递给模板文件来实现更灵活的页面定制，本文将详细介绍如何在 WordPress 中实现这一功能，并提供一些使用示例。

什么是模板文件

在 WordPress 中，模板文件是用于定义页面布局和内容的 HTML 文件，它们通常位于主题目录下的 template-parts 文件夹中，并使用特定的命名规则(如 content-{slug}.php)进行组织，通过编辑模板文件，开发者可以自定义页面的外观和功能。

如何将参数传递给模板文件

1、在主题的 functions.php 文件中添加自定义函数

要将参数传递给模板文件，首先需要在主题的 functions.php 文件中添加一个自定义函数，这个函数接收一个参数($post_id),并将其作为变量存储在全局作用域中，可以使用 get_template_part() 函数来引用模板文件。

function my_custom_function($post_id) {
    global $post;
    $my_variable = 'Hello, World!'; // 这里可以设置你需要传递给模板文件的参数值
    get_template_part('template-parts/content', array('slug' => $post->post_type));
}
add_action('the_content', 'my_custom_function');

2、在模板文件中使用传递的参数

在模板文件(如 content-post.php)中，可以使用 get_bloginfo() 函数获取传递的参数值。

<?php echo get_bloginfo('name'); ?> <!-输出博客名称 -->

3、在其他地方调用自定义函数以传递参数

要在其他地方调用自定义函数以传递参数，可以使用 do_action() 函数，可以在文章列表页面上调用自定义函数，将文章类型作为参数传递给模板文件：

<?php get_header(); ?>
<div id="content">
    <?php if (have_posts()) : while (have_posts()) : the_post(); ?>
        <?php do_action('my_custom_function', get_the_ID()); ?> <!-调用自定义函数并传递文章 ID 作为参数 -->
        <h2><a href="<?php the_permalink(); ?>"><?php the_title(); ?></a></h2> <!-显示文章标题和链接 -->
        <?php the_excerpt(); ?> <!-显示文章摘要 -->
    <?php endwhile; endif; ?>
</div>
<?php get_footer(); ?>

相关问题与解答

Q: 如何将多个参数传递给模板文件？

A: 若要将多个参数传递给模板文件，可以在 get_template_part() 函数中添加更多参数。

get_template_part('template-parts/content', array('slug' => $post->post_type, 'page-id' => $page_id));