poll.module 25.5 KB
Newer Older
1
<?php
2
// $Id$
3

Dries's avatar
 
Dries committed
4 5 6 7 8 9
/**
 * @file
 * Enables your site to capture votes on different topics in the form of multiple
 * choice questions.
 */

10 11 12
/**
 * Implementation of hook_help().
 */
13 14
function poll_help($path, $arg) {
  switch ($path) {
Steven Wittens's avatar
Steven Wittens committed
15
    case 'admin/help#poll':
16 17 18
      $output = '<p>' . t('The poll module can be used to create simple polls for site users. A poll is a simple, multiple choice questionnaire which displays the cumulative results of the answers to the poll. Having polls on the site is a good way to receive feedback from community members.') . '</p>';
      $output .= '<p>' . t('When creating a poll, enter the question being posed, as well as the potential choices (and beginning vote counts for each choice). The status and duration (length of time the poll remains active for new votes) can also be specified. Use the <a href="@poll">poll</a> menu item to view all current polls. To vote in or view the results of a specific poll, click on the poll itself.', array('@poll' => url('poll'))) . '</p>';
      $output .= '<p>' . t('For more information, see the online handbook entry for <a href="@poll">Poll module</a>.', array('@poll' => 'http://drupal.org/handbook/modules/poll/')) . '</p>';
19
      return $output;
Steven Wittens's avatar
Steven Wittens committed
20
  }
21 22
}

23 24 25 26
/**
 * Implementation of hook_init().
 */
function poll_init() {
27
  drupal_add_css(drupal_get_path('module', 'poll') . '/poll.css');
28 29
}

30
/**
31
 * Implementation of hook_theme().
32 33 34
 */
function poll_theme() {
  return array(
35
    'poll_vote' => array(
36
      'template' => 'poll-vote',
37 38
      'arguments' => array('form' => NULL),
    ),
39 40 41
    'poll_choices' => array(
      'arguments' => array('form' => NULL),
    ),
42
    'poll_results' => array(
43
      'template' => 'poll-results',
44
      'arguments' => array('raw_title' => NULL, 'results' => NULL, 'votes' => NULL, 'raw_links' => NULL, 'block' => NULL, 'nid' => NULL, 'vote' => NULL),
45 46
    ),
    'poll_bar' => array(
47
      'template' => 'poll-bar',
48
      'arguments' => array('title' => NULL, 'votes' => NULL, 'total_votes' => NULL, 'vote' => NULL, 'block' => NULL),
49 50 51 52
    ),
  );
}

53 54 55 56
/**
 * Implementation of hook_perm().
 */
function poll_perm() {
57 58 59 60 61 62 63 64
  $perms = node_list_permissions('poll');
  $perms += array(
    'vote on polls' => t('Cast votes on polls.'),
    'cancel own vote' => t('Retract and optionally change own votes.'),
    'inspect all votes' => t('View voting results.'),
  );

  return $perms;
65 66
}

67 68 69
/**
 * Implementation of hook_access().
 */
70
function poll_access($op, $node, $account) {
71 72
  switch ($op) {
    case 'create':
73
      return user_access('create poll content', $account);
74
    case 'update':
75
      return user_access('edit any poll content', $account) || (user_access('edit own poll content', $account) && ($node->uid == $account->uid));
76 77
    case 'delete':
      return user_access('delete any poll content', $account) || (user_access('delete own poll content', $account) && ($node->uid == $account->uid));
Dries's avatar
 
Dries committed
78
  }
Steven Wittens's avatar
Steven Wittens committed
79 80
}

81 82 83 84 85 86 87 88 89 90 91 92 93 94 95 96 97 98 99 100 101 102 103 104 105 106 107 108 109 110
/**
 * Implementation of hook_menu().
 */
