phone.gb.inc in Phone Number 6

CCK Field for United Kingdom phone numbers.

File

includes/phone.gb.inc

<?php

/**
 * @file
 * CCK Field for United Kingdom phone numbers.
 */
function _uk_phone_rules() {

  // TODO: more detailed check by area codes
  return '/^
      0*(2[03489])(\\d{4})(\\d{4})    # 02x [eight-digit local number]
      |
      0*(11[3-8])(\\d{3})(\\d{4})     # 011x [seven-digit local number]
      |
      0*(1[2-9]1)(\\d{3})(\\d{4})     # 01x1 [seven-digit local number]
      |
      0*(1[2-9][0|2-9]\\d)(\\d{5,6})  # 01xxx [mostly six-digit local numbers] (but not 01x1 codes)
    $/x';
}

/**
 * Validate country level phone number.
 *
 * @param $number
 *   Digits only value.
 * @param $ext
 *   Digits only value.
 * @param $error
 *   The error message to shown to user.
 *   Available parameters to use in the error message are
 *   - "%countrycode": the alpha-2 CC
 *   - "%phone_input": the original number input by user (could be invalid)
 *   - "%max_length": allowed maximum length of the phone number
 * @return boolean
 *   TRUE if it is a valid phone number for that country, FALSE otherwise.
 */
function gb_validate_number($number, $ext = '', &$error) {

  // Don't worry about separators
  if (preg_match(_uk_phone_rules(), cck_phone_clean_number($number))) {
    return TRUE;
  }

  // t() is not needed
  $error = '"%phone_input" is not a valid United Kingdom phone number, it should be a 10 digit number like "99 9999 9999", with optional leading "0"';
  return FALSE;
}

/**
 * Cleanup user-entered values for a phone number field for saving to DB.
 *
 * @param $number
 *   A single phone number item.
 */
function gb_sanitize_number(&$number) {

  // Remove trunk prefix '0'
  $number = preg_replace('/^0*/', '', $number);
}

/**
 * Default formatter for international phone number.
 *
 * @param $element
 *   $element['#item']['country_codes']: alpha-2 country code
 *   $element['#item']['number']: phone number
 * @param $error
 *   The error message to shown to user.
 *   Available parameters to use in the error message are
 *   - "%countrycode": the alpha-2 CC
 *   - "%phone_input": the original number input by user (could be invalid)
 *   - "%max_length": allowed maximum length of the phone number
 * @return boolean
 *   TRUE if it is a valid phone number for that country, FALSE otherwise.
 */
function gb_formatter_default($element) {

  // Display a global phone number with country code.
  $phone = '';
  $item = $element['#item'];
  $number = $item['number'];
  if ($number) {
    $cc = cck_phone_countrycodes($item['country_codes']);
    if (preg_match(_uk_phone_rules(), $number, $matches)) {

      // output as +44 AA BBBB CCCC, +44 AAA BBB CCCC or +44 AAAA BBB CCC
      array_shift($matches);
      $phone = $cc['code'] . ' ' . implode(' ', $matches);
    }
    else {
      $phone = "{$cc['code']} {$number}";
    }
  }
  return $phone;
}

/**
 * Local formatter for local phone number.
 *
 * @param $element
 *   $element['#item']['country_codes']: alpha-2 country code
 *   $element['#item']['number']: phone number
 * @param $error
 *   The error message to shown to user.
 *   Available parameters to use in the error message are
 *   - "%countrycode": the alpha-2 CC
 *   - "%phone_input": the original number input by user (could be invalid)
 *   - "%max_length": allowed maximum length of the phone number
 * @return boolean
 *   TRUE if it is a valid phone number for that country, FALSE otherwise.
 */
function gb_formatter_local($element) {

  // Display a local phone number without country code.
  $phone = '';
  $number = $element['#item']['number'];
  if ($number) {
    if (preg_match(_uk_phone_rules(), $number, $matches)) {

      // output as 0AA BBBB CCCC, 0AAA BBB CCCC or 0AAAA BBB CCC
      array_shift($matches);
      $phone = '0' . implode(' ', $matches);
    }
    else {
      $phone = "0{$number}";
    }
  }
  return $phone;
}

Functions

Name	Description
gb_formatter_default	Default formatter for international phone number.
gb_formatter_local	Local formatter for local phone number.
gb_sanitize_number	Cleanup user-entered values for a phone number field for saving to DB.
gb_validate_number	Validate country level phone number.
_uk_phone_rules	@file CCK Field for United Kingdom phone numbers.