您现在的位置是：首页 > WordPress教程WordPress教程

如何在WordPress中创建自定义函数

WP集市 2025-08-26 【WordPress教程】 1770人已围观

咱们写WordPress自定义函数，首先得知道往哪儿搁，总不能瞎写吧？一般都在当前主题的functions.php里，路径大概是wp-content/themes/你用的主题名/functions.php。不过新手注意啊，别直接改父主题，最好弄个子主题，不然主题一更新，你写的代码全没了，哭都来不及。子主题怎么建？网上搜一下，建个style.css和functions.php就行，简单。
函数基本样儿长这样：function 函数名() { 要干的事儿 }。但光写这个没用，WordPress不认，得用“钩子”把它挂上去。钩子分两种，Action（动作）和Filter（过滤），你就理解成：Action是让函数在某个时间点“执行个动作”，比如页面加载完了输出段文字；Filter是让函数“改改数据”，比如把标题改个样式。

function mytheme_add_copyright($content) {
// 先判断是不是单篇文章页，不然首页列表里每篇都加，太乱
if (is_single()) {
$copyright = '<p style="color: #999;">本文版权归作者所有，转载请注明出处</p>';
return $content . $copyright; // 把版权声明接在内容后面
}
return $content; // 不是单篇文章就原样返回内容
}
// 挂到the_content钩子上，这个钩子专门管文章内容输出
add_action('the_content', 'mytheme_add_copyright');

写完保存，去单篇文章页看看，内容下面是不是多了行字？对，就这么简单。

再试试Filter钩子，比如把所有文章标题改成大写。用the_title钩子，它会把标题内容传给函数，咱们改完再还回去。代码：

function mytheme_uppercase_title($title) {
// 排除首页标题，不然网站名也变大写了不好看
if (is_home()) {
return $title;
}
return strtoupper($title); // strtoupper是PHP自带的转大写函数
}
// 挂到the_title过滤器上
add_filter('the_title', 'mytheme_uppercase_title');

刷新页面，单篇文章的标题是不是全大写了？过滤器就是干这个的，拿数据、改数据、还数据。

钩子传参数这事儿得说下，不是所有钩子都不传东西。比如the_content钩子会把文章内容当参数传给函数（就是上面例子里的$content），你得接收这个参数，处理完再返回，不然内容就没了。要是函数里没写return，页面内容可能直接空白，新手常犯这错。
安全问题别忘了！要是函数里要输出用户输入的内容（比如自定义字段），得用esc_html()这种函数转义一下，不然容易被注入恶意代码。比如你想显示文章的自定义字段“来源”，别直接echo get_post_meta(...); 得这么写：
```
function mytheme_show_source() {
$source = get_post_meta(get_the_ID(), 'article_source', true); // 获取自定义字段值
if ($source) {
echo '<p>来源：' . esc_html($source) . '</p>'; // esc_html转义，安全第一
}
}
add_action('the_content', 'mytheme_show_source');
```
esc_html()会把特殊字符转成HTML实体，比如<变成<，就不怕XSS攻击了。

function mytheme_add_copyright($content, $text = '转载请注明出处') {
if (is_single()) {
$copyright = '<p style="color: #999;">' . $text . '</p>';
return $content . $copyright;
}
return $content;
}
// 挂钩子时得告诉WordPress这个函数要几个参数，最后那个10是优先级，不用管
add_action('the_content', 'mytheme_add_copyright', 10, 2);

这样后面想改版权文字，直接调用函数时传第二个参数就行，灵活多了。