1 | <?php |
---|
2 | /** |
---|
3 | * Smarty plugin |
---|
4 | * |
---|
5 | * @package Smarty |
---|
6 | * @subpackage PluginsFunction |
---|
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 encode them.<br> |
---|
16 | * Params: |
---|
17 | * <pre> |
---|
18 | * - address - (required) - 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 | * * javascript_charcode : encode with javascript charcode |
---|
24 | * * hex : encode with hexidecimal (no javascript) |
---|
25 | * - cc - (optional) - address(es) to carbon copy |
---|
26 | * - bcc - (optional) - address(es) to blind carbon copy |
---|
27 | * - subject - (optional) - e-mail subject |
---|
28 | * - newsgroups - (optional) - newsgroup(s) to post to |
---|
29 | * - followupto - (optional) - address(es) to follow up to |
---|
30 | * - extra - (optional) - extra tags for the href link |
---|
31 | * </pre> |
---|
32 | * Examples: |
---|
33 | * <pre> |
---|
34 | * {mailto address="me@domain.com"} |
---|
35 | * {mailto address="me@domain.com" encode="javascript"} |
---|
36 | * {mailto address="me@domain.com" encode="hex"} |
---|
37 | * {mailto address="me@domain.com" subject="Hello to you!"} |
---|
38 | * {mailto address="me@domain.com" cc="you@domain.com,they@domain.com"} |
---|
39 | * {mailto address="me@domain.com" extra='class="mailto"'} |
---|
40 | * </pre> |
---|
41 | * |
---|
42 | * @link http://www.smarty.net/manual/en/language.function.mailto.php {mailto} |
---|
43 | * (Smarty online manual) |
---|
44 | * @version 1.2 |
---|
45 | * @author Monte Ohrt <monte at ohrt dot com> |
---|
46 | * @author credits to Jason Sweat (added cc, bcc and subject functionality) |
---|
47 | * @param array $params parameters |
---|
48 | * @param Smarty_Internal_Template $template template object |
---|
49 | * @return string |
---|
50 | */ |
---|
51 | function smarty_function_mailto($params, $template) |
---|
52 | { |
---|
53 | static $_allowed_encoding = array('javascript' => true, 'javascript_charcode' => true, 'hex' => true, 'none' => true); |
---|
54 | $extra = ''; |
---|
55 | |
---|
56 | if (empty($params['address'])) { |
---|
57 | trigger_error("mailto: missing 'address' parameter",E_USER_WARNING); |
---|
58 | return; |
---|
59 | } else { |
---|
60 | $address = $params['address']; |
---|
61 | } |
---|
62 | |
---|
63 | $text = $address; |
---|
64 | // netscape and mozilla do not decode %40 (@) in BCC field (bug?) |
---|
65 | // so, don't encode it. |
---|
66 | $search = array('%40', '%2C'); |
---|
67 | $replace = array('@', ','); |
---|
68 | $mail_parms = array(); |
---|
69 | foreach ($params as $var => $value) { |
---|
70 | switch ($var) { |
---|
71 | case 'cc': |
---|
72 | case 'bcc': |
---|
73 | case 'followupto': |
---|
74 | if (!empty($value)) |
---|
75 | $mail_parms[] = $var . '=' . str_replace($search, $replace, rawurlencode($value)); |
---|
76 | break; |
---|
77 | |
---|
78 | case 'subject': |
---|
79 | case 'newsgroups': |
---|
80 | $mail_parms[] = $var . '=' . rawurlencode($value); |
---|
81 | break; |
---|
82 | |
---|
83 | case 'extra': |
---|
84 | case 'text': |
---|
85 | $$var = $value; |
---|
86 | |
---|
87 | default: |
---|
88 | } |
---|
89 | } |
---|
90 | |
---|
91 | if ($mail_parms) { |
---|
92 | $address .= '?' . join('&', $mail_parms); |
---|
93 | } |
---|
94 | |
---|
95 | $encode = (empty($params['encode'])) ? 'none' : $params['encode']; |
---|
96 | if (!isset($_allowed_encoding[$encode])) { |
---|
97 | trigger_error("mailto: 'encode' parameter must be none, javascript, javascript_charcode or hex", E_USER_WARNING); |
---|
98 | return; |
---|
99 | } |
---|
100 | // FIXME: (rodneyrehm) document.write() excues me what? 1998 has passed! |
---|
101 | if ($encode == 'javascript') { |
---|
102 | $string = 'document.write(\'<a href="mailto:' . $address . '" ' . $extra . '>' . $text . '</a>\');'; |
---|
103 | |
---|
104 | $js_encode = ''; |
---|
105 | for ($x = 0, $_length = strlen($string); $x < $_length; $x++) { |
---|
106 | $js_encode .= '%' . bin2hex($string[$x]); |
---|
107 | } |
---|
108 | |
---|
109 | return '<script type="text/javascript">eval(unescape(\'' . $js_encode . '\'))</script>'; |
---|
110 | } elseif ($encode == 'javascript_charcode') { |
---|
111 | $string = '<a href="mailto:' . $address . '" ' . $extra . '>' . $text . '</a>'; |
---|
112 | |
---|
113 | for($x = 0, $y = strlen($string); $x < $y; $x++) { |
---|
114 | $ord[] = ord($string[$x]); |
---|
115 | } |
---|
116 | |
---|
117 | $_ret = "<script type=\"text/javascript\" language=\"javascript\">\n" |
---|
118 | . "{document.write(String.fromCharCode(" |
---|
119 | . implode(',', $ord) |
---|
120 | . "))" |
---|
121 | . "}\n" |
---|
122 | . "</script>\n"; |
---|
123 | |
---|
124 | return $_ret; |
---|
125 | } elseif ($encode == 'hex') { |
---|
126 | preg_match('!^(.*)(\?.*)$!', $address, $match); |
---|
127 | if (!empty($match[2])) { |
---|
128 | trigger_error("mailto: hex encoding does not work with extra attributes. Try javascript.",E_USER_WARNING); |
---|
129 | return; |
---|
130 | } |
---|
131 | $address_encode = ''; |
---|
132 | for ($x = 0, $_length = strlen($address); $x < $_length; $x++) { |
---|
133 | if (preg_match('!\w!' . Smarty::$_UTF8_MODIFIER, $address[$x])) { |
---|
134 | $address_encode .= '%' . bin2hex($address[$x]); |
---|
135 | } else { |
---|
136 | $address_encode .= $address[$x]; |
---|
137 | } |
---|
138 | } |
---|
139 | $text_encode = ''; |
---|
140 | for ($x = 0, $_length = strlen($text); $x < $_length; $x++) { |
---|
141 | $text_encode .= '&#x' . bin2hex($text[$x]) . ';'; |
---|
142 | } |
---|
143 | |
---|
144 | $mailto = "mailto:"; |
---|
145 | return '<a href="' . $mailto . $address_encode . '" ' . $extra . '>' . $text_encode . '</a>'; |
---|
146 | } else { |
---|
147 | // no encoding |
---|
148 | return '<a href="mailto:' . $address . '" ' . $extra . '>' . $text . '</a>'; |
---|
149 | } |
---|
150 | } |
---|
151 | |
---|
152 | ?> |
---|