function poll_menu() {
  $items['poll'] = array(
    'title' => 'Polls',
    'page callback' => 'poll_page',
    'access arguments' => array('access content'),
    'type' => MENU_SUGGESTED_ITEM,
  );

  $items['node/%node/votes'] = array(
    'title' => 'Votes',
    'page callback' => 'poll_votes',
    'page arguments' => array(1),
    'access callback' => '_poll_menu_access',
    'access arguments' => array(1, 'inspect all votes', FALSE),
    'weight' => 3,
    'type' => MENU_LOCAL_TASK,
  );

  $items['node/%node/results'] = array(
    'title' => 'Results',
    'page callback' => 'poll_results',
    'page arguments' => array(1),
    'access callback' => '_poll_menu_access',
    'access arguments' => array(1, 'access content', TRUE),
    'weight' => 3,
    'type' => MENU_LOCAL_TASK,
  );
111 112 113 114 115 116 117 118

  $items['poll/js'] = array(
    'title' => 'Javascript Choice Form',
    'page callback' => 'poll_choice_js',
    'access arguments' => array('access content'),
    'type' => MENU_CALLBACK,
  );

119 120 121 122 123 124 125 126 127 128
  return $items;
}

/**
 * Callback function to see if a node is acceptable for poll menu items.
 */
function _poll_menu_access($node, $perm, $inspect_allowvotes) {
  return user_access($perm) && ($node->type == 'poll') && ($node->allowvotes || !$inspect_allowvotes);
}

129 130 131 132 133
/**
 * Implementation of hook_block().
 *
 * Generates a block containing the latest poll.
 */
134
function poll_block($op = 'list', $delta = '') {
Steven Wittens's avatar
Steven Wittens committed
135 136
  if (user_access('access content')) {
    if ($op == 'list') {
137
      $blocks['recent']['info'] = t('Most recent poll');
Dries's avatar
 
Dries committed
138 139
      return $blocks;
    }
140
    else if ($op == 'view') {
141
      // Retrieve the latest poll.
142
      $sql = db_rewrite_sql("SELECT MAX(n.created) FROM {node} n INNER JOIN {poll} p ON p.nid = n.nid WHERE n.status = 1 AND p.active = 1");
Dries's avatar
 
Dries committed
143
      $timestamp = db_result(db_query($sql));
Dries's avatar
 
Dries committed
144
      if ($timestamp) {
145
        $poll = node_load(array('type' => 'poll', 'created' => $timestamp, 'status' => 1));
Steven Wittens's avatar
Steven Wittens committed
146

Dries's avatar
 
Dries committed
147
        if ($poll->nid) {
148
          $poll = poll_view($poll, TRUE, FALSE, TRUE);
Dries's avatar
 
Dries committed
149
        }
Dries's avatar
 
Dries committed
150
      }
Steven Wittens's avatar
Steven Wittens committed
151
      $block['subject'] = t('Poll');
152
      $block['content'] = drupal_render($poll->content);
Dries's avatar
 
Dries committed
153
      return $block;
154 155 156 157
    }
  }
}

158 159 160 161 162
/**
 * Implementation of hook_cron().
 *
 * Closes polls that have exceeded their allowed runtime.
 */
163
function poll_cron() {
164
  $result = db_query('SELECT p.nid FROM {poll} p INNER JOIN {node} n ON p.nid = n.nid WHERE (n.created + p.runtime) < ' . REQUEST_TIME . ' AND p.active = 1 AND p.runtime != 0');
Dries's avatar
 
Dries committed
165
  while ($poll = db_fetch_object($result)) {
166
    db_query("UPDATE {poll} SET active = 0 WHERE nid = %d", $poll->nid);
Dries's avatar
 
Dries committed
167
  }
168 169
}

170
/**
171
 * Implementation of hook_node_info().
172
 */
173 174 175 176 177
function poll_node_info() {
  return array(
    'poll' => array(
      'name' => t('Poll'),
      'module' => 'poll',
178
      'description' => t('A <em>poll</em> is a question with a set of possible responses. A <em>poll</em>, once created, automatically provides a simple running count of the number of votes received for each response.'),
179 180 181 182
      'title_label' => t('Question'),
      'has_body' => FALSE,
    )
  );
183 184
}

185 186 187
/**
 * Implementation of hook_form().
 */
