You are here

number.module in Content Construction Kit (CCK) 6

Same filename and directory in other branches
  1. 6.3 modules/number/number.module
  2. 6.2 modules/number/number.module

Defines numeric field types.

File

modules/number/number.module
View source
<?php

/**
 * @file
 * Defines numeric field types.
 */

/**
 * Implementation of hook_theme().
 */
function number_theme() {
  return array(
    'number' => array(
      'arguments' => array(
        'element' => NULL,
      ),
    ),
    'number_formatter_default' => array(
      'arguments' => array(
        'element' => NULL,
      ),
      'function' => 'theme_number_formatter_generic',
    ),
    'number_formatter_us_0' => array(
      'arguments' => array(
        'element' => NULL,
      ),
      'function' => 'theme_number_formatter_generic',
    ),
    'number_formatter_us_1' => array(
      'arguments' => array(
        'element' => NULL,
      ),
      'function' => 'theme_number_formatter_generic',
    ),
    'number_formatter_us_2' => array(
      'arguments' => array(
        'element' => NULL,
      ),
      'function' => 'theme_number_formatter_generic',
    ),
    'number_formatter_be_0' => array(
      'arguments' => array(
        'element' => NULL,
      ),
      'function' => 'theme_number_formatter_generic',
    ),
    'number_formatter_be_1' => array(
      'arguments' => array(
        'element' => NULL,
      ),
      'function' => 'theme_number_formatter_generic',
    ),
    'number_formatter_fr_0' => array(
      'arguments' => array(
        'element' => NULL,
      ),
      'function' => 'theme_number_formatter_generic',
    ),
    'number_formatter_fr_1' => array(
      'arguments' => array(
        'element' => NULL,
      ),
      'function' => 'theme_number_formatter_generic',
    ),
    'number_formatter_unformatted' => array(
      'arguments' => array(
        'element' => NULL,
      ),
    ),
  );
}

/**
 * Implementation of hook_field_info().
 *
 * Here we indicate that the content module will use its default
 * handling for the view of these fields.
 *
 * Callbacks can be omitted if default handing is used.
 * They're included here just so this module can be used
 * as an example for custom modules that might do things
 * differently.
 */
function number_field_info() {
  return array(
    'number_integer' => array(
      'label' => t('Integer'),
      'description' => t('Store a number in the database as an integer.'),
      'callbacks' => array(
        'tables' => CONTENT_CALLBACK_DEFAULT,
        'arguments' => CONTENT_CALLBACK_DEFAULT,
      ),
    ),
    'number_decimal' => array(
      'label' => t('Decimal'),
      'description' => t('Store a number in the database in a fixed decimal format.'),
      'callbacks' => array(
        'tables' => CONTENT_CALLBACK_DEFAULT,
        'arguments' => CONTENT_CALLBACK_DEFAULT,
      ),
    ),
    'number_float' => array(
      'label' => t('Float'),
      'description' => t('Store a number in the database in a floating point format.'),
      'callbacks' => array(
        'tables' => CONTENT_CALLBACK_DEFAULT,
        'arguments' => CONTENT_CALLBACK_DEFAULT,
      ),
    ),
  );
}

/**
 * Implementation of hook_field_settings().
 */
