core_print_API.php

<?php
	# Mantis - a php based bugtracking system
	# Copyright (C) 2000 - 2002  Kenzaburo Ito - kenito@300baud.org
	# This program is distributed under the terms and conditions of the GPL
	# See the files README and LICENSE for details

	###########################################################################
	# Basic Print API
	###########################################################################

	# this file handles printing and string manipulation functions

	# --------------------
	function print_header_redirect( $p_url ) {
		global $g_use_iis;

		if ( OFF == $g_use_iis ) {
			header( "Status: 302" );
		}
		header( "Content-Type: text/html" );
		header( "Pragma: no-cache" );
		header( "Expires: Fri, 01 Jan 1999 00:00:00 GMT" );
		header( "Cache-control: no-cache, no-cache=\"Set-Cookie\", private" );
		if ( ON == $g_use_iis ) {
			header( "Refresh: 0;url=$p_url" );
		} else {
			header( "Location: $p_url" );
		}
	}
	# --------------------
	# prints the name of the user given the id.  also makes it an email link.
	function print_user( $p_user_id ) {
		global $g_mantis_user_table, $s_user_no_longer_exists;

		# invalid user
		if ( "0000000" == $p_user_id ) {
			return;
		}
	    $query = "SELECT username, email
	    		FROM $g_mantis_user_table
	    		WHERE id='$p_user_id'";
	    $result = db_query( $query );
	    if ( db_num_rows( $result ) > 0 ) {
			$t_username	= db_result( $result, 0, 0 );
			$t_email	= db_result( $result, 0, 1 );

			print_email_link( $t_email, $t_username );
		} else {
			PRINT $s_user_no_longer_exists;
		}
	}
	# --------------------
	# same as print_user() but fills in the subject with the bug summary
	function print_user_with_subject( $p_user_id, $p_bug_id ) {
		global $g_mantis_user_table, $s_user_no_longer_exists;

		if ( "0000000" == $p_user_id ) {
			return;
		}
	    $query = "SELECT username, email
	    		FROM $g_mantis_user_table
	    		WHERE id='$p_user_id'";
	    $result = db_query( $query );
	    if ( db_num_rows( $result ) > 0 ) {
			$t_username	= db_result( $result, 0, 0 );
			$t_email	= db_result( $result, 0, 1 );

			print_email_link_with_subject( $t_email, $t_username, $p_bug_id );
		} else {
			PRINT $s_user_no_longer_exists;
		}
	}
	# --------------------
	# returns username if account
	function get_user( $p_user_id ) {
		global $g_mantis_user_table, $s_user_no_longer_exists;

		if ( "0000000" == $p_user_id ) {
			return "";
		}
		$query = "SELECT username
				FROM $g_mantis_user_table
				WHERE id='$p_user_id'";
		$result = db_query( $query );
		if ( db_num_rows( $result )>0 ) {
			return db_result( $result, 0, 0 );
		} else {
			return $s_user_no_longer_exists;
		}
	}
	# --------------------
	function print_duplicate_id( $p_duplicate_id ) {
		global 	$g_view_bug_page, $g_view_bug_advanced_page;

		if ( $p_duplicate_id!="0000000" ) {
			if ( ON == get_current_user_pref_field( "advanced_view" ) ) {
				PRINT "<a href=\"$g_view_bug_advanced_page?f_id=$p_duplicate_id\">".$p_duplicate_id."</a>";
			} else {
				PRINT "<a href=\"$g_view_bug_page?f_id=$p_duplicate_id\">".$p_duplicate_id."</a>";
			}
		}
	}
	# --------------------
	###########################################################################
	# Option List Printing API
	###########################################################################
	# --------------------
	function print_user_option_list( $p_user_id ) {
		global $g_mantis_user_table;

	    $query = "SELECT id, username
	    		FROM $g_mantis_user_table
	    		ORDER BY username";
	    $result = db_query( $query );
	    $user_count = db_num_rows( $result );
	    for ($i=0;$i<$user_count;$i++) {
	    	$row = db_fetch_array( $result );
	    	$t_user_id   = $row["id"];
	    	$t_user_name = $row["username"];

	    	if ( $t_user_id == $p_user_id ) {
				PRINT "<option value=\"$t_user_id\" SELECTED>".$t_user_name."</option>";
			}
			else {
				PRINT "<option value=\"$t_user_id\">".$t_user_name."</option>";
			}
		}
	}
	# --------------------
	function print_reporter_option_list( $p_user_id ) {
		global	$g_mantis_user_table, $g_mantis_project_user_list_table,
				$g_mantis_project_table, $g_project_cookie_val;

		$t_adm = ADMINISTRATOR;
		$t_rep = REPORTER;
		$t_pub = PUBLIC;
		$t_prv = PRIVATE;

		# checking if it's per project or all projects
		# 0 is all projects
		if ( '0000000' == $g_project_cookie_val ) {
			$query = "SELECT DISTINCT u.id, u.username, u.email
					FROM 	$g_mantis_user_table u,
							$g_mantis_project_user_list_table l,
							$g_mantis_project_table p
					WHERE	(p.view_state='$t_pub' AND
							u.access_level>='$t_rep') OR
							(l.access_level>='$t_rep' AND
							l.user_id=u.id) OR
							u.access_level>='$t_adm'
					ORDER BY u.username";
		} else {
			$query = "SELECT DISTINCT u.id, u.username, u.email
					FROM 	$g_mantis_user_table u,
							$g_mantis_project_user_list_table l,
							$g_mantis_project_table p
					WHERE	(p.view_state='$t_pub' AND
							u.access_level>='$t_rep' AND
							p.id='$g_project_cookie_val') OR
							(l.access_level>='$t_rep' AND
							l.user_id=u.id AND
							l.project_id='$g_project_cookie_val') OR
							u.access_level>='$t_adm'
					ORDER BY u.username";
		}
		$result = db_query( $query );
		$user_count = db_num_rows( $result );
		for ($i=0;$i<$user_count;$i++) {
			$row = db_fetch_array( $result );
			extract( $row, EXTR_PREFIX_ALL, "v" );
			if ( $v_id == $p_user_id ) {
				PRINT "<option value=\"$v_id\" SELECTED>$v_username</option>";
			} else {
				PRINT "<option value=\"$v_id\">$v_username</option>";
			}
		} # end for
	}
	# --------------------
	function print_duplicate_id_option_list() {
		global $g_mantis_bug_table;

	    $query = "SELECT id
	    		FROM $g_mantis_bug_table
	    		ORDER BY id ASC";
	    $result = db_query( $query );
	    $duplicate_id_count = db_num_rows( $result );
	    PRINT "<option value=\"0000000\"></option>";

	    for ($i=0;$i<$duplicate_id_count;$i++) {
	    	$row = db_fetch_array( $result );
	    	$t_duplicate_id	= $row["id"];

			PRINT "<option value=\"$t_duplicate_id\">".$t_duplicate_id."</option>";
		}
	}
	# --------------------
	# Get current headlines and id  prefix with v_
	function print_news_item_option_list() {
		global $g_mantis_news_table, $g_project_cookie_val;

		if ( access_level_check_greater_or_equal( ADMINISTRATOR ) ) {
			$query = "SELECT id, headline
				FROM $g_mantis_news_table
				ORDER BY date_posted DESC";
		} else {
			$query = "SELECT id, headline
				FROM $g_mantis_news_table
				WHERE project_id='$g_project_cookie_val'
				ORDER BY date_posted DESC";
		}
	    $result = db_query( $query );
	    $news_count = db_num_rows( $result );

		for ($i=0;$i<$news_count;$i++) {
			$row = db_fetch_array( $result );
			extract( $row, EXTR_PREFIX_ALL, "v" );
			$v_headline = string_display( $v_headline );

			PRINT "<option value=\"$v_id\">$v_headline</option>";
		}
	}
	# --------------------
	# Used for update pages
	function print_field_option_list( $p_list, $p_item="" ) {
		global $g_mantis_bug_table;

		$t_category_string = get_enum_string( $g_mantis_bug_table, $p_list );
	    $t_arr = explode_enum_string( $t_category_string );
		$entry_count = count( $t_arr );
		for ($i=0;$i<$entry_count;$i++) {
			$t_s = str_replace( "'", "", $t_arr[$i] );
			if ( $p_item == $t_s ) {
				PRINT "<option value=\"$t_s\" SELECTED>$t_s</option>";
			}
			else {
				PRINT "<option value=\"$t_s\">$t_s</option>";
			}
		} # end for
	}
	# --------------------
	function print_assign_to_option_list( $p_id="" ) {
		global $g_mantis_user_table, $g_mantis_project_table,
				$g_mantis_project_user_list_table, $g_project_cookie_val;

		$t_adm = ADMINISTRATOR;
		$t_dev = DEVELOPER;
		$t_pub = PUBLIC;
		$t_prv = PRIVATE;

		# checking if it's per project or all projects
		# 0 is all projects
		if ( '0000000' == $g_project_cookie_val ) {
			$query = "SELECT DISTINCT u.id, u.username, u.email
					FROM 	$g_mantis_user_table u,
							$g_mantis_project_user_list_table l,
							$g_mantis_project_table p
					WHERE	(p.view_state='$t_pub' AND
							u.access_level>='$t_dev') OR
							(l.access_level>='$t_dev' AND
							l.user_id=u.id) OR
							u.access_level>='$t_adm'
					ORDER BY u.username";
		} else {
			$query = "SELECT DISTINCT u.id, u.username, u.email
					FROM 	$g_mantis_user_table u,
							$g_mantis_project_user_list_table l,
							$g_mantis_project_table p
					WHERE	(p.view_state='$t_pub' AND
							u.access_level>='$t_dev' AND
							p.id='$g_project_cookie_val') OR
							(l.access_level>='$t_dev' AND
							l.user_id=u.id AND
							l.project_id='$g_project_cookie_val') OR
							u.access_level>='$t_adm'
					ORDER BY u.username";
		}

		$result = db_query( $query );
		$user_count = db_num_rows( $result );
		for ($i=0;$i<$user_count;$i++) {
			$row = db_fetch_array( $result );
			extract( $row, EXTR_PREFIX_ALL, "v" );
			if ( $v_id == $p_id ) {
				PRINT "<option value=\"$v_id\" SELECTED>$v_username</option>";
			} else {
				PRINT "<option value=\"$v_id\">$v_username</option>";
			}
		} # end for
	}
	# --------------------
	# List projects that the current user has access to
	function print_project_option_list( $p_project_id="" ) {
		global $g_mantis_project_table, $g_mantis_project_user_list_table,
				$g_project_cookie_val;

		$t_user_id = get_current_user_field( "id" );
		$t_access_level = get_current_user_field( "access_level" );

		$t_pub = PUBLIC;
		$t_prv = PRIVATE;

		if ( ADMINISTRATOR == $t_access_level ) {
			$query = "SELECT DISTINCT( p.id ), p.name
						FROM $g_mantis_project_table p
						WHERE p.enabled=1
						ORDER BY p.name";
		} else {
			$query = "SELECT DISTINCT( p.id ), p.name
						FROM $g_mantis_project_table p
						LEFT JOIN $g_mantis_project_user_list_table u
						ON p.id=u.project_id
						WHERE p.enabled=1 AND
						((p.view_state=$t_pub) OR
						 (p.view_state=$t_prv AND u.user_id=$t_user_id))
						ORDER BY p.name";
		}

		$result = db_query( $query );
		$project_count = db_num_rows( $result );

		for ($i=0;$i<$project_count;$i++) {
			$row = db_fetch_array( $result );
			extract( $row, EXTR_PREFIX_ALL, "v" );
			if ( $p_project_id == $v_id ) {
				PRINT "<option value=\"$v_id\" SELECTED>$v_name</option>";
			} else {
				PRINT "<option value=\"$v_id\">$v_name</option>";
			}
		}
	}
	# --------------------
	# prints the profiles given the user id
	function print_profile_option_list( $p_id, $p_select_id="" ) {
		global $g_mantis_user_profile_table, $g_mantis_user_pref_table;

		$query = "SELECT default_profile
			FROM $g_mantis_user_pref_table
			WHERE user_id='$p_id'";
	    $result = db_query( $query );
	    $v_default_profile = db_result( $result, 0, 0 );

		# Get profiles
		$query = "SELECT id, platform, os, os_build
			FROM $g_mantis_user_profile_table
			WHERE user_id='$p_id'
			ORDER BY id";
	    $result = db_query( $query );
	    $profile_count = db_num_rows( $result );

		PRINT "<option value=\"\"></option>";
		for ($i=0;$i<$profile_count;$i++) {
			# prefix data with v_
			$row = db_fetch_array( $result );
			extract( $row, EXTR_PREFIX_ALL, "v" );
			$v_platform	= string_display( $v_platform );
			$v_os		= string_display( $v_os );
			$v_os_build	= string_display( $v_os_build );

			if ( $v_id == $v_default_profile ) {
				PRINT "<option value=\"$v_id\" SELECTED>$v_platform $v_os $v_os_build</option>";
			} else {
				PRINT "<option value=\"$v_id\">$v_platform $v_os $v_os_build</option>";
			}
		}
	}
	# --------------------
	function print_news_project_option_list( $p_id ) {
		global 	$g_mantis_project_table, $g_mantis_project_user_list_table,
				$g_project_cookie;

		if ( access_level_check_greater_or_equal( ADMINISTRATOR ) ) {
			$query = "SELECT *
					FROM $g_mantis_project_table
					ORDER BY name";
		} else {
			$t_user_id = get_current_user_field( "id" );
			$query = "SELECT p.id, p.name
					FROM $g_mantis_project_table p, $g_mantis_project_user_list_table m
					WHERE 	p.id=m.project_id AND
							m.user_id='$t_user_id' AND
							p.enabled='1'";
		}
		$result = db_query( $query );
		$project_count = db_num_rows( $result );
		for ($i=0;$i<$project_count;$i++) {
			$row = db_fetch_array( $result );
			extract( $row, EXTR_PREFIX_ALL, "v" );

			if ( $v_id == $p_id ) {
				PRINT "<option value=\"$v_id\" SELECTED>$v_name</option>";
			} else {
				PRINT "<option value=\"$v_id\">$v_name</option>";
			}
		} # end for
	}
	# --------------------
	# Since categories can be orphaned we need to grab all unique instances of category
	# We check in the project category table and in the bug table
	# We put them all in one array and make sure the entries are unique
	function print_category_option_list( $p_category="" ) {
		global $g_mantis_bug_table, $g_mantis_project_category_table, $g_project_cookie_val;

		# grab all categories in the project category table
		$cat_arr = array();
		$query = "SELECT DISTINCT( category ) as category
				FROM $g_mantis_project_category_table
				WHERE project_id='$g_project_cookie_val'
				ORDER BY category";
		$result = db_query( $query );
		$category_count = db_num_rows( $result );
		for ($i=0;$i<$category_count;$i++) {
			$row = db_fetch_array( $result );
			$cat_arr[] = $row["category"];
		}
		sort( $cat_arr );
		$cat_arr = array_unique( $cat_arr );

		foreach( $cat_arr as $t_category ) {
			if ( $t_category == $p_category ) {
				PRINT "<option value=\"$t_category\" SELECTED>$t_category</option>";
			} else {
				PRINT "<option value=\"$t_category\">$t_category</option>";
			}
		}
	}
	# --------------------
	# Since categories can be orphaned we need to grab all unique instances of category
	# We check in the project category table and in the bug table
	# We put them all in one array and make sure the entries are unique
	function print_category_complete_option_list( $p_category="" ) {
		global $g_mantis_bug_table, $g_mantis_project_category_table, $g_project_cookie_val;

		# grab all categories in the project category table
		$cat_arr = array();
		$query = "SELECT DISTINCT( category ) as category
				FROM $g_mantis_project_category_table
				WHERE project_id='$g_project_cookie_val'
				ORDER BY category";
		$result = db_query( $query );
		$category_count = db_num_rows( $result );
		for ($i=0;$i<$category_count;$i++) {
			$row = db_fetch_array( $result );
			$cat_arr[] = $row["category"];
		}

		# grab all categories in the bug table
		$query = "SELECT DISTINCT( category ) as category
				FROM $g_mantis_bug_table
				WHERE project_id='$g_project_cookie_val'
				ORDER BY category";
		$result = db_query( $query );
		$category_count = db_num_rows( $result );

		for ($i=0;$i<$category_count;$i++) {
			$row = db_fetch_array( $result );
			$cat_arr[] = $row["category"];
		}
		sort( $cat_arr );
		$cat_arr = array_unique( $cat_arr );

		foreach( $cat_arr as $t_category ) {
			if ( $t_category == $p_category ) {
				PRINT "<option value=\"$t_category\" SELECTED>$t_category</option>";
			} else {
				PRINT "<option value=\"$t_category\">$t_category</option>";
			}
		}
	}
	# --------------------
	function print_category_option_listOLD( $p_category="" ) {
		global $g_mantis_project_category_table, $g_project_cookie_val;

		# @@@ not implemented yet
		if ( '0000000' == $g_project_cookie_val ) {
			$query = "SELECT category
					FROM $g_mantis_project_category_table
					WHERE project_id='$g_project_cookie_val'
					ORDER BY category";

		} else {
			$query = "SELECT category
					FROM $g_mantis_project_category_table
					WHERE project_id='$g_project_cookie_val'
					ORDER BY category";
		}

		$result = db_query( $query );
		$category_count = db_num_rows( $result );
		for ($i=0;$i<$category_count;$i++) {
			$row = db_fetch_array( $result );
			$t_category = $row["category"];
			if ( $t_category == $p_category ) {
				PRINT "<option value=\"$t_category\" SELECTED>$t_category</option>";
			} else {
				PRINT "<option value=\"$t_category\">$t_category</option>";
			}
		}
	}
	# --------------------
	function print_version_option_list( $p_version="" ) {
		global $g_mantis_project_version_table, $g_project_cookie_val;

		$query = "SELECT *
				FROM $g_mantis_project_version_table
				WHERE project_id='$g_project_cookie_val'
				ORDER BY date_order DESC";
		$result = db_query( $query );
		$version_count = db_num_rows( $result );
		for ($i=0;$i<$version_count;$i++) {
			$row = db_fetch_array( $result );
			$t_version = $row["version"];
			if ( $t_version == $p_version ) {
				PRINT "<option value=\"$t_version\" SELECTED>$t_version</option>";
			} else {
				PRINT "<option value=\"$t_version\">$t_version</option>";
			}
		}
	}
	# --------------------
	# select the proper enum values based on the input parameter
	# we use variable variables in order to achieve this
	function print_enum_string_option_list( $p_enum_name, $p_val=0 ) {
		$g_var = "g_".$p_enum_name."_enum_string";
		global $$g_var;

		$t_arr  = explode_enum_string( $$g_var );
		$enum_count = count( $t_arr );
		for ($i=0;$i<$enum_count;$i++) {
			$t_elem  = explode_enum_arr( $t_arr[$i] );
			$t_elem2 = get_enum_element( $p_enum_name, $t_elem[0] );
			if ( $t_elem[0] == $p_val ) {
				PRINT "<option value=\"$t_elem[0]\" SELECTED>$t_elem2</option>";
			} else {
				PRINT "<option value=\"$t_elem[0]\">$t_elem2</option>";
			}
		} # end for
	}
	# --------------------
	# prints the list of access levels exluding ADMINISTRATOR
	# this is used when adding users to projects
	function print_project_user_option_list( $p_val ) {
		global $g_mantis_project_table, $g_access_levels_enum_string;

		$t_arr = explode_enum_string( $g_access_levels_enum_string );
		$enum_count = count( $t_arr );
		for ($i=0;$i<$enum_count;$i++) {
			$t_elem = explode_enum_arr( $t_arr[$i] );

			if ( $t_elem[0] >= ADMINISTRATOR ) {
				continue;
			}

			$t_access_level = get_enum_element( "access_levels", $t_elem[0] );
			if ( $p_val == $t_elem[0] ) {
				PRINT "<option value=\"$t_elem[0]\" SELECTED>$t_access_level</option>";
			} else {
				PRINT "<option value=\"$t_elem[0]\">$t_access_level</option>";
			}
		} # end for
	}
	# --------------------
	function print_language_option_list( $p_language ) {
		global $g_language_choices_arr;

		$t_arr = $g_language_choices_arr;
		$enum_count = count( $t_arr );
		for ($i=0;$i<$enum_count;$i++) {
			if ( $t_arr[$i] == $p_language ) {
				PRINT "<option value=\"$t_arr[$i]\" SELECTED>$t_arr[$i]</option>";
			} else {
				PRINT "<option value=\"$t_arr[$i]\">$t_arr[$i]</option>";
			}
		} # end for
	}
	# --------------------
	# @@@ preliminary support for multiple bug actions.
	function print_all_bug_action_option_list() {
		$zook_arr[0] = "Move Bugs";
		$zook_arr[1] = "Assign";
		$zook_arr[3] = "Resolve";
		$zook_arr[4] = "Update Priority";
		$zook_arr[4] = "Update Status";

		$t_count = count( $zook_arr );
		for ($i=0;$i<$t_count;$i++) {
			PRINT "<option value=\""."\">".$zook_arr[$i]."</option>";
		}
	}
	# --------------------
	# list of users that are NOT in the specified project
	# if no project is specified use the current project
	function print_project_user_list_option_list( $p_project_id=0 ) {
		global	$g_mantis_project_user_list_table, $g_mantis_user_table,
				$g_project_cookie_val;

		if ( 0 == $p_project_id ) {
			$p_project_id = $g_project_cookie_val;
		}
		$t_adm = ADMINISTRATOR;
		$query = "SELECT DISTINCT u.id, u.username
				FROM $g_mantis_user_table u
				LEFT JOIN $g_mantis_project_user_list_table p
				ON p.user_id=u.id AND p.project_id='$p_project_id'
				WHERE u.access_level<$t_adm AND
					p.user_id IS NULL AND
					u.access_level<'$t_adm'
				ORDER BY u.username";
		$result = db_query( $query );
		$category_count = db_num_rows( $result );
		for ($i=0;$i<$category_count;$i++) {
			$row = db_fetch_array( $result );
			$t_username = $row["username"];
			$t_id = $row["id"];
			PRINT "<option value=\"$t_id\">$t_username</option>";
		}
	}
	# --------------------
	# list of projects that a user is NOT in
	function print_project_user_list_option_list2( $p_user_id ) {
		global	$g_mantis_project_user_list_table, $g_mantis_project_table;

		$t_prv = PRIVATE;
		$query = "SELECT DISTINCT p.id, p.name
				FROM $g_mantis_project_table p
				LEFT JOIN $g_mantis_project_user_list_table u
				ON p.id=u.project_id AND u.user_id='$p_user_id'
				WHERE p.enabled=1 AND
					p.view_state='$t_prv' AND
					u.user_id IS NULL
				ORDER BY p.name";
		$result = db_query( $query );
		$category_count = db_num_rows( $result );
		for ($i=0;$i<$category_count;$i++) {
			$row = db_fetch_array( $result );
			$t_project_name = $row["name"];
			$t_id = $row["id"];
			PRINT "<option value=\"$t_id\">$t_project_name</option>";
		}
	}
	# --------------------
	# list of projects that a user is NOT in
	function print_project_user_list( $p_user_id ) {
		global	$g_mantis_project_user_list_table, $g_mantis_project_table,
				$s_remove_link, $g_manage_user_proj_delete;

		$query = "SELECT DISTINCT p.id, p.name, p.view_state, u.access_level
				FROM $g_mantis_project_table p
				LEFT JOIN $g_mantis_project_user_list_table u
				ON p.id=u.project_id
				WHERE p.enabled=1 AND
					u.user_id='$p_user_id'
				ORDER BY p.name";
		$result = db_query( $query );
		$category_count = db_num_rows( $result );
		for ($i=0;$i<$category_count;$i++) {
			$row = db_fetch_array( $result );
			$t_project_id = $row["id"];
			$t_project_name = $row["name"];
			$t_view_state = $row["view_state"];
			$t_access_level = $row["access_level"];
			$t_access_level = get_enum_element( "access_levels", $t_access_level );
			$t_view_state = get_enum_element( "project_view_state", $t_view_state );
			PRINT "$t_project_name [$t_access_level] ($t_view_state) [<a class=\"small\" href=\"$g_manage_user_proj_delete?f_project_id=$t_project_id&f_user_id=$p_user_id\">$s_remove_link</a>]<br />";
		}
	}
	# --------------------
	###########################################################################
	# String printing API
	###########################################################################
	# --------------------
	# prints a link to a bug given an ID
	# it accounts for the user preference and site override
	function print_bug_link( $p_id ) {
		global 	$g_view_bug_page, $g_view_bug_advanced_page, $g_show_view;

		switch ( $g_show_view ) {
		case BOTH:
			if ( ON == get_current_user_pref_field( "advanced_view" ) ) {
				PRINT "<a href=\"$g_view_bug_advanced_page?f_id=$p_id\">$p_id</a>";
			} else {
				PRINT "<a href=\"$g_view_bug_page?f_id=$p_id\">$p_id</a>";
			}
			break;
		case SIMPLE_ONLY:
			PRINT "<a href=\"$g_view_bug_page?f_id=$p_id\">$p_id</a>";
			break;
		case ADVANCED_ONLY:
			PRINT "<a href=\"$g_view_bug_advanced_page?f_id=$p_id\">$p_id</a>";
			break;
		}
	}
	# --------------------
	# prints a link to the update page given an ID
	# it accounts for the user preference and site override
	function get_bug_update_page() {
		global 	$g_bug_update_page, $g_bug_update_advanced_page, $g_show_update;

		switch ( $g_show_update ) {
		case BOTH:
			if ( ON == get_current_user_pref_field( "advanced_update" ) ) {
				return $g_bug_update_advanced_page;
			} else {
				return $g_bug_update_page;
			}
			break;
		case SIMPLE_ONLY:
				return $g_bug_update_page;
			break;
		case ADVANCED_ONLY:
				return $g_bug_update_advanced_page;
			break;
		}
	}
	# --------------------
	# returns a href link to a bug given an ID
	# it accounts for the user preference and site override
	function get_bug_link( $p_id ) {
		global 	$g_view_bug_page, $g_view_bug_advanced_page, $g_show_view;

		switch ( $g_show_view ) {
		case BOTH:
			if ( ON == get_current_user_pref_field( "advanced_view" ) ) {
				return "<a href=\"$g_view_bug_advanced_page?f_id=$p_id\">$p_id</a>";
			} else {
				return "<a href=\"$g_view_bug_page?f_id=$p_id\">$p_id</a>";
			}
			break;
		case SIMPLE_ONLY:
			return "<a href=\"$g_view_bug_page?f_id=$p_id\">$p_id</a>";
			break;
		case ADVANCED_ONLY:
			return "<a href=\"$g_view_bug_advanced_page?f_id=$p_id\">$p_id</a>";
			break;
		}
	}
	# --------------------
	# returns a href link to a bug given an ID
	# it accounts for the user preference and site override
	function get_bug_link_plain( $p_id ) {
		global 	$g_view_bug_page, $g_view_bug_advanced_page, $g_show_view;

		switch ( $g_show_view ) {
		case BOTH:
			if ( ON == get_current_user_pref_field( "advanced_view" ) ) {
				return "$g_view_bug_advanced_page?f_id=$p_id";
			} else {
				return "$g_view_bug_page?f_id=$p_id";
			}
			break;
		case SIMPLE_ONLY:
			return "$g_view_bug_page?f_id=$p_id";
			break;
		case ADVANCED_ONLY:
			return "$g_view_bug_advanced_page?f_id=$p_id";
			break;
		}
	}
	# --------------------
	# formats the severity given the status
	# shows the severity in BOLD if the bug is NOT closed and is of significant severity
	function print_formatted_severity_string( $p_status, $p_severity ) {
		$t_sev_str = get_enum_element( "severity", $p_severity );
		if ( ( ( MAJOR == $p_severity ) ||
			   ( CRASH == $p_severity ) ||
			   ( BLOCK == $p_severity ) ) &&
			 ( CLOSED != $p_status ) ) {
			PRINT "<span class=\"bold\">$t_sev_str</span>";
		} else {
			PRINT "$t_sev_str";
		}
	}
	# --------------------
	function print_project_category_string( $p_project_id ) {
		global $g_mantis_project_category_table, $g_mantis_project_table;

		$query = "SELECT category
				FROM $g_mantis_project_category_table
				WHERE project_id='$p_project_id'
				ORDER BY category";
		$result = db_query( $query );
		$category_count = db_num_rows( $result );
		$t_string = "";

		for ($i=0;$i<$category_count;$i++) {
			$row = db_fetch_array( $result );
			$t_category = $row["category"];

			if ( $i+1 < $category_count ) {
				$t_string .= $t_category.", ";
			} else {
				$t_string .= $t_category;
			}
		}

		return $t_string;
	}
	# --------------------
	function print_project_version_string( $p_project_id ) {
		global $g_mantis_project_version_table, $g_mantis_project_table;

		$query = "SELECT version
				FROM $g_mantis_project_version_table
				WHERE project_id='$p_project_id'";
		$result = db_query( $query );
		$version_count = db_num_rows( $result );
		$t_string = "";

		for ($i=0;$i<$version_count;$i++) {
			$row = db_fetch_array( $result );
			$t_version = $row["version"];

			if ( $i+1 < $version_count ) {
				$t_string .= $t_version.", ";
			} else {
				$t_string .= $t_version;
			}
		}

		return $t_string;
	}
	# --------------------
	###########################################################################
	# Link Printing API
	###########################################################################
	# --------------------
	function print_view_bug_sort_link( $p_string, $p_sort_field, $p_sort, $p_dir ) {
		global $g_view_all_set;

		if ( $p_sort_field == $p_sort ) {
			# we toggle between ASC and DESC if the user clicks the same sort order
			if ( "ASC" == $p_dir ) {
				$p_dir = "DESC";
			} else {
				$p_dir = "ASC";
			}

			PRINT "<a href=\"$g_view_all_set?f_sort=$p_sort_field&f_dir=$p_dir&f_type=2\">$p_string</a>";
		} else {
			PRINT "<a href=\"$g_view_all_set?f_sort=$p_sort_field&f_dir=$p_dir&f_type=2\">$p_string</a>";
		}
	}
	# --------------------
	function print_view_bug_sort_link2( $p_string, $p_sort_field, $p_sort, $p_dir ) {
		global $g_view_all_set;

		if ( $p_sort_field == $p_sort ) {
			# we toggle between ASC and DESC if the user clicks the same sort order
			if ( "ASC" == $p_dir ) {
				$p_dir = "DESC";
			} else {
				$p_dir = "ASC";
			}

			PRINT "<a href=\"$g_view_all_set?f_sort=$p_sort_field&f_dir=$p_dir&f_type=2&f_print=1\">$p_string</a>";
		} else {
			PRINT "<a href=\"$g_view_all_set?f_sort=$p_sort_field&f_dir=$p_dir&f_type=2&f_print=1\">$p_string</a>";
		}
	}
	# --------------------
	function print_manage_user_sort_link(  $p_page, $p_string, $p_sort_field, $p_dir, $p_hide=0 ) {
		PRINT "<a href=\"$p_page?f_sort=$p_sort_field&f_dir=$p_dir&f_save=1&f_hide=$p_hide\">$p_string</a>";
	}
	# --------------------
	function print_manage_project_sort_link(  $p_page, $p_string, $p_sort_field, $p_dir ) {
		PRINT "<a href=\"$p_page?f_sort=$p_sort_field&f_dir=$p_dir\">$p_string</a>";
	}
	# --------------------
	# print the bracketed links used near the top
	# if the $p_link is blank then the text is printed but no link is created
	function print_bracket_link( $p_link, $p_url_text ) {
		if (empty( $p_link )) {
			PRINT "[ $p_url_text ]";
		} else {
			PRINT "[ <a href=\"$p_link\">$p_url_text</a> ]";
		}
	}
	# --------------------
	# print a mailto: href link
	function print_email_link( $p_email, $p_text ) {
		PRINT get_email_link($p_email,$p_text);
	}
	# --------------------
	# return the mailto: href string link instead of printing it
	function get_email_link( $p_email, $p_text ) {
		global $g_show_user_email, $g_anonymous_account;

		switch ( $g_show_user_email ) {
			case NONE:	return "$p_text";
			case ALL:	return "<a href=\"mailto:$p_email\">$p_text</a>";
			case NO_ANONYMOUS:	if ( get_current_user_field( "username" ) != $g_anonymous_account ) {
									return "<a href=\"mailto:$p_email\">$p_text</a>";
								} else {
									return "$p_text";
								}
			case ADMIN_ONLY:	if ( ADMINISTRATOR == get_current_user_field( "access_level" ) ) {
									return "<a href=\"mailto:$p_email\">$p_text</a>";
								} else {
									return "$p_text";
								}
			default:	return "$p_text";
		}
	}
	# --------------------
	# print a mailto: href link with subject
	function print_email_link_with_subject( $p_email, $p_text, $p_bug_id ) {
		global $g_mantis_bug_table;

		$t_subject = email_build_subject( $p_bug_id );
		PRINT get_email_link_with_subject( $p_email, $p_text, $t_subject );
	}
	# --------------------
	# return the mailto: href string link instead of printing it
	# add subject line
	function get_email_link_with_subject( $p_email, $p_text, $p_summary ) {
		global $g_show_user_email, $g_anonymous_account;

		switch ( $g_show_user_email ) {
			case NONE:	return "$p_text";
			case ALL:	return "<a href=\"mailto:$p_email?subject=$p_summary\">$p_text</a>";
			case NO_ANONYMOUS:	if ( get_current_user_field( "username" ) != $g_anonymous_account ) {
									return "<a href=\"mailto:$p_email?subject=$p_summary\">$p_text</a>";
								} else {
									return "$p_text";
								}
			case ADMIN_ONLY:	if ( ADMINISTRATOR == get_current_user_field( "access_level" ) ) {
									return "<a href=\"mailto:$p_email?subject=$p_summary\">$p_text</a>";
								} else {
									return "$p_text";
								}
			default:	return "$p_text";
		}
	}
	# --------------------
	# print our standard mysql query error
	# this function should rarely (if ever) be reached.  instead the db_()
	# functions should trap (altough inelegantly).
	function print_sql_error( $p_query ) {
		global $MANTIS_ERROR, $g_administrator_email, $s_administrator;

		PRINT $MANTIS_ERROR[ERROR_SQL];
		print_email_link( $g_administrator_email, $s_administrator );
		PRINT "<p>$p_query;<p>";
	}
	# --------------------
	###########################################################################
	# Filter API
	###########################################################################
	# --------------------
	# make http and mailto link urls
	function filter_href_tags( $p_string ) {
    	$p_string = eregi_replace( "([[:alnum:]]+)://([^[:space:]]*)([[:alnum:]#?/&=])",
    							"<a href=\"\\1://\\2\\3\">\\1://\\2\\3</a>",
    							$p_string);
        $p_string = eregi_replace( "(([a-z0-9_]|\\-|\\.)+@([^[:space:]]*)([[:alnum:]-]))",
        						"<a href=\"mailto:\\1\" target=\"_new\">\\1</a>",
        						$p_string);
		return $p_string;
	}
	# --------------------
	# undo http and mailto link urls for editing purposes
	function unfilter_href_tags( $p_string ) {
    	$p_string = eregi_replace( "<a href=\"([[:alnum:]]+)://([^[:space:]]*)([[:alnum:]#?/&=])\">([^[:space:]]*)([[:alnum:]#?/&=])</a>",
    							"\\1://\\2\\3",
    							$p_string);
        $p_string = eregi_replace( "<a href=\"mailto:(([a-z0-9_]|\\-|\\.)+@([^[:space:]]*)([[:alnum:]-]))\" target=\"_new\">(([a-z0-9_]|\\-|\\.)+@([^[:space:]]*)([[:alnum:]-]))</a>",
        						"\\1",
        						$p_string);
		return $p_string;
	}
	# --------------------
	# @@@ currently does nothing
	function filter_img_tags( $p_string ) {
		return $p_string;
	}
	# --------------------
	# process $g_html_tags to be treated as html
	function filter_html_tags( $p_string ) {
		global $g_html_tags;

		$t_filter_from 	= @array( "/\//", "/</", "/>/" );
		$t_filter_to 	= @array( "\/", "", "" );
		//$t_filter_from 	= @array( "\/", "<", ">" );
		//$t_filter_to 	= @array( "\/", "", "" );

		$t_tag_count = count( $g_html_tags );
		for ($i=0;$i<$t_tag_count;$i++) {
			$tag = preg_replace( $t_filter_from, $t_filter_to, $g_html_tags[$i] );

			$p_string = preg_replace( "/&lt;($tag)&gt;/i", "<\\1>", $p_string );
		}

		return $p_string;
	}
	# --------------------
	###########################################################################
	# String Processing API
	###########################################################################
	# --------------------
	# every string that comes form a textarea should be processed through this
	# function *before* insertion into the database.
	function string_prepare_textarea( $p_string ) {
		global $g_allow_href_tags, $g_allow_html_tags;

		$p_string = htmlspecialchars( $p_string );

		if ( ON == $g_allow_html_tags ) {
			$p_string = filter_html_tags( $p_string );
		}

		if ( ON == $g_allow_href_tags ) {
			$p_string = filter_href_tags( $p_string );
		}

		$p_string = filter_img_tags( $p_string );
		$p_string = addslashes( $p_string );
		return $p_string;
	}
	# --------------------
	# every string that comes form a text field should be processed through this
	# function *before* insertion into the database.
	function string_prepare_text( $p_string ) {
		global $g_allow_href_tags, $g_allow_html_tags;
		# the " breaks a text box when you go back to edit so we will convert
		# it here
		$p_string = str_replace( "\"", "'", $p_string );
		$p_string = htmlspecialchars( $p_string );

		if ( ON == $g_allow_html_tags ) {
			$p_string = filter_html_tags( $p_string );
		}

		if ( ON == $g_allow_href_tags ) {
			$p_string = filter_href_tags( $p_string );
		}

		$p_string = filter_img_tags( $p_string );
		$p_string = addslashes( $p_string );
		return $p_string;
	}
	# --------------------
	# Use this to prepare a string for display to HTML
	function string_display( $p_string ) {
		$p_string = stripslashes( $p_string );
		$p_string = process_bug_link( $p_string );
		$p_string = process_cvs_link( $p_string );
		$p_string = nl2br( $p_string );
		return $p_string;
	}
	# --------------------
	# Prepare a string for plain text display in email
	function string_email( $p_string ) {
		$p_string = stripslashes( $p_string );
		$p_string = unfilter_href_tags( $p_string );
		$p_string = process_bug_link_email( $p_string );
		$p_string = process_cvs_link_email( $p_string );
		$p_string = str_replace( "&lt;", "<",  $p_string );
		$p_string = str_replace( "&gt;", ">",  $p_string );
		$p_string = str_replace( "&quot;", "\"",  $p_string );
		$p_string = str_replace( "&amp;", "&",  $p_string );

		return $p_string;
	}
	# --------------------
	# Process a string for display in a textarea box
	function string_edit_textarea( $p_string ) {
		$p_string = stripslashes( $p_string );
		$p_string = str_replace( "<br>", "",  $p_string );
		$p_string = unfilter_href_tags( $p_string );
		$p_string = str_replace( "<br />", "\n",  $p_string );
		$p_string = str_replace( "&lt;", "<",  $p_string );
		$p_string = str_replace( "&gt;", ">",  $p_string );
		$p_string = str_replace( "&quot;", "\"",  $p_string );
		return $p_string;
	}
	# --------------------
	# Process a string for display in a text box
	function string_edit_text( $p_string ) {
		$p_string = stripslashes( $p_string );
		$p_string = str_replace( "<br>", "",  $p_string );
		$p_string = unfilter_href_tags( $p_string );
		$p_string = str_replace( "&lt;", "<",  $p_string );
		$p_string = str_replace( "&gt;", ">",  $p_string );
		$p_string = str_replace( "&quot;", "'",  $p_string );
		return $p_string;
	}
	# --------------------
	###########################################################################
	# Miscellaneous String Functions API
	###########################################################################
	# --------------------
	# duplicates str_pad() from PHP4
	# left pad $p_string with $p_pad until we reach $p_length
	function str_pd( $p_string, $p_pad, $p_length, $p_dir=STR_PAD_RIGHT ) {
		$t_num = $p_length - strlen( $p_string );
		for ($i=0;$i<$t_num;$i++) {
			switch ( $p_dir ) {
				case STR_PAD_LEFT: $p_string = $p_pad.$p_string;
									break;
				case STR_PAD_RIGHT: $p_string = $p_string.$p_pad;
									break;
			}
		}
		return $p_string;
	}
	# --------------------
	/* wordwrap($string, $cols, $prefix)
	 *
	 * Takes $string, and wraps it on a per-word boundary (does not clip
	 * words UNLESS the word is more than $cols long), no more than $cols per
	 * line. Allows for optional prefix string for each line. (Was written to
	 * easily format replies to e-mails, prefixing each line with "> ".
	 *
	 * Copyright 1999 Dominic J. Eidson, use as you wish, but give credit
	 * where credit due.
	 */
	if ( !function_exists( "wordwrap" ) ) {
		function wordwrap ($string, $cols = 72, $prefix = "") {

			$t_lines = split( "\n", $string);
			$outlines = "";

			while(list(, $thisline) = each($t_lines)) {
				if(strlen($thisline) > $cols) {

					$newline = "";
					$t_l_lines = split(" ", $thisline);

					while(list(, $thisword) = each($t_l_lines)) {
						while((strlen($thisword) + strlen($prefix)) > $cols) {
							$cur_pos = 0;
							$outlines .= $prefix;

							for($num=0; $num < $cols-1; $num++) {
							    $outlines .= $thisword[$num];
							    $cur_pos++;
							} # end for

							$outlines .= "\n";
							$thisword = substr($thisword, $cur_pos, (strlen($thisword)-$cur_pos));
						} # end innermost while

						if((strlen($newline) + strlen($thisword)) > $cols) {
							$outlines .= $prefix.$newline."\n";
							$newline = $thisword." ";
						} else {
							$newline .= $thisword." ";
						}
					}  # end while

					$outlines .= $prefix.$newline."\n";
			    } else {
					$outlines .= $prefix.$thisline."\n";
				}
			} # end outermost while
			return $outlines;
		}
	}
	# --------------------
?>