encode.php

   1 <?php
   2
   3 #  Copyright (C) 2005 Jason Woofenden
   4 #
   5 #  This program is free software: you can redistribute it and/or modify
   6 #  it under the terms of the GNU General Public License as published by
   7 #  the Free Software Foundation, either version 3 of the License, or
   8 #  (at your option) any later version.
   9 #
  10 #  This program is distributed in the hope that it will be useful,
  11 #  but WITHOUT ANY WARRANTY; without even the implied warranty of
  12 #  MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
  13 #  GNU General Public License for more details.
  14 #
  15 #  You should have received a copy of the GNU General Public License
  16 #  along with this program.  If not, see <http://www.gnu.org/licenses/>.
  17
  18
  19 # This file contains basic encodings. These are used by the encoder. You can
  20 # specify any template tag to be encoded with this syntax: ~variable encoding~
  21 #
  22 # this example: <p>~foo html~</p>
  23 # will encode foo (using enc_html()) before displaying it, so that characters
  24 # such as < will display properly.
  25
  26 function enc_cap($str) {
  27         $str = ucfirst($str);
  28         return $str;
  29 }
  30
  31 function enc_jsdq($str) {
  32         $str = enc_sql($str);
  33         $str = str_replace("\n", "\\n", $str);
  34         return str_replace("\r", "\\r", $str);
  35 }
  36
  37 # encode for putting within double-quotes in SQL
  38 function enc_sql($str) {
  39         $str = str_replace("\\", "\\\\", $str);
  40         $str = str_replace('"', "\\\"", $str);
  41         return $str;
  42 }
  43
  44 # Encode for output in html. does nothing with whitespace
  45 #
  46 # Example: <p>~foo html~</p>
  47 function enc_html($str) {
  48         $str = str_replace('&', '&amp;', $str);
  49         $str = str_replace('<', '&lt;', $str);
  50         $str = str_replace('>', '&gt;', $str);
  51         return $str;
  52 }
  53
  54 # Encode for output in html. Convert newlines to <br>
  55 #
  56 # Example: <p>~foo htmlbr~</p>
  57 function enc_htmlbr($str) {
  58         $str = enc_html($str);
  59         $str = str_replace("\n", "<br>\n", $str);
  60         return $str;
  61 }
  62
  63 # Encode for output in html. Preserves newlines and indentation by converting
  64 # newlines to <br> and spaces at the begining of lines to &nbsp;&nbsp;
  65 #
  66 # Example: <p>~foo htmlbrtab~</p>
  67 function enc_htmlbrtab($str) {
  68         $str = enc_htmlbr($str);
  69         $space_to_nbsp = create_function('$matches', 'return str_repeat(\'&nbsp;\', strlen($matches[0]) * 2);');
  70         $str = preg_replace_callback("|^ *|m", $space_to_nbsp, $str);
  71         return $str;
  72 }
  73
  74 # Encode for output in html. Spaces converted to &nbsp; and \n to <br>
  75 #
  76 # Example: <option value="12">~foo htmlbrnbsp~</option>
  77 function enc_htmlbrnbsp($str) {
  78         $str = enc_htmlbr($str);
  79         $str = str_replace(' ', '&nbsp;', $str);
  80         return $str;
  81 }
  82
  83 # Encode for output in html. Spaces converted to &nbsp;
  84 #
  85 # Example: <option value="12">~foo htmlnbsp~</option>
  86 function enc_htmlnbsp($str) {
  87         $str = enc_html($str);
  88         $str = str_replace(' ', '&nbsp;', $str);
  89         return $str;
  90 }
  91
  92
  93 # HTML attribute.
  94 #
  95 # Example: <input name="foo" value="~foo attr~">
  96 function enc_attr($str) {
  97         $str = str_replace('&', '&amp;', $str);
  98         $str = str_replace('"', '&quot;', $str);
  99         return $str;
 100 }
 101
 102 # URI agument value.
 103 #
 104 # Example:  <a href="http://example.com?foo=~foo url_val attr~">http://example.com?foo=~foo url_val~</a>
 105 function enc_url_val($str) {
 106         return rawurlencode($str);
 107 }
 108
 109 # FIXME
 110 function enc_url_path($str) {
 111         $str = rawurlencode($str);
 112         $str = str_replace('%2F', '/', $str);
 113         return $str;
 114 }
 115
 116
 117 # This is a hack to work around html's stupid syntax for checkboxes.
 118 #
 119 # Place the template marker just before a " somewhere.
 120 #
 121 # Example: <input type="checkbox" name="foo~foo checked~">
 122 function enc_checked($str) {
 123         if($str && $str !== 'No' && $str !== 'False' && $str !== 'false') {
 124                 return '" checked="checked';
 125         } else {
 126                 return '';
 127         }
 128 }
 129
 130 # 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".
 131 # Example template:  Subscribe to mailing list?: ~subscribe yesno~
 132 function enc_yesno($str) {
 133         if($str && $str !== 'No' && $str !== 'False' && $str !== 'false') {
 134                 return 'Yes';
 135         } else {
 136                 return 'No';
 137         }
 138 }
 139
 140
 141 # add a tab at the begining of each non-empty line
 142 function enc_tab($str) {
 143         $lines = explode("\n", $str);
 144         $out = '';
 145         foreach($lines as $line) {
 146                 if($line) {
 147                         $out .= "\t$line";
 148                 }
 149                 $out .= "\n";
 150         }
 151
 152         # remove the extra newline added above
 153         return substr($out, 0, -1);
 154 }
 155
 156 function enc_upper($str) {
 157         return strtoupper($str);
 158 }
 159
 160 # pass date in the form 2008-05-23
 161 # ercodes date as 05/23/2008
 162 function enc_mmddyyyy($yyyy_mm_dd) {
 163         if($yyyy_mm_dd == '') {
 164                 return '';
 165         }
 166         if(strlen($yyyy_mm_dd) != 10) {
 167                 return date('m/d/Y');
 168         }
 169         return substr($yyyy_mm_dd, 5, 2) . '/' . substr($yyyy_mm_dd, 8, 2) . '/' . substr($yyyy_mm_dd, 0, 4);
 170 }
 171
 172 # depricated. call enc_mmddyyyy() instead
 173 function enc_mdy($str) {
 174         return enc_mmddyyyy($str);
 175 }
 176
 177 function enc_mmddyyyyhhmm($seconds) {
 178         return date('m/d/Y g:ia', (int)$seconds);
 179 }
 180
 181 # takes decimal
 182 # returns hh:mm
 183 function enc_hhmm($str) {
 184         if(strlen($str) == 0) {
 185                 return '';
 186         }
 187         $hours = floor($str);
 188         $minutes = round(($str - $hours) * 60);
 189         $str = sprintf("%d:%02d", $hours, $minutes);
 190         return $str;
 191 }
 192
 193 # takes decimal
 194 # returns hh:mm followed by "am" or "pm" with no space
 195 function enc_12hr($str) {
 196         if(strlen($str) == 0) {
 197                 return '';
 198         }
 199         $hours = floor($str);
 200         $minutes = round(($str - $hours) * 60);
 201         $suffix = 'am';
 202         if($hours >= 12.0) {
 203                 $suffix = 'pm';
 204                 if($hours > 12.0) {
 205                         $hours -= 12.0;
 206                 }
 207         }
 208         $str = sprintf("%d:%02d", $hours, $minutes);
 209         $str .= $suffix;
 210         return $str;
 211 }
 212
 213
 214
 215 # These are depricated! All but PULLDOWN_HASH still work, but you should update your code.
 216 define('PULLDOWN_AUTO', 0); define('PULLDOWN_ARRAY', 1); define('PULLDOWN_HASH', 2); define('PULLDOWN_2D', 3);
 217
 218
 219 # call this function before you run() the template so enc_options() knows what
 220 # to do
 221 #
 222 # Parameters:
 223 #
 224 #   name: the name of the html control
 225 #
 226 #   options: an array of options to display in the pulldown/selectbox. Each
 227 #   element can be either a string, or an array with two elements (first the
 228 #   value to post, and second the value to display in the pulldown)
 229 #
 230 #   multiple: UNTESTED set to true for multiple-select boxes.
 231
 232 function pulldown($name, $in_options, $multiple = false) {
 233         if($multiple === PULLDOWN_HASH) {
 234                 die('Webmaster error: PULLDOWN_HASH is depricated. Pass array(a,b) not a=>b');
 235         }
 236         if($multiple !== true) {
 237                 # Probably due to API change (removing 3rd argument) but don't bother
 238                 # emitting a warning, because the above warning handles the only
 239                 # important case.
 240                 $multiple = false;
 241         }
 242         $options = array();
 243         foreach($in_options as $option) {
 244                 if(is_array($option)) {
 245                         $options[] = $option;
 246                 } else {
 247                         $options[] = array($option, $option);
 248                 }
 249         }
 250         $GLOBALS[$name . '_options'] = array(
 251                 'options' => $options,
 252                 'multiple' => $multiple);
 253 }
 254
 255 # output a bunch of <option> tags
 256 function enc_options($values, $name) {
 257         if(!isset($GLOBALS[$name . '_options'])) {
 258                 die("pulldown('$name') must be called before this template can be run. See code/wfpl/encode.php");
 259         }
 260         if($GLOBALS[$name . '_options']['multiple']) { # FIXME test this
 261                 $values = explode(', ', $values);
 262         }
 263         return encode_options($values, $GLOBALS[$name . '_options']['options'], PULLDOWN_2D);
 264 }
 265
 266 # for radios and pulldowns:
 267 # pass posted value
 268 # returns what the user sees in the pulldown or on the radio button caption
 269 function enc_pulled($str, $name) {
 270         if(!isset($GLOBALS[$name . '_options'])) {
 271                 die("pulldown('$name') must be called before this template can be run. See code/wfpl/encode.php");
 272         }
 273         foreach($GLOBALS[$name . '_options']['options'] as &$kv) {
 274                 if($kv[0] == $str) {
 275                         return $kv[1];
 276                 }
 277         }
 278         return $str;
 279 }
 280
 281 function enc_radio_n($str, $name, $n) {
 282         if(!isset($GLOBALS[$name . '_options'])) {
 283                 die("pulldown('$name') must be called before this template can be run. See code/wfpl/encode.php");
 284         }
 285
 286         if(!isset($GLOBALS[$name . '_options']['options'][$n])) {
 287                 die("Template error: pulldown('$name') does not have element # $n");
 288         }
 289
 290         $value = enc_attr($GLOBALS[$name . '_options']['options'][$n][0]);
 291
 292         if($str === $value) {
 293                 $value .= '" checked="checked';
 294         }
 295
 296         return $value;
 297 }
 298 function enc_radio_0($str, $name) { return enc_radio_n($str, $name, 0); }
 299 function enc_radio_1($str, $name) { return enc_radio_n($str, $name, 1); }
 300 function enc_radio_2($str, $name) { return enc_radio_n($str, $name, 2); }
 301 function enc_radio_3($str, $name) { return enc_radio_n($str, $name, 3); }
 302 function enc_radio_4($str, $name) { return enc_radio_n($str, $name, 4); }
 303 function enc_radio_5($str, $name) { return enc_radio_n($str, $name, 5); }
 304 function enc_radio_6($str, $name) { return enc_radio_n($str, $name, 6); }
 305 function enc_radio_7($str, $name) { return enc_radio_n($str, $name, 7); }
 306
 307
 308 function enc_radio_caption_n($str, $name, $n) {
 309         if(!isset($GLOBALS[$name . '_options'])) {
 310                 die("pulldown('$name') must be called before this template can be run. See code/wfpl/encode.php");
 311         }
 312
 313         if(!isset($GLOBALS[$name . '_options']['options'][$n])) {
 314                 die("Template error: pulldown('$name') does not have element #$n");
 315         }
 316
 317         return $GLOBALS[$name . '_options']['options'][$n][1];
 318 }
 319 function enc_radio_caption_0($str, $name) { return enc_radio_caption_n($str, $name, 0); }
 320 function enc_radio_caption_1($str, $name) { return enc_radio_caption_n($str, $name, 1); }
 321 function enc_radio_caption_2($str, $name) { return enc_radio_caption_n($str, $name, 2); }
 322 function enc_radio_caption_3($str, $name) { return enc_radio_caption_n($str, $name, 3); }
 323 function enc_radio_caption_4($str, $name) { return enc_radio_caption_n($str, $name, 4); }
 324 function enc_radio_caption_5($str, $name) { return enc_radio_caption_n($str, $name, 5); }
 325 function enc_radio_caption_6($str, $name) { return enc_radio_caption_n($str, $name, 6); }
 326 function enc_radio_caption_7($str, $name) { return enc_radio_caption_n($str, $name, 7); }
 327
 328
 329 # use this function along with a special template to generate the html for pulldowns and multiple select boxes.
 330 #
 331 # Parameters:
 332 #
 333 #    selected: can be a string or (for multiple-selects) an array
 334 #
 335 #    options, keys_from: see documentation for pulldown() above
 336 function encode_options($selected, $options, $keys_from) {
 337         if(!is_array($selected)) {
 338                 $selected = array($selected);
 339         }
 340
 341         if($keys_from != PULLDOWN_2D) {
 342                 $options = pulldown_options_to_2d($options, $keys_from);
 343         }
 344
 345         $out = '';
 346         foreach($options as $option) {
 347                 list($value, $display, $arg3) = $option;
 348                 $out .= '<option';
 349
 350                 if($arg3 == 'disabled') {
 351                         $out .= ' disabled';
 352                 } elseif(in_array($value, $selected)) {
 353                         $out .= ' selected';
 354                 }
 355
 356                 if($value !== $display || strpos($value, ' ') !== false) {
 357                         $out .= ' value="';
 358                         $out .= enc_attr($value);
 359                         $out .= '"';
 360                 }
 361
 362                 $out .= '>';
 363
 364                 $out .= enc_htmlnbsp($display);
 365
 366                 $out .= "</option>\n";
 367         }
 368
 369         return $out;
 370 }
 371
 372 $GLOBALS['wfpl_states_assoc'] = array("AL" => "Alabama", "AK" => "Alaska", "AZ" => "Arizona", "AR" => "Arkansas", "CA" => "California", "CO" => "Colorado", "CT" => "Connecticut", "DE" => "Delaware", "FL" => "Florida", "GA" => "Georgia", "HI" => "Hawaii", "ID" => "Idaho", "IL" => "Illinois", "IN" => "Indiana", "IA" => "Iowa", "KS" => "Kansas", "KY" => "Kentucky", "LA" => "Louisiana", "ME" => "Maine", "MD" => "Maryland", "MA" => "Massachusetts", "MI" => "Michigan", "MN" => "Minnesota", "MS" => "Mississippi", "MO" => "Missouri", "MT" => "Montana", "NE" => "Nebraska", "NV" => "Nevada", "NH" => "New Hampshire", "NJ" => "New Jersey", "NM" => "New Mexico", "NY" => "New York", "NC" => "North Carolina", "ND" => "North Dakota", "OH" => "Ohio", "OK" => "Oklahoma", "OR" => "Oregon", "PA" => "Pennsylvania", "RI" => "Rhode Island", "SC" => "South Carolina", "SD" => "South Dakota", "TN" => "Tennessee", "TX" => "Texas", "UT" => "Utah", "VT" => "Vermont", "VA" => "Virginia", "WA" => "Washington", "DC" => "Washington, DC", "WV" => "West Virginia", "WI" => "Wisconsin", "WY" => "Wyoming");
 373
 374 # display <option>s
 375 function enc_states($str) {
 376         $ret = '';
 377
 378         return encode_options($str, $GLOBALS['wfpl_states_assoc'], PULLDOWN_HASH);
 379 }
 380
 381 $GLOBALS['wfpl_provinces_assoc'] = array("AB" => "Alberta", "BC" => "British Columbia", "MB" => "Manitoba", "NF" => "Newfoundland", "NB" => "New Brunswick", "NS" => "Nova Scotia", "NT" => "Northwest Territories", "NU" => "Nunavut", "ON" => "Ontario", "PE" => "Prince Edward Island", "QC" => "Quebec", "SK" => "Saskatchewan", "YT" => "Yukon Territory");
 382
 383 # display <option>s
 384 function enc_provinces($str) {
 385         $ret = '';
 386
 387         return encode_options($str, $GLOBALS['wfpl_provinces_assoc'], PULLDOWN_HASH);
 388 }
 389
 390 # returns "odd", then "even", then "odd" etc.
 391 function enc_evenodd($values, $name) {
 392         if(!isset($GLOBALS['wfpl_even_odds'])) {
 393                 $GLOBALS['wfpl_even_odds'] = array();
 394         }
 395
 396         if($GLOBALS['wfpl_even_odds'][$name]) {
 397                 $GLOBALS['wfpl_even_odds'][$name] = false;
 398                 return 'even';
 399         } else {
 400                 $GLOBALS['wfpl_even_odds'][$name] = true;
 401                 return 'odd';
 402         }
 403 }
 404
 405 function enc_image_src($str) {
 406         list($src, $width, $height, $a, $b, $c) = explode(' ', $str);
 407         return $src;
 408 }
 409
 410 function enc_image_width($str) {
 411         list($src, $width, $height, $a, $b, $c) = explode(' ', $str);
 412         return $width;
 413 }
 414
 415 function enc_image_height($str) {
 416         list($src, $width, $height, $a, $b, $c) = explode(' ', $str);
 417         return $height;
 418 }
 419
 420 function enc_thumb_src($str) {
 421         list($a, $b, $c, $src, $width, $height) = explode(' ', $str);
 422         return $src;
 423 }
 424
 425 function enc_thumb_width($str) {
 426         list($a, $b, $c, $src, $width, $height) = explode(' ', $str);
 427         return $width;
 428 }
 429 function enc_thumb_height($str) {
 430         list($a, $b, $c, $src, $width, $height) = explode(' ', $str);
 431         return $height;
 432 }
 433
 434 # example template: Length: ~length html~ day~length s~
 435 function enc_s($str) {
 436         if($str == '1') {
 437                 return '';
 438         }
 439
 440         return 's';
 441 }