user_contactmethods │ хук-фільтр │ WP 2.9.0

Дозволяє змінити додаткові контактні дані користувача.

У цей фільтр не потрапляють поля emailта сайт.

До версії 3.6 у цьому фільтрі можна було видалити або змінити контактні дані, задані за замовчуванням ( AIM, Yahoo IM, Jabber / Google Talk ). З версії 3.6 ці методи зв’язку відключені.

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

add_filter( 'user_contactmethods', 'wp_kama_user_contactmethods_filter', 10, 2);

/**
 * Function for `user_contactmethods` filter-hook.
 *
 * @param string[] $methods Array of contact method labels keyed by contact method.
 * @param WP_User|null $user WP_User object або null if none was provided.
 *
 * @return string[]
 */
function wp_kama_user_contactmethods_filter( $methods, $user ){

	// Filter...
	return $methods;
}

$methods (масив): Масив контактних даних та їх назв.
$user (WP_User): Об’єкт редагованого користувача.

Приклади

#1 Додамо додаткові контактні дані для всіх користувачів

add_filter( 'user_contactmethods', 'add_user_contact_method' );

function add_user_contact_method( $method ) {

	$custom_contact = [
		'facebook' => __( 'Facebook' ),
		'twitter' => __( 'Twitter' ),
		'whatsapp' => __( 'WhatsApp' ),
	];

	$method = array_merge( $method, $custom_contact );

	return $method;

}

список змін

З версії 2.9.0

Введено.

Де викликається хук

wp_get_user_contact_methods()

user_contactmethods

return apply_filters( 'user_contactmethods', $methods, $user );

Де використовується хук у WordPress

Використання не знайдено.