<?php

/**
 * @file ConferenceDAO.inc.php
 *
 * Copyright (c) 2000-2008 John Willinsky
 * Distributed under the GNU GPL v2. For full terms see the file docs/COPYING.
 *
 * @package conference
 * @class ConferenceDAO
 *
 * Class for Conference DAO.
 * Operations for retrieving and modifying Conference objects.
 *
 * $Id: ConferenceDAO.inc.php,v 1.9 2008/04/04 17:06:45 asmecher Exp $
 */

import ('conference.Conference');

class ConferenceDAO extends DAO {
	/**
	 * Retrieve a conference by ID.
	 * @param $conferenceId int
	 * @return Conference
	 */
	function &getConference($conferenceId) {
		$result = &$this->retrieve(
			'SELECT * FROM conferences WHERE conference_id = ?', $conferenceId
		);

		$returner = null;
		if ($result->RecordCount() != 0) {
			$returner = &$this->_returnConferenceFromRow($result->GetRowAssoc(false));
		}
		$result->Close();
		unset($result);
		return $returner;
	}

	/**
	 * Retrieve a conference by path.
	 * @param $path string
	 * @return Conference
	 */
	function &getConferenceByPath($path) {
		$returner = null;
		$result = &$this->retrieve(
			'SELECT * FROM conferences WHERE path = ?', $path
		);

		if ($result->RecordCount() != 0) {
			$returner = &$this->_returnConferenceFromRow($result->GetRowAssoc(false));
		}
		$result->Close();
		unset($result);
		return $returner;
	}

	/**
	 * Internal function to return a Conference object from a row.
	 * @param $row array
	 * @return Conference
	 */
	function &_returnConferenceFromRow(&$row) {
		$conference = &new Conference();
		$conference->setConferenceId($row['conference_id']);
		$conference->setPath($row['path']);
		$conference->setSequence($row['seq']);
		$conference->setEnabled($row['enabled']);
		$conference->setPrimaryLocale($row['primary_locale']);

		HookRegistry::call('ConferenceDAO::_returnConferenceFromRow', array(&$conference, &$row));

		return $conference;
	}

	/**
	 * Insert a new conference.
	 * @param $conference Conference
	 */	
	function insertConference(&$conference) {
		$this->update(
			'INSERT INTO conferences
				(primary_locale, path, seq, enabled)
				VALUES
				(?, ?, ?, ?)',
			array(
				$conference->getPrimaryLocale(),
				$conference->getPath(),
				$conference->getSequence() == null ? 0 : $conference->getSequence(),
				$conference->getEnabled() ? 1 : 0
			)
		);

		$conference->setConferenceId($this->getInsertConferenceId());
		return $conference->getConferenceId();
	}

	/**
	 * Update an existing conference.
	 * @param $conference Conference
	 */
	function updateConference(&$conference) {
		return $this->update(
			'UPDATE conferences
				SET
					primary_locale = ?,
					path = ?,
					seq = ?,
					enabled = ?
				WHERE conference_id = ?',
			array(
				$conference->getPrimaryLocale(),
				$conference->getPath(),
				$conference->getSequence(),
				$conference->getEnabled() ? 1 : 0,
				$conference->getConferenceId()
			)
		);
	}

	/**
	 * Delete a conference, INCLUDING ALL DEPENDENT ITEMS.
	 * @param $conference Conference
	 */
	function deleteConference(&$conference) {
		return $this->deleteConferenceById($conference->getConferenceId());
	}