188
function poll_form(&$node, $form_state) {
189 190
  global $user;

191 192
  $admin = user_access('administer nodes') || user_access('edit any poll content') || (user_access('edit own poll content') && $user->uid == $node->uid);

193
  $type = node_get_types('type', $node);
194 195 196 197 198

  $form = array(
    '#cache' => TRUE,
  );

199 200 201 202 203
  $form['title'] = array(
    '#type' => 'textfield',
    '#title' => check_plain($type->title_label),
    '#required' => TRUE,
    '#default_value' => $node->title,
204
    '#weight' => -5,
205
  );
206

207 208
  if (isset($form_state['choice_count'])) {
    $choice_count = $form_state['choice_count'];
209 210
  }
  else {
211
    $choice_count = max(2, empty($node->choice) ? 2 : count($node->choice));
212 213
  }

214 215 216
  // Add a wrapper for the choices and more button.
  $form['choice_wrapper'] = array(
    '#tree' => FALSE,
217
    '#weight' => -4,
218 219
    '#prefix' => '<div class="clear-block" id="poll-choice-wrapper">',
    '#suffix' => '</div>',
220
  );
221

222 223 224
  // Container for just the poll choices.
  $form['choice_wrapper']['choice'] = array(
    '#prefix' => '<div id="poll-choices">',
225
    '#suffix' => '</div>',
226
    '#theme' => 'poll_choices',
227 228
  );

229
  // Add the current choices to the form.
230 231 232 233 234 235 236 237 238 239 240
  $delta = 0;
  $weight = 0;
  if (isset($node->choice)) {
    $delta = count($node->choice);
    $weight = -$delta;
    foreach ($node->choice as $chid => $choice) {
      $key = 'chid:'. $chid;
      $form['choice_wrapper']['choice'][$key] = _poll_choice_form($key, $choice['chid'], $choice['chtext'], $choice['chvotes'], $choice['weight'], $choice_count);
      $weight = ($choice['weight'] > $weight) ? $choice['weight'] : $weight;
    }
  }
241

242 243 244 245 246
  // Add initial or additional choices.
  $existing_delta = $delta;
  for ($delta; $delta < $choice_count; $delta++) {
    $key = 'new:'. ($delta - $existing_delta);
    $form['choice_wrapper']['choice'][$key] = _poll_choice_form($key, NULL, '', 0, $weight, $choice_count);
247 248 249 250 251 252 253 254
  }

  // We name our button 'poll_more' to avoid conflicts with other modules using
  // AHAH-enabled buttons with the id 'more'.
  $form['choice_wrapper']['poll_more'] = array(
    '#type' => 'submit',
    '#value' => t('More choices'),
    '#description' => t("If the amount of boxes above isn't enough, click here to add more choices."),
255
    '#weight' => 1,
256 257 258 259 260 261 262
    '#submit' => array('poll_more_choices_submit'), // If no javascript action.
    '#ahah' => array(
      'path' => 'poll/js',
      'wrapper' => 'poll-choices',
      'method' => 'replace',
      'effect' => 'fade',
    ),
263 264
  );

Steven Wittens's avatar
Steven Wittens committed
265
  // Poll attributes
266 267 268 269 270 271 272 273 274 275
  $duration = array(0 => t('Unlimited')) + drupal_map_assoc(array(86400, 172800, 345600, 604800, 1209600, 2419200, 4838400, 9676800, 31536000), "format_interval");
  $active = array(0 => t('Closed'), 1 => t('Active'));

  $form['settings'] = array(
    '#type' => 'fieldset',
    '#collapsible' => TRUE,
    '#title' => t('Poll settings'),
    '#weight' => -3,
    '#access' => $admin,
  );
276

277 278 279 280 281 282 283 284
  $form['settings']['active'] = array(
    '#type' => 'radios',
    '#title' => t('Poll status'),
    '#default_value' => isset($node->active) ? $node->active : 1,
    '#options' => $active,
    '#description' => t('When a poll is closed, visitors can no longer vote for it.'),
    '#access' => $admin,
  );
285 286 287
  $form['settings']['runtime'] = array(
    '#type' => 'select',
    '#title' => t('Poll duration'),
288
    '#default_value' => isset($node->runtime) ? $node->runtime : 0,
289
    '#options' => $duration,
290 291
    '#description' => t('After this period, the poll will be closed automatically.'),
  );
Dries's avatar
 
Dries committed
292

293
  return $form;
294
}
295

296 297 298 299 300 301 302 303 304 305 306 307 308 309 310
/**
 * Submit handler to add more choices to a poll form. This handler is used when
 * javascript is not available. It makes changes to the form state and the
 * entire form is rebuilt during the page reload.
 */
function poll_more_choices_submit($form, &$form_state) {
  // Set the form to rebuild and run submit handlers.
  node_form_submit_build_node($form, $form_state);

  // Make the changes we want to the form state.
  if ($form_state['values']['poll_more']) {
    $form_state['choice_count'] = count($form_state['values']['choice']) + 5;
  }
}

