HEX
Server: Apache
System: Linux 185.122.168.184.host.secureserver.net 5.14.0-570.60.1.el9_6.x86_64 #1 SMP PREEMPT_DYNAMIC Wed Nov 5 05:00:59 EST 2025 x86_64
User: barbeatleanalyti (1024)
PHP: 8.1.33
Disabled: NONE
Upload Files
File: /home/barbeatleanalyti/public_html/public_html/webmail/modules/Contacts/Classes/VCard/Helper.php
<?php
/**
 * This code is licensed under AGPLv3 license or Afterlogic Software License
 * if commercial version of the product was purchased.
 * For full statements of the licenses see LICENSE-AFTERLOGIC and LICENSE-AGPL3 files.
 */

namespace Aurora\Modules\Contacts\Classes\VCard;

/**
 * @license https://www.gnu.org/licenses/agpl-3.0.html AGPL-3.0
 * @license https://afterlogic.com/products/common-licensing Afterlogic Software License
 * @copyright Copyright (c) 2019, Afterlogic Corp.
 *
 * @ignore
 * @package Contactsmain
 * @subpackage Helpers
 */
class Helper
{
	
	public static function GetContactDataFromVcard($oVCard, $sUUID = '')
	{
		$aContact = [];
		
		if (!empty($sUUID))
		{
			$aContact['UUID'] = (string) $sUUID;
		}
/*
		elseif (isset($oVCard->UID))
		{
			$aContact['UUID'] = (string) $oVCard->UID;
		}
*/
		$aGroupNames = [];
		if (isset($oVCard->CATEGORIES))
		{
			foreach ($oVCard->CATEGORIES->getParts() as $sCategory)
			{
				$aGroupNames[] = (string) $sCategory;
			}
		}
		$aContact['GroupNames'] = $aGroupNames;

		$aContact['FullName'] = isset($oVCard->FN) ? (string) $oVCard->FN : '';

		if (isset($oVCard->N))
		{
			$aNames = $oVCard->N->getParts();
			if (count($aNames) >= 2)
			{
				$aContact['LastName'] = !empty($aNames[0]) ? (string) $aNames[0] : '';
				$aContact['FirstName'] = !empty($aNames[1]) ? (string) $aNames[1] : '';
			}
		}

		$aContact['NickName'] = isset($oVCard->NICKNAME) ? (string) $oVCard->NICKNAME : '';
		$aContact['Notes'] = isset($oVCard->NOTE) ? (string) $oVCard->NOTE : '';

		if (isset($oVCard->BDAY))
		{
			$aDateTime = explode('T', (string) $oVCard->BDAY);
			if (isset($aDateTime[0]))
			{
				$aDate = explode('-', $aDateTime[0]);
				if (count($aDate) >= 3)
				{
					$aContact['BirthYear'] = (int) $aDate[0];
					$aContact['BirthMonth'] = (int) $aDate[1];
					$aContact['BirthDay'] = (int) $aDate[2];
				}
			}
		}

		if (isset($oVCard->ORG))
		{
			$aOrgs = $oVCard->ORG->getParts();

			if (count($aOrgs) >= 2)
			{
				$aContact['BusinessCompany'] = !empty($aOrgs[0]) ? (string) $aOrgs[0] : '';
				$aContact['BusinessDepartment'] = !empty($aOrgs[1]) ? (string) $aOrgs[1] : '';
			}
		}

		$aContact['BusinessJobTitle'] = isset($oVCard->TITLE) ? (string) $oVCard->TITLE : '';

		if (isset($oVCard->ADR))
		{
			foreach($oVCard->ADR as $oAdr)
			{
				$aAdrs = $oAdr->getParts();
				$oTypes = $oAdr['TYPE'];
				if ($oTypes)
				{
					if ($oTypes->has('WORK'))
					{
						$aContact['BusinessAddress'] = isset($aAdrs[2]) ? (string) $aAdrs[2] : '';
						$aContact['BusinessCity'] = isset($aAdrs[3]) ? (string) $aAdrs[3] : '';
						$aContact['BusinessState'] = isset($aAdrs[4]) ? (string) $aAdrs[4] : '';
						$aContact['BusinessZip'] = isset($aAdrs[5]) ? (string) $aAdrs[5] : '';
						$aContact['BusinessCountry'] = isset($aAdrs[6]) ? (string) $aAdrs[6] : '';
					}
					if ($oTypes->has('HOME'))
					{
						$aContact['PersonalAddress'] = isset($aAdrs[2]) ? (string) $aAdrs[2] : '';
						$aContact['PersonalCity'] = isset($aAdrs[3]) ? (string) $aAdrs[3] : '';
						$aContact['PersonalState'] = isset($aAdrs[4]) ? (string) $aAdrs[4] : '';
						$aContact['PersonalZip'] = isset($aAdrs[5]) ? (string) $aAdrs[5] : '';
						$aContact['PersonalCountry'] = isset($aAdrs[6]) ? (string) $aAdrs[6] : '';
					}
				}
				else
				{
					$aContact['PersonalAddress'] = isset($aAdrs[2]) ? (string) $aAdrs[2] : '';
					$aContact['PersonalCity'] = isset($aAdrs[3]) ? (string) $aAdrs[3] : '';
					$aContact['PersonalState'] = isset($aAdrs[4]) ? (string) $aAdrs[4] : '';
					$aContact['PersonalZip'] = isset($aAdrs[5]) ? (string) $aAdrs[5] : '';
					$aContact['PersonalCountry'] = isset($aAdrs[6]) ? (string) $aAdrs[6] : '';
				}
			}
		}

		if (isset($oVCard->EMAIL))
		{
			foreach($oVCard->EMAIL as $oEmail)
			{
				$oType = $oEmail['TYPE'];
				if ($oType)
				{
					if ($oType->has('WORK') || $oType->has('INTERNET'))
					{
						$aContact['BusinessEmail'] = (string) $oEmail;
						if ($oType->has('PREF'))
						{
							$aContact['PrimaryEmail'] = \Aurora\Modules\Contacts\Enums\PrimaryEmail::Business;
						}
					}
					else if ($oType->has('HOME'))
					{
						$aContact['PersonalEmail'] = (string) $oEmail;
						if ($oType->has('PREF'))
						{
							$aContact['PrimaryEmail'] = \Aurora\Modules\Contacts\Enums\PrimaryEmail::Personal;
						}
					}
					else if ($oType->has('OTHER'))
					{
						$aContact['OtherEmail'] = (string) $oEmail;
						if ($oType->has('PREF'))
						{
							$aContact['PrimaryEmail'] = \Aurora\Modules\Contacts\Enums\PrimaryEmail::Other;
						}
					}
					else if ($oEmail->group && isset($oVCard->{$oEmail->group.'.X-ABLABEL'}) &&
						strtolower((string) $oVCard->{$oEmail->group.'.X-ABLABEL'}) === '_$!<other>!$_')
					{
						$aContact['OtherEmail'] = (string) $oEmail;
						if ($oType->has('PREF'))
						{
							$aContact['PrimaryEmail'] = \Aurora\Modules\Contacts\Enums\PrimaryEmail::Other;
						}
					}
				}
				else
				{
					$aContact['OtherEmail'] = (string) $oEmail;
					$aContact['PrimaryEmail'] = \Aurora\Modules\Contacts\Enums\PrimaryEmail::Other;
				}
			}
			if (empty($aContact['PrimaryEmail']))
			{
				if (!empty($aContact['BusinessEmail']))
				{
					$aContact['PrimaryEmail'] = \Aurora\Modules\Contacts\Enums\PrimaryEmail::Business;
				}
				else if (!empty($aContact['PersonalEmail']))
				{
					$aContact['PrimaryEmail'] = \Aurora\Modules\Contacts\Enums\PrimaryEmail::Personal;
				}
				else if (!empty($aContact['OtherEmail']))
				{
					$aContact['PrimaryEmail'] = \Aurora\Modules\Contacts\Enums\PrimaryEmail::Other;
				}
			}
		}

		if (isset($oVCard->URL))
		{
			foreach($oVCard->URL as $oUrl)
			{
				$oTypes = $oUrl['TYPE'];
				if ($oTypes)
				{
					if ($oTypes->has('HOME'))
					{
						$aContact['PersonalWeb'] = (string) $oUrl;
					}
					else if ($oTypes->has('WORK'))
					{
						$aContact['BusinessWeb'] = (string) $oUrl;
					}
				}
				else
				{
					$aContact['PersonalWeb'] = (string) $oUrl;
				}
			}
		}

		if (isset($oVCard->TEL))
		{
			foreach($oVCard->TEL as $oTel)
			{
				$oTypes = $oTel['TYPE'];
				if ($oTypes)
				{
					if ($oTypes->has('FAX'))
					{
						if ($oTypes->has('HOME'))
						{
							$aContact['PersonalFax'] = (string) $oTel;
						}
						if ($oTypes->has('WORK'))
						{
							$aContact['BusinessFax'] = (string) $oTel;
						}
					}
					else
					{
						if ($oTypes->has('CELL'))
						{
							$aContact['PersonalMobile'] = (string) $oTel;
						}
						else if ($oTypes->has('HOME'))
						{
							$aContact['PersonalPhone'] = (string) $oTel;
						}
						else if ($oTypes->has('WORK'))
						{
							$aContact['BusinessPhone'] = (string) $oTel;
						}
					}
				}
				else
				{
					$aContact['PersonalPhone'] = (string) $oTel;
				}
			}
		}

		if (isset($oVCard->{'X-OFFICE'}))
		{
			$aContact['BusinessOffice'] = (string) $oVCard->{'X-OFFICE'};
		}

		if (isset($oVCard->{'X-USE-FRIENDLY-NAME'}))
		{
			$aContact['UseFriendlyName'] = '1' === (string) $oVCard->{'X-USE-FRIENDLY-NAME'};
		}
		
		return $aContact;
	}
	
	/**
	* @param \Aurora\Modules\Contacts\Classes\Contact $oContact
	* @param \Sabre\VObject\Component $oVCard
	* @return void
	*/
	public static function UpdateVCardAddressesFromContact($oContact, &$oVCard)
	{
		$bFindHome = false;
		$bFindWork = false;

		$oVCardCopy = clone $oVCard;

		$sADRHome = array(
			'',
			'',
			$oContact->PersonalAddress,
			$oContact->PersonalCity,
			$oContact->PersonalState,
			$oContact->PersonalZip,
			$oContact->PersonalCountry
		);

		if (empty($oContact->PersonalAddress) && empty($oContact->PersonalCity) &&
				empty($oContact->PersonalState) && empty($oContact->PersonalZip) &&
						empty($oContact->PersonalCountry))
		{
			$bFindHome = true;
		}

		$sADRWork = array(
			'',
			'',
			$oContact->BusinessAddress,
			$oContact->BusinessCity,
			$oContact->BusinessState,
			$oContact->BusinessZip,
			$oContact->BusinessCountry
		);

		if (empty($oContact->BusinessAddress) && empty($oContact->BusinessCity) &&
				empty($oContact->BusinessState) && empty($oContact->BusinessZip) &&
						empty($oContact->BusinessCountry))
		{
			$bFindWork = true;
		}

		if (isset($oVCardCopy->ADR))
		{
			unset($oVCard->ADR);
			foreach ($oVCardCopy->ADR as $oAdr)
			{
				if ($oTypes = $oAdr['TYPE'])
				{
					if ($oTypes->has('HOME'))
					{
						if ($bFindHome)
						{
							unset($oAdr);
						}
						else
						{
							$oAdr->setValue($sADRHome);
							$bFindHome = true;
						}
					}
					if ($oTypes->has('WORK'))
					{
						if ($bFindWork)
						{
							unset($oAdr);
						}
						else
						{
							$oAdr->setValue($sADRWork);
							$bFindWork = true;
						}
					}
				}
				if (isset($oAdr))
				{
					$oVCard->add($oAdr);
				}
			}
		}

		if (!$bFindHome)
		{
			$oVCard->add('ADR', $sADRHome, array('TYPE' => array('HOME')));
		}
		if (!$bFindWork)
		{
			$oVCard->add('ADR', $sADRWork, array('TYPE' => array('WORK')));
		}
	}

	/**
	* @param \Aurora\Modules\Contacts\Classes\Contact $oContact
	* @param \Sabre\VObject\Component\VCard $oVCard
	* @return void
	*/
	public static function UpdateVCardEmailsFromContact($oContact, &$oVCard)
	{
		$bFindHome = (empty($oContact->PersonalEmail)) ? false : true;
		$bFindWork = (empty($oContact->BusinessEmail)) ? false : true;
		$bFindOther = (empty($oContact->OtherEmail)) ? false : true;

		$oVCardCopy = clone $oVCard;

		if (isset($oVCardCopy->EMAIL))
		{
			unset($oVCard->EMAIL);
			foreach ($oVCardCopy->EMAIL as $oEmail)
			{
				if ($oTypes = $oEmail['TYPE'])
				{
					$aTypes = array();
					foreach ($oTypes as $sType)
					{
						if ('PREF' !== strtoupper($sType))
						{
							$aTypes[] = $sType;
						}
					}
					$oTypes->setValue($aTypes);

					if ($oTypes->has('HOME'))
					{
						if (!$bFindHome)
						{
							unset($oEmail);
						}
						else
						{
							$bFindHome = false;
							if ($oContact->PrimaryEmail == \Aurora\Modules\Contacts\Enums\PrimaryEmail::Personal)
							{
								$oTypes->addValue('PREF');
							}
							$oEmail->setValue($oContact->PersonalEmail);
						}
					}
					else if ($oTypes->has('WORK'))
					{
						if (!$bFindWork)
						{
							unset($oEmail);
						}
						else
						{
							$bFindWork = false;
							if ($oContact->PrimaryEmail == \Aurora\Modules\Contacts\Enums\PrimaryEmail::Business)
							{
								$oTypes->addValue('PREF');
							}
							$oEmail->setValue($oContact->BusinessEmail);
						}
					}
					else if ($oTypes->has('OTHER'))
					{
						if (!$bFindOther)
						{
							unset($oEmail);
						}
						else
						{
							$bFindOther = false;
							if ($oContact->PrimaryEmail == \Aurora\Modules\Contacts\Enums\PrimaryEmail::Other)
							{
								$oTypes->addValue('PREF');
							}
							$oEmail->setValue($oContact->OtherEmail);
						}
					}
					else if ($oEmail->group && isset($oVCardCopy->{$oEmail->group.'.X-ABLabel'}) &&
							(strtolower((string) $oVCardCopy->{$oEmail->group.'.X-ABLabel'}) === '_$!<other>!$_') ||
							(strtolower((string) $oVCardCopy->{$oEmail->group.'.X-ABLabel'}) === 'other'))
					{
						if (!$bFindOther)
						{
							unset($oVCardCopy->{$oEmail->group.'.X-ABLabel'});
							unset($oEmail);
						}
						else
						{
							$bFindOther = false;
							if ($oContact->PrimaryEmail == \Aurora\Modules\Contacts\Enums\PrimaryEmail::Other)
							{
								$oTypes->addValue('PREF');
							}
							$oEmail->setValue($oContact->OtherEmail);
						}
					}
						
				}
				if (isset($oEmail))
				{
					$oVCard->add($oEmail);
				}
			}
		}
		
		if ($bFindHome)
		{
			$aTypes = array('HOME');
			if ($oContact->PrimaryEmail == \Aurora\Modules\Contacts\Enums\PrimaryEmail::Personal)
			{
				$aTypes[] = 'PREF';
			}
			$oEmail = $oVCard->add('EMAIL', $oContact->PersonalEmail, array('TYPE' => $aTypes));
		}
		if ($bFindWork)
		{
			$aTypes = array('WORK');
			if ($oContact->PrimaryEmail == \Aurora\Modules\Contacts\Enums\PrimaryEmail::Business)
			{
				$aTypes[] = 'PREF';
			}
			$oEmail = $oVCard->add('EMAIL', $oContact->BusinessEmail, array('TYPE' => $aTypes));
		}
		if ($bFindOther)
		{
			$aTypes = array('OTHER');
			if ($oContact->PrimaryEmail == \Aurora\Modules\Contacts\Enums\PrimaryEmail::Other)
			{
				$aTypes[] = 'PREF';
			}			
			$oEmail = $oVCard->add('EMAIL', $oContact->OtherEmail, array('TYPE' => $aTypes));
		}
	}

	/**
	* @param \Aurora\Modules\Contacts\Classes\Contact $oContact
	* @param \Sabre\VObject\Component $oVCard
	* @return void
	*/
	public static function UpdateVCardUrlsFromContact($oContact, &$oVCard)
	{
		$bFindHome = false;
		$bFindWork = false;

		if (empty($oContact->PersonalWeb))
		{
			$bFindHome = true;
		}
		if (empty($oContact->BusinessWeb))
		{
			$bFindWork = true;
		}

		if (isset($oVCard->URL))
		{
			foreach ($oVCard->URL as $oUrl)
			{
				if ($oTypes = $oUrl['TYPE'])
				{
					if ($oTypes->has('HOME'))
					{
						if ($bFindHome)
						{
							unset($oUrl);
						}
						else
						{
							$oUrl->setValue($oContact->PersonalWeb);
							$bFindHome = true;
						}
					}
					if ($oTypes->has('WORK'))
					{
						if ($bFindWork)
						{
							unset($oUrl);
						}
						else
						{
							$oUrl->setValue($oContact->BusinessWeb);
							$bFindWork = true;
						}
					}
				}
			}
		}

		if (!$bFindHome)
		{
			$oVCard->add('URL', $oContact->PersonalWeb, array('TYPE' => array('HOME')));
		}
		if (!$bFindWork)
		{
			$oVCard->add('URL', $oContact->BusinessWeb, array('TYPE' => array('WORK')));
		}
	}

