One User Avatar 2.5.6 has 16 actions and 21 filters, read directly from its source code on Nov 17, 2026. The list updates automatically when a new version is released.
How to use these hooks
Actions let you run your own code at a specific moment. Filters let you change a value before the plugin uses it. Put your code in a child theme's functions.php or a code-snippets plugin, never in the plugin's own files, because updates overwrite them.
// Run your own code when One User Avatar fires an action
add_action( 'admin_enqueue_scripts', function( $hook_suffix ) {
// Your code runs here.
}, 10, 1 );
// Change a value One User Avatar is about to use
add_filter( 'get_wp_user_avatar', function( $avatar, $id_or_email, $size, $align, $alt ) {
// Change $avatar here.
return $avatar;
}, 10, 5 );Parts of a name in {braces} are filled in at runtime (for example a post type or field ID). Choose Example on any hook for a ready-to-edit snippet.
All hooks
-
admin_enqueue_scripts
action/** * Enqueue scripts. */ do_action( 'admin_enqueue_scripts', $hook_suffix ); -
admin_head
action/** * Fires in head section for all admin pages. */ do_action( 'admin_head' ); -
admin_head-{$hook_suffix}
action/** * Fires in head section for this specific admin page. */ do_action( "admin_head-{$hook_suffix}" ); -
admin_print_scripts
action/** * Fires when scripts are printed for all admin pages. */ do_action( 'admin_print_scripts' ); -
/** * Fires when scripts are printed for this specific page based on $hook_suffix. */ do_action( "admin_print_scripts-{$hook_suffix}" ); -
admin_print_styles
action/** * Fires when styles are printed for all admin pages. */ do_action( 'admin_print_styles' ); -
/** * Fires when styles are printed for this specific page based on $hook_suffix. */ do_action( "admin_print_styles-{$hook_suffix}" ); -
get_wp_user_avatar
filter/** * Filter get_wp_user_avatar */ apply_filters( 'get_wp_user_avatar', $avatar, $id_or_email, $size, $align, $alt ); -
wpua_add_media_state
filter/** * Filter media states */ apply_filters( 'wpua_add_media_state', $states ); -
wpua_attachment_is_image
filter/** * Filter local image check */ apply_filters( 'wpua_attachment_is_image', $is_image, $attachment_id ); -
wpua_before_settings
filter/** * Filter settings at beginning of table */ apply_filters( 'wpua_before_settings', $wpua_before_settings ); -
wpua_get_attachment_image
filter/** * Filter local image tag */ apply_filters( 'wpua_get_attachment_image', $image, $attachment_id, $size, $icon, $attr ); -
/** * Filter local image src */ apply_filters( 'wpua_get_attachment_image_src', $image_src_array, $attachment_id, $size, $icon ); -
wpua_get_avatar_filter
filter/** * Filter get_avatar filter */ apply_filters( 'wpua_get_avatar_filter', $avatar, $id_or_email, $size, $default, $alt ); -
wpua_get_avatar_filter_url
filter/** * Filter get_avatar_url filter */ apply_filters( 'wpua_get_avatar_filter_url', $url, $id_or_email ); -
wpua_get_avatar_original
filter/** * Filter original avatar src */ apply_filters( 'wpua_get_avatar_original', $default ); -
wpua_is_author_or_above
filter/** * Filter Author privilege check */ apply_filters( 'wpua_is_author_or_above', $is_author_or_above ); -
wpua_options_page_title
filter/** * Filter admin page title */ apply_filters( 'wpua_options_page_title', $wpua_options_page_title ); -
wpua_profile_title
filter/** * Filter profile title */ apply_filters( 'wpua_profile_title', $wpua_profile_title ); -
wpua_register_settings
filter/** * Filter admin whitelist settings */ apply_filters( 'wpua_register_settings', $settings ); -
wpua_settings
filter/** * Filter main settings */ apply_filters( 'wpua_settings', $wpua_settings ); -
wpua_subscriber_settings
filter/** * Filter Subscriber settings */ apply_filters( 'wpua_subscriber_settings', $wpua_subscriber_settings ); -
wpua_default_alt_tag
filterapply_filters( 'wpua_default_alt_tag', esc_html__( 'Avatar', 'one-user-avatar' ) ); -
avatar_defaults
filterapply_filters( 'avatar_defaults', $avatar_defaults ); -
run_wpua_resource_manager
filterapply_filters( 'run_wpua_resource_manager', $this->valid_request ); -
widget_text
filterapply_filters( 'widget_text', empty( $instance['text'] ) ? '' : $instance['text'], $instance ); -
widget_title
filterapply_filters( 'widget_title', empty( $instance['title'] ) ? '' : $instance['title'], $instance, $this->id_base ); -
wpua_after_avatar
actiondo_action( 'wpua_after_avatar' ); -
wpua_after_avatar_admin
actiondo_action( 'wpua_after_avatar_admin' ); -
wpua_after_avatar{$is_admin}
actiondo_action( "wpua_after_avatar{$is_admin}" ); -
wpua_before_avatar
actiondo_action( 'wpua_before_avatar' ); -
wpua_before_avatar_admin
actiondo_action( 'wpua_before_avatar_admin' ); -
do_action( "wpua_before_avatar{$is_admin}" ); -
wpua_show_profile
actiondo_action( 'wpua_show_profile', $user ); -
wpua_update
actiondo_action( 'wpua_update', $valid_user->ID ); -
wpua_update_errors
actiondo_action_ref_array( 'wpua_update_errors', array( &$errors, $update, &$user ) ); -
wpua_widget_instance
filterapply_filters( 'wpua_widget_instance', $instance );
Generated from One User Avatar's GPL-licensed source code. Hooks inside bundled third-party libraries are not listed.
Can't find the right hook?
We can build the customisation for you. Describe what you need: