<?php
// $Id$

/**
 * @file
 * Allow direct creation of CAPTCHA points during installation.
 */

/**
 * Set a CAPTCHA point.
 *
 * Inserts/updates a CAPTCHA point using the form identifier, CAPTCHA module
 * name and the CAPTCHA challenge type.
 *
 * @param $form_id
 *    The identifier of the form to add a CAPTCHA challenge.
 * @param $module
 *    The module providing the CAPTCHA challenge.
 * @param $type
 *    The CAPTCHA challenge type.
 */
function install_captcha_add_captcha_point($form_id, $module, $type) {
  if (db_table_exists('captcha_points')) {
    // Update point (if already exists)
    db_query("
      UPDATE {captcha_points} SET
        module = '%s',
        type = '%s'
      WHERE form_id = '%s'
    ", $module, $type, $form_id);
    // No update -> insert row
    if (!db_affected_rows()) {
      db_query("
        INSERT INTO {captcha_points} (
          form_id, module, type
        ) VALUES (
          '%s', '%s', '%s'
        )
      ", $form_id, $module, $type);
    }
  }
}

/**
 * Remove a CAPTCHA point.
 *
 * Removes the CAPTCHA point identified by the passed form identifier.
 *
 * @param $form_id
 *    The identifier of the form to remove a CAPTCHA challenge.
 */
function install_captcha_remove_captcha_point($form_id) {
  db_query("
    DELETE FROM {captcha_points}
    WHERE form_id = '%s'
  ", $form_id);
}

/**
 * Remove default CAPTCHA points.
 *
 * Removes all default CAPTCHA points installed by the module itself.
 */
function install_captcha_remove_default_captcha_points() {
  $defaults = array(
  'comment_form', 'contact_mail_user', 'contact_mail_page',
  'user_register', 'user_pass', 'user_login', 'user_login_block'
  );
  foreach ($defaults as $form_id) {
    install_captcha_remove_captcha_point($form_id);
  }
}