You are here

Home » API reference » reCAPTCHA 8

recaptcha.module in reCAPTCHA 8

Same filename and directory in other branches
  1. 8.3 recaptcha.module
  2. 8.2 recaptcha.module
  3. 5.2 recaptcha.module
  4. 6.2 recaptcha.module
  5. 6 recaptcha.module
  6. 7.2 recaptcha.module
  7. 7 recaptcha.module

Uses the reCAPTCHA web service to improve the CAPTCHA system.

File

recaptcha.module
View source 
<?php

/**
 * @file
 * Uses the reCAPTCHA web service to improve the CAPTCHA system.
 */

/**
 * Implements hook_help().
 */
function recaptcha_help($path, $arg) {
  $output = '';
  switch ($path) {
    case 'admin/modules#name':
      $output .= t('reCAPTCHA');
      break;
    case 'admin/modules#description':
    case 'admin/user/captcha/recaptcha':
      $output .= t('Uses the <a href="@url" target="_blank">reCAPTCHA</a> web service to improve the CAPTCHA system and protect email addresses.', array(
        '@url' => url('https://www.google.com/recaptcha'),
      ));
      break;
    case 'admin/help#recaptcha':
      $output .= '<p>' . t('Uses the reCAPTCHA web service to improve the CAPTCHA module and protect email addresses. For more information on what reCAPTCHA is, visit <a href="@url" target="_blank">the official website</a>.', array(
        '@url' => url('https://www.google.com/recaptcha'),
      )) . '</p><h3>' . t('Configuration') . '</h3><p>' . t('The settings associated with reCAPTCHA can be found in the <a href="@recaptchatab">reCAPTCHA tab</a>, in the <a href="@captchasettings">CAPTCHA settings</a>. You must set your public and private reCAPTCHA keys in order to use the module. Once the public and private keys are set, visit the <a href="@captchasettings">CAPTCHA settings</a>, where you can choose where reCAPTCHA should be displayed.', array(
        '@recaptchatab' => url('admin/user/captcha/recaptcha'),
        '@captchasettings' => url('admin/user/captcha'),
      )) . '</p>';
      break;
  }
  return $output;
}

/**
 * Implements hook_theme().
 */
function recaptcha_theme() {
  return array(
    'recaptcha_custom_widget' => array(
      'variables' => array(),
      'template' => 'recaptcha-custom-widget',
    ),
  );
}

/**
 * Implements hook_menu().
 */
function recaptcha_menu() {
  $items = array();
  $items['admin/config/people/captcha/recaptcha'] = array(
    'title' => 'reCAPTCHA',
    'description' => 'Administer the reCAPTCHA web service.',
    'route_name' => 'recaptcha.settings',
  );
  return $items;
}

/**
 * Implements hook_permission().
 */
function recaptcha_permission() {
  return array(
    'administer recaptcha' => array(
      'title' => t('reCaptcha Administration'),
      'description' => t('Administer reCaptcha settings'),
    ),
  );
}

/**
 * Implements hook_captcha().
 */