	/**
	* @param \Aurora\Modules\Contacts\Classes\Contact $oContact
	* @param \Sabre\VObject\Component\VCard $oVCard
	* @return void
	*/
	public static function UpdateVCardPhonesFromContact($oContact, &$oVCard)
	{
		$bFindHome = false;
		$bFindWork = false;
		$bFindCell = false;
		$bFindPersonalFax = false;
		$bFindWorkFax = false;

		$oVCardCopy = clone $oVCard;

		if (empty($oContact->PersonalPhone))
		{
			$bFindHome = true;
		}
		if (empty($oContact->BusinessPhone))
		{
			$bFindWork = true;
		}
		if (empty($oContact->PersonalMobile))
		{
			$bFindCell = true;
		}
		if (empty($oContact->PersonalFax))
		{
			$bFindPersonalFax = true;
		}
		if (empty($oContact->BusinessFax))
		{
			$bFindWorkFax = true;
		}

		if (isset($oVCardCopy->TEL))
		{
			unset($oVCard->TEL);
			foreach ($oVCardCopy->TEL as $oTel)
			{
				if ($oTypes = $oTel['TYPE'])
				{
					if ($oTypes->has('VOICE'))
					{
						if ($oTypes->has('HOME'))
						{
							if ($bFindHome)
							{
								unset($oTel);
							}
							else
							{
								$oTel->setValue($oContact->PersonalPhone);
								$bFindHome = true;
							}
						}
						if ($oTypes->has('WORK'))
						{
							if ($bFindWork)
							{
								unset($oTel);
							}
							else
							{
								$oTel->setValue($oContact->BusinessPhone);
								$bFindWork = true;
							}
						}
						if ($oTypes->has('CELL'))
						{
							if ($bFindCell)
							{
								unset($oTel);
							}
							else
							{
								$oTel->setValue($oContact->PersonalMobile);
								$bFindCell = true;
							}
						}
					}
					else if ($oTypes->has('FAX'))
					{
						if ($oTypes->has('HOME'))
						{
							if ($bFindPersonalFax)
							{
								unset($oTel);
							}
							else
							{
								$oTel->setValue($oContact->PersonalFax);
								$bFindPersonalFax = true;
							}
						}
						if ($oTypes->has('WORK'))
						{
							if ($bFindWorkFax)
							{
								unset($oTel);
							}
							else
							{
								$oTel->setValue($oContact->BusinessFax);
								$bFindWorkFax = true;
							}
						}
					}
				}
				if (isset($oTel))
				{
					$oVCard->add($oTel);
				}
			}
		}

		if (!$bFindHome)
		{
			$oVCard->add('TEL', $oContact->PersonalPhone, array('TYPE' => array('VOICE', 'HOME')));
		}
		if (!$bFindWork)
		{
			$oVCard->add('TEL', $oContact->BusinessPhone, array('TYPE' => array('VOICE', 'WORK')));
		}
		if (!$bFindCell)
		{
			$oVCard->add('TEL', $oContact->PersonalMobile, array('TYPE' => array('VOICE', 'CELL')));
		}
		if (!$bFindPersonalFax)
		{
			$oVCard->add('TEL', $oContact->PersonalFax, array('TYPE' => array('FAX', 'HOME')));
		}
		if (!$bFindWorkFax)
		{
			$oVCard->add('TEL', $oContact->BusinessFax, array('TYPE' => array('FAX', 'WORK')));
		}
	}

