/**
* Votes for something
* @param {string} forType the type of thing to vote for
* @param {string} forId string uniquely identifying that thing among others of its type
* @param {integer} value the value the user has voted for, such as a rating etc.
*/
function Users_vote_post()
{
$user = Users::loggedInUser(true);
$required = array('forType', 'forId');
foreach ($required as $field) {
if (empty($_REQUEST[$field])) {
throw new Q_Exception_RequiredField(compact('field'));
}
}
$value = Q_Config::get('Users', 'vote', $_REQUEST['forType'], 'value', null);
if (isset($value)) {
$_REQUEST['value'] = $value;
} else {
if (!isset($_REQUEST['value'])) {
$_REQUEST['value'] = 1;
}
}
if ($_REQUEST['forType'] === 'Users/hinted') {
$hinted = Q::ifset($_SESSION, 'Users', 'hinted', array());
if (!in_array($_REQUEST['forId'], $hinted)) {
$_SESSION['Users']['hinted'][] = $_REQUEST['forId'];
}
}
$vote = new Users_Vote();
$vote->userId = $user->id;
$vote->forType = $_REQUEST['forType'];
$vote->forId = $_REQUEST['forId'];
$vote->value = $_REQUEST['value'];
$retrieved = $vote->retrieve();
/**
* @event Users/vote {before}
* @return {string}
*/
if (false === Q::event('Users/vote', compact('user', 'vote'), 'before')) {
return;
}
if (!$retrieved) {
$vote->save();
}
$vote = $vote->exportArray();
$vote['retrieved'] = $retrieved;
Users::$cache['vote'] = $vote;
}
