useravatar

• UserAvatarMacroParameters, xwiki-platform: username is a mandatory String shown with the UserReference picker, width and height are Integers with no default and no constraint.
• ReleaseSheetHeader, xwiki-platform: the only use of the macro in the XWiki pages, {{useravatar username="..." width="100"/}} for the release manager.
• XWIKI-17347: the user picker of the username field, added in XWiki 12.5.

C1, minor: "The image's height" does not give the unit, pixels, nor that an empty value keeps the height of the uploaded picture. The English name is the parameter ID "height", which the dialog shows capitalized.

C3, minor: the field opens empty, which stands for the height of the uploaded picture, a value the dialog does not show and that depends on each user's upload: an avatar of 300 by 200 pixels shows at that size. Every use sets a size, 40 in the documentation examples and a width of 100 in the release sheet of XWiki Standard, but no single value is used in most cases.

C4: a plain text field for a number of pixels.

C6: Height comes first in the Optional parameters tab, both are set in the most common example.

C8: not marked as advanced, and set in the most common example.

C9: set in the documentation examples.

C13: a number, typed Integer, with no declared range, while only a positive number of pixels makes sense: height="abc" or height="50%" can be typed in the text field and is rendered as height="0", and height="-5" is output as is, see E2.

C1: "The name of the user whose avatar is to be displayed" says what to give. The English name is the parameter ID "username", which the dialog shows capitalized as "Username".

C2: mandatory with no default, which is right: the user is the whole purpose of the macro.

C4: a user picker. Searching "John", "Doe" or "johndoe" lists John Doe with their avatar, "Adm" lists Administrator, and picking a user writes username="XWiki.JohnDoe" . Opening the dialog of an existing macro shows the selected user.

C5: three fields, Username outside any group and Height and Width in the Optional parameters tab.

C6: Username, set in the most common example, comes first.

C13: N/A, the accepted values are the users of the wiki, picked from a list.

C1, minor: "The image's width" does not give the unit, pixels, nor that an empty value keeps the width of the uploaded picture. The English name is the parameter ID "width", which the dialog shows capitalized.

C3, minor: the field opens empty, which stands for the width of the uploaded picture, a value the dialog does not show and that depends on each user's upload: an avatar of 300 by 200 pixels shows at that size. Every use sets a size, 40 in the documentation examples and a width of 100 in the release sheet of XWiki Standard, but no single value is used in most cases.

C4: a plain text field for a number of pixels.

C6: Width comes after Height in the Optional parameters tab, since neither declares an order: both are set in the most common example and only two fields are in the tab, so it is easy to reach. The only use in XWiki pages, the release sheet, sets width only.

C8: not marked as advanced, and set in the most common example.

C9: set in the documentation examples.

C13: a number, typed Integer, with no declared range, while only a positive number of pixels makes sense: width="abc" , width="50%" or width="40px" can be typed in the text field and is rendered as width="0", and width="-5" is output as is, see E2.