311
function _poll_choice_form($key, $chid = NULL, $value = '', $votes = 0, $weight = 0, $size = 10) {
312 313 314 315 316 317 318 319
  $admin = user_access('administer nodes');

  $form = array(
    '#tree' => TRUE,
  );

  // We'll manually set the #parents property of these fields so that
  // their values appear in the $form_state['values']['choice'] array.
320 321 322 323 324 325
  $form['chid'] = array(
    '#type' => 'value',
    '#value' => $chid,
    '#parents' => array('choice', $key, 'chid'),
  );

326 327 328
  $form['chtext'] = array(
    '#type' => 'textfield',
    '#default_value' => $value,
329
    '#parents' => array('choice', $key, 'chtext'),
330 331
  );

332 333 334 335 336 337 338 339 340 341 342 343 344 345 346
  $form['chvotes'] = array(
    '#type' => 'textfield',
    '#default_value' => $votes,
    '#size' => 5,
    '#maxlength' => 7,
    '#parents' => array('choice', $key, 'chvotes'),
    '#access' => user_access('administer nodes'),
  );

  $form['weight'] = array(
    '#type' => 'weight',
    '#default_value' => $weight,
    '#delta' => $size,
    '#parents' => array('choice', $key, 'weight'),
  );
347 348 349 350 351 352 353 354

  return $form;
}

/**
 * Menu callback for AHAH additions.
 */
function poll_choice_js() {
355 356 357 358 359 360 361
  // Add the new element to the stored form state. Without adding the element
  // to the form, Drupal is not aware of this new elements existence and will
  // not process it. We retreive the cached form, add the element, and resave.
  $form_build_id = $_POST['form_build_id'];
  $form_state = array('submitted' => FALSE);
  $form = form_get_cache($form_build_id, $form_state);

362
  $delta = count($_POST['choice']);
363 364 365 366 367 368 369
  $key = isset($form['#node']->choice) ? 'new:'. ($delta - count($form['#node']->choice)) : 'new:'. $delta;

  // Match the new choice at the current greatest weight.
  $weight = 0;
  foreach ($_POST['choice'] as $choice) {
    $weight = $choice['weight'] > $weight ? $choice['weight'] : $weight;
  }
370 371

  // Build our new form element.
372
  $form_element = _poll_choice_form($key, NULL, NULL, NULL, $weight, $delta + 1);
373 374
  drupal_alter('form', $form_element, array(), 'poll_choice_js');

375 376 377 378 379 380 381 382 383 384 385 386 387
  // Dynamically increase the delta of the weight field for every field added.
  foreach(element_children($form['choice_wrapper']['choice']) as $n) {
    $form['choice_wrapper']['choice'][$n]['weight']['#delta'] = $delta + 1;
  }

  // Add the new poll choice.
  $form['choice_wrapper']['choice'][$key] = $form_element;

  // Reorder the form to use the same order as post.
  $order = array_flip(array_keys($_POST['choice']));
  $form['choice_wrapper']['choice'] = array_merge($order, $form['choice_wrapper']['choice']);

  // Resave the cache.
388
  form_set_cache($form_build_id, $form, $form_state);
389 390 391 392
  $form += array(
    '#post' => $_POST,
    '#programmed' => FALSE,
  );
393 394

  // Rebuild the form.
395 396 397 398 399
  $form = form_builder('poll_node_form', $form, $form_state);

  // Render the new output.
  $choice_form = $form['choice_wrapper']['choice'];
  unset($choice_form['#prefix'], $choice_form['#suffix']); // Prevent duplicate wrappers.
400 401
  $choice_form[$key]['#attributes']['class'] = empty($choice_form[$key]['#attributes']['class']) ? 'ahah-new-content' : $choice_form[$key]['#attributes']['class'] .' ahah-new-content';
  $choice_form[$key]['chvotes']['#value'] = 0;
402 403 404 405 406
  $output = theme('status_messages') . drupal_render($choice_form);

  drupal_json(array('status' => TRUE, 'data' => $output));
}

407 408 409 410 411 412 413
/**
 * Implementation of hook_submit().
 */
function poll_node_form_submit(&$form, &$form_state) {
  // Renumber fields
  $form_state['values']['choice'] = array_values($form_state['values']['choice']);
  $form_state['values']['teaser'] = poll_teaser((object)$form_state['values']);
414 415
}

