6  * @subpackage PluginsFunction
 
  10  * Smarty {mailto} function plugin
 
  15  * Purpose:  automate mailto address link creation, and optionally
 
  20  * {mailto address="me@domain.com"}
 
  21  * {mailto address="me@domain.com" encode="javascript"}
 
  22  * {mailto address="me@domain.com" encode="hex"}
 
  23  * {mailto address="me@domain.com" subject="Hello to you!"}
 
  24  * {mailto address="me@domain.com" cc="you@domain.com,they@domain.com"}
 
  25  * {mailto address="me@domain.com" extra='class="mailto"'}
 
  28  * @link http://smarty.php.net/manual/en/language.function.mailto.php {mailto}
 
  29  *          (Smarty online manual)
 
  31  * @author Monte Ohrt <monte at ohrt dot com> 
 
  32  * @author credits to Jason Sweat (added cc, bcc and subject functionality) 
 
  33  * @param array $params parameters
 
  35  *          - address = e-mail address
 
  36  *          - text = (optional) text to display, default is address
 
  37  *          - encode = (optional) can be one of:
 
  38  *                 * none : no encoding (default)
 
  39  *                 * javascript : encode with javascript
 
  40  *                 * javascript_charcode : encode with javascript charcode
 
  41  *                 * hex : encode with hexidecimal (no javascript)
 
  42  *          - cc = (optional) address(es) to carbon copy
 
  43  *          - bcc = (optional) address(es) to blind carbon copy
 
  44  *          - subject = (optional) e-mail subject
 
  45  *          - newsgroups = (optional) newsgroup(s) to post to
 
  46  *          - followupto = (optional) address(es) to follow up to
 
  47  *          - extra = (optional) extra tags for the href link
 
  48  * @param object $template template object
 
  51 function smarty_function_mailto($params, $template)
 
  55     if (empty($params['address'])) {
 
  56         trigger_error("mailto: missing 'address' parameter",E_USER_WARNING);
 
  59         $address = $params['address'];
 
  63     // netscape and mozilla do not decode %40 (@) in BCC field (bug?)
 
  64     // so, don't encode it.
 
  65     $search = array('%40', '%2C');
 
  66     $replace = array('@', ',');
 
  67     $mail_parms = array();
 
  68     foreach ($params as $var => $value) {
 
  74                     $mail_parms[] = $var . '=' . str_replace($search, $replace, rawurlencode($value));
 
  79                 $mail_parms[] = $var . '=' . rawurlencode($value);
 
  91     for ($i = 0; $i < count($mail_parms); $i++) {
 
  92         $mail_parm_vals .= (0 == $i) ? '?' : '&';
 
  93         $mail_parm_vals .= $mail_parms[$i];
 
  95     $address .= $mail_parm_vals;
 
  97     $encode = (empty($params['encode'])) ? 'none' : $params['encode'];
 
  98     if (!in_array($encode, array('javascript', 'javascript_charcode', 'hex', 'none'))) {
 
  99         trigger_error("mailto: 'encode' parameter must be none, javascript or hex",E_USER_WARNING);
 
 103     if ($encode == 'javascript') {
 
 104         $string = 'document.write(\'<a href="mailto:' . $address . '" ' . $extra . '>' . $text . '</a>\');';
 
 107         for ($x = 0; $x < strlen($string); $x++) {
 
 108             $js_encode .= '%' . bin2hex($string[$x]);
 
 111         return '<script type="text/javascript">eval(unescape(\'' . $js_encode . '\'))</script>';
 
 112     } elseif ($encode == 'javascript_charcode') {
 
 113         $string = '<a href="mailto:' . $address . '" ' . $extra . '>' . $text . '</a>';
 
 115         for($x = 0, $y = strlen($string); $x < $y; $x++) {
 
 116             $ord[] = ord($string[$x]);
 
 119         $_ret = "<script type=\"text/javascript\" language=\"javascript\">\n";
 
 121         $_ret .= "{document.write(String.fromCharCode(";
 
 122         $_ret .= implode(',', $ord);
 
 126         $_ret .= "</script>\n";
 
 129     } elseif ($encode == 'hex') {
 
 130         preg_match('!^(.*)(\?.*)$!', $address, $match);
 
 131         if (!empty($match[2])) {
 
 132             trigger_error("mailto: hex encoding does not work with extra attributes. Try javascript.",E_USER_WARNING);
 
 135         $address_encode = '';
 
 136         for ($x = 0; $x < strlen($address); $x++) {
 
 137             if (preg_match('!\w!', $address[$x])) {
 
 138                 $address_encode .= '%' . bin2hex($address[$x]);
 
 140                 $address_encode .= $address[$x];
 
 144         for ($x = 0; $x < strlen($text); $x++) {
 
 145             $text_encode .= '&#x' . bin2hex($text[$x]) . ';';
 
 148         $mailto = "mailto:";
 
 149         return '<a href="' . $mailto . $address_encode . '" ' . $extra . '>' . $text_encode . '</a>';
 
 152         return '<a href="mailto:' . $address . '" ' . $extra . '>' . $text . '</a>';