function number_field_settings($op, $field) {
  switch ($op) {
    case 'form':
      $form = array();
      $form['min'] = array(
        '#type' => 'textfield',
        '#title' => t('Minimum'),
        '#default_value' => is_numeric($field['min']) ? $field['min'] : '',
      );
      $form['max'] = array(
        '#type' => 'textfield',
        '#title' => t('Maximum'),
        '#default_value' => is_numeric($field['max']) ? $field['max'] : '',
      );
      if ($field['type'] == 'number_decimal') {
        $form['precision'] = array(
          '#type' => 'select',
          '#options' => drupal_map_assoc(range(10, 32)),
          '#title' => t('Precision'),
          '#description' => t('The total number of digits to store in the database, including those to the right of the decimal.'),
          '#default_value' => is_numeric($field['precision']) ? $field['precision'] : 10,
        );
        $form['scale'] = array(
          '#type' => 'select',
          '#options' => drupal_map_assoc(range(0, 2)),
          '#title' => t('Scale'),
          '#description' => t('The number of digits to the right of the decimal.'),
          '#default_value' => is_numeric($field['scale']) ? $field['scale'] : 2,
        );
        $form['decimal'] = array(
          '#type' => 'select',
          '#options' => array(
            '.' => 'decimal point',
            ',' => 'comma',
            ' ' => 'space',
          ),
          '#title' => t('Decimal marker'),
          '#description' => t('The character users will input to mark the decimal point in forms.'),
          '#default_value' => !empty($field['decimal']) ? $field['decimal'] : '.',
        );
      }
      $form['append']['prefix'] = array(
        '#type' => 'textfield',
        '#title' => t('Prefix'),
        '#size' => 60,
        '#default_value' => !empty($field['prefix']) ? $field['prefix'] : '',
        '#description' => t('Define a string that should be prefixed to the value, like $ or €. Leave blank for none. Separate singular and plural values with a pipe (pound|pounds).'),
      );
      $form['append']['suffix'] = array(
        '#type' => 'textfield',
        '#title' => t('Suffix'),
        '#size' => 60,
        '#default_value' => !empty($field['suffix']) ? $field['suffix'] : '',
        '#description' => t('Define a string that should suffixed to the value, like m², m/s², kb/s. Leave blank for none. Separate singular and plural values with a pipe (pound|pounds).'),
      );
      $form['allowed_values_fieldset'] = array(
        '#type' => 'fieldset',
        '#title' => t('Allowed values'),
        '#collapsible' => TRUE,
        '#collapsed' => TRUE,
      );
      $form['allowed_values_fieldset']['allowed_values'] = array(
        '#type' => 'textarea',
        '#title' => t('Allowed values list'),
        '#default_value' => !empty($field['allowed_values']) ? $field['allowed_values'] : '',
        '#required' => FALSE,
        '#rows' => 10,
        '#description' => t('The possible values this field can contain. Enter one value per line, in the format key|label. The key is the value that will be stored in the database and it must match the field storage type, %type. The label is optional and the key will be used as the label if no label is specified.', array(
          '%type' => $field['type'],
        )),
      );
      $form['allowed_values_fieldset']['advanced_options'] = array(
        '#type' => 'fieldset',
        '#title' => t('PHP code'),
        '#collapsible' => TRUE,
        '#collapsed' => empty($field['allowed_values_php']),
      );
      $form['allowed_values_fieldset']['advanced_options']['allowed_values_php'] = array(
        '#type' => 'textarea',
        '#title' => t('Code'),
        '#default_value' => !empty($field['allowed_values_php']) ? $field['allowed_values_php'] : '',
        '#rows' => 6,
        '#description' => t('Advanced usage only: PHP code that returns a keyed array of allowed values. Should not include &lt;?php ?&gt; delimiters. If this field is filled out, the array returned by this code will override the allowed values list above.'),
      );
      return $form;
    case 'validate':
      if ($field['min'] && !is_numeric($field['min'])) {
        form_set_error('min', t('"Minimum" must be a number.'));
      }
      if ($field['max'] && !is_numeric($field['max'])) {
        form_set_error('max', t('"Maximum" must be a number.'));
      }
      break;
    case 'save':
      $values = array(
        'prefix',
        'suffix',
        'min',
        'max',
        'allowed_values',
        'allowed_values_php',
      );
      if ($field['type'] == 'number_decimal') {
        $values = array_merge($values, array(
          'precision',
          'scale',
          'decimal',
        ));
      }
      return $values;
    case 'database columns':
      if ($field['type'] == 'number_integer') {
        return array(
          'value' => array(
            'type' => 'int',
            'not null' => FALSE,
            'sortable' => TRUE,
          ),
        );
      }
      if ($field['type'] == 'number_float') {
        return array(
          'value' => array(
            'type' => 'float',
            'not null' => FALSE,
            'sortable' => TRUE,
          ),
        );
      }
      if ($field['type'] == 'number_decimal') {
        $precision = isset($field['precision']) ? $field['precision'] : 10;
        $scale = isset($field['scale']) ? $field['scale'] : 2;
        return array(
          'value' => array(
            'type' => 'numeric',
            'precision' => $precision,
            'scale' => $scale,
            'not null' => FALSE,
            'sortable' => TRUE,
          ),
        );
      }
    case 'views data':
      $allowed_values = content_allowed_values($field);
      if (count($allowed_values)) {
        $data = content_views_field_views_data($field);
        $db_info = content_database_info($field);
        $table_alias = content_views_tablename($field);

        // Swap the filter handler to the 'in' operator.
        $data[$table_alias][$field['field_name'] . '_value']['filter']['handler'] = 'views_handler_filter_many_to_one_content';
        return $data;
      }
      break;
  }
}

/**
 * Implementation of hook_field().
 */
