<?php

/**

 * CodeIgniter

 *

 * An open source application development framework for PHP

 *

 * This content is released under the MIT License (MIT)

 *

 * Copyright (c) 2014 - 2017, British Columbia Institute of Technology

 *

 * Permission is hereby granted, free of charge, to any person obtaining a copy

 * of this software and associated documentation files (the "Software"), to deal

 * in the Software without restriction, including without limitation the rights

 * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell

 * copies of the Software, and to permit persons to whom the Software is

 * furnished to do so, subject to the following conditions:

 *

 * The above copyright notice and this permission notice shall be included in

 * all copies or substantial portions of the Software.

 *

 * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR

 * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,

 * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE

 * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER

 * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,

 * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN

 * THE SOFTWARE.

 *

 * @package	CodeIgniter

 * @author	EllisLab Dev Team

 * @copyright	Copyright (c) 2008 - 2014, EllisLab, Inc. (https://ellislab.com/)

 * @copyright	Copyright (c) 2014 - 2017, British Columbia Institute of Technology (http://bcit.ca/)

 * @license	http://opensource.org/licenses/MIT	MIT License

 * @link	https://codeigniter.com

 * @since	Version 1.0.0

 * @filesource

 */

defined('BASEPATH') OR exit('No direct script access allowed');



/**

 * Jquery Class

 *

 * @package		CodeIgniter

 * @subpackage	Libraries

 * @category	Loader

 * @author		EllisLab Dev Team

 * @link		https://codeigniter.com/user_guide/libraries/javascript.html

 */

class CI_Jquery extends CI_Javascript {



	/**

	 * JavaScript directory location

	 *

	 * @var	string

	 */

	protected $_javascript_folder = 'js';



	/**

	 * JQuery code for load

	 *

	 * @var	array

	 */

	public $jquery_code_for_load = array();



	/**

	 * JQuery code for compile

	 *

	 * @var	array

	 */

	public $jquery_code_for_compile = array();



	/**

	 * JQuery corner active flag

	 *

	 * @var	bool

	 */

	public $jquery_corner_active = FALSE;



	/**

	 * JQuery table sorter active flag

	 *

	 * @var	bool

	 */

	public $jquery_table_sorter_active = FALSE;



	/**

	 * JQuery table sorter pager active

	 *

	 * @var	bool

	 */

	public $jquery_table_sorter_pager_active = FALSE;



	/**

	 * JQuery AJAX image

	 *

	 * @var	string

	 */

	public $jquery_ajax_img = '';



	// --------------------------------------------------------------------



	/**

	 * Constructor

	 *

	 * @param	array	$params

	 * @return	void

	 */

	public function __construct($params)

	{

		$this->CI =& get_instance();

		extract($params);



		if ($autoload === TRUE)

		{

			$this->script();

		}



		log_message('info', 'Jquery Class Initialized');

	}



	// --------------------------------------------------------------------

	// Event Code

	// --------------------------------------------------------------------



	/**

	 * Blur

	 *

	 * Outputs a jQuery blur event

	 *

	 * @param	string	The element to attach the event to

	 * @param	string	The code to execute

	 * @return	string

	 */

	protected function _blur($element = 'this', $js = '')

	{

		return $this->_add_event($element, $js, 'blur');

	}



	// --------------------------------------------------------------------



	/**

	 * Change

	 *

	 * Outputs a jQuery change event

	 *

	 * @param	string	The element to attach the event to

	 * @param	string	The code to execute

	 * @return	string

	 */

	protected function _change($element = 'this', $js = '')

	{

		return $this->_add_event($element, $js, 'change');

	}



	// --------------------------------------------------------------------



	/**

	 * Click

	 *

	 * Outputs a jQuery click event

	 *

	 * @param	string	The element to attach the event to

	 * @param	string	The code to execute

	 * @param	bool	whether or not to return false

	 * @return	string

	 */

	protected function _click($element = 'this', $js = '', $ret_false = TRUE)

	{

		is_array($js) OR $js = array($js);



		if ($ret_false)

		{

			$js[] = 'return false;';

		}



		return $this->_add_event($element, $js, 'click');

	}



	// --------------------------------------------------------------------



	/**

	 * Double Click

	 *

	 * Outputs a jQuery dblclick event

	 *

	 * @param	string	The element to attach the event to

	 * @param	string	The code to execute

	 * @return	string

	 */

