123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296297298299300301302303304305306307308309310311312313314315316317318319320321322323324325326327328329330331332333334335336337338339340341342343344345346347348349350351352353354355356357358359360361362363364365366367368369370371372373374375376377378379380381382383384385386387388389390391392393394395396397398399400401402403404405406407408409410411412413414415416417418419420421422423424425426427428429430431432433434435436437438439440441442443444445446447448449450451452453454455456457458459460461462463464465466467468469470471472473474475476477478479480481482483484485486487488489490491492493494495496497498499500501502503504505506507508509510511512513514515516517518519520521522523524525526527528529530531532533534535536537538539540541542543544545546547548549550551552553554555556557558559560561562563564565566567568569570571572573574575576577578579580581582583584585586587588589590591592593594595596597598599600601602603604605606607608609610611612613614615616617618619620621622623624625626627628629630631632633634635636637638639640641642643644645646647648649650651652653654655656657658659660661662663664665666667668669670671672673674675676677678679680681682683684685686687688689690691692693694695696697698699700701702703704705706707708709710711712713714715716717718719720721722723724725726727728729730731732733734735736737738739740741742743744745746747748749750751752753754755756757758759760761762763764765766767768769770771772773774775776777778779780781782783784785786787788789790791792793794795796797798799800801802803804805806807808809810811812813814815816817818819820 |
- <?php
- /**
- * @file
- * Webform module number component.
- */
- /**
- * Implements _webform_defaults_component().
- */
- function _webform_defaults_number() {
- return array(
- 'name' => '',
- 'form_key' => NULL,
- 'pid' => 0,
- 'weight' => 0,
- 'value' => '',
- 'mandatory' => 0,
- 'extra' => array(
- 'type' => 'textfield',
- 'field_prefix' => '',
- 'field_suffix' => '',
- 'disabled' => 0,
- 'unique' => 0,
- 'title_display' => 0,
- 'description' => '',
- 'attributes' => array(),
- 'private' => FALSE,
- 'min' => '',
- 'max' => '',
- 'step' => '',
- 'decimals' => '',
- 'point' => '.',
- 'separator' => ',',
- 'integer' => 0,
- 'excludezero' => 0,
- ),
- );
- }
- /**
- * Implements _webform_theme_component().
- */
- function _webform_theme_number() {
- return array(
- 'webform_number' => array(
- 'render element' => 'element',
- 'file' => 'components/number.inc',
- ),
- 'webform_display_number' => array(
- 'render element' => 'element',
- 'file' => 'components/number.inc',
- ),
- );
- }
- /**
- * Implements _webform_edit_component().
- */
- function _webform_edit_number($component) {
- $form = array();
- $form['value'] = array(
- '#type' => 'textfield',
- '#title' => t('Default value'),
- '#default_value' => $component['value'],
- '#description' => t('The default value of the field.') . theme('webform_token_help'),
- '#size' => 60,
- '#maxlength' => 1024,
- '#weight' => 0,
- );
- $form['display']['type'] = array(
- '#type' => 'radios',
- '#title' => t('Element type'),
- '#options' => array(
- 'textfield' => t('Text field'),
- 'select' => t('Select list'),
- ),
- '#default_value' => $component['extra']['type'],
- '#description' => t('A minimum and maximum value are required if displaying as a select.'),
- '#weight' => -1,
- '#parents' => array('extra', 'type'),
- );
- $form['display']['field_prefix'] = array(
- '#type' => 'textfield',
- '#title' => t('Prefix text placed to the left of the field'),
- '#default_value' => $component['extra']['field_prefix'],
- '#description' => t('Examples: $, #, -.'),
- '#size' => 20,
- '#maxlength' => 127,
- '#weight' => 1.1,
- '#parents' => array('extra', 'field_prefix'),
- );
- $form['display']['field_suffix'] = array(
- '#type' => 'textfield',
- '#title' => t('Postfix text placed to the right of the field'),
- '#default_value' => $component['extra']['field_suffix'],
- '#description' => t('Examples: lb, kg, %.'),
- '#size' => 20,
- '#maxlength' => 127,
- '#weight' => 1.2,
- '#parents' => array('extra', 'field_suffix'),
- );
- $form['display']['disabled'] = array(
- '#type' => 'checkbox',
- '#title' => t('Disabled'),
- '#return_value' => 1,
- '#description' => t('Make this field non-editable. Useful for setting an unchangeable default value.'),
- '#weight' => 11,
- '#default_value' => $component['extra']['disabled'],
- '#parents' => array('extra', 'disabled'),
- );
- $form['display']['decimals'] = array(
- '#type' => 'select',
- '#title' => t('Decimal places'),
- '#options' => array('' => t('Automatic')) + drupal_map_assoc(range(0, 10)),
- '#description' => t('Automatic will display up to @count decimals places if needed. A value of "2" is common to format currency amounts.', array('@count' => '4')),
- '#default_value' => $component['extra']['decimals'],
- '#weight' => 2,
- '#parents' => array('extra', 'decimals'),
- '#element_validate' => array('_webform_edit_number_validate'),
- );
- $form['display']['separator'] = array(
- '#type' => 'select',
- '#title' => t('Thousands separator'),
- '#options' => array(
- ',' => t('Comma (,)'),
- '.' => t('Period (.)'),
- ' ' => t('Space ( )'),
- '' => t('None'),
- ),
- '#default_value' => $component['extra']['separator'],
- '#weight' => 3,
- '#parents' => array('extra', 'separator'),
- '#element_validate' => array('_webform_edit_number_validate'),
- );
- $form['display']['point'] = array(
- '#type' => 'select',
- '#title' => t('Decimal point'),
- '#options' => array(
- ',' => t('Comma (,)'),
- '.' => t('Period (.)'),
- ),
- '#default_value' => $component['extra']['point'],
- '#weight' => 4,
- '#parents' => array('extra', 'point'),
- '#element_validate' => array('_webform_edit_number_validate'),
- );
- $form['validation']['unique'] = array(
- '#type' => 'checkbox',
- '#title' => t('Unique'),
- '#return_value' => 1,
- '#description' => t('Check that all entered values for this field are unique. The same value is not allowed to be used twice.'),
- '#weight' => 1,
- '#default_value' => $component['extra']['unique'],
- '#parents' => array('extra', 'unique'),
- );
- $form['validation']['integer'] = array(
- '#type' => 'checkbox',
- '#title' => t('Integer'),
- '#return_value' => 1,
- '#description' => t('Permit only integer values as input. e.g. 12.34 would be invalid.'),
- '#weight' => 1.5,
- '#default_value' => $component['extra']['integer'],
- '#parents' => array('extra', 'integer'),
- );
- $form['validation']['min'] = array(
- '#type' => 'textfield',
- '#title' => t('Minimum'),
- '#default_value' => $component['extra']['min'],
- '#description' => t('Minimum numeric value. e.g. 0 would ensure positive numbers.'),
- '#size' => 5,
- '#maxlength' => 10,
- '#weight' => 2.1,
- '#parents' => array('extra', 'min'),
- '#element_validate' => array('_webform_edit_number_validate'),
- );
- $form['validation']['max'] = array(
- '#type' => 'textfield',
- '#title' => t('Maximum'),
- '#default_value' => $component['extra']['max'],
- '#description' => t('Maximum numeric value. This may also determine the display width of your field.'),
- '#size' => 5,
- '#maxlength' => 10,
- '#weight' => 2.2,
- '#parents' => array('extra', 'max'),
- '#element_validate' => array('_webform_edit_number_validate'),
- );
- $form['validation']['step'] = array(
- '#type' => 'textfield',
- '#title' => t('Step'),
- '#default_value' => $component['extra']['step'],
- '#description' => t('Limit options to a specific increment. e.g. a step of "5" would allow values 5, 10, 15, etc.'),
- '#size' => 5,
- '#maxlength' => 10,
- '#weight' => 3,
- '#parents' => array('extra', 'step'),
- '#element_validate' => array('_webform_edit_number_validate'),
- );
- // Analysis settings.
- $form['analysis'] = array(
- '#type' => 'fieldset',
- '#title' => t('Analysis'),
- '#collapsible' => TRUE,
- '#collapsed' => FALSE,
- '#weight' => 10,
- );
- $form['analysis']['excludezero'] = array(
- '#type' => 'checkbox',
- '#title' => t('Exclude zero'),
- '#return_value' => 1,
- '#description' => t('Exclude entries of zero (or blank) when counting submissions to calculate average and standard deviation.'),
- '#weight' => 1.5,
- '#default_value' => $component['extra']['excludezero'],
- '#parents' => array('extra', 'excludezero'),
- );
- return $form;
- }
- /**
- * Theme function to render a number component.
- */
- function theme_webform_number($variables) {
- $element = $variables['element'];
- // This IF statement is mostly in place to allow our tests to set type="text"
- // because SimpleTest does not support type="number".
- if (!isset($element['#attributes']['type'])) {
- $element['#attributes']['type'] = 'number';
- }
- // Step property *must* be a full number with 0 prefix if a decimal.
- if (!empty($element['#step']) && !is_int($element['#step'] * 1)) {
- $decimals = strlen($element['#step']) - strrpos($element['#step'], '.') - 1;
- $element['#step'] = sprintf('%1.' . $decimals . 'F', $element['#step']);
- }
- // If the number is not an integer and step is undefined/empty, set the "any"
- // value to allow any decimal.
- if (empty($element['#integer']) && empty($element['#step'])) {
- $element['#step'] = 'any';
- }
- elseif ($element['#integer'] && empty($element['#step'])) {
- $element['#step'] = 1;
- }
- // Convert properties to attributes on the element if set.
- foreach (array('id', 'name', 'value', 'size', 'min', 'max', 'step') as $property) {
- if (isset($element['#' . $property]) && $element['#' . $property] !== '') {
- $element['#attributes'][$property] = $element['#' . $property];
- }
- }
- _form_set_class($element, array('form-text', 'form-number'));
- return '<input' . drupal_attributes($element['#attributes']) . ' />';
- }
- /**
- * Implements _webform_render_component().
- */
- function _webform_render_number($component, $value = NULL, $filter = TRUE) {
- $node = isset($component['nid']) ? node_load($component['nid']) : NULL;
- $element = array(
- '#title' => $filter ? _webform_filter_xss($component['name']) : $component['name'],
- '#title_display' => $component['extra']['title_display'] ? $component['extra']['title_display'] : 'before',
- '#default_value' => $filter ? _webform_filter_values($component['value'], $node, NULL, NULL, FALSE) : $component['value'],
- '#required' => $component['mandatory'],
- '#weight' => $component['weight'],
- '#field_prefix' => empty($component['extra']['field_prefix']) ? NULL : ($filter ? _webform_filter_xss($component['extra']['field_prefix']) : $component['extra']['field_prefix']),
- '#field_suffix' => empty($component['extra']['field_suffix']) ? NULL : ($filter ? _webform_filter_xss($component['extra']['field_suffix']) : $component['extra']['field_suffix']),
- '#description' => $filter ? _webform_filter_descriptions($component['extra']['description'], $node) : $component['extra']['description'],
- '#attributes' => $component['extra']['attributes'],
- '#element_validate' => array('_webform_validate_number'),
- '#theme_wrappers' => array('webform_element'),
- '#min' => $component['extra']['min'],
- '#max' => $component['extra']['max'],
- '#step' => $component['extra']['step'] ? abs($component['extra']['step']) : '',
- '#integer' => $component['extra']['integer'],
- '#point' => $component['extra']['point'],
- '#separator' => $component['extra']['separator'],
- '#decimals' => $component['extra']['decimals'],
- '#translatable' => array('title', 'description', 'field_prefix', 'field_suffix'),
- );
- // Set the decimal count to zero for integers.
- if ($element['#integer'] && $element['#decimals'] === '') {
- $element['#decimals'] = 0;
- }
- // Flip the min and max properties to make min less than max if needed.
- if ($element['#min'] !== '' && $element['#max'] !== '' && $element['#min'] > $element['#max']) {
- $max = $element['#min'];
- $element['#min'] = $element['#max'];
- $element['#max'] = $max;
- }
- // Ensure #step starts with a zero if a decimal.
- if (!is_int($element['#step'] * 1)) {
- $decimals = strlen($element['#step']) - strrpos($element['#step'], '.') - 1;
- $element['#step'] = sprintf('%1.' . $decimals . 'F', $element['#step']);
- }
- if ($component['extra']['type'] == 'textfield') {
- // Render as textfield.
- $element['#type'] = 'webform_number';
- // Set the size property based on #max, to ensure consistent behavior for
- // browsers that do not support type = number.
- if ($element['#max']) {
- $element['#size'] = strlen($element['#max']) + 1;
- }
- }
- else {
- // Render as select.
- $element['#type'] = 'select';
- // Create user-specified options list as an array.
- $element['#options'] = _webform_number_select_options($component);
- // Add default options if using a select list with no default. This trigger's
- // Drupal 7's adding of the option for us. See form_process_select().
- if ($component['extra']['type'] == 'select' && $element['#default_value'] === '') {
- $element['#empty_value'] = '';
- }
- }
- // Set user-entered values.
- if (isset($value[0])) {
- // If the value has been standardized, convert it to the expected format
- // for display to the user.
- if (webform_number_format_match($value[0], '.', '')) {
- $element['#default_value'] = _webform_number_format($component, $value[0]);
- }
- // Otherwise use the user-defined input.
- else {
- $element['#default_value'] = $value[0];
- }
- }
- // Enforce uniqueness.
- if ($component['extra']['unique']) {
- $element['#element_validate'][] = 'webform_validate_unique';
- }
- // Set readonly if disabled.
- if ($component['extra']['disabled']) {
- if ($filter) {
- $element['#attributes']['readonly'] = 'readonly';
- }
- else {
- $element['#disabled'] = TRUE;
- }
- }
- return $element;
- }
- /**
- * Implements _webform_display_component().
- */
- function _webform_display_number($component, $value, $format = 'html') {
- $empty = !isset($value[0]) || $value[0] === '';
- return array(
- '#title' => $component['name'],
- '#weight' => $component['weight'],
- '#theme' => 'webform_display_number',
- '#theme_wrappers' => $format == 'html' ? array('webform_element') : array('webform_element_text'),
- '#field_prefix' => $empty ? '' : $component['extra']['field_prefix'],
- '#field_suffix' => $empty ? '' : $component['extra']['field_suffix'],
- '#format' => $format,
- '#value' => $empty ? '' : _webform_number_format($component, $value[0]),
- '#translatable' => array('title'),
- );
- }
- /**
- * Format the output of data for this component.
- */
- function theme_webform_display_number($variables) {
- $element = $variables['element'];
- $prefix = $element['#format'] == 'html' ? '' : $element['#field_prefix'];
- $suffix = $element['#format'] == 'html' ? '' : $element['#field_suffix'];
- $value = $element['#format'] == 'html' ? check_plain($element['#value']) : $element['#value'];
- return $value !== '' ? ($prefix . $value . $suffix) : ' ';
- }
- /**
- * Implements _webform_analysis_component().
- */
- function _webform_analysis_number($component, $sids = array(), $single = FALSE) {
- $advanced_stats = $single;
- $query = db_select('webform_submitted_data', 'wsd', array('fetch' => PDO::FETCH_ASSOC))
- ->fields('wsd', array('data'))
- ->condition('nid', $component['nid'])
- ->condition('cid', $component['cid']);
- if (count($sids)) {
- $query->condition('sid', $sids, 'IN');
- }
- $population = array();
- $submissions = 0;
- $non_zero = 0;
- $non_empty = 0;
- $sum = 0;
- $result = $query->execute();
- foreach ($result as $data) {
- $value = trim($data['data']);
- $number = (float)$value;
- $non_empty += (integer)($value !== '');
- $non_zero += (integer)($number != 0.0);
- $sum += $number;
- $population[] = $number;
- $submissions++;
- }
- sort($population, SORT_NUMERIC);
- // Average and population count.
- if ($component['extra']['excludezero']) {
- $average = $non_zero ? ($sum / $non_zero) : 0;
- $average_title = t('Average !mu excluding zeros/blanks', array('!mu' => $advanced_stats ? '(μ)' : ''));
- // Sample (sub-set of total population).
- $population_count = $non_zero - 1;
- $sigma = 'sd';
- $description = t('sample');
- }
- else {
- $average = $submissions ? ($sum / $submissions) : 0;
- $average_title = t('Average !mu including zeros/blanks', array('!mu' => $advanced_stats ? '(μ)' : ''));
- // Population.
- $population_count = $submissions;
- $sigma = 'σ';
- $description = t('population');
- }
- // Formatting.
- $average = _webform_number_format($component, $average);
- $sum = _webform_number_format($component, $sum);
- $rows[0] = array(t('Zero/blank'), ($submissions - $non_zero));
- $rows[1] = array(t('User entered value'), $non_empty);
- $rows[2] = array(t('Sum') . ($advanced_stats ? ' (Σ)' : ''), $sum);
- $rows[3] = array($average_title, $average);
- if (!$advanced_stats && $sum != 0) {
- $rows[4] = array('', l(t('More stats »'), 'node/' . $component['nid'] . '/webform-results/analysis/' . $component['cid']));
- }
- // Normal distribution information.
- if ($advanced_stats && $population_count && $sum != 0) {
- // Standard deviation.
- $stddev = 0;
- foreach($population as $value) {
- // Obtain the total of squared variances.
- $stddev += pow(($value - $average), 2);
- }
- if ($population_count > 0) {
- $stddev = sqrt($stddev / $population_count);
- }
- else {
- $stddev = sqrt($stddev);
- }
- // Skip the rest of the distribution rows if standard deviation is 0.
- if (empty($stddev)) {
- return $rows;
- }
- // Build normal distribution table rows.
- $count = array();
- $percent = array();
- $limit = array();
- $index = 0;
- $count[] = 0;
- $limit[] = $average - ($stddev * 4);
- foreach ($population as $value) {
- while ($value >= $limit[$index]) {
- $percent[] = number_format($count[$index] / $population_count * 100, 2, '.', '');
- $limit[] = $limit[$index] + $stddev;
- $index += 1;
- if ($limit[$index] == $average) {
- $limit[$index] = $limit[$index] + $stddev;
- }
- $count[$index] = 0;
- }
- $count[$index] += 1;
- }
- $percent[] = number_format($count[$index] / $population_count * 100, 2, '.', '');
- // Format normal distribution table output.
- $stddev = _webform_number_format($component, $stddev);
- $low = _webform_number_format($component, $population[0]);
- $high = _webform_number_format($component, end($population));
- foreach($limit as $key => $value) {
- $limit[$key] = _webform_number_format($component, $value);
- }
- // Column headings (override potential theme uppercase, e.g. Seven in D7).
- $header = array(
- t('Normal Distribution'),
- array('data' => '-4' . $sigma, 'style' => 'text-transform: lowercase;',),
- array('data' => '-3' . $sigma, 'style' => 'text-transform: lowercase;',),
- array('data' => '-2' . $sigma, 'style' => 'text-transform: lowercase;',),
- array('data' => '-1' . $sigma, 'style' => 'text-transform: lowercase;',),
- array('data' => '+1' . $sigma, 'style' => 'text-transform: lowercase;',),
- array('data' => '+2' . $sigma, 'style' => 'text-transform: lowercase;',),
- array('data' => '+3' . $sigma, 'style' => 'text-transform: lowercase;',),
- array('data' => '+4' . $sigma, 'style' => 'text-transform: lowercase;',),
- );
- // Insert row labels.
- array_unshift($limit, t('Boundary'));
- array_unshift($count, t('Count'));
- array_unshift($percent, t('% of !description', array('!description' => $description)));
- $output = theme('table', array('header' => $header, 'rows' => array($limit, $count, $percent)));
- $rows[4] = array(t('Range'), t('!low to !high', array('!low' => $low, '!high' => $high)));
- $rows[5] = array(t('Standard deviation (!sigma)', array('!sigma' => $sigma)), $stddev);
- $rows[6] = array(array('data' => $output, 'colspan' => 2));
- }
- return $rows;
- }
- /**
- * Implements _webform_table_component().
- */
- function _webform_table_number($component, $value) {
- return isset($value[0]) ? _webform_number_format($component, $value[0]) : '';
- }
- /**
- * Implements _webform_csv_headers_component().
- */
- function _webform_csv_headers_number($component, $export_options) {
- $header = array();
- $header[0] = '';
- $header[1] = '';
- $header[2] = $component['name'];
- return $header;
- }
- /**
- * Implements _webform_csv_data_component().
- */
- function _webform_csv_data_number($component, $export_options, $value) {
- if (isset($value[0]) && is_numeric($value[0]) && $component['extra']['decimals'] !== '') {
- $value[0] = number_format($value[0], $component['extra']['decimals'], '.', '');
- }
- return isset($value[0]) ? $value[0] : '';
- }
- /**
- * A Drupal Form API Validation function. Validates the entered values from
- * number components on the client-side form.
- *
- * @param $element
- * The form element. May either be a select or a webform_number element.
- * @param $form_state
- * The full form state for the webform.
- * @return
- * None. Calls a form_set_error if the number is not valid.
- */
- function _webform_validate_number($element, &$form_state) {
- // Trim spaces for basic cleanup.
- $value = trim($element['#value']);
- form_set_value($element, $value, $form_state);
- if ($value != '') {
- // First check that the entered value matches the expected value.
- if (!webform_number_format_match($value, $element['#point'], $element['#separator'])) {
- form_error($element, t('%name field value must format numbers as "@example".', array('%name' => $element['#title'], '@example' => webform_number_format(12345.6789, $element['#decimals'], $element['#point'], $element['#separator']))));
- return;
- }
- // Numeric test.
- $numeric_value = webform_number_standardize($value, $element['#point']);
- if (is_numeric($numeric_value)) {
- // Range test.
- if ($element['#min'] != '' && $element['#max'] != '') {
- // Flip minimum and maximum if needed.
- if ($element['#max'] > $element['#min']) {
- $min = $element['#min'];
- $max = $element['#max'];
- }
- else {
- $min = $element['#max'];
- $max = $element['#min'];
- }
- if ($numeric_value > $max || $numeric_value < $min) {
- form_error($element, t('%name field value of @value should be in the range @min to @max.', array('%name' => $element['#title'], '@value' => $value, '@min' => $element['#min'], '@max' => $element['#max'])));
- }
- }
- elseif ($element['#max'] != '' && $numeric_value > $element['#max']) {
- form_error($element, t('%name field value must be less than @max.', array('%name' => $element['#title'], '@max' => $element['#max'])));
- }
- elseif ($element['#min'] != '' && $numeric_value < $element['#min']) {
- form_error($element, t('%name field value must be greater than @min.', array('%name' => $element['#title'], '@min' => $element['#min'])));
- }
- // Integer test.
- if ($element['#integer'] && !is_int($numeric_value * 1)) {
- form_error($element, t('%name field value of @value must be an integer.', array('%name' => $element['#title'], '@value' => $value)));
- }
- // Step test.
- $starting_number = $element['#min'] ? $element['#min'] : 0;
- if ($element['#step'] != 0 && webform_modulo($numeric_value - $starting_number, $element['#step']) != 0) {
- $samples = array(
- $starting_number,
- $starting_number + ($element['#step'] * 1),
- $starting_number + ($element['#step'] * 2),
- $starting_number + ($element['#step'] * 3),
- );
- if ($starting_number) {
- form_error($element, t('%name field value must be @start plus a multiple of @step. i.e. @samples, etc.', array('%name' => $element['#title'], '@start' => $element['#min'], '@step' => $element['#step'], '@samples' => implode(', ', $samples))));
- }
- else {
- form_error($element, t('%name field value must be a multiple of @step. i.e. @samples, etc.', array('%name' => $element['#title'], '@step' => $element['#step'], '@samples' => implode(', ', $samples))));
- }
- }
- }
- else {
- form_error($element, t('%name field value of @value must be numeric.', array('%name' => $element['#title'], '@value' => $value)));
- }
- }
- }
- /**
- * Implements _webform_submit_component().
- */
- function _webform_submit_number($component, $value) {
- // Because _webform_validate_number() ensures the format matches when moving
- // forward through a form, this should always pass before saving into the
- // database. When moving backwards in a form, do not adjust the value, since
- // it has not yet been validated.
- if (webform_number_format_match($value, $component['extra']['point'], $component['extra']['separator'])) {
- $value = webform_number_standardize($value, $component['extra']['point']);
- }
- return $value;
- }
- /**
- * Validation of number edit form items.
- */
- function _webform_edit_number_validate($element, &$form_state) {
- // Find the value of all related fields to this element.
- $parents = $element['#parents'];
- $key = array_pop($parents);
- $values = $form_state['values'];
- foreach ($parents as $parent) {
- $values = $values[$parent];
- }
- switch ($key) {
- case 'min':
- if ($values['min'] == '') {
- if (isset($values['type']) && $values['type'] === 'select') {
- form_error($element, t('Minimum is required when using a select list element.'));
- }
- }
- else {
- if (!is_numeric($values['min'])) {
- form_error($element, t('Minimum must be numeric.'));
- }
- if ($values['integer'] && !is_int($values['min'] * 1)) {
- form_error($element, t('Minimum must have an integer value.'));
- }
- }
- break;
- case 'max':
- if ($values['max'] == '') {
- if (isset($values['type']) && $values['type'] === 'select') {
- form_error($element, t('Maximum is required when using a select list element.'));
- }
- }
- else {
- if (!is_numeric($values['max'])) {
- form_error($element, t('Maximum must be numeric.'));
- }
- if ($values['integer'] && !is_int($values['max'] * 1)) {
- form_error($element, t('Maximum must have an integer value.'));
- }
- }
- break;
- case 'step':
- if ($values['step'] !== '') {
- if (!is_numeric($values['step'])) {
- form_error($element, t('Step must be numeric.'));
- }
- else {
- if ($values['integer'] && !is_int($values['step'] * 1)) {
- form_error($element, t('Step must have an integer value.'));
- }
- }
- }
- break;
- }
- return TRUE;
- }
- /**
- * Generate select list options.
- */
- function _webform_number_select_options($component) {
- $options = array();
- $step = abs($component['extra']['step']);
- // Step is optional and defaults to 1.
- $step = empty($step) ? 1 : $step;
- // Generate list in correct direction.
- $min = $component['extra']['min'];
- $max = $component['extra']['max'];
- $flipped = FALSE;
- if ($max < $min) {
- $min = $component['extra']['max'];
- $max = $component['extra']['min'];
- $flipped = TRUE;
- }
- for ($f = $min; $f <= $max; $f += $step) {
- $options[$f . ''] = $f . '';
- }
- // TODO: HTML5 browsers apparently do not include the max value if it does
- // not line up with step. Restore this if needed in the future.
- // Add end limit if it's been skipped due to step.
- //if (end($options) != $max) {
- // $options[$f] = $max;
- //}
- if ($flipped) {
- $options = array_reverse($options, TRUE);
- }
- // Apply requisite number formatting.
- foreach ($options as $key => $value) {
- $options[$key] = _webform_number_format($component, $value);
- }
- return $options;
- }
- /**
- * Apply number format based on a component and number value.
- */
- function _webform_number_format($component, $value) {
- return webform_number_format($value, $component['extra']['decimals'], $component['extra']['point'], $component['extra']['separator']);
- }
- /**
- * Validates if a provided number string matches an expected format.
- *
- * This function allows the thousands separator to be optional, but decimal
- * points must be in the right location.
- *
- * Based on http://stackoverflow.com/questions/5917082/regular-expression-to-match-numbers-with-or-without-commas-and-decimals-in-text.
- */
- function webform_number_format_match($value, $point, $separator) {
- return preg_match('/^(-? ?[1-9](?:\d{0,2})(?:' . ($separator ? (preg_quote($separator, '/') . '?') : '') . '\d{3})*(?:' . preg_quote($point, '/') . '\d*[0-9])?|0?' . preg_quote($point, '/') . '\d*[1-9]|0)$/', $value);
- }
- /**
- * Format a number with thousands separator, decimal point, and decimal places.
- *
- * This function is a wrapper around PHP's native number_format(), but allows
- * the decimal places parameter to be NULL or an empty string, resulting in a
- * behavior of no change to the decimal places.
- */
- function webform_number_format($value, $decimals = NULL, $point = '.', $separator = ',') {
- if (!is_numeric($value)) {
- return '';
- }
- // If no decimal places are specified, do a best guess length of decimals.
- if (is_null($decimals) || $decimals === '') {
- // If it's an integer, no decimals needed.
- if (is_int(($value . '') * 1)) {
- $decimals = 0;
- }
- else {
- $decimals = strlen($value) - strrpos($value, '.') - 1;
- }
- if ($decimals > 4) {
- $decimals = 4;
- }
- }
- return number_format($value, $decimals, $point, $separator);
- }
- /**
- * Given a number, convert it to string compatible with a PHP float.
- *
- * @param string $value
- * The string value to be standardized into a numeric string.
- * @param $point
- * The point separator between the whole number and the decimals.
- */
- function webform_number_standardize($value, $point) {
- // For simplicity, strip everything that's not the decimal point.
- $value = preg_replace('/[^\-0-9' . preg_quote($point, '/') . ']/', '', $value);
- // Convert the decimal point to a period.
- $value = str_replace($point, '.', $value);
- return $value;
- }
- /**
- * Custom modulo function that properly handles float division.
- *
- * See https://drupal.org/node/1601968.
- */
- function webform_modulo($a, $b) {
- return $a - $b * (($b < 0) ? ceil($a / $b) : floor($a / $b));
- }
|