Avatar Tooltip

常見問題

Why does a tooltip show “No more info available”?

Because the avatar owner is registered neither to the blog nor to Gravatar.

I think some existing gravatars are missing or not shown…

We suggest that first of all you read the Gravatar FAQ.

I can see that the plugin files (css, javascript) are properly loaded in my theme, but tooltips are not shown yet… What’s wrong?

Probably the default jQuery selector (#main ...) is not good for your theme.
Look inside your theme html code and search for a class/id of your main content div: e.g. #content or something similar.
Then, go in Settings > Avatar Tooltip and set up the new selector.
This parent class is useful to avoid that the toolip is shown on undesired avatars (e.g. top Toolbar).

Can I customise the tooltip aspect?

In Settings > Avatar Tooltip you can set up main options (main css theme, position).
Then, you can edit axe-avatar-tooltip.css in plugin folder.
A tip: copy this file to your theme directory and edit it there. Useful to prevent the loss of styles when you upgrade the plugin.

I don’t care about Gravatar profile data. Can the tooltip show local user info?

You can use the sample available at this link: the tooltips will show the user bio (description), a link to user recent posts, the links to social network profiles (as filled in profile by user). Everything taken locallly from blog, nothing from Gravatar profile.

Can I customise the tooltip content text?

You have some available filter hooks to manage the tooltip text.

The following sample adds ugly debug info at the bottom of tooltip:

function my_avatar_tooltip_content_after( $text, $user, $md5email, $grav_name, $grav_profile ) {
    if ( is_object($user) ) {
        $text .= '<br />USERDATA:<br /><pre style="color:#000">'. print_r( $user, true ) .'</pre>';
    }
    if ( is_array($grav_profile) ) {
        $text .= '<br />GRAVATAR PROFILE:<br /><pre style="color:#000">'. print_r( $grav_profile, true . '</pre>');
    }   
    return $text;
}
add_filter('axe_avatar_tooltip_content_after', 'my_avatar_tooltip_content_after', 10, 5);

The following sample replaces the account list (facebook, twitter…) with a link to Gravatar full profile:

function my_avatar_tooltip_content_gravatar_accounts( $text, $md5email, $grav_profile ) {
    if ( isset( $grav_profile['profileUrl'] ) ) {
        return '<a href="'. esc_url($grav_profile['profileUrl']) .'" title="'. esc_attr( __('view complete profile on Gravatar', AXE_AT_PLUGIN_DIR) ) .'" target="_blank" rel="nofollow">' . __('view complete profile on Gravatar', AXE_AT_PLUGIN_DIR) .'</a>';
    } else {
        return $text;
    }
}
add_filter('axe_avatar_tooltip_content_gravatar_accounts', 'my_avatar_tooltip_content_gravatar_accounts', 10, 3);

You can look for more hooks inside plugin code.

If you are brave, the function that returns the tooltip text is pluggable and you can replace it at all:

1. create a php file in mu-plugins folder (if the folder does not exists, simply create it)
2. add a new function called axe_at_tooltip_content (look for the orginal function inside plugin code to see how it works)
3. from that moment, the plugin will load your custom function