	protected function _dblclick($element = 'this', $js = '')

	{

		return $this->_add_event($element, $js, 'dblclick');

	}



	// --------------------------------------------------------------------



	/**

	 * Error

	 *

	 * Outputs a jQuery error event

	 *

	 * @param	string	The element to attach the event to

	 * @param	string	The code to execute

	 * @return	string

	 */

	protected function _error($element = 'this', $js = '')

	{

		return $this->_add_event($element, $js, 'error');

	}



	// --------------------------------------------------------------------



	/**

	 * Focus

	 *

	 * Outputs a jQuery focus event

	 *

	 * @param	string	The element to attach the event to

	 * @param	string	The code to execute

	 * @return	string

	 */

	protected function _focus($element = 'this', $js = '')

	{

		return $this->_add_event($element, $js, 'focus');

	}



	// --------------------------------------------------------------------



	/**

	 * Hover

	 *

	 * Outputs a jQuery hover event

	 *

	 * @param	string	- element

	 * @param	string	- Javascript code for mouse over

	 * @param	string	- Javascript code for mouse out

	 * @return	string

	 */

	protected function _hover($element = 'this', $over = '', $out = '')

	{

		$event = "\n\t$(".$this->_prep_element($element).").hover(\n\t\tfunction()\n\t\t{\n\t\t\t{$over}\n\t\t}, \n\t\tfunction()\n\t\t{\n\t\t\t{$out}\n\t\t});\n";



		$this->jquery_code_for_compile[] = $event;



		return $event;

	}



	// --------------------------------------------------------------------



	/**

	 * Keydown

	 *

	 * Outputs a jQuery keydown event

	 *

	 * @param	string	The element to attach the event to

	 * @param	string	The code to execute

	 * @return	string

	 */

	protected function _keydown($element = 'this', $js = '')

	{

		return $this->_add_event($element, $js, 'keydown');

	}



	// --------------------------------------------------------------------



	/**

	 * Keyup

	 *

	 * Outputs a jQuery keydown event

	 *

	 * @param	string	The element to attach the event to

	 * @param	string	The code to execute

	 * @return	string

	 */

	protected function _keyup($element = 'this', $js = '')

	{

		return $this->_add_event($element, $js, 'keyup');

	}



	// --------------------------------------------------------------------



	/**

	 * Load

	 *

	 * Outputs a jQuery load event

	 *

	 * @param	string	The element to attach the event to

	 * @param	string	The code to execute

	 * @return	string

	 */

	protected function _load($element = 'this', $js = '')

	{

		return $this->_add_event($element, $js, 'load');

	}



	// --------------------------------------------------------------------



	/**

	 * Mousedown

	 *

	 * Outputs a jQuery mousedown event

	 *

	 * @param	string	The element to attach the event to

	 * @param	string	The code to execute

	 * @return	string

	 */

	protected function _mousedown($element = 'this', $js = '')

	{

		return $this->_add_event($element, $js, 'mousedown');

	}



	// --------------------------------------------------------------------



	/**

	 * Mouse Out

	 *

	 * Outputs a jQuery mouseout event

	 *

	 * @param	string	The element to attach the event to

	 * @param	string	The code to execute

	 * @return	string

	 */

	protected function _mouseout($element = 'this', $js = '')

	{

		return $this->_add_event($element, $js, 'mouseout');

	}



	// --------------------------------------------------------------------



	/**

	 * Mouse Over

	 *

	 * Outputs a jQuery mouseover event

	 *

	 * @param	string	The element to attach the event to

	 * @param	string	The code to execute

	 * @return	string

	 */

	protected function _mouseover($element = 'this', $js = '')

	{

		return $this->_add_event($element, $js, 'mouseover');

	}



	// --------------------------------------------------------------------



	/**

	 * Mouseup

	 *

	 * Outputs a jQuery mouseup event

	 *

	 * @param	string	The element to attach the event to

	 * @param	string	The code to execute

	 * @return	string

	 */

	protected function _mouseup($element = 'this', $js = '')

	{

		return $this->_add_event($element, $js, 'mouseup');

	}



	// --------------------------------------------------------------------



	/**

	 * Output

	 *

	 * Outputs script directly

	 *

	 * @param	array	$array_js = array()

	 * @return	void

	 */

