WordPress.org
Get WordPress
WordPress.org

WordPress Developer Resources

get_translations_for_domain()

get_translations_for_domain( string $domain ): Translations|NOOP_Translations

In this article

Back to top

Returns the Translations instance for a text domain.

Description

If there isn’t one, returns empty Translations instance.

Parameters

$domainstringrequired
Text domain. Unique identifier for retrieving translated strings.

Return

Translations|NOOP_Translations A Translations instance.

Source

function get_translations_for_domain( $domain ) {
	global $l10n;
	if ( isset( $l10n[ $domain ] ) || ( _load_textdomain_just_in_time( $domain ) && isset( $l10n[ $domain ] ) ) ) {
		return $l10n[ $domain ];
	}

	static $noop_translations = null;
	if ( null === $noop_translations ) {
		$noop_translations = new NOOP_Translations();
	}

	$l10n[ $domain ] = &$noop_translations;

	return $noop_translations;
}

View all references View on Trac View on GitHub

UsesDescription
_load_textdomain_just_in_time()wp-includes/l10n.php

Loads plugin and theme text domains just-in-time.

Used byDescription
WP_Locale_Switcher::load_translations()wp-includes/class-wp-locale-switcher.php

Load translations for a given locale.

translate()wp-includes/l10n.php

Retrieves the translation of $text.

translate_with_gettext_context()wp-includes/l10n.php

Retrieves the translation of $text in the context defined in $context.

_n()wp-includes/l10n.php

Translates and retrieves the singular or plural form based on the supplied number.

_nx()wp-includes/l10n.php

Translates and retrieves the singular or plural form based on the supplied number, with gettext context.

Changelog

VersionDescription
2.8.0Introduced.

User Contributed Notes

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