wpseek.com
A WordPress-centric search engine for devs and theme authors



set_theme_mod › WordPress Function

Since2.1.0
Deprecatedn/a
set_theme_mod ( $name, $value )
Parameters: (2)
  • (string) $name Theme modification name.
    Required: Yes
  • (mixed) $value Theme modification value.
    Required: Yes
Returns:
  • (bool) True if the value was updated, false otherwise.
Defined at:
Codex:
Change Log:
  • 5.6.0

Updates theme modification value for the active theme.



Source

function set_theme_mod( $name, $value ) {
	$mods      = get_theme_mods();
	$old_value = isset( $mods[ $name ] ) ? $mods[ $name ] : false;

	/**
	 * Filters the theme modification, or '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 mixed $value     The new value of the theme modification.
	 * @param mixed $old_value The current value of the theme modification.
	 */
	$mods[ $name ] = apply_filters( "pre_set_theme_mod_{$name}", $value, $old_value );

	$theme = get_option( 'stylesheet' );

	return update_option( "theme_mods_$theme", $mods );
}