*
* Copyright 1999-2001 (c) VA Linux Systems
* Copyright 2010 (c) FusionForge Team
- * Copyright (C) 2010 Alain Peyrat - Alcatel-Lucent
+ * Copyright (C) 2010-2012 Alain Peyrat - Alcatel-Lucent
+ * Copyright 2011, Franck Villaume - Capgemini
+ * Copyright 2011-2012, Franck Villaume - TrivialDev
*
- * This file is part of FusionForge.
+ * This file is part of FusionForge. FusionForge is free software;
+ * you can redistribute it and/or modify it under the terms of the
+ * GNU General Public License as published by the Free Software
+ * Foundation; either version 2 of the Licence, or (at your option)
+ * any later version.
*
- * FusionForge is free software; you can redistribute it and/or modify
- * it under the terms of the GNU General Public License as published
- * by the Free Software Foundation; either version 2 of the License,
- * or (at your option) any later version.
- *
- * FusionForge is distributed in the hope that it will be useful, but
- * WITHOUT ANY WARRANTY; without even the implied warranty of
- * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
- * General Public License for more details.
+ * FusionForge is distributed in the hope that it will be useful,
+ * but WITHOUT ANY WARRANTY; without even the implied warranty of
+ * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
+ * GNU General Public License for more details.
*
- * You should have received a copy of the GNU General Public License
- * along with FusionForge; if not, write to the Free Software
- * Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307
- * USA
+ * You should have received a copy of the GNU General Public License along
+ * with FusionForge; if not, write to the Free Software Foundation, Inc.,
+ * 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA.
*/
/**
}
/**
- * html_feedback_top() - Show the feedback output at the bottom of the page.
+ * html_feedback_bottom() - Show the feedback output at the bottom of the page.
*
* @param string The feedback.
*/
$res=db_query_params('SELECT theme_id, fullname FROM themes WHERE enabled=true',
array());
$nbTheme = db_numrows($res);
- if($nbTheme < 2) {
+ if ($nbTheme == 1) {
+ $thetheme = db_result($res, 0, 'fullname');
+ return util_html_secure($thetheme) . html_e('input', array(
+ 'type' => 'hidden',
+ 'name' => $title,
+ 'value' => db_result($res, 0, 'theme_id'),
+ ));
+ } else if ($nbTheme < 1) {
return("");
- }
- else {
- return html_build_select_box($res, $title, $selected, false);
+ } else {
+ return html_build_select_box($res,$title,$selected,false);
}
}
$return = '
<select name="'.$select_name.'">';
- $rows=count($vals);
+ $rows = count($vals);
- for ($i=0; $i<$rows; $i++) {
+ for ($i = 0; $i < $rows; $i++) {
if ( $samevals ) {
$return .= "\n\t\t<option value=\"" . $vals[$i] . "\"";
if ($vals[$i] == $checked_val) {
return $return;
}
+/**
+ * html_get_tooltip_description() - Get the tooltip description of the element
+ *
+ * @param string element name
+ */
+
function html_get_tooltip_description($element_name) {
- switch( $element_name ) {
- case 'assigned_to':
- return( _('This drop-down box represents the person to which a tracker item is assigned.'));
- case 'status_id':
- return( _('This drop-down box represents the current status of a tracker item.<br /><br />You can set the status to \'Pending\' if you are waiting for a response from the tracker item author. When the author responds the status is automatically reset to that of \'Open\'. Otherwise, if the author doesn\'t respond with an admin-defined amount of time (default is 14 days) then the item is given a status of \'Deleted\'.'));
- case 'category':
- return( _('Tracker category'));
- case 'group':
- return( _('Tracker group'));
- case 'sort_by':
- return( _('The Sort By option allows you to determine how the browse results are sorted.<br /><br /> You can sort by ID, Priority, Summary, Open Date, Close Date, Submitter, or Assignee. You can also have the results sorted in Ascending or Descending order.'));
- case 'new_artifact_type_id':
- return( _('The Data Type option determines the type of tracker item this is. Since the tracker rolls into one the bug, patch, support, etc... managers you need to be able to determine which one of these an item should belong.<br /><br />This has the added benefit of enabling an admin to turn a support request into a bug.'));
- case 'priority':
- return( _('The priority option allows a user to define a tracker item priority (ranging from 1-Lowest to 5-Highest).<br /><br />This is especially helpful for bugs and support requests where a user might find a critical problem with a project.'));
- case 'resolution':
- return( _('Resolution'));
- case 'summary':
- return( _('The summary text-box represents a short tracker item summary. Useful when browsing through several tracker items.'));
- case 'canned_response':
- return( _('The canned response drop-down represents a list of project admin-defined canned responses to common support or bug submission.<br /><br /> If you are a project admin you can click the \'(admin)\' link to define your own canned responses'));
- case 'comment':
- return( _('Comment'));
- case 'description':
- return( htmlentities(_('Enter the complete description.').'<br/><br/>'.
- _("<div align=\"left\"><b>Editing tips:</b><br/><strong>http,https or ftp</strong>: Hyperlinks.<br/><strong>[#NNN]</strong>: Tracker id NNN.<br/><strong>[TNNN]</strong>: Task id NNN.<br/><strong>[wiki:<pagename>]</strong>: Wiki page.<br/><strong>[forum:<msg_id>]</strong>: Forum post.</div>"),
- ENT_COMPAT, 'UTF-8'));
- case 'attach_file':
- return( _('When you wish to attach a file to a tracker item you must check this checkbox before submitting changes.'));
- case 'monitor':
- return( htmlentities(_('You can monitor or un-monitor this item by clicking the "Monitor" button. <br /><br /><strong>Note!</strong> this will send you additional email. If you add comments to this item, or submitted, or are assigned this item, you will also get emails for those reasons as well!'),
- ENT_COMPAT, 'UTF-8'));
- default:
- return('');
+ global $use_tooltips;
+ if ($use_tooltips) {
+ switch( $element_name ) {
+ case 'assigned_to':
+ return( _('This drop-down box represents the person to which a tracker item is assigned.'));
+ case 'status_id':
+ return( _('This drop-down box represents the current status of a tracker item.<br /><br />You can set the status to \'Pending\' if you are waiting for a response from the tracker item author. When the author responds the status is automatically reset to that of \'Open\'. Otherwise, if the author doesn\'t respond with an admin-defined amount of time (default is 14 days) then the item is given a status of \'Deleted\'.'));
+ case 'category':
+ return( _('Tracker category'));
+ case 'group':
+ return( _('Tracker group'));
+ case 'sort_by':
+ return( _('The Sort By option allows you to determine how the browse results are sorted.<br /><br /> You can sort by ID, Priority, Summary, Open Date, Close Date, Submitter, or Assignee. You can also have the results sorted in Ascending or Descending order.'));
+ case 'new_artifact_type_id':
+ return( _('The Data Type option determines the type of tracker item this is. Since the tracker rolls into one the bug, patch, support, etc... managers you need to be able to determine which one of these an item should belong.<br /><br />This has the added benefit of enabling an admin to turn a support request into a bug.'));
+ case 'priority':
+ return( _('The priority option allows a user to define a tracker item priority (ranging from 1-Lowest to 5-Highest).<br /><br />This is especially helpful for bugs and support requests where a user might find a critical problem with a project.'));
+ case 'resolution':
+ return( _('Resolution'));
+ case 'summary':
+ return( _('The summary text-box represents a short tracker item summary. Useful when browsing through several tracker items.'));
+ case 'canned_response':
+ return( _('The canned response drop-down represents a list of project admin-defined canned responses to common support or bug submission.<br /><br /> If you are a project admin you can click the \'(admin)\' link to define your own canned responses'));
+ case 'comment':
+ return( _('Anyone can add here comments to give additional information, answers and solutions. Please, be as precise as possible to avoid misunderstanding. If relevant, screenshots or documents can be added as attached files.'));
+ case 'description':
+ return( htmlentities(_('Enter the complete description.').'<br/><br/>'.
+ _("<div align=\"left\"><b>Editing tips:</b><br/><strong>http,https or ftp</strong>: Hyperlinks.<br/><strong>[#NNN]</strong>: Tracker id NNN.<br/><strong>[TNNN]</strong>: Task id NNN.<br/><strong>[wiki:<pagename>]</strong>: Wiki page.<br/><strong>[forum:<msg_id>]</strong>: Forum post.</div>"),
+ ENT_COMPAT, 'UTF-8'));
+ case 'attach_file':
+ return( _('When you wish to attach a file to a tracker item you must check this checkbox before submitting changes.'));
+ case 'monitor':
+ return( htmlentities(_('You can monitor or un-monitor this item by clicking the "Monitor" button. <br /><br /><strong>Note!</strong> this will send you additional email. If you add comments to this item, or submitted, or are assigned this item, you will also get emails for those reasons as well!'),
+ ENT_COMPAT, 'UTF-8'));
+ default:
+ return('');
+ }
+ } else {
+ return('');
}
}
-function html_use_tooltips() {
+function html_use_jquery() {
use_javascript('/scripts/jquery/jquery-1.4.2.min.js');
+}
+
+function html_use_tooltips() {
+ html_use_jquery();
use_javascript('/scripts/jquery-tipsy/src/javascripts/jquery.tipsy.js');
- use_javascript('/js/tooltips.js');
+ use_javascript('/js/jquery-common.js');
use_stylesheet('/scripts/jquery-tipsy/src/stylesheets/tipsy.css');
}
+function html_use_storage() {
+ html_use_jquery();
+ use_javascript('/scripts/jquery-storage/jquery.Storage.js');
+}
+
+function html_use_simplemenu() {
+ html_use_jquery();
+ use_javascript('/scripts/jquery-simpletreemenu/js/jquery-simpleTreeMenu-1.1.0.js');
+ use_stylesheet('/scripts/jquery-simpletreemenu/css/jquery-simpleTreeMenu-1.1.0.css');
+}
+
+function html_use_coolfieldset() {
+ html_use_jquery();
+ use_javascript('/scripts/coolfieldset/js/jquery.coolfieldset.js');
+ use_javascript('/js/jquery-common.js');
+ use_stylesheet('/scripts/coolfieldset/css/jquery.coolfieldset.css');
+}
+
+function html_use_jqueryui() {
+ html_use_jquery();
+ use_javascript('/scripts/jquery-ui/js/jquery-ui-1.8.17.custom.min.js');
+ use_stylesheet('/scripts/jquery-ui/css/overcast/jquery-ui-1.8.17.custom.css');
+}
+
/**
* html_build_select_box_from_arrays() - Takes two arrays, with the first array being the "id" or value and the other
* array being the text you want displayed.
* @param array Array of all allowed values from the full list.
*/
function html_build_select_box_from_arrays ($vals,$texts,$select_name,$checked_val='xzxz',$show_100=true,$text_100='none',$show_any=false,$text_any='any', $allowed=false) {
+ $have_a_subelement = false;
+
if ($text_100=='none'){
$text_100=_('None');
}
}
}
- $title = html_get_tooltip_description($select_name);
$return .= '
- <select'.$id.' name="'.$select_name.'" title="'.$title.'">';
+ <select'.$id.' name="'.$select_name.'" title="'.util_html_secure($title).'">';
//we don't always want the default Any row shown
if ($show_any) {
$return .= '
- <option value=""'.(($checked_val=='') ? ' selected="selected"' : '').'>'. $text_any .'</option>';
+ <option value=""'.(($checked_val=='') ? ' selected="selected"' : '').'>'. util_html_secure($text_any) .'</option>';
+ $have_a_subelement = true;
}
//we don't always want the default 100 row shown
if ($show_100) {
$return .= '
- <option value="100"'.(($checked_val==100) ? ' selected="selected"' : '').'>'. $text_100 .'</option>';
+ <option value="100"'.(($checked_val==100) ? ' selected="selected"' : '').'>'. util_html_secure($text_100) .'</option>';
+ $have_a_subelement = true;
}
$checked_found=false;
// if it was shown above, otherwise do show it
if (($vals[$i] != '100') || ($vals[$i] == '100' && !$show_100)) {
$return .= '
- <option value="'.$vals[$i].'"';
+ <option value="'.util_html_secure($vals[$i]).'"';
if ((string)$vals[$i] == (string)$checked_val) {
$checked_found=true;
$return .= ' selected="selected"';
if (is_array($allowed) && !in_array($vals[$i], $allowed)) {
$return .= ' disabled="disabled" class="option_disabled"';
}
- $return .= '>'./*htmlspecialchars(*/$texts[$i]/*)*/.'</option>';
+ $return .= '>'.util_html_secure($texts[$i]).'</option>';
+ $have_a_subelement = true;
}
}
//
//
if (!$checked_found && $checked_val != 'xzxz' && $checked_val && $checked_val != 100) {
$return .= '
- <option value="'.$checked_val.'" selected="selected">'._('No Change').'</option>';
+ <option value="'.util_html_secure($checked_val).'" selected="selected">'._('No Change').'</option>';
+ $have_a_subelement = true;
+ }
+
+ if (!$have_a_subelement) {
+ /* <select></select> without <option/> in between is invalid */
+ return '<!-- select without options -->';
}
$return .= '
* @param bool Whether or not to show the '100 row'
* @param string What to call the '100 row'. Defaults to none.
*/
-function html_build_select_box ($result, $name, $checked_val="xzxz",$show_100=true,$text_100='none',$show_any=false,$text_any='Select One') {
+function html_build_select_box ($result, $name, $checked_val="xzxz", $show_100=true, $text_100='none', $show_any=false, $text_any='Select One') {
if ($text_100=='none'){
$text_100=_('None');
}
/**
* html_build_multiple_select_box_from_arrays() - Takes two arrays and builds a multi-select box
*
- * @param array id of the field
+ * @param array id of the field
* @param array Text to be displayed
* @param string id of the items selected
* @param string The item that should be checked
$rows=count($ids);
for ($i=0; $i<$rows; $i++) {
if (( $ids[$i] != '100') || ($ids[$i] == '100' && !$show_100)) {
- $return .='
+ $return .='
<option value="'.$ids[$i].'"';
/*
Determine if it's checked
*/
function html_build_priority_select_box ($name='priority', $checked_val='3', $nochange=false) {
?>
- <select id="tracker-<?php echo $name ?>" name="<?php echo $name; ?>" title="<?php echo html_get_tooltip_description($name) ?>">
+ <select id="tracker-<?php echo $name ?>" name="<?php echo $name; ?>" title="<?php echo util_html_secure(html_get_tooltip_description($name)) ?>">
<?php if($nochange) { ?>
<option value="100"<?php if ($nochange) {echo " selected=\"selected\"";} ?>><?php echo _('No Change') ?></option>
<?php } ?>
/**
* html_buildcheckboxarray() - Build an HTML checkbox array.
*
- * @param array Options array
- * @param name Checkbox name
- * @param array Array of boxes to be pre-checked
+ * @param array Options array
+ * @param name Checkbox name
+ * @param array Array of boxes to be pre-checked
*/
function html_buildcheckboxarray($options,$name,$checked_array) {
$option_count=count($options);
}
/**
- * site_header() - everything required to handle security and
- * add navigation for user pages like /my/ and /account/
+ * site_header() - everything required to handle security and
+ * add navigation for user pages like /my/ and /account/
*
- * @param array Must contain $user_id
+ * @param array Must contain $user_id
*/
function site_header($params) {
GLOBAL $HTML;
Check to see if active user
Check to see if logged in
*/
- echo $HTML->header($params);
-
- if(isset($GLOBALS['error_msg']) && $GLOBALS['error_msg']) {
- echo html_error_top($GLOBALS['error_msg']);
- }
- if(isset($GLOBALS['warning_msg']) && $GLOBALS['warning_msg']) {
- echo html_warning_top($GLOBALS['warning_msg']);
- }
- if(isset($GLOBALS['feedback']) && $GLOBALS['feedback']) {
- echo html_feedback_top($GLOBALS['feedback']);
- }
+ $HTML->header($params);
}
/**
* site_footer() - Show the HTML site footer.
*
- * @param array Footer params array
+ * @param array Footer params array
*/
function site_footer($params) {
- GLOBAL $HTML;
+ global $HTML;
$HTML->footer($params);
}
/**
- * site_project_header() - everything required to handle
- * security and state checks for a project web page
+ * site_project_header() - everything required to handle
+ * security and state checks for a project web page
*
- * @param params array() must contain $toptab and $group
+ * @param params array() must contain $toptab and $group
*/
function site_project_header($params) {
- GLOBAL $HTML;
+ global $HTML;
/*
Check to see if active
exit_error(sprintf(_('Project Problem: %s'),$project->getErrorMessage()),'home');
}
- //group is private
- if (!$project->isPublic()) {
- session_require_perm ('project_read', $group_id);
- }
+ // Check permissions in case of restricted access
+ session_require_perm ('project_read', $group_id);
//for dead projects must be member of admin project
if (!$project->isActive()) {
if (!isset($params['h1'])){
$params['h1'] = $h1;
}
-
+
+ if ($project->getDescription()) {
+ $params['meta-description'] = $project->getDescription();
+ }
+
+ if (forge_get_config('use_project_tags')) {
+ $res = db_query_params('SELECT name FROM project_tags WHERE group_id = $1', array($group_id));
+ if ($res && db_numrows($res) > 0) {
+ while ($row = db_fetch_array($res)) {
+ $array[] = $row['name'];
+ }
+ $params['meta-keywords'] = htmlspecialchars(join(', ', $array));
+ }
+ }
+
site_header($params);
-
-// echo $HTML->project_tabs($params['toptab'],$params['group'],$params['tabtext']);
}
/**
- * site_project_footer() - currently a simple shim
- * that should be on every project page, rather than
- * a direct call to site_footer() or theme_footer()
+ * site_project_footer() - currently a simple shim
+ * that should be on every project page, rather than
+ * a direct call to site_footer() or theme_footer()
*
- * @param params array() empty
+ * @param params array() empty
*/
function site_project_footer($params) {
site_footer($params);
}
/**
- * site_user_header() - everything required to handle security and
- * add navigation for user pages like /my/ and /account/
+ * site_user_header() - everything required to handle security and
+ * add navigation for user pages like /my/ and /account/
*
- * @param params array() must contain $user_id
+ * @param params array() must contain $user_id
*/
function site_user_header($params) {
GLOBAL $HTML;
*/
site_header($params);
echo ($HTML->beginSubMenu());
- $arr_t = array() ;
- $all_l = array() ;
-
- $arr_t[] = _('My Personal Page') ;
- $arr_l[] = '/my/' ;
+ $arr_t = array();
+ $all_l = array();
+ $arr_attr = array();
+
+ $arr_t[] = _('My Personal Page');
+ $arr_l[] = '/my/';
+ $arr_attr[] = array('title' => _('View your personal page, a selection of widgets to follow the informations from projects.'), 'class' => 'tabtitle-nw');
+
+ if (forge_get_config('use_tracker')) {
+ $arr_t[] = _('Trackers dashboard');
+ $arr_l[] = '/my/dashboard.php';
+ $arr_attr[] = array('title' => _('View your tasks and artifacts.'), 'class' => 'tabtitle');
+ }
- $arr_t[] = _('Trackers dashboard') ;
- $arr_l[] = '/my/dashboard.php' ;
- if ($GLOBALS['sys_use_diary']) {
- $arr_t[] = _('Diary & Notes') ;
- $arr_l[] = '/my/diary.php' ;
+ if (forge_get_config('use_diary')) {
+ $arr_t[] = _('Diary & Notes');
+ $arr_l[] = '/my/diary.php';
+ $arr_attr[] = array('title' => _('Manage your diary. Add, modify or delete your notes.'), 'class' => 'tabtitle');
}
- $arr_t[] = _('Account Maintenance') ;
- $arr_l[] = '/account/' ;
+ $arr_t[] = _('Account Maintenance');
+ $arr_l[] = '/account/';
+ $arr_attr[] = array('title' => _('Manage your account. Change your password, select your preferences.'), 'class' => 'tabtitle');
- if (!forge_get_config ('project_registration_restricted')
- || forge_check_global_perm ('approve_projects', '')) {
- $arr_t[] = _('Register Project') ;
- $arr_l[] = '/register/' ;
+ if (!forge_get_config('project_registration_restricted')
+ || forge_check_global_perm('approve_projects', '')) {
+ $arr_t[] = _('Register Project');
+ $arr_l[] = '/register/';
+ $arr_attr[] = array('title' => _('Register a new project in forge, following the workflow.'), 'class' => 'tabtitle');
}
- echo ($HTML->printSubMenu($arr_t, $arr_l)) ;
- plugin_hook ("usermenu", false) ;
+ echo ($HTML->printSubMenu($arr_t, $arr_l, $arr_attr));
+ if ( plugin_hook_listeners("usermenu") > 0 ) {
+ echo $HTML->subMenuSeparator();
+ }
+ plugin_hook("usermenu", false);
echo ($HTML->endSubMenu());
}
/**
- * site_user_footer() - currently a simple shim that should be on every user page,
- * rather than a direct call to site_footer() or theme_footer()
+ * site_user_footer() - currently a simple shim that should be on every user page,
+ * rather than a direct call to site_footer() or theme_footer()
*
- * @param params array() empty
+ * @param params array() empty
*/
function site_user_footer($params) {
site_footer($params);
}
/**
- * html_clean_hash_string() - Remove noise characters from hex hash string
+ * html_clean_hash_string() - Remove noise characters from hex hash string
*
- * Thruout SourceForge, URLs with hexadecimal hash string parameters
- * are being sent via email to request confirmation of user actions.
- * It was found that some mail clients distort this hash, so we take
- * special steps to encode it in the way which help to preserve its
- * recognition. This routine
+ * Thruout SourceForge, URLs with hexadecimal hash string parameters
+ * are being sent via email to request confirmation of user actions.
+ * It was found that some mail clients distort this hash, so we take
+ * special steps to encode it in the way which help to preserve its
+ * recognition. This routine
*
- * @param hashstr required hash parameter as received from browser
- * @return pure hex string
+ * @param hashstr required hash parameter as received from browser
+ * @return pure hex string
*/
function html_clean_hash_string($hashstr) {
return $hashstr;
}
+function relative_date ($date) {
+ $delta = time() - $date;
+ if ($delta<60)
+ return sprintf(ngettext('%d second ago', '%d seconds ago', $delta), $delta);
+
+ $delta = round($delta/60);
+ if ($delta<60)
+ return sprintf(ngettext('%d minute ago', '%d minutes ago', $delta), $delta);
+
+ $delta = round($delta/60);
+ if ($delta<24)
+ return sprintf(ngettext('%d hour ago', '%d hours ago', $delta), $delta);
+
+ $delta = round($delta/24);
+ if ($delta<7)
+ return sprintf(ngettext('%d day ago', '%d days ago', $delta), $delta);
+
+ $delta = round($delta/7);
+ if ($delta<4)
+ return sprintf(ngettext('%d week ago', '%d weeks ago', $delta), $delta);
+
+ return date(_('Y-m-d H:i'), $date);
+}
+
+/* TODO: think about beautifying output */
+
+/**
+ * html_eo() - Return proper element XHTML start tag
+ *
+ * @param string $name
+ * element name
+ * @param array $attrs
+ * (optional) associative array of element attributes
+ * values: arrays are space-imploded;
+ * false values and empty arrays ignored
+ * @return string
+ * XHTML string suitable for echo'ing
+ */
+function html_eo($name, $attrs=array()) {
+ $rv = '<' . $name;
+ foreach ($attrs as $key => $value) {
+ if (is_array($value)) {
+ $value = count($value) ? implode(" ", $value) : false;
+ }
+ if ($value === false) {
+ continue;
+ }
+ $rv .= ' ' . $key . '="' . htmlspecialchars($value) . '"';
+ }
+ $rv .= '>';
+ return $rv;
+}
+
+/**
+ * html_e() - Return proper element XHTML start/end sequence
+ *
+ * @param string $name
+ * element name
+ * @param array $attrs
+ * (optional) associative array of element attributes
+ * values: arrays are space-imploded;
+ * false values and empty arrays ignored
+ * @param string $content
+ * (optional) XHTML to be placed inside
+ * @param bool $shortform
+ * (optional) allow short open-close form
+ * (default: true)
+ * @return string
+ * XHTML string suitable for echo'ing
+ */
+function html_e($name, $attrs=array(), $content="", $shortform=true) {
+ $rv = '<' . $name;
+ foreach ($attrs as $key => $value) {
+ if (is_array($value)) {
+ $value = count($value) ? implode(" ", $value) : false;
+ }
+ if ($value === false) {
+ continue;
+ }
+ $rv .= ' ' . $key . '="' . htmlspecialchars($value) . '"';
+ }
+ if ($content === "" && $shortform) {
+ $rv .= ' />';
+ } else {
+ $rv .= '>' . $content . '</' . $name . '>';
+ }
+ return $rv;
+}
+
+$html_autoclose_stack = array();
+$html_autoclose_pos = 0;
+
+/**
+ * html_ap() - Return XHTML element autoclose stack position
+ *
+ * @return integer
+ */
+function html_ap() {
+ global $html_autoclose_pos;
+
+ return $html_autoclose_pos;
+}
+
+/**
+ * html_ao() - Return proper element XHTML start tag, with autoclose
+ *
+ * @param string $name
+ * element name
+ * @param array $attrs
+ * (optional) associative array of element attributes
+ * values: arrays are space-imploded;
+ * false values and empty arrays ignored
+ * @return string
+ * XHTML string suitable for echo'ing
+ */
+function html_ao($name, $attrs=array()) {
+ global $html_autoclose_pos, $html_autoclose_stack;
+
+ $html_autoclose_stack[$html_autoclose_pos++] = array(
+ 'name' => $name,
+ 'attr' => $attrs,
+ );
+ return html_eo($name, $attrs);
+}
+
+/**
+ * html_aonce() - Return once proper element XHTML start tag, with autoclose
+ *
+ * @param ref &$sptr
+ initialise this to false; will be modified
+ * @param string $name
+ * element name
+ * @param array $attrs
+ * (optional) associative array of element attributes
+ * values: arrays are space-imploded;
+ * false values and empty arrays ignored
+ * @return string
+ * XHTML string suitable for echo'ing
+ */
+function html_aonce(&$sptr, $name, $attrs=array()) {
+ if ($sptr !== false) {
+ /* already run */
+ return "";
+ }
+ $sptr = html_ap();
+ return html_ao($name, $attrs);
+}
+
+/**
+ * html_ac() - Return proper element XHTML end tags, autoclosing
+ *
+ * @param integer $spos
+ * stack position to return to
+ * (nothing is done if === false)
+ * @return string
+ * XHTML string suitable for echo'ing
+ */
+function html_ac($spos) {
+ global $html_autoclose_pos, $html_autoclose_stack;
+
+ if ($spos === false) {
+ /* support for html_aonce() */
+ return "";
+ }
+
+ if ($html_autoclose_pos < $spos) {
+ $e = "html_autoclose stack underflow; closing down to " .
+ $spos . " but we're down to " . $html_autoclose_pos .
+ " already!";
+ throw new Exception($e);
+ }
+
+ $rv = "";
+ while ($html_autoclose_pos > $spos) {
+ --$html_autoclose_pos;
+ $rv .= '</' . $html_autoclose_stack[$html_autoclose_pos]['name'] . '>';
+ unset($html_autoclose_stack[$html_autoclose_pos]);
+ }
+ return $rv;
+}
+
+/**
+ * html_a_copy() - Return a copy of part of the autoclose stack
+ *
+ * @param integer $spos
+ * stack position caller will return to
+ * @return opaque
+ * argument suitable for html_a_apply()
+ */
+function html_a_copy($spos) {
+ global $html_autoclose_pos, $html_autoclose_stack;
+
+ if ($spos === false) {
+ return array();
+ }
+
+ if ($spos > $html_autoclose_pos) {
+ $e = "html_autoclose stack underflow; closing down to " .
+ $spos . " but we're down to " . $html_autoclose_pos .
+ " already!";
+ throw new Exception($e);
+ }
+
+ $rv = array();
+ while ($spos < $html_autoclose_pos) {
+ $rv[] = $html_autoclose_stack[$spos++];
+ }
+ return $rv;
+}
+
+/**
+ * html_a_apply() - Reopen tags based on an autoclose stack copy
+ *
+ * @param opaque $scopy
+ * return value from html_a_copy()
+ * @return string
+ * XHTML string suitable for echo'ing
+ */
+function html_a_apply($scopy) {
+ /* array_reduce() would be useful here... IF IT WORKED, FFS! */
+ $rv = "";
+ foreach ($scopy as $value) {
+ $rv .= html_ao($value['name'], $value['attr']);
+ }
+ return $rv;
+}
+
// Local Variables:
// mode: php
// c-file-style: "bsd"
// End:
-
-?>