<?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
|| ###################################################################
\*=====================================================================*/

/*
A USEFUL QUERY:

DELETE FROM history WHERE field IN ('lastposttime', 'lastpostby', 'hiddenlastposttime', 'hiddenlastpostby')

*/

/**
* 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	bool	If TRUE, then the list of fields is used to exclude, not include
	* @param	string	Element to add to
	* @param	string	Field prefix
	*/
	function add_data($orig, $data, $fields, $exclude = false, $element = '', $prefix = '')
	{
		$array = ($orig ? 'original' : 'modified');
		$prefix .= '.';
		
		if ($exclude == false)
		{
			foreach ($fields AS $fname => $fdisplay)
			{
				if (is_numeric($fname))
				{
					$fname = $fdisplay;
				}
				
				$this->{$array}["$element"]["$prefix$fdisplay"] = array('name' => $fname, 'value' => $data["$fname"]);
			}
		}
		else
		{
			foreach ($data AS $fname => $value)
			{
				if (!in_array($fname, $fields))
				{
					$this->{$array}["$element"]["$prefix$fname"] = array('name' => $fname, 'value' => $value);
				}
			}
		}
	}
}

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