	/**
	* @param \Aurora\Modules\Contacts\Classes\Contact $oContact
	* @param \Sabre\VObject\Component $oVCard
	* @param bool $bIsUpdate = false
	* @return void
	*/
	public static function UpdateVCardFromContact($oContact, &$oVCard, $bIsUpdate = false)
	{
		$oVCard->VERSION = '3.0';

		$oVCard->UID = $oContact->UUID;

		$oVCard->FN = $oContact->FullName;
		$oVCard->N = array(
			$oContact->LastName,
			$oContact->FirstName,
			'',
			$oContact->Title,
			'',
			''
		);
		$oVCard->{'X-OFFICE'} = $oContact->BusinessOffice;
		$oVCard->{'X-USE-FRIENDLY-NAME'} = $oContact->UseFriendlyName ? '1' : '0';
		$oVCard->TITLE = $oContact->BusinessJobTitle;
		$oVCard->NICKNAME = $oContact->NickName;
		$oVCard->NOTE = $oContact->Notes;
		$oVCard->ORG = array(
			$oContact->BusinessCompany,
			$oContact->BusinessDepartment
		);
		
		$aCategories = [];
		foreach ($oContact->GroupsContacts as $oGroupsContact)
		{
			$oContactsModule = \Aurora\System\Api::GetModuleDecorator('Contacts');
			$oGroup = $oContactsModule->GetGroup($oGroupsContact->GroupUUID);
			if ($oGroup)
			{
				$aCategories[] = $oGroup->Name;
			}
		}
		
		unset($oVCard->CATEGORIES);
		if (count($aCategories) > 0)
		{
			$oVCard->add('CATEGORIES')->setParts($aCategories);
		}

		self::UpdateVCardAddressesFromContact($oContact, $oVCard);
		self::UpdateVCardEmailsFromContact($oContact, $oVCard);
		self::UpdateVCardUrlsFromContact($oContact, $oVCard);
		self::UpdateVCardPhonesFromContact($oContact, $oVCard);

		unset($oVCard->BDAY);
		if ($oContact->BirthYear !== 0 && $oContact->BirthMonth !== 0 && $oContact->BirthDay !== 0)
		{
			$sBDayDT = $oContact->BirthYear.'-'.$oContact->BirthMonth.'-'.$oContact->BirthDay;
			$oVCard->add('BDAY', $sBDayDT);
		}
	}
}