TrackManiaControl/application/core/Libs/FML/CustomUI.php

<?php

namespace FML;

/**
 * Class representing a Custom_UI
 *
 * @author    steeffeen
 * @copyright FancyManiaLinks Copyright © 2014 Steffen Schröder
 * @license   http://www.gnu.org/licenses/ GNU General Public License, Version 3
 */
class CustomUI {
	/*
	 * Protected Properties
	 */
	protected $encoding = 'utf-8';
	protected $tagName = 'custom_ui';
	protected $noticeVisible = null;
	protected $challengeInfoVisible = null;
	protected $netInfosVisible = null;
	protected $chatVisible = null;
	protected $checkpointListVisible = null;
	protected $roundScoresVisible = null;
	protected $scoretableVisible = null;
	protected $globalVisible = null;

	/**
	 * Create a new CustomUI Object
	 *
	 * @return \FML\CustomUI
	 */
	public static function create() {
		$customUI = new CustomUI();
		return $customUI;
	}

	/**
	 * Construct a new CustomUI Object
	 */
	public function __construct() {
	}

	/**
	 * Set XML Encoding
	 *
	 * @param string $encoding XML Encoding
	 * @return \FML\CustomUI
	 */
	public function setXMLEncoding($encoding) {
		$this->encoding = (string)$encoding;
		return $this;
	}

	/**
	 * Set Showing of Notices
	 *
	 * @param bool $visible Whether Notices should be shown
	 * @return \FML\CustomUI
	 */
	public function setNoticeVisible($visible) {
		$this->noticeVisible = $visible;
		return $this;
	}

	/**
	 * Set Showing of the Challenge Info
	 *
	 * @param bool $visible Whether the Challenge Info should be shown
	 * @return \FML\CustomUI
	 */
	public function setChallengeInfoVisible($visible) {
		$this->challengeInfoVisible = $visible;
		return $this;
	}

	/**
	 * Set Showing of the Net Infos
	 *
	 * @param bool $visible Whether the Net Infos should be shown
	 * @return \FML\CustomUI
	 */
	public function setNetInfosVisible($visible) {
		$this->netInfosVisible = $visible;
		return $this;
	}

	/**
	 * Set Showing of the Chat
	 *
	 * @param bool $visible Whether the Chat should be shown
	 * @return \FML\CustomUI
	 */
	public function setChatVisible($visible) {
		$this->chatVisible = $visible;
		return $this;
	}

	/**
	 * Set Showing of the Checkpoint List
	 *
	 * @param bool $visible Whether the Checkpoint should be shown
	 * @return \FML\CustomUI
	 */
	public function setCheckpointListVisible($visible) {
		$this->checkpointListVisible = $visible;
		return $this;
	}

	/**
	 * Set Showing of Round Scores
	 *
	 * @param bool $visible Whether the Round Scores should be shown
	 * @return \FML\CustomUI
	 */
	public function setRoundScoresVisible($visible) {
		$this->roundScoresVisible = $visible;
		return $this;
	}

	/**
	 * Set Showing of the Scoretable
	 *
	 * @param bool $visible Whether the Scoretable should be shown
	 * @return \FML\CustomUI
	 */
	public function setScoretableVisible($visible) {
		$this->scoretableVisible = $visible;
		return $this;
	}

	/**
	 * Set Global Showing
	 *
	 * @param bool $visible Whether the UI should be disabled completely
	 * @return \FML\CustomUI
	 */
	public function setGlobalVisible($visible) {
		$this->globalVisible = $visible;
		return $this;
	}

	/**
	 * Render the XML Document
	 *
	 * @param \DOMDocument $domDocument (optional) DomDocument for which the XML Element should be rendered
	 * @return \DOMDocument
	 */
	public function render($domDocument = null) {
		$isChild = (bool)$domDocument;
		if (!$isChild) {
			$domDocument                = new \DOMDocument('1.0', $this->encoding);
			$domDocument->xmlStandalone = true;
		}
		$xmlElement = $domDocument->createElement($this->tagName);
		if (!$isChild) {
			$domDocument->appendChild($xmlElement);
		}
		$settings = $this->getSettings();
		foreach ($settings as $setting => $value) {
			if ($value === null) {
				continue;
			}
			$xmlSubElement = $domDocument->createElement($setting);
			$xmlSubElement->setAttribute('visible', ($value ? 1 : 0));
			$xmlElement->appendChild($xmlSubElement);
		}
		if ($isChild) {
			return $xmlElement;
		}
		return $domDocument;
	}

	/**
	 * Get String Representation
	 *
	 * @return string
	 */
	public function __toString() {
		$domDocument = $this->render();
		$xmlText     = $domDocument->saveXML();
		return $xmlText;
	}

	/**
	 * Get associative Array of all CustomUI Settings
	 *
	 * @return array
	 */
	protected function getSettings() {
		$settings                    = array();
		$settings['challenge_info']  = $this->challengeInfoVisible;
		$settings['chat']            = $this->chatVisible;
		$settings['checkpoint_list'] = $this->checkpointListVisible;
		$settings['global']          = $this->globalVisible;
		$settings['net_infos']       = $this->netInfosVisible;
		$settings['notice']          = $this->noticeVisible;
		$settings['round_scores']    = $this->roundScoresVisible;
		$settings['scoretable']      = $this->scoretableVisible;
		return $settings;
	}
}