Dries's avatar
 
Dries committed
416
/**
417
 * Implementation of hook_validate().
Dries's avatar
 
Dries committed
418
 */
419 420 421 422 423 424 425 426 427 428
function poll_validate($node) {
  if (isset($node->title)) {
    // Check for at least two options and validate amount of votes:
    $realchoices = 0;
    // Renumber fields
    $node->choice = array_values($node->choice);
    foreach ($node->choice as $i => $choice) {
      if ($choice['chtext'] != '') {
        $realchoices++;
      }
429
      if (isset($choice['chvotes']) && $choice['chvotes'] < 0) {
430 431 432
        form_set_error("choice][$i][chvotes", t('Negative values are not allowed.'));
      }
    }
Dries's avatar
 
Dries committed
433

434 435 436 437
    if ($realchoices < 2) {
      form_set_error("choice][$realchoices][chtext", t('You must fill in at least two choices.'));
    }
  }
438 439
}

440 441 442
/**
 * Implementation of hook_load().
 */
443
function poll_load($node) {
444 445 446
  global $user;

  $poll = db_fetch_object(db_query("SELECT runtime, active FROM {poll} WHERE nid = %d", $node->nid));
Dries's avatar
 
Dries committed
447

448
  // Load the appropriate choices into the $poll object.
449
  $result = db_query("SELECT chid, chtext, chvotes, weight FROM {poll_choices} WHERE nid = %d ORDER BY weight", $node->nid);
Steven Wittens's avatar
Steven Wittens committed
450
  while ($choice = db_fetch_array($result)) {
451
    $poll->choice[$choice['chid']] = $choice;
452
  }
453

454
  // Determine whether or not this user is allowed to vote.
455 456 457
  $poll->allowvotes = FALSE;
  if (user_access('vote on polls') && $poll->active) {
    if ($user->uid) {
458
      $result = db_fetch_object(db_query('SELECT chid FROM {poll_votes} WHERE nid = %d AND uid = %d', $node->nid, $user->uid));
459 460
    }
    else {
461
      $result = db_fetch_object(db_query("SELECT chid FROM {poll_votes} WHERE nid = %d AND hostname = '%s'", $node->nid, ip_address()));
462
    }
463 464
    if (isset($result->chid)) {
      $poll->vote = $result->chid;
465 466 467 468 469 470
    }
    else {
      $poll->vote = -1;
      $poll->allowvotes = TRUE;
    }
  }
471 472
  return $poll;
}
Dries's avatar
 
Dries committed
473

474
/**
475
 * Implementation of hook_insert().
476
 */
477 478 479 480 481 482 483 484 485 486 487 488 489
function poll_insert($node) {
  if (!user_access('administer nodes')) {
    // Make sure all votes are 0 initially
    foreach ($node->choice as $i => $choice) {
      $node->choice[$i]['chvotes'] = 0;
    }
    $node->active = 1;
  }

  db_query("INSERT INTO {poll} (nid, runtime, active) VALUES (%d, %d, %d)", $node->nid, $node->runtime, $node->active);

  foreach ($node->choice as $choice) {
    if ($choice['chtext'] != '') {
490
      db_query("INSERT INTO {poll_choices} (nid, chtext, chvotes, weight) VALUES (%d, '%s', %d, %d)", $node->nid, $choice['chtext'], $choice['chvotes'], $choice['weight']);
491 492 493 494 495 496 497 498
    }
  }
}

/**
 * Implementation of hook_update().
 */
function poll_update($node) {
499
  // Update poll settings.
500 501
  db_query('UPDATE {poll} SET runtime = %d, active = %d WHERE nid = %d', $node->runtime, $node->active, $node->nid);

502 503 504 505 506 507 508 509 510
  // Poll choices with empty titles signifies removal. We remove all votes to
  // the removed options, so people who voted on them can vote again.
  foreach ($node->choice as $key => $choice) {
    if (!empty($choice['chtext'])) {
      if (isset($choice['chid'])) {
        db_query("UPDATE {poll_choices} SET chtext = '%s', chvotes = %d, weight = %d WHERE chid = %d", $choice['chtext'], (int)$choice['chvotes'], $choice['weight'], $choice['chid']);
      }
      else {
        db_query("INSERT INTO {poll_choices} (nid, chtext, chvotes, weight) VALUES (%d, '%s', %d, %d)", $node->nid, $choice['chtext'], (int)$choice['chvotes'], $choice['weight']);
511 512 513
      }
    }
    else {
514
      db_query("DELETE FROM {poll_votes} WHERE nid = %d AND chid = %d", $node->nid, $key);
515 516 517 518 519 520 521 522 523 524 525 526 527 528 529 530 531 532 533 534 535 536 537 538 539 540 541 542 543 544 545 546
    }
  }
}

