迭代式建主题(70):从主题到产品:配置项怎么设计

作者: admin 分类: wordpress主题制作教程 发布时间: 2026-11-05 09:00

如果你要把这个主题交给别人用,会立刻遇到一个问题:别人想要的页脚文字、logo、配色,和你不一样。

别把能改的东西写死

第一反应往往是「让他改代码」。这不现实——大多数人不会改 PHP。

用 Customizer 加一个字段

// 后台「外观 → 自定义」里注册一个字段
function itheme_customize( $wp_customize ) {
    $wp_customize->add_setting( 'itheme_footer_text', array(
        'default'           => '© 我的站',
        'sanitize_callback' => 'sanitize_text_field',
    ) );
    $wp_customize->add_control( 'itheme_footer_text', array(
        'label'   => '页脚文字',
        'section' => 'title_tagline',
        'type'    => 'text',
    ) );
}
add_action( 'customize_register', 'itheme_customize' );

两个部分:add_setting 声明这个设置项(含默认值和清洗方式),add_control 决定它显示在后台哪个位置。

模板里取出来

<?php echo esc_html( get_theme_mod( 'itheme_footer_text', '© 我的站' ) ); ?>

第二个参数是默认值——用户没设过时显示这个,所以页脚不会是空的。

sanitize_callback 不能省

它决定「用户输进来的东西怎么洗干净」。文本用 sanitize_text_field,网址用 esc_url_raw,多行文本用 sanitize_textarea_field。不写这个,用户能存进任意 HTML。

几个算合适

页脚文字、logo、社交链接、主色——四五个够了。设置项一多,用户反而不知道该改哪个,你还得为每一项写文档。

下一篇:这一路踩过的坑。

本系列:迭代式建主题 · 目录(72 篇) | 上一篇 (69) | 下一篇 (71)

相关文章

发表回复

您的邮箱地址不会被公开。 必填项已用 * 标注

Powered by 草根站长笔记 © 2015-2026 草根站长笔记 Inc.版权所有,禁止转载