<?php

/**
 * Calendar Solution's parent class for viewing and editing a specific event
 *
 * @package CalendarSolution
 * @author Daniel Convissor <hide@address.com>
 * @copyright The Analysis and Solutions Company, 2002-2012
 * @license http://www.analysisandsolutions.com/software/license.htm Simple Public License
 */

/**
 * The parent class for viewing and editing a specific event
 *
 * @package CalendarSolution
 * @author Daniel Convissor <hide@address.com>
 * @copyright The Analysis and Solutions Company, 2002-2012
 * @license http://www.analysisandsolutions.com/software/license.htm Simple Public License
 */
abstract class CalendarSolution_Detail extends CalendarSolution {
	/**
	 * Converts a bitwise number into an array of values that are a power of 2
	 *
	 * @param int $in  the number to convert
	 *
	 * @return array  the array of converted information
	 */
	protected function get_array_from_bitwise($in) {
		if (is_array($in)) {
			return $in;
		}

		$in = (int) $in;
		$out = array();
		for ($i = 1; $i <= $in; $i *= 2) {
			if ($in & $i) {
				$out[] = $i;
			}
		}
		return $out;
	}

	/**
	 * Converts array values to a bitwise value
	 *
	 * @param array $in  the array of integers to convert
	 *
	 * @return int  the sum of the individual values
	 */
	protected function get_bitwise_from_array($in) {
		if (!is_array($in)) {
			return null;
		}
		return array_sum($in);
	}

	/**
	 * Assembles the query string, executes it and stores the result in
	 * $this->data
	 *
	 * @param int $calendar_id  the id number of the item to get (defaults to
	 *                          $_REQUEST['calendar_id'])
	 * @return void
	 *
	 * @uses SQLSolution_General::RunQuery()  to access the database
	 * @uses CalendarSolution::get_int_from_request()  to determine the
	 *       user's intention
	 *
	 * @throws CalendarSolution_Exception on an invalid $calendar_id or if
	 *         no matching record is found
	 */
	protected function run_query($calendar_id = null) {
		if ($calendar_id === null) {
			$calendar_id = $this->get_int_from_request('calendar_id');
		}

		if (empty($calendar_id)
			|| !preg_match('/^\d{1,10}$/', $calendar_id))
		{
			throw new CalendarSolution_Exception('Invalid $calendar_id');
		}

		$this->sql->SQLQueryString = "SELECT
			calendar_id,
			calendar_uri,
			category,
			cs_calendar.category_id AS category_id,
			changed,
			date_start,
			detail,
			COALESCE(calendar_uri, frequent_event_uri) AS display_uri,
			feature_on_page_id,
			cs_calendar.frequent_event_id AS frequent_event_id,
			frequent_event_uri,
			is_own_event,
			list_link_goes_to_id,
			location_start,
			note,
			status,
			cs_calendar.status_id,
			summary,
			time_end,
			time_start,
			title
			FROM cs_calendar
			LEFT JOIN cs_frequent_event USING (frequent_event_id)
			LEFT JOIN cs_status
				ON (cs_status.status_id = cs_calendar.status_id)
			LEFT JOIN cs_category
				ON (cs_category.category_id = cs_calendar.category_id)
			WHERE calendar_id = $calendar_id";

		$this->sql->RunQuery(__FILE__, __LINE__);

		if ($this->sql->SQLRecordSetRowCount == 0) {
			throw new CalendarSolution_Exception('No events match your criteria');
		}
	}

	/**
	 * Populates $this->data with a record from the database
	 *
	 * @param int $calendar_id  the id number of the item to get
	 *
	 * @return void
	 *
	 * @uses CalendarSolution::$data  to hold the data
	 */
	public function set_data_from_query($calendar_id = null,
		$safe_markup = true, $escape_html = true)
	{
		$this->run_query($calendar_id);

		$original_safe_markup = $this->sql->SQLSafeMarkup;
		$original_escape_html = $this->sql->SQLEscapeHTML;

		$this->sql->SQLSafeMarkup = $safe_markup ? 'Y' : 'N';
		$this->sql->SQLEscapeHTML = $escape_html ? 'Y' : 'N';

		$this->data = $this->sql->RecordAsAssocArray(__FILE__, __LINE__,
			array('display_uri'));
		$this->data['set_from'] = 'query';

		$this->sql->SQLSafeMarkup = $original_safe_markup;
		$this->sql->SQLEscapeHTML = $original_escape_html;
	}
}