/**
 * Implementation of hook_delete().
 */
function poll_delete($node) {
  db_query("DELETE FROM {poll} WHERE nid = %d", $node->nid);
  db_query("DELETE FROM {poll_choices} WHERE nid = %d", $node->nid);
  db_query("DELETE FROM {poll_votes} WHERE nid = %d", $node->nid);
}

/**
 * Implementation of hook_view().
 *
 * @param $block
 *   An extra parameter that adapts the hook to display a block-ready
 *   rendering of the poll.
 */
function poll_view($node, $teaser = FALSE, $page = FALSE, $block = FALSE) {
  global $user;
  $output = '';

  // Special display for side-block
  if ($block) {
    // No 'read more' link
    $node->readmore = FALSE;

    $links = module_invoke_all('link', 'node', $node, 1);
    $links[] = array('title' => t('Older polls'), 'href' => 'poll', 'attributes' => array('title' => t('View the list of polls on this site.')));
    if ($node->allowvotes && $block) {
547
      $links[] = array('title' => t('Results'), 'href' => 'node/' . $node->nid . '/results', 'attributes' => array('title' => t('View the current poll results.')));
548 549 550 551 552 553 554
    }

    $node->links = $links;
  }

  if (!empty($node->allowvotes) && ($block || empty($node->show_results))) {
    $node->content['body'] = array(
555
      '#markup' => drupal_get_form('poll_view_voting', $node, $block),
556 557 558 559
    );
  }
  else {
    $node->content['body'] = array(
560
      '#markup' => poll_view_results($node, $teaser, $page, $block),
561 562 563
    );
  }
  return $node;
564
}
565

566
/**
567
 * Creates a simple teaser that lists all the choices.
568 569
 *
 * This is primarily used for RSS.
570
 */
571
function poll_teaser($node) {
572
  $teaser = NULL;
Dries's avatar
Dries committed
573
  if (is_array($node->choice)) {
Steven Wittens's avatar
Steven Wittens committed
574
    foreach ($node->choice as $k => $choice) {
575
      if ($choice['chtext'] != '') {
576
        $teaser .= '* ' . check_plain($choice['chtext']) . "\n";
577
      }
578 579 580 581
    }
  }
  return $teaser;
}
582

Steven Wittens's avatar
Steven Wittens committed
583
/**
584
 * Generates the voting form for a poll.
585 586 587 588
 *
 * @ingroup forms
 * @see poll_vote()
 * @see phptemplate_preprocess_poll_vote()
Steven Wittens's avatar
Steven Wittens committed
589
 */
590
function poll_view_voting(&$form_state, $node, $block) {
Dries's avatar
 
Dries committed
591
  if ($node->choice) {
Steven Wittens's avatar
Steven Wittens committed
592 593
    $list = array();
    foreach ($node->choice as $i => $choice) {
594
      $list[$i] = check_plain($choice['chtext']);
595
    }
596 597 598 599 600
    $form['choice'] = array(
      '#type' => 'radios',
      '#default_value' => -1,
      '#options' => $list,
    );
Dries's avatar
 
Dries committed
601
  }
602

603
  $form['vote'] = array(
604
    '#type' => 'submit',
605 606 607 608 609 610 611 612 613 614 615 616 617 618
    '#value' => t('Vote'),
    '#submit' => array('poll_vote'),
  );

  // Store the node so we can get to it in submit functions.
  $form['#node'] = $node;
  $form['#block'] = $block;

  // Set form caching because we could have multiple of these forms on
  // the same page, and we want to ensure the right one gets picked.
  $form['#cache'] = TRUE;

  // Provide a more cleanly named voting form theme.
  $form['#theme'] = 'poll_vote';
619
  return $form;
620
}
Steven Wittens's avatar
Steven Wittens committed
621

622 623 624 625 626 627 628 629 630
/**
 * Validation function for processing votes
 */
