/**
* Edits a contact in the system. Fills the "contact" slot.
* @param {array} $_REQUEST
* @param {string} $_REQUEST.label The label of the contact
* @param {string} $_REQUEST.contactUserId The contactUserId of the contact
* @param {string} [$_REQUEST.nickname] The nickname of the contact
* @param {string} [$_REQUEST.userId=Users::loggedInUser(true)->id] You can override the user id, if another plugin adds a hook that allows you to do this
*/
function Users_contact_put($params = array())
{
$req = array_merge($_REQUEST, $params);
Q_Request::requireFields(array('label', 'contactUserId'), $req, true);
$loggedInUserId = Users::loggedInUser(true)->id;
$userId = Q::ifset($req, 'userId', $loggedInUserId);
$label = $req['label'];
$contactUserId = $req['contactUserId'];
$nickname = Q::ifset($req, 'nickname', null);
Users::canManageContacts($loggedInUserId, $userId, $label, true);
$contact = new Users_Contact();
$contact->userId = $userId;
$contact->label = $label;
$contact->contactUserId = $contactUserId;
if (!$contact->retrieve()) {
throw new Q_Exception_MissingRow(array('table' => 'Users_Contact', 'criteria' => json_encode($contact->fields)));
}
if ($nickname) {
$contact->nickname = $nickname;
}
$contact->save();
Q_Response::setSlot('contact', $contact->exportArray());
}
/**
* Check if contact belongs to label
* @method checkLabel
* @static
* @param {string} $userId
* @param {string} $label
* @param {string} $contactId
* @return {boolean}
*/
static function checkLabel($userId, $label, $contactId)
{
if (!$userId or !$contactId) {
return null;
}
if ($userId instanceof Users_User) {
$userId = $userId->id;
}
if ($contactId instanceof Users_User) {
$contactId = $contactId->id;
}
$contact = new Users_Contact();
$contact->userId = $userId;
$contact->label = $label;
$contact->contactUserId = $contactId;
return !!$contact->retrieve();
}