Make WordPress Core

Opened 9 years ago

Closed 2 years ago

Last modified 2 years ago

#32998 closed enhancement (fixed)

What's a weblog?

Reported by: johnjamesjacoby's profile johnjamesjacoby Owned by: audrasjb's profile audrasjb
Milestone: 6.0 Priority: low
Severity: minor Version:
Component: Options, Meta APIs Keywords: has-patch commit has-copy-review assigned-for-commit
Focuses: ui-copy Cc:

Description

Just kidding. Kind of.

In options-discussion.php is a string which seems just out-of-date enough to warrant a refresh:

An avatar is an image that follows you from weblog to weblog appearing beside your name when you comment on avatar enabled sites. Here you can enable the display of avatars for people who comment on your site.

Attachments (4)

32998.01.patch (841 bytes) - added by johnjamesjacoby 9 years ago.
First pass recommendation, attempting to be considerate of third party functionality
32998.2.patch (957 bytes) - added by sabernhardt 3 years ago.
32998.diff (783 bytes) - added by peterwilsoncc 2 years ago.
Capture d’écran 2022-03-28 à 12.21.58.png (190.3 KB) - added by audrasjb 2 years ago.
Testing the above PR

Download all attachments as: .zip

Change History (28)

@johnjamesjacoby
9 years ago

First pass recommendation, attempting to be considerate of third party functionality

#1 @johnjamesjacoby
9 years ago

This is somewhat related to #31168. We can now be a bit more explicit about where administrators can expect to most likely see avatars, as they are no longer enabled on pages by default.

#2 @johnjamesjacoby
9 years ago

To save a click & grok, my grammatically deficient recommended updated text is:

An avatar is an image that follows you from website to website, often appearing beside your name in comments and blog posts. Here you can enable the display of avatars for registered users and other visitors who interact with this site.

#3 follow-up: @helen
9 years ago

I don't think it's accurate to say that an avatar (as opposed to gravatar) is something that follow you from website to website, also that fragment is pretty creepy. Never noticed it before.

#4 in reply to: ↑ 3 @johnjamesjacoby
9 years ago

Replying to helen:

I don't think it's accurate to say that an avatar (as opposed to gravatar) is something that follow you from website to website, also that fragment is pretty creepy. Never noticed it before.

I agree that it could be perceived as a bit spooky sounding, especially if someone is truly unfamiliar with avatars and Gravatar, which this message seems to be geared towards educating.

Because WordPress core does not allow registered users to upload their own avatars without the use of a plugin, and because get_avatar() attempts to find a Gravatar by default always, it's not an inaccurate statement even if the reality of it is creepy.

This string did originally make mention of Gravatar.com, but if my memory of the IRC logs from 2008 serves me right, it was altered to eliminate the jargon & confusion, and simultaneously remove the direct link to Gravatar.com which ultimately results in sign-ups to Automattic's WordPress.com product.

In BuddyPress, we moved away from the word "avatar" on anything that's user-facing, and switched to "photo" instead. We decided "Profile photo" and "Group photo" were more universally understood than expecting a developer or site administrator to explain to a client or community of users what an "avatar" was and why they shouldn't be afraid of it. I don't expect WordPress to go in this extreme of a direction, but figured it was pertinent information.

WordPress could also just eliminate this bit of helper text entirely, or tuck it up into the hidden "Help" section for someone to go stumble into if we're looking for a more elaborate solution (which I'm happy to patch up if that's the direction we think is the most agreeable.)

#5 @netweb
9 years ago

Suggestions attempting to removing the word follow for less creepiness:

  • An avatar is an image attached to your user profile that can be shared from website to website...
  • An avatar is an image attached to your user profile that is shared between websites...
  • An avatar is a user profile image shared between websites...

#6 @GaryJ
8 years ago

An avatar is a visual at-a-glance representation of you, across different websites.
or
An avatar is a visual representation of you, across different websites.

Two key words here:

  • "visual" - we may support screen readers, but the raison d'etre is that it's a graphical instance.
  • "representation" - it doesn't have to be a photo, or any likeness of a person - it could be a company logo - so don't focus on what may or may not in the avatar, but what it stands for - it represents (typically) a single person.

I'm not keen on the "follows", or "shared between websites" - the websites don't share it amongst themselves.

#7 @garrett-eclipse
4 years ago

  • Component changed from Text Changes to Options, Meta APIs
  • Focuses ui-copy added

@sabernhardt
3 years ago

#8 @sabernhardt
3 years ago

  • Keywords has-patch needs-copy-review added
  • Milestone set to Future Release

I blended the second option from comment:6 into what was in the first patch.

An avatar is a visual representation of you, across different websites, often appearing beside your name in comments and blog posts. Here, you can enable the display of avatars for registered users and other visitors who interact with this site.

Another option could include "An avatar is an image that represents you..."

#9 @sabernhardt
3 years ago

  • Milestone changed from Future Release to 6.0

#10 follow-up: @costdev
2 years ago

Throwing my two cents in: I think this is both specific and broad enough to be fit for purpose.

