user_contactmethods
Позволяет изменить дополнительные контактные данные пользователя.
В этот фильтр не попадают поля 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)
- Объект редактируемого пользователя.
Примеры
#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 | Введена. |
Где вызывается хук
user_contactmethods
wp-includes/user.php 2795
return apply_filters( 'user_contactmethods', $methods, $user );
