| 1 | <?php |
| 2 | /** |
| 3 | * Smarty plugin |
| 4 | * @package Smarty |
| 5 | * @subpackage plugins |
| 6 | */ |
| 7 | |
| 8 | |
| 9 | /** |
| 10 | * Smarty {mailto} function plugin |
| 11 | * |
| 12 | * Type: function<br> |
| 13 | * Name: mailto<br> |
| 14 | * Date: May 21, 2002 |
| 15 | * Purpose: automate mailto address link creation, and optionally |
| 16 | * encode them.<br> |
| 17 | * Input:<br> |
| 18 | * - address = e-mail address |
| 19 | * - text = (optional) text to display, default is address |
| 20 | * - encode = (optional) can be one of: |
| 21 | * * none : no encoding (default) |
| 22 | * * javascript : encode with javascript |
| 23 | * * hex : encode with hexidecimal (no javascript) |
| 24 | * - cc = (optional) address(es) to carbon copy |
| 25 | * - bcc = (optional) address(es) to blind carbon copy |
| 26 | * - subject = (optional) e-mail subject |
| 27 | * - newsgroups = (optional) newsgroup(s) to post to |
| 28 | * - followupto = (optional) address(es) to follow up to |
| 29 | * - extra = (optional) extra tags for the href link |
| 30 | * |
| 31 | * Examples: |
| 32 | * <pre> |
| 33 | * {mailto address="me@domain.com"} |
| 34 | * {mailto address="me@domain.com" encode="javascript"} |
| 35 | * {mailto address="me@domain.com" encode="hex"} |
| 36 | * {mailto address="me@domain.com" subject="Hello to you!"} |
| 37 | * {mailto address="me@domain.com" cc="you@domain.com,they@domain.com"} |
| 38 | * {mailto address="me@domain.com" extra='class="mailto"'} |
| 39 | * </pre> |
| 40 | * @link http://smarty.php.net/manual/en/language.function.mailto.php {mailto} |
| 41 | * (Smarty online manual) |
| 42 | * @version 1.2 |
| 43 | * @author Monte Ohrt <monte@ispi.net> |
| 44 | * @author credits to Jason Sweat (added cc, bcc and subject functionality) |
| 45 | * @param array |
| 46 | * @param Smarty |
| 47 | * @return string |
| 48 | */ |
| 49 | function smarty_function_mailto($params, &$smarty) |
| 50 | { |
| 51 | $extra = ''; |
| 52 | extract($params); |
| 53 | |
| 54 | if (empty($address)) { |
| 55 | $smarty->trigger_error("mailto: missing 'address' parameter"); |
| 56 | return; |
| 57 | } |
| 58 | |
| 59 | if (empty($text)) { |
| 60 | $text = $address; |
| 61 | } |
| 62 | |
| 63 | // netscape and mozilla do not decode %40 (@) in BCC field (bug?) |
| 64 | // so, don't encode it. |
| 65 | |
| 66 | $mail_parms = array(); |
| 67 | if (!empty($cc)) { |
| 68 | $mail_parms[] = 'cc='.str_replace('%40','@',rawurlencode($cc)); |
| 69 | } |
| 70 | |
| 71 | if (!empty($bcc)) { |
| 72 | $mail_parms[] = 'bcc='.str_replace('%40','@',rawurlencode($bcc)); |
| 73 | } |
| 74 | |
| 75 | if (!empty($subject)) { |
| 76 | $mail_parms[] = 'subject='.rawurlencode($subject); |
| 77 | } |
| 78 | |
| 79 | if (!empty($newsgroups)) { |
| 80 | $mail_parms[] = 'newsgroups='.rawurlencode($newsgroups); |
| 81 | } |
| 82 | |
| 83 | if (!empty($followupto)) { |
| 84 | $mail_parms[] = 'followupto='.str_replace('%40','@',rawurlencode($followupto)); |
| 85 | } |
| 86 | |
| 87 | $mail_parm_vals = ''; |
| 88 | for ($i=0; $i<count($mail_parms); $i++) { |
| 89 | $mail_parm_vals .= (0==$i) ? '?' : '&'; |
| 90 | $mail_parm_vals .= $mail_parms[$i]; |
| 91 | } |
| 92 | $address .= $mail_parm_vals; |
| 93 | |
| 94 | if (empty($encode)) { |
| 95 | $encode = 'none'; |
| 96 | } elseif (!in_array($encode,array('javascript','hex','none')) ) { |
| 97 | $smarty->trigger_error("mailto: 'encode' parameter must be none, javascript or hex"); |
| 98 | return; |
| 99 | } |
| 100 | |
| 101 | if ($encode == 'javascript' ) { |
| 102 | $string = 'document.write(\'<a href="mailto:'.$address.'" '.$extra.'>'.$text.'</a>\');'; |
| 103 | |
| 104 | for ($x=0; $x < strlen($string); $x++) { |
| 105 | $js_encode .= '%' . bin2hex($string[$x]); |
| 106 | } |
| 107 | |
| 108 | return '<script type="text/javascript" language="javascript">eval(unescape(\''.$js_encode.'\'))</script>'; |
| 109 | |
| 110 | } elseif ($encode == 'hex') { |
| 111 | |
| 112 | preg_match('!^(.*)(\?.*)$!',$address,$match); |
| 113 | if(!empty($match[2])) { |
| 114 | $smarty->trigger_error("mailto: hex encoding does not work with extra attributes. Try javascript."); |
| 115 | return; |
| 116 | } |
| 117 | for ($x=0; $x < strlen($address); $x++) { |
| 118 | if(preg_match('!\w!',$address[$x])) { |
| 119 | $address_encode .= '%' . bin2hex($address[$x]); |
| 120 | } else { |
| 121 | $address_encode .= $address[$x]; |
| 122 | } |
| 123 | } |
| 124 | for ($x=0; $x < strlen($text); $x++) { |
| 125 | $text_encode .= '&#x' . bin2hex($text[$x]).';'; |
| 126 | } |
| 127 | |
| 128 | return '<a href="mailto:'.$address_encode.'" '.$extra.'>'.$text_encode.'</a>'; |
| 129 | |
| 130 | } else { |
| 131 | // no encoding |
| 132 | return '<a href="mailto:'.$address.'" '.$extra.'>'.$text.'</a>'; |
| 133 | |
| 134 | } |
| 135 | |
| 136 | } |
| 137 | |
| 138 | /* vim: set expandtab: */ |
| 139 | |
| 140 | ?> |