Overview

The Gravatar module integrates Gravatar URL generation with HumHub profile image rendering and provides user and administrator configuration.

Main responsibilities

• GravatarService centralizes Gravatar URL generation and determines when Gravatar should be used.
• UserSettingsForm manages user-level Gravatar preferences.
• The administrator configuration form manages network-wide defaults and controls which user preferences are available.
• The custom user image widget integrates Gravatar selection into HumHub profile image rendering.
• The profile image helper provides reusable methods for resolving Gravatar and profile image URLs.

Configuration behavior

Network-wide settings determine whether Gravatar is enabled, the default image style, the maximum rating, and which user preferences are permitted.

User settings must not override administrator restrictions. A user's selected rating must remain within the network-wide maximum.

When the preference to use Gravatar over an uploaded HumHub image is permitted and enabled, the Gravatar-aware rendering path must select Gravatar before falling back to the uploaded image.

Compatibility

The module targets HumHub 1.19+ and PHP 8.2+.

When changing the image integration, verify that normal HumHub image behavior remains intact, including links, tooltips, online status indicators, and the uploaded-image fallback.

Testing checklist

• Verify Gravatar fallback when no custom HumHub image exists.
• Verify the uploaded HumHub image is used when Gravatar is disabled.
• Verify the preference to use Gravatar over an uploaded image.
• Verify each administrator setting affects actual rendering behavior.
• Verify user settings cannot override administrator restrictions.
• Verify profile image links, tooltips, and online status indicators.