function number_field($op, &$node, $field, &$items, $teaser, $page) {
  switch ($op) {
    case 'validate':
      $allowed_values = content_allowed_values($field);
      if (is_array($items)) {
        foreach ($items as $delta => $item) {
          $error_field = $field['field_name'] . '][' . $delta . '][value';
          if ($item['value'] != '') {
            if (is_numeric($field['min']) && $item['value'] < $field['min']) {
              form_set_error($error_field, t('The value of %name may be no smaller than %min.', array(
                '%name' => t($field['widget']['label']),
                '%min' => $field['min'],
              )));
            }
            if (is_numeric($field['max']) && $item['value'] > $field['max']) {
              form_set_error($error_field, t('The value of %name may be no larger than %max.', array(
                '%name' => t($field['widget']['label']),
                '%max' => $field['max'],
              )));
            }
            if (count($allowed_values) && !array_key_exists($item['value'], $allowed_values)) {
              form_set_error($error_field, t('Illegal value for %name.', array(
                '%name' => t($field['widget']['label']),
              )));
            }
          }
        }
      }
      break;
  }
}

/**
 * Implementation of hook_content_is_empty().
 */
function number_content_is_empty($item, $field) {
  if (empty($item['value'])) {
    return TRUE;
  }
  return FALSE;
}

/**
 * Implementation of hook_field_formatter_info().
 */
function number_field_formatter_info() {
  return array(
    'default' => array(
      'label' => '9999',
      'multiple values' => CONTENT_HANDLE_CORE,
      'field types' => array(
        'number_integer',
        'number_decimal',
        'number_float',
      ),
    ),
    'us_0' => array(
      'label' => '9,999',
      'multiple values' => CONTENT_HANDLE_CORE,
      'field types' => array(
        'number_integer',
        'number_decimal',
        'number_float',
      ),
    ),
    'us_1' => array(
      'label' => '9,999.9',
      'multiple values' => CONTENT_HANDLE_CORE,
      'field types' => array(
        'number_decimal',
        'number_float',
      ),
    ),
    'us_2' => array(
      'label' => '9,999.99',
      'multiple values' => CONTENT_HANDLE_CORE,
      'field types' => array(
        'number_decimal',
        'number_float',
      ),
    ),
    'be_0' => array(
      'label' => '9.999',
      'multiple values' => CONTENT_HANDLE_CORE,
      'field types' => array(
        'number_integer',
        'number_decimal',
        'number_float',
      ),
    ),
    'be_1' => array(
      'label' => '9.999,9',
      'multiple values' => CONTENT_HANDLE_CORE,
      'field types' => array(
        'number_decimal',
        'number_float',
      ),
    ),
    'be_2' => array(
      'label' => '9.999,99',
      'multiple values' => CONTENT_HANDLE_CORE,
      'field types' => array(
        'number_decimal',
        'number_float',
      ),
    ),
    'fr_0' => array(
      'label' => '9 999',
      'multiple values' => CONTENT_HANDLE_CORE,
      'field types' => array(
        'number_integer',
        'number_decimal',
        'number_float',
      ),
    ),
    'fr_1' => array(
      'label' => '9 999, 9',
      'multiple values' => CONTENT_HANDLE_CORE,
      'field types' => array(
        'number_decimal',
        'number_float',
      ),
    ),
    'fr_2' => array(
      'label' => '9 999, 99',
      'multiple values' => CONTENT_HANDLE_CORE,
      'field types' => array(
        'number_decimal',
        'number_float',
      ),
    ),
    'unformatted' => array(
      'label' => t('unformatted'),
      'multiple values' => CONTENT_HANDLE_CORE,
      'field types' => array(
        'number_integer',
        'number_decimal',
        'number_float',
      ),
    ),
  );
}

/**
 * Proxy theme function for 'unformatted' number field formatter.
 */
function theme_number_formatter_unformatted($element) {
  return $element['#item']['value'];
}

/**
 * Proxy theme function for number field formatters.
 */
