Este plugin não foi testado com as 3 últimas grandes versões do WordPress. Pode já não ser suportado e pode ter problemas de compatibilidade quando usado com versões mais recentes do WordPress.

Avatar Tooltip

Descrição

You can enable a tooltip that shows info about user/author when you rollover/click on related avatar.

Let’s speak clearly: if you are loooking for a plugin that enables the standard Gravatar hovercards, this is not the plugin right for you. Please look for another one.

When you rollover/click on an avatar (e.g. of a comment author), a tooltip popups and shows:

  • some additional links if the author is a registered user: e.g. to user post archive, to user external website, to user blog (if multisite)
  • some info from Gravatar if author is registered to that service: e.g. location, “about me” description, websites, other account pages (facebook, twitter….)

In plugin settings you can set up the javascript and css main options.

The plugin comes with some filter hooks, so you can customise the tooltip content at all.

The plugin uses qTip plugin for jQuery.

Ecrãs

  • Tooltip of a user registered to blog and registered to Gravatar
  • Tooltip of a user not registered to blog but registered to Gravatar
  • Tooltip of a user registered to blog but not registered to Gravatar

Instalação

INSTALLATION

  1. Upload plugin directory to the /wp-content/plugins/ directory
  2. Activate the plugin through the Plugins menu in WordPress

SETUP

  1. Go to Settings > Avatar Tooltip to set up options
  2. Edit axe-avatar-tooltip.css to customise tooltip styles

Perguntas frequentes

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

Avaliações

Ler 1 avaliação

Contribuidores e programadores

“Avatar Tooltip” é software de código aberto. As seguintes pessoas contribuíram para este plugin:

Contribuidores

Registo de alterações

1.0.2

  • Updated: for a better integration with other plugins the get_avatar filter priority was increased to be sure that the [rel] attribute is added after other filters

1.0.1

  • Fixed: bug about not showing tooltip content for not-logged user

1.0

  • Initial release