Avataurus

Avataurus for WordPress — deterministic face avatars for every user

by Mladen Ruzicic · github.com/ruzicic/avataurus-wp · website

★ 0stars

Install

Download source zip No release zip yet

This is the repository archive. It installs, but the folder name will carry the branch suffix and updates will not flow.

Install straight from GitHub with WP-CLI:

wp plugin install https://github.com/ruzicic/avataurus-wp/archive/refs/heads/master.zip

No built-in updater. New versions won't appear under Dashboard → Updates. Install new releases yourself, or let Git Updater track the repository.

Readme github.com/ruzicic/avataurus-wp ↗

Avataurus for WordPress

Replace default WordPress avatars with unique, deterministic face avatars.

How It Works

Each user's email address deterministically produces a unique avatar with distinct eyes, mouth, and background color. Same email, same face, every time.

Install

Upload the avataurus folder to /wp-content/plugins/
Activate the plugin
Go to Settings > Discussion > Default Avatar
Select Avataurus (Face) or Avataurus (Initial)

Features

Zero config — activate and go
Respects Gravatars — real Gravatar profile pictures are preserved
Deterministic — same email = same avatar, always
Fast — served from Cloudflare's edge (200+ locations)
Privacy-friendly — no tracking, no cookies, no data collection
Clean uninstall — removes all traces when deactivated

Filters

// Change the variant per context
add_filter( 'avataurus_variant', function( $variant, $id_or_email ) {
    // Use initials in admin, faces on frontend
    return is_admin() ? 'initial' : 'face';
}, 10, 2 );

// Modify the seed
add_filter( 'avataurus_seed', function( $seed, $id_or_email ) {
    return $seed;
}, 10, 2 );

// Modify the full avatar URL
add_filter( 'avataurus_avatar_url', function( $url, $id_or_email, $args ) {
    return $url;
}, 10, 3 );

License

GPL-2.0-or-later — as required for WordPress.org plugins.