function _captcha_insert_captcha_element in CAPTCHA 7

Same name and namespace in other branches

1. 6.2 captcha.inc \_captcha_insert_captcha_element()

Helper function to insert a CAPTCHA element in a form before a given form element.

Parameters

array $form: the form to add the CAPTCHA element to.

array $placement: information where the CAPTCHA element should be inserted. $placement should be an associative array with fields:

• 'path': path (array of path items) of the container in the form where the CAPTCHA element should be inserted.
• 'key': the key of the element before which the CAPTCHA element should be inserted. If the field 'key' is undefined or NULL, the CAPTCHA will just be appended in the container.
• 'weight': if 'key' is not NULL: should be the weight of the element defined by 'key'. If 'key' is NULL and weight is not NULL: set the weight property of the CAPTCHA element to this value.

array $captcha_element: the CAPTCHA element to insert.

1 call to _captcha_insert_captcha_element()

captcha_form_alter in ./captcha.module

Implements of hook_form_alter().

File

./captcha.inc, line 443

General CAPTCHA functionality and helper functions.

Code

function _captcha_insert_captcha_element(&$form, $placement, $captcha_element) {

  // Get path, target and target weight or use defaults if not available.
  $target_key = isset($placement['key']) ? $placement['key'] : NULL;
  $target_weight = isset($placement['weight']) ? $placement['weight'] : NULL;
  $path = isset($placement['path']) ? $placement['path'] : array();

  // Walk through the form along the path.
  $form_stepper =& $form;
  foreach ($path as $step) {
    if (isset($form_stepper[$step])) {
      $form_stepper =& $form_stepper[$step];
    }
    else {

      // Given path is invalid: stop stepping and
      // continue in best effort (append instead of insert).
      $target_key = NULL;
      break;
    }
  }

  // If no target is available: just append the CAPTCHA element to the container.
  if ($target_key == NULL || !array_key_exists($target_key, $form_stepper)) {

    // Optionally, set weight of CAPTCHA element.
    if ($target_weight != NULL) {
      $captcha_element['#weight'] = $target_weight;
    }
    $form_stepper['captcha'] = $captcha_element;
  }
  else {

    // If target has a weight: set weight of CAPTCHA element a bit smaller
    // and just append the CAPTCHA: sorting will fix the ordering anyway.
    if ($target_weight != NULL) {
      $captcha_element['#weight'] = $target_weight - 0.1;
      $form_stepper['captcha'] = $captcha_element;
    }
    else {

      // If we can't play with weights: insert the CAPTCHA element at the right position.
      // Because PHP lacks a function for this (array_splice() comes close,
      // but it does not preserve the key of the inserted element), we do it by hand:
      // chop of the end, append the CAPTCHA element and put the end back.
      $offset = array_search($target_key, array_keys($form_stepper));
      $end = array_splice($form_stepper, $offset);
      $form_stepper['captcha'] = $captcha_element;
      foreach ($end as $k => $v) {
        $form_stepper[$k] = $v;
      }
    }
  }
}