File Source for BirthdayDateTextInput.class.php

<?php
/**
* For including this file you have to define the constant "CLASSPATH".
* Because every include in the framework depends on the CLASSPATH definition.
* The CLASSPATH means the relative path to the folder that contains the
* framework GilliGan.
*
* @package forms
* @subpackage items
*/
if( !defined( "CLASSPATH" ) )
{
echo "<h3>You have to define the constant CLASSPATH!</h3>\n";
echo "Example: define( 'CLASSPATH', '../path/to/classes/' );\n";
exit();
}
if ( defined( "LANG" ) )
{
/**
* Including language specific messages.
*/
require_once CLASSPATH."forms/items/BirthdayDateTextInput/".LANG.".inc.php";
/**
* Including language specific messages.
*/
require_once CLASSPATH."core/lang_spec_values/".LANG.".inc.php";
}
else
{
echo "<h3>You have to define the constant LANG!</h3>\n";
echo "Example for german: define( 'LANG', 'de' );\n";
exit();
}
/**
*
*/
require_once CLASSPATH."forms/items/HTMLTextInput.class.php";
/**
*
*/
require_once CLASSPATH."html/JavaScript.class.php";
/**
* A class to generate text input fields to fill in Dates.
*
* @package forms
* @subpackage items
* @version 0.1.81
*
* @author Daniel Plücken <daniel@debakel.net>
* @license http://www.gnu.org/copyleft/lesser.html
* GNU Lesser General Public License
* @copyright Copyright (C) 2003 Daniel Plücken <daniel@debakel.net>
*
* This library is free software; you can redistribute it and/or
* modify it under the terms of the GNU Lesser General Public
* License as published by the Free Software Foundation; either
* version 2.1 of the License.
*
* This library is distributed in the hope that it will be useful,
* but WITHOUT ANY WARRANTY; without even the implied warranty of
* MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
* GNU Lesser General Public License for more details.
*
* You should have received a copy of the GNU Lesser General
* Public License along with this library; if not, write to the
* Free Software Foundation, Inc., 59 Temple Place, Suite 330,
* Boston, MA 02111-1307 USA
*/
class BirthdayDateTextInput extends HTMLTextInput
{
/**
* The template for how to interpret the date.
* The standardvalue follows ISO 8601.
*
* Valid chars are:
* - y for year
* - m for month
* - d for day
*
* @access private
* @var string $template_date_format
*/
var $template_date_format = "";
/**
* Stores the interpreted day
*
* @access private
* @var integer $day
*/
var $day = 0;
/**
* Stores the interpreted month
*
* @access private
* @var integer $month
*/
var $month = 0;
/**
* Stores the interpreted year
*
* @access private
* @var integer $year
*/
var $year = 0;
/**
* Stores whether this object has been output already.
*
* @access private
* @var integer $year
*/
var $first_output = true;
/**
* Constructor
*
* @access public
* @version 1.12
* @since 0.1.0
*
* @param string $name The value of the "name"-attribute of the text
* input field.
* @param string $value The value of the "value"-attribute of the text
* input field.
* @param integer $size The value of the "size"-attribute of the text
* input field.
* @param string $str_date_template Sets the template how to display date
* in the text input. The rules follow
* the parameter rules of the
* date()-function.
* @return BirthdayDateTextInput
*/
function BirthdayDateTextInput(
$name = "",
$value = "",
$size = 0,
$str_date_template = ""
)
{
$this->HTMLTextInput( $name, $value, $size, 10 );
$this->setDateTemplate( $str_date_template );
}
/**
* Interprets a given date on the basis of a template.
*
* @access public
* @version 1.0
* @since 1.78
*
* @param string $str_date
* @param string $str_template
* @param boolean $store_format
*
* @return array The date interpreted in an array in index order: year,
* month, day
*/
function interpretDate(
$str_date = "",
$str_template = "",
$store_format = false
)
{
if ( @is_object( $this ) )
{
if ( empty( $str_template ) )
{ $str_template = $this->template_date_format; }
else
if ( $store_format )
{ $this->setDateTemplate( $str_template ); }
if ( empty( $str_date ) )
{ $str_date = $this->value; }
}
$y_pos = strpos( $str_template, "y" );
$m_pos = strpos( $str_template, "m" );
$d_pos = strpos( $str_template, "d" );
$int_max = max( $y_pos, $d_pos, $m_pos );
$int_min = min( $y_pos, $d_pos, $m_pos );
$d_regexp_pos = $m_regexp_pos = $y_regexp_pos = 2;
switch ( $int_max )
{
case $y_pos:
$y_regexp_pos = 3;
break;
case $m_pos:
$m_regexp_pos = 3;
break;
case $d_pos:
$d_regexp_pos = 3;
break;
default:
break;
}
switch ( $int_min )
{
case $y_pos:
$y_regexp_pos = 1;
break;
case $m_pos:
$m_regexp_pos = 1;
break;
case $d_pos:
$d_regexp_pos = 1;
break;
default:
break;
}
$str_template = str_replace( ".", "\.", $str_template );
$str_template = str_replace( "d", "(\d{1,2})", $str_template );
$str_template = str_replace( "m", "(\d{1,2})", $str_template );
$str_template = str_replace( "y", "(\d{4,4})", $str_template );
$matches_arr = array();
preg_match( "!^".$str_template."$!", $str_date, $matches_arr );
if ( @is_object( $this ) && $store_format )
{
$this->day = $matches_arr[$d_regexp_pos];
$this->month = $matches_arr[$m_regexp_pos];
$this->year = $matches_arr[$y_regexp_pos];
}
return array(
$matches_arr[$y_regexp_pos],
$matches_arr[$m_regexp_pos],
$matches_arr[$d_regexp_pos]
);
}
/**
* Returns the value of this item in ISO format.
*
* @access public
* @version 1.0
* @since 0.1.75
*
* @return string The value of this input in ISO format.
*/
function getISODate()
{
if ( preg_match( "!^\d{4,4}-\d{1,2}-\d{1,2}$!", $this->value ) )
return $this->value;
else
{
$str_lang = LANG;
if ( !empty( $this->template_date_format ) )
$str_template = $this->template_date_format;
else
switch ( $str_lang )
{
case "de":
$str_template = "d.m.y";
break;
case "en":
$str_template = "m.d.y";
break;
default:
$str_template = "y-m-d";
break;
}
$tmp_arr = $this->interpretDate( $this->value, $str_template, false );
return $tmp_arr[0]."-".$tmp_arr[1]."-".$tmp_arr[2];
}
}
/**
* A overwritten method to forbid to set the maximal capacity of this special
* kind of input.
*
* @access public
* @version 1.0
* @since 0.1.7
*
* @return void
*/
function setMaxChars()
{ die( "It is not allowed to set the maximum capacity of date input." ); }
/**
* Makes a clone of this object an returns a reference to this clone.
*
* @access public
* @version 1.0
* @since 0.1.2
*
* @param string $new_name
* @param string $selected_value
* @param string $size
*
* @return object
*/
function getClone(
$new_name = "",
$selected_value = "",
$size = 0
)
{
$newInstance = parent::getClone(
$new_name,
$selected_value,
10,
$size
);
return $newInstance;
}
/**
* Returns a javascript functions to validate the correctness of a date.
*
* @access public
* @version 1.1
* @since 0.1.0
*
* @return string
*/
function getJSFunctionsToCheckDate()
{
static $JSOutputted = 0;
if( $JSOutputted < 1 )
{
$JSOutputted ++;
$tmp_js_validate = JS_REGEXP_VALID_DATE;
$tmp_js_digit_separator = JS_DATE_DIGIT_SEPARATOR;
$tmp_js_msg_invalid = JS_ERR_INVALID_DATE_MSG;
$tmp_js_msg_day_zero = JS_ERR_DAY_IS_ZERO_MSG;
$tmp_js_msg_day_gt_31 = JS_ERR_DAY_GREATER_THAN_31_MSG;
$tmp_js_msg_month_zero = JS_ERR_MONTH_IS_ZERO_MSG;
$tmp_js_msg_month_gt_twelve = JS_EER_MONTH_GREATER_THAN_TWELVE;
$tmp_js_msg_day_gt_29_in_feb_of_leap =
JS_ERR_DAY_GREATER_THAN_29_IN_FEBUARY_OF_A_LEAP_YEAR;
$tmp_js_msg_day_gt_28_in_feb_of_non_leap =
JS_ERR_DAY_GREATER_THAN_28_IN_FEBUARY_OF_A_NON_LEAP_YEAR;
$tmp_js_msg_day_gt_30 = JS_ERR_DAY_GREATER_THAN_30_MSG;
$temp =
<<<JSCRIPT
<script language="javascript">
<!--
function removeLeadingZeros( str )
{
while ( str.substr( 0, 1 ) == "0" )
str = str.substr( 1, str.length - 1 );
return str;
}
function isLeapYear( y )
{ return ((y % 4 == 0) && ((y % 100!= 0) || (y % 400 == 0))); }
function checkTextDate( inputItem )
{
if ( inputItem.value == "" )
return true;
regExpress = /${tmp_js_validate}/;
if ( !regExpress.test( inputItem.value ) )
{
alert( unescape( '${tmp_js_msg_invalid}' ) );
return false;
}
var date_tokens = inputItem.value.split( "${tmp_js_digit_separator}" );
day = parseInt( removeLeadingZeros( date_tokens[0] ) );
month = parseInt( removeLeadingZeros( date_tokens[1] ) );
year = parseInt( removeLeadingZeros( date_tokens[2] ) );
if ( day == 0 )
{
alert( unescape( '${tmp_js_msg_day_zero}' ) );
day = 1;
}
if ( day > 31 )
{
alert( unescape( '${tmp_js_msg_day_gt_31}' ) );
day = 31;
}
if ( month == 0 )
{
alert( unescape( '${tmp_js_msg_month_zero}' ) );
month = 1;
}
if ( month > 12 )
{
alert( unescape( '${tmp_js_msg_month_gt_twelve}' ) );
month = 12;
}
if ( isLeapYear( year ) && ( month == 2 ) && ( day > 29 ) )
{
alert( unescape ( '${tmp_js_msg_day_gt_29_in_feb_of_leap}' ) );
day = 29;
}
else
if ( !isLeapYear( year ) && month == 2 && day > 28 )
{
alert( unescape( '${tmp_js_msg_day_gt_28_in_feb_of_non_leap}' ) );
day = 28;
}
else
{
// Month with 30 days
var errMonth = "";
switch( month )
{
case 4:
if ( day > 30 )
errMonth = "{$GLOBALS["monthNames"][3]}";
break;
case 6:
if ( day > 30 )
errMonth = "{$GLOBALS["monthNames"][5]}";
break;
case 9:
if ( day > 30 )
errMonth = "{$GLOBALS["monthNames"][8]}";
break;
case 11:
if ( day > 30 )
errMonth = "{$GLOBALS["monthNames"][10]}";
break;
}
if( errMonth != "" )
{
alert( unescape( '${tmp_js_msg_day_gt_30}' ) );
day = 30;
}
}
day = ( day < 10 ) ? "0" + day : day;
month = ( month < 10 ) ? "0" + month : month;
var str_tmp = inputItem.getAttribute( "dateTemplate" );
var str_val = str_tmp.replace( /d/i, day );
str_val = str_val.replace( /m/i, month );
str_val = str_val.replace( /y/i, year );
inputItem.value = str_val;
return true;
}
// -->
</script>
JSCRIPT;
return $temp;
}
}
/**
* Returns a javascript to check if the given value is valid for this kind of
* input.
*
* @access public
* @version 1.0
* @since 0.1.0
*
* @return string
*/
function getValidationOrder()
{
$outputstr = "checkTextDate( document."
.$parentform -> name."."
.$this -> name
." )";
return $outputstr;
}
/**
* Generates the sourcecode to build this object and returns it.
*
* @access public
* @version 1.0
* @since 0.1.4
*
* @return string
*/
function getPHPSource()
{
$outputstr = "unset( \x24value );\n";
$outputstr .= "\x24value = \x24_REQUEST[\"".$this -> name."\"]\n";
$outputstr .= "\x24input[] = new BirthdayDateTextInput(\n"
." \"".$this -> name."\",\n"
." \x24value,\n"
." \"".$this -> size."\"\n"
." );\n";
$outputstr .= !empty( $this -> value )
? "if( \x24value === \"\" )\n"
." \x24input[count(\x24input)-1] "
."-> setValue( \"".$this -> value."\" );\n\n"
: "\n";
return $outputstr;
}
/**
* Sets the template how to display date in the text input. The rules follow
* the parameter rules of the date()-function.
*
* @access public
* @version 1.12
* @since 0.1.77
*
* @param string $str_date
*
* @return void
*/
function setDateTemplate( $str_date = "" )
{
if ( !empty( $str_date ) )
$this->template_date_format = $str_date;
else
{
$str_lang = LANG;
switch ( $str_lang )
{
case "de":
$this->template_date_format = "d.m.y";
break;
case "en":
$this->template_date_format = "m.d.y";
break;
default:
$this->template_date_format = "y-m-d";
break;
}
}
}
/**
* Returns a generated string based on the attributes of this object.
*
* @access public
* @version 1.15
* @since 0.1.0
*
* @return string
*/
function get()
{
if ( preg_match( "!^\d{4,4}-\d{1,2}-\d{1,2}$!", $this->value ) )
{
$tmp_arr = $this->interpretDate( $this->value, "y-m-d", false );
$this->value = $this->template_date_format;
$this->value = str_replace( "y", $tmp_arr[0], $this->value );
$this->value = str_replace( "m", $tmp_arr[1], $this->value );
$this->value = str_replace( "d", $tmp_arr[2], $this->value );
}
if ( $this->first_output )
{
if ( empty( $this->other_attributes ) )
$this->other_attributes = "dateTemplate=\""
.$this->template_date_format
."\"";
else
$this->other_attributes .= " dateTemplate=\""
.$this->template_date_format
."\"";
$this->first_output = false;
}
parent::setOnBlur( "checkTextDate( this );".$this->blur );
return $this->getJSFunctionsToCheckDate()
.parent::get();
}
} // END of class BirthdayDateTextInput
?>

Source for file BirthdayDateTextInput.class.php