Option to hide users' email address

[derSuessmann]

• Gitea version (or commit ref): 1.0

Description

Currently, Gitea displays the users' email address on the explore users and users' profile pages. The exist two issues in Gogs #3358 and #3381. In addtion I would like to state my case:

In some cases the users' email address should be protected. This may be to avoid the harvesting of email addresses for UCE or another reason. In my context, running a Gitea server in a school's network, I am even more concerned about stalking.

Generally there seem to be two options:

1. Add a site wide configuration option to hide the users' email address.
2. Add a user setting for opting in.

The first option may be more attractive for schools. The second targets a broader audience. Maybe both should be implemented.
...

[lunny]

There is a PR #336 to resolve this, please discuss there.

[derSuessmann]

I am ok with continuing the discussion over there, but I think it is the wrong way around. A newcomer will normally search the issues and not the pull requests. (That was exactly what I did and I did not find that someone was already working on my issue. The discussion on Gitter helped me a lot, so I decided to open this issue)
The issue should be discussed as an issue and the discussion on the pull request should be about the proposed solution.
This issue should stay open until there is a solution (like PR #336 has been merged). This would also be the right way according to the Contribution Guidelines.

[bkcsoft]

@lunny this extends on #336, I'd like to keep this one open until it's all resolved :)

[bkcsoft]

@derSuessmann My proposal is this:

• Have user-setting for displaying ones email. Migration should set this to true for backwards compatability.
• Have a site-wide option DEFAULT_SHOW_EMAIL=boolean which sets the default for newly created users, should also be set to true by default for the same reason

Thoughts?

[bkcsoft]

DEFAULT_SHOW_EMAIL should be configurable from /install just like Offline-Mode etc...

[derSuessmann]

I agree, but would prefer DEFAULT_KEEP_EMAIL_PRIVATE as it has a positive logic and includes the hiding of the real email address in git log. My proposal for a change is:

User requirement
The user of Gitea may want to keep his email address private from other users to prevent email harvesting for UCE or stalking.

Change requirements

• The change must not change the behavior of an updated installation (REQ1). If an existing installation is updated with the changed version, the email address of all users will still be visible until they change their settings.
• The change must enable a user of Gitea to decide whether his email address will be shown (REQ2). This should be implemented as a user setting in the Profile section below the Email address. The option should be called "Keep Email Private" in the dialog and KeepEmailPrivate as a field in the user struct.
• The change must introduce a new site-wide option DEFAULT_KEEP_EMAIL_PRIVATE (REQ3). If the option is true all new user will get KeepEmailPrivate set to true, otherwise false.
• The email address must not be shown to other users on the explore/users and users profile pages if KeepEmailPrivate is true (REQ4).
• The email address should be replaced with a concatenation of the user name in lower case, "@noreply" and the domain name from the settings (<LowerName>@noreply.<DOMAIN>) in the git log, if KeepEmailPrivate is true (REQ5).
• An ApiFormat() call should return the same email address as shown in the git log (REQ6). This requirement is linked to (REQ5).
• The value of DEFAULT_KEEP_EMAIL_PRIVATE should be set on the install page (REQ6).
• The change does not differentiate between what is visible to an administrator and a normal user on the explore/users and users' profile pages.

[derSuessmann]

All requirements can be fulfilled. I have just pushed the code to the keep-email-private branch in my fork. First tests were successful.

[bkcsoft]

@derSuessmann I like it, please make a PR 😉 Only think I can say up front is WRT REQ5, that would be <LowerName>-noreply@<Domain> otherwise you'll end up in someones spam-filter 😄