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 or null if none was provided.
 *
 * @return string[]
 */
function wp_kama_user_contactmethods_filter( $methods, $user ){

	// filter...
	return $methods;
}
$methods(массив)
Массив контактных данных и их названий.
$user(WP_User)
Объект редактируемого пользователя.

Примеры

2

#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
wp-includes/user.php 2795
return apply_filters( 'user_contactmethods', $methods, $user );

Где используется хук в WordPress

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