html.php File Reference

Go to the source code of this file.

Functions
	html_show_displayoptions ($content, $form_opening=0, $submit=0)
	html_show_boxoptions ($legend, $content, $form_opening=0, $submit=0)
	html_splitpage ($how)
	html_nextprev ($search_url, $rows, $rows_returned)
	html_anchor ($content, $name)
	html_feedback_top ()
	html_feedback_bottom ()
	html_image ($src, $args, $display=1)
	html_build_select_box_from_array ($vals, $select_name, $checked_val='xzxz', $samevals=0)
	html_build_select_box_from_arrays ($vals, $texts, $select_name, $checked_val='xzxz',#4 $show_100=true, $text_100='None',#6 $show_any=false, $text_any='Any',#8 $show_unknown=false)
	html_select_permission_box ($artifact, $row, $level="member")
	html_select_restriction_box ($artifact, $row, $level="group", $notd=0, $event=1)
	html_select_typedir_box ($input_name, $current_value)
	html_select_theme_box ($input_name="user_theme", $current=0)
	html_build_priority_select_box ($name='priority', $checked_val='5')
	html_buildpriority_select_box ($name='priority', $checked_val='5')
	html_build_checkboxarray ($options, $name, $checked_array)
	html_buildcheckboxarray ($options, $name, $checked_array)
	html_build_checkbox ($name, $is_checked=0)
	html_header ($params)
	html_footer ($params)
	site_header ($params)
	site_footer ($params)
	site_project_header ($params)
Variables
	$return = (' />')

---

Function Documentation

html_anchor (  $  content, $  name )

Definition at line 137 of file html.php. References $content, and $name. { if (!$name) { $name = $content; }; return '<a name="'.$name.'" href="#'.$name.'">'.$content.'</a>'; }

html_build_checkbox (  $  name, $  is_checked = 0 )

Definition at line 815 of file html.php. References print. Referenced by specific_line(). { print '<input type="checkbox" name="'.$name.'" value="1"'; if ($is_checked) { print ' checked="checked"'; } print ' />'; }

html_build_checkboxarray (  $  options, $  name, $  checked_array )

Definition at line 789 of file html.php. References $i, and print. Referenced by html_buildcheckboxarray(). { $option_count=count($options); $checked_count=count($checked_array); for ($i=1; $i<=$option_count; $i++) { print ' <br><input type="checkbox" name="'.$name.'" value="'.$i.'"'; for ($j=0; $j<$checked_count; $j++) { if ($i == $checked_array[$j]) { print ' checked="checked"'; } } print ' /> '.$options[$i]; } }

html_build_priority_select_box (  $  name = 'priority', $  checked_val = '5' )

Definition at line 753 of file html.php. References print. Referenced by html_buildpriority_select_box(). { /* Return a select box of standard priorities. The name of this select box is optional and so is the default checked value */ ?> <SELECT NAME="<?php print $name; ?>"> <option value="1"<?php if ($checked_val=="1") {print " selected=\"selected\"";} ?>>1 - Lowest</option> <option value="2"<?php if ($checked_val=="2") {print " selected=\"selected\"";} ?>>2</option> <option value="3"<?php if ($checked_val=="3") {print " selected=\"selected\"";} ?>>3</option> <option value="4"<?php if ($checked_val=="4") {print " selected=\"selected\"";} ?>>4</option> <option value="5"<?php if ($checked_val=="5") {print " selected=\"selected\"";} ?>>5 - Medium</option> <option value="6"<?php if ($checked_val=="6") {print " selected=\"selected\"";} ?>>6</option> <option value="7"<?php if ($checked_val=="7") {print " selected=\"selected\"";} ?>>7</option> <option value="8"<?php if ($checked_val=="8") {print " selected=\"selected\"";} ?>>8</option> <option value="9"<?php if ($checked_val=="9") {print " selected=\"selected\"";} ?>>9 - Highest</option> </SELECT> <?php }

html_build_select_box_from_array (  $  vals, $  select_name, $  checked_val = 'xzxz', $  samevals = 0 )

Definition at line 310 of file html.php. References $i, $return, $rows, and selected. { /* Takes one array, with the first array being the "id" or value and the array being the text you want displayed The second parameter is the name you want assigned to this form element The third parameter is optional. Pass the value of the item that should be checked */ $return .= ' <select name="'.$select_name.'">'; $rows=count($vals); for ($i=0; $i<$rows; $i++) { if ($samevals) { $return .= "\n\t\t<option value=\"" . $vals[$i] . "\""; if ($vals[$i] == $checked_val) { $return .= ' selected="selected"'; } } else { $return .= "\n\t\t<option value=\"" . $i .'"'; if ($i == $checked_val) { $return .= ' selected="selected"'; } } $return .= '>'.$vals[$i].'</option>'; } $return .= ' </select>'; return $return; }

html_build_select_box_from_arrays (  $  vals, $  texts, $  select_name, $  checked_val = 'xzxz', #4 $  show_100 = true, $  text_100 = 'None', #6 $  show_any = false, $  text_any = 'Any', #8 $  show_unknown = false )

Definition at line 352 of file html.php. References $i, $return, $rows, and selected. Referenced by calendar_selectbox(), and conf_form(). { /* The infamous '100 row' has to do with the SQL Table joins done throughout all this code. There must be a related row in users, categories, etc, and by default that row is 100, so almost every pop-up box has 100 as the default Most tables in the database should therefore have a row with an id of 100 in it so that joins are successful There is now another infamous row called the Any row. It is not in any table as opposed to 100. it's just here as a convenience mostly when using select boxes in queries (bug, task,...). The 0 value is reserved for Any and must not be used in any table. Params: Takes two arrays, with the first array being the "id" or value and the other array being the text you want displayed The third parameter is the name you want assigned to this form element The fourth parameter is optional. Pass the value of the item that should be checked The fifth parameter is an optional boolean - whether or not to show the '100 row' The sixth parameter is optional - what to call the '100 row' defaults to none The 7th parameter is an optional boolean - whether or not to show the 'Any row' The 8th parameter is optional - what to call the 'Any row' defaults to nAny */ $return .= ' <select name="'.$select_name.'">'; # We want the "Default" on item initial post, only at this momement if ($show_unknown) { $return .= "\n<option value=\"!unknown!\">"._("Unknown")."</option>"; } #we don't always want the default any row shown if ($show_any) { $selected = ( $checked_val == 0 ? 'selected="selected"':''); $return .= "\n<option value=\"0\" $selected>$text_any </option>"; } #we don't always want the default 100 row shown if ($show_100) { $selected = ( $checked_val == 100 ? 'selected="selected"':''); $return .= "\n<option value=\"100\" $selected>$text_100 </option>"; } $rows=count($vals); if (count($texts) != $rows) { $return .= 'ERROR - uneven row counts'; } for ($i=0; $i<$rows; $i++) { # uggh - sorry - don't show the 100 row and Any row # if it was shown above, otherwise do show it if ((($vals[$i] != '100') && ($vals[$i] != '0')) || ($vals[$i] == '100' && !$show_100) || ($vals[$i] == '0' && !$show_any)) { $return .= ' <option value="'.$vals[$i].'"'; if ($vals[$i] == $checked_val) { $return .= ' selected="selected"'; } $return .= '>'.$texts[$i].'</option>'; } } $return .= ' </select>'; return $return; } function html_build_select_box ($result, $name, $checked_val="xzxz",$show_100=true,$text_100='None',$show_any=false,$text_any='Any',$show_unknown=false) { /* Takes a result set, with the first column being the "id" or value and the second column being the text you want displayed The second parameter is the name you want assigned to this form element The third parameter is optional. Pass the value of the item that should be checked The fourth parameter is an optional boolean - whether or not to show the '100 row' The fifth parameter is optional - what to call the '100 row' defaults to none */ return html_build_select_box_from_arrays (utils_result_column_to_array($result,0),utils_result_column_to_array($result,1),$name,$checked_val,$show_100,$text_100,$show_any,$text_any,$show_unknown); } function html_build_multiple_select_box ($result,$name,$checked_array,$size='8',$show_100=true,$text_100='None', $show_any=false,$text_any='Any',$show_value=true) { /* Takes a result set, with the first column being the "id" or value and the second column being the text you want displayed The second parameter is the name you want assigned to this form element The third parameter is an array of checked values; The fourth parameter is optional. Pass the size of this box Fifth to eigth params determine whether to show None and Any Ninth param determine whether to show numeric values next to the menu label (default true for backward compatibility */ $checked_count=count($checked_array); # print '-- '.$checked_count.' --'; $return .= ' <SELECT NAME="'.$name.'" MULTIPLE SIZE="'.$size.'">'; /* Put in the Any box */ if ($show_any) { $return .= ' <option value="0"'; for ($j=0; $j<$checked_count; $j++) { if ($checked_array[$j] == '0') { $return .= ' selected="selected"'; } } $return .= '>'.$text_any.'</option>'; } /* Put in the default NONE box */ if ($show_100) { $return .= ' <option value="100"'; for ($j=0; $j<$checked_count; $j++) { if ($checked_array[$j] == '100') { $return .= ' selected="selected"'; } } $return .= '>'.$text_100.'</option>'; } $rows=db_numrows($result); for ($i=0; $i<$rows; $i++) { if (db_result($result,$i,0) != '100') { $return .= ' <option value="'.db_result($result,$i,0).'"'; /* Determine if it's checked */ $val=db_result($result,$i,0); for ($j=0; $j<$checked_count; $j++) { if ($val == $checked_array[$j]) { $return .= ' selected="selected"'; } } $return .= '>'. ($show_value?$val.'-':''). substr(db_result($result,$i,1),0,35). '</option>'; } }

html_buildcheckboxarray (  $  options, $  name, $  checked_array )

Definition at line 809 of file html.php. References html_build_checkboxarray(). { #deprecated return html_build_checkboxarray($options,$name,$checked_array); }

html_buildpriority_select_box (  $  name = 'priority', $  checked_val = '5' )

Definition at line 783 of file html.php. References html_build_priority_select_box(). { return html_build_priority_select_box($name, $checked_val); }

html_feedback_bottom (   )

Do as the feeback on the top of the page Definition at line 195 of file html.php. References html_feedback_top(). Referenced by html_footer(). { html_feedback_top(); }

html_feedback_top (   )

Print out the feedback Definition at line 146 of file html.php. References $GLOBALS, Error, and print. Referenced by exit_error(), html_feedback_bottom(), and html_header(). { # By default, escape the html special chars, unless feedback_html was # set in the code to allow an htmlized feedback (that should happen on rare # occasions) if (!$GLOBALS[feedback_html]) { $GLOBALS[feedback] = htmlspecialchars($GLOBALS[feedback]); $GLOBALS[ffeedback] = htmlspecialchars($GLOBALS[ffeedback]); } $script_hide = 'onclick="document.getElementById(\'feedback\').style.visibility=\'hidden\'; document.getElementById(\'feedbackback\').style.visibility=\'visible\';"'; $script_show = 'onclick="document.getElementById(\'feedback\').style.visibility=\'visible\'; document.getElementById(\'feedbackback\').style.visibility=\'hidden\';"'; # Button to get back hidden feedback, hidden by default print '<div '.$script_show.' id="feedbackback" class="feedbackback">'._("Show feedback again").'</div>'; # Only success if ($GLOBALS[feedback] && !$GLOBALS[ffeedback]) { print '<div id="feedback" class="feedback" '.$script_hide.'><span class="feedbacktitle"><img src="'.$GLOBALS['sys_home'].'images/'.SV_THEME.'.theme/ok.png" class="feedbackimage" alt="'._("Success").'" /> '._("Success:").'</span> '.$GLOBALS[feedback].'</div>'; } # Only errors if ($GLOBALS[ffeedback] && !$GLOBALS[feedback]) { print '<div id="feedback" class="feedbackerror" '.$script_hide.'><span class="feedbackerrortitle"><img src="'.$GLOBALS['sys_home'].'images/'.SV_THEME.'.theme/wrong.png" class="feedbackimage" alt="'._("Error").'" /> '._("Error:").'</span>'.$GLOBALS[ffeedback].'</div>'; } # Errors and success if ($GLOBALS[ffeedback] && $GLOBALS[feedback]) { print '<div id="feedback" class="feedbackerrorandsuccess" '.$script_hide.'><span class="feedbackerrorandsuccesstitle"><img src="'.$GLOBALS['sys_home'].'images/'.SV_THEME.'.theme/wrong.png" class="feedbackimage" alt="'._("Some Errors").'" /> '._("Some Errors:").'</span>'.$GLOBALS[feedback].' '.$GLOBALS[ffeedback].'</div>'; } if ($GLOBALS[sys_debug_on] && $GLOBALS[debug]) { print '<div class="debug">DEBUG information: '.$GLOBALS[debug].'</div>'; } # We unset feedback so there will be a bottom feedback only if something # changed. It may confuse users, however I would find more confusing to # have two lookalike feedback information providing most of the time the # same information AND (that is the problem) sometimes more information # in the second one. unset($GLOBALS[feedback],$GLOBALS[ffeedback],$GLOBALS[debug]); }

html_footer (  $  params  )

Definition at line 834 of file html.php. References html_feedback_bottom(), and print. Referenced by site_footer(). { global $HTML; print html_feedback_bottom($GLOBALS['feedback']); $HTML->footer($params); }

html_header (  $  params  )

Catch all header functions Definition at line 826 of file html.php. References html_feedback_top(), and print. Referenced by site_header(), and site_project_header(). { global $HTML; print $HTML->header($params); print html_feedback_top($GLOBALS['feedback']); print $HTML->tabs($params); }

html_image (  $  src, $  args, $  display = 1 )

Definition at line 202 of file html.php. References $return, and SV_THEME. Referenced by menu_print_sidebar(). { GLOBAL $img_attr; $return = ('<img src="'.$GLOBALS['sys_home'].'images/'.SV_THEME.'.theme/'.$src.'"'); reset($args); while(list($k,$v) = each($args)) { $return .= ' '.$k.'="'.$v.'"'; } # ## insert a border tag if there isn't one if (!$args['border']) $return .= (' border="0"'); # ## if no height AND no width tag, insert em both if (!$args['height'] && !$args['width']) { #Check to see if we've already fetched the image data if(!$img_attr[$src] && is_file($GLOBALS['sys_www_topdir'].'/images/'.SV_THEME.'.theme/'.$src)) { list($width, $height, $type, $img_attr[$src]) = @getimagesize($GLOBALS['sys_www_topdir'].'/images/'.SV_THEME.'.theme/'.$src); } else { if (is_file($GLOBALS['sys_www_topdir'].'/images/'.SV_THEME.'.theme/'.$src)) { list($width, $height, $type, $img_attr[$src]) = @getimagesize($GLOBALS['sys_www_topdir'].'/images/'.SV_THEME.'.theme/'.$src); } } $return .= ' ' . $img_attr[$src]; }

html_nextprev (  $  search_url, $  rows, $  rows_returned )

Definition at line 102 of file html.php. References print. { global $offset, $max_rows; if (($rows_returned > $rows) || ($offset != 0)) { print "\n<br /><h5 class=\"nextprev\">\n"; if ($offset != 0) { print '<a href="'.$search_url.'&amp;offset='.($offset-$rows).'&amp;max_rows='.$max_rows.'#results">'; print '<img src="'.$GLOBALS['sys_home'].'images/'.SV_THEME.'.theme/previous.png" border="0" alt="'._("Previous Results").'" />'._("Previous Results").'</a>'; } else { print '<img src="'.$GLOBALS['sys_home'].'images/'.SV_THEME.'.theme/previousgrey.png" border="0" alt="'._("Previous Results").'" /><em>'._("Previous Results").'</em>'; } print "&nbsp; &nbsp; &nbsp;"; if ($rows_returned > $rows) { print '<a href="'.$search_url.'&amp;offset='.($offset+$rows).'&amp;max_rows='.$max_rows.'#results">'; print _("Next Results").' <img src="'.$GLOBALS['sys_home'].'images/'.SV_THEME.'.theme/next.png" border="0" alt="'._("Next Results").'" /></a>'; } else { print '<em>'._("Next Results").'</em> <img src="'.$GLOBALS['sys_home'].'images/'.SV_THEME.'.theme/nextgrey.png" border="0" alt="'._("Next Results").'" />'; } print "</h5>\n"; } }

html_select_permission_box (  $  artifact, $  row, $  level = "member" )

Definition at line 553 of file html.php. References $row, $value, group_id, and print. { # If $row['user_id'] does not exists, we havent got a row but simple value # and it means that we are about to modify per group default if ($level == "type") { $value = $row; $default = 0; } elseif ($level == "group") { $value = $row; $default = _("Group Type Default"); } else { $num = $row['user_id']; $value = $row[$artifact.'_flags']; $default = _("Group Default"); } print ' <td align="center"> <select name="'.$artifact.'_user_'.$num.'">'; if ($default) { print ' <option value="NULL"'.((!$value)?" selected=\"selected\"":"").'>'.$default.'</option>'; } print ' <option value="9"'.(($value == 9)?" selected=\"selected\"":"").'>'._("None").'</option>'; if ($artifact != "news") { print ' <option value="1"'.(($value == 1)?" selected=\"selected\"":"").'>'._("Technician").'</option>'; } print ' <option value="3"'.(($value == 3)?" selected=\"selected\"":"").'>'._("Manager").'</option>'; if ($artifact != "news") { print ' <option value="2"'.(($value == 2)?" selected=\"selected\"":"").'>'._("Techn. & Manager").'</option>'; } print ' </select>'; if (!$value && $level == "group") { $value = group_gettypepermissions($GLOBALS[group_id], $artifact); print '<br />('. (($value == 9)?_("None"):""). (($value == 1)?_("Technician"):""). (($value == 3)?_("Manager"):""). (($value == 2)?_("Techn. & Manager"):""). ')'; } print ' </td>'; }

html_select_restriction_box (  $  artifact, $  row, $  level = "group", $  notd = 0, $  event = 1 )

Definition at line 619 of file html.php. References $row, $value, group_id, and print. { # event = 1 : posting items # event = 2 : posting comments # If $row['user_id'] does not exists, we havent got a row but simple value # and it means that we are about to modify per group default if ($level == "type") { $value = $row; $default = 0; } else { $value = $row; if ($event == 2) { $default = _("Same as for new items"); } else { $default = _("Group Type Default"); } } if (!$notd) { print ' <td align="center">'; } print ' <select name="'.$artifact.'_restrict_event'.$event.'">'; if ($default) { print ' <option value="NULL"'.((!$value)?" selected=\"selected\"":"").'>'.$default.'</option>'; } print ' <option value="5"'.(($value == 5)?" selected=\"selected\"":"").'>'._("Project Member").'</option>'; print ' <option value="3"'.(($value == 3)?" selected=\"selected\"":"").'>'._("Logged-in User").'</option>'; print ' <option value="2"'.(($value == 2)?" selected=\"selected\"":"").'>'._("Anonymous").'</option>'; print ' </select>'; if (!$value && $level == "group" && $event == 1) { $value = group_gettyperestrictions($GLOBALS[group_id], $artifact); print '<br />('. (($value == 5)?_("Project Member"):""). (($value == 3)?_("Logged-in User"):""). (($value == 2)?_("Anonymous"):""). ')'; } if (!$notd) { print ' </td>'; } }

html_select_theme_box (  $  input_name = "user_theme", $  current = 0 )

Definition at line 718 of file html.php. References $theme, print, selected, and theme_list(). { print ' <select name="'.$input_name.'">'; # usual themes $data = theme_list(1); while (list(,$theme) = each($data)) { print "\n\t\t".'<option value="'.$theme.'"'; if ($theme == $current) { print ' selected="selected"'; } print '>'.$theme; if ($theme == $GLOBALS['sys_themedefault']) { print ' ('._("default").')'; } print '</option>'."\n"; } # special rotate case $theme = "rotate"; print "\n\t\t".'<option value="'.$theme.'"'; if ($theme == $current) { print ' selected="selected"'; } print '> &gt; '.("alphabetically picked everyday").'</option>'; # special random case $theme = "random"; print "\n\t\t".'<option value="'.$theme.'"'; if ($theme == $current) { print ' selected="selected"'; } print '> &gt; '.("randomly picked everyday").'</option>'; print " </select>\n"; }

html_select_typedir_box (  $  input_name, $  current_value )

Definition at line 691 of file html.php. References nbsp, and print. { print '<br />&nbsp;&nbsp; <select name="'.$input_name.'"> <option value="basicdirectory"'.(($current_value == "basicdirectory")?" selected":"").'>'._("Basic Directory").'</option> <option value="basiccvs"'.(($current_value == "basiccvs")?" selected=\"selected\"":"").'>'._("Basic Cvs Directory").'</option> <option value="basicsvn"'.(($current_value == "basicsvn")?" selected=\"selected\"":"").'>'._("Basic Subversion Directory").'</option> <option value="cvsattic"'.(($current_value == "cvsattic")?" selected=\"selected\"":"").'>'._("Cvs Attic/Gna").'</option> <option value="svnattic"'.(($current_value == "svnattic")?" selected=\"selected\"":"").'>'._("Subversion Attic/Gna").'</option> <option value="savannah-gnu"'.(($current_value == "savannah-gnu")?" selected=\"selected\"":"").'>'._("Savannah GNU").'</option> <option value="savannah-nongnu"'.(($current_value == "savannah-nongnu")?" selected=\"selected\"":"").'>'._("Savannah non-GNU").'</option> </select> [BACKEND SPECIFIC] '; # put some information print '<br /><span class="smaller">Basic directory will make the backend using DownloadMakeArea(), defined in Savannah::Download; <br /> CVS directory will make the backend using CvsMakeArea(), defined in Savannah::Cvs;<br /> (If you need to build directories with another method, the solution is to write a new sub in the appropriate perl module, please send a mail to savane-dev@gna.org to get information about that)</span><br /><br />'; }

html_show_boxoptions (  $  legend, $  content, $  form_opening = 0, $  submit = 0 )

Definition at line 37 of file html.php. References $ret, and form. Referenced by html_show_displayoptions(). { $script_hide = 'onclick="document.getElementById(\'boxoptionscontent\').style.display=\'none\'; document.getElementById(\'boxoptionslinkhide\').style.display=\'none\'; document.getElementById(\'boxoptionslinkshow\').style.display=\'inline\';"'; $script_show = 'onclick="document.getElementById(\'boxoptionscontent\').style.display=\'inline\'; document.getElementById(\'boxoptionslinkhide\').style.display=\'inline\'; document.getElementById(\'boxoptionslinkshow\').style.display=\'none\';"'; $ret = ' <fieldset class="boxoptions"> <a name="options"></a> <legend>'; # yeupou, 2006-02: it is not ubercool to use monospace font to show # plus or minus button, but all the tests I made with icons so far ended up # in quite an ugly thing when the font scale change. $ret .= ' <span '.$script_hide.' id="boxoptionslinkhide"><span class="minusorplus">(-)</span>'.$legend.'</span> <span '.$script_show.' id="boxoptionslinkshow"><span class="minusorplus">(+)</span>'.$legend.'</span> </legend> <span id="boxoptionscontent">'; if ($form_opening && $submit) { $ret .= ' '.$form_opening.' <span class="boxoptionssubmit">'.$submit.'</span>'; } $ret .= ' <span class="smaller">'.$content.'</span>'; if ($form_opening && $submit) { $ret .= ' </form>'; } $ret .= ' </span> </fieldset> '; return $ret; }

html_show_displayoptions (  $  content, $  form_opening = 0, $  submit = 0 )

Definition at line 32 of file html.php. References html_show_boxoptions(). { return html_show_boxoptions(_("Display Criteria"), $content, $form_opening, $submit); }

html_splitpage (  $  how  )

Definition at line 82 of file html.php. { if ($how == 'start' || $how == '1') { return "\n".'<div class="splitright">'."\n"; } elseif ($how == 'middle' || $how == '2') { return "\n".'</div><!-- end splitright -->'."\n". '<div class="splitleft">'."\n"; } else { return "\n".'</div><!-- end splitleft -->'."\n"; } }

site_footer (  $  params  )

Definition at line 849 of file html.php. References html_footer(). { html_footer($params); }

site_header (  $  params  )

aliases of catch all header functions Definition at line 844 of file html.php. References html_header(). { html_header($params); }

site_project_header (  $  params  )

site_project_header everything required to handle security and state checks for a project web page Parameters: params  array() must contain $context and $group Returns: text - prints HTML to the screen directly Definition at line 865 of file html.php. References $group_id, $project, exit_error(), group, group_id, and html_header(). Referenced by forum_header().

---

Variable Documentation

return $return = (' />')

Definition at line 239 of file html.php. Referenced by box1_bottom(), box1_top(), box_bottom(), box_middle(), box_top(), html_build_select_box_from_array(), html_build_select_box_from_arrays(), html_image(), news_show_latest(), people_show_category_list(), people_show_category_table(), show_features_boxes(), show_newest_projects(), show_sitestats(), show_votes(), and utils_link().

---