pkp#10489 Allow users to add custom initials for avatars

classes/identity/Identity.php

@@ -201,6 +201,28 @@ public function setPreferredPublicName($preferredPublicName, $locale)
         $this->setData('preferredPublicName', $preferredPublicName, $locale);
     }
 
+
+    /**
+     * Set preferred avatar initials.
+     *
+     */
+    public function setPreferredAvatarInitials(string $preferredAvatarInitials, ?string $locale): void
+    {
+        $this->setData('preferredAvatarInitials', $preferredAvatarInitials, $locale);
+    }
+
+    /**
+     * Get preferred avatar initials.
+     *
+     * @param string $locale
+     *
+     * @return string
+     */
+    public function getPreferredAvatarInitials($locale)
+    {
+        return $this->getData('preferredAvatarInitials', $locale);
+    }
+
     /**
      * Get affiliation (position, institution, etc.).
      *

classes/user/form/IdentityForm.php

@@ -98,6 +98,7 @@ public function initData()
             'familyName' => $user->getFamilyName(null),
             'preferredPublicName' => $user->getPreferredPublicName(null),
             'orcid' => $user->getOrcid(),
+            'preferredAvatarInitials' => $user->getPreferredAvatarInitials(null),
         ];
     }
 
@@ -109,7 +110,7 @@ public function readInputData()
         parent::readInputData();
 
         $this->readUserVars([
-            'givenName', 'familyName', 'preferredPublicName', 'orcid','removeOrcidId'
+            'givenName', 'familyName', 'preferredPublicName', 'orcid', 'removeOrcidId', 'preferredAvatarInitials'
         ]);
     }
 
@@ -123,14 +124,15 @@ public function execute(...$functionArgs)
 
 
         // Request to delete ORCID token is handled separately from other form field updates
-        if($this->getData('removeOrcidId') === 'true') {
+        if ($this->getData('removeOrcidId') === 'true') {
             $user->setOrcid(null);
             $user->setOrcidVerified(false);
             OrcidManager::removeOrcidAccessToken($user);
         } else {
             $user->setGivenName($this->getData('givenName'), null);
             $user->setFamilyName($this->getData('familyName'), null);
             $user->setPreferredPublicName($this->getData('preferredPublicName'), null);
+            $user->setPreferredAvatarInitials($this->getData('preferredAvatarInitials'), null);
         }
 
         parent::execute(...$functionArgs);

locale/en/user.po

@@ -239,6 +239,13 @@ msgstr ""
 "Please provide the full name as the author should be identified on the "
 "published work. Example: Dr. Alan P. Mwandenga"
 
+msgid "user.preferredAvatarInitials"
+msgstr "Preferred Avatar Initials"
+
+msgid "user.preferredAvatarInitials.description"
+msgstr ""
+"Enter the two letters you’d like to use as your avatar. These initials will be displayed to represent you."
+
 msgid "user.profile.changePasswordInstructions"
 msgstr ""
 "Enter your current and new passwords below to change the password for your "

schemas/user.json

@@ -217,6 +217,15 @@
 				"nullable"
 			]
 		},
+		"preferredAvatarInitials": {
+			"type": "string",
+			"description": "An optional field for users to specify the initials that they want to be displayed in their avatars.",
+			"multilingual": false,
+			"apiSummary": true,
+			"validation": [
+				"nullable"
+			]
+		},
 		"signature": {
 			"type": "string",
 			"multilingual": true,

templates/user/identityForm.tpl

@@ -50,6 +50,11 @@
 		{fbvElement type="text" label="user.preferredPublicName" multilingual="true" name="preferredPublicName" id="preferredPublicName" value=$preferredPublicName size=$fbvStyles.size.LARGE}
 	{/fbvFormSection}
 
+
+	{fbvFormSection for="preferredAvatarInitials" description="user.preferredAvatarInitials.description"}
+		{fbvElement type="text" label="user.preferredAvatarInitials" name="preferredAvatarInitials" maxlength="2" id="preferredPublicName" value=$preferredAvatarInitials size=$fbvStyles.size.SMALL}
+	{/fbvFormSection}
+
 	{if $orcidEnabled}
 
 	<div class="orcid_container">