	/**
	 * Delete a conference by ID, INCLUDING ALL DEPENDENT ITEMS.
	 * @param $conferenceId int
	 */
	function deleteConferenceById($conferenceId) {
		$conferenceSettingsDao = &DAORegistry::getDAO('ConferenceSettingsDAO');
		$conferenceSettingsDao->deleteSettingsByConference($conferenceId);

		$emailTemplateDao = &DAORegistry::getDAO('EmailTemplateDAO');
		$emailTemplateDao->deleteEmailTemplatesByConference($conferenceId);

		$rtDao = &DAORegistry::getDAO('RTDAO');
		$rtDao->deleteVersionsByConference($conferenceId);

		$roleDao = &DAORegistry::getDAO('RoleDAO');
		$roleDao->deleteRoleByConferenceId($conferenceId);

		$groupDao = &DAORegistry::getDAO('GroupDAO');
		$groupDao->deleteGroupsByConferenceId($conferenceId);

		$pluginSettingsDao = &DAORegistry::getDAO('PluginSettingsDAO');
		$pluginSettingsDao->deleteSettingsByConferenceId($conferenceId);

		$announcementDao = &DAORegistry::getDAO('AnnouncementDAO');
		$announcementDao->deleteAnnouncementsByConference($conferenceId);

		$announcementTypeDao =& DAORegistry::getDAO('AnnouncementTypeDAO');
		$announcementTypeDao->deleteAnnouncementTypesByConference($conferenceId);

		$schedConfDao = &DAORegistry::getDAO('SchedConfDAO');
		$schedConfDao->deleteSchedConfsByConferenceId($conferenceId);

		return $this->update(
			'DELETE FROM conferences WHERE conference_id = ?', $conferenceId
		);
	}

	/**
	 * Retrieve all conferences.
	 * @return DAOResultFactory containing matching conferences
	 */
	function &getConferences($rangeInfo = null) {
		$result = &$this->retrieveRange(
			'SELECT * FROM conferences ORDER BY seq',
			false, $rangeInfo
		);

		$returner = &new DAOResultFactory($result, $this, '_returnConferenceFromRow');
		return $returner;
	}

	/**
	 * Retrieve all enabled conferences
	 * @return array Conferences ordered by sequence
	 */
	function &getEnabledConferences() {
		$result = &$this->retrieve(
			'SELECT * FROM conferences WHERE enabled=1 ORDER BY seq'
		);

		$resultFactory = &new DAOResultFactory($result, $this, '_returnConferenceFromRow');
		return $resultFactory;
	}

	/**
	 * Retrieve the IDs and titles of all conferences in an associative array.
	 * @return array
	 */
	function &getConferenceTitles() {
		$conferences = array();
		$conferenceIterator =& $this->getConferences();
		while ($conference =& $conferenceIterator->next()) {
			$conferences[$conference->getConferenceId()] = $conference->getConferenceTitle();
			unset($conference);
		}
		return $conferences;
	}

	/**
	 * Retrieve enabled conference IDs and titles in an associative array
	 * @return array
	 */
	function &getEnabledConferenceTitles() {
		$conferences = array();
		$conferenceIterator =& $this->getEnabledConferences();
		while ($conference =& $conferenceIterator->next()) {
			$conferences[$conference->getConferenceId()] = $conference->getConferenceTitle();
			unset($conference);
		}
		return $conferences;
	}

	/**
	 * Check if a conference exists with a specified path.
	 * @param $path the path of the conference
	 * @return boolean
	 */
	function conferenceExistsByPath($path) {
		$result = &$this->retrieve(
			'SELECT COUNT(*) FROM conferences WHERE path = ?', $path
		);
		$returner = isset($result->fields[0]) && $result->fields[0] == 1 ? true : false;

		$result->Close();
		unset($result);

		return $returner;
	}

	/**
	 * Sequentially renumber conferences in their sequence order.
	 */
	function resequenceConferences() {
		$result = &$this->retrieve(
			'SELECT conference_id FROM conferences ORDER BY seq'
		);

		for ($i=1; !$result->EOF; $i++) {
			list($conferenceId) = $result->fields;
			$this->update(
				'UPDATE conferences SET seq = ? WHERE conference_id = ?',
				array(
					$i,
					$conferenceId
				)
			);

			$result->moveNext();
		}

		$result->close();
		unset($result);
	}

	/**
	 * Get the ID of the last inserted conference.
	 * @return int
	 */
	function getInsertConferenceId() {
		return $this->getInsertId('conferences', 'conference_id');
	}
}

?>