<?php
/*=====================================================================*\
|| ###################################################################
|| # Bugdar [#]version[#]
|| # Copyright Š2002-[#]year[#] Iris Studios, Inc.
|| #
|| # This program 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; version [#]gpl[#] of the License.
|| #
|| # This program 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 this program; if not, write to the Free Software Foundation, Inc.,
|| # 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA
|| ###################################################################
\*=====================================================================*/

/**
* Bug Change Logging
*
* This class is used to record changes in a bug's fields, comments, and
* attachments.
*
* @author		Iris Studios, Inc.
* @copyright	Copyright Š2002 - [#]year[#], Iris Studios, Inc.
* @version		$Revision$
* @package		Bugdar
* 
*/
class Logging
{
	/**
	* Bug ID
	* @var	integer
	* @access	private
	*/
	var $bugid = 0;
	
	/**
	* The original data to compare against
	* @var	array
	* @access	private
	*/
	var $original = array();
	
	/**
	* Modified data
	* @var	array
	* @access	private
	*/
	var $modified = array();
	
	// ###################################################################
	/**
	* Sets the bug ID for the current logging instance
	*
	* @access	public
	*
	* @param	integer	New bug ID
	*/
	function set_bugid($newbugid)
	{
		$this->bugid = $newbugid;
	}
	
	// ###################################################################
	/**
	* Assigns data into the $this->original or $this->modified array based
	* on the passed arrays of information and the fields to add (and what
	* name to add them under), the element they go into, and any prefix
	*
	* @access	public
	*
	* @param	bool	TRUE for original, FALSE for modified
	* @param	array	Data array
	* @param	array	List of fields in the data array to add; in format of array('field name' => 'display name', 'display name 2', 'display name 3')
	* @param	string	Element to add to
	* @param	string	Field prefix
	*/
	function add_data($orig, $data, $fields, $element = '', $prefix = '')
	{
		$array = ($orig ? 'original' : 'modified');
		$prefix .= ($prefix != '' ? '.' : '');
		
		foreach ($fields AS $fname => $fdisplay)
		{
			if (is_numeric($fname))
			{
				$fname = $fdisplay;
			}
			
			$this->{$array}["$element"]["$prefix$fdisplay"] = $data["$fname"];
		}
	}
	
	// ###################################################################
	/**
	* Adds strings to the IDs so that it's human-readable and that's
	* stored in the database so that if whatever value is deleted,
	* the text still exists in the end. This takes the element and a list
	* of fields to prossess in order to work.
	*
	* @access	public
	*
	* @param	string	Element name
	* @param	array	List of fields to use
	*/
	function process_fields($element, $fields)
	{
		foreach (array('original', 'modified') AS $array)
		{
			foreach ($this->{$array}["$element"] AS $display => $fname)
			{
				if (in_array($fname, $fields))
				{
					
				}
			}
		}
	}
}

/*=====================================================================*\
|| ###################################################################
|| # $HeadURL$
|| # $Id$
|| ###################################################################
\*=====================================================================*/
?>