set_theme_mod()

更新当前主题的主题修改值。

原型

set_theme_mod( string $name, mixed $value )

参数

$name (string) (Required) 主题修改名称。

$value (mixed) (Required) 主题修改价值。

源文件

路径：wp-includes/theme.php

<?php
...
function set_theme_mod( $name, $value ) {
	$mods = get_theme_mods();
	$old_value = isset( $mods[ $name ] ) ? $mods[ $name ] : false;
	/**
	 * Filters the theme mod value on save.
	 *
	 * The dynamic portion of the hook name, `$name`, refers to the key name of
	 * the modification array. For example, 'header_textcolor', 'header_image',
	 * and so on depending on the theme options.
	 *
	 * @since 3.9.0
	 *
	 * @param string $value     The new value of the theme mod.
	 * @param string $old_value The current value of the theme mod.
	 */
	$mods[ $name ] = apply_filters( "pre_set_theme_mod_{$name}", $value, $old_value );
	$theme = get_option( 'stylesheet' );
	update_option( "theme_mods_$theme", $mods );
}
...
?>

其他

英文文档：https://developer.wordpress.org/reference/functions/set_theme_mod/