function recaptcha_captcha($op, $captcha_type = '') {
  switch ($op) {
    case 'list':
      return array(
        'reCAPTCHA',
      );
    case 'generate':
      $captcha = array();
      if ($captcha_type == 'reCAPTCHA') {

        // Retrieve configuration variables.
        $recaptcha_theme = variable_get('recaptcha_theme', 'red');
        $recaptcha_tabindex = variable_get('recaptcha_tabindex', NULL);
        $recaptcha_public_key = variable_get('recaptcha_public_key', FALSE);
        $recaptcha_ajax_api = variable_get('recaptcha_ajax_api', FALSE);

        // Test if reCAPTCHA can be used, falling back to Math if it is not
        // configured, the library won't load, or the server is down.
        if (!$recaptcha_public_key || !_recaptcha_load_library() || !_recaptcha_test_recaptcha_server()) {
          return captcha_captcha('generate', 'Math');
        }
        if ($recaptcha_ajax_api) {

          // By default CAPTCHA turns off page caching on any page where a
          // CAPTCHA challenge appears. If recaptcha is using AJAX API, set
          // caching back to its old state as stored in DB.
          global $conf;
          $conf['cache'] = unserialize(db_query("SELECT value FROM {variable} WHERE name = 'cache'")
            ->fetchField());
        }
        $recaptcha_options = array(
          'theme' => $recaptcha_theme,
        );

        // Localization support.
        global $language;
        if (isset($language->language)) {

          // reCAPTCHA uses two-character language codes, so 'pt-br' must be
          // passed as 'pt'; cf. https://developers.google.com/recaptcha/docs/customization#i18n
          $recaptcha_options['lang'] = drupal_substr($language->language, 0, 2);
        }

        // Construct the Javascript, but only display it once.
        static $_recaptcha_jsadded = FALSE;
        if ($_recaptcha_jsadded == FALSE && $recaptcha_ajax_api == FALSE) {
          $_recaptcha_jsadded = TRUE;

          // Add support to display the custom theme.
          if ($recaptcha_theme == 'custom') {
            $recaptcha_options['custom_theme_widget'] = 'recaptcha_custom_theme_widget';
          }

          // Set the default tab index.
          if (!empty($recaptcha_tabindex)) {
            $recaptcha_options['tabindex'] = $recaptcha_tabindex;
          }
          drupal_add_js('var RecaptchaOptions = ' . drupal_json_encode($recaptcha_options) . ';', array(
            'type' => 'inline',
          ));
        }

        // Create the form. Captcha requires TRUE to be returned in solution.
        $captcha['solution'] = TRUE;
        $captcha['captcha_validate'] = 'recaptcha_captcha_validation';

        // If 'Disable Client-Side Cookies' is set, then add query string to
        // end of the public key string before passing to recaptchalib.
        if (variable_get('recaptcha_nocookies', FALSE)) {
          $recaptcha_public_key .= '&nocookie=1';
        }
        $captcha['form']['captcha_response'] = array(
          '#type' => 'hidden',
          '#value' => 'reCAPTCHA',
        );

        // Expose the form, either straight HTML, or using the AJAX API.
        // Build the custom theme HTML if necessary.
        $recaptcha_custom_html = $recaptcha_theme == 'custom' ? theme('recaptcha_custom_widget') : '';
        if ($recaptcha_ajax_api == FALSE) {

          // Only generate recaptcha_get_html() if we're not using the AJAX API.
          $html = recaptcha_get_html($recaptcha_public_key, NULL, TRUE);
          $captcha['form']['captcha_form'] = array(
            '#type' => 'item',
            '#markup' => (!empty($recaptcha_custom_html) ? '<div id="recaptcha_custom_theme_widget">' . $recaptcha_custom_html . '</div>' : '') . $html,
          );
        }
        else {
          $captcha['form']['captcha_form'] = array(
            '#type' => 'item',
            // Create the destination container, inserting any custom theme HTML
            // necessary ($recaptcha_custom_html will be empty if we are not
            // using custom theme).
            '#markup' => '<div id="recaptcha_ajax_api_container">' . $recaptcha_custom_html . '</div>',
          );
          drupal_add_js('https://www.google.com/recaptcha/api/js/recaptcha_ajax.js', array(
            'type' => 'external',
          ));
          $recaptcha_options['public_key'] = $recaptcha_public_key;
          $recaptcha_options['container'] = 'recaptcha_ajax_api_container';
          drupal_add_js(array(
            'recaptcha' => $recaptcha_options,
          ), 'setting');
          drupal_add_js(drupal_get_path('module', 'recaptcha') . '/recaptcha.js');
        }
      }
      return $captcha;
  }
}

/**
 * @return bool
 *   Whether or not the reCAPTCHA server is up.
 */
function _recaptcha_test_recaptcha_server() {
  $fs = @fsockopen(RECAPTCHA_VERIFY_SERVER, 80, $errno, $errstr, 10);
  if ($fs) {
    fclose($fs);
    return TRUE;
  }
  else {
    drupal_set_message(t('Unable to connect with the reCAPTCHA server (@server): @errno: @errstr', array(
      '@server' => RECAPTCHA_VERIFY_SERVER,
      '@errno' => $errno,
      '@errstr' => $errstr,
    )), 'error');
    return FALSE;
  }
}

/**
 * CAPTCHA Callback; Validates the reCAPTCHA code.
 */
function recaptcha_captcha_validation($solution = NULL, $response = NULL) {
  global $user;
  $recaptcha_private_key = variable_get('recaptcha_private_key', FALSE);
  $ip_address = ip_address();
  if ($recaptcha_private_key && $ip_address && $response === 'reCAPTCHA' && !empty($_POST['recaptcha_challenge_field']) && !empty($_POST['recaptcha_response_field']) && _recaptcha_test_recaptcha_server()) {
    $resp = recaptcha_check_answer($recaptcha_private_key, $ip_address, check_plain($_POST['recaptcha_challenge_field']), check_plain($_POST['recaptcha_response_field']));
    return $resp->is_valid;
  }
  return FALSE;
}

/**
 * Load the recaptcha library.
 */
function _recaptcha_load_library() {
  return module_load_include('php', 'recaptcha', 'recaptcha-php-1.11/recaptchalib');
}

/**
 * Prepares variables for reCAPTCHA custom widget templates.
 *
 * Default template: recaptcha-custom-widget.html.twig.
 *
 * @param array $variables
 *   An associative array which contains translations for widget interface.
 */
function template_preprocess_recaptcha_custom_widget(&$variables) {
  $variables = array(
    'recaptcha_only_if_incorrect_sol' => t('Incorrect please try again.'),
    'recaptcha_only_if_image_enter' => t('Enter the words above:'),
    'recaptcha_only_if_audio_enter' => t('Enter the words you hear:'),
    'recaptcha_get_another_captcha' => t('Get another CAPTCHA'),
    'recaptcha_only_if_image' => t('Get an audio CAPTCHA'),
    'recaptcha_only_if_audio' => t('Get an image CAPTCHA'),
    'help' => t('Help'),
  );
}

Functions

Namesort descending Description
recaptcha_captcha Implements hook_captcha().
recaptcha_captcha_validation CAPTCHA Callback; Validates the reCAPTCHA code.
recaptcha_help Implements hook_help().
recaptcha_menu Implements hook_menu().
recaptcha_permission Implements hook_permission().
recaptcha_theme Implements hook_theme().
template_preprocess_recaptcha_custom_widget Prepares variables for reCAPTCHA custom widget templates.
_recaptcha_load_library Load the recaptcha library.
_recaptcha_test_recaptcha_server