One User Avatar icon
Membership & Users

One User Avatar hooks reference

  • By One Designs
  • v2.5.6
  • Updated

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.

functions.phpyour child theme
// 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

  • includes/wpua-tinymce-window.php line 42
    /**
     * Enqueue scripts.
     */
    do_action( 'admin_enqueue_scripts', $hook_suffix );
  • admin_head

    action
    includes/wpua-tinymce-window.php line 87
    /**
     * Fires in head section for all admin pages.
     */
    do_action( 'admin_head' );
  • includes/wpua-tinymce-window.php line 80
    /**
     * Fires in head section for this specific admin page.
     */
    do_action( "admin_head-{$hook_suffix}" );
  • includes/wpua-tinymce-window.php line 70
    /**
     * Fires when scripts are printed for all admin pages.
     */
    do_action( 'admin_print_scripts' );
  • includes/wpua-tinymce-window.php line 63
    /**
     * Fires when scripts are printed for this specific page based on $hook_suffix.
     */
    do_action( "admin_print_scripts-{$hook_suffix}" );
  • includes/wpua-tinymce-window.php line 56
    /**
     * Fires when styles are printed for all admin pages.
     */
    do_action( 'admin_print_styles' );
  • includes/wpua-tinymce-window.php line 49
    /**
     * Fires when styles are printed for this specific page based on $hook_suffix.
     */
    do_action( "admin_print_styles-{$hook_suffix}" );
  • includes/class-wp-user-avatar-functions.php line 961
    /**
     * Filter get_wp_user_avatar
     */
    apply_filters( 'get_wp_user_avatar', $avatar, $id_or_email, $size, $align, $alt );
  • includes/class-wp-user-avatar-admin.php line 579
    /**
     * Filter media states
     */
    apply_filters( 'wpua_add_media_state', $states );
  • includes/class-wp-user-avatar-functions.php line 368
    /**
     * Filter local image check
     */
    apply_filters( 'wpua_attachment_is_image', $is_image, $attachment_id );
  • includes/wpua-options-page.php line 122
    /**
     * Filter settings at beginning of table
     */
    apply_filters( 'wpua_before_settings', $wpua_before_settings );
  • includes/class-wp-user-avatar-functions.php line 401
    /**
     * Filter local image tag
     */
    apply_filters( 'wpua_get_attachment_image', $image, $attachment_id, $size, $icon, $attr );
  • includes/class-wp-user-avatar-functions.php line 425
    /**
     * Filter local image src
     */
    apply_filters( 'wpua_get_attachment_image_src', $image_src_array, $attachment_id, $size, $icon );
  • includes/class-wp-user-avatar-functions.php line 673
    /**
     * Filter get_avatar filter
     */
    apply_filters( 'wpua_get_avatar_filter', $avatar, $id_or_email, $size, $default, $alt );
  • includes/class-wp-user-avatar-functions.php line 92
    /**
     * Filter get_avatar_url filter
     */
    apply_filters( 'wpua_get_avatar_filter_url', $url, $id_or_email );
  • includes/class-wp-user-avatar-functions.php line 755
    /**
     * Filter original avatar src
     */
    apply_filters( 'wpua_get_avatar_original', $default );
  • includes/class-wp-user-avatar.php line 702
    /**
     * Filter Author privilege check
     */
    apply_filters( 'wpua_is_author_or_above', $is_author_or_above );
  • includes/wpua-options-page.php line 74
    /**
     * Filter admin page title
     */
    apply_filters( 'wpua_options_page_title', $wpua_options_page_title );
  • includes/wpua-functions.php line 100
    /**
     * Filter profile title
     */
    apply_filters( 'wpua_profile_title', $wpua_profile_title );
  • includes/class-wp-user-avatar-admin.php line 327
    /**
     * Filter admin whitelist settings
     */
    apply_filters( 'wpua_register_settings', $settings );
  • wpua_settings

    filter
    includes/wpua-options-page.php line 199
    /**
     * Filter main settings
     */
    apply_filters( 'wpua_settings', $wpua_settings );
  • includes/wpua-options-page.php line 298
    /**
     * Filter Subscriber settings
     */
    apply_filters( 'wpua_subscriber_settings', $wpua_subscriber_settings );
  • includes/class-wp-user-avatar-functions.php line 581 · used in 2 places
    apply_filters( 'wpua_default_alt_tag', esc_html__( 'Avatar', 'one-user-avatar' ) );
  • includes/class-wp-user-avatar-admin.php line 371
    apply_filters( 'avatar_defaults', $avatar_defaults );
  • includes/class-wp-user-avatar-resource-manager.php line 93
    apply_filters( 'run_wpua_resource_manager', $this->valid_request );
  • widget_text

    filter
    includes/class-wp-user-avatar-widget.php line 57
    apply_filters( 'widget_text', empty( $instance['text'] ) ? '' : $instance['text'], $instance );
  • widget_title

    filter
    includes/class-wp-user-avatar-widget.php line 56
    apply_filters( 'widget_title', empty( $instance['title'] ) ? '' : $instance['title'], $instance, $this->id_base );
  • includes/wpua-functions.php line 82
    do_action( 'wpua_after_avatar' );
  • includes/wpua-functions.php line 177
    do_action( 'wpua_after_avatar_admin' );
  • includes/class-wp-user-avatar.php line 357
    do_action( "wpua_after_avatar{$is_admin}" );
  • includes/wpua-functions.php line 73
    do_action( 'wpua_before_avatar' );
  • includes/wpua-functions.php line 168
    do_action( 'wpua_before_avatar_admin' );
  • includes/class-wp-user-avatar.php line 353
    do_action( "wpua_before_avatar{$is_admin}" );
  • includes/class-wp-user-avatar-shortcode.php line 301
    do_action( 'wpua_show_profile', $user );
  • wpua_update

    action
    includes/class-wp-user-avatar-shortcode.php line 249
    do_action( 'wpua_update', $valid_user->ID );
  • includes/class-wp-user-avatar-shortcode.php line 189
    do_action_ref_array( 'wpua_update_errors', array( &$errors, $update, &$user ) );
  • includes/class-wp-user-avatar-widget.php line 55
    apply_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: