Allow customizing the email field name for PasswordResetForm

[CHI Cheng]

Like USERNAME_FIELD, add a similar parameter so PasswordResetForm, and other customized user model functions, do not rely on fixed name email field to send emails.

[Tim Graham]

Seems like a reasonable request.

[Susan Tan]

I've been reading this doc for context + background: ​https://docs.djangoproject.com/en/1.5/topics/auth/default/#django.contrib.auth.forms.PasswordResetForm

It seems that I'll need to edit the PasswordResetForm class method located in contrib.auth.forms. In particular, L27 might needed to be changed: "email = forms.EmailField(label=_("Email"), max_length=254)"

Is there an existing similar example that I can follow? I've done a global search on USERNAME_FIELD, which returned a lot of results; I'm not sure which are the relevant files to look at.

[Tim Graham]

This isn't about renaming the form field, but rather not assuming the "email" field on the UserModel is called "email". We could accomplish this on PasswordResetForm by passing in a parameter to the save method with the name of the field, but it would be better to get an idea of the "other customized user model functions" the OP had in mind to better determine the feasibility and design of this.

[jorgecarleitao]

Doesn't the ticket #17431 solves this?

[Tim Graham]

No, I think it's still an issue. I'll attach a patch with a sketch of the code changes.

[Tim Graham]

I left some ideas for improvement on the ​PR.

[Tim Graham <timograham@…>]

In 617e36dc:

Fixed #20705 -- Allowed using PasswordResetForm with user models with an email field not named 'email'.