function theme_number_formatter_generic($element) {
  $field = content_fields($element['#field_name'], $element['#type_name']);
  $value = $element['#item']['value'];
  if ($allowed_values = content_allowed_values($field)) {
    if (isset($allowed_values[$value]) && $allowed_values[$value] != $value) {
      return $allowed_values[$value];
    }
  }
  switch ($element['#formatter']) {
    case 'us_0':
      $output = number_format($value, 0, '.', ',');
      break;
    case 'us_1':
      $output = number_format($value, 1, '.', ',');
      break;
    case 'us_2':
      $output = number_format($value, 2, '.', ',');
      break;
    case 'be_0':
      $output = number_format($value, 0, ',', '.');
      break;
    case 'be_1':
      $output = number_format($value, 1, ',', '.');
      break;
    case 'be_2':
      $output = number_format($value, 2, ',', '.');
      break;
    case 'fr_0':
      $output = number_format($value, 0, ', ', ' ');
      break;
    case 'fr_1':
      $output = number_format($value, 1, ', ', ' ');
      break;
    case 'fr_2':
      $output = number_format($value, 2, ', ', ' ');
      break;
    default:
      $output = $value;
      break;
  }
  $prefixes = explode('|', $field['prefix']);
  $suffixes = explode('|', $field['suffix']);
  $prefix = count($prefixes) > 1 ? format_plural($value, $prefixes[0], $prefixes[1]) : $prefixes[0];
  $suffix = count($suffixes) > 1 ? format_plural($value, $suffixes[0], $suffixes[1]) : $suffixes[0];
  return $prefix . $output . $suffix;
}

/**
 * Implementation of hook_widget_info().
 *
 * Here we indicate that the content module will handle
 * the default value and multiple values for these widgets.
 *
 * Callbacks can be omitted if default handing is used.
 * They're included here just so this module can be used
 * as an example for custom modules that might do things
 * differently.
 */
function number_widget_info() {
  return array(
    'number' => array(
      'label' => t('Text field'),
      'field types' => array(
        'number_integer',
        'number_decimal',
        'number_float',
      ),
      'multiple values' => CONTENT_HANDLE_CORE,
      'callbacks' => array(
        'default value' => CONTENT_CALLBACK_DEFAULT,
      ),
    ),
  );
}

/**
 * Implementation of FAPI hook_elements().
 *
 * Any FAPI callbacks needed for individual widgets can be declared here,
 * and the element will be passed to those callbacks for processing.
 *
 * Drupal will automatically theme the element using a theme with
 * the same name as the hook_elements key.
 *
 * Includes a regex to check for valid values as an additional parameter
 * the validator can use. The regex can be overridden if necessary.
 */
function number_elements() {
  return array(
    'number' => array(
      '#input' => TRUE,
      '#columns' => array(
        'value',
      ),
      '#delta' => 0,
      '#process' => array(
        'number_process',
      ),
    ),
  );
}

/**
 * Implementation of hook_widget().
 *
 * Attach a single form element to the form. It will be built out and
 * validated in the callback(s) listed in hook_elements. We build it
 * out in the callbacks rather than here in hook_widget so it can be
 * plugged into any module that can provide it with valid
 * $field information.
 *
 * Content module will set the weight, field name and delta values
 * for each form element. This is a change from earlier CCK versions
 * where the widget managed its own multiple values.
 *
 * If there are multiple values for this field, the content module will
 * call this function as many times as needed.
 *
 * @param $form
 *   the entire form array, $form['#node'] holds node information
 * @param $form_state
 *   the form_state, $form_state['values'] holds the form values.
 * @param $field
 *   the field array
 * @param $delta
 *   the order of this item in the array of subelements (0, 1, 2, etc)
 *
 * @return
 *   the form item for a single element for this field
 */
function number_widget(&$form, &$form_state, $field, $items, $delta = 0) {
  $element = array(
    '#type' => $field['widget']['type'],
    '#default_value' => isset($items[$delta]) ? $items[$delta] : NULL,
  );
  return $element;
}

/**
 * Process an individual element.
 *
 * Build the form element. When creating a form using FAPI #process,
 * note that $element['#value'] is already set.
 *
 * The $fields array is in $form['#field_info'][$element['#field_name']].
 */
