chore: correct php docs

hamza221 · hamza221 · commit 40769c723335 · 2026-03-10T18:25:41.000+01:00
Signed-off-by: Hamza &lt;hamzamahjoubi221@gmail.com&gt;
diff --git a/lib/Controller/SocialApiController.php b/lib/Controller/SocialApiController.php
@@ -34,10 +34,10 @@ public function __construct(
 	/**
 	 * update appconfig (admin setting)
 	 *
-	 * @param {String} key the identifier to change
-	 * @param {String} allow the value to set
+	 * @param string $key the identifier to change
+	 * @param string $allow the value to set
 	 *
-	 * @returns {JSONResponse} an empty JSONResponse with respective http status code
+	 * @return JSONResponse an empty JSONResponse with respective http status code
 	 */
 	public function setAppConfig($key, $allow) {
 		$permittedKeys = ['allowSocialSync'];
@@ -53,10 +53,10 @@ public function setAppConfig($key, $allow) {
 	 *
 	 * update appconfig (user setting)
 	 *
-	 * @param {String} key the identifier to change
-	 * @param {String} allow the value to set
+	 * @param string $key the identifier to change
+	 * @param string $allow the value to set
 	 *
-	 * @returns {JSONResponse} an empty JSONResponse with respective http status code
+	 * @return JSONResponse an empty JSONResponse with respective http status code
 	 */
 	public function setUserConfig($key, $allow) {
 		$user = $this->userSession->getUser();
@@ -74,9 +74,9 @@ public function setUserConfig($key, $allow) {
 	 *
 	 * retrieve appconfig (user setting)
 	 *
-	 * @param {String} key the identifier to retrieve
+	 * @param string $key the identifier to retrieve
 	 *
-	 * @returns {string} the desired value or null if not existing
+	 * @return string|null the desired value or null if not existing
 	 */
 	public function getUserConfig($key) {
 		$user = $this->userSession->getUser();
@@ -93,7 +93,7 @@ public function getUserConfig($key) {
 	 *
 	 * returns an array of supported social networks
 	 *
-	 * @returns {array} array of the supported social networks
+	 * @return array array of the supported social networks
 	 */
 	public function getSupportedNetworks() : array {
 		return $this->socialApiService->getSupportedNetworks();
@@ -105,11 +105,11 @@ public function getSupportedNetworks() : array {
 	 *
 	 * Retrieves social profile data for a contact and updates the entry
 	 *
-	 * @param {String} addressbookId the addressbook identifier
-	 * @param {String} contactId the contact identifier
-	 * @param {String} network the social network to use (if unkown: take first match)
+	 * @param string $addressbookId the addressbook identifier
+	 * @param string $contactId the contact identifier
+	 * @param string $network the social network to use (if unknown: take first match)
 	 *
-	 * @returns {JSONResponse} an empty JSONResponse with respective http status code
+	 * @return JSONResponse an empty JSONResponse with respective http status code
 	 */
 	public function updateContact(string $addressbookId, string $contactId, string $network) : JSONResponse {
 		return $this->socialApiService->updateContact($addressbookId, $contactId, $network);
diff --git a/lib/Service/Social/CompositeSocialProvider.php b/lib/Service/Social/CompositeSocialProvider.php
@@ -38,7 +38,7 @@ public function __construct(InstagramProvider $instagramProvider,
 	/**
 	 * returns an array of supported social providers
 	 *
-	 * @returns String[] array of the supported social networks
+	 * @return string[] array of the supported social networks
 	 */
 	public function getSupportedNetworks() : array {
 		return array_keys($this->providers);
diff --git a/lib/Service/Social/DiasporaProvider.php b/lib/Service/Social/DiasporaProvider.php
@@ -28,7 +28,7 @@ public function __construct(IClientService $httpClient) {
 	/**
 	 * Returns if this provider supports this contact
 	 *
-	 * @param {array} contact info
+	 * @param array $contact contact info
 	 *
 	 * @return bool
 	 */
@@ -44,7 +44,7 @@ public function supportsContact(array $contact):bool {
 	/**
 	 * Returns all possible profile-picture urls
 	 *
-	 * @param {array} contact information
+	 * @param array $contact contact information
 	 *
 	 * @return array
 	 */
@@ -66,7 +66,7 @@ public function getImageUrls(array $contact):array {
 	/**
 	 * Returns the profile-picture url
 	 *
-	 * @param {string} profileId the profile-id
+	 * @param string $profileUrl the profile-id
 	 *
 	 * @return string|null
 	 */
@@ -96,7 +96,7 @@ protected function getImageUrl(string $profileUrl):?string {
 	/**
 	 * Returns all possible profile ids for contact
 	 *
-	 * @param {array} contact information
+	 * @param array $contact contact information
 	 *
 	 * @return array
 	 */
@@ -120,9 +120,9 @@ protected function getProfileIds($contact):array {
 	/**
 	 * Returns the profile-id
 	 *
-	 * @param {string} the value from the contact's x-socialprofile
+	 * @param string $candidate the value from the contact's x-socialprofile
 	 *
-	 * @return string
+	 * @return string|null
 	 */
 	protected function cleanupId(string $candidate):?string {
 		try {
diff --git a/lib/Service/Social/FacebookProvider.php b/lib/Service/Social/FacebookProvider.php
@@ -24,7 +24,7 @@ public function __construct(IClientService $httpClient) {
 	/**
 	 * Returns if this provider supports this contact
 	 *
-	 * @param {array} contact info
+	 * @param array $contact contact info
 	 *
 	 * @return bool
 	 */
@@ -40,7 +40,7 @@ public function supportsContact(array $contact):bool {
 	/**
 	 * Returns the profile-picture url
 	 *
-	 * @param {array} contact information
+	 * @param array $contact contact information
 	 *
 	 * @return array
 	 */
@@ -59,7 +59,7 @@ public function getImageUrls(array $contact):array {
 	/**
 	 * Returns the profile-id
 	 *
-	 * @param {string} the value from the contact's x-socialprofile
+	 * @param string $candidate the value from the contact's x-socialprofile
 	 *
 	 * @return string
 	 */
@@ -74,7 +74,7 @@ protected function cleanupId(string $candidate):string {
 	/**
 	 * Returns all possible profile ids for contact
 	 *
-	 * @param {array} contact information
+	 * @param array $contact contact information
 	 *
 	 * @return array of string profile ids
 	 */
@@ -94,7 +94,7 @@ protected function getProfiles(array $contact):array {
 	/**
 	 * Returns all possible profile ids for contact
 	 *
-	 * @param {array} contact information
+	 * @param array $contact contact information
 	 *
 	 * @return array of string profile ids
 	 */
@@ -113,7 +113,7 @@ protected function getProfileIds(array $contact):array {
 	 * Fallback: return profile name
 	 * (will give oauth error from facebook except if profile is public)
 	 *
-	 * @param {string} profileName the user's profile name
+	 * @param string $profileName the user's profile name
 	 *
 	 * @return string
 	 */
diff --git a/lib/Service/Social/GravatarProvider.php b/lib/Service/Social/GravatarProvider.php
@@ -17,7 +17,7 @@ public function __construct() {
 	/**
 	 * Returns if this provider supports this contact
 	 *
-	 * @param {array} contact info
+	 * @param array $contact contact info
 	 *
 	 * @return bool
 	 */
@@ -33,7 +33,7 @@ public function supportsContact(array $contact):bool {
 	/**
 	 * Returns the profile-picture url
 	 *
-	 * @param {array} contact information
+	 * @param array $contact contact information
 	 *
 	 * @return array
 	 */
diff --git a/lib/Service/Social/ISocialProvider.php b/lib/Service/Social/ISocialProvider.php
@@ -11,7 +11,7 @@ interface ISocialProvider {
 	/**
 	 * Returns true if provider supports the contact
 	 *
-	 * @param {array} contact details
+	 * @param array $contact contact details
 	 *
 	 * @return boolean
 	 */
@@ -20,7 +20,7 @@ public function supportsContact(array $contact):bool ;
 	/**
 	 * Returns all possible profile-picture urls
 	 *
-	 * @param {array} contact information
+	 * @param array $contact contact information
 	 *
 	 * @return array
 	 */
diff --git a/lib/Service/Social/InstagramProvider.php b/lib/Service/Social/InstagramProvider.php
@@ -31,7 +31,7 @@ public function __construct(IClientService $httpClient,
 	/**
 	 * Returns if this provider supports this contact
 	 *
-	 * @param {array} contact info
+	 * @param array $contact contact info
 	 *
 	 * @return bool
 	 */
@@ -47,7 +47,7 @@ public function supportsContact(array $contact):bool {
 	/**
 	 * Returns the profile-picture url
 	 *
-	 * @param {array} contact information
+	 * @param array $contact contact information
 	 *
 	 * @return array
 	 */
@@ -67,7 +67,7 @@ public function getImageUrls(array $contact):array {
 	/**
 	 * Returns the profile-id
 	 *
-	 * @param {string} the value from the contact's x-socialprofile
+	 * @param string $candidate the value from the contact's x-socialprofile
 	 *
 	 * @return string
 	 */
@@ -79,7 +79,7 @@ protected function cleanupId(string $candidate):string {
 	/**
 	 * Returns all possible profile urls for contact
 	 *
-	 * @param {array} contact information
+	 * @param array $contact contact information
 	 *
 	 * @return array of string profile urls
 	 */
@@ -99,7 +99,7 @@ protected function getProfiles($contact):array {
 	/**
 	 * Returns all possible profile ids for contact
 	 *
-	 * @param {array} contact information
+	 * @param array $contact contact information
 	 *
 	 * @return array of string profile ids
 	 */
@@ -115,10 +115,10 @@ protected function getProfileIds($contact):array {
 	/**
 	 * extracts desired value from a json
 	 *
-	 * @param {string} url the target from where to fetch the json
-	 * @param {String} the desired key to filter for (nesting possible with '->')
+	 * @param string $url the target from where to fetch the json
+	 * @param string $desired the desired key to filter for (nesting possible with '->')
 	 *
-	 * @returns {String} the extracted value or null if not present
+	 * @return string|null the extracted value or null if not present
 	 */
 	protected function getFromJson(string $url, string $desired) : ?string {
 		try {
diff --git a/lib/Service/Social/MastodonProvider.php b/lib/Service/Social/MastodonProvider.php
@@ -24,7 +24,7 @@ public function __construct(IClientService $httpClient) {
 	/**
 	 * Returns if this provider supports this contact
 	 *
-	 * @param {array} contact info
+	 * @param array $contact contact info
 	 *
 	 * @return bool
 	 */
@@ -40,7 +40,7 @@ public function supportsContact(array $contact):bool {
 	/**
 	 * Returns all possible profile-picture urls
 	 *
-	 * @param {array} contact information
+	 * @param array $contact contact information
 	 *
 	 * @return array
 	 */
@@ -60,7 +60,7 @@ public function getImageUrls(array $contact):array {
 	/**
 	 * Returns the profile-picture url
 	 *
-	 * @param {array} contact information
+	 * @param string $profileUrl profile URL
 	 *
 	 * @return string|null
 	 */
@@ -77,7 +77,7 @@ public function getImageUrl(string $profileUrl):?string {
 	/**
 	 * Returns all possible profile URI for contact by searching the mastodon instance
 	 *
-	 * @param {array} contact information
+	 * @param array $contact contact information
 	 *
 	 * @return array of possible profileIds
 	 */
@@ -116,9 +116,9 @@ protected function getProfileIds($contact):array {
 	/**
 	 * Returns the profile-id
 	 *
-	 * @param {string} the value from the contact's x-socialprofile
+	 * @param string $candidate the value from the contact's x-socialprofile
 	 *
-	 * @return array username and server instance
+	 * @return array|null username and server instance
 	 */
 	protected function cleanupId(string $candidate):?array {
 		$candidate = preg_replace('/^' . preg_quote('x-apple:', '/') . '/', '', $candidate);
diff --git a/lib/Service/Social/TelegramProvider.php b/lib/Service/Social/TelegramProvider.php
@@ -31,7 +31,7 @@ public function __construct(IClientService $httpClient,
 	/**
 	 * Returns if this provider supports this contact
 	 *
-	 * @param {array} contact info
+	 * @param array $contact contact info
 	 *
 	 * @return bool
 	 */
@@ -47,7 +47,7 @@ public function supportsContact(array $contact):bool {
 	/**
 	 * Returns the profile-picture url
 	 *
-	 * @param {array} contact information
+	 * @param array $contact contact information
 	 *
 	 * @return array
 	 */
@@ -67,7 +67,7 @@ public function getImageUrls(array $contact):array {
 	/**
 	 * Returns the profile-id
 	 *
-	 * @param {string} the value from the contact's x-socialprofile
+	 * @param string $candidate the value from the contact's x-socialprofile
 	 *
 	 * @return string
 	 */
@@ -82,7 +82,7 @@ protected function cleanupId(string $candidate):string {
 	/**
 	 * Returns all possible profile ids for contact
 	 *
-	 * @param {array} contact information
+	 * @param array $contact contact information
 	 *
 	 * @return array of string profile ids
 	 */
@@ -102,10 +102,10 @@ protected function getProfileIds($contact):array {
 	/**
 	 * extracts desired value from an html page
 	 *
-	 * @param {string} url the target from where to fetch the content
-	 * @param {String} the desired catchword to filter for
+	 * @param string $url the target from where to fetch the content
+	 * @param string $desired the desired catchword to filter for
 	 *
-	 * @returns {String} the extracted value (first match) or null if not present
+	 * @return string|null the extracted value (first match) or null if not present
 	 */
 	protected function getFromHtml(string $url, string $desired) : ?string {
 		try {
diff --git a/lib/Service/Social/TumblrProvider.php b/lib/Service/Social/TumblrProvider.php
diff --git a/lib/Service/Social/XingProvider.php b/lib/Service/Social/XingProvider.php
diff --git a/lib/Service/SocialApiService.php b/lib/Service/SocialApiService.php

Original file line number	Diff line number	Diff line change
`@@ -34,10 +34,10 @@ public function __construct(`
`34`	`34`	`/**`
`35`	`35`	`* update appconfig (admin setting)`
`36`	`36`	`*`
`37`		`- * @param {String} key the identifier to change`
`38`		`- * @param {String} allow the value to set`
	`37`	`+ * @param string $key the identifier to change`
	`38`	`+ * @param string $allow the value to set`
`39`	`39`	`*`
`40`		`- * @returns {JSONResponse} an empty JSONResponse with respective http status code`
	`40`	`+ * @return JSONResponse an empty JSONResponse with respective http status code`
`41`	`41`	`*/`
`42`	`42`	`public function setAppConfig($key, $allow) {`
`43`	`43`	`$permittedKeys = ['allowSocialSync'];`
`@@ -53,10 +53,10 @@ public function setAppConfig($key, $allow) {`
`53`	`53`	`*`
`54`	`54`	`* update appconfig (user setting)`
`55`	`55`	`*`
`56`		`- * @param {String} key the identifier to change`
`57`		`- * @param {String} allow the value to set`
	`56`	`+ * @param string $key the identifier to change`
	`57`	`+ * @param string $allow the value to set`
`58`	`58`	`*`
`59`		`- * @returns {JSONResponse} an empty JSONResponse with respective http status code`
	`59`	`+ * @return JSONResponse an empty JSONResponse with respective http status code`
`60`	`60`	`*/`
`61`	`61`	`public function setUserConfig($key, $allow) {`
`62`	`62`	`$user = $this->userSession->getUser();`
`@@ -74,9 +74,9 @@ public function setUserConfig($key, $allow) {`
`74`	`74`	`*`
`75`	`75`	`* retrieve appconfig (user setting)`
`76`	`76`	`*`
`77`		`- * @param {String} key the identifier to retrieve`
	`77`	`+ * @param string $key the identifier to retrieve`
`78`	`78`	`*`
`79`		`- * @returns {string} the desired value or null if not existing`
	`79`	`+ * @return string\|null the desired value or null if not existing`
`80`	`80`	`*/`
`81`	`81`	`public function getUserConfig($key) {`
`82`	`82`	`$user = $this->userSession->getUser();`
`@@ -93,7 +93,7 @@ public function getUserConfig($key) {`
`93`	`93`	`*`
`94`	`94`	`* returns an array of supported social networks`
`95`	`95`	`*`
`96`		`- * @returns {array} array of the supported social networks`
	`96`	`+ * @return array array of the supported social networks`
`97`	`97`	`*/`
`98`	`98`	`public function getSupportedNetworks() : array {`
`99`	`99`	`return $this->socialApiService->getSupportedNetworks();`
`@@ -105,11 +105,11 @@ public function getSupportedNetworks() : array {`
`105`	`105`	`*`
`106`	`106`	`* Retrieves social profile data for a contact and updates the entry`
`107`	`107`	`*`
`108`		`- * @param {String} addressbookId the addressbook identifier`
`109`		`- * @param {String} contactId the contact identifier`
`110`		`- * @param {String} network the social network to use (if unkown: take first match)`
	`108`	`+ * @param string $addressbookId the addressbook identifier`
	`109`	`+ * @param string $contactId the contact identifier`
	`110`	`+ * @param string $network the social network to use (if unknown: take first match)`
`111`	`111`	`*`
`112`		`- * @returns {JSONResponse} an empty JSONResponse with respective http status code`
	`112`	`+ * @return JSONResponse an empty JSONResponse with respective http status code`
`113`	`113`	`*/`
`114`	`114`	`public function updateContact(string $addressbookId, string $contactId, string $network) : JSONResponse {`
`115`	`115`	`return $this->socialApiService->updateContact($addressbookId, $contactId, $network);`
Original file line number	Diff line number	Diff line change
`@@ -38,7 +38,7 @@ public function __construct(InstagramProvider $instagramProvider,`
`38`	`38`	`/**`
`39`	`39`	`* returns an array of supported social providers`
`40`	`40`	`*`
`41`		`- * @returns String[] array of the supported social networks`
	`41`	`+ * @return string[] array of the supported social networks`
`42`	`42`	`*/`
`43`	`43`	`public function getSupportedNetworks() : array {`
`44`	`44`	`return array_keys($this->providers);`
Original file line number	Diff line number	Diff line change
`@@ -28,7 +28,7 @@ public function __construct(IClientService $httpClient) {`
`28`	`28`	`/**`
`29`	`29`	`* Returns if this provider supports this contact`
`30`	`30`	`*`
`31`		`- * @param {array} contact info`
	`31`	`+ * @param array $contact contact info`
`32`	`32`	`*`
`33`	`33`	`* @return bool`
`34`	`34`	`*/`
`@@ -44,7 +44,7 @@ public function supportsContact(array $contact):bool {`
`44`	`44`	`/**`
`45`	`45`	`* Returns all possible profile-picture urls`
`46`	`46`	`*`
`47`		`- * @param {array} contact information`
	`47`	`+ * @param array $contact contact information`
`48`	`48`	`*`
`49`	`49`	`* @return array`
`50`	`50`	`*/`
`@@ -66,7 +66,7 @@ public function getImageUrls(array $contact):array {`
`66`	`66`	`/**`
`67`	`67`	`* Returns the profile-picture url`
`68`	`68`	`*`
`69`		`- * @param {string} profileId the profile-id`
	`69`	`+ * @param string $profileUrl the profile-id`
`70`	`70`	`*`
`71`	`71`	`* @return string\|null`
`72`	`72`	`*/`
`@@ -96,7 +96,7 @@ protected function getImageUrl(string $profileUrl):?string {`
`96`	`96`	`/**`
`97`	`97`	`* Returns all possible profile ids for contact`
`98`	`98`	`*`
`99`		`- * @param {array} contact information`
	`99`	`+ * @param array $contact contact information`
`100`	`100`	`*`
`101`	`101`	`* @return array`
`102`	`102`	`*/`
`@@ -120,9 +120,9 @@ protected function getProfileIds($contact):array {`
`120`	`120`	`/**`
`121`	`121`	`* Returns the profile-id`
`122`	`122`	`*`
`123`		`- * @param {string} the value from the contact's x-socialprofile`
	`123`	`+ * @param string $candidate the value from the contact's x-socialprofile`
`124`	`124`	`*`
`125`		`- * @return string`
	`125`	`+ * @return string\|null`
`126`	`126`	`*/`
`127`	`127`	`protected function cleanupId(string $candidate):?string {`
`128`	`128`	`try {`
Original file line number	Diff line number	Diff line change
`@@ -24,7 +24,7 @@ public function __construct(IClientService $httpClient) {`
`24`	`24`	`/**`
`25`	`25`	`* Returns if this provider supports this contact`
`26`	`26`	`*`
`27`		`- * @param {array} contact info`
	`27`	`+ * @param array $contact contact info`
`28`	`28`	`*`
`29`	`29`	`* @return bool`
`30`	`30`	`*/`
`@@ -40,7 +40,7 @@ public function supportsContact(array $contact):bool {`
`40`	`40`	`/**`
`41`	`41`	`* Returns the profile-picture url`
`42`	`42`	`*`
`43`		`- * @param {array} contact information`
	`43`	`+ * @param array $contact contact information`
`44`	`44`	`*`
`45`	`45`	`* @return array`
`46`	`46`	`*/`
`@@ -59,7 +59,7 @@ public function getImageUrls(array $contact):array {`
`59`	`59`	`/**`
`60`	`60`	`* Returns the profile-id`
`61`	`61`	`*`
`62`		`- * @param {string} the value from the contact's x-socialprofile`
	`62`	`+ * @param string $candidate the value from the contact's x-socialprofile`
`63`	`63`	`*`
`64`	`64`	`* @return string`
`65`	`65`	`*/`
`@@ -74,7 +74,7 @@ protected function cleanupId(string $candidate):string {`
`74`	`74`	`/**`
`75`	`75`	`* Returns all possible profile ids for contact`
`76`	`76`	`*`
`77`		`- * @param {array} contact information`
	`77`	`+ * @param array $contact contact information`
`78`	`78`	`*`
`79`	`79`	`* @return array of string profile ids`
`80`	`80`	`*/`
`@@ -94,7 +94,7 @@ protected function getProfiles(array $contact):array {`
`94`	`94`	`/**`
`95`	`95`	`* Returns all possible profile ids for contact`
`96`	`96`	`*`
`97`		`- * @param {array} contact information`
	`97`	`+ * @param array $contact contact information`
`98`	`98`	`*`
`99`	`99`	`* @return array of string profile ids`
`100`	`100`	`*/`
`@@ -113,7 +113,7 @@ protected function getProfileIds(array $contact):array {`
`113`	`113`	`* Fallback: return profile name`
`114`	`114`	`* (will give oauth error from facebook except if profile is public)`
`115`	`115`	`*`
`116`		`- * @param {string} profileName the user's profile name`
	`116`	`+ * @param string $profileName the user's profile name`
`117`	`117`	`*`
`118`	`118`	`* @return string`
`119`	`119`	`*/`
Original file line number	Diff line number	Diff line change
`@@ -17,7 +17,7 @@ public function __construct() {`
`17`	`17`	`/**`
`18`	`18`	`* Returns if this provider supports this contact`
`19`	`19`	`*`
`20`		`- * @param {array} contact info`
	`20`	`+ * @param array $contact contact info`
`21`	`21`	`*`
`22`	`22`	`* @return bool`
`23`	`23`	`*/`
`@@ -33,7 +33,7 @@ public function supportsContact(array $contact):bool {`
`33`	`33`	`/**`
`34`	`34`	`* Returns the profile-picture url`
`35`	`35`	`*`
`36`		`- * @param {array} contact information`
	`36`	`+ * @param array $contact contact information`
`37`	`37`	`*`
`38`	`38`	`* @return array`
`39`	`39`	`*/`
Original file line number	Diff line number	Diff line change
`@@ -11,7 +11,7 @@ interface ISocialProvider {`
`11`	`11`	`/**`
`12`	`12`	`* Returns true if provider supports the contact`
`13`	`13`	`*`
`14`		`- * @param {array} contact details`
	`14`	`+ * @param array $contact contact details`
`15`	`15`	`*`
`16`	`16`	`* @return boolean`
`17`	`17`	`*/`
`@@ -20,7 +20,7 @@ public function supportsContact(array $contact):bool ;`
`20`	`20`	`/**`
`21`	`21`	`* Returns all possible profile-picture urls`
`22`	`22`	`*`
`23`		`- * @param {array} contact information`
	`23`	`+ * @param array $contact contact information`
`24`	`24`	`*`
`25`	`25`	`* @return array`
`26`	`26`	`*/`
Original file line number	Diff line number	Diff line change
`@@ -31,7 +31,7 @@ public function __construct(IClientService $httpClient,`
`31`	`31`	`/**`
`32`	`32`	`* Returns if this provider supports this contact`
`33`	`33`	`*`
`34`		`- * @param {array} contact info`
	`34`	`+ * @param array $contact contact info`
`35`	`35`	`*`
`36`	`36`	`* @return bool`
`37`	`37`	`*/`
`@@ -47,7 +47,7 @@ public function supportsContact(array $contact):bool {`
`47`	`47`	`/**`
`48`	`48`	`* Returns the profile-picture url`
`49`	`49`	`*`
`50`		`- * @param {array} contact information`
	`50`	`+ * @param array $contact contact information`
`51`	`51`	`*`
`52`	`52`	`* @return array`
`53`	`53`	`*/`
`@@ -67,7 +67,7 @@ public function getImageUrls(array $contact):array {`
`67`	`67`	`/**`
`68`	`68`	`* Returns the profile-id`
`69`	`69`	`*`
`70`		`- * @param {string} the value from the contact's x-socialprofile`
	`70`	`+ * @param string $candidate the value from the contact's x-socialprofile`
`71`	`71`	`*`
`72`	`72`	`* @return string`
`73`	`73`	`*/`
`@@ -79,7 +79,7 @@ protected function cleanupId(string $candidate):string {`
`79`	`79`	`/**`
`80`	`80`	`* Returns all possible profile urls for contact`
`81`	`81`	`*`
`82`		`- * @param {array} contact information`
	`82`	`+ * @param array $contact contact information`
`83`	`83`	`*`
`84`	`84`	`* @return array of string profile urls`
`85`	`85`	`*/`
`@@ -99,7 +99,7 @@ protected function getProfiles($contact):array {`
`99`	`99`	`/**`
`100`	`100`	`* Returns all possible profile ids for contact`
`101`	`101`	`*`
`102`		`- * @param {array} contact information`
	`102`	`+ * @param array $contact contact information`
`103`	`103`	`*`
`104`	`104`	`* @return array of string profile ids`
`105`	`105`	`*/`
`@@ -115,10 +115,10 @@ protected function getProfileIds($contact):array {`
`115`	`115`	`/**`
`116`	`116`	`* extracts desired value from a json`
`117`	`117`	`*`
`118`		`- * @param {string} url the target from where to fetch the json`
`119`		`- * @param {String} the desired key to filter for (nesting possible with '->')`
	`118`	`+ * @param string $url the target from where to fetch the json`
	`119`	`+ * @param string $desired the desired key to filter for (nesting possible with '->')`
`120`	`120`	`*`
`121`		`- * @returns {String} the extracted value or null if not present`
	`121`	`+ * @return string\|null the extracted value or null if not present`
`122`	`122`	`*/`
`123`	`123`	`protected function getFromJson(string $url, string $desired) : ?string {`
`124`	`124`	`try {`