WordPress主题开发（ 十二）之—— 主题的functions.php

介绍

functions.php文件是WordPress主题开发中的关键文件之一，它允许我们向WordPress主题添加功能和特性。通过在functions.php中调用WordPress函数或定义自己的函数，我们可以增强主题的模块化性、扩展性和功能性。

使用functions.php vs. 插件

在开发主题时，我们通常需要添加一些自定义功能。这可以通过将功能添加到functions.php文件或创建一个独立的WordPress插件来实现。每种方法都有其优点和缺点，下面对比一下：

使用WordPress插件：

• 需要独立的插件文件和标题文本。
• 存储在wp-content/plugins目录中。
• 仅在插件激活时执行。
• 适用于所有主题。
• 应该用于特定的功能，如SEO优化或备份。

使用functions.php文件：

• 不需要唯一的标题文本。
• 存储在当前主题目录的functions.php文件中。
• 仅在激活当前主题时执行。
• 仅适用于当前主题（如果更改主题，则功能不再可用）。
• 可以包含多个代码块，实现各种功能。

通常，如果要为主题添加新功能，最好将其放在插件中。但在functions.php文件中，我们可以添加与当前主题紧密相关的功能。

创建和使用functions.php

每个WordPress主题都可以包含一个functions.php文件。如果我们的主题已经有这个文件，我们可以直接向其中添加代码。如果没有，我们需要创建一个。

子主题可以有自己的functions.php文件。将函数添加到子主题的functions.php文件中是一种无风险的方法，因为在更新父主题时，子主题的功能不会丢失。请注意，尽管子主题的functions.php在父主题之前加载，但它不会覆盖父主题的文件。这允许我们扩展或修改父主题的功能。

在functions.php中的常见用途

以下是我们可以在functions.php文件中执行的一些常见操作：

1. 使用WordPress钩子

可以使用WordPress提供的钩子来添加或修改功能。例如，通过使用excerpt_length过滤器，我们可以更改文章摘录的长度（默认为55个单词）。

function custom_excerpt_length($length) {
    return 30; // 修改摘录长度为30个单词
}
add_filter('excerpt_length', 'custom_excerpt_length');
1
2
3
4

2. 启用WordPress功能

使用add_theme_support()函数，我们可以启用WordPress的各种功能，如缩略图、文章格式和导航菜单。

add_theme_support('post-thumbnails'); // 启用特色图片
add_theme_support('post-formats', array('aside', 'gallery', 'quote', 'image', 'video')); // 启用文章格式
1
2

3. 定义可重用的函数

我们可以在functions.php文件中定义自己的函数，然后在主题的其他模板文件中重复使用这些函数。这可以提高代码的可维护性。

function custom_display_author() {
    $author = get_the_author();
    echo "文章作者：$author";
}
1
2
3
4

4. 添加自动Feed链接

使用add_theme_support()函数，我们可以添加自动Feed链接到中，使用户能够订阅文章和评论的RSS Feed。

add_theme_support('automatic-feed-links');
1

5. 自定义导航菜单

使用register_nav_menus()函数，我们可以在主题中注册自定义导航菜单，让用户可以轻松管理网站菜单。

register_nav_menus(array(
    'primary' => '主导航菜单',
    'footer' => '页脚菜单',
));
1
2
3
4

6. 文本域加载

通过使用load_theme_textdomain()函数，我们可以使主题中的字符串可翻译，以便将主题本地化为多种语言。

load_theme_textdomain('mytheme', get_template_directory() . '/languages');
1

7. 定义内容宽度

定义内容宽度变量可以确保上传的内容（如图片）不会破坏网站布局。内容宽度设置了允许添加到网站的任何内容的最大宽度。

if (!isset($content_width)) {
    $content_width = 800; // 像素
}
1
2
3

示例functions.php文件

下面是一个示例functions.php文件，其中包括上述许多功能和其他常见功能。

/**
 * 主题功能和定义
 *
 * @package MyCustomTheme
 * @since MyCustomTheme 1.0
 */

// 设置内容宽度
if (!isset($content_width)) {
    $content_width = 800; // 像素
}

if (!function_exists('mycustomtheme_setup')) :
/**
 * 设置主题默认值，并注册一些WordPress功能
 * 请确保这些功能在init钩子之前设置，以确保其有效性
 */
function mycustomtheme_setup() {

    // 使主题可翻译
    load_theme_textdomain('mycustomtheme', get_template_directory() . '/languages');

    // 添加默认的文章和评论订阅源到中
    add_theme_support('automatic-feed-links');

    // 添加缩略图和特色图像支持
    add_theme_support('post-thumbnails');

    // 添加自定义菜单
    register_nav_menus(array(
        'primary' => __('主导航菜单', 'mycustomtheme'),
        'footer' => __('页脚菜单', 'mycustomtheme'),
    ));

    // 启用文章格式支持：aside, gallery, quote, image, and video
    add_theme_support('post-form

ats', array('aside', 'gallery', 'quote', 'image', 'video'));
}
endif; // mycustomtheme_setup

add_action('after_setup_theme', 'mycustomtheme_setup');
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42

请注意，上面的示例中的函数名mycustomtheme是一个示例主题名称，应根据实际主题名称进行更改。

总结

functions.php文件是WordPress主题开发中的关键文件之一，用于添加自定义功能和特性。通过合理使用它，可以增强主题的功能、扩展性和可维护性。请根据自己的主题需求和功能添加适当的代码。不同主题可能需要不同的自定义功能，functions.php文件为您提供了实现这些功能的灵活性。