Add method to get the version of an avatar

Signed-off-by: Daniel Calviño Sánchez <[email protected]>

lib/private/Avatar/GuestAvatarProvider.php

@@ -71,6 +71,16 @@ public function canBeModifiedByCurrentUser(IAvatar $avatar): bool {
 		return false;
 	}
 
+	/**
+	 * Returns the latest value of the avatar version
+	 *
+	 * @param IAvatar $avatar ignored
+	 * @return int 0, as versions are not supported by guest avatars
+	 */
+	public function getVersion(IAvatar $avatar): int {
+		return 0;
+	}
+
 	/**
 	 * Returns the cache duration for guest avatars in seconds
 	 *

lib/private/Avatar/UserAvatarProvider.php

@@ -130,6 +130,21 @@ public function canBeModifiedByCurrentUser(IAvatar $avatar): bool {
 		return $avatar->getUser()->getUID() === $this->currentUser->getUID();
 	}
 
+	/**
+	 * Returns the latest value of the avatar version
+	 *
+	 * @param IAvatar $avatar the avatar to check
+	 * @return int the latest value of the avatar version
+	 * @throws \InvalidArgumentException if the given avatar is not a UserAvatar
+	 */
+	public function getVersion(IAvatar $avatar): int {
+		if (!($avatar instanceof UserAvatar)) {
+			throw new \InvalidArgumentException();
+		}
+
+		return (int) $this->config->getUserValue($avatar->getUser()->getUID(), 'avatar', 'version', 0);
+	}
+
 	/**
 	 * Returns the cache duration for user avatars in seconds
 	 *

lib/public/IAvatarProvider.php

@@ -80,6 +80,22 @@ public function canBeAccessedByCurrentUser(IAvatar $avatar): bool;
 	 */
 	public function canBeModifiedByCurrentUser(IAvatar $avatar): bool;
 
+	/**
+	 * Returns the latest value of the avatar version
+	 *
+	 * Implementers of IAvatarProvider may not throw \InvalidArgumentException
+	 * if the behaviour does not depend on specific avatar instances (for
+	 * example, if versions are not supported and the same version is always
+	 * returned).
+	 *
+	 * @param IAvatar $avatar the avatar to check
+	 * @return int the latest value of the avatar version
+	 * @throws \InvalidArgumentException if the given avatar is not supported by
+	 *         this provider
+	 * @since 21.0.0
+	 */
+	public function getVersion(IAvatar $avatar): int;
+
 	/**
 	 * Returns the cache duration in seconds
 	 *