# will encode foo (using enc_html()) before displaying it, so that characters
# such as < will display properly.
+function enc_cap($str) {
+ $str = ucfirst($str);
+ return $str;
+}
+
+# quote for placing between single quotes in php
+function enc_phpsq($str) {
+ $str = str_replace("\\", "\\\\", $str);
+ $str = str_replace("'", "\\'", $str);
+ return $str;
+}
+
+function enc_jsdq($str) {
+ $str = enc_sql($str);
+ $str = str_replace("\n", "\\n", $str);
+ $str = str_replace("\r", "\\r", $str);
+ return $str;
+}
+
+function enc_json($str) {
+ return json_encode($str);
+}
# encode for putting within double-quotes in SQL
function enc_sql($str) {
@@ -36,7 +45,7 @@ function enc_sql($str) {
# Encode for output in html. does nothing with whitespace
#
-# Example:
~foo.html~
+# Example:
~foo html~
function enc_html($str) {
$str = str_replace('&', '&', $str);
$str = str_replace('<', '<', $str);
@@ -44,10 +53,48 @@ function enc_html($str) {
return $str;
}
+# Encode for output in html. Convert newlines to
+#
+# Example:
~foo htmlbr~
+function enc_htmlbr($str) {
+ $str = enc_html($str);
+ $str = str_replace("\n", " \n", $str);
+ return $str;
+}
+
+# Encode for output in html. Preserves newlines and indentation by converting
+# newlines to and spaces/tabs at the begining of lines to s
+#
+# Example:
~foo htmlbrtab~
+function enc_htmlbrtab($str) {
+ $str = enc_htmlbr($str);
+ $whitespace_to_nbsp = create_function('$matches', '$count = 0; $chars = str_split($matches[0]); foreach ($chars as $c) { if ($c == " ") { $count += 1; } else if ($c == "\t") { $count += 8; } } return str_repeat(" ", $count);');
+ $str = preg_replace_callback("|^[ \t]+|m", $whitespace_to_nbsp, $str);
+ return $str;
+}
+
+# Encode for output in html. Spaces converted to and \n to
+#
+# Example:
+function enc_htmlbrnbsp($str) {
+ $str = enc_htmlbr($str);
+ $str = str_replace(' ', ' ', $str);
+ return $str;
+}
+
+# Encode for output in html. Spaces converted to
+#
+# Example:
+function enc_htmlnbsp($str) {
+ $str = enc_html($str);
+ $str = str_replace(' ', ' ', $str);
+ return $str;
+}
+
# HTML attribute.
#
-# Example:
+# Example:
function enc_attr($str) {
$str = str_replace('&', '&', $str);
$str = str_replace('"', '"', $str);
@@ -56,53 +103,403 @@ function enc_attr($str) {
# URI agument value.
#
-# Example: http://example.com?foo=~foo.url_val~
+# Example: http://example.com?foo=~foo url_val~
function enc_url_val($str) {
return rawurlencode($str);
}
+# FIXME
+function enc_url_path($str) {
+ $str = rawurlencode($str);
+ $str = str_replace('%2F', '/', $str);
+ return $str;
+}
+
+
# This is a hack to work around html's stupid syntax for checkboxes.
#
# Place the template marker just before a " somewhere.
#
-# Example:
+# Example:
function enc_checked($str) {
- if($str == 'Yes') {
+ if($str && $str !== 'No' && $str !== 'False' && $str !== 'false') {
return '" checked="checked';
} else {
return '';
}
}
-# add a tab at the begining of each non-empty line
+# normally, checkboxes values from get/post to 0 or 1, and stored in the database this way. enc_yesno() can be used in your templates to display this as "Yes" or "No".
+# Example template: Subscribe to mailing list?: ~subscribe yesno~
+function enc_yesno($str) {
+ if($str && $str !== 'No' && $str !== 'False' && $str !== 'false') {
+ return 'Yes';
+ } else {
+ return 'No';
+ }
+}
+
+
+# add a tab at the begining of each line
function enc_tab($str) {
- $lines = explode("\n", $str);
+ if('' . $str === '') {
+ return '';
+ }
+ return "\t" . implode("\n\t", explode("\n", $str));
+}
+
+function enc_uppercase($str) {
+ return strtoupper($str);
+}
+function enc_upper($str) { # depricated
+ return enc_uppercase($str);
+}
+
+function enc_lowercase($str) {
+ return strtolower($str);
+}
+
+# pass date in the form 2008-05-23
+# ercodes date as 05/23/2008
+function enc_mmddyyyy($yyyy_mm_dd) {
+ if($yyyy_mm_dd == '') {
+ return '';
+ }
+ if(strlen($yyyy_mm_dd) != 10) {
+ return date('m/d/Y');
+ }
+ return substr($yyyy_mm_dd, 5, 2) . '/' . substr($yyyy_mm_dd, 8, 2) . '/' . substr($yyyy_mm_dd, 0, 4);
+}
+
+# depricated. call enc_mmddyyyy() instead
+function enc_mdy($str) {
+ return enc_mmddyyyy($str);
+}
+
+# pass unix timestamp or "2012-12-20 22:23:34"
+function enc_mmddyyyyhhmm($str) {
+ if(is_numeric($str)) {
+ return date('m/d/Y g:ia', (int)$str);
+ } else {
+ return enc_mmddyyyy(substr($str, 0, 10)) . substr($str, 10, 6);
+ }
+}
+
+# takes decimal number of hours
+# returns hh:mm
+function enc_hhmm($str) {
+ if(strlen($str) == 0) {
+ return '';
+ }
+ $hours = floor($str);
+ $minutes = round(($str - $hours) * 60);
+ $str = sprintf("%d:%02d", $hours, $minutes);
+ return $str;
+}
+
+# takes decimal number of hours
+# returns hh:mm followed by "am" or "pm" with no space
+function enc_12hr($str) {
+ if(strlen($str) == 0) {
+ return '';
+ }
+ $hours = floor($str);
+ $minutes = round(($str - $hours) * 60);
+ $suffix = 'am';
+ if($hours >= 12.0) {
+ $suffix = 'pm';
+ if($hours > 12.0) {
+ $hours -= 12.0;
+ }
+ }
+ $str = sprintf("%d:%02d", $hours, $minutes);
+ $str .= $suffix;
+ return $str;
+}
+
+
+
+# These are depricated! All but PULLDOWN_HASH still work, but you should update your code.
+define('PULLDOWN_AUTO', 0); define('PULLDOWN_ARRAY', 1); define('PULLDOWN_HASH', 2); define('PULLDOWN_2D', 3);
+
+
+# call this function before you run() the template so enc_options() knows what
+# to do
+#
+# Parameters:
+#
+# name: the name of the html control
+#
+# options: an array of options to display in the pulldown/selectbox. Each
+# element can be either a string, or an array with two elements (first the
+# value to post, and second the value to display in the pulldown)
+#
+# multiple: UNTESTED set to true for multiple-select boxes.
+
+function pulldown($name, $in_options, $multiple = false) {
+ if($multiple === PULLDOWN_HASH) {
+ die('Webmaster error: PULLDOWN_HASH is depricated. Pass array(a,b) not a=>b');
+ }
+ if($multiple !== true) {
+ # Probably due to API change (removing 3rd argument) but don't bother
+ # emitting a warning, because the above warning handles the only
+ # important case.
+ $multiple = false;
+ }
+ $options = array();
+ foreach($in_options as $option) {
+ if(is_array($option)) {
+ $options[] = $option;
+ } else {
+ $options[] = array($option, $option);
+ }
+ }
+ $GLOBALS[$name . '_options'] = array(
+ 'options' => $options,
+ 'multiple' => $multiple);
+}
+
+# output a bunch of