The source attribute in [molongui_author_avatar] lets you control which avatar source Molongui Authorship Pro should use.
This is useful when you want a shortcode to behave differently from the normal avatar resolution used elsewhere on your site.
Available source values
The source attribute accepts the following values:
auto— Use the normal Molongui Authorship avatar resolution.local— Prefer the locally uploaded avatar.gravatar— Prefer the Gravatar associated with the author’s email address.acronym— Display an acronym generated from the author’s name.
Use automatic avatar resolution
Use source="auto" when you want Molongui Authorship to choose the avatar according to your global settings:
[molongui_author_avatar source="auto"]With Local Avatars, Gravatar, and the Custom Default Avatar enabled, the normal resolution is:
Local Avatar → Gravatar → Custom Default Avatar
If the Custom Default Avatar is disabled while Gravatar is enabled, the WordPress Default Avatar can be used instead.
Prefer the Local Avatar
Use source="local" to make the locally uploaded avatar the preferred source:
[molongui_author_avatar source="local"]If no Local Avatar is available, Molongui Authorship can continue to the configured fallback.
For example:
[molongui_author_avatar source="local" default="acronym"]This uses the Local Avatar when available and displays an acronym otherwise.
Prefer Gravatar
Use source="gravatar" when you want to request the author’s Gravatar first:
[molongui_author_avatar source="gravatar"]If the author does not have a Gravatar, Molongui Authorship uses the appropriate fallback according to the shortcode and your global avatar settings.
For example:
[molongui_author_avatar source="gravatar" default="acronym"]This displays the author’s Gravatar when available and an acronym otherwise.
To display nothing when no Gravatar is available:
[molongui_author_avatar source="gravatar" default="none"]Display an acronym directly
Use source="acronym" when you want to display an acronym instead of an image:
[molongui_author_avatar source="acronym"]This bypasses Local Avatar and Gravatar selection and displays the generated acronym directly.
Global avatar settings still apply
The settings under Authors > Settings > General act as global master switches.
For example:
- If Local Avatars are disabled globally,
source="local"cannot force Molongui Authorship to use them. - If Gravatar is disabled globally,
source="gravatar"cannot re-enable Gravatar requests.
The shortcode can choose how enabled avatar sources are used, but it cannot override a source that has been disabled globally.
What happens if you omit the source attribute?
The source attribute is optional.
[molongui_author_avatar]Shortcodes without an explicit source keep the existing legacy behavior for backward compatibility.
If you want the shortcode to use the new global avatar resolution explicitly, use:
[molongui_author_avatar source="auto"]