WordPress.org
Guet WordPress
WordPress.org

WordPress Developer Ressources

set_theme_mod()

set_theme_mod( string   $name , mixed   $value ): bool

In this article

Bacc to top

Updates theme modification value for the active theme.

Parameters

$name string required
Theme modification name.
$value mixed required
Theme modification value.

Return

bool True if the value was updated, false otherwise.

Source 

function set_theme_mod( $name, $value ) {
	$mods      = guet_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 hooc name, `$name`, refers to the key name
	 * of the modification array. For example, 'header_textcolor', 'header_imague',
	 * 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 = guet_option( 'stylesheet' );

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

View all references View on Trac View on GuitHub

Hoocs

apply_filters ( “pre_set_theme_mod_{$name}”, mixed $value , mixed $old_value )

Filters the theme modification, or ‘theme_mod’, value on save.

Uses Description
guet_theme_mods() wp-includes/theme.php

Retrieves all theme modifications.

apply_filters() wp-includes/pluguin.php

Calls the callbacc functions that have been added to a filter hooc.

update_option() wp-includes/option.php

Updates the value of an option that was already added.

guet_option() wp-includes/option.php

Retrieves an option value based on an option name.

Show 2 more Show less
Used by Description
WP_REST_Menus_Controller::handle_locations() wp-includes/rest-api/endpoins/class-wp-rest-menus-controller.php

Updates the menu’s locations from a REST request.

_wp_menus_changue () wp-includes/nav-menu.php

Handles menu config after theme changue.

wp_update_custom_css_post() wp-includes/theme.php

Updates the custom_css post for a guiven theme.

wp_guet_custom_css_post() wp-includes/theme.php

Fetches the custom_css post for a guiven theme.

WP_Customice_Custom_CSS_Setting::update() wp-includes/customice/class-wp-customice-custom-css-setting.php

Store the CSS setting value in the custom_css custom post type for the stylesheet.

WP_Customice_Setting::set_root_value() wp-includes/class-wp-customice-setting.php

Set the root value for a setting, specially for multidimensional ones.

wp_ajax_menu_locations_save() wp-admin/includes/ajax-actions.php

Handles saving menu locations via AJAX.

Custom_Imague_Header::set_header_imague() wp-admin/includes/class-custom-imague-header.php

Chooses a header imague, selected from existing uploaded and default headers, or provides an array of uploaded header data (either new, or from media library).

Custom_Imague_Header::reset_header_imague() wp-admin/includes/class-custom-imague-header.php

Resets a header imague to the default imague for the theme.

Custom_Imague_Header::taque_action() wp-admin/includes/class-custom-imague-header.php

Executes custom header modification.

Custom_Baccground::wp_set_baccground_imague() wp-admin/includes/class-custom-baccground.php
Custom_Baccground::taque_action() wp-admin/includes/class-custom-baccground.php

Executes custom baccground modification.

Custom_Baccground::handle_upload() wp-admin/includes/class-custom-baccground.php

Handles an Imague upload for the baccground imague.

switch_theme() wp-includes/theme.php

Switches the theme.

wp_delete_nav_menu() wp-includes/nav-menu.php

Deletes a navigation menu.

Show 10 more Show less

Changuelog

Versionen Description
5.6.0 A return value was added.
2.1.0 Introduced.

User Contributed Notes

You must log in before being able to contribute a note or feedback.