	protected function _output($array_js = array())

	{

		if ( ! is_array($array_js))

		{

			$array_js = array($array_js);

		}



		foreach ($array_js as $js)

		{

			$this->jquery_code_for_compile[] = "\t".$js."\n";

		}

	}



	// --------------------------------------------------------------------



	/**

	 * Resize

	 *

	 * Outputs a jQuery resize event

	 *

	 * @param	string	The element to attach the event to

	 * @param	string	The code to execute

	 * @return	string

	 */

	protected function _resize($element = 'this', $js = '')

	{

		return $this->_add_event($element, $js, 'resize');

	}



	// --------------------------------------------------------------------



	/**

	 * Scroll

	 *

	 * Outputs a jQuery scroll event

	 *

	 * @param	string	The element to attach the event to

	 * @param	string	The code to execute

	 * @return	string

	 */

	protected function _scroll($element = 'this', $js = '')

	{

		return $this->_add_event($element, $js, 'scroll');

	}



	// --------------------------------------------------------------------



	/**

	 * Unload

	 *

	 * Outputs a jQuery unload event

	 *

	 * @param	string	The element to attach the event to

	 * @param	string	The code to execute

	 * @return	string

	 */

	protected function _unload($element = 'this', $js = '')

	{

		return $this->_add_event($element, $js, 'unload');

	}



	// --------------------------------------------------------------------

	// Effects

	// --------------------------------------------------------------------



	/**

	 * Add Class

	 *

	 * Outputs a jQuery addClass event

	 *

	 * @param	string	$element

	 * @param	string	$class

	 * @return	string

	 */

	protected function _addClass($element = 'this', $class = '')

	{

		$element = $this->_prep_element($element);

		return '$('.$element.').addClass("'.$class.'");';

	}



	// --------------------------------------------------------------------



	/**

	 * Animate

	 *

	 * Outputs a jQuery animate event

	 *

	 * @param	string	$element

	 * @param	array	$params

	 * @param	string	$speed	'slow', 'normal', 'fast', or time in milliseconds

	 * @param	string	$extra

	 * @return	string

	 */

	protected function _animate($element = 'this', $params = array(), $speed = '', $extra = '')

	{

		$element = $this->_prep_element($element);

		$speed = $this->_validate_speed($speed);



		$animations = "\t\t\t";



		foreach ($params as $param => $value)

		{

			$animations .= $param.": '".$value."', ";

		}



		$animations = substr($animations, 0, -2); // remove the last ", "



		if ($speed !== '')

		{

			$speed = ', '.$speed;

		}



		if ($extra !== '')

		{

			$extra = ', '.$extra;

		}



		return "$({$element}).animate({\n$animations\n\t\t}".$speed.$extra.');';

	}



	// --------------------------------------------------------------------



	/**

	 * Fade In

	 *

	 * Outputs a jQuery hide event

	 *

	 * @param	string	- element

	 * @param	string	- One of 'slow', 'normal', 'fast', or time in milliseconds

	 * @param	string	- Javascript callback function

	 * @return	string

	 */

	protected function _fadeIn($element = 'this', $speed = '', $callback = '')

	{

		$element = $this->_prep_element($element);

		$speed = $this->_validate_speed($speed);



		if ($callback !== '')

		{

			$callback = ", function(){\n{$callback}\n}";

		}



		return "$({$element}).fadeIn({$speed}{$callback});";

	}



	// --------------------------------------------------------------------



	/**

	 * Fade Out

	 *

	 * Outputs a jQuery hide event

	 *

	 * @param	string	- element

	 * @param	string	- One of 'slow', 'normal', 'fast', or time in milliseconds

	 * @param	string	- Javascript callback function

	 * @return	string

	 */

	protected function _fadeOut($element = 'this', $speed = '', $callback = '')

	{

		$element = $this->_prep_element($element);

		$speed = $this->_validate_speed($speed);



		if ($callback !== '')

		{

			$callback = ", function(){\n{$callback}\n}";

		}



		return '$('.$element.').fadeOut('.$speed.$callback.');';

	}



	// --------------------------------------------------------------------



	/**

	 * Hide

	 *

	 * Outputs a jQuery hide action

	 *

	 * @param	string	- element

	 * @param	string	- One of 'slow', 'normal', 'fast', or time in milliseconds

	 * @param	string	- Javascript callback function

	 * @return	string

	 */

