WordPress.org
Get WordPress
WordPress.org

WordPress Developer Resources

WP_Textdomain_Registry::invalidate_mo_files_cache()

WP_Textdomain_Registry::invalidate_mo_files_cache( WP_Upgrader $upgrader, array $hook_extra )

In this article

Back to top

Invalidate the cache for .mo files.

Description

This function deletes the cache entries related to .mo files when triggered by specific actions, such as the completion of an upgrade process.

Parameters

$upgraderWP_Upgraderrequired
Unused. WP_Upgrader instance. In other contexts this might be a Theme_Upgrader, Plugin_Upgrader, Core_Upgrade, or Language_Pack_Upgrader instance.
$hook_extraarrayrequired
Array of bulk item update data.
  • action string
    Type of action. Default 'update'.
  • type string
    Type of update process. Accepts 'plugin', 'theme', 'translation', or 'core'.
  • bulk bool
    Whether the update process is a bulk update. Default true.
  • plugins array
    Array of the basename paths of the plugins’ main files.
  • themes array
    The theme slugs.
  • translations array
    Array of translations update data.
    • language string
      The locale the translation is for.
    • type string
      Type of translation. Accepts 'plugin', 'theme', or 'core'.
    • slug string
      Text domain the translation is for. The slug of a theme/plugin or 'default' for core translations.
    • version string
      The version of a theme, plugin, or core.

Source

public function invalidate_mo_files_cache( $upgrader, $hook_extra ) {
	if (
		! isset( $hook_extra['type'] ) ||
		'translation' !== $hook_extra['type'] ||
		array() === $hook_extra['translations']
	) {
		return;
	}

	$translation_types = array_unique( wp_list_pluck( $hook_extra['translations'], 'type' ) );

	foreach ( $translation_types as $type ) {
		switch ( $type ) {
			case 'plugin':
				wp_cache_delete( md5( WP_LANG_DIR . '/plugins/' ), 'translation_files' );
				break;
			case 'theme':
				wp_cache_delete( md5( WP_LANG_DIR . '/themes/' ), 'translation_files' );
				break;
			default:
				wp_cache_delete( md5( WP_LANG_DIR . '/' ), 'translation_files' );
				break;
		}
	}
}

View all references View on Trac View on GitHub

UsesDescription
wp_cache_delete()wp-includes/cache.php

Removes the cache contents matching key and group.

wp_list_pluck()wp-includes/functions.php

Plucks a certain field out of each object or array in an array.

Changelog

VersionDescription
6.5.0Introduced.

User Contributed Notes

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