source: trunk/include/smarty/libs/plugins/function.html_select_date.php @ 23384

Last change on this file since 23384 was 23384, checked in by rvelices, 11 years ago

smarty 3 - first pass for tests

  • Property svn:eol-style set to LF
File size: 14.2 KB
Line 
1<?php
2/**
3 * Smarty plugin
4 *
5 * @package Smarty
6 * @subpackage PluginsFunction
7 */
8
9/**
10 * @ignore
11 */
12require_once(SMARTY_PLUGINS_DIR . 'shared.escape_special_chars.php');
13/**
14 * @ignore
15 */
16require_once(SMARTY_PLUGINS_DIR . 'shared.make_timestamp.php');
17
18/**
19 * Smarty {html_select_date} plugin
20 *
21 * Type:     function<br>
22 * Name:     html_select_date<br>
23 * Purpose:  Prints the dropdowns for date selection.
24 *
25 * ChangeLog:
26 * <pre>
27 *            - 1.0 initial release
28 *            - 1.1 added support for +/- N syntax for begin
29 *              and end year values. (Monte)
30 *            - 1.2 added support for yyyy-mm-dd syntax for
31 *              time value. (Jan Rosier)
32 *            - 1.3 added support for choosing format for
33 *              month values (Gary Loescher)
34 *            - 1.3.1 added support for choosing format for
35 *              day values (Marcus Bointon)
36 *            - 1.3.2 support negative timestamps, force year
37 *              dropdown to include given date unless explicitly set (Monte)
38 *            - 1.3.4 fix behaviour of 0000-00-00 00:00:00 dates to match that
39 *              of 0000-00-00 dates (cybot, boots)
40 *            - 2.0 complete rewrite for performance, 
41 *              added attributes month_names, *_id
42 * </pre>
43 *
44 * @link http://www.smarty.net/manual/en/language.function.html.select.date.php {html_select_date}
45 *      (Smarty online manual)
46 * @version 2.0
47 * @author Andrei Zmievski
48 * @author Monte Ohrt <monte at ohrt dot com>
49 * @author Rodney Rehm
50 * @param array                    $params   parameters
51 * @param Smarty_Internal_Template $template template object
52 * @return string
53 */
54function smarty_function_html_select_date($params, $template)
55{
56    // generate timestamps used for month names only
57    static $_month_timestamps = null;
58    static $_current_year = null;
59    if ($_month_timestamps === null) {
60        $_current_year = date('Y');
61        $_month_timestamps = array();
62        for ($i = 1; $i <= 12; $i++) {
63            $_month_timestamps[$i] = mktime(0, 0, 0, $i, 1, 2000);
64        }
65    }
66
67    /* Default values. */
68    $prefix = "Date_";
69    $start_year = null;
70    $end_year = null;
71    $display_days = true;
72    $display_months = true;
73    $display_years = true;
74    $month_format = "%B";
75    /* Write months as numbers by default  GL */
76    $month_value_format = "%m";
77    $day_format = "%02d";
78    /* Write day values using this format MB */
79    $day_value_format = "%d";
80    $year_as_text = false;
81    /* Display years in reverse order? Ie. 2000,1999,.... */
82    $reverse_years = false;
83    /* Should the select boxes be part of an array when returned from PHP?
84       e.g. setting it to "birthday", would create "birthday[Day]",
85       "birthday[Month]" & "birthday[Year]". Can be combined with prefix */
86    $field_array = null;
87    /* <select size>'s of the different <select> tags.
88       If not set, uses default dropdown. */
89    $day_size = null;
90    $month_size = null;
91    $year_size = null;
92    /* Unparsed attributes common to *ALL* the <select>/<input> tags.
93       An example might be in the template: all_extra ='class ="foo"'. */
94    $all_extra = null;
95    /* Separate attributes for the tags. */
96    $day_extra = null;
97    $month_extra = null;
98    $year_extra = null;
99    /* Order in which to display the fields.
100       "D" -> day, "M" -> month, "Y" -> year. */
101    $field_order = 'MDY';
102    /* String printed between the different fields. */
103    $field_separator = "\n";
104    $option_separator = "\n";
105    $time = null;
106    // $all_empty = null;
107    // $day_empty = null;
108    // $month_empty = null;
109    // $year_empty = null;
110    $extra_attrs = '';
111    $all_id = null;
112    $day_id = null;
113    $month_id = null;
114    $year_id = null;
115
116    foreach ($params as $_key => $_value) {
117        switch ($_key) {
118            case 'time':
119                if (!is_array($_value) && $_value !== null) {
120                    $time = smarty_make_timestamp($_value);
121                }
122                break;
123               
124            case 'month_names':
125                if (is_array($_value) && count($_value) == 12) {
126                    $$_key = $_value;
127                } else {
128                    trigger_error("html_select_date: month_names must be an array of 12 strings", E_USER_NOTICE);
129                }
130                break;
131               
132            case 'prefix':
133            case 'field_array':
134            case 'start_year':
135            case 'end_year':
136            case 'day_format':
137            case 'day_value_format':
138            case 'month_format':
139            case 'month_value_format':
140            case 'day_size':
141            case 'month_size':
142            case 'year_size':
143            case 'all_extra':
144            case 'day_extra':
145            case 'month_extra':
146            case 'year_extra':
147            case 'field_order':
148            case 'field_separator':
149            case 'option_separator':
150            case 'all_empty':
151            case 'month_empty':
152            case 'day_empty':
153            case 'year_empty':
154            case 'all_id':
155            case 'month_id':
156            case 'day_id':
157            case 'year_id':
158                $$_key = (string)$_value;
159                break;
160
161            case 'display_days':
162            case 'display_months':
163            case 'display_years':
164            case 'year_as_text':
165            case 'reverse_years':
166                $$_key = (bool)$_value;
167                break;
168
169            default:
170                if (!is_array($_value)) {
171                    $extra_attrs .= ' ' . $_key . '="' . smarty_function_escape_special_chars($_value) . '"';
172                } else {
173                    trigger_error("html_select_date: extra attribute '$_key' cannot be an array", E_USER_NOTICE);
174                } 
175                break;
176        } 
177    }
178   
179    // Note: date() is faster than strftime()
180    // Note: explode(date()) is faster than date() date() date()
181    if (isset($params['time']) && is_array($params['time'])) {
182        if (isset($params['time'][$prefix . 'Year'])) {
183            // $_REQUEST[$field_array] given
184            foreach (array('Y' => 'Year',  'm' => 'Month', 'd' => 'Day') as $_elementKey => $_elementName) {
185                $_variableName = '_' . strtolower($_elementName);
186                $$_variableName = isset($params['time'][$prefix . $_elementName])
187                    ? $params['time'][$prefix . $_elementName]
188                    : date($_elementKey);
189            }
190            $time = mktime(0, 0, 0, $_month, $_day, $_year);
191        } elseif (isset($params['time'][$field_array][$prefix . 'Year'])) {
192            // $_REQUEST given
193            foreach (array('Y' => 'Year',  'm' => 'Month', 'd' => 'Day') as $_elementKey => $_elementName) {
194                $_variableName = '_' . strtolower($_elementName);
195                $$_variableName = isset($params['time'][$field_array][$prefix . $_elementName])
196                    ? $params['time'][$field_array][$prefix . $_elementName]
197                    : date($_elementKey);
198            }
199            $time = mktime(0, 0, 0, $_month, $_day, $_year);
200        } else {
201            // no date found, use NOW
202            list($_year, $_month, $_day) = $time = explode('-', date('Y-m-d'));
203        }
204    } elseif ($time === null) {
205        if (array_key_exists('time', $params)) {
206            $_year = $_month = $_day = $time = null;
207        } else {
208            list($_year, $_month, $_day) = $time = explode('-', date('Y-m-d'));
209        }
210    } else {
211        list($_year, $_month, $_day) = $time = explode('-', date('Y-m-d', $time));
212    }
213
214    // make syntax "+N" or "-N" work with $start_year and $end_year
215    // Note preg_match('!^(\+|\-)\s*(\d+)$!', $end_year, $match) is slower than trim+substr
216    foreach (array('start', 'end') as $key) {
217        $key .= '_year';
218        $t = $$key;
219        if ($t === null) {
220            $$key = (int)$_current_year;
221        } else if ($t[0] == '+') {
222            $$key = (int)($_current_year + trim(substr($t, 1)));
223        } else if ($t[0] == '-') {
224            $$key = (int)($_current_year - trim(substr($t, 1)));
225        } else {
226            $$key = (int)$$key;
227        }
228    }
229
230    // flip for ascending or descending
231    if (($start_year > $end_year && !$reverse_years) || ($start_year < $end_year && $reverse_years)) {
232        $t = $end_year;
233        $end_year = $start_year;
234        $start_year = $t;
235    }
236
237    // generate year <select> or <input>
238    if ($display_years) {
239        $_html_years = '';
240        $_extra = '';
241        $_name = $field_array ? ($field_array . '[' . $prefix . 'Year]') : ($prefix . 'Year');
242        if ($all_extra) {
243            $_extra .= ' ' . $all_extra;
244        } 
245        if ($year_extra) {
246            $_extra .= ' ' . $year_extra;
247        }
248       
249        if ($year_as_text) {
250            $_html_years = '<input type="text" name="' . $_name . '" value="' . $_year . '" size="4" maxlength="4"' . $_extra . $extra_attrs . ' />';
251        } else {
252            $_html_years = '<select name="' . $_name . '"';
253            if ($year_id !== null || $all_id !== null) {
254                $_html_years .= ' id="' . smarty_function_escape_special_chars( 
255                    $year_id !== null ? ( $year_id ? $year_id : $_name ) : ( $all_id ? ($all_id . $_name) : $_name ) 
256                ) . '"';
257            }
258            if ($year_size) {
259                $_html_years .= ' size="' . $year_size . '"';
260            } 
261            $_html_years .= $_extra . $extra_attrs . '>' . $option_separator;
262           
263            if (isset($year_empty) || isset($all_empty)) {
264                $_html_years .= '<option value="">' . ( isset($year_empty) ? $year_empty : $all_empty ) . '</option>' . $option_separator;
265            }
266           
267            $op = $start_year > $end_year ? -1 : 1;
268            for ($i=$start_year; $op > 0 ? $i <= $end_year : $i >= $end_year; $i += $op) {
269                $_html_years .= '<option value="' . $i . '"'
270                    . ($_year == $i ? ' selected="selected"' : '')
271                    . '>' . $i . '</option>' . $option_separator;
272            }
273           
274            $_html_years .= '</select>';
275        }
276    }
277   
278    // generate month <select> or <input>
279    if ($display_months) {
280        $_html_month = '';
281        $_extra = '';
282        $_name = $field_array ? ($field_array . '[' . $prefix . 'Month]') : ($prefix . 'Month');
283        if ($all_extra) {
284            $_extra .= ' ' . $all_extra;
285        } 
286        if ($month_extra) {
287            $_extra .= ' ' . $month_extra;
288        }
289       
290        $_html_months = '<select name="' . $_name . '"';
291        if ($month_id !== null || $all_id !== null) {
292            $_html_months .= ' id="' . smarty_function_escape_special_chars( 
293                $month_id !== null ? ( $month_id ? $month_id : $_name ) : ( $all_id ? ($all_id . $_name) : $_name ) 
294            ) . '"';
295        }
296        if ($month_size) {
297            $_html_months .= ' size="' . $month_size . '"';
298        } 
299        $_html_months .= $_extra . $extra_attrs . '>' . $option_separator;
300       
301        if (isset($month_empty) || isset($all_empty)) {
302            $_html_months .= '<option value="">' . ( isset($month_empty) ? $month_empty : $all_empty ) . '</option>' . $option_separator;
303        }
304       
305        for ($i = 1; $i <= 12; $i++) {
306            $_val = sprintf('%02d', $i);
307            $_text = isset($month_names) ? smarty_function_escape_special_chars($month_names[$i]) : ($month_format == "%m" ? $_val : strftime($month_format, $_month_timestamps[$i]));
308            $_value = $month_value_format == "%m" ? $_val : strftime($month_value_format, $_month_timestamps[$i]);
309            $_html_months .= '<option value="' . $_value . '"'
310                . ($_val == $_month ? ' selected="selected"' : '')
311                . '>' . $_text . '</option>' . $option_separator;
312        }
313       
314        $_html_months .= '</select>';
315    }
316   
317    // generate day <select> or <input>
318    if ($display_days) {
319        $_html_day = '';
320        $_extra = '';
321        $_name = $field_array ? ($field_array . '[' . $prefix . 'Day]') : ($prefix . 'Day');
322        if ($all_extra) {
323            $_extra .= ' ' . $all_extra;
324        } 
325        if ($day_extra) {
326            $_extra .= ' ' . $day_extra;
327        }
328       
329        $_html_days = '<select name="' . $_name . '"';
330        if ($day_id !== null || $all_id !== null) {
331            $_html_days .= ' id="' . smarty_function_escape_special_chars( 
332                $day_id !== null ? ( $day_id ? $day_id : $_name ) : ( $all_id ? ($all_id . $_name) : $_name ) 
333            ) . '"';
334        }
335        if ($day_size) {
336            $_html_days .= ' size="' . $day_size . '"';
337        } 
338        $_html_days .= $_extra . $extra_attrs . '>' . $option_separator;
339       
340        if (isset($day_empty) || isset($all_empty)) {
341            $_html_days .= '<option value="">' . ( isset($day_empty) ? $day_empty : $all_empty ) . '</option>' . $option_separator;
342        }
343       
344        for ($i = 1; $i <= 31; $i++) {
345            $_val = sprintf('%02d', $i);
346            $_text = $day_format == '%02d' ? $_val : sprintf($day_format, $i);
347            $_value = $day_value_format ==  '%02d' ? $_val : sprintf($day_value_format, $i);
348            $_html_days .= '<option value="' . $_value . '"'
349                . ($_val == $_day ? ' selected="selected"' : '')
350                . '>' . $_text . '</option>' . $option_separator;
351        }
352       
353        $_html_days .= '</select>';
354    }
355
356    // order the fields for output
357    $_html = '';
358    for ($i=0; $i <= 2; $i++) {
359        switch ($field_order[$i]) {
360            case 'Y':
361            case 'y':
362                if (isset($_html_years)) {
363                    if ($_html) {
364                        $_html .= $field_separator;
365                    }
366                    $_html .= $_html_years;
367                }
368            break;
369           
370            case 'm':
371            case 'M':
372                if (isset($_html_months)) {
373                    if ($_html) {
374                        $_html .= $field_separator;
375                    }
376                    $_html .= $_html_months;
377                }
378            break;
379           
380            case 'd':
381            case 'D':
382                if (isset($_html_days)) {
383                    if ($_html) {
384                        $_html .= $field_separator;
385                    }
386                    $_html .= $_html_days;
387                }
388            break;
389        }
390    }
391    return $_html;
392}
393
394?>
Note: See TracBrowser for help on using the repository browser.