如果你要把这个主题交给别人用,会立刻遇到一个问题:别人想要的页脚文字、logo、配色,和你不一样。
第一反应往往是「让他改代码」。这不现实——大多数人不会改 PHP。
// 后台「外观 → 自定义」里注册一个字段
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_text_field,网址用 esc_url_raw,多行文本用 sanitize_textarea_field。不写这个,用户能存进任意 HTML。
页脚文字、logo、社交链接、主色——四五个够了。设置项一多,用户反而不知道该改哪个,你还得为每一项写文档。
下一篇:这一路踩过的坑。
本系列:迭代式建主题 · 目录(72 篇) | 上一篇 (69) | 下一篇 (71)