`AvatarManager`

\Benecaster\Avatar\AvatarManager

Class Free

Manages subscriber avatar storage and output. Hooks into WordPress’s avatar system (get_avatar_url, get_avatar) and BuddyPress (bp_get_user_avatar) to substitute uploaded subscriber avatars for the default Gravatar or WordPress fallback. Falls through to the original value untouched when the subscriber has no avatar, avatars are disabled site-wide, or the user is not a subscriber.

Registered via AvatarManager::register() during plugin init. Third-party code should use the class helpers rather than reading the underlying user meta directly. Short-circuits entirely when the benecaster_avatars_enabled option is '0'.

Methods

Method	Visibility	Since	Description
`get_attachment_id( int $user_id ): int`	Public	—	Returns the attachment ID from _benecaster_avatar_attachment_id user meta, or 0 if the meta is absent or the referenced attachment has been deleted. Handles stale meta transparently.
`get_url( int $user_id ): ?string`	Public	—	Returns the URL for the subscriber's avatar, or null if no avatar is set or the attachment is missing.
`resolve_user_id( mixed $id_or_email ): int`	Public	—	Normalizes the first argument accepted by WordPress's get_avatar() family into a WP user ID. Accepts int, WP_User, WP_Post, WP_Comment, or email string. Returns 0 when resolution fails.

Constants

Name	Value	Description
`META_KEY`	`'_benecaster_avatar_attachment_id'`	WordPress user meta key where the attachment ID of the subscriber's current avatar is stored.

Name	Set by	What it does	Kept for
`wordpress_logged_in_*`	Benecaster	Keeps you signed in to your Benecaster account.	Until you sign out, or two weeks with "Remember Me".
`wordpress_sec_*`	Benecaster	Secures your signed-in session over HTTPS.	Until you sign out, or two weeks with "Remember Me".
`wp-settings-*`	Benecaster	Remembers your admin screen preferences.	One year.
`benecaster_ls_purchase_sign_in`	Benecaster	Signs you in to your new account on the page you bought from, once your purchase has gone through.	Thirty minutes, or until you are signed in.
`benecaster_ls_cookie_consent`	Benecaster	Remembers the choice you make on this banner, so we do not ask again.	One year.

Name	Set by	What it does	Kept for
`__stripe_mid`	Stripe	Lets Stripe recognise the device across payment attempts to detect card fraud.	One year.
`__stripe_sid`	Stripe	The same fraud check, for the current visit only.	Thirty minutes.