Source code for profiles.forms
__copyright__ = "Copyright © Stichting SciPost (SciPost Foundation)"
__license__ = "AGPL v3"
from django import forms
from django.db.models import Q
from crispy_forms.helper import FormHelper
from crispy_forms.layout import Layout, Field
from crispy_bootstrap5.bootstrap5 import FloatingField
from dal import autocomplete
from common.forms import ModelChoiceFieldwithid
from invitations.models import RegistrationInvitation
from organizations.models import Organization
from scipost.models import Contributor
from submissions.models import RefereeInvitation
from .models import Profile, ProfileEmail, Affiliation
[docs]class ProfileForm(forms.ModelForm):
email = forms.EmailField(required=False)
# If the Profile is created from an existing object (so we can update the object):
instance_from_type = forms.CharField(max_length=32, required=False)
instance_pk = forms.IntegerField(required=False)
[docs] class Meta:
model = Profile
fields = [
"title",
"first_name",
"last_name",
"orcid_id",
"webpage",
"acad_field",
"specialties",
"topics",
"accepts_SciPost_emails",
"accepts_refereeing_requests",
"instance_from_type",
"instance_pk",
]
def __init__(self, *args, **kwargs):
super().__init__(*args, **kwargs)
self.fields["email"].initial = self.instance.email
self.fields["instance_from_type"].widget = forms.HiddenInput()
self.fields["instance_pk"].widget = forms.HiddenInput()
[docs] def clean_email(self):
"""Check that the email isn't yet associated to an existing Profile."""
cleaned_email = self.cleaned_data["email"]
if (
cleaned_email
and ProfileEmail.objects.filter(email=cleaned_email)
.exclude(profile__id=self.instance.id)
.exists()
):
raise forms.ValidationError("A Profile with this email already exists.")
return cleaned_email
[docs] def clean_instance_from_type(self):
"""
Check that only recognized types are used.
"""
cleaned_instance_from_type = self.cleaned_data["instance_from_type"]
if cleaned_instance_from_type not in [
"",
"contributor",
"refereeinvitation",
"registrationinvitation",
]:
raise forms.ValidationError("The from_type hidden field is inconsistent.")
return cleaned_instance_from_type
[docs] def save(self):
profile = super().save()
if self.cleaned_data["email"]:
profile.emails.update(primary=False)
email, __ = ProfileEmail.objects.get_or_create(
profile=profile, email=self.cleaned_data["email"]
)
profile.emails.filter(id=email.id).update(primary=True, still_valid=True)
instance_pk = self.cleaned_data["instance_pk"]
if instance_pk:
if self.cleaned_data["instance_from_type"] == "contributor":
Contributor.objects.filter(pk=instance_pk).update(profile=profile)
elif self.cleaned_data["instance_from_type"] == "refereeinvitation":
RefereeInvitation.objects.filter(pk=instance_pk).update(profile=profile)
elif self.cleaned_data["instance_from_type"] == "registrationinvitation":
RegistrationInvitation.objects.filter(pk=instance_pk).update(
profile=profile
)
return profile
[docs]class SimpleProfileForm(ProfileForm):
"""
Simple version of ProfileForm, displaying only required fields.
"""
def __init__(self, *args, **kwargs):
super().__init__(*args, **kwargs)
self.fields["orcid_id"].widget = forms.HiddenInput()
self.fields["webpage"].widget = forms.HiddenInput()
self.fields["acad_field"].widget = forms.HiddenInput()
self.fields["specialties"].widget = forms.HiddenInput()
self.fields["topics"].widget = forms.HiddenInput()
self.fields["accepts_SciPost_emails"].widget = forms.HiddenInput()
self.fields["accepts_refereeing_requests"].widget = forms.HiddenInput()
[docs]class ProfileMergeForm(forms.Form):
to_merge = ModelChoiceFieldwithid(
queryset=Profile.objects.all(),
widget=autocomplete.ModelSelect2(url="/profiles/profile-autocomplete"),
empty_label=None,
)
to_merge_into = ModelChoiceFieldwithid(
queryset=Profile.objects.all(),
widget=autocomplete.ModelSelect2(url="/profiles/profile-autocomplete"),
empty_label=None,
)
[docs] def clean(self):
"""
To merge Profiles, they must be distinct, and it must not be the
case that they both are associated to a Contributor instance
(which would mean two Contributor objects for the same person).
"""
data = super().clean()
if self.cleaned_data["to_merge"] == self.cleaned_data["to_merge_into"]:
self.add_error(None, "A Profile cannot be merged into itself.")
if (
self.cleaned_data["to_merge"].has_active_contributor
and self.cleaned_data["to_merge_into"].has_active_contributor
):
self.add_error(
None,
"Each of these two Profiles has an active Contributor. "
"Merge the Contributors first.\n"
"If these are distinct people or if two separate "
"accounts are needed, a ProfileNonDuplicate instance should be created; "
"contact techsupport.",
)
return data
[docs] def save(self):
"""
Perform the actual merge: save all data from to-be-deleted profile
into the one to be kept.
"""
profile = self.cleaned_data["to_merge_into"]
profile_old = self.cleaned_data["to_merge"]
# Merge information from old to new Profile.
if profile.orcid_id is None:
profile.orcid_id = profile_old.orcid_id
if profile.webpage is None:
profile.webpage = profile_old.webpage
if profile.acad_field is None:
profile.acad_field = profile_old.acad_field
if profile_old.has_active_contributor and not profile.has_active_contributor:
profile.contributor = profile_old.contributor
profile.save() # Save all the field updates.
profile.specialties.add(*profile_old.specialties.all())
profile.topics.add(*profile_old.topics.all())
# Merge email
profile_old.emails.exclude(
email__in=profile.emails.values_list("email", flat=True)
).update(primary=False, profile=profile)
# Move all affiliations to the "new" profile
profile_old.affiliations.all().update(profile=profile)
# Move all PublicationAuthorsTable instances to the "new" profile
profile_old.publicationauthorstable_set.all().update(profile=profile)
# Move all invitations to the "new" profile
profile_old.refereeinvitation_set.all().update(profile=profile)
profile_old.registrationinvitation_set.all().update(profile=profile)
# Move all PotentialFellowships to the "new" profile
profile_old.potentialfellowship_set.all().update(profile=profile)
profile_old.delete()
return Profile.objects.get(
id=profile.id
) # Retrieve again because of all the db updates.
[docs]class ProfileEmailForm(forms.ModelForm):
def __init__(self, *args, **kwargs):
self.profile = kwargs.pop("profile", None)
super().__init__(*args, **kwargs)
[docs] def clean_email(self):
"""Check if profile/email combination exists."""
email = self.cleaned_data["email"]
if self.profile.emails.filter(email=email).exists():
self.add_error("email", "This profile/email pair is already defined.")
return email
[docs] def save(self):
"""Save to a profile."""
if self.cleaned_data["primary"]:
self.profile.emails.update(primary=False)
self.instance.profile = self.profile
return super().save()
[docs]class ProfileSelectForm(forms.Form):
profile = forms.ModelChoiceField(
queryset=Profile.objects.all(),
widget=autocomplete.ModelSelect2(url="/profiles/profile-autocomplete"),
help_text=("Start typing, and select from the popup."),
)
[docs]class ProfileDynSelForm(forms.Form):
q = forms.CharField(max_length=32, label="Search (by name)")
action_url_name = forms.CharField()
action_url_base_kwargs = forms.JSONField(required=False)
action_target_element_id = forms.CharField()
def __init__(self, *args, **kwargs):
super().__init__(*args, **kwargs)
self.helper = FormHelper()
self.helper.layout = Layout(
FloatingField("q", autocomplete="off"),
Field("action_url_name", type="hidden"),
Field("action_url_base_kwargs", type="hidden"),
Field("action_target_element_id", type="hidden"),
)
[docs] def search_results(self):
if self.cleaned_data["q"]:
profiles = Profile.objects.filter(
Q(last_name__icontains=self.cleaned_data["q"])
| Q(first_name__icontains=self.cleaned_data["q"])
).distinct()
return profiles
else:
return Profile.objects.none()
[docs]class AffiliationForm(forms.ModelForm):
organization = forms.ModelChoiceField(
queryset=Organization.objects.all(),
widget=autocomplete.ModelSelect2(
url="/organizations/organization-autocomplete", attrs={"data-html": True}
),
)
[docs] class Meta:
model = Affiliation
fields = [
"profile",
"organization",
"category",
"description",
"date_from",
"date_until",
]
def __init__(self, *args, **kwargs):
super().__init__(*args, **kwargs)
self.fields["profile"].widget = forms.HiddenInput()