change_locale

Fires when the locale is switched to or restored.

Description

do_action( 'change_locale', (string) $locale ); 

Parameters (1)

0. $locale (string)
The new locale.

Usage

To run the hook, copy the example below.
  1. // run the action 
  2. do_action( 'change_locale', $locale ); 
The following example is for adding a hook callback.
  1. // define the change_locale callback 
  2. function action_change_locale( $locale ) { 
  3. // make action magic happen here... 
  4. }; 
  5.  
  6. // add the action 
  7. add_action( 'change_locale', 'action_change_locale', 10, 1 ); 
To remove a hook callback, use the example below.
  1. // remove the action 
  2. remove_action( 'change_locale', 'action_change_locale', 10, 1 ); 

Defined (3)

The action is defined in the following location(s).

/wp-includes/class-wp-locale-switcher.php  
  1. do_action( 'change_locale', $locale ); 
/wp-includes/default-filters.php  
  1. add_action( 'change_locale', 'create_initial_post_types' ); 
  1. add_action( 'change_locale', 'create_initial_taxonomies' );