Club Drupal

 * data. Modules can cast votes with arbitrary properties and VotingAPI will

 * total them automatically. Support for basic anonymous voting by IP address,

 * multi-criteria voting, arbitrary aggregation functions, etc.

 */

/**

 * Implements of hook_menu().

    'access callback' => 'user_access',

    'access arguments' => array('administer voting api'),

    'file' => 'votingapi.admin.inc',

  );

  if (module_exists('devel_generate')) {

 */

function votingapi_permission() {

  return array(

  );

}

 * Modules that need more explicit control can call votingapi_add_votes() and

 * manage the deletion/recalculation tasks manually.

 *

 *   An array of votes, each with the following structure:

 *   $vote['entity_type']  (Optional, defaults to 'node')

 *   $vote['entity_id']    (Required)

 *   $vote['uid']           (Optional, defaults to current user)

 *   $vote['vote_source']   (Optional, defaults to current IP)

 *   $vote['timestamp']     (Optional, defaults to REQUEST_TIME)

 *   A keyed array used to determine what votes will be deleted when the current

 *   vote is cast. If no value is specified, all votes for the current content

 *   by the current user will be reset. If an empty array is passed in, no votes

 *   $criteria['vote_source']

 *   $criteria['timestamp']   (If this is set, records with timestamps

 *      GREATER THAN the set value will be selected.)

 *   An array of vote result records affected by the vote. The values are

 *   contained in a nested array keyed thusly:

 *   $value = $results[$entity_type][$entity_id][$tag][$value_type][$function]

 * Save a collection of votes to the database.

 *

 * This function does most of the heavy lifting for VotingAPI the main

 * of results. As such, it's useful for modules that must insert their votes in

 * separate batches without triggering unecessary recalculation.

 *

 *

 *   A vote or array of votes, each with the following structure:

 *   $vote['entity_type']  (Optional, defaults to 'node')

 *   $vote['entity_id']    (Required)

 *   $vote['uid']           (Optional, defaults to current user)

 *   $vote['vote_source']   (Optional, defaults to current IP)

 *   $vote['timestamp']     (Optional, defaults to REQUEST_TIME)

 *   The same votes, with vote_id keys populated.

 *

 * @see votingapi_set_votes()

 * little use for most third-party modules, unless they manually insert their

 * own result data.

 *

 *   An array of vote results, each with the following properties:

 *   $vote_result['entity_type']

 *   $vote_result['entity_id']

    foreach ($vote_results as $vote) {

      $vids[] = $vote['vote_cache_id'];

    }

  }

}

 *      GREATER THAN the set value will be selected.)

 * @param $limit

 *   An optional integer specifying the maximum number of votes to return.

 * @return

 *   An array of votes matching the criteria.

 */

    if (!empty($criteria['vote_source'])) {

      $window = variable_get('votingapi_anonymous_window', 86400);

    }

    $window = variable_get('votingapi_user_window', -1);

  }

  if ($window >= 0) {

 *      GREATER THAN the set value will be selected.)

 * @param $limit

 *   An optional integer specifying the maximum number of votes to return.

 * @return

 *   An array of vote results matching the criteria.

 */

 * responsibility for the full voting cycle: the votingapi_set_vote() function

 * recalculates automatically.

 *

 *   A string identifying the type of content being rated. Node, comment,

 *   aggregator item, etc.

 *   The key ID of the content being rated.

 *   An array of the resulting votingapi_cache records, structured thusly:

 *   $value = $results[$ag][$value_type][$function]

 *

/**

 *

 * If your module needs to determine what existing tags, value_types, etc., are

 * being supplied by other modules, call this function. Querying the votingapi

 *

 * Three major bins of data are stored: tags, value_types, and functions. Each

 * entry in these bins is keyed by the value stored in the actual VotingAPI

 * Modules can add extra keys to their entries if desired.

 *

 *

 *   An array of metadata defined by VotingAPI and altered by vote modules.

 *

 * @see hook_votingapi_metadata_alter()

function votingapi_votingapi_storage_standard_results($entity_type, $entity_id) {

  $cache = array();

  $sql .= "COUNT(v.value) as value_count, SUM(v.value) as value_sum  ";

  $sql .= "FROM {votingapi_vote} v ";

  $sql .= "WHERE v.entity_type = :type AND v.entity_id = :id AND v.value_type IN ('points', 'percent') ";

  $sql .= "GROUP BY v.value_type, v.tag";

  foreach ($results as $result) {

    $cache[$result->tag][$result->value_type]['count'] = $result->value_count;

    }

  }

  $sql .= "FROM {votingapi_vote} v ";

  $sql .= "WHERE v.entity_type = :type AND v.entity_id = :id AND v.value_type = 'option' ";

  $sql .= "GROUP BY v.value, v.tag, v.value_type";

  foreach ($results as $result) {

    $cache[$result->tag][$result->value_type]['option-' . $result->value] = $result->score;

 *

 * @param $vote

 *   A single vote.

 */

function _votingapi_prep_vote(&$vote) {

  global $user;

      'uid' => $user->uid,

      'timestamp' => REQUEST_TIME,

      'vote_source' => ip_address(),

    );

  }

}