function number_process($element, $edit, $form_state, $form) {
  $field_name = $element['#field_name'];
  $field = $form['#field_info'][$field_name];
  $field_key = $element['#columns'][0];
  $value = isset($element['#value'][$field_key]) ? $element['#value'][$field_key] : '';
  $value = isset($field['decimal']) ? str_replace('.', $field['decimal'], $value) : $value;
  $element[$field_key] = array(
    '#type' => 'textfield',
    '#title' => $element['#title'],
    '#description' => $element['#description'],
    '#required' => $element['#required'],
    '#default_value' => $value,
    // Need to allow a slightly larger size that the field length to allow
    // for some configurations where all characters won't fit in input field.
    '#size' => isset($field['precision']) ? $field['precision'] + 2 : 12,
    '#maxlength' => isset($field['precision']) ? $field['precision'] : 10,
    '#attributes' => array(
      'class' => 'number',
    ),
  );
  $prefixes = array();
  $suffixes = array();
  if (!empty($field['prefix'])) {
    $prefixes = explode('|', $field['prefix']);
    $element[$field_key]['#field_prefix'] = array_pop($prefixes);
  }
  if (!empty($field['suffix'])) {
    $suffixes = explode('|', $field['suffix']);
    $element[$field_key]['#field_suffix'] = array_pop($suffixes);
  }
  switch ($field['type']) {
    case 'number_float':
      $element['#element_validate'] = array(
        'number_float_validate',
      );
      break;
    case 'number_integer':
      $element['#element_validate'] = array(
        'number_integer_validate',
      );
      break;
    case 'number_decimal':
      $element['#element_validate'] = array(
        'number_decimal_validate',
      );
      $element['#decimal'] = isset($field['decimal']) ? $field['decimal'] : '.';
      $element['#precision'] = isset($field['precision']) ? $field['precision'] : 10;
      $element['#scale'] = isset($field['scale']) ? $field['scale'] : 2;
      break;
  }
  return $element;
}

/**
 * FAPI validation of an individual float element.
 */
function number_float_validate($element, &$form_state) {
  $field_key = $element['#columns'][0];
  $value = $element['#value'][$field_key];
  if ($element[$field_key]['#required'] || !empty($value)) {
    $start = $value;
    $value = preg_replace('@[^-0-9\\.]@', '', $value);
    if ($start != $value) {

      // No reason to make this an error, just need to inform user what has changed.
      drupal_set_message(t('Only numbers and decimals are allowed in %field. %start was changed to %value.', array(
        '%field' => t($element[$field_key]['#title']),
        '%start' => $start,
        '%value' => $value,
      )));
    }
    form_set_value($element[$field_key], $value, $form_state);
  }
}

/**
 * FAPI validation of an individual integer element.
 */
function number_integer_validate($element, &$form_state) {
  $field_key = $element['#columns'][0];
  $value = $element['#value'][$field_key];
  if ($element[$field_key]['#required'] || !empty($value)) {
    $start = $value;
    $value = preg_replace('@[^-0-9]@', '', $value);
    if ($start != $value) {

      // No reason to make this an error, just need to inform user what has changed.
      drupal_set_message(t('Only numbers are allowed in %field. %start was changed to %value.', array(
        '%field' => t($element[$field_key]['#title']),
        '%start' => $start,
        '%value' => $value,
      )));
    }
    form_set_value($element[$field_key], $value, $form_state);
  }
}

/**
 * FAPI validation of an individual decimal element.
 */
function number_decimal_validate($element, &$form_state) {
  $field_key = $element['#columns'][0];
  $value = $element['#value'][$field_key];
  if ($element[$field_key]['#required'] || !empty($value)) {
    $start = $value;
    $value = str_replace($element['#decimal'], '.', $value);
    $value = preg_replace('@[^-0-9\\.]@', '', $value);
    if ($start != $value) {

      // No reason to make this an error, just need to inform user what has changed.
      drupal_set_message(t('Only numbers and the decimal character (%decimal) are allowed in %field. %start was changed to %value.', array(
        '%decimal' => $element['#decimal'],
        '%field' => t($element[$field_key]['#title']),
        '%start' => $start,
        '%value' => $value,
      )));
    }
    $value = round($value, $element['#scale']);
    form_set_value($element[$field_key], $value, $form_state);
  }
}

/**
 * FAPI theme for an individual number element.
 *
 * The textfield is already rendered by the textfield
 * theme and the HTML output lives in $element['#children'].
 * Override this theme to make custom changes to the output.
 *
 * $element['#field_name'] contains the field name
 * $element['#delta]  is the position of this element in the group
 */
function theme_number($element) {
  return $element['#children'];
}

Functions

Namesort descending Description
number_content_is_empty Implementation of hook_content_is_empty().
number_decimal_validate FAPI validation of an individual decimal element.
number_elements Implementation of FAPI hook_elements().
number_field Implementation of hook_field().
number_field_formatter_info Implementation of hook_field_formatter_info().
number_field_info Implementation of hook_field_info().
number_field_settings Implementation of hook_field_settings().
number_float_validate FAPI validation of an individual float element.
number_integer_validate FAPI validation of an individual integer element.
number_process Process an individual element.
number_theme Implementation of hook_theme().
number_widget Implementation of hook_widget().
number_widget_info Implementation of hook_widget_info().
theme_number FAPI theme for an individual number element.
theme_number_formatter_generic Proxy theme function for number field formatters.
theme_number_formatter_unformatted Proxy theme function for 'unformatted' number field formatter.