function poll_view_voting_validate($form, &$form_state) {
  if ($form_state['values']['choice'] == -1) {
    form_set_error( 'choice', t('Your vote could not be recorded because you did not select any of the choices.'));
  }
}

631 632 633 634 635 636 637 638 639
/**
 * Submit handler for processing a vote
 */
function poll_vote($form, &$form_state) {
  $node = $form['#node'];
  $choice = $form_state['values']['choice'];

  global $user;
  if ($user->uid) {
640
    db_query('INSERT INTO {poll_votes} (nid, chid, uid) VALUES (%d, %d, %d)', $node->nid, $choice, $user->uid);
641 642
  }
  else {
643
    db_query("INSERT INTO {poll_votes} (nid, chid, hostname) VALUES (%d, %d, '%s')", $node->nid, $choice, ip_address());
644 645 646
  }

  // Add one to the votes.
647
  db_query("UPDATE {poll_choices} SET chvotes = chvotes + 1 WHERE chid = %d", $choice);
648 649 650 651 652 653 654

  cache_clear_all();
  drupal_set_message(t('Your vote was recorded.'));

  // Return the user to whatever page they voted from.
}

655 656
/**
 * Themes the voting form for a poll.
657 658
 *
 * Inputs: $form
659
 */
660 661 662 663 664 665 666
function template_preprocess_poll_vote(&$variables) {
  $form = $variables['form'];
  $variables['choice'] = drupal_render($form['choice']);
  $variables['title'] = check_plain($form['#node']->title);
  $variables['vote'] = drupal_render($form['vote']);
  $variables['rest'] = drupal_render($form);
  $variables['block'] = $form['#block'];
667 668 669 670
  // If this is a block, allow a different tpl.php to be used.
  if ($variables['block']) {
    $variables['template_files'][] = 'poll-vote-block';
  }
Steven Wittens's avatar
Steven Wittens committed
671 672
}

673 674 675
/**
 * Generates a graphical representation of the results of a poll.
 */
Dries's avatar
Dries committed
676
function poll_view_results(&$node, $teaser, $page, $block) {
Steven Wittens's avatar
Steven Wittens committed
677
  // Count the votes and find the maximum
678 679
  $total_votes = 0;
  $max_votes = 0;
Steven Wittens's avatar
Steven Wittens committed
680
  foreach ($node->choice as $choice) {
681 682 683 684
    if (isset($choice['chvotes'])) {
      $total_votes += $choice['chvotes'];
      $max_votes = max($max_votes, $choice['chvotes']);
    }
Steven Wittens's avatar
Steven Wittens committed
685 686
  }

687
  $poll_results = '';
Steven Wittens's avatar
Steven Wittens committed
688
  foreach ($node->choice as $i => $choice) {
689
    if (!empty($choice['chtext'])) {
690
      $chvotes = isset($choice['chvotes']) ? $choice['chvotes'] : NULL;
691
      $poll_results .= theme('poll_bar', $choice['chtext'], $chvotes, $total_votes, isset($node->vote) && $node->vote == $i, $block);
692
    }
693
  }
Steven Wittens's avatar
Steven Wittens committed
694

695
  return theme('poll_results', $node->title, $poll_results, $total_votes, isset($node->links) ? $node->links : array(), $block, $node->nid, isset($node->vote) ? $node->vote : NULL);
Steven Wittens's avatar
Steven Wittens committed
696 697
}

698 699 700

/**
 * Theme the admin poll form for choices.
701 702
 *
 * @ingroup themeable
703 704
 */
function theme_poll_choices($form) {
705
  drupal_add_tabledrag('poll-choice-table', 'order', 'sibling', 'poll-weight');
706

707
  $delta = 0;
708 709
  $rows = array();
  $headers = array(
710
    '',
711 712
    t('Choice'),
    t('Vote count'),
713
    t('Weight'),
714 715 716
  );

  foreach (element_children($form) as $key) {
717 718 719
    $delta++;
    // Set special classes for drag and drop updating.
    $form[$key]['weight']['#attributes']['class'] = 'poll-weight';
720 721 722 723

    // Build the table row.
    $row = array(
      'data' => array(
724 725 726 727
        array('class' => 'choice-flag'),
        drupal_render($form[$key]['chtext']),
        drupal_render($form[$key]['chvotes']),
        drupal_render($form[$key]['weight']),
728
      ),
729
      'class' => 'draggable',
730 731
    );

732 733 734
    // Add any additional classes set on the row.
    $row['class'] .= isset($form[$key]['#attributes']['class']) ? ' '. $form[$key]['#attributes']['class'] : '';

735 736 737
    $rows[] = $row;
  }

738
  $output = theme('table', $headers, $rows, array('id' => 'poll-choice-table'));
739 740 741 742
  $output .= drupal_render($form);
  return $output;
}