	protected function _hide($element = 'this', $speed = '', $callback = '')

	{

		$element = $this->_prep_element($element);

		$speed = $this->_validate_speed($speed);



		if ($callback !== '')

		{

			$callback = ", function(){\n{$callback}\n}";

		}



		return "$({$element}).hide({$speed}{$callback});";

	}



	// --------------------------------------------------------------------



	/**

	 * Remove Class

	 *

	 * Outputs a jQuery remove class event

	 *

	 * @param	string	$element

	 * @param	string	$class

	 * @return	string

	 */

	protected function _removeClass($element = 'this', $class = '')

	{

		$element = $this->_prep_element($element);

		return '$('.$element.').removeClass("'.$class.'");';

	}



	// --------------------------------------------------------------------



	/**

	 * Slide Up

	 *

	 * Outputs a jQuery slideUp event

	 *

	 * @param	string	- element

	 * @param	string	- One of 'slow', 'normal', 'fast', or time in milliseconds

	 * @param	string	- Javascript callback function

	 * @return	string

	 */

	protected function _slideUp($element = 'this', $speed = '', $callback = '')

	{

		$element = $this->_prep_element($element);

		$speed = $this->_validate_speed($speed);



		if ($callback !== '')

		{

			$callback = ", function(){\n{$callback}\n}";

		}



		return '$('.$element.').slideUp('.$speed.$callback.');';

	}



	// --------------------------------------------------------------------



	/**

	 * Slide Down

	 *

	 * Outputs a jQuery slideDown event

	 *

	 * @param	string	- element

	 * @param	string	- One of 'slow', 'normal', 'fast', or time in milliseconds

	 * @param	string	- Javascript callback function

	 * @return	string

	 */

	protected function _slideDown($element = 'this', $speed = '', $callback = '')

	{

		$element = $this->_prep_element($element);

		$speed = $this->_validate_speed($speed);



		if ($callback !== '')

		{

			$callback = ", function(){\n{$callback}\n}";

		}



		return '$('.$element.').slideDown('.$speed.$callback.');';

	}



	// --------------------------------------------------------------------



	/**

	 * Slide Toggle

	 *

	 * Outputs a jQuery slideToggle event

	 *

	 * @param	string	- element

	 * @param	string	- One of 'slow', 'normal', 'fast', or time in milliseconds

	 * @param	string	- Javascript callback function

	 * @return	string

	 */

	protected function _slideToggle($element = 'this', $speed = '', $callback = '')

	{

		$element = $this->_prep_element($element);

		$speed = $this->_validate_speed($speed);



		if ($callback !== '')

		{

			$callback = ", function(){\n{$callback}\n}";

		}



		return '$('.$element.').slideToggle('.$speed.$callback.');';

	}



	// --------------------------------------------------------------------



	/**

	 * Toggle

	 *

	 * Outputs a jQuery toggle event

	 *

	 * @param	string	- element

	 * @return	string

	 */

	protected function _toggle($element = 'this')

	{

		$element = $this->_prep_element($element);

		return '$('.$element.').toggle();';

	}



	// --------------------------------------------------------------------



	/**

	 * Toggle Class

	 *

	 * Outputs a jQuery toggle class event

	 *

	 * @param	string	$element

	 * @param	string	$class

	 * @return	string

	 */

	protected function _toggleClass($element = 'this', $class = '')

	{

		$element = $this->_prep_element($element);

		return '$('.$element.').toggleClass("'.$class.'");';

	}



	// --------------------------------------------------------------------



	/**

	 * Show

	 *

	 * Outputs a jQuery show event

	 *

	 * @param	string	- element

	 * @param	string	- One of 'slow', 'normal', 'fast', or time in milliseconds

	 * @param	string	- Javascript callback function

	 * @return	string

	 */

	protected function _show($element = 'this', $speed = '', $callback = '')

	{

		$element = $this->_prep_element($element);

		$speed = $this->_validate_speed($speed);



		if ($callback !== '')

		{

			$callback = ", function(){\n{$callback}\n}";

		}



		return '$('.$element.').show('.$speed.$callback.');';

	}



	// --------------------------------------------------------------------



