如何创建自定义 WordPress 模板标签
使用模板标签构建WordPress 主题非常简单。您可以添加以显示帖子或页面标题,也可以使用它来显示帖子或页面内容。WordPress 中还有更多的模板标签,我们可以使用它们来显示其他内容。the_title()
the_content()
但是当谈到只显示主题中的特定内容时,您可能希望创建自己的模板标签。在今天的教程中,我们将带您完成这个不太复杂的过程。让我们从基础开始。
基本模板标签
如果您看一下WordPress 核心资源,您会发现模板标签基本上是一个 PHP 函数,运行一组带有一些参数的代码。
例如,要创建自己的模板标签,您可以在主题目录中的 functions.php 中编写一个 PHP 函数。
1个
2个
3个
|
function my_template_tag() { echo 'This is my template' ; } |
然后,在您的其他主题文件中,例如single.php
或page.php
,您可以像这样添加该功能。
1个
|
<?php my_template_tag() ;?> |
这将显示在函数内部回显的“这是我的模板” my_template_tag()
。
创建一个 WordPress 模板就是这么简单。好了,现在让我们来看一个稍微高级一点的例子。
页面浏览量计数模板标签
在此示例中,我们将创建一个模板,该模板将显示每个帖子和页面的查看次数。
首先,在Jetpack中安装并激活 WordPress.com Stat。并确保您已将 Jetpack 连接到 WordPress.com。我们使用 WordPress.com Stat 的原因是视图数据将存储在 WordPress.com 而不是我们自己的数据库中。这可以节省我们的服务器负载。
在名为 的functions.php中创建一个函数the_view()
,如下所示:
1个
2个
3个
|
function the_view() { } |
我们会将函数(模板标签)放在页面或帖子中,因此我们需要获取页面和帖子 ID 号。这可以使用检索get_the_ID();
。
1个
2个
3个
|
function the_view() { $id = get_the_ID(); } |
然后,我们可以使用函数从 WordPress.com Stats 中检索视图数stats_get_csv();
。这个函数接受几个参数(在这里找到完整的列表)。
在我们的例子中,我们需要添加days
,它指定视图计数的时间范围,以及post_id
.
1个
2个
3个
4个
|
function the_view() { $id = get_the_ID(); $page_view = stats_get_csv( 'postviews' , 'days=-1&post_id=' . $id . '' ); } |
在上面的代码中,由于我们将参数设置days
为-1
,我们将从一开始就检索给定帖子 ID 的查看次数,从激活 WordPress.com Stat 插件时开始。
一旦我们有了数字,我们只需要回显它,如下所示。
1个
2个
3个
4个
5个
|
function the_view() { $id = get_the_ID(); $page_view = stats_get_csv( 'postviews' , 'days=-1&post_id=' . $id . '' ); echo $page_view [0][ 'views' ]; } |
就是这样,我们用于显示页面浏览量的新模板标签就完成了。您可以<?php the_view() ;?>
在 page.php 或 single.php 中的任何位置。例如:
如果您有任何疑问,请随时将其放在下面的评论部分。