<?php
/**
* 
*/

/**
* 
*/
class CJT_Framework_Developer_Interface_Block_Shortcode_Parameters_Parameters
extends CJT_Framework_Developer_Interface_Block_Parameters_Parameters {

	/**
	* Block programming interface (BPI).
	* 
	* @param mixed $name
	*/
	public function get($name) {
		// Initialize.
		$value = NULL;
		// Get param key from the given name.
		$key = strtolower($name);
		if (!isset($this->params[$key])) {
			echo cssJSToolbox::getText("Parameter {$name} is not found!");
		}
		else {
			$value = $this->params[$key]->getValue();
		}
		// Allow writing it in the original case inside the code
		// however its only retrived by the lowercvase letter.
		return $value;
	}

	/**
	* put your comment there...
	* 
	*/
	protected function getFactory() {
		return new CJT_Framework_Developer_Interface_Block_Shortcode_Parameters_Factory();
	}
	
	/**
	* put your comment there...
	* 
	* @param mixed $strings
	* @param mixed $content
	* @return CJT_Framework_Developer_Interface_Block_Shortcode_Parameters_Parameters
	*/
	public function loadString($strings, $content) {
		// Get the name of the CONTENT PARAMETER -- If EXISTS!
		// THEN PUSH IT AS ITS PASSED AS SHORTCODR ATTRIBUTE.
		if ($contentParameter = $this->getContentParameter()) {
			$strings[$contentParameter->getDefinition()->getName(true)] = $content;
		}
		// Load all parameters with shortcde parameters.
		foreach ($this->getParams() as $name => $param) {
			// Dont override default value unless parameter is passed!
			if (isset($strings[$name])) {
				$param->loadString($strings[$name]);
			}
			// Validate type!                                                                                                                                           
			if (!$param->validate()) {
				echo cssJSToolbox::getText("Invalid Shortcode parameter: {$type->getMessage()}");
			}
			// Remove the value from the stringsValue allow validating if 
			// any invalid parameter name is passed!
			// See after the loop.
			unset($strings[$name]);
		}
		// If there is any string values still exists then invalid parameter is passed.
		if (!empty($strings)) {
			echo cssJSToolbox::getText("Invalid Shortcode parameter(s) has been passed! Please check parameters name.");
		}
		return $this;
	}

	/**
	* put your comment there...
	* 
	* @param mixed $excludes
	* @param array Parameters to include (Will be merged to params)
	* @return string JSON of the parameters list.
	*/
	public function json($excludes = null, $includes = null) {
		// Initialize.
		$params = array();
		$json = '';
		// Build exclude list.
		$excludes = explode(',', $excludes);
		// Get all parameters.
		foreach ($this->getParams() as $name => $param) {
			// Process only parameters not in the eexclude list.
			if (!in_array($name, $excludes)) {
				$definition = $param->getDefinition();
				// Get parameter real name.
				$realName = $definition->getName();
				// Don't use optional parameters with no values passed.
				$value = $param->getValue(true);
				$isOptional = !$definition->getRequired();
				if ($isOptional) {
					$stack = array($value);
					do {
						// Get current value.
						$current = array_shift($stack);
						// Add to process later.
						if (!is_scalar($current)) {
							$stack += (array) $current;
						}
						// Once a non-empty value is found use it!
						else if ($current) {
							$params[$realName] = $value;
							break; // Exit the loop!
						}
					} while (!empty($stack));
				}
				else {
					$params[$realName] = $value;
				}
			}
		}
		// Merge INCLUDE List!
		$includes && ($params = array_merge($params, $includes));
		// Get JSON.
		$json = json_encode($params);
		// Returns.
		return $json;
	}

	/**
	* put your comment there...
	* 
	* @param mixed $blockName
	*/
	public function shortcode($blockName) {
		// Initialize.
		$shortcode = "[cjtoolbox name='{$blockName}'\n\t\t%s]%s\n[/cjtoolbox]";
		$shortcodeContent = '';
		$params = $this->getParams();
		$attributes = array();		
		// Process all parameters except of the Shortcode Content parameter.
		if ($contentParameter = $this->getContentParameter()) {
			// Remove it from the list as it will be added as content rather than attribute.
			unset($params[$contentParameter->getDefinition()->getName(true)]);	
			// Get Content Parameter data.
			$shortcodeContent = $contentParameter->getValue();
		}
		// Aggregate all parameters strings in one array!
		foreach ($params as $param) {
			$attributes[] = $param->shortcode();
		}
		// Join with a TAB character + Add Content Parameter!
		return sprintf($shortcode, join("\t\t\n", $attributes), $shortcodeContent);
	}

} // End class