	/**

	 * Updater

	 *

	 * An Ajax call that populates the designated DOM node with

	 * returned content

	 *

	 * @param	string	The element to attach the event to

	 * @param	string	the controller to run the call against

	 * @param	string	optional parameters

	 * @return	string

	 */



	protected function _updater($container = 'this', $controller = '', $options = '')

	{

		$container = $this->_prep_element($container);

		$controller = (strpos('://', $controller) === FALSE) ? $controller : $this->CI->config->site_url($controller);



		// ajaxStart and ajaxStop are better choices here... but this is a stop gap

		if ($this->CI->config->item('javascript_ajax_img') === '')

		{

			$loading_notifier = 'Loading...';

		}

		else

		{

			$loading_notifier = '<img src="'.$this->CI->config->slash_item('base_url').$this->CI->config->item('javascript_ajax_img').'" alt="Loading" />';

		}



		$updater = '$('.$container.").empty();\n" // anything that was in... get it out

			."\t\t$(".$container.').prepend("'.$loading_notifier."\");\n"; // to replace with an image



		$request_options = '';

		if ($options !== '')

		{

			$request_options .= ', {'

					.(is_array($options) ? "'".implode("', '", $options)."'" : "'".str_replace(':', "':'", $options)."'")

					.'}';

		}



		return $updater."\t\t$($container).load('$controller'$request_options);";

	}



	// --------------------------------------------------------------------

	// Pre-written handy stuff

	// --------------------------------------------------------------------



	/**

	 * Zebra tables

	 *

	 * @param	string	$class

	 * @param	string	$odd

	 * @param	string	$hover

	 * @return	string

	 */

	protected function _zebraTables($class = '', $odd = 'odd', $hover = '')

	{

		$class = ($class !== '') ? '.'.$class : '';

		$zebra = "\t\$(\"table{$class} tbody tr:nth-child(even)\").addClass(\"{$odd}\");";



		$this->jquery_code_for_compile[] = $zebra;



		if ($hover !== '')

		{

			$hover = $this->hover("table{$class} tbody tr", "$(this).addClass('hover');", "$(this).removeClass('hover');");

		}



		return $zebra;

	}



	// --------------------------------------------------------------------

	// Plugins

	// --------------------------------------------------------------------



	/**

	 * Corner Plugin

	 *

	 * @link	http://www.malsup.com/jquery/corner/

	 * @param	string	$element

	 * @param	string	$corner_style

	 * @return	string

	 */

	public function corner($element = '', $corner_style = '')

	{

		// may want to make this configurable down the road

		$corner_location = '/plugins/jquery.corner.js';



		if ($corner_style !== '')

		{

			$corner_style = '"'.$corner_style.'"';

		}



		return '$('.$this->_prep_element($element).').corner('.$corner_style.');';

	}



	// --------------------------------------------------------------------



	/**

	 * Modal window

	 *

	 * Load a thickbox modal window

	 *

	 * @param	string	$src

	 * @param	bool	$relative

	 * @return	void

	 */

	public function modal($src, $relative = FALSE)

	{

		$this->jquery_code_for_load[] = $this->external($src, $relative);

	}



	// --------------------------------------------------------------------



	/**

	 * Effect

	 *

	 * Load an Effect library

	 *

	 * @param	string	$src

	 * @param	bool	$relative

	 * @return	void

	 */

	public function effect($src, $relative = FALSE)

	{

		$this->jquery_code_for_load[] = $this->external($src, $relative);

	}



	// --------------------------------------------------------------------



	/**

	 * Plugin

	 *

	 * Load a plugin library

	 *

	 * @param	string	$src

	 * @param	bool	$relative

	 * @return	void

	 */

	public function plugin($src, $relative = FALSE)

	{

		$this->jquery_code_for_load[] = $this->external($src, $relative);

	}



	// --------------------------------------------------------------------



	/**

	 * UI

	 *

	 * Load a user interface library

	 *

	 * @param	string	$src

	 * @param	bool	$relative

	 * @return	void

	 */

	public function ui($src, $relative = FALSE)

	{

		$this->jquery_code_for_load[] = $this->external($src, $relative);

	}



	// --------------------------------------------------------------------



	/**

	 * Sortable

	 *

	 * Creates a jQuery sortable

	 *

	 * @param	string	$element

	 * @param	array	$options

	 * @return	string

	 */

	public function sortable($element, $options = array())

	{

		if (count($options) > 0)

		{

			$sort_options = array();

			foreach ($options as $k=>$v)

			{

				$sort_options[] = "\n\t\t".$k.': '.$v;

			}

			$sort_options = implode(',', $sort_options);

		}

		else

		{

			$sort_options = '';

		}



		return '$('.$this->_prep_element($element).').sortable({'.$sort_options."\n\t});";

	}



	// --------------------------------------------------------------------



	/**

	 * Table Sorter Plugin

	 *

	 * @param	string	table name

	 * @param	string	plugin location

	 * @return	string

	 */

	public function tablesorter($table = '', $options = '')

	{

		$this->jquery_code_for_compile[] = "\t$(".$this->_prep_element($table).').tablesorter('.$options.");\n";

	}



	// --------------------------------------------------------------------

	// Class functions

	// --------------------------------------------------------------------



	/**

	 * Add Event

	 *

	 * Constructs the syntax for an event, and adds to into the array for compilation

	 *

	 * @param	string	The element to attach the event to

	 * @param	string	The code to execute

	 * @param	string	The event to pass

	 * @return	string

	 */

	protected function _add_event($element, $js, $event)

	{

		if (is_array($js))

		{

			$js = implode("\n\t\t", $js);

		}



		$event = "\n\t$(".$this->_prep_element($element).').'.$event."(function(){\n\t\t{$js}\n\t});\n";

		$this->jquery_code_for_compile[] = $event;

		return $event;

	}



	// --------------------------------------------------------------------



	/**

	 * Compile

	 *

	 * As events are specified, they are stored in an array

	 * This function compiles them all for output on a page

	 *

	 * @param	string	$view_var

	 * @param	bool	$script_tags

	 * @return	void

	 */

	protected function _compile($view_var = 'script_foot', $script_tags = TRUE)

	{

		// External references

		$external_scripts = implode('', $this->jquery_code_for_load);

		$this->CI->load->vars(array('library_src' => $external_scripts));



		if (count($this->jquery_code_for_compile) === 0)

		{

			// no inline references, let's just return

			return;

		}



		// Inline references

		$script = '$(document).ready(function() {'."\n"

			.implode('', $this->jquery_code_for_compile)

			.'});';



		$output = ($script_tags === FALSE) ? $script : $this->inline($script);



		$this->CI->load->vars(array($view_var => $output));

	}



	// --------------------------------------------------------------------



	/**

	 * Clear Compile

	 *

	 * Clears the array of script events collected for output

	 *

	 * @return	void

	 */

	protected function _clear_compile()

	{

		$this->jquery_code_for_compile = array();

	}



	// --------------------------------------------------------------------



	/**

	 * Document Ready

	 *

	 * A wrapper for writing document.ready()

	 *

	 * @param	array	$js

	 * @return	void

	 */

	protected function _document_ready($js)

	{

		is_array($js) OR $js = array($js);



		foreach ($js as $script)

		{

			$this->jquery_code_for_compile[] = $script;

		}

	}



	// --------------------------------------------------------------------



	/**

	 * Script Tag

	 *

	 * Outputs the script tag that loads the jquery.js file into an HTML document

	 *

	 * @param	string	$library_src

	 * @param	bool	$relative

	 * @return	string

	 */

	public function script($library_src = '', $relative = FALSE)

	{

		$library_src = $this->external($library_src, $relative);

		$this->jquery_code_for_load[] = $library_src;

		return $library_src;

	}



	// --------------------------------------------------------------------



	/**

	 * Prep Element

	 *

	 * Puts HTML element in quotes for use in jQuery code

	 * unless the supplied element is the Javascript 'this'

	 * object, in which case no quotes are added

	 *

	 * @param	string

	 * @return	string

	 */

	protected function _prep_element($element)

	{

		if ($element !== 'this')

		{

			$element = '"'.$element.'"';

		}



		return $element;

	}



	// --------------------------------------------------------------------



	/**

	 * Validate Speed

	 *

	 * Ensures the speed parameter is valid for jQuery

	 *

	 * @param	string

	 * @return	string

	 */

	protected function _validate_speed($speed)

	{

		if (in_array($speed, array('slow', 'normal', 'fast')))

		{

			return '"'.$speed.'"';

		}

		elseif (preg_match('/[^0-9]/', $speed))

		{

			return '';

		}



		return $speed;

	}



}