An avatar is an image that can be associated with a user across multiple websites. Here, you can enable the display of avatars for users who interact with this site.

  • "image":
    • Implies "visual". ✅
    • Could be a photo. ✅
    • Could be a logo. ✅
    • Could be a cat. 😸
    • "visual representation" could mean an animated character - Think game console profiles.
    • In my experience, "visual representation" is not accessible language, and often needs further, specific explanation.
    • "image", on the other hand, is widely understood, second only to something like "pic" in English.
  • "can be"
    • Acknowledges that the user may not use it on other websites. ✅
      • The avatar is associated with an email address that the user may only use on this website.
      • The site owner doesn't need to know that it's associated with the user's email address.
    • Acknowledges that other websites used by the user may not have avatars enabled. ✅
    • Acknowledges Gravatar's copy: "You choose what to display on Gravatar-enabled sites: what you share on your profile is open to the world." ✅
  • "associated":
    • Accounts for an avatar that represents the user. ✅
    • Accounts for an avatar that represents the user's group (company, department, gaming clan). ✅
    • Accounts for an avatar that represents nothing. ✅
    • Accounts for default avatars. ✅
  • "users who interact with this site"
    • Does not differentiate between registered users and other visitors. ❓ - Is this correct?
    • Does not assume the species of the user. ✅
      • Democratising publishing means we welcome our inter-galactic visitors. 👽
  • Does not presume to know where the avatar will be used on the website. ✅
Last edited 2 years ago by costdev (previous) (diff)

#11 @audrasjb
2 years ago

Speaking as a fr_FR GTE, the new string works for me in terms of i18n 👍

#12 in reply to: ↑ 10 @webcommsat
2 years ago

I would make two further suggestions to avoid the word 'here' which can cause confusion for accessibility and expectation.

From my understanding of what will happen, suggest revising the text to:
'In this area [use name if it has one], you can choose to display avatars of users who interact with the site.'

Replying to costdev:

Throwing my two cents in: I think this is both specific and broad enough to be fit for purpose.

An avatar is an image that can be associated with a user across multiple websites. Here, you can enable the display of avatars for users who interact with this site.

  • "image":
    • Implies "visual". ✅
    • Could be a photo. ✅
    • Could be a logo. ✅
    • Could be a cat. 😸
    • "visual representation" could mean an animated character - Think game console profiles.
    • In my experience, "visual representation" is not accessible language, and often needs further, specific explanation.
    • "image", on the other hand, is widely understood, second only to something like "pic" in English.
  • "can be"
    • Acknowledges that the user may not use it on other websites. ✅
      • The avatar is associated with an email address that the user may only use on this website.
      • The site owner doesn't need to know that it's associated with the user's email address.
    • Acknowledges that other websites used by the user may not have avatars enabled. ✅
    • Acknowledges Gravatar's copy: "You choose what to display on Gravatar-enabled sites: what you share on your profile is open to the world." ✅
  • "associated":
    • Accounts for an avatar that represents the user. ✅
    • Accounts for an avatar that represents the user's group (company, department, gaming clan). ✅
    • Accounts for an avatar that represents nothing. ✅
    • Accounts for default avatars. ✅
  • "users who interact with this site"
    • Does not differentiate between registered users and other visitors. ❓ - Is this correct?
    • Does not assume the species of the user. ✅
      • Democratising publishing means we welcome our inter-galactic visitors. 👽
  • Does not presume to know where the avatar will be used on the website. ✅
Version 0, edited 2 years ago by webcommsat (next)

@peterwilsoncc
2 years ago

#13 @peterwilsoncc
2 years ago

In 32998.diff : Minimal text per @webcommsat's suggestion above.

#14 @audrasjb
2 years ago

  • Keywords commit added; needs-copy-review removed

The new description looks good to me, thanks for refreshing it to implement the suggested copy changes @peterwilsoncc.
Self assigning for commit.

#15 @audrasjb
2 years ago

  • Keywords assigned-for-commit added

#16 @webcommsat
2 years ago

@audrasjb and @peterwilsoncc thanks for the replies.
My suggested text was to add to the previous comment, that is, to replace the second sentence from @costdev. I would suggest using @costdev first sentence too. 'An avatar is an image that can be associated with a user across multiple websites.'

So the completed text change would be:
'An avatar is an image that can be associated with a user across multiple websites. In this area, you can choose to display avatars of users who interact with the site.'

Apologies for any extra work that causes.

#17 @audrasjb
2 years ago

  • Keywords needs-refresh added; commit assigned-for-commit removed

Alright, let's remove this from the commit list for now.

This ticket was mentioned in PR #2467 on WordPress/wordpress-develop by audrasjb.


2 years ago
#18

  • Keywords needs-refresh removed

#19 @audrasjb
2 years ago

  • Keywords needs-copy-review added

@webcommsat could you please proof read the above PR?

@audrasjb
2 years ago

Testing the above PR

#21 @webcommsat
2 years ago

Thank you @audrasjb - that looks fine and incorporates both @costdev and my comments. Thanks so much for looking at this and the PR.

#22 @audrasjb
2 years ago

  • Keywords commit has-copy-review assigned-for-commit added; needs-copy-review removed

Thanks for the review!

#23 @audrasjb
2 years ago

  • Owner set to audrasjb
  • Resolution set to fixed
  • Status changed from new to closed

In 53001:

Options, Meta APIs: Rephrase the description of the "Avatars" section.

This changeset clarifies the description of the "Avatars" section in Discussion Settings screen.

Props johnjamesjacoby, helen, netweb, GaryJ, sabernhardt, costdev, audrasjb, webcommsat, peterwilsoncc.
Fixes #32998.

Note: See TracTickets for help on using tickets.