ngettext │ хук-фільтр │ WP 2.2.0

Дозволяє змінити перекладений функцією _n() рядок.

Такий рядок використовується для написів, які залежать від попереду числа, що стоїть, наприклад: 1 персик, 2 персика, 10 персиків.

Це фільтр функції _n() .

Використання

add_filter( 'ngettext', 'wp_kama_ngettext_filter', 10, 5);

/**
 * Function for `ngettext` filter-hook.
 *
 * @param string $translation Translated text.
 * @param string $single Цей текст буде використаний, якщо номер є особливим.
 * @param string $plural Цей текст буде використаний, якщо номер є plural.
 * @param string $number Число для compare до використання будь-якої singular або plural form.
 * @param string $domain Text domain. Unique identifier for retrieving translated strings.
 *
 * @return string
 */
function wp_kama_ngettext_filter( $translation, $single, $plural, $number, $domain ){

	// Filter...
	return $translation;
}

$translation (рядок): Перекладений текст.
$single (рядок): Оригінальний текст для однини.
$plural (рядок): Оригінальний текст для множини.
$number (рядок): Число, за яким вибирається рядок для перекладу.
$domain (рядок): Ідентифікатор перекладу, який вказується у функціях перекладу. За ним завантажується файл перекладу
.mo .

Приклади

#1 Замінимо слово `items` на `elements` у блоці пагінації таблиці `WP_List_Table` в адмінці

Переклад рядка items у блоці пагінації у таблиці адмінки

## Replace `items` name in wp_list_table pagination box
add_filter( 'ngettext', 'change_wp_list_table_pagination_item_name', 10, 5);
function change_wp_list_table_pagination_item_name( $translation, $single, $plural, $number, $domain ) {

	if ( $domain === 'default' && in_array( $translation, ['%s item', '%s items'] ) ) {
		return str_replace( '%s item', '%s element', $translation );
	}

	return $translation;
}