Steven Wittens's avatar
Steven Wittens committed
743
/**
744 745 746 747 748 749 750 751 752 753 754
 * Preprocess the poll_results theme hook.
 *
 * Inputs: $raw_title, $results, $votes, $raw_links, $block, $nid, $vote. The
 * $raw_* inputs to this are naturally unsafe; often safe versions are
 * made to simply overwrite the raw version, but in this case it seems likely
 * that the title and the links may be overridden by the theme layer, so they
 * are left in with a different name for that purpose.
 *
 * @see poll-results.tpl.php
 * @see poll-results-block.tpl.php
 * @see theme_poll_results()
Steven Wittens's avatar
Steven Wittens committed
755
 */
756 757 758 759
function template_preprocess_poll_results(&$variables) {
  $variables['links'] = theme('links', $variables['raw_links']);
  if (isset($variables['vote']) && $variables['vote'] > -1 && user_access('cancel own vote')) {
    $variables['cancel_form'] = drupal_get_form('poll_cancel_form', $variables['nid']);
Steven Wittens's avatar
Steven Wittens committed
760
  }
761 762 763 764 765
  $variables['title'] = check_plain($variables['raw_title']);

  // If this is a block, allow a different tpl.php to be used.
  if ($variables['block']) {
    $variables['template_files'][] = 'poll-results-block';
Steven Wittens's avatar
Steven Wittens committed
766 767 768
  }
}

769
/**
770 771 772 773 774 775 776
 * Preprocess the poll_bar theme hook.
 *
 * Inputs: $title, $votes, $total_votes, $voted, $block
 *
 * @see poll-bar.tpl.php
 * @see poll-bar-block.tpl.php
 * @see theme_poll_bar()
777
 */
778 779 780
function template_preprocess_poll_bar(&$variables) {
  if ($variables['block']) {
    $variables['template_files'][] = 'poll-bar-block';
781
  }
782 783
  $variables['title'] = check_plain($variables['title']);
  $variables['percentage'] = round($variables['votes'] * 100 / max($variables['total_votes'], 1));
784 785
}

Steven Wittens's avatar
Steven Wittens committed
786
/**
787 788 789 790
 * Builds the cancel form for a poll.
 *
 * @ingroup forms
 * @see poll_cancel()
Steven Wittens's avatar
Steven Wittens committed
791
 */
792 793 794
function poll_cancel_form(&$form_state, $nid) {
  // Store the nid so we can get to it in submit functions.
  $form['#nid'] = $nid;
795

796
  $form['submit'] = array(
797
    '#type' => 'submit',
798 799 800
    '#value' => t('Cancel your vote'),
    '#submit' => array('poll_cancel')
  );
801

802
  $form['#cache'] = TRUE;
803

804 805
  return $form;
}
806 807

/**
808
 * Submit callback for poll_cancel_form
809
 */
810 811
function poll_cancel($form, &$form_state) {
  $node = node_load($form['#nid']);
812 813
  global $user;

814 815
  if ($user->uid) {
    db_query('DELETE FROM {poll_votes} WHERE nid = %d and uid = %d', $node->nid, $user->uid);
Steven Wittens's avatar
Steven Wittens committed
816 817
  }
  else {
818
    db_query("DELETE FROM {poll_votes} WHERE nid = %d and hostname = '%s'", $node->nid, ip_address());
Steven Wittens's avatar
Steven Wittens committed
819
  }
820 821

  // Subtract from the votes.
822
  db_query("UPDATE {poll_choices} SET chvotes = chvotes - 1 WHERE chid = %d", $node->vote);
Steven Wittens's avatar
Steven Wittens committed
823 824
}

825 826 827 828 829 830 831 832
/**
 * Implementation of hook_user().
 */
function poll_user($op, &$edit, &$user) {
  if ($op == 'delete') {
    db_query('UPDATE {poll_votes} SET uid = 0 WHERE uid = %d', $user->uid);
  }
}