<?php
/*=====================================================================*\
|| ################################################################### ||
|| # Bugdar [#]version[#]
|| # --------------------------------------------------------------- # ||
|| # Copyright Š2002-[#]year[#] by Iris Studios, Inc. All Rights Reserved. # ||
|| # This file may not be reproduced in any way without permission.  # ||
|| # --------------------------------------------------------------- # ||
|| # User License Agreement at http://www.iris-studios.com/license/  # ||
|| ################################################################### ||
\*=====================================================================*/

class History
{
	/**
	* Bug ID
	* @var	integer
	*/
	var $bugid = 0;
	
	/**
	* Attachment ID
	* @var	integer
	*/
	var $attachmentid = 0;
	
	/**
	* Comment ID
	* @var	integer
	*/
	var $commentid = 0;
	
	/**
	* Allow diff's that have an empty result (no change)
	* @var	bool
	*/
	var $allowempty = false;
	
	/**
	* Logs a field change into the database
	*
	* @param	array	Diff data produced by diff()
	*/
	function log($diffdata = null)
	{
		global $bugsys;
		
		$this->bugid = intval($this->bugid);
		$this->attachmentid = intval($this->attachmentid);
		$this->commentid = intval($this->commentid);
		
		if ($diffdata == -1)
		{
			return;
		}
		
		if (!$diffdata)
		{
			return;
		}

		$bugsys->db->query("
			INSERT INTO " . TABLE_PREFIX . "history
				(bugid, attachmentid, commentid, dateline, userid, field, original, changed)
			VALUES
				(" . $this->bugid . ", " . $this->attachmentid . ", " . $this->commentid . ", " . TIMENOW . ",
				" . $bugsys->userinfo['userid'] . ", '" . $bugsys->escape($diffdata['field']) . "', 
				'" . $bugsys->escape($diffdata['initial']) . "', '" . $bugsys->escape($diffdata['final']) . "'
			)"
		);
	}
	
	/**
	* Compares two values and creates a report of their differences
	*
	* @param	string	Name of the field
	* @param	mixed	Initial value
	* @param	mixed	Final value
	*
	* @return	array	Difference report
	*/
	function diff($field, $initial, $final)
	{
		$field = trim($field);
		$initial = trim($initial);
		$final = trim($final);
		
		if (empty($field))
		{
			return -1;
		}
		
		if (empty($initial) AND empty($final))
		{
			if (!$this->allowempty)
			{
				return -1;
			}
		}
		
		if (!$this->allowempty)
		{
			if ($initial === $final)
			{
				return -1;
			}
		}
		
		return array('field' => $field, 'initial' => $initial, 'final' => $final);
	}
}

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