6 * The idea is to inlcude here some functions to make easier
7 * the right to left implementation by "functionize" some
10 * @copyright © 1999-2007 The SquirrelMail Project Team
11 * @license http://opensource.org/licenses/gpl-license.php GNU Public License
13 * @package squirrelmail
19 * Generates a hyperlink
21 * @param string $uri The target link location
22 * @param string $text The link text
23 * @param string $target The location where the link should
24 * be opened (OPTIONAL; default not used)
25 * @param string $onclick The onClick JavaScript handler (OPTIONAL;
27 * @param string $class The CSS class name (OPTIONAL; default
29 * @param string $id The ID name (OPTIONAL; default not used)
30 * @param string $name The anchor name (OPTIONAL; default not used)
31 * @param array $aAttribs Any extra attributes: this must be an
32 * associative array, where keys will be
33 * added as the attribute name, and values
34 * (which are optional - should be null if
35 * none should be used) will be placed in
36 * double quotes (pending template implementation)
37 * as the attribute value (OPTIONAL; default empty).
39 * @return string The desired hyperlink tag.
44 function create_hyperlink($uri, $text, $target='', $onclick='',
45 $class='', $id='', $name='', $aAttribs=array()) {
49 $oTemplate->assign('uri', $uri);
50 $oTemplate->assign('text', $text);
51 $oTemplate->assign('target', $target);
52 $oTemplate->assign('onclick', $onclick);
53 $oTemplate->assign('class', $class);
54 $oTemplate->assign('id', $id);
55 $oTemplate->assign('name', $name);
57 $oTemplate->assign('aAttribs', $aAttribs);
59 return $oTemplate->fetch('hyperlink.tpl');
65 * Generates an image tag
67 * @param string $src The image source path
68 * @param string $alt Alternate link text (OPTIONAL; default
70 * @param string $width The width the image should be shown in
71 * (OPTIONAL; default not used)
72 * @param string $height The height the image should be shown in
73 * (OPTIONAL; default not used)
74 * @param string $border The image's border attribute value
75 * (OPTIONAL; default not used)
76 * @param string $class The CSS class name (OPTIONAL; default
78 * @param string $id The ID name (OPTIONAL; default not used)
79 * @param string $onclick The onClick JavaScript handler (OPTIONAL;
81 * @param string $title The image's title attribute value
82 * (OPTIONAL; default not used)
83 * @param string $align The image's alignment attribute value
84 * (OPTIONAL; default not used)
85 * @param string $hspace The image's hspace attribute value
86 * (OPTIONAL; default not used)
87 * @param string $vspace The image's vspace attribute value
88 * (OPTIONAL; default not used)
89 * @param string $text_alternative A text replacement for the entire
90 * image tag, to be used at the
91 * discretion of the template set,
92 * if for some reason the image tag
93 * cannot or should not be produced
94 * (OPTIONAL; default not used)
95 * @param array $aAttribs Any extra attributes: this must be an
96 * associative array, where keys will be
97 * added as the attribute name, and values
98 * (which are optional - should be null if
99 * none should be used) will be placed in
100 * double quotes (pending template implementation)
101 * as the attribute value (OPTIONAL; default empty).
103 * @return string The desired hyperlink tag.
108 function create_image($src, $alt='', $width='', $height='',
109 $border='', $class='', $id='', $onclick='',
110 $title='', $align='', $hspace='', $vspace='',
111 $text_alternative='', $aAttribs=array()) {
115 $oTemplate->assign('src', $src);
116 $oTemplate->assign('alt', $alt);
117 $oTemplate->assign('width', $width);
118 $oTemplate->assign('height', $height);
119 $oTemplate->assign('border', $border);
120 $oTemplate->assign('class', $class);
121 $oTemplate->assign('id', $id);
122 $oTemplate->assign('onclick', $onclick);
123 $oTemplate->assign('title', $title);
124 $oTemplate->assign('align', $align);
125 $oTemplate->assign('hspace', $hspace);
126 $oTemplate->assign('vspace', $vspace);
127 $oTemplate->assign('text_alternative', $text_alternative);
129 $oTemplate->assign('aAttribs', $aAttribs);
131 return $oTemplate->fetch('image.tpl');
137 * Generates a label tag
139 * @param string $value The contents that belong inside the label
140 * @param string $for The ID to which the label applies (OPTIONAL;
142 * @param array $aAttribs Any extra attributes: this must be an
143 * associative array, where keys will be
144 * added as the attribute name, and values
145 * (which are optional - should be null if
146 * none should be used) will be placed in
147 * double quotes (pending template implementation)
148 * as the attribute value (OPTIONAL; default empty).
150 * @return string The desired label tag.
155 function create_label($value, $for='', $aAttribs=array()) {
159 $oTemplate->assign('text', $value);
160 $oTemplate->assign('for', $for);
162 $oTemplate->assign('aAttribs', $aAttribs);
164 return $oTemplate->fetch('label.tpl');
170 * Generates a span tag
172 * @param string $value The contents that belong inside the span
173 * @param string $class The CSS class name (OPTIONAL; default
175 * @param string $id The ID name (OPTIONAL; default not used)
176 * @param array $aAttribs Any extra attributes: this must be an
177 * associative array, where keys will be
178 * added as the attribute name, and values
179 * (which are optional - should be null if
180 * none should be used) will be placed in
181 * double quotes (pending template implementation)
182 * as the attribute value (OPTIONAL; default empty).
184 * @return string The desired span tag.
189 function create_span($value, $class='', $id='', $aAttribs=array()) {
193 $oTemplate->assign('value', $value);
194 $oTemplate->assign('class', $class);
195 $oTemplate->assign('id', $id);
197 $oTemplate->assign('aAttribs', $aAttribs);
199 return $oTemplate->fetch('span.tpl');
205 * Generates an opening body tag
207 * @param string $onload Body onload JavaScript handler code
208 * (OPTIONAL; default not used)
209 * @param string $class The CSS class name (OPTIONAL; default
211 * @param array $aAttribs Any extra attributes: this must be an
212 * associative array, where keys will be
213 * added as the attribute name, and values
214 * (which are optional - should be null if
215 * none should be used) will be placed in
216 * double quotes (pending template implementation)
217 * as the attribute value (OPTIONAL; default empty).
219 * @return string The desired body tag.
224 function create_body($onload='', $class='', $aAttribs=array()) {
228 $oTemplate->assign('onload', $onload);
229 $oTemplate->assign('class', $class);
231 $oTemplate->assign('aAttribs', $aAttribs);
233 return $oTemplate->fetch('body.tpl');
239 * Generates html tags
240 //FIXME: This should not be used anywhere in the core, or we should convert this to use templates. We sould not be assuming HTML output.
242 * @param string $tag Tag to output
243 * @param string $val Value between tags
244 * @param string $align Alignment (left, center, etc)
245 * @param string $bgcolor Back color in hexadecimal
246 * @param string $xtra Extra options
247 * @return string HTML ready for output
250 function html_tag( $tag, // Tag to output
251 $val = '', // Value between tags
252 $align = '', // Alignment
253 $bgcolor = '', // Back color
254 $xtra = '' ) { // Extra options
256 GLOBAL $languages, $squirrelmail_language;
258 $align = strtolower( $align );
260 $tag = strtolower( $tag );
262 if ( isset( $languages[$squirrelmail_language]['DIR']) ) {
263 $dir = $languages[$squirrelmail_language]['DIR'];
268 if ( $dir == 'ltr' ) {
276 if ( $bgcolor <> '' ) {
277 $bgc = " bgcolor=\"$bgcolor\"";
285 $alg = " align=\"$rgt\"";
288 $alg = " align=\"$lft\"";
291 $alg = " align=\"$align\"";
297 if ( $dir <> 'ltr' ) {
298 $ret .= " dir=\"$dir\"";
307 $ret .= ">$val</$tag>\n";
317 * This function is used to add, modify or delete GET variables in a URL.
318 * It is especially useful when $url = $PHP_SELF
320 * Set $val to NULL to remove $var from $url.
321 * To ensure compatibility with older versions, use $val='0' to set $var to 0.
323 * @param string $url url that must be modified
324 * @param string $var GET variable name
325 * @param string $val variable value
326 * @param boolean $link controls sanitizing of ampersand in urls (since 1.3.2)
328 * @return string $url modified url
333 function set_url_var($url, $var, $val=null, $link=true) {
334 $url = str_replace('&','&',$url);
336 if (strpos($url, '?') === false) {
340 list($uri, $params) = explode('?', $url, 2);
343 $params = explode('&', $params);
345 foreach ($params as $p) {
347 $p = explode('=', $p);
348 $newpar[$p[0]] = (isset($p[1]) ?
$p[1] : '');
353 unset($newpar[$var]);
355 $newpar[$var] = $val;
358 if (!count($newpar)) {
363 foreach ($newpar as $name => $value) {
364 $url .= "$name=$value&";
367 $url = substr($url, 0, -1);
369 $url = str_replace('&','&',$url);