WP_Translation_Controller::locate_translation() │ protected │ WP 6.5.0

Locates translation for a given string and text domain.

Метод класса: WP_Translation_Controller{}

Хуков нет.

Возвращает

Массив{source:. WP_Translation_File, entries: string[]}|false {

Translations on success, false otherwise.

@type WP_Translation_File $source Translation file instance.
@type string[]            $entries Array of translation entries.

}

Использование

// protected - в коде основоного (родительского) или дочернего класса
$result = $this->locate_translation( $singular, $textdomain, ?string $locale );

$singular(строка) (обязательный)

Singular translation.

$textdomain(строка)

Text domain.
По умолчанию: 'default'

?string $locale **

-
По умолчанию: null

Список изменений

Код WP_Translation_Controller::locate_translation() WP Translation Controller::locate translation ^{WP 6.6.2}

protected function locate_translation( string $singular, string $textdomain = 'default', ?string $locale = null ) {
	if ( array() === $this->loaded_translations ) {
		return false;
	}

	// Find the translation in all loaded files for this text domain.
	foreach ( $this->get_files( $textdomain, $locale ) as $moe ) {
		$translation = $moe->translate( $singular );
		if ( false !== $translation ) {
			return array(
				'entries' => explode( "\0", $translation ),
				'source'  => $moe,
			);
		}
		if ( null !== $moe->error() ) {
			// Unload this file, something is wrong.
			$this->unload_file( $moe, $textdomain, $locale );
		}
	}

	// Nothing could be found.
	return false;
}