enmi-conf.org: wp/wp-includes/l10n.php@cf61fcea0001 (annotated)

0 d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	1	<?php
d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	2	/**
7 cf61fcea0001 resynchronize code repo with production ymh <ymh.work@gmail.com> parents: 5 diff changeset	3	* Core Translation API
0 d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	4	*
d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	5	* @package WordPress
d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	6	* @subpackage i18n
7 cf61fcea0001 resynchronize code repo with production ymh <ymh.work@gmail.com> parents: 5 diff changeset	7	* @since 1.2.0
0 d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	8	*/
d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	9
d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	10	/**
7 cf61fcea0001 resynchronize code repo with production ymh <ymh.work@gmail.com> parents: 5 diff changeset	11	* Retrieves the current locale.
0 d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	12	*
7 cf61fcea0001 resynchronize code repo with production ymh <ymh.work@gmail.com> parents: 5 diff changeset	13	* If the locale is set, then it will filter the locale in the {@see 'locale'}
cf61fcea0001 resynchronize code repo with production ymh <ymh.work@gmail.com> parents: 5 diff changeset	14	* filter hook and return the value.
0 d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	15	*
d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	16	* If the locale is not set already, then the WPLANG constant is used if it is
7 cf61fcea0001 resynchronize code repo with production ymh <ymh.work@gmail.com> parents: 5 diff changeset	17	* defined. Then it is filtered through the {@see 'locale'} filter hook and
cf61fcea0001 resynchronize code repo with production ymh <ymh.work@gmail.com> parents: 5 diff changeset	18	* the value for the locale global set and the locale is returned.
0 d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	19	*
d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	20	* The process to get the locale should only be done once, but the locale will
7 cf61fcea0001 resynchronize code repo with production ymh <ymh.work@gmail.com> parents: 5 diff changeset	21	* always be filtered using the {@see 'locale'} hook.
0 d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	22	*
d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	23	* @since 1.5.0
d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	24	*
7 cf61fcea0001 resynchronize code repo with production ymh <ymh.work@gmail.com> parents: 5 diff changeset	25	* @global string $locale
cf61fcea0001 resynchronize code repo with production ymh <ymh.work@gmail.com> parents: 5 diff changeset	26	* @global string $wp_local_package
cf61fcea0001 resynchronize code repo with production ymh <ymh.work@gmail.com> parents: 5 diff changeset	27	*
cf61fcea0001 resynchronize code repo with production ymh <ymh.work@gmail.com> parents: 5 diff changeset	28	* @return string The locale of the blog or from the {@see 'locale'} hook.
0 d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	29	*/
d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	30	function get_locale() {
5 5e2f62d02dcd upgrade wordpress + plugins ymh <ymh.work@gmail.com> parents: 0 diff changeset	31	global $locale, $wp_local_package;
0 d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	32
5 5e2f62d02dcd upgrade wordpress + plugins ymh <ymh.work@gmail.com> parents: 0 diff changeset	33	if ( isset( $locale ) ) {
0 d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	34	/**
7 cf61fcea0001 resynchronize code repo with production ymh <ymh.work@gmail.com> parents: 5 diff changeset	35	* Filters the locale ID of the WordPress installation.
0 d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	36	*
5 5e2f62d02dcd upgrade wordpress + plugins ymh <ymh.work@gmail.com> parents: 0 diff changeset	37	* @since 1.5.0
0 d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	38	*
d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	39	* @param string $locale The locale ID.
d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	40	*/
d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	41	return apply_filters( 'locale', $locale );
5 5e2f62d02dcd upgrade wordpress + plugins ymh <ymh.work@gmail.com> parents: 0 diff changeset	42	}
0 d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	43
5 5e2f62d02dcd upgrade wordpress + plugins ymh <ymh.work@gmail.com> parents: 0 diff changeset	44	if ( isset( $wp_local_package ) ) {
5e2f62d02dcd upgrade wordpress + plugins ymh <ymh.work@gmail.com> parents: 0 diff changeset	45	$locale = $wp_local_package;
5e2f62d02dcd upgrade wordpress + plugins ymh <ymh.work@gmail.com> parents: 0 diff changeset	46	}
5e2f62d02dcd upgrade wordpress + plugins ymh <ymh.work@gmail.com> parents: 0 diff changeset	47
5e2f62d02dcd upgrade wordpress + plugins ymh <ymh.work@gmail.com> parents: 0 diff changeset	48	// WPLANG was defined in wp-config.
5e2f62d02dcd upgrade wordpress + plugins ymh <ymh.work@gmail.com> parents: 0 diff changeset	49	if ( defined( 'WPLANG' ) ) {
0 d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	50	$locale = WPLANG;
5 5e2f62d02dcd upgrade wordpress + plugins ymh <ymh.work@gmail.com> parents: 0 diff changeset	51	}
0 d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	52
d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	53	// If multisite, check options.
d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	54	if ( is_multisite() ) {
d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	55	// Don't check blog option when installing.
7 cf61fcea0001 resynchronize code repo with production ymh <ymh.work@gmail.com> parents: 5 diff changeset	56	if ( wp_installing() \|\| ( false === $ms_locale = get_option( 'WPLANG' ) ) ) {
5 5e2f62d02dcd upgrade wordpress + plugins ymh <ymh.work@gmail.com> parents: 0 diff changeset	57	$ms_locale = get_site_option( 'WPLANG' );
5e2f62d02dcd upgrade wordpress + plugins ymh <ymh.work@gmail.com> parents: 0 diff changeset	58	}
0 d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	59
5 5e2f62d02dcd upgrade wordpress + plugins ymh <ymh.work@gmail.com> parents: 0 diff changeset	60	if ( $ms_locale !== false ) {
0 d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	61	$locale = $ms_locale;
5 5e2f62d02dcd upgrade wordpress + plugins ymh <ymh.work@gmail.com> parents: 0 diff changeset	62	}
5e2f62d02dcd upgrade wordpress + plugins ymh <ymh.work@gmail.com> parents: 0 diff changeset	63	} else {
5e2f62d02dcd upgrade wordpress + plugins ymh <ymh.work@gmail.com> parents: 0 diff changeset	64	$db_locale = get_option( 'WPLANG' );
5e2f62d02dcd upgrade wordpress + plugins ymh <ymh.work@gmail.com> parents: 0 diff changeset	65	if ( $db_locale !== false ) {
5e2f62d02dcd upgrade wordpress + plugins ymh <ymh.work@gmail.com> parents: 0 diff changeset	66	$locale = $db_locale;
5e2f62d02dcd upgrade wordpress + plugins ymh <ymh.work@gmail.com> parents: 0 diff changeset	67	}
0 d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	68	}
d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	69
5 5e2f62d02dcd upgrade wordpress + plugins ymh <ymh.work@gmail.com> parents: 0 diff changeset	70	if ( empty( $locale ) ) {
0 d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	71	$locale = 'en_US';
5 5e2f62d02dcd upgrade wordpress + plugins ymh <ymh.work@gmail.com> parents: 0 diff changeset	72	}
0 d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	73
5 5e2f62d02dcd upgrade wordpress + plugins ymh <ymh.work@gmail.com> parents: 0 diff changeset	74	/** This filter is documented in wp-includes/l10n.php */
0 d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	75	return apply_filters( 'locale', $locale );
d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	76	}
d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	77
d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	78	/**
7 cf61fcea0001 resynchronize code repo with production ymh <ymh.work@gmail.com> parents: 5 diff changeset	79	* Retrieves the locale of a user.
cf61fcea0001 resynchronize code repo with production ymh <ymh.work@gmail.com> parents: 5 diff changeset	80	*
cf61fcea0001 resynchronize code repo with production ymh <ymh.work@gmail.com> parents: 5 diff changeset	81	* If the user has a locale set to a non-empty string then it will be
cf61fcea0001 resynchronize code repo with production ymh <ymh.work@gmail.com> parents: 5 diff changeset	82	* returned. Otherwise it returns the locale of get_locale().
cf61fcea0001 resynchronize code repo with production ymh <ymh.work@gmail.com> parents: 5 diff changeset	83	*
cf61fcea0001 resynchronize code repo with production ymh <ymh.work@gmail.com> parents: 5 diff changeset	84	* @since 4.7.0
cf61fcea0001 resynchronize code repo with production ymh <ymh.work@gmail.com> parents: 5 diff changeset	85	*
cf61fcea0001 resynchronize code repo with production ymh <ymh.work@gmail.com> parents: 5 diff changeset	86	* @param int\|WP_User $user_id User's ID or a WP_User object. Defaults to current user.
cf61fcea0001 resynchronize code repo with production ymh <ymh.work@gmail.com> parents: 5 diff changeset	87	* @return string The locale of the user.
cf61fcea0001 resynchronize code repo with production ymh <ymh.work@gmail.com> parents: 5 diff changeset	88	*/
cf61fcea0001 resynchronize code repo with production ymh <ymh.work@gmail.com> parents: 5 diff changeset	89	function get_user_locale( $user_id = 0 ) {
cf61fcea0001 resynchronize code repo with production ymh <ymh.work@gmail.com> parents: 5 diff changeset	90	$user = false;
cf61fcea0001 resynchronize code repo with production ymh <ymh.work@gmail.com> parents: 5 diff changeset	91	if ( 0 === $user_id && function_exists( 'wp_get_current_user' ) ) {
cf61fcea0001 resynchronize code repo with production ymh <ymh.work@gmail.com> parents: 5 diff changeset	92	$user = wp_get_current_user();
cf61fcea0001 resynchronize code repo with production ymh <ymh.work@gmail.com> parents: 5 diff changeset	93	} elseif ( $user_id instanceof WP_User ) {
cf61fcea0001 resynchronize code repo with production ymh <ymh.work@gmail.com> parents: 5 diff changeset	94	$user = $user_id;
cf61fcea0001 resynchronize code repo with production ymh <ymh.work@gmail.com> parents: 5 diff changeset	95	} elseif ( $user_id && is_numeric( $user_id ) ) {
cf61fcea0001 resynchronize code repo with production ymh <ymh.work@gmail.com> parents: 5 diff changeset	96	$user = get_user_by( 'id', $user_id );
cf61fcea0001 resynchronize code repo with production ymh <ymh.work@gmail.com> parents: 5 diff changeset	97	}
cf61fcea0001 resynchronize code repo with production ymh <ymh.work@gmail.com> parents: 5 diff changeset	98
cf61fcea0001 resynchronize code repo with production ymh <ymh.work@gmail.com> parents: 5 diff changeset	99	if ( ! $user ) {
cf61fcea0001 resynchronize code repo with production ymh <ymh.work@gmail.com> parents: 5 diff changeset	100	return get_locale();
cf61fcea0001 resynchronize code repo with production ymh <ymh.work@gmail.com> parents: 5 diff changeset	101	}
cf61fcea0001 resynchronize code repo with production ymh <ymh.work@gmail.com> parents: 5 diff changeset	102
cf61fcea0001 resynchronize code repo with production ymh <ymh.work@gmail.com> parents: 5 diff changeset	103	$locale = $user->locale;
cf61fcea0001 resynchronize code repo with production ymh <ymh.work@gmail.com> parents: 5 diff changeset	104	return $locale ? $locale : get_locale();
cf61fcea0001 resynchronize code repo with production ymh <ymh.work@gmail.com> parents: 5 diff changeset	105	}
cf61fcea0001 resynchronize code repo with production ymh <ymh.work@gmail.com> parents: 5 diff changeset	106
cf61fcea0001 resynchronize code repo with production ymh <ymh.work@gmail.com> parents: 5 diff changeset	107	/**
0 d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	108	* Retrieve the translation of $text.
d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	109	*
d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	110	* If there is no translation, or the text domain isn't loaded, the original text is returned.
d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	111	*
7 cf61fcea0001 resynchronize code repo with production ymh <ymh.work@gmail.com> parents: 5 diff changeset	112	* Note: Don't use translate() directly, use __() or related functions.
0 d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	113	*
d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	114	* @since 2.2.0
d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	115	*
d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	116	* @param string $text Text to translate.
d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	117	* @param string $domain Optional. Text domain. Unique identifier for retrieving translated strings.
7 cf61fcea0001 resynchronize code repo with production ymh <ymh.work@gmail.com> parents: 5 diff changeset	118	* Default 'default'.
0 d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	119	* @return string Translated text
d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	120	*/
d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	121	function translate( $text, $domain = 'default' ) {
d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	122	$translations = get_translations_for_domain( $domain );
7 cf61fcea0001 resynchronize code repo with production ymh <ymh.work@gmail.com> parents: 5 diff changeset	123	$translation = $translations->translate( $text );
5 5e2f62d02dcd upgrade wordpress + plugins ymh <ymh.work@gmail.com> parents: 0 diff changeset	124
0 d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	125	/**
7 cf61fcea0001 resynchronize code repo with production ymh <ymh.work@gmail.com> parents: 5 diff changeset	126	* Filters text with its translation.
0 d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	127	*
d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	128	* @since 2.0.11
d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	129	*
7 cf61fcea0001 resynchronize code repo with production ymh <ymh.work@gmail.com> parents: 5 diff changeset	130	* @param string $translation Translated text.
0 d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	131	* @param string $text Text to translate.
d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	132	* @param string $domain Text domain. Unique identifier for retrieving translated strings.
d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	133	*/
7 cf61fcea0001 resynchronize code repo with production ymh <ymh.work@gmail.com> parents: 5 diff changeset	134	return apply_filters( 'gettext', $translation, $text, $domain );
0 d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	135	}
d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	136
d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	137	/**
d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	138	* Remove last item on a pipe-delimited string.
d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	139	*
d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	140	* Meant for removing the last item in a string, such as 'Role name\|User role'. The original
d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	141	* string will be returned if no pipe '\|' characters are found in the string.
d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	142	*
d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	143	* @since 2.8.0
d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	144	*
d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	145	* @param string $string A pipe-delimited string.
d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	146	* @return string Either $string or everything before the last pipe.
d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	147	*/
d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	148	function before_last_bar( $string ) {
d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	149	$last_bar = strrpos( $string, '\|' );
7 cf61fcea0001 resynchronize code repo with production ymh <ymh.work@gmail.com> parents: 5 diff changeset	150	if ( false === $last_bar ) {
0 d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	151	return $string;
7 cf61fcea0001 resynchronize code repo with production ymh <ymh.work@gmail.com> parents: 5 diff changeset	152	} else {
0 d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	153	return substr( $string, 0, $last_bar );
7 cf61fcea0001 resynchronize code repo with production ymh <ymh.work@gmail.com> parents: 5 diff changeset	154	}
0 d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	155	}
d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	156
d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	157	/**
d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	158	* Retrieve the translation of $text in the context defined in $context.
d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	159	*
d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	160	* If there is no translation, or the text domain isn't loaded the original
d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	161	* text is returned.
d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	162	*
7 cf61fcea0001 resynchronize code repo with production ymh <ymh.work@gmail.com> parents: 5 diff changeset	163	* Note: Don't use translate_with_gettext_context() directly, use _x() or related functions.
cf61fcea0001 resynchronize code repo with production ymh <ymh.work@gmail.com> parents: 5 diff changeset	164	*
0 d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	165	* @since 2.8.0
d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	166	*
d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	167	* @param string $text Text to translate.
d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	168	* @param string $context Context information for the translators.
d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	169	* @param string $domain Optional. Text domain. Unique identifier for retrieving translated strings.
7 cf61fcea0001 resynchronize code repo with production ymh <ymh.work@gmail.com> parents: 5 diff changeset	170	* Default 'default'.
0 d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	171	* @return string Translated text on success, original text on failure.
d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	172	*/
d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	173	function translate_with_gettext_context( $text, $context, $domain = 'default' ) {
d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	174	$translations = get_translations_for_domain( $domain );
7 cf61fcea0001 resynchronize code repo with production ymh <ymh.work@gmail.com> parents: 5 diff changeset	175	$translation = $translations->translate( $text, $context );
0 d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	176	/**
7 cf61fcea0001 resynchronize code repo with production ymh <ymh.work@gmail.com> parents: 5 diff changeset	177	* Filters text with its translation based on context information.
0 d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	178	*
d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	179	* @since 2.8.0
d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	180	*
7 cf61fcea0001 resynchronize code repo with production ymh <ymh.work@gmail.com> parents: 5 diff changeset	181	* @param string $translation Translated text.
0 d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	182	* @param string $text Text to translate.
d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	183	* @param string $context Context information for the translators.
d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	184	* @param string $domain Text domain. Unique identifier for retrieving translated strings.
d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	185	*/
7 cf61fcea0001 resynchronize code repo with production ymh <ymh.work@gmail.com> parents: 5 diff changeset	186	return apply_filters( 'gettext_with_context', $translation, $text, $context, $domain );
0 d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	187	}
d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	188
d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	189	/**
7 cf61fcea0001 resynchronize code repo with production ymh <ymh.work@gmail.com> parents: 5 diff changeset	190	* Retrieve the translation of $text.
cf61fcea0001 resynchronize code repo with production ymh <ymh.work@gmail.com> parents: 5 diff changeset	191	*
cf61fcea0001 resynchronize code repo with production ymh <ymh.work@gmail.com> parents: 5 diff changeset	192	* If there is no translation, or the text domain isn't loaded, the original text is returned.
0 d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	193	*
d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	194	* @since 2.1.0
d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	195	*
d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	196	* @param string $text Text to translate.
d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	197	* @param string $domain Optional. Text domain. Unique identifier for retrieving translated strings.
7 cf61fcea0001 resynchronize code repo with production ymh <ymh.work@gmail.com> parents: 5 diff changeset	198	* Default 'default'.
0 d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	199	* @return string Translated text.
d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	200	*/
d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	201	function __( $text, $domain = 'default' ) {
d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	202	return translate( $text, $domain );
d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	203	}
d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	204
d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	205	/**
d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	206	* Retrieve the translation of $text and escapes it for safe use in an attribute.
d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	207	*
d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	208	* If there is no translation, or the text domain isn't loaded, the original text is returned.
d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	209	*
d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	210	* @since 2.8.0
d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	211	*
d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	212	* @param string $text Text to translate.
d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	213	* @param string $domain Optional. Text domain. Unique identifier for retrieving translated strings.
7 cf61fcea0001 resynchronize code repo with production ymh <ymh.work@gmail.com> parents: 5 diff changeset	214	* Default 'default'.
0 d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	215	* @return string Translated text on success, original text on failure.
d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	216	*/
d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	217	function esc_attr__( $text, $domain = 'default' ) {
d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	218	return esc_attr( translate( $text, $domain ) );
d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	219	}
d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	220
d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	221	/**
d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	222	* Retrieve the translation of $text and escapes it for safe use in HTML output.
d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	223	*
7 cf61fcea0001 resynchronize code repo with production ymh <ymh.work@gmail.com> parents: 5 diff changeset	224	* If there is no translation, or the text domain isn't loaded, the original text
cf61fcea0001 resynchronize code repo with production ymh <ymh.work@gmail.com> parents: 5 diff changeset	225	* is escaped and returned..
0 d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	226	*
d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	227	* @since 2.8.0
d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	228	*
d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	229	* @param string $text Text to translate.
d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	230	* @param string $domain Optional. Text domain. Unique identifier for retrieving translated strings.
7 cf61fcea0001 resynchronize code repo with production ymh <ymh.work@gmail.com> parents: 5 diff changeset	231	* Default 'default'.
0 d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	232	* @return string Translated text
d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	233	*/
d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	234	function esc_html__( $text, $domain = 'default' ) {
d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	235	return esc_html( translate( $text, $domain ) );
d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	236	}
d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	237
d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	238	/**
d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	239	* Display translated text.
d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	240	*
d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	241	* @since 1.2.0
d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	242	*
d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	243	* @param string $text Text to translate.
d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	244	* @param string $domain Optional. Text domain. Unique identifier for retrieving translated strings.
7 cf61fcea0001 resynchronize code repo with production ymh <ymh.work@gmail.com> parents: 5 diff changeset	245	* Default 'default'.
0 d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	246	*/
d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	247	function _e( $text, $domain = 'default' ) {
d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	248	echo translate( $text, $domain );
d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	249	}
d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	250
d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	251	/**
d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	252	* Display translated text that has been escaped for safe use in an attribute.
d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	253	*
d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	254	* @since 2.8.0
d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	255	*
d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	256	* @param string $text Text to translate.
d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	257	* @param string $domain Optional. Text domain. Unique identifier for retrieving translated strings.
7 cf61fcea0001 resynchronize code repo with production ymh <ymh.work@gmail.com> parents: 5 diff changeset	258	* Default 'default'.
0 d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	259	*/
d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	260	function esc_attr_e( $text, $domain = 'default' ) {
d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	261	echo esc_attr( translate( $text, $domain ) );
d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	262	}
d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	263
d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	264	/**
d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	265	* Display translated text that has been escaped for safe use in HTML output.
d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	266	*
d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	267	* @since 2.8.0
d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	268	*
d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	269	* @param string $text Text to translate.
d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	270	* @param string $domain Optional. Text domain. Unique identifier for retrieving translated strings.
7 cf61fcea0001 resynchronize code repo with production ymh <ymh.work@gmail.com> parents: 5 diff changeset	271	* Default 'default'.
0 d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	272	*/
d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	273	function esc_html_e( $text, $domain = 'default' ) {
d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	274	echo esc_html( translate( $text, $domain ) );
d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	275	}
d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	276
d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	277	/**
d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	278	* Retrieve translated string with gettext context.
d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	279	*
d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	280	* Quite a few times, there will be collisions with similar translatable text
d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	281	* found in more than two places, but with different translated context.
d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	282	*
d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	283	* By including the context in the pot file, translators can translate the two
d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	284	* strings differently.
d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	285	*
d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	286	* @since 2.8.0
d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	287	*
d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	288	* @param string $text Text to translate.
d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	289	* @param string $context Context information for the translators.
d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	290	* @param string $domain Optional. Text domain. Unique identifier for retrieving translated strings.
7 cf61fcea0001 resynchronize code repo with production ymh <ymh.work@gmail.com> parents: 5 diff changeset	291	* Default 'default'.
0 d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	292	* @return string Translated context string without pipe.
d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	293	*/
d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	294	function _x( $text, $context, $domain = 'default' ) {
d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	295	return translate_with_gettext_context( $text, $context, $domain );
d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	296	}
d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	297
d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	298	/**
d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	299	* Display translated string with gettext context.
d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	300	*
d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	301	* @since 3.0.0
d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	302	*
d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	303	* @param string $text Text to translate.
d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	304	* @param string $context Context information for the translators.
d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	305	* @param string $domain Optional. Text domain. Unique identifier for retrieving translated strings.
7 cf61fcea0001 resynchronize code repo with production ymh <ymh.work@gmail.com> parents: 5 diff changeset	306	* Default 'default'.
0 d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	307	* @return string Translated context string without pipe.
d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	308	*/
d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	309	function _ex( $text, $context, $domain = 'default' ) {
d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	310	echo _x( $text, $context, $domain );
d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	311	}
d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	312
d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	313	/**
d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	314	* Translate string with gettext context, and escapes it for safe use in an attribute.
d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	315	*
d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	316	* @since 2.8.0
d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	317	*
d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	318	* @param string $text Text to translate.
d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	319	* @param string $context Context information for the translators.
d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	320	* @param string $domain Optional. Text domain. Unique identifier for retrieving translated strings.
7 cf61fcea0001 resynchronize code repo with production ymh <ymh.work@gmail.com> parents: 5 diff changeset	321	* Default 'default'.
0 d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	322	* @return string Translated text
d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	323	*/
d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	324	function esc_attr_x( $text, $context, $domain = 'default' ) {
d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	325	return esc_attr( translate_with_gettext_context( $text, $context, $domain ) );
d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	326	}
d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	327
d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	328	/**
d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	329	* Translate string with gettext context, and escapes it for safe use in HTML output.
d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	330	*
d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	331	* @since 2.9.0
d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	332	*
d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	333	* @param string $text Text to translate.
d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	334	* @param string $context Context information for the translators.
d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	335	* @param string $domain Optional. Text domain. Unique identifier for retrieving translated strings.
7 cf61fcea0001 resynchronize code repo with production ymh <ymh.work@gmail.com> parents: 5 diff changeset	336	* Default 'default'.
0 d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	337	* @return string Translated text.
d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	338	*/
d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	339	function esc_html_x( $text, $context, $domain = 'default' ) {
d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	340	return esc_html( translate_with_gettext_context( $text, $context, $domain ) );
d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	341	}
d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	342
d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	343	/**
7 cf61fcea0001 resynchronize code repo with production ymh <ymh.work@gmail.com> parents: 5 diff changeset	344	* Translates and retrieves the singular or plural form based on the supplied number.
0 d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	345	*
7 cf61fcea0001 resynchronize code repo with production ymh <ymh.work@gmail.com> parents: 5 diff changeset	346	* Used when you want to use the appropriate form of a string based on whether a
cf61fcea0001 resynchronize code repo with production ymh <ymh.work@gmail.com> parents: 5 diff changeset	347	* number is singular or plural.
cf61fcea0001 resynchronize code repo with production ymh <ymh.work@gmail.com> parents: 5 diff changeset	348	*
cf61fcea0001 resynchronize code repo with production ymh <ymh.work@gmail.com> parents: 5 diff changeset	349	* Example:
cf61fcea0001 resynchronize code repo with production ymh <ymh.work@gmail.com> parents: 5 diff changeset	350	*
cf61fcea0001 resynchronize code repo with production ymh <ymh.work@gmail.com> parents: 5 diff changeset	351	* printf( _n( '%s person', '%s people', $count, 'text-domain' ), number_format_i18n( $count ) );
0 d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	352	*
d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	353	* @since 2.8.0
d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	354	*
7 cf61fcea0001 resynchronize code repo with production ymh <ymh.work@gmail.com> parents: 5 diff changeset	355	* @param string $single The text to be used if the number is singular.
cf61fcea0001 resynchronize code repo with production ymh <ymh.work@gmail.com> parents: 5 diff changeset	356	* @param string $plural The text to be used if the number is plural.
cf61fcea0001 resynchronize code repo with production ymh <ymh.work@gmail.com> parents: 5 diff changeset	357	* @param int $number The number to compare against to use either the singular or plural form.
0 d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	358	* @param string $domain Optional. Text domain. Unique identifier for retrieving translated strings.
7 cf61fcea0001 resynchronize code repo with production ymh <ymh.work@gmail.com> parents: 5 diff changeset	359	* Default 'default'.
cf61fcea0001 resynchronize code repo with production ymh <ymh.work@gmail.com> parents: 5 diff changeset	360	* @return string The translated singular or plural form.
0 d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	361	*/
d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	362	function _n( $single, $plural, $number, $domain = 'default' ) {
d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	363	$translations = get_translations_for_domain( $domain );
7 cf61fcea0001 resynchronize code repo with production ymh <ymh.work@gmail.com> parents: 5 diff changeset	364	$translation = $translations->translate_plural( $single, $plural, $number );
cf61fcea0001 resynchronize code repo with production ymh <ymh.work@gmail.com> parents: 5 diff changeset	365
0 d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	366	/**
7 cf61fcea0001 resynchronize code repo with production ymh <ymh.work@gmail.com> parents: 5 diff changeset	367	* Filters the singular or plural form of a string.
0 d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	368	*
d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	369	* @since 2.2.0
d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	370	*
d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	371	* @param string $translation Translated text.
7 cf61fcea0001 resynchronize code repo with production ymh <ymh.work@gmail.com> parents: 5 diff changeset	372	* @param string $single The text to be used if the number is singular.
cf61fcea0001 resynchronize code repo with production ymh <ymh.work@gmail.com> parents: 5 diff changeset	373	* @param string $plural The text to be used if the number is plural.
cf61fcea0001 resynchronize code repo with production ymh <ymh.work@gmail.com> parents: 5 diff changeset	374	* @param string $number The number to compare against to use either the singular or plural form.
0 d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	375	* @param string $domain Text domain. Unique identifier for retrieving translated strings.
d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	376	*/
d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	377	return apply_filters( 'ngettext', $translation, $single, $plural, $number, $domain );
d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	378	}
d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	379
d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	380	/**
7 cf61fcea0001 resynchronize code repo with production ymh <ymh.work@gmail.com> parents: 5 diff changeset	381	* Translates and retrieves the singular or plural form based on the supplied number, with gettext context.
cf61fcea0001 resynchronize code repo with production ymh <ymh.work@gmail.com> parents: 5 diff changeset	382	*
cf61fcea0001 resynchronize code repo with production ymh <ymh.work@gmail.com> parents: 5 diff changeset	383	* This is a hybrid of _n() and _x(). It supports context and plurals.
0 d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	384	*
7 cf61fcea0001 resynchronize code repo with production ymh <ymh.work@gmail.com> parents: 5 diff changeset	385	* Used when you want to use the appropriate form of a string with context based on whether a
cf61fcea0001 resynchronize code repo with production ymh <ymh.work@gmail.com> parents: 5 diff changeset	386	* number is singular or plural.
cf61fcea0001 resynchronize code repo with production ymh <ymh.work@gmail.com> parents: 5 diff changeset	387	*
cf61fcea0001 resynchronize code repo with production ymh <ymh.work@gmail.com> parents: 5 diff changeset	388	* Example of a generic phrase which is disambiguated via the context parameter:
cf61fcea0001 resynchronize code repo with production ymh <ymh.work@gmail.com> parents: 5 diff changeset	389	*
cf61fcea0001 resynchronize code repo with production ymh <ymh.work@gmail.com> parents: 5 diff changeset	390	* printf( _nx( '%s group', '%s groups', $people, 'group of people', 'text-domain' ), number_format_i18n( $people ) );
cf61fcea0001 resynchronize code repo with production ymh <ymh.work@gmail.com> parents: 5 diff changeset	391	* printf( _nx( '%s group', '%s groups', $animals, 'group of animals', 'text-domain' ), number_format_i18n( $animals ) );
0 d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	392	*
d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	393	* @since 2.8.0
d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	394	*
7 cf61fcea0001 resynchronize code repo with production ymh <ymh.work@gmail.com> parents: 5 diff changeset	395	* @param string $single The text to be used if the number is singular.
cf61fcea0001 resynchronize code repo with production ymh <ymh.work@gmail.com> parents: 5 diff changeset	396	* @param string $plural The text to be used if the number is plural.
cf61fcea0001 resynchronize code repo with production ymh <ymh.work@gmail.com> parents: 5 diff changeset	397	* @param int $number The number to compare against to use either the singular or plural form.
0 d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	398	* @param string $context Context information for the translators.
d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	399	* @param string $domain Optional. Text domain. Unique identifier for retrieving translated strings.
7 cf61fcea0001 resynchronize code repo with production ymh <ymh.work@gmail.com> parents: 5 diff changeset	400	* Default 'default'.
cf61fcea0001 resynchronize code repo with production ymh <ymh.work@gmail.com> parents: 5 diff changeset	401	* @return string The translated singular or plural form.
0 d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	402	*/
d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	403	function _nx($single, $plural, $number, $context, $domain = 'default') {
d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	404	$translations = get_translations_for_domain( $domain );
7 cf61fcea0001 resynchronize code repo with production ymh <ymh.work@gmail.com> parents: 5 diff changeset	405	$translation = $translations->translate_plural( $single, $plural, $number, $context );
cf61fcea0001 resynchronize code repo with production ymh <ymh.work@gmail.com> parents: 5 diff changeset	406
0 d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	407	/**
7 cf61fcea0001 resynchronize code repo with production ymh <ymh.work@gmail.com> parents: 5 diff changeset	408	* Filters the singular or plural form of a string with gettext context.
0 d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	409	*
d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	410	* @since 2.8.0
d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	411	*
d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	412	* @param string $translation Translated text.
7 cf61fcea0001 resynchronize code repo with production ymh <ymh.work@gmail.com> parents: 5 diff changeset	413	* @param string $single The text to be used if the number is singular.
cf61fcea0001 resynchronize code repo with production ymh <ymh.work@gmail.com> parents: 5 diff changeset	414	* @param string $plural The text to be used if the number is plural.
cf61fcea0001 resynchronize code repo with production ymh <ymh.work@gmail.com> parents: 5 diff changeset	415	* @param string $number The number to compare against to use either the singular or plural form.
0 d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	416	* @param string $context Context information for the translators.
d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	417	* @param string $domain Text domain. Unique identifier for retrieving translated strings.
d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	418	*/
d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	419	return apply_filters( 'ngettext_with_context', $translation, $single, $plural, $number, $context, $domain );
d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	420	}
d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	421
d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	422	/**
7 cf61fcea0001 resynchronize code repo with production ymh <ymh.work@gmail.com> parents: 5 diff changeset	423	* Registers plural strings in POT file, but does not translate them.
0 d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	424	*
d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	425	* Used when you want to keep structures with translatable plural
7 cf61fcea0001 resynchronize code repo with production ymh <ymh.work@gmail.com> parents: 5 diff changeset	426	* strings and use them later when the number is known.
0 d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	427	*
d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	428	* Example:
5 5e2f62d02dcd upgrade wordpress + plugins ymh <ymh.work@gmail.com> parents: 0 diff changeset	429	*
7 cf61fcea0001 resynchronize code repo with production ymh <ymh.work@gmail.com> parents: 5 diff changeset	430	* $message = _n_noop( '%s post', '%s posts', 'text-domain' );
5 5e2f62d02dcd upgrade wordpress + plugins ymh <ymh.work@gmail.com> parents: 0 diff changeset	431	* ...
7 cf61fcea0001 resynchronize code repo with production ymh <ymh.work@gmail.com> parents: 5 diff changeset	432	* printf( translate_nooped_plural( $message, $count, 'text-domain' ), number_format_i18n( $count ) );
0 d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	433	*
d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	434	* @since 2.5.0
d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	435	*
7 cf61fcea0001 resynchronize code repo with production ymh <ymh.work@gmail.com> parents: 5 diff changeset	436	* @param string $singular Singular form to be localized.
cf61fcea0001 resynchronize code repo with production ymh <ymh.work@gmail.com> parents: 5 diff changeset	437	* @param string $plural Plural form to be localized.
0 d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	438	* @param string $domain Optional. Text domain. Unique identifier for retrieving translated strings.
7 cf61fcea0001 resynchronize code repo with production ymh <ymh.work@gmail.com> parents: 5 diff changeset	439	* Default null.
cf61fcea0001 resynchronize code repo with production ymh <ymh.work@gmail.com> parents: 5 diff changeset	440	* @return array {
cf61fcea0001 resynchronize code repo with production ymh <ymh.work@gmail.com> parents: 5 diff changeset	441	* Array of translation information for the strings.
cf61fcea0001 resynchronize code repo with production ymh <ymh.work@gmail.com> parents: 5 diff changeset	442	*
cf61fcea0001 resynchronize code repo with production ymh <ymh.work@gmail.com> parents: 5 diff changeset	443	* @type string $0 Singular form to be localized. No longer used.
cf61fcea0001 resynchronize code repo with production ymh <ymh.work@gmail.com> parents: 5 diff changeset	444	* @type string $1 Plural form to be localized. No longer used.
cf61fcea0001 resynchronize code repo with production ymh <ymh.work@gmail.com> parents: 5 diff changeset	445	* @type string $singular Singular form to be localized.
cf61fcea0001 resynchronize code repo with production ymh <ymh.work@gmail.com> parents: 5 diff changeset	446	* @type string $plural Plural form to be localized.
cf61fcea0001 resynchronize code repo with production ymh <ymh.work@gmail.com> parents: 5 diff changeset	447	* @type null $context Context information for the translators.
cf61fcea0001 resynchronize code repo with production ymh <ymh.work@gmail.com> parents: 5 diff changeset	448	* @type string $domain Text domain.
cf61fcea0001 resynchronize code repo with production ymh <ymh.work@gmail.com> parents: 5 diff changeset	449	* }
0 d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	450	*/
d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	451	function _n_noop( $singular, $plural, $domain = null ) {
d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	452	return array( 0 => $singular, 1 => $plural, 'singular' => $singular, 'plural' => $plural, 'context' => null, 'domain' => $domain );
d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	453	}
d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	454
d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	455	/**
7 cf61fcea0001 resynchronize code repo with production ymh <ymh.work@gmail.com> parents: 5 diff changeset	456	* Registers plural strings with gettext context in POT file, but does not translate them.
cf61fcea0001 resynchronize code repo with production ymh <ymh.work@gmail.com> parents: 5 diff changeset	457	*
cf61fcea0001 resynchronize code repo with production ymh <ymh.work@gmail.com> parents: 5 diff changeset	458	* Used when you want to keep structures with translatable plural
cf61fcea0001 resynchronize code repo with production ymh <ymh.work@gmail.com> parents: 5 diff changeset	459	* strings and use them later when the number is known.
cf61fcea0001 resynchronize code repo with production ymh <ymh.work@gmail.com> parents: 5 diff changeset	460	*
cf61fcea0001 resynchronize code repo with production ymh <ymh.work@gmail.com> parents: 5 diff changeset	461	* Example of a generic phrase which is disambiguated via the context parameter:
cf61fcea0001 resynchronize code repo with production ymh <ymh.work@gmail.com> parents: 5 diff changeset	462	*
cf61fcea0001 resynchronize code repo with production ymh <ymh.work@gmail.com> parents: 5 diff changeset	463	* $messages = array(
cf61fcea0001 resynchronize code repo with production ymh <ymh.work@gmail.com> parents: 5 diff changeset	464	* 'people' => _nx_noop( '%s group', '%s groups', 'people', 'text-domain' ),
cf61fcea0001 resynchronize code repo with production ymh <ymh.work@gmail.com> parents: 5 diff changeset	465	* 'animals' => _nx_noop( '%s group', '%s groups', 'animals', 'text-domain' ),
cf61fcea0001 resynchronize code repo with production ymh <ymh.work@gmail.com> parents: 5 diff changeset	466	* );
cf61fcea0001 resynchronize code repo with production ymh <ymh.work@gmail.com> parents: 5 diff changeset	467	* ...
cf61fcea0001 resynchronize code repo with production ymh <ymh.work@gmail.com> parents: 5 diff changeset	468	* $message = $messages[ $type ];
cf61fcea0001 resynchronize code repo with production ymh <ymh.work@gmail.com> parents: 5 diff changeset	469	* printf( translate_nooped_plural( $message, $count, 'text-domain' ), number_format_i18n( $count ) );
0 d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	470	*
d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	471	* @since 2.8.0
7 cf61fcea0001 resynchronize code repo with production ymh <ymh.work@gmail.com> parents: 5 diff changeset	472	*
cf61fcea0001 resynchronize code repo with production ymh <ymh.work@gmail.com> parents: 5 diff changeset	473	* @param string $singular Singular form to be localized.
cf61fcea0001 resynchronize code repo with production ymh <ymh.work@gmail.com> parents: 5 diff changeset	474	* @param string $plural Plural form to be localized.
cf61fcea0001 resynchronize code repo with production ymh <ymh.work@gmail.com> parents: 5 diff changeset	475	* @param string $context Context information for the translators.
cf61fcea0001 resynchronize code repo with production ymh <ymh.work@gmail.com> parents: 5 diff changeset	476	* @param string $domain Optional. Text domain. Unique identifier for retrieving translated strings.
cf61fcea0001 resynchronize code repo with production ymh <ymh.work@gmail.com> parents: 5 diff changeset	477	* Default null.
cf61fcea0001 resynchronize code repo with production ymh <ymh.work@gmail.com> parents: 5 diff changeset	478	* @return array {
cf61fcea0001 resynchronize code repo with production ymh <ymh.work@gmail.com> parents: 5 diff changeset	479	* Array of translation information for the strings.
cf61fcea0001 resynchronize code repo with production ymh <ymh.work@gmail.com> parents: 5 diff changeset	480	*
cf61fcea0001 resynchronize code repo with production ymh <ymh.work@gmail.com> parents: 5 diff changeset	481	* @type string $0 Singular form to be localized. No longer used.
cf61fcea0001 resynchronize code repo with production ymh <ymh.work@gmail.com> parents: 5 diff changeset	482	* @type string $1 Plural form to be localized. No longer used.
cf61fcea0001 resynchronize code repo with production ymh <ymh.work@gmail.com> parents: 5 diff changeset	483	* @type string $2 Context information for the translators. No longer used.
cf61fcea0001 resynchronize code repo with production ymh <ymh.work@gmail.com> parents: 5 diff changeset	484	* @type string $singular Singular form to be localized.
cf61fcea0001 resynchronize code repo with production ymh <ymh.work@gmail.com> parents: 5 diff changeset	485	* @type string $plural Plural form to be localized.
cf61fcea0001 resynchronize code repo with production ymh <ymh.work@gmail.com> parents: 5 diff changeset	486	* @type string $context Context information for the translators.
cf61fcea0001 resynchronize code repo with production ymh <ymh.work@gmail.com> parents: 5 diff changeset	487	* @type string $domain Text domain.
cf61fcea0001 resynchronize code repo with production ymh <ymh.work@gmail.com> parents: 5 diff changeset	488	* }
0 d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	489	*/
d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	490	function _nx_noop( $singular, $plural, $context, $domain = null ) {
d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	491	return array( 0 => $singular, 1 => $plural, 2 => $context, 'singular' => $singular, 'plural' => $plural, 'context' => $context, 'domain' => $domain );
d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	492	}
d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	493
d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	494	/**
7 cf61fcea0001 resynchronize code repo with production ymh <ymh.work@gmail.com> parents: 5 diff changeset	495	* Translates and retrieves the singular or plural form of a string that's been registered
cf61fcea0001 resynchronize code repo with production ymh <ymh.work@gmail.com> parents: 5 diff changeset	496	* with _n_noop() or _nx_noop().
cf61fcea0001 resynchronize code repo with production ymh <ymh.work@gmail.com> parents: 5 diff changeset	497	*
cf61fcea0001 resynchronize code repo with production ymh <ymh.work@gmail.com> parents: 5 diff changeset	498	* Used when you want to use a translatable plural string once the number is known.
cf61fcea0001 resynchronize code repo with production ymh <ymh.work@gmail.com> parents: 5 diff changeset	499	*
cf61fcea0001 resynchronize code repo with production ymh <ymh.work@gmail.com> parents: 5 diff changeset	500	* Example:
cf61fcea0001 resynchronize code repo with production ymh <ymh.work@gmail.com> parents: 5 diff changeset	501	*
cf61fcea0001 resynchronize code repo with production ymh <ymh.work@gmail.com> parents: 5 diff changeset	502	* $message = _n_noop( '%s post', '%s posts', 'text-domain' );
cf61fcea0001 resynchronize code repo with production ymh <ymh.work@gmail.com> parents: 5 diff changeset	503	* ...
cf61fcea0001 resynchronize code repo with production ymh <ymh.work@gmail.com> parents: 5 diff changeset	504	* printf( translate_nooped_plural( $message, $count, 'text-domain' ), number_format_i18n( $count ) );
0 d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	505	*
d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	506	* @since 3.1.0
d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	507	*
7 cf61fcea0001 resynchronize code repo with production ymh <ymh.work@gmail.com> parents: 5 diff changeset	508	* @param array $nooped_plural Array with singular, plural, and context keys, usually the result of _n_noop() or _nx_noop().
cf61fcea0001 resynchronize code repo with production ymh <ymh.work@gmail.com> parents: 5 diff changeset	509	* @param int $count Number of objects.
0 d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	510	* @param string $domain Optional. Text domain. Unique identifier for retrieving translated strings. If $nooped_plural contains
7 cf61fcea0001 resynchronize code repo with production ymh <ymh.work@gmail.com> parents: 5 diff changeset	511	* a text domain passed to _n_noop() or _nx_noop(), it will override this value. Default 'default'.
0 d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	512	* @return string Either $single or $plural translated text.
d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	513	*/
d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	514	function translate_nooped_plural( $nooped_plural, $count, $domain = 'default' ) {
d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	515	if ( $nooped_plural['domain'] )
d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	516	$domain = $nooped_plural['domain'];
d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	517
d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	518	if ( $nooped_plural['context'] )
d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	519	return _nx( $nooped_plural['singular'], $nooped_plural['plural'], $count, $nooped_plural['context'], $domain );
d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	520	else
d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	521	return _n( $nooped_plural['singular'], $nooped_plural['plural'], $count, $domain );
d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	522	}
d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	523
d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	524	/**
d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	525	* Load a .mo file into the text domain $domain.
d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	526	*
d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	527	* If the text domain already exists, the translations will be merged. If both
d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	528	* sets have the same string, the translation from the original value will be taken.
d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	529	*
d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	530	* On success, the .mo file will be placed in the $l10n global by $domain
d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	531	* and will be a MO object.
d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	532	*
d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	533	* @since 1.5.0
d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	534	*
7 cf61fcea0001 resynchronize code repo with production ymh <ymh.work@gmail.com> parents: 5 diff changeset	535	* @global array $l10n An array of all currently loaded text domains.
cf61fcea0001 resynchronize code repo with production ymh <ymh.work@gmail.com> parents: 5 diff changeset	536	* @global array $l10n_unloaded An array of all text domains that have been unloaded again.
cf61fcea0001 resynchronize code repo with production ymh <ymh.work@gmail.com> parents: 5 diff changeset	537	*
0 d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	538	* @param string $domain Text domain. Unique identifier for retrieving translated strings.
d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	539	* @param string $mofile Path to the .mo file.
d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	540	* @return bool True on success, false on failure.
d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	541	*/
d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	542	function load_textdomain( $domain, $mofile ) {
7 cf61fcea0001 resynchronize code repo with production ymh <ymh.work@gmail.com> parents: 5 diff changeset	543	global $l10n, $l10n_unloaded;
cf61fcea0001 resynchronize code repo with production ymh <ymh.work@gmail.com> parents: 5 diff changeset	544
cf61fcea0001 resynchronize code repo with production ymh <ymh.work@gmail.com> parents: 5 diff changeset	545	$l10n_unloaded = (array) $l10n_unloaded;
0 d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	546
d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	547	/**
7 cf61fcea0001 resynchronize code repo with production ymh <ymh.work@gmail.com> parents: 5 diff changeset	548	* Filters whether to override the .mo file loading.
0 d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	549	*
d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	550	* @since 2.9.0
d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	551	*
7 cf61fcea0001 resynchronize code repo with production ymh <ymh.work@gmail.com> parents: 5 diff changeset	552	* @param bool $override Whether to override the .mo file loading. Default false.
5 5e2f62d02dcd upgrade wordpress + plugins ymh <ymh.work@gmail.com> parents: 0 diff changeset	553	* @param string $domain Text domain. Unique identifier for retrieving translated strings.
5e2f62d02dcd upgrade wordpress + plugins ymh <ymh.work@gmail.com> parents: 0 diff changeset	554	* @param string $mofile Path to the MO file.
0 d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	555	*/
d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	556	$plugin_override = apply_filters( 'override_load_textdomain', false, $domain, $mofile );
d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	557
d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	558	if ( true == $plugin_override ) {
7 cf61fcea0001 resynchronize code repo with production ymh <ymh.work@gmail.com> parents: 5 diff changeset	559	unset( $l10n_unloaded[ $domain ] );
cf61fcea0001 resynchronize code repo with production ymh <ymh.work@gmail.com> parents: 5 diff changeset	560
0 d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	561	return true;
d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	562	}
d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	563
d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	564	/**
d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	565	* Fires before the MO translation file is loaded.
d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	566	*
d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	567	* @since 2.9.0
d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	568	*
d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	569	* @param string $domain Text domain. Unique identifier for retrieving translated strings.
d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	570	* @param string $mofile Path to the .mo file.
d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	571	*/
d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	572	do_action( 'load_textdomain', $domain, $mofile );
d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	573
d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	574	/**
7 cf61fcea0001 resynchronize code repo with production ymh <ymh.work@gmail.com> parents: 5 diff changeset	575	* Filters MO file path for loading translations for a specific text domain.
0 d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	576	*
d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	577	* @since 2.9.0
d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	578	*
d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	579	* @param string $mofile Path to the MO file.
d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	580	* @param string $domain Text domain. Unique identifier for retrieving translated strings.
d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	581	*/
d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	582	$mofile = apply_filters( 'load_textdomain_mofile', $mofile, $domain );
d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	583
d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	584	if ( !is_readable( $mofile ) ) return false;
d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	585
d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	586	$mo = new MO();
d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	587	if ( !$mo->import_from_file( $mofile ) ) return false;
d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	588
d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	589	if ( isset( $l10n[$domain] ) )
d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	590	$mo->merge_with( $l10n[$domain] );
d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	591
7 cf61fcea0001 resynchronize code repo with production ymh <ymh.work@gmail.com> parents: 5 diff changeset	592	unset( $l10n_unloaded[ $domain ] );
cf61fcea0001 resynchronize code repo with production ymh <ymh.work@gmail.com> parents: 5 diff changeset	593
0 d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	594	$l10n[$domain] = &$mo;
d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	595
d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	596	return true;
d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	597	}
d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	598
d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	599	/**
d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	600	* Unload translations for a text domain.
d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	601	*
d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	602	* @since 3.0.0
d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	603	*
7 cf61fcea0001 resynchronize code repo with production ymh <ymh.work@gmail.com> parents: 5 diff changeset	604	* @global array $l10n An array of all currently loaded text domains.
cf61fcea0001 resynchronize code repo with production ymh <ymh.work@gmail.com> parents: 5 diff changeset	605	* @global array $l10n_unloaded An array of all text domains that have been unloaded again.
cf61fcea0001 resynchronize code repo with production ymh <ymh.work@gmail.com> parents: 5 diff changeset	606	*
0 d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	607	* @param string $domain Text domain. Unique identifier for retrieving translated strings.
d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	608	* @return bool Whether textdomain was unloaded.
d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	609	*/
d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	610	function unload_textdomain( $domain ) {
7 cf61fcea0001 resynchronize code repo with production ymh <ymh.work@gmail.com> parents: 5 diff changeset	611	global $l10n, $l10n_unloaded;
cf61fcea0001 resynchronize code repo with production ymh <ymh.work@gmail.com> parents: 5 diff changeset	612
cf61fcea0001 resynchronize code repo with production ymh <ymh.work@gmail.com> parents: 5 diff changeset	613	$l10n_unloaded = (array) $l10n_unloaded;
0 d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	614
d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	615	/**
7 cf61fcea0001 resynchronize code repo with production ymh <ymh.work@gmail.com> parents: 5 diff changeset	616	* Filters whether to override the text domain unloading.
0 d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	617	*
d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	618	* @since 3.0.0
d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	619	*
7 cf61fcea0001 resynchronize code repo with production ymh <ymh.work@gmail.com> parents: 5 diff changeset	620	* @param bool $override Whether to override the text domain unloading. Default false.
5 5e2f62d02dcd upgrade wordpress + plugins ymh <ymh.work@gmail.com> parents: 0 diff changeset	621	* @param string $domain Text domain. Unique identifier for retrieving translated strings.
0 d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	622	*/
d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	623	$plugin_override = apply_filters( 'override_unload_textdomain', false, $domain );
d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	624
7 cf61fcea0001 resynchronize code repo with production ymh <ymh.work@gmail.com> parents: 5 diff changeset	625	if ( $plugin_override ) {
cf61fcea0001 resynchronize code repo with production ymh <ymh.work@gmail.com> parents: 5 diff changeset	626	$l10n_unloaded[ $domain ] = true;
cf61fcea0001 resynchronize code repo with production ymh <ymh.work@gmail.com> parents: 5 diff changeset	627
0 d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	628	return true;
7 cf61fcea0001 resynchronize code repo with production ymh <ymh.work@gmail.com> parents: 5 diff changeset	629	}
0 d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	630
d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	631	/**
d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	632	* Fires before the text domain is unloaded.
d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	633	*
d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	634	* @since 3.0.0
d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	635	*
d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	636	* @param string $domain Text domain. Unique identifier for retrieving translated strings.
d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	637	*/
d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	638	do_action( 'unload_textdomain', $domain );
d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	639
d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	640	if ( isset( $l10n[$domain] ) ) {
d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	641	unset( $l10n[$domain] );
7 cf61fcea0001 resynchronize code repo with production ymh <ymh.work@gmail.com> parents: 5 diff changeset	642
cf61fcea0001 resynchronize code repo with production ymh <ymh.work@gmail.com> parents: 5 diff changeset	643	$l10n_unloaded[ $domain ] = true;
cf61fcea0001 resynchronize code repo with production ymh <ymh.work@gmail.com> parents: 5 diff changeset	644
0 d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	645	return true;
d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	646	}
d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	647
d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	648	return false;
d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	649	}
d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	650
d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	651	/**
d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	652	* Load default translated strings based on locale.
d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	653	*
d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	654	* Loads the .mo file in WP_LANG_DIR constant path from WordPress root.
d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	655	* The translated (.mo) file is named based on the locale.
d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	656	*
d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	657	* @see load_textdomain()
d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	658	*
d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	659	* @since 1.5.0
5 5e2f62d02dcd upgrade wordpress + plugins ymh <ymh.work@gmail.com> parents: 0 diff changeset	660	*
7 cf61fcea0001 resynchronize code repo with production ymh <ymh.work@gmail.com> parents: 5 diff changeset	661	* @param string $locale Optional. Locale to load. Default is the value of get_locale().
5 5e2f62d02dcd upgrade wordpress + plugins ymh <ymh.work@gmail.com> parents: 0 diff changeset	662	* @return bool Whether the textdomain was loaded.
0 d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	663	*/
5 5e2f62d02dcd upgrade wordpress + plugins ymh <ymh.work@gmail.com> parents: 0 diff changeset	664	function load_default_textdomain( $locale = null ) {
5e2f62d02dcd upgrade wordpress + plugins ymh <ymh.work@gmail.com> parents: 0 diff changeset	665	if ( null === $locale ) {
7 cf61fcea0001 resynchronize code repo with production ymh <ymh.work@gmail.com> parents: 5 diff changeset	666	$locale = is_admin() ? get_user_locale() : get_locale();
5 5e2f62d02dcd upgrade wordpress + plugins ymh <ymh.work@gmail.com> parents: 0 diff changeset	667	}
0 d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	668
5 5e2f62d02dcd upgrade wordpress + plugins ymh <ymh.work@gmail.com> parents: 0 diff changeset	669	// Unload previously loaded strings so we can switch translations.
5e2f62d02dcd upgrade wordpress + plugins ymh <ymh.work@gmail.com> parents: 0 diff changeset	670	unload_textdomain( 'default' );
5e2f62d02dcd upgrade wordpress + plugins ymh <ymh.work@gmail.com> parents: 0 diff changeset	671
5e2f62d02dcd upgrade wordpress + plugins ymh <ymh.work@gmail.com> parents: 0 diff changeset	672	$return = load_textdomain( 'default', WP_LANG_DIR . "/$locale.mo" );
0 d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	673
d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	674	if ( ( is_multisite() \|\| ( defined( 'WP_INSTALLING_NETWORK' ) && WP_INSTALLING_NETWORK ) ) && ! file_exists( WP_LANG_DIR . "/admin-$locale.mo" ) ) {
d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	675	load_textdomain( 'default', WP_LANG_DIR . "/ms-$locale.mo" );
5 5e2f62d02dcd upgrade wordpress + plugins ymh <ymh.work@gmail.com> parents: 0 diff changeset	676	return $return;
0 d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	677	}
d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	678
7 cf61fcea0001 resynchronize code repo with production ymh <ymh.work@gmail.com> parents: 5 diff changeset	679	if ( is_admin() \|\| wp_installing() \|\| ( defined( 'WP_REPAIRING' ) && WP_REPAIRING ) ) {
0 d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	680	load_textdomain( 'default', WP_LANG_DIR . "/admin-$locale.mo" );
5 5e2f62d02dcd upgrade wordpress + plugins ymh <ymh.work@gmail.com> parents: 0 diff changeset	681	}
0 d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	682
d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	683	if ( is_network_admin() \|\| ( defined( 'WP_INSTALLING_NETWORK' ) && WP_INSTALLING_NETWORK ) )
d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	684	load_textdomain( 'default', WP_LANG_DIR . "/admin-network-$locale.mo" );
d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	685
5 5e2f62d02dcd upgrade wordpress + plugins ymh <ymh.work@gmail.com> parents: 0 diff changeset	686	return $return;
0 d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	687	}
d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	688
d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	689	/**
7 cf61fcea0001 resynchronize code repo with production ymh <ymh.work@gmail.com> parents: 5 diff changeset	690	* Loads a plugin's translated strings.
0 d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	691	*
d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	692	* If the path is not given then it will be the root of the plugin directory.
d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	693	*
d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	694	* The .mo file should be named based on the text domain with a dash, and then the locale exactly.
d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	695	*
d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	696	* @since 1.5.0
7 cf61fcea0001 resynchronize code repo with production ymh <ymh.work@gmail.com> parents: 5 diff changeset	697	* @since 4.6.0 The function now tries to load the .mo file from the languages directory first.
0 d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	698	*
d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	699	* @param string $domain Unique identifier for retrieving translated strings
7 cf61fcea0001 resynchronize code repo with production ymh <ymh.work@gmail.com> parents: 5 diff changeset	700	* @param string $deprecated Optional. Use the $plugin_rel_path parameter instead. Default false.
0 d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	701	* @param string $plugin_rel_path Optional. Relative path to WP_PLUGIN_DIR where the .mo file resides.
5 5e2f62d02dcd upgrade wordpress + plugins ymh <ymh.work@gmail.com> parents: 0 diff changeset	702	* Default false.
5e2f62d02dcd upgrade wordpress + plugins ymh <ymh.work@gmail.com> parents: 0 diff changeset	703	* @return bool True when textdomain is successfully loaded, false otherwise.
0 d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	704	*/
d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	705	function load_plugin_textdomain( $domain, $deprecated = false, $plugin_rel_path = false ) {
d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	706	/**
7 cf61fcea0001 resynchronize code repo with production ymh <ymh.work@gmail.com> parents: 5 diff changeset	707	* Filters a plugin's locale.
0 d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	708	*
d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	709	* @since 3.0.0
d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	710	*
d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	711	* @param string $locale The plugin's current locale.
d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	712	* @param string $domain Text domain. Unique identifier for retrieving translated strings.
d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	713	*/
7 cf61fcea0001 resynchronize code repo with production ymh <ymh.work@gmail.com> parents: 5 diff changeset	714	$locale = apply_filters( 'plugin_locale', is_admin() ? get_user_locale() : get_locale(), $domain );
cf61fcea0001 resynchronize code repo with production ymh <ymh.work@gmail.com> parents: 5 diff changeset	715
cf61fcea0001 resynchronize code repo with production ymh <ymh.work@gmail.com> parents: 5 diff changeset	716	$mofile = $domain . '-' . $locale . '.mo';
0 d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	717
7 cf61fcea0001 resynchronize code repo with production ymh <ymh.work@gmail.com> parents: 5 diff changeset	718	// Try to load from the languages directory first.
cf61fcea0001 resynchronize code repo with production ymh <ymh.work@gmail.com> parents: 5 diff changeset	719	if ( load_textdomain( $domain, WP_LANG_DIR . '/plugins/' . $mofile ) ) {
cf61fcea0001 resynchronize code repo with production ymh <ymh.work@gmail.com> parents: 5 diff changeset	720	return true;
cf61fcea0001 resynchronize code repo with production ymh <ymh.work@gmail.com> parents: 5 diff changeset	721	}
cf61fcea0001 resynchronize code repo with production ymh <ymh.work@gmail.com> parents: 5 diff changeset	722
cf61fcea0001 resynchronize code repo with production ymh <ymh.work@gmail.com> parents: 5 diff changeset	723	if ( false !== $plugin_rel_path ) {
0 d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	724	$path = WP_PLUGIN_DIR . '/' . trim( $plugin_rel_path, '/' );
5 5e2f62d02dcd upgrade wordpress + plugins ymh <ymh.work@gmail.com> parents: 0 diff changeset	725	} elseif ( false !== $deprecated ) {
7 cf61fcea0001 resynchronize code repo with production ymh <ymh.work@gmail.com> parents: 5 diff changeset	726	_deprecated_argument( __FUNCTION__, '2.7.0' );
0 d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	727	$path = ABSPATH . trim( $deprecated, '/' );
d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	728	} else {
d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	729	$path = WP_PLUGIN_DIR;
d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	730	}
d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	731
7 cf61fcea0001 resynchronize code repo with production ymh <ymh.work@gmail.com> parents: 5 diff changeset	732	return load_textdomain( $domain, $path . '/' . $mofile );
0 d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	733	}
d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	734
d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	735	/**
d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	736	* Load the translated strings for a plugin residing in the mu-plugins directory.
d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	737	*
d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	738	* @since 3.0.0
7 cf61fcea0001 resynchronize code repo with production ymh <ymh.work@gmail.com> parents: 5 diff changeset	739	* @since 4.6.0 The function now tries to load the .mo file from the languages directory first.
0 d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	740	*
d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	741	* @param string $domain Text domain. Unique identifier for retrieving translated strings.
7 cf61fcea0001 resynchronize code repo with production ymh <ymh.work@gmail.com> parents: 5 diff changeset	742	* @param string $mu_plugin_rel_path Optional. Relative to `WPMU_PLUGIN_DIR` directory in which the .mo
cf61fcea0001 resynchronize code repo with production ymh <ymh.work@gmail.com> parents: 5 diff changeset	743	* file resides. Default empty string.
0 d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	744	* @return bool True when textdomain is successfully loaded, false otherwise.
d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	745	*/
d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	746	function load_muplugin_textdomain( $domain, $mu_plugin_rel_path = '' ) {
5 5e2f62d02dcd upgrade wordpress + plugins ymh <ymh.work@gmail.com> parents: 0 diff changeset	747	/** This filter is documented in wp-includes/l10n.php */
7 cf61fcea0001 resynchronize code repo with production ymh <ymh.work@gmail.com> parents: 5 diff changeset	748	$locale = apply_filters( 'plugin_locale', is_admin() ? get_user_locale() : get_locale(), $domain );
0 d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	749
d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	750	$mofile = $domain . '-' . $locale . '.mo';
d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	751
7 cf61fcea0001 resynchronize code repo with production ymh <ymh.work@gmail.com> parents: 5 diff changeset	752	// Try to load from the languages directory first.
cf61fcea0001 resynchronize code repo with production ymh <ymh.work@gmail.com> parents: 5 diff changeset	753	if ( load_textdomain( $domain, WP_LANG_DIR . '/plugins/' . $mofile ) ) {
cf61fcea0001 resynchronize code repo with production ymh <ymh.work@gmail.com> parents: 5 diff changeset	754	return true;
cf61fcea0001 resynchronize code repo with production ymh <ymh.work@gmail.com> parents: 5 diff changeset	755	}
cf61fcea0001 resynchronize code repo with production ymh <ymh.work@gmail.com> parents: 5 diff changeset	756
cf61fcea0001 resynchronize code repo with production ymh <ymh.work@gmail.com> parents: 5 diff changeset	757	$path = WPMU_PLUGIN_DIR . '/' . ltrim( $mu_plugin_rel_path, '/' );
cf61fcea0001 resynchronize code repo with production ymh <ymh.work@gmail.com> parents: 5 diff changeset	758
cf61fcea0001 resynchronize code repo with production ymh <ymh.work@gmail.com> parents: 5 diff changeset	759	return load_textdomain( $domain, $path . '/' . $mofile );
0 d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	760	}
d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	761
d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	762	/**
d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	763	* Load the theme's translated strings.
d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	764	*
d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	765	* If the current locale exists as a .mo file in the theme's root directory, it
d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	766	* will be included in the translated strings by the $domain.
d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	767	*
d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	768	* The .mo files must be named based on the locale exactly.
d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	769	*
d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	770	* @since 1.5.0
7 cf61fcea0001 resynchronize code repo with production ymh <ymh.work@gmail.com> parents: 5 diff changeset	771	* @since 4.6.0 The function now tries to load the .mo file from the languages directory first.
0 d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	772	*
d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	773	* @param string $domain Text domain. Unique identifier for retrieving translated strings.
d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	774	* @param string $path Optional. Path to the directory containing the .mo file.
d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	775	* Default false.
d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	776	* @return bool True when textdomain is successfully loaded, false otherwise.
d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	777	*/
d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	778	function load_theme_textdomain( $domain, $path = false ) {
d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	779	/**
7 cf61fcea0001 resynchronize code repo with production ymh <ymh.work@gmail.com> parents: 5 diff changeset	780	* Filters a theme's locale.
0 d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	781	*
d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	782	* @since 3.0.0
d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	783	*
d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	784	* @param string $locale The theme's current locale.
d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	785	* @param string $domain Text domain. Unique identifier for retrieving translated strings.
d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	786	*/
7 cf61fcea0001 resynchronize code repo with production ymh <ymh.work@gmail.com> parents: 5 diff changeset	787	$locale = apply_filters( 'theme_locale', is_admin() ? get_user_locale() : get_locale(), $domain );
0 d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	788
7 cf61fcea0001 resynchronize code repo with production ymh <ymh.work@gmail.com> parents: 5 diff changeset	789	$mofile = $domain . '-' . $locale . '.mo';
0 d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	790
7 cf61fcea0001 resynchronize code repo with production ymh <ymh.work@gmail.com> parents: 5 diff changeset	791	// Try to load from the languages directory first.
cf61fcea0001 resynchronize code repo with production ymh <ymh.work@gmail.com> parents: 5 diff changeset	792	if ( load_textdomain( $domain, WP_LANG_DIR . '/themes/' . $mofile ) ) {
cf61fcea0001 resynchronize code repo with production ymh <ymh.work@gmail.com> parents: 5 diff changeset	793	return true;
cf61fcea0001 resynchronize code repo with production ymh <ymh.work@gmail.com> parents: 5 diff changeset	794	}
0 d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	795
7 cf61fcea0001 resynchronize code repo with production ymh <ymh.work@gmail.com> parents: 5 diff changeset	796	if ( ! $path ) {
cf61fcea0001 resynchronize code repo with production ymh <ymh.work@gmail.com> parents: 5 diff changeset	797	$path = get_template_directory();
cf61fcea0001 resynchronize code repo with production ymh <ymh.work@gmail.com> parents: 5 diff changeset	798	}
cf61fcea0001 resynchronize code repo with production ymh <ymh.work@gmail.com> parents: 5 diff changeset	799
cf61fcea0001 resynchronize code repo with production ymh <ymh.work@gmail.com> parents: 5 diff changeset	800	return load_textdomain( $domain, $path . '/' . $locale . '.mo' );
0 d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	801	}
d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	802
d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	803	/**
d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	804	* Load the child themes translated strings.
d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	805	*
d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	806	* If the current locale exists as a .mo file in the child themes
d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	807	* root directory, it will be included in the translated strings by the $domain.
d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	808	*
d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	809	* The .mo files must be named based on the locale exactly.
d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	810	*
d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	811	* @since 2.9.0
d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	812	*
d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	813	* @param string $domain Text domain. Unique identifier for retrieving translated strings.
5 5e2f62d02dcd upgrade wordpress + plugins ymh <ymh.work@gmail.com> parents: 0 diff changeset	814	* @param string $path Optional. Path to the directory containing the .mo file.
5e2f62d02dcd upgrade wordpress + plugins ymh <ymh.work@gmail.com> parents: 0 diff changeset	815	* Default false.
0 d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	816	* @return bool True when the theme textdomain is successfully loaded, false otherwise.
d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	817	*/
d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	818	function load_child_theme_textdomain( $domain, $path = false ) {
d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	819	if ( ! $path )
d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	820	$path = get_stylesheet_directory();
d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	821	return load_theme_textdomain( $domain, $path );
d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	822	}
d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	823
d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	824	/**
7 cf61fcea0001 resynchronize code repo with production ymh <ymh.work@gmail.com> parents: 5 diff changeset	825	* Loads plugin and theme textdomains just-in-time.
cf61fcea0001 resynchronize code repo with production ymh <ymh.work@gmail.com> parents: 5 diff changeset	826	*
cf61fcea0001 resynchronize code repo with production ymh <ymh.work@gmail.com> parents: 5 diff changeset	827	* When a textdomain is encountered for the first time, we try to load
cf61fcea0001 resynchronize code repo with production ymh <ymh.work@gmail.com> parents: 5 diff changeset	828	* the translation file from `wp-content/languages`, removing the need
cf61fcea0001 resynchronize code repo with production ymh <ymh.work@gmail.com> parents: 5 diff changeset	829	* to call load_plugin_texdomain() or load_theme_texdomain().
cf61fcea0001 resynchronize code repo with production ymh <ymh.work@gmail.com> parents: 5 diff changeset	830	*
cf61fcea0001 resynchronize code repo with production ymh <ymh.work@gmail.com> parents: 5 diff changeset	831	* @since 4.6.0
cf61fcea0001 resynchronize code repo with production ymh <ymh.work@gmail.com> parents: 5 diff changeset	832	* @access private
cf61fcea0001 resynchronize code repo with production ymh <ymh.work@gmail.com> parents: 5 diff changeset	833	*
cf61fcea0001 resynchronize code repo with production ymh <ymh.work@gmail.com> parents: 5 diff changeset	834	* @see get_translations_for_domain()
cf61fcea0001 resynchronize code repo with production ymh <ymh.work@gmail.com> parents: 5 diff changeset	835	* @global array $l10n_unloaded An array of all text domains that have been unloaded again.
cf61fcea0001 resynchronize code repo with production ymh <ymh.work@gmail.com> parents: 5 diff changeset	836	*
cf61fcea0001 resynchronize code repo with production ymh <ymh.work@gmail.com> parents: 5 diff changeset	837	* @param string $domain Text domain. Unique identifier for retrieving translated strings.
cf61fcea0001 resynchronize code repo with production ymh <ymh.work@gmail.com> parents: 5 diff changeset	838	* @return bool True when the textdomain is successfully loaded, false otherwise.
cf61fcea0001 resynchronize code repo with production ymh <ymh.work@gmail.com> parents: 5 diff changeset	839	*/
cf61fcea0001 resynchronize code repo with production ymh <ymh.work@gmail.com> parents: 5 diff changeset	840	function _load_textdomain_just_in_time( $domain ) {
cf61fcea0001 resynchronize code repo with production ymh <ymh.work@gmail.com> parents: 5 diff changeset	841	global $l10n_unloaded;
cf61fcea0001 resynchronize code repo with production ymh <ymh.work@gmail.com> parents: 5 diff changeset	842
cf61fcea0001 resynchronize code repo with production ymh <ymh.work@gmail.com> parents: 5 diff changeset	843	$l10n_unloaded = (array) $l10n_unloaded;
cf61fcea0001 resynchronize code repo with production ymh <ymh.work@gmail.com> parents: 5 diff changeset	844
cf61fcea0001 resynchronize code repo with production ymh <ymh.work@gmail.com> parents: 5 diff changeset	845	// Short-circuit if domain is 'default' which is reserved for core.
cf61fcea0001 resynchronize code repo with production ymh <ymh.work@gmail.com> parents: 5 diff changeset	846	if ( 'default' === $domain \|\| isset( $l10n_unloaded[ $domain ] ) ) {
cf61fcea0001 resynchronize code repo with production ymh <ymh.work@gmail.com> parents: 5 diff changeset	847	return false;
cf61fcea0001 resynchronize code repo with production ymh <ymh.work@gmail.com> parents: 5 diff changeset	848	}
cf61fcea0001 resynchronize code repo with production ymh <ymh.work@gmail.com> parents: 5 diff changeset	849
cf61fcea0001 resynchronize code repo with production ymh <ymh.work@gmail.com> parents: 5 diff changeset	850	$translation_path = _get_path_to_translation( $domain );
cf61fcea0001 resynchronize code repo with production ymh <ymh.work@gmail.com> parents: 5 diff changeset	851	if ( false === $translation_path ) {
cf61fcea0001 resynchronize code repo with production ymh <ymh.work@gmail.com> parents: 5 diff changeset	852	return false;
cf61fcea0001 resynchronize code repo with production ymh <ymh.work@gmail.com> parents: 5 diff changeset	853	}
cf61fcea0001 resynchronize code repo with production ymh <ymh.work@gmail.com> parents: 5 diff changeset	854
cf61fcea0001 resynchronize code repo with production ymh <ymh.work@gmail.com> parents: 5 diff changeset	855	return load_textdomain( $domain, $translation_path );
cf61fcea0001 resynchronize code repo with production ymh <ymh.work@gmail.com> parents: 5 diff changeset	856	}
cf61fcea0001 resynchronize code repo with production ymh <ymh.work@gmail.com> parents: 5 diff changeset	857
cf61fcea0001 resynchronize code repo with production ymh <ymh.work@gmail.com> parents: 5 diff changeset	858	/**
cf61fcea0001 resynchronize code repo with production ymh <ymh.work@gmail.com> parents: 5 diff changeset	859	* Gets the path to a translation file for loading a textdomain just in time.
cf61fcea0001 resynchronize code repo with production ymh <ymh.work@gmail.com> parents: 5 diff changeset	860	*
cf61fcea0001 resynchronize code repo with production ymh <ymh.work@gmail.com> parents: 5 diff changeset	861	* Caches the retrieved results internally.
cf61fcea0001 resynchronize code repo with production ymh <ymh.work@gmail.com> parents: 5 diff changeset	862	*
cf61fcea0001 resynchronize code repo with production ymh <ymh.work@gmail.com> parents: 5 diff changeset	863	* @since 4.7.0
cf61fcea0001 resynchronize code repo with production ymh <ymh.work@gmail.com> parents: 5 diff changeset	864	* @access private
cf61fcea0001 resynchronize code repo with production ymh <ymh.work@gmail.com> parents: 5 diff changeset	865	*
cf61fcea0001 resynchronize code repo with production ymh <ymh.work@gmail.com> parents: 5 diff changeset	866	* @see _load_textdomain_just_in_time()
cf61fcea0001 resynchronize code repo with production ymh <ymh.work@gmail.com> parents: 5 diff changeset	867	*
cf61fcea0001 resynchronize code repo with production ymh <ymh.work@gmail.com> parents: 5 diff changeset	868	* @param string $domain Text domain. Unique identifier for retrieving translated strings.
cf61fcea0001 resynchronize code repo with production ymh <ymh.work@gmail.com> parents: 5 diff changeset	869	* @param bool $reset Whether to reset the internal cache. Used by the switch to locale functionality.
cf61fcea0001 resynchronize code repo with production ymh <ymh.work@gmail.com> parents: 5 diff changeset	870	* @return string\|false The path to the translation file or false if no translation file was found.
cf61fcea0001 resynchronize code repo with production ymh <ymh.work@gmail.com> parents: 5 diff changeset	871	*/
cf61fcea0001 resynchronize code repo with production ymh <ymh.work@gmail.com> parents: 5 diff changeset	872	function _get_path_to_translation( $domain, $reset = false ) {
cf61fcea0001 resynchronize code repo with production ymh <ymh.work@gmail.com> parents: 5 diff changeset	873	static $available_translations = array();
cf61fcea0001 resynchronize code repo with production ymh <ymh.work@gmail.com> parents: 5 diff changeset	874
cf61fcea0001 resynchronize code repo with production ymh <ymh.work@gmail.com> parents: 5 diff changeset	875	if ( true === $reset ) {
cf61fcea0001 resynchronize code repo with production ymh <ymh.work@gmail.com> parents: 5 diff changeset	876	$available_translations = array();
cf61fcea0001 resynchronize code repo with production ymh <ymh.work@gmail.com> parents: 5 diff changeset	877	}
cf61fcea0001 resynchronize code repo with production ymh <ymh.work@gmail.com> parents: 5 diff changeset	878
cf61fcea0001 resynchronize code repo with production ymh <ymh.work@gmail.com> parents: 5 diff changeset	879	if ( ! isset( $available_translations[ $domain ] ) ) {
cf61fcea0001 resynchronize code repo with production ymh <ymh.work@gmail.com> parents: 5 diff changeset	880	$available_translations[ $domain ] = _get_path_to_translation_from_lang_dir( $domain );
cf61fcea0001 resynchronize code repo with production ymh <ymh.work@gmail.com> parents: 5 diff changeset	881	}
cf61fcea0001 resynchronize code repo with production ymh <ymh.work@gmail.com> parents: 5 diff changeset	882
cf61fcea0001 resynchronize code repo with production ymh <ymh.work@gmail.com> parents: 5 diff changeset	883	return $available_translations[ $domain ];
cf61fcea0001 resynchronize code repo with production ymh <ymh.work@gmail.com> parents: 5 diff changeset	884	}
cf61fcea0001 resynchronize code repo with production ymh <ymh.work@gmail.com> parents: 5 diff changeset	885
cf61fcea0001 resynchronize code repo with production ymh <ymh.work@gmail.com> parents: 5 diff changeset	886	/**
cf61fcea0001 resynchronize code repo with production ymh <ymh.work@gmail.com> parents: 5 diff changeset	887	* Gets the path to a translation file in the languages directory for the current locale.
cf61fcea0001 resynchronize code repo with production ymh <ymh.work@gmail.com> parents: 5 diff changeset	888	*
cf61fcea0001 resynchronize code repo with production ymh <ymh.work@gmail.com> parents: 5 diff changeset	889	* Holds a cached list of available .mo files to improve performance.
cf61fcea0001 resynchronize code repo with production ymh <ymh.work@gmail.com> parents: 5 diff changeset	890	*
cf61fcea0001 resynchronize code repo with production ymh <ymh.work@gmail.com> parents: 5 diff changeset	891	* @since 4.7.0
cf61fcea0001 resynchronize code repo with production ymh <ymh.work@gmail.com> parents: 5 diff changeset	892	* @access private
cf61fcea0001 resynchronize code repo with production ymh <ymh.work@gmail.com> parents: 5 diff changeset	893	*
cf61fcea0001 resynchronize code repo with production ymh <ymh.work@gmail.com> parents: 5 diff changeset	894	* @see _get_path_to_translation()
cf61fcea0001 resynchronize code repo with production ymh <ymh.work@gmail.com> parents: 5 diff changeset	895	*
cf61fcea0001 resynchronize code repo with production ymh <ymh.work@gmail.com> parents: 5 diff changeset	896	* @param string $domain Text domain. Unique identifier for retrieving translated strings.
cf61fcea0001 resynchronize code repo with production ymh <ymh.work@gmail.com> parents: 5 diff changeset	897	* @return string\|false The path to the translation file or false if no translation file was found.
cf61fcea0001 resynchronize code repo with production ymh <ymh.work@gmail.com> parents: 5 diff changeset	898	*/
cf61fcea0001 resynchronize code repo with production ymh <ymh.work@gmail.com> parents: 5 diff changeset	899	function _get_path_to_translation_from_lang_dir( $domain ) {
cf61fcea0001 resynchronize code repo with production ymh <ymh.work@gmail.com> parents: 5 diff changeset	900	static $cached_mofiles = null;
cf61fcea0001 resynchronize code repo with production ymh <ymh.work@gmail.com> parents: 5 diff changeset	901
cf61fcea0001 resynchronize code repo with production ymh <ymh.work@gmail.com> parents: 5 diff changeset	902	if ( null === $cached_mofiles ) {
cf61fcea0001 resynchronize code repo with production ymh <ymh.work@gmail.com> parents: 5 diff changeset	903	$cached_mofiles = array();
cf61fcea0001 resynchronize code repo with production ymh <ymh.work@gmail.com> parents: 5 diff changeset	904
cf61fcea0001 resynchronize code repo with production ymh <ymh.work@gmail.com> parents: 5 diff changeset	905	$locations = array(
cf61fcea0001 resynchronize code repo with production ymh <ymh.work@gmail.com> parents: 5 diff changeset	906	WP_LANG_DIR . '/plugins',
cf61fcea0001 resynchronize code repo with production ymh <ymh.work@gmail.com> parents: 5 diff changeset	907	WP_LANG_DIR . '/themes',
cf61fcea0001 resynchronize code repo with production ymh <ymh.work@gmail.com> parents: 5 diff changeset	908	);
cf61fcea0001 resynchronize code repo with production ymh <ymh.work@gmail.com> parents: 5 diff changeset	909
cf61fcea0001 resynchronize code repo with production ymh <ymh.work@gmail.com> parents: 5 diff changeset	910	foreach ( $locations as $location ) {
cf61fcea0001 resynchronize code repo with production ymh <ymh.work@gmail.com> parents: 5 diff changeset	911	$mofiles = glob( $location . '/*.mo' );
cf61fcea0001 resynchronize code repo with production ymh <ymh.work@gmail.com> parents: 5 diff changeset	912	if ( $mofiles ) {
cf61fcea0001 resynchronize code repo with production ymh <ymh.work@gmail.com> parents: 5 diff changeset	913	$cached_mofiles = array_merge( $cached_mofiles, $mofiles );
cf61fcea0001 resynchronize code repo with production ymh <ymh.work@gmail.com> parents: 5 diff changeset	914	}
cf61fcea0001 resynchronize code repo with production ymh <ymh.work@gmail.com> parents: 5 diff changeset	915	}
cf61fcea0001 resynchronize code repo with production ymh <ymh.work@gmail.com> parents: 5 diff changeset	916	}
cf61fcea0001 resynchronize code repo with production ymh <ymh.work@gmail.com> parents: 5 diff changeset	917
cf61fcea0001 resynchronize code repo with production ymh <ymh.work@gmail.com> parents: 5 diff changeset	918	$locale = is_admin() ? get_user_locale() : get_locale();
cf61fcea0001 resynchronize code repo with production ymh <ymh.work@gmail.com> parents: 5 diff changeset	919	$mofile = "{$domain}-{$locale}.mo";
cf61fcea0001 resynchronize code repo with production ymh <ymh.work@gmail.com> parents: 5 diff changeset	920
cf61fcea0001 resynchronize code repo with production ymh <ymh.work@gmail.com> parents: 5 diff changeset	921	$path = WP_LANG_DIR . '/plugins/' . $mofile;
cf61fcea0001 resynchronize code repo with production ymh <ymh.work@gmail.com> parents: 5 diff changeset	922	if ( in_array( $path, $cached_mofiles ) ) {
cf61fcea0001 resynchronize code repo with production ymh <ymh.work@gmail.com> parents: 5 diff changeset	923	return $path;
cf61fcea0001 resynchronize code repo with production ymh <ymh.work@gmail.com> parents: 5 diff changeset	924	}
cf61fcea0001 resynchronize code repo with production ymh <ymh.work@gmail.com> parents: 5 diff changeset	925
cf61fcea0001 resynchronize code repo with production ymh <ymh.work@gmail.com> parents: 5 diff changeset	926	$path = WP_LANG_DIR . '/themes/' . $mofile;
cf61fcea0001 resynchronize code repo with production ymh <ymh.work@gmail.com> parents: 5 diff changeset	927	if ( in_array( $path, $cached_mofiles ) ) {
cf61fcea0001 resynchronize code repo with production ymh <ymh.work@gmail.com> parents: 5 diff changeset	928	return $path;
cf61fcea0001 resynchronize code repo with production ymh <ymh.work@gmail.com> parents: 5 diff changeset	929	}
cf61fcea0001 resynchronize code repo with production ymh <ymh.work@gmail.com> parents: 5 diff changeset	930
cf61fcea0001 resynchronize code repo with production ymh <ymh.work@gmail.com> parents: 5 diff changeset	931	return false;
cf61fcea0001 resynchronize code repo with production ymh <ymh.work@gmail.com> parents: 5 diff changeset	932	}
cf61fcea0001 resynchronize code repo with production ymh <ymh.work@gmail.com> parents: 5 diff changeset	933
cf61fcea0001 resynchronize code repo with production ymh <ymh.work@gmail.com> parents: 5 diff changeset	934	/**
0 d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	935	* Return the Translations instance for a text domain.
d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	936	*
d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	937	* If there isn't one, returns empty Translations instance.
d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	938	*
5 5e2f62d02dcd upgrade wordpress + plugins ymh <ymh.work@gmail.com> parents: 0 diff changeset	939	* @since 2.8.0
5e2f62d02dcd upgrade wordpress + plugins ymh <ymh.work@gmail.com> parents: 0 diff changeset	940	*
7 cf61fcea0001 resynchronize code repo with production ymh <ymh.work@gmail.com> parents: 5 diff changeset	941	* @global array $l10n
cf61fcea0001 resynchronize code repo with production ymh <ymh.work@gmail.com> parents: 5 diff changeset	942	*
0 d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	943	* @param string $domain Text domain. Unique identifier for retrieving translated strings.
7 cf61fcea0001 resynchronize code repo with production ymh <ymh.work@gmail.com> parents: 5 diff changeset	944	* @return Translations\|NOOP_Translations A Translations instance.
0 d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	945	*/
d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	946	function get_translations_for_domain( $domain ) {
d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	947	global $l10n;
7 cf61fcea0001 resynchronize code repo with production ymh <ymh.work@gmail.com> parents: 5 diff changeset	948	if ( isset( $l10n[ $domain ] ) \|\| ( _load_textdomain_just_in_time( $domain ) && isset( $l10n[ $domain ] ) ) ) {
cf61fcea0001 resynchronize code repo with production ymh <ymh.work@gmail.com> parents: 5 diff changeset	949	return $l10n[ $domain ];
0 d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	950	}
7 cf61fcea0001 resynchronize code repo with production ymh <ymh.work@gmail.com> parents: 5 diff changeset	951
cf61fcea0001 resynchronize code repo with production ymh <ymh.work@gmail.com> parents: 5 diff changeset	952	static $noop_translations = null;
cf61fcea0001 resynchronize code repo with production ymh <ymh.work@gmail.com> parents: 5 diff changeset	953	if ( null === $noop_translations ) {
cf61fcea0001 resynchronize code repo with production ymh <ymh.work@gmail.com> parents: 5 diff changeset	954	$noop_translations = new NOOP_Translations;
cf61fcea0001 resynchronize code repo with production ymh <ymh.work@gmail.com> parents: 5 diff changeset	955	}
cf61fcea0001 resynchronize code repo with production ymh <ymh.work@gmail.com> parents: 5 diff changeset	956
cf61fcea0001 resynchronize code repo with production ymh <ymh.work@gmail.com> parents: 5 diff changeset	957	return $noop_translations;
0 d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	958	}
d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	959
d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	960	/**
d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	961	* Whether there are translations for the text domain.
d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	962	*
d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	963	* @since 3.0.0
5 5e2f62d02dcd upgrade wordpress + plugins ymh <ymh.work@gmail.com> parents: 0 diff changeset	964	*
7 cf61fcea0001 resynchronize code repo with production ymh <ymh.work@gmail.com> parents: 5 diff changeset	965	* @global array $l10n
cf61fcea0001 resynchronize code repo with production ymh <ymh.work@gmail.com> parents: 5 diff changeset	966	*
0 d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	967	* @param string $domain Text domain. Unique identifier for retrieving translated strings.
d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	968	* @return bool Whether there are translations.
d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	969	*/
d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	970	function is_textdomain_loaded( $domain ) {
d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	971	global $l10n;
7 cf61fcea0001 resynchronize code repo with production ymh <ymh.work@gmail.com> parents: 5 diff changeset	972	return isset( $l10n[ $domain ] );
0 d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	973	}
d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	974
d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	975	/**
d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	976	* Translates role name.
d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	977	*
d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	978	* Since the role names are in the database and not in the source there
d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	979	* are dummy gettext calls to get them into the POT file and this function
d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	980	* properly translates them back.
d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	981	*
7 cf61fcea0001 resynchronize code repo with production ymh <ymh.work@gmail.com> parents: 5 diff changeset	982	* The before_last_bar() call is needed, because older installations keep the roles
0 d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	983	* using the old context format: 'Role name\|User role' and just skipping the
7 cf61fcea0001 resynchronize code repo with production ymh <ymh.work@gmail.com> parents: 5 diff changeset	984	* content after the last bar is easier than fixing them in the DB. New installations
0 d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	985	* won't suffer from that problem.
d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	986	*
d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	987	* @since 2.8.0
d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	988	*
d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	989	* @param string $name The role name.
d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	990	* @return string Translated role name on success, original name on failure.
d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	991	*/
d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	992	function translate_user_role( $name ) {
d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	993	return translate_with_gettext_context( before_last_bar($name), 'User role' );
d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	994	}
d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	995
d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	996	/**
d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	997	* Get all available languages based on the presence of *.mo files in a given directory.
d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	998	*
d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	999	* The default directory is WP_LANG_DIR.
d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	1000	*
d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	1001	* @since 3.0.0
7 cf61fcea0001 resynchronize code repo with production ymh <ymh.work@gmail.com> parents: 5 diff changeset	1002	* @since 4.7.0 The results are now filterable with the {@see 'get_available_languages'} filter.
0 d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	1003	*
d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	1004	* @param string $dir A directory to search for language files.
d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	1005	* Default WP_LANG_DIR.
d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	1006	* @return array An array of language codes or an empty array if no languages are present. Language codes are formed by stripping the .mo extension from the language file names.
d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	1007	*/
d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	1008	function get_available_languages( $dir = null ) {
d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	1009	$languages = array();
d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	1010
7 cf61fcea0001 resynchronize code repo with production ymh <ymh.work@gmail.com> parents: 5 diff changeset	1011	$lang_files = glob( ( is_null( $dir ) ? WP_LANG_DIR : $dir ) . '/*.mo' );
cf61fcea0001 resynchronize code repo with production ymh <ymh.work@gmail.com> parents: 5 diff changeset	1012	if ( $lang_files ) {
cf61fcea0001 resynchronize code repo with production ymh <ymh.work@gmail.com> parents: 5 diff changeset	1013	foreach ( $lang_files as $lang_file ) {
cf61fcea0001 resynchronize code repo with production ymh <ymh.work@gmail.com> parents: 5 diff changeset	1014	$lang_file = basename( $lang_file, '.mo' );
cf61fcea0001 resynchronize code repo with production ymh <ymh.work@gmail.com> parents: 5 diff changeset	1015	if ( 0 !== strpos( $lang_file, 'continents-cities' ) && 0 !== strpos( $lang_file, 'ms-' ) &&
cf61fcea0001 resynchronize code repo with production ymh <ymh.work@gmail.com> parents: 5 diff changeset	1016	0 !== strpos( $lang_file, 'admin-' ) ) {
cf61fcea0001 resynchronize code repo with production ymh <ymh.work@gmail.com> parents: 5 diff changeset	1017	$languages[] = $lang_file;
cf61fcea0001 resynchronize code repo with production ymh <ymh.work@gmail.com> parents: 5 diff changeset	1018	}
cf61fcea0001 resynchronize code repo with production ymh <ymh.work@gmail.com> parents: 5 diff changeset	1019	}
0 d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	1020	}
d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	1021
7 cf61fcea0001 resynchronize code repo with production ymh <ymh.work@gmail.com> parents: 5 diff changeset	1022	/**
cf61fcea0001 resynchronize code repo with production ymh <ymh.work@gmail.com> parents: 5 diff changeset	1023	* Filters the list of available language codes.
cf61fcea0001 resynchronize code repo with production ymh <ymh.work@gmail.com> parents: 5 diff changeset	1024	*
cf61fcea0001 resynchronize code repo with production ymh <ymh.work@gmail.com> parents: 5 diff changeset	1025	* @since 4.7.0
cf61fcea0001 resynchronize code repo with production ymh <ymh.work@gmail.com> parents: 5 diff changeset	1026	*
cf61fcea0001 resynchronize code repo with production ymh <ymh.work@gmail.com> parents: 5 diff changeset	1027	* @param array $languages An array of available language codes.
cf61fcea0001 resynchronize code repo with production ymh <ymh.work@gmail.com> parents: 5 diff changeset	1028	* @param string $dir The directory where the language files were found.
cf61fcea0001 resynchronize code repo with production ymh <ymh.work@gmail.com> parents: 5 diff changeset	1029	*/
cf61fcea0001 resynchronize code repo with production ymh <ymh.work@gmail.com> parents: 5 diff changeset	1030	return apply_filters( 'get_available_languages', $languages, $dir );
0 d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	1031	}
d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	1032
d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	1033	/**
d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	1034	* Get installed translations.
d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	1035	*
d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	1036	* Looks in the wp-content/languages directory for translations of
d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	1037	* plugins or themes.
d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	1038	*
d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	1039	* @since 3.7.0
d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	1040	*
d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	1041	* @param string $type What to search for. Accepts 'plugins', 'themes', 'core'.
d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	1042	* @return array Array of language data.
d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	1043	*/
d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	1044	function wp_get_installed_translations( $type ) {
d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	1045	if ( $type !== 'themes' && $type !== 'plugins' && $type !== 'core' )
d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	1046	return array();
d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	1047
d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	1048	$dir = 'core' === $type ? '' : "/$type";
d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	1049
d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	1050	if ( ! is_dir( WP_LANG_DIR ) )
d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	1051	return array();
d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	1052
d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	1053	if ( $dir && ! is_dir( WP_LANG_DIR . $dir ) )
d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	1054	return array();
d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	1055
d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	1056	$files = scandir( WP_LANG_DIR . $dir );
d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	1057	if ( ! $files )
d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	1058	return array();
d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	1059
d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	1060	$language_data = array();
d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	1061
d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	1062	foreach ( $files as $file ) {
7 cf61fcea0001 resynchronize code repo with production ymh <ymh.work@gmail.com> parents: 5 diff changeset	1063	if ( '.' === $file[0] \|\| is_dir( WP_LANG_DIR . "$dir/$file" ) ) {
5 5e2f62d02dcd upgrade wordpress + plugins ymh <ymh.work@gmail.com> parents: 0 diff changeset	1064	continue;
5e2f62d02dcd upgrade wordpress + plugins ymh <ymh.work@gmail.com> parents: 0 diff changeset	1065	}
5e2f62d02dcd upgrade wordpress + plugins ymh <ymh.work@gmail.com> parents: 0 diff changeset	1066	if ( substr( $file, -3 ) !== '.po' ) {
0 d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	1067	continue;
5 5e2f62d02dcd upgrade wordpress + plugins ymh <ymh.work@gmail.com> parents: 0 diff changeset	1068	}
7 cf61fcea0001 resynchronize code repo with production ymh <ymh.work@gmail.com> parents: 5 diff changeset	1069	if ( ! preg_match( '/(?:(.+)-)?([a-z]{2,3}(?:_[A-Z]{2})?(?:_[a-z0-9]+)?).po/', $file, $match ) ) {
0 d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	1070	continue;
5 5e2f62d02dcd upgrade wordpress + plugins ymh <ymh.work@gmail.com> parents: 0 diff changeset	1071	}
5e2f62d02dcd upgrade wordpress + plugins ymh <ymh.work@gmail.com> parents: 0 diff changeset	1072	if ( ! in_array( substr( $file, 0, -3 ) . '.mo', $files ) ) {
0 d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	1073	continue;
5 5e2f62d02dcd upgrade wordpress + plugins ymh <ymh.work@gmail.com> parents: 0 diff changeset	1074	}
0 d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	1075
d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	1076	list( , $textdomain, $language ) = $match;
5 5e2f62d02dcd upgrade wordpress + plugins ymh <ymh.work@gmail.com> parents: 0 diff changeset	1077	if ( '' === $textdomain ) {
0 d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	1078	$textdomain = 'default';
5 5e2f62d02dcd upgrade wordpress + plugins ymh <ymh.work@gmail.com> parents: 0 diff changeset	1079	}
0 d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	1080	$language_data[ $textdomain ][ $language ] = wp_get_pomo_file_data( WP_LANG_DIR . "$dir/$file" );
d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	1081	}
d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	1082	return $language_data;
d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	1083	}
d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	1084
d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	1085	/**
d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	1086	* Extract headers from a PO file.
d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	1087	*
d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	1088	* @since 3.7.0
d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	1089	*
d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	1090	* @param string $po_file Path to PO file.
d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	1091	* @return array PO file headers.
d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	1092	*/
d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	1093	function wp_get_pomo_file_data( $po_file ) {
d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	1094	$headers = get_file_data( $po_file, array(
d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	1095	'POT-Creation-Date' => '"POT-Creation-Date',
d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	1096	'PO-Revision-Date' => '"PO-Revision-Date',
d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	1097	'Project-Id-Version' => '"Project-Id-Version',
d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	1098	'X-Generator' => '"X-Generator',
d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	1099	) );
d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	1100	foreach ( $headers as $header => $value ) {
d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	1101	// Remove possible contextual '\n' and closing double quote.
d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	1102	$headers[ $header ] = preg_replace( '~(\\\n)?"$~', '', $value );
d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	1103	}
d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	1104	return $headers;
d970ebf37754 first import ymh <ymh.work@gmail.com> parents: diff changeset	1105	}
5 5e2f62d02dcd upgrade wordpress + plugins ymh <ymh.work@gmail.com> parents: 0 diff changeset	1106
5e2f62d02dcd upgrade wordpress + plugins ymh <ymh.work@gmail.com> parents: 0 diff changeset	1107	/**
5e2f62d02dcd upgrade wordpress + plugins ymh <ymh.work@gmail.com> parents: 0 diff changeset	1108	* Language selector.
5e2f62d02dcd upgrade wordpress + plugins ymh <ymh.work@gmail.com> parents: 0 diff changeset	1109	*
5e2f62d02dcd upgrade wordpress + plugins ymh <ymh.work@gmail.com> parents: 0 diff changeset	1110	* @since 4.0.0
7 cf61fcea0001 resynchronize code repo with production ymh <ymh.work@gmail.com> parents: 5 diff changeset	1111	* @since 4.3.0 Introduced the `echo` argument.
cf61fcea0001 resynchronize code repo with production ymh <ymh.work@gmail.com> parents: 5 diff changeset	1112	* @since 4.7.0 Introduced the `show_option_site_default` argument.
5 5e2f62d02dcd upgrade wordpress + plugins ymh <ymh.work@gmail.com> parents: 0 diff changeset	1113	*
5e2f62d02dcd upgrade wordpress + plugins ymh <ymh.work@gmail.com> parents: 0 diff changeset	1114	* @see get_available_languages()
5e2f62d02dcd upgrade wordpress + plugins ymh <ymh.work@gmail.com> parents: 0 diff changeset	1115	* @see wp_get_available_translations()
5e2f62d02dcd upgrade wordpress + plugins ymh <ymh.work@gmail.com> parents: 0 diff changeset	1116	*
5e2f62d02dcd upgrade wordpress + plugins ymh <ymh.work@gmail.com> parents: 0 diff changeset	1117	* @param string\|array $args {
5e2f62d02dcd upgrade wordpress + plugins ymh <ymh.work@gmail.com> parents: 0 diff changeset	1118	* Optional. Array or string of arguments for outputting the language selector.
5e2f62d02dcd upgrade wordpress + plugins ymh <ymh.work@gmail.com> parents: 0 diff changeset	1119	*
7 cf61fcea0001 resynchronize code repo with production ymh <ymh.work@gmail.com> parents: 5 diff changeset	1120	* @type string $id ID attribute of the select element. Default 'locale'.
cf61fcea0001 resynchronize code repo with production ymh <ymh.work@gmail.com> parents: 5 diff changeset	1121	* @type string $name Name attribute of the select element. Default 'locale'.
cf61fcea0001 resynchronize code repo with production ymh <ymh.work@gmail.com> parents: 5 diff changeset	1122	* @type array $languages List of installed languages, contain only the locales.
cf61fcea0001 resynchronize code repo with production ymh <ymh.work@gmail.com> parents: 5 diff changeset	1123	* Default empty array.
cf61fcea0001 resynchronize code repo with production ymh <ymh.work@gmail.com> parents: 5 diff changeset	1124	* @type array $translations List of available translations. Default result of
cf61fcea0001 resynchronize code repo with production ymh <ymh.work@gmail.com> parents: 5 diff changeset	1125	* wp_get_available_translations().
cf61fcea0001 resynchronize code repo with production ymh <ymh.work@gmail.com> parents: 5 diff changeset	1126	* @type string $selected Language which should be selected. Default empty.
cf61fcea0001 resynchronize code repo with production ymh <ymh.work@gmail.com> parents: 5 diff changeset	1127	* @type bool\|int $echo Whether to echo the generated markup. Accepts 0, 1, or their
cf61fcea0001 resynchronize code repo with production ymh <ymh.work@gmail.com> parents: 5 diff changeset	1128	* boolean equivalents. Default 1.
cf61fcea0001 resynchronize code repo with production ymh <ymh.work@gmail.com> parents: 5 diff changeset	1129	* @type bool $show_available_translations Whether to show available translations. Default true.
cf61fcea0001 resynchronize code repo with production ymh <ymh.work@gmail.com> parents: 5 diff changeset	1130	* @type bool $show_option_site_default Whether to show an option to fall back to the site's locale. Default false.
5 5e2f62d02dcd upgrade wordpress + plugins ymh <ymh.work@gmail.com> parents: 0 diff changeset	1131	* }
7 cf61fcea0001 resynchronize code repo with production ymh <ymh.work@gmail.com> parents: 5 diff changeset	1132	* @return string HTML content
5 5e2f62d02dcd upgrade wordpress + plugins ymh <ymh.work@gmail.com> parents: 0 diff changeset	1133	*/
5e2f62d02dcd upgrade wordpress + plugins ymh <ymh.work@gmail.com> parents: 0 diff changeset	1134	function wp_dropdown_languages( $args = array() ) {
5e2f62d02dcd upgrade wordpress + plugins ymh <ymh.work@gmail.com> parents: 0 diff changeset	1135
7 cf61fcea0001 resynchronize code repo with production ymh <ymh.work@gmail.com> parents: 5 diff changeset	1136	$parsed_args = wp_parse_args( $args, array(
cf61fcea0001 resynchronize code repo with production ymh <ymh.work@gmail.com> parents: 5 diff changeset	1137	'id' => 'locale',
cf61fcea0001 resynchronize code repo with production ymh <ymh.work@gmail.com> parents: 5 diff changeset	1138	'name' => 'locale',
5 5e2f62d02dcd upgrade wordpress + plugins ymh <ymh.work@gmail.com> parents: 0 diff changeset	1139	'languages' => array(),
5e2f62d02dcd upgrade wordpress + plugins ymh <ymh.work@gmail.com> parents: 0 diff changeset	1140	'translations' => array(),
5e2f62d02dcd upgrade wordpress + plugins ymh <ymh.work@gmail.com> parents: 0 diff changeset	1141	'selected' => '',
7 cf61fcea0001 resynchronize code repo with production ymh <ymh.work@gmail.com> parents: 5 diff changeset	1142	'echo' => 1,
5 5e2f62d02dcd upgrade wordpress + plugins ymh <ymh.work@gmail.com> parents: 0 diff changeset	1143	'show_available_translations' => true,
7 cf61fcea0001 resynchronize code repo with production ymh <ymh.work@gmail.com> parents: 5 diff changeset	1144	'show_option_site_default' => false,
5 5e2f62d02dcd upgrade wordpress + plugins ymh <ymh.work@gmail.com> parents: 0 diff changeset	1145	) );
5e2f62d02dcd upgrade wordpress + plugins ymh <ymh.work@gmail.com> parents: 0 diff changeset	1146
7 cf61fcea0001 resynchronize code repo with production ymh <ymh.work@gmail.com> parents: 5 diff changeset	1147	// Bail if no ID or no name.
cf61fcea0001 resynchronize code repo with production ymh <ymh.work@gmail.com> parents: 5 diff changeset	1148	if ( ! $parsed_args['id'] \|\| ! $parsed_args['name'] ) {
cf61fcea0001 resynchronize code repo with production ymh <ymh.work@gmail.com> parents: 5 diff changeset	1149	return;
cf61fcea0001 resynchronize code repo with production ymh <ymh.work@gmail.com> parents: 5 diff changeset	1150	}
cf61fcea0001 resynchronize code repo with production ymh <ymh.work@gmail.com> parents: 5 diff changeset	1151
cf61fcea0001 resynchronize code repo with production ymh <ymh.work@gmail.com> parents: 5 diff changeset	1152	// English (United States) uses an empty string for the value attribute.
cf61fcea0001 resynchronize code repo with production ymh <ymh.work@gmail.com> parents: 5 diff changeset	1153	if ( 'en_US' === $parsed_args['selected'] ) {
cf61fcea0001 resynchronize code repo with production ymh <ymh.work@gmail.com> parents: 5 diff changeset	1154	$parsed_args['selected'] = '';
cf61fcea0001 resynchronize code repo with production ymh <ymh.work@gmail.com> parents: 5 diff changeset	1155	}
cf61fcea0001 resynchronize code repo with production ymh <ymh.work@gmail.com> parents: 5 diff changeset	1156
cf61fcea0001 resynchronize code repo with production ymh <ymh.work@gmail.com> parents: 5 diff changeset	1157	$translations = $parsed_args['translations'];
5 5e2f62d02dcd upgrade wordpress + plugins ymh <ymh.work@gmail.com> parents: 0 diff changeset	1158	if ( empty( $translations ) ) {
5e2f62d02dcd upgrade wordpress + plugins ymh <ymh.work@gmail.com> parents: 0 diff changeset	1159	require_once( ABSPATH . 'wp-admin/includes/translation-install.php' );
5e2f62d02dcd upgrade wordpress + plugins ymh <ymh.work@gmail.com> parents: 0 diff changeset	1160	$translations = wp_get_available_translations();
5e2f62d02dcd upgrade wordpress + plugins ymh <ymh.work@gmail.com> parents: 0 diff changeset	1161	}
5e2f62d02dcd upgrade wordpress + plugins ymh <ymh.work@gmail.com> parents: 0 diff changeset	1162
5e2f62d02dcd upgrade wordpress + plugins ymh <ymh.work@gmail.com> parents: 0 diff changeset	1163	/*
7 cf61fcea0001 resynchronize code repo with production ymh <ymh.work@gmail.com> parents: 5 diff changeset	1164	* $parsed_args['languages'] should only contain the locales. Find the locale in
5 5e2f62d02dcd upgrade wordpress + plugins ymh <ymh.work@gmail.com> parents: 0 diff changeset	1165	* $translations to get the native name. Fall back to locale.
5e2f62d02dcd upgrade wordpress + plugins ymh <ymh.work@gmail.com> parents: 0 diff changeset	1166	*/
5e2f62d02dcd upgrade wordpress + plugins ymh <ymh.work@gmail.com> parents: 0 diff changeset	1167	$languages = array();
7 cf61fcea0001 resynchronize code repo with production ymh <ymh.work@gmail.com> parents: 5 diff changeset	1168	foreach ( $parsed_args['languages'] as $locale ) {
5 5e2f62d02dcd upgrade wordpress + plugins ymh <ymh.work@gmail.com> parents: 0 diff changeset	1169	if ( isset( $translations[ $locale ] ) ) {
5e2f62d02dcd upgrade wordpress + plugins ymh <ymh.work@gmail.com> parents: 0 diff changeset	1170	$translation = $translations[ $locale ];
5e2f62d02dcd upgrade wordpress + plugins ymh <ymh.work@gmail.com> parents: 0 diff changeset	1171	$languages[] = array(
5e2f62d02dcd upgrade wordpress + plugins ymh <ymh.work@gmail.com> parents: 0 diff changeset	1172	'language' => $translation['language'],
5e2f62d02dcd upgrade wordpress + plugins ymh <ymh.work@gmail.com> parents: 0 diff changeset	1173	'native_name' => $translation['native_name'],
5e2f62d02dcd upgrade wordpress + plugins ymh <ymh.work@gmail.com> parents: 0 diff changeset	1174	'lang' => current( $translation['iso'] ),
5e2f62d02dcd upgrade wordpress + plugins ymh <ymh.work@gmail.com> parents: 0 diff changeset	1175	);
5e2f62d02dcd upgrade wordpress + plugins ymh <ymh.work@gmail.com> parents: 0 diff changeset	1176
5e2f62d02dcd upgrade wordpress + plugins ymh <ymh.work@gmail.com> parents: 0 diff changeset	1177	// Remove installed language from available translations.
5e2f62d02dcd upgrade wordpress + plugins ymh <ymh.work@gmail.com> parents: 0 diff changeset	1178	unset( $translations[ $locale ] );
5e2f62d02dcd upgrade wordpress + plugins ymh <ymh.work@gmail.com> parents: 0 diff changeset	1179	} else {
5e2f62d02dcd upgrade wordpress + plugins ymh <ymh.work@gmail.com> parents: 0 diff changeset	1180	$languages[] = array(
5e2f62d02dcd upgrade wordpress + plugins ymh <ymh.work@gmail.com> parents: 0 diff changeset	1181	'language' => $locale,
5e2f62d02dcd upgrade wordpress + plugins ymh <ymh.work@gmail.com> parents: 0 diff changeset	1182	'native_name' => $locale,
5e2f62d02dcd upgrade wordpress + plugins ymh <ymh.work@gmail.com> parents: 0 diff changeset	1183	'lang' => '',
5e2f62d02dcd upgrade wordpress + plugins ymh <ymh.work@gmail.com> parents: 0 diff changeset	1184	);
5e2f62d02dcd upgrade wordpress + plugins ymh <ymh.work@gmail.com> parents: 0 diff changeset	1185	}
5e2f62d02dcd upgrade wordpress + plugins ymh <ymh.work@gmail.com> parents: 0 diff changeset	1186	}
5e2f62d02dcd upgrade wordpress + plugins ymh <ymh.work@gmail.com> parents: 0 diff changeset	1187
7 cf61fcea0001 resynchronize code repo with production ymh <ymh.work@gmail.com> parents: 5 diff changeset	1188	$translations_available = ( ! empty( $translations ) && $parsed_args['show_available_translations'] );
5 5e2f62d02dcd upgrade wordpress + plugins ymh <ymh.work@gmail.com> parents: 0 diff changeset	1189
5e2f62d02dcd upgrade wordpress + plugins ymh <ymh.work@gmail.com> parents: 0 diff changeset	1190	// Holds the HTML markup.
5e2f62d02dcd upgrade wordpress + plugins ymh <ymh.work@gmail.com> parents: 0 diff changeset	1191	$structure = array();
5e2f62d02dcd upgrade wordpress + plugins ymh <ymh.work@gmail.com> parents: 0 diff changeset	1192
5e2f62d02dcd upgrade wordpress + plugins ymh <ymh.work@gmail.com> parents: 0 diff changeset	1193	// List installed languages.
5e2f62d02dcd upgrade wordpress + plugins ymh <ymh.work@gmail.com> parents: 0 diff changeset	1194	if ( $translations_available ) {
5e2f62d02dcd upgrade wordpress + plugins ymh <ymh.work@gmail.com> parents: 0 diff changeset	1195	$structure[] = '<optgroup label="' . esc_attr_x( 'Installed', 'translations' ) . '">';
5e2f62d02dcd upgrade wordpress + plugins ymh <ymh.work@gmail.com> parents: 0 diff changeset	1196	}
7 cf61fcea0001 resynchronize code repo with production ymh <ymh.work@gmail.com> parents: 5 diff changeset	1197
cf61fcea0001 resynchronize code repo with production ymh <ymh.work@gmail.com> parents: 5 diff changeset	1198	// Site default.
cf61fcea0001 resynchronize code repo with production ymh <ymh.work@gmail.com> parents: 5 diff changeset	1199	if ( $parsed_args['show_option_site_default'] ) {
cf61fcea0001 resynchronize code repo with production ymh <ymh.work@gmail.com> parents: 5 diff changeset	1200	$structure[] = sprintf(
cf61fcea0001 resynchronize code repo with production ymh <ymh.work@gmail.com> parents: 5 diff changeset	1201	'<option value="site-default" data-installed="1"%s>%s</option>',
cf61fcea0001 resynchronize code repo with production ymh <ymh.work@gmail.com> parents: 5 diff changeset	1202	selected( 'site-default', $parsed_args['selected'], false ),
cf61fcea0001 resynchronize code repo with production ymh <ymh.work@gmail.com> parents: 5 diff changeset	1203	_x( 'Site Default', 'default site language' )
cf61fcea0001 resynchronize code repo with production ymh <ymh.work@gmail.com> parents: 5 diff changeset	1204	);
cf61fcea0001 resynchronize code repo with production ymh <ymh.work@gmail.com> parents: 5 diff changeset	1205	}
cf61fcea0001 resynchronize code repo with production ymh <ymh.work@gmail.com> parents: 5 diff changeset	1206
cf61fcea0001 resynchronize code repo with production ymh <ymh.work@gmail.com> parents: 5 diff changeset	1207	// Always show English.
cf61fcea0001 resynchronize code repo with production ymh <ymh.work@gmail.com> parents: 5 diff changeset	1208	$structure[] = sprintf(
cf61fcea0001 resynchronize code repo with production ymh <ymh.work@gmail.com> parents: 5 diff changeset	1209	'<option value="" lang="en" data-installed="1"%s>English (United States)</option>',
cf61fcea0001 resynchronize code repo with production ymh <ymh.work@gmail.com> parents: 5 diff changeset	1210	selected( '', $parsed_args['selected'], false )
cf61fcea0001 resynchronize code repo with production ymh <ymh.work@gmail.com> parents: 5 diff changeset	1211	);
cf61fcea0001 resynchronize code repo with production ymh <ymh.work@gmail.com> parents: 5 diff changeset	1212
cf61fcea0001 resynchronize code repo with production ymh <ymh.work@gmail.com> parents: 5 diff changeset	1213	// List installed languages.
5 5e2f62d02dcd upgrade wordpress + plugins ymh <ymh.work@gmail.com> parents: 0 diff changeset	1214	foreach ( $languages as $language ) {
5e2f62d02dcd upgrade wordpress + plugins ymh <ymh.work@gmail.com> parents: 0 diff changeset	1215	$structure[] = sprintf(
5e2f62d02dcd upgrade wordpress + plugins ymh <ymh.work@gmail.com> parents: 0 diff changeset	1216	'<option value="%s" lang="%s"%s data-installed="1">%s</option>',
5e2f62d02dcd upgrade wordpress + plugins ymh <ymh.work@gmail.com> parents: 0 diff changeset	1217	esc_attr( $language['language'] ),
5e2f62d02dcd upgrade wordpress + plugins ymh <ymh.work@gmail.com> parents: 0 diff changeset	1218	esc_attr( $language['lang'] ),
7 cf61fcea0001 resynchronize code repo with production ymh <ymh.work@gmail.com> parents: 5 diff changeset	1219	selected( $language['language'], $parsed_args['selected'], false ),
5 5e2f62d02dcd upgrade wordpress + plugins ymh <ymh.work@gmail.com> parents: 0 diff changeset	1220	esc_html( $language['native_name'] )
5e2f62d02dcd upgrade wordpress + plugins ymh <ymh.work@gmail.com> parents: 0 diff changeset	1221	);
5e2f62d02dcd upgrade wordpress + plugins ymh <ymh.work@gmail.com> parents: 0 diff changeset	1222	}
5e2f62d02dcd upgrade wordpress + plugins ymh <ymh.work@gmail.com> parents: 0 diff changeset	1223	if ( $translations_available ) {
5e2f62d02dcd upgrade wordpress + plugins ymh <ymh.work@gmail.com> parents: 0 diff changeset	1224	$structure[] = '</optgroup>';
5e2f62d02dcd upgrade wordpress + plugins ymh <ymh.work@gmail.com> parents: 0 diff changeset	1225	}
5e2f62d02dcd upgrade wordpress + plugins ymh <ymh.work@gmail.com> parents: 0 diff changeset	1226
5e2f62d02dcd upgrade wordpress + plugins ymh <ymh.work@gmail.com> parents: 0 diff changeset	1227	// List available translations.
5e2f62d02dcd upgrade wordpress + plugins ymh <ymh.work@gmail.com> parents: 0 diff changeset	1228	if ( $translations_available ) {
5e2f62d02dcd upgrade wordpress + plugins ymh <ymh.work@gmail.com> parents: 0 diff changeset	1229	$structure[] = '<optgroup label="' . esc_attr_x( 'Available', 'translations' ) . '">';
5e2f62d02dcd upgrade wordpress + plugins ymh <ymh.work@gmail.com> parents: 0 diff changeset	1230	foreach ( $translations as $translation ) {
5e2f62d02dcd upgrade wordpress + plugins ymh <ymh.work@gmail.com> parents: 0 diff changeset	1231	$structure[] = sprintf(
5e2f62d02dcd upgrade wordpress + plugins ymh <ymh.work@gmail.com> parents: 0 diff changeset	1232	'<option value="%s" lang="%s"%s>%s</option>',
5e2f62d02dcd upgrade wordpress + plugins ymh <ymh.work@gmail.com> parents: 0 diff changeset	1233	esc_attr( $translation['language'] ),
5e2f62d02dcd upgrade wordpress + plugins ymh <ymh.work@gmail.com> parents: 0 diff changeset	1234	esc_attr( current( $translation['iso'] ) ),
7 cf61fcea0001 resynchronize code repo with production ymh <ymh.work@gmail.com> parents: 5 diff changeset	1235	selected( $translation['language'], $parsed_args['selected'], false ),
5 5e2f62d02dcd upgrade wordpress + plugins ymh <ymh.work@gmail.com> parents: 0 diff changeset	1236	esc_html( $translation['native_name'] )
5e2f62d02dcd upgrade wordpress + plugins ymh <ymh.work@gmail.com> parents: 0 diff changeset	1237	);
5e2f62d02dcd upgrade wordpress + plugins ymh <ymh.work@gmail.com> parents: 0 diff changeset	1238	}
5e2f62d02dcd upgrade wordpress + plugins ymh <ymh.work@gmail.com> parents: 0 diff changeset	1239	$structure[] = '</optgroup>';
5e2f62d02dcd upgrade wordpress + plugins ymh <ymh.work@gmail.com> parents: 0 diff changeset	1240	}
5e2f62d02dcd upgrade wordpress + plugins ymh <ymh.work@gmail.com> parents: 0 diff changeset	1241
7 cf61fcea0001 resynchronize code repo with production ymh <ymh.work@gmail.com> parents: 5 diff changeset	1242	// Combine the output string.
cf61fcea0001 resynchronize code repo with production ymh <ymh.work@gmail.com> parents: 5 diff changeset	1243	$output = sprintf( '<select name="%s" id="%s">', esc_attr( $parsed_args['name'] ), esc_attr( $parsed_args['id'] ) );
cf61fcea0001 resynchronize code repo with production ymh <ymh.work@gmail.com> parents: 5 diff changeset	1244	$output .= join( "\n", $structure );
cf61fcea0001 resynchronize code repo with production ymh <ymh.work@gmail.com> parents: 5 diff changeset	1245	$output .= '</select>';
cf61fcea0001 resynchronize code repo with production ymh <ymh.work@gmail.com> parents: 5 diff changeset	1246
cf61fcea0001 resynchronize code repo with production ymh <ymh.work@gmail.com> parents: 5 diff changeset	1247	if ( $parsed_args['echo'] ) {
cf61fcea0001 resynchronize code repo with production ymh <ymh.work@gmail.com> parents: 5 diff changeset	1248	echo $output;
cf61fcea0001 resynchronize code repo with production ymh <ymh.work@gmail.com> parents: 5 diff changeset	1249	}
cf61fcea0001 resynchronize code repo with production ymh <ymh.work@gmail.com> parents: 5 diff changeset	1250
cf61fcea0001 resynchronize code repo with production ymh <ymh.work@gmail.com> parents: 5 diff changeset	1251	return $output;
cf61fcea0001 resynchronize code repo with production ymh <ymh.work@gmail.com> parents: 5 diff changeset	1252	}
cf61fcea0001 resynchronize code repo with production ymh <ymh.work@gmail.com> parents: 5 diff changeset	1253
cf61fcea0001 resynchronize code repo with production ymh <ymh.work@gmail.com> parents: 5 diff changeset	1254	/**
cf61fcea0001 resynchronize code repo with production ymh <ymh.work@gmail.com> parents: 5 diff changeset	1255	* Checks if current locale is RTL.
cf61fcea0001 resynchronize code repo with production ymh <ymh.work@gmail.com> parents: 5 diff changeset	1256	*
cf61fcea0001 resynchronize code repo with production ymh <ymh.work@gmail.com> parents: 5 diff changeset	1257	* @since 3.0.0
cf61fcea0001 resynchronize code repo with production ymh <ymh.work@gmail.com> parents: 5 diff changeset	1258	*
cf61fcea0001 resynchronize code repo with production ymh <ymh.work@gmail.com> parents: 5 diff changeset	1259	* @global WP_Locale $wp_locale
cf61fcea0001 resynchronize code repo with production ymh <ymh.work@gmail.com> parents: 5 diff changeset	1260	*
cf61fcea0001 resynchronize code repo with production ymh <ymh.work@gmail.com> parents: 5 diff changeset	1261	* @return bool Whether locale is RTL.
cf61fcea0001 resynchronize code repo with production ymh <ymh.work@gmail.com> parents: 5 diff changeset	1262	*/
cf61fcea0001 resynchronize code repo with production ymh <ymh.work@gmail.com> parents: 5 diff changeset	1263	function is_rtl() {
cf61fcea0001 resynchronize code repo with production ymh <ymh.work@gmail.com> parents: 5 diff changeset	1264	global $wp_locale;
cf61fcea0001 resynchronize code repo with production ymh <ymh.work@gmail.com> parents: 5 diff changeset	1265	if ( ! ( $wp_locale instanceof WP_Locale ) ) {
cf61fcea0001 resynchronize code repo with production ymh <ymh.work@gmail.com> parents: 5 diff changeset	1266	return false;
cf61fcea0001 resynchronize code repo with production ymh <ymh.work@gmail.com> parents: 5 diff changeset	1267	}
cf61fcea0001 resynchronize code repo with production ymh <ymh.work@gmail.com> parents: 5 diff changeset	1268	return $wp_locale->is_rtl();
cf61fcea0001 resynchronize code repo with production ymh <ymh.work@gmail.com> parents: 5 diff changeset	1269	}
cf61fcea0001 resynchronize code repo with production ymh <ymh.work@gmail.com> parents: 5 diff changeset	1270
cf61fcea0001 resynchronize code repo with production ymh <ymh.work@gmail.com> parents: 5 diff changeset	1271	/**
cf61fcea0001 resynchronize code repo with production ymh <ymh.work@gmail.com> parents: 5 diff changeset	1272	* Switches the translations according to the given locale.
cf61fcea0001 resynchronize code repo with production ymh <ymh.work@gmail.com> parents: 5 diff changeset	1273	*
cf61fcea0001 resynchronize code repo with production ymh <ymh.work@gmail.com> parents: 5 diff changeset	1274	* @since 4.7.0
cf61fcea0001 resynchronize code repo with production ymh <ymh.work@gmail.com> parents: 5 diff changeset	1275	*
cf61fcea0001 resynchronize code repo with production ymh <ymh.work@gmail.com> parents: 5 diff changeset	1276	* @global WP_Locale_Switcher $wp_locale_switcher
cf61fcea0001 resynchronize code repo with production ymh <ymh.work@gmail.com> parents: 5 diff changeset	1277	*
cf61fcea0001 resynchronize code repo with production ymh <ymh.work@gmail.com> parents: 5 diff changeset	1278	* @param string $locale The locale.
cf61fcea0001 resynchronize code repo with production ymh <ymh.work@gmail.com> parents: 5 diff changeset	1279	* @return bool True on success, false on failure.
cf61fcea0001 resynchronize code repo with production ymh <ymh.work@gmail.com> parents: 5 diff changeset	1280	*/
cf61fcea0001 resynchronize code repo with production ymh <ymh.work@gmail.com> parents: 5 diff changeset	1281	function switch_to_locale( $locale ) {
cf61fcea0001 resynchronize code repo with production ymh <ymh.work@gmail.com> parents: 5 diff changeset	1282	/* @var WP_Locale_Switcher $wp_locale_switcher */
cf61fcea0001 resynchronize code repo with production ymh <ymh.work@gmail.com> parents: 5 diff changeset	1283	global $wp_locale_switcher;
cf61fcea0001 resynchronize code repo with production ymh <ymh.work@gmail.com> parents: 5 diff changeset	1284
cf61fcea0001 resynchronize code repo with production ymh <ymh.work@gmail.com> parents: 5 diff changeset	1285	return $wp_locale_switcher->switch_to_locale( $locale );
cf61fcea0001 resynchronize code repo with production ymh <ymh.work@gmail.com> parents: 5 diff changeset	1286	}
5 5e2f62d02dcd upgrade wordpress + plugins ymh <ymh.work@gmail.com> parents: 0 diff changeset	1287
7 cf61fcea0001 resynchronize code repo with production ymh <ymh.work@gmail.com> parents: 5 diff changeset	1288	/**
cf61fcea0001 resynchronize code repo with production ymh <ymh.work@gmail.com> parents: 5 diff changeset	1289	* Restores the translations according to the previous locale.
cf61fcea0001 resynchronize code repo with production ymh <ymh.work@gmail.com> parents: 5 diff changeset	1290	*
cf61fcea0001 resynchronize code repo with production ymh <ymh.work@gmail.com> parents: 5 diff changeset	1291	* @since 4.7.0
cf61fcea0001 resynchronize code repo with production ymh <ymh.work@gmail.com> parents: 5 diff changeset	1292	*
cf61fcea0001 resynchronize code repo with production ymh <ymh.work@gmail.com> parents: 5 diff changeset	1293	* @global WP_Locale_Switcher $wp_locale_switcher
cf61fcea0001 resynchronize code repo with production ymh <ymh.work@gmail.com> parents: 5 diff changeset	1294	*
cf61fcea0001 resynchronize code repo with production ymh <ymh.work@gmail.com> parents: 5 diff changeset	1295	* @return string\|false Locale on success, false on error.
cf61fcea0001 resynchronize code repo with production ymh <ymh.work@gmail.com> parents: 5 diff changeset	1296	*/
cf61fcea0001 resynchronize code repo with production ymh <ymh.work@gmail.com> parents: 5 diff changeset	1297	function restore_previous_locale() {
cf61fcea0001 resynchronize code repo with production ymh <ymh.work@gmail.com> parents: 5 diff changeset	1298	/* @var WP_Locale_Switcher $wp_locale_switcher */
cf61fcea0001 resynchronize code repo with production ymh <ymh.work@gmail.com> parents: 5 diff changeset	1299	global $wp_locale_switcher;
cf61fcea0001 resynchronize code repo with production ymh <ymh.work@gmail.com> parents: 5 diff changeset	1300
cf61fcea0001 resynchronize code repo with production ymh <ymh.work@gmail.com> parents: 5 diff changeset	1301	return $wp_locale_switcher->restore_previous_locale();
5 5e2f62d02dcd upgrade wordpress + plugins ymh <ymh.work@gmail.com> parents: 0 diff changeset	1302	}
7 cf61fcea0001 resynchronize code repo with production ymh <ymh.work@gmail.com> parents: 5 diff changeset	1303
cf61fcea0001 resynchronize code repo with production ymh <ymh.work@gmail.com> parents: 5 diff changeset	1304	/**
cf61fcea0001 resynchronize code repo with production ymh <ymh.work@gmail.com> parents: 5 diff changeset	1305	* Restores the translations according to the original locale.
cf61fcea0001 resynchronize code repo with production ymh <ymh.work@gmail.com> parents: 5 diff changeset	1306	*
cf61fcea0001 resynchronize code repo with production ymh <ymh.work@gmail.com> parents: 5 diff changeset	1307	* @since 4.7.0
cf61fcea0001 resynchronize code repo with production ymh <ymh.work@gmail.com> parents: 5 diff changeset	1308	*
cf61fcea0001 resynchronize code repo with production ymh <ymh.work@gmail.com> parents: 5 diff changeset	1309	* @global WP_Locale_Switcher $wp_locale_switcher
cf61fcea0001 resynchronize code repo with production ymh <ymh.work@gmail.com> parents: 5 diff changeset	1310	*
cf61fcea0001 resynchronize code repo with production ymh <ymh.work@gmail.com> parents: 5 diff changeset	1311	* @return string\|false Locale on success, false on error.
cf61fcea0001 resynchronize code repo with production ymh <ymh.work@gmail.com> parents: 5 diff changeset	1312	*/
cf61fcea0001 resynchronize code repo with production ymh <ymh.work@gmail.com> parents: 5 diff changeset	1313	function restore_current_locale() {
cf61fcea0001 resynchronize code repo with production ymh <ymh.work@gmail.com> parents: 5 diff changeset	1314	/* @var WP_Locale_Switcher $wp_locale_switcher */
cf61fcea0001 resynchronize code repo with production ymh <ymh.work@gmail.com> parents: 5 diff changeset	1315	global $wp_locale_switcher;
cf61fcea0001 resynchronize code repo with production ymh <ymh.work@gmail.com> parents: 5 diff changeset	1316
cf61fcea0001 resynchronize code repo with production ymh <ymh.work@gmail.com> parents: 5 diff changeset	1317	return $wp_locale_switcher->restore_current_locale();
cf61fcea0001 resynchronize code repo with production ymh <ymh.work@gmail.com> parents: 5 diff changeset	1318	}
cf61fcea0001 resynchronize code repo with production ymh <ymh.work@gmail.com> parents: 5 diff changeset	1319
cf61fcea0001 resynchronize code repo with production ymh <ymh.work@gmail.com> parents: 5 diff changeset	1320	/**
cf61fcea0001 resynchronize code repo with production ymh <ymh.work@gmail.com> parents: 5 diff changeset	1321	* Whether switch_to_locale() is in effect.
cf61fcea0001 resynchronize code repo with production ymh <ymh.work@gmail.com> parents: 5 diff changeset	1322	*
cf61fcea0001 resynchronize code repo with production ymh <ymh.work@gmail.com> parents: 5 diff changeset	1323	* @since 4.7.0
cf61fcea0001 resynchronize code repo with production ymh <ymh.work@gmail.com> parents: 5 diff changeset	1324	*
cf61fcea0001 resynchronize code repo with production ymh <ymh.work@gmail.com> parents: 5 diff changeset	1325	* @global WP_Locale_Switcher $wp_locale_switcher
cf61fcea0001 resynchronize code repo with production ymh <ymh.work@gmail.com> parents: 5 diff changeset	1326	*
cf61fcea0001 resynchronize code repo with production ymh <ymh.work@gmail.com> parents: 5 diff changeset	1327	* @return bool True if the locale has been switched, false otherwise.
cf61fcea0001 resynchronize code repo with production ymh <ymh.work@gmail.com> parents: 5 diff changeset	1328	*/
cf61fcea0001 resynchronize code repo with production ymh <ymh.work@gmail.com> parents: 5 diff changeset	1329	function is_locale_switched() {
cf61fcea0001 resynchronize code repo with production ymh <ymh.work@gmail.com> parents: 5 diff changeset	1330	/* @var WP_Locale_Switcher $wp_locale_switcher */
cf61fcea0001 resynchronize code repo with production ymh <ymh.work@gmail.com> parents: 5 diff changeset	1331	global $wp_locale_switcher;
cf61fcea0001 resynchronize code repo with production ymh <ymh.work@gmail.com> parents: 5 diff changeset	1332
cf61fcea0001 resynchronize code repo with production ymh <ymh.work@gmail.com> parents: 5 diff changeset	1333	return $wp_locale_switcher->is_switched();
cf61fcea0001 resynchronize code repo with production ymh <ymh.work@gmail.com> parents: 5 diff changeset	1334	}

author	ymh <ymh.work@gmail.com>
	Mon, 14 Oct 2019 17:39:30 +0200
changeset 7	cf61fcea0001
parent 5	5e2f62d02dcd
child 9	177826044cd9
permissions	-rw-r--r--