diff --git a/README.txt b/README.txt index e5dded4..e59fb27 100644 --- a/README.txt +++ b/README.txt @@ -13,6 +13,17 @@ Customise the order your pages are listed in with a simple Ajax drag-and-drop ad If you want to see an example of the admin page check out: http://joelstarnes.co.uk/pagemash/example + + += Development Version 1.0.0 beta = + +I have just finished a major rebuild of the plugin to give full recursive suppot for unlimited nested children in a collapsable list which I've decided to release as the first major version 1.0.0. but it'd be really helpful if some people can download the 1.0.0 beta and give me some feedback to iron out any bugs. + +http://joelstarnes.co.uk/pagemash/example_v1.0.0 + +http://wordpress.org/extend/plugins/pagemash/download/pagemash.1.0.0.zip + + == Installation == 1. Download Plugin @@ -20,42 +31,25 @@ If you want to see an example of the admin page check out: http://joelstarnes.co 1. Activate in 'Plugins' admin menu 1. {Edit your Template} -In most cases the plugin should work straight out the box, since most templates will include something similar to: `wp_list_pages('title_li=

Pages

);` +In most cases the plugin should work straight out the box so give it an install and if then there is further info available in the plugin's admin page under 'Show further info'. -However to achieve full functionality including the 'exclude pages' feature you should replace the wp_list_pages() function with the following php code: - - `if(function_exists('pageMash_exclude_pages'))` - `{$exclude_pages=pageMash_exclude_pages();} else{$exclude_pages='';}` - `wp_list_pages('title_li=

Pages

&exclude='.$exclude_pages);` - - -You can place the code wherever you would like your page listings to appear; -usually either the header.php or sidebar.php file found in: `wp-content\themes\theme_name` - == Frequently Asked Questions == If you have any questions or comments, please drop me an email: joel@joelstarnes.co.uk - = Can I use this with the 'Pages' sidebar widget? = Yes. Go into the wordpress admin; Presentation > Widgets and drag the pages widget to the sidebar, then go to it's settings by clicking the icon on the right and ensure that 'sort by' value is set to 'page order'. Note however that the exclude pages feature will not work, so disable this in the top of the pagemash.php file by setting '$excludePagesFeature = false;'. + == Screenshots == 1. Admin Interface. 2. If you are having problems using the pages widget; goto [Admin > Presentation > Widgets] and check that the 'sort by' value is set to 'page order'. -== Localization == - -Currently only available in english. - -== Limitations== - -The plugin will currently only handle top level pages. ==Change Log== @@ -65,9 +59,10 @@ The plugin will currently only handle top level pages. 0.1.2 > Fixed CSS&JS headers to only display on pageMash admin -0.1.3 > Fixed exclude pages feature +0.1.3 > Fixed exclude pages feature \n +1.0.0 beta > Major rebuild > Recusive page handles unlimited nested children, collapsable list items, interface makeover... -==Road Map== +== Localization == -For the next majour release I hope to support children pages and allow these to be sorted and moved between different parents in a nested list fashion. \ No newline at end of file +Currently only available in english. diff --git a/collapse.png b/collapse.png new file mode 100644 index 0000000..3141467 Binary files /dev/null and b/collapse.png differ diff --git a/expand.png b/expand.png new file mode 100644 index 0000000..d5bfa07 Binary files /dev/null and b/expand.png differ diff --git a/myjson.php b/myjson.php new file mode 100644 index 0000000..852ac77 --- /dev/null +++ b/myjson.php @@ -0,0 +1,806 @@ + + * @author Matt Knapp + * @author Brett Stimmerman + * @copyright 2005 Michal Migurski + * @version CVS: $Id: JSON.php,v 1.31 2006/06/28 05:54:17 migurski Exp $ + * @license http://www.opensource.org/licenses/bsd-license.php + * @link http://pear.php.net/pepr/pepr-proposal-show.php?id=198 + */ + +/** + * Marker constant for Services_JSON::decode(), used to flag stack state + */ +define('SERVICES_JSON_SLICE', 1); + +/** + * Marker constant for Services_JSON::decode(), used to flag stack state + */ +define('SERVICES_JSON_IN_STR', 2); + +/** + * Marker constant for Services_JSON::decode(), used to flag stack state + */ +define('SERVICES_JSON_IN_ARR', 3); + +/** + * Marker constant for Services_JSON::decode(), used to flag stack state + */ +define('SERVICES_JSON_IN_OBJ', 4); + +/** + * Marker constant for Services_JSON::decode(), used to flag stack state + */ +define('SERVICES_JSON_IN_CMT', 5); + +/** + * Behavior switch for Services_JSON::decode() + */ +define('SERVICES_JSON_LOOSE_TYPE', 16); + +/** + * Behavior switch for Services_JSON::decode() + */ +define('SERVICES_JSON_SUPPRESS_ERRORS', 32); + +/** + * Converts to and from JSON format. + * + * Brief example of use: + * + * + * // create a new instance of Services_JSON + * $json = new Services_JSON(); + * + * // convert a complexe value to JSON notation, and send it to the browser + * $value = array('foo', 'bar', array(1, 2, 'baz'), array(3, array(4))); + * $output = $json->encode($value); + * + * print($output); + * // prints: ["foo","bar",[1,2,"baz"],[3,[4]]] + * + * // accept incoming POST data, assumed to be in JSON notation + * $input = file_get_contents('php://input', 1000000); + * $value = $json->decode($input); + * + */ +class Services_JSON +{ + /** + * constructs a new JSON instance + * + * @param int $use object behavior flags; combine with boolean-OR + * + * possible values: + * - SERVICES_JSON_LOOSE_TYPE: loose typing. + * "{...}" syntax creates associative arrays + * instead of objects in decode(). + * - SERVICES_JSON_SUPPRESS_ERRORS: error suppression. + * Values which can't be encoded (e.g. resources) + * appear as NULL instead of throwing errors. + * By default, a deeply-nested resource will + * bubble up with an error, so all return values + * from encode() should be checked with isError() + */ + function Services_JSON($use = 0) + { + $this->use = $use; + } + + /** + * convert a string from one UTF-16 char to one UTF-8 char + * + * Normally should be handled by mb_convert_encoding, but + * provides a slower PHP-only method for installations + * that lack the multibye string extension. + * + * @param string $utf16 UTF-16 character + * @return string UTF-8 character + * @access private + */ + function utf162utf8($utf16) + { + // oh please oh please oh please oh please oh please + if(function_exists('mb_convert_encoding')) { + return mb_convert_encoding($utf16, 'UTF-8', 'UTF-16'); + } + + $bytes = (ord($utf16{0}) << 8) | ord($utf16{1}); + + switch(true) { + case ((0x7F & $bytes) == $bytes): + // this case should never be reached, because we are in ASCII range + // see: http://www.cl.cam.ac.uk/~mgk25/unicode.html#utf-8 + return chr(0x7F & $bytes); + + case (0x07FF & $bytes) == $bytes: + // return a 2-byte UTF-8 character + // see: http://www.cl.cam.ac.uk/~mgk25/unicode.html#utf-8 + return chr(0xC0 | (($bytes >> 6) & 0x1F)) + . chr(0x80 | ($bytes & 0x3F)); + + case (0xFFFF & $bytes) == $bytes: + // return a 3-byte UTF-8 character + // see: http://www.cl.cam.ac.uk/~mgk25/unicode.html#utf-8 + return chr(0xE0 | (($bytes >> 12) & 0x0F)) + . chr(0x80 | (($bytes >> 6) & 0x3F)) + . chr(0x80 | ($bytes & 0x3F)); + } + + // ignoring UTF-32 for now, sorry + return ''; + } + + /** + * convert a string from one UTF-8 char to one UTF-16 char + * + * Normally should be handled by mb_convert_encoding, but + * provides a slower PHP-only method for installations + * that lack the multibye string extension. + * + * @param string $utf8 UTF-8 character + * @return string UTF-16 character + * @access private + */ + function utf82utf16($utf8) + { + // oh please oh please oh please oh please oh please + if(function_exists('mb_convert_encoding')) { + return mb_convert_encoding($utf8, 'UTF-16', 'UTF-8'); + } + + switch(strlen($utf8)) { + case 1: + // this case should never be reached, because we are in ASCII range + // see: http://www.cl.cam.ac.uk/~mgk25/unicode.html#utf-8 + return $utf8; + + case 2: + // return a UTF-16 character from a 2-byte UTF-8 char + // see: http://www.cl.cam.ac.uk/~mgk25/unicode.html#utf-8 + return chr(0x07 & (ord($utf8{0}) >> 2)) + . chr((0xC0 & (ord($utf8{0}) << 6)) + | (0x3F & ord($utf8{1}))); + + case 3: + // return a UTF-16 character from a 3-byte UTF-8 char + // see: http://www.cl.cam.ac.uk/~mgk25/unicode.html#utf-8 + return chr((0xF0 & (ord($utf8{0}) << 4)) + | (0x0F & (ord($utf8{1}) >> 2))) + . chr((0xC0 & (ord($utf8{1}) << 6)) + | (0x7F & ord($utf8{2}))); + } + + // ignoring UTF-32 for now, sorry + return ''; + } + + /** + * encodes an arbitrary variable into JSON format + * + * @param mixed $var any number, boolean, string, array, or object to be encoded. + * see argument 1 to Services_JSON() above for array-parsing behavior. + * if var is a strng, note that encode() always expects it + * to be in ASCII or UTF-8 format! + * + * @return mixed JSON string representation of input var or an error if a problem occurs + * @access public + */ + function encode($var) + { + switch (gettype($var)) { + case 'boolean': + return $var ? 'true' : 'false'; + + case 'NULL': + return 'null'; + + case 'integer': + return (int) $var; + + case 'double': + case 'float': + return (float) $var; + + case 'string': + // STRINGS ARE EXPECTED TO BE IN ASCII OR UTF-8 FORMAT + $ascii = ''; + $strlen_var = strlen($var); + + /* + * Iterate over every character in the string, + * escaping with a slash or encoding to UTF-8 where necessary + */ + for ($c = 0; $c < $strlen_var; ++$c) { + + $ord_var_c = ord($var{$c}); + + switch (true) { + case $ord_var_c == 0x08: + $ascii .= '\b'; + break; + case $ord_var_c == 0x09: + $ascii .= '\t'; + break; + case $ord_var_c == 0x0A: + $ascii .= '\n'; + break; + case $ord_var_c == 0x0C: + $ascii .= '\f'; + break; + case $ord_var_c == 0x0D: + $ascii .= '\r'; + break; + + case $ord_var_c == 0x22: + case $ord_var_c == 0x2F: + case $ord_var_c == 0x5C: + // double quote, slash, slosh + $ascii .= '\\'.$var{$c}; + break; + + case (($ord_var_c >= 0x20) && ($ord_var_c <= 0x7F)): + // characters U-00000000 - U-0000007F (same as ASCII) + $ascii .= $var{$c}; + break; + + case (($ord_var_c & 0xE0) == 0xC0): + // characters U-00000080 - U-000007FF, mask 110XXXXX + // see http://www.cl.cam.ac.uk/~mgk25/unicode.html#utf-8 + $char = pack('C*', $ord_var_c, ord($var{$c + 1})); + $c += 1; + $utf16 = $this->utf82utf16($char); + $ascii .= sprintf('\u%04s', bin2hex($utf16)); + break; + + case (($ord_var_c & 0xF0) == 0xE0): + // characters U-00000800 - U-0000FFFF, mask 1110XXXX + // see http://www.cl.cam.ac.uk/~mgk25/unicode.html#utf-8 + $char = pack('C*', $ord_var_c, + ord($var{$c + 1}), + ord($var{$c + 2})); + $c += 2; + $utf16 = $this->utf82utf16($char); + $ascii .= sprintf('\u%04s', bin2hex($utf16)); + break; + + case (($ord_var_c & 0xF8) == 0xF0): + // characters U-00010000 - U-001FFFFF, mask 11110XXX + // see http://www.cl.cam.ac.uk/~mgk25/unicode.html#utf-8 + $char = pack('C*', $ord_var_c, + ord($var{$c + 1}), + ord($var{$c + 2}), + ord($var{$c + 3})); + $c += 3; + $utf16 = $this->utf82utf16($char); + $ascii .= sprintf('\u%04s', bin2hex($utf16)); + break; + + case (($ord_var_c & 0xFC) == 0xF8): + // characters U-00200000 - U-03FFFFFF, mask 111110XX + // see http://www.cl.cam.ac.uk/~mgk25/unicode.html#utf-8 + $char = pack('C*', $ord_var_c, + ord($var{$c + 1}), + ord($var{$c + 2}), + ord($var{$c + 3}), + ord($var{$c + 4})); + $c += 4; + $utf16 = $this->utf82utf16($char); + $ascii .= sprintf('\u%04s', bin2hex($utf16)); + break; + + case (($ord_var_c & 0xFE) == 0xFC): + // characters U-04000000 - U-7FFFFFFF, mask 1111110X + // see http://www.cl.cam.ac.uk/~mgk25/unicode.html#utf-8 + $char = pack('C*', $ord_var_c, + ord($var{$c + 1}), + ord($var{$c + 2}), + ord($var{$c + 3}), + ord($var{$c + 4}), + ord($var{$c + 5})); + $c += 5; + $utf16 = $this->utf82utf16($char); + $ascii .= sprintf('\u%04s', bin2hex($utf16)); + break; + } + } + + return '"'.$ascii.'"'; + + case 'array': + /* + * As per JSON spec if any array key is not an integer + * we must treat the the whole array as an object. We + * also try to catch a sparsely populated associative + * array with numeric keys here because some JS engines + * will create an array with empty indexes up to + * max_index which can cause memory issues and because + * the keys, which may be relevant, will be remapped + * otherwise. + * + * As per the ECMA and JSON specification an object may + * have any string as a property. Unfortunately due to + * a hole in the ECMA specification if the key is a + * ECMA reserved word or starts with a digit the + * parameter is only accessible using ECMAScript's + * bracket notation. + */ + + // treat as a JSON object + if (is_array($var) && count($var) && (array_keys($var) !== range(0, sizeof($var) - 1))) { + $properties = array_map(array($this, 'name_value'), + array_keys($var), + array_values($var)); + + foreach($properties as $property) { + if(Services_JSON::isError($property)) { + return $property; + } + } + + return '{' . join(',', $properties) . '}'; + } + + // treat it like a regular array + $elements = array_map(array($this, 'encode'), $var); + + foreach($elements as $element) { + if(Services_JSON::isError($element)) { + return $element; + } + } + + return '[' . join(',', $elements) . ']'; + + case 'object': + $vars = get_object_vars($var); + + $properties = array_map(array($this, 'name_value'), + array_keys($vars), + array_values($vars)); + + foreach($properties as $property) { + if(Services_JSON::isError($property)) { + return $property; + } + } + + return '{' . join(',', $properties) . '}'; + + default: + return ($this->use & SERVICES_JSON_SUPPRESS_ERRORS) + ? 'null' + : new Services_JSON_Error(gettype($var)." can not be encoded as JSON string"); + } + } + + /** + * array-walking function for use in generating JSON-formatted name-value pairs + * + * @param string $name name of key to use + * @param mixed $value reference to an array element to be encoded + * + * @return string JSON-formatted name-value pair, like '"name":value' + * @access private + */ + function name_value($name, $value) + { + $encoded_value = $this->encode($value); + + if(Services_JSON::isError($encoded_value)) { + return $encoded_value; + } + + return $this->encode(strval($name)) . ':' . $encoded_value; + } + + /** + * reduce a string by removing leading and trailing comments and whitespace + * + * @param $str string string value to strip of comments and whitespace + * + * @return string string value stripped of comments and whitespace + * @access private + */ + function reduce_string($str) + { + $str = preg_replace(array( + + // eliminate single line comments in '// ...' form + '#^\s*//(.+)$#m', + + // eliminate multi-line comments in '/* ... */' form, at start of string + '#^\s*/\*(.+)\*/#Us', + + // eliminate multi-line comments in '/* ... */' form, at end of string + '#/\*(.+)\*/\s*$#Us' + + ), '', $str); + + // eliminate extraneous space + return trim($str); + } + + /** + * decodes a JSON string into appropriate variable + * + * @param string $str JSON-formatted string + * + * @return mixed number, boolean, string, array, or object + * corresponding to given JSON input string. + * See argument 1 to Services_JSON() above for object-output behavior. + * Note that decode() always returns strings + * in ASCII or UTF-8 format! + * @access public + */ + function decode($str) + { + $str = $this->reduce_string($str); + + switch (strtolower($str)) { + case 'true': + return true; + + case 'false': + return false; + + case 'null': + return null; + + default: + $m = array(); + + if (is_numeric($str)) { + // Lookie-loo, it's a number + + // This would work on its own, but I'm trying to be + // good about returning integers where appropriate: + // return (float)$str; + + // Return float or int, as appropriate + return ((float)$str == (integer)$str) + ? (integer)$str + : (float)$str; + + } elseif (preg_match('/^("|\').*(\1)$/s', $str, $m) && $m[1] == $m[2]) { + // STRINGS RETURNED IN UTF-8 FORMAT + $delim = substr($str, 0, 1); + $chrs = substr($str, 1, -1); + $utf8 = ''; + $strlen_chrs = strlen($chrs); + + for ($c = 0; $c < $strlen_chrs; ++$c) { + + $substr_chrs_c_2 = substr($chrs, $c, 2); + $ord_chrs_c = ord($chrs{$c}); + + switch (true) { + case $substr_chrs_c_2 == '\b': + $utf8 .= chr(0x08); + ++$c; + break; + case $substr_chrs_c_2 == '\t': + $utf8 .= chr(0x09); + ++$c; + break; + case $substr_chrs_c_2 == '\n': + $utf8 .= chr(0x0A); + ++$c; + break; + case $substr_chrs_c_2 == '\f': + $utf8 .= chr(0x0C); + ++$c; + break; + case $substr_chrs_c_2 == '\r': + $utf8 .= chr(0x0D); + ++$c; + break; + + case $substr_chrs_c_2 == '\\"': + case $substr_chrs_c_2 == '\\\'': + case $substr_chrs_c_2 == '\\\\': + case $substr_chrs_c_2 == '\\/': + if (($delim == '"' && $substr_chrs_c_2 != '\\\'') || + ($delim == "'" && $substr_chrs_c_2 != '\\"')) { + $utf8 .= $chrs{++$c}; + } + break; + + case preg_match('/\\\u[0-9A-F]{4}/i', substr($chrs, $c, 6)): + // single, escaped unicode character + $utf16 = chr(hexdec(substr($chrs, ($c + 2), 2))) + . chr(hexdec(substr($chrs, ($c + 4), 2))); + $utf8 .= $this->utf162utf8($utf16); + $c += 5; + break; + + case ($ord_chrs_c >= 0x20) && ($ord_chrs_c <= 0x7F): + $utf8 .= $chrs{$c}; + break; + + case ($ord_chrs_c & 0xE0) == 0xC0: + // characters U-00000080 - U-000007FF, mask 110XXXXX + //see http://www.cl.cam.ac.uk/~mgk25/unicode.html#utf-8 + $utf8 .= substr($chrs, $c, 2); + ++$c; + break; + + case ($ord_chrs_c & 0xF0) == 0xE0: + // characters U-00000800 - U-0000FFFF, mask 1110XXXX + // see http://www.cl.cam.ac.uk/~mgk25/unicode.html#utf-8 + $utf8 .= substr($chrs, $c, 3); + $c += 2; + break; + + case ($ord_chrs_c & 0xF8) == 0xF0: + // characters U-00010000 - U-001FFFFF, mask 11110XXX + // see http://www.cl.cam.ac.uk/~mgk25/unicode.html#utf-8 + $utf8 .= substr($chrs, $c, 4); + $c += 3; + break; + + case ($ord_chrs_c & 0xFC) == 0xF8: + // characters U-00200000 - U-03FFFFFF, mask 111110XX + // see http://www.cl.cam.ac.uk/~mgk25/unicode.html#utf-8 + $utf8 .= substr($chrs, $c, 5); + $c += 4; + break; + + case ($ord_chrs_c & 0xFE) == 0xFC: + // characters U-04000000 - U-7FFFFFFF, mask 1111110X + // see http://www.cl.cam.ac.uk/~mgk25/unicode.html#utf-8 + $utf8 .= substr($chrs, $c, 6); + $c += 5; + break; + + } + + } + + return $utf8; + + } elseif (preg_match('/^\[.*\]$/s', $str) || preg_match('/^\{.*\}$/s', $str)) { + // array, or object notation + + if ($str{0} == '[') { + $stk = array(SERVICES_JSON_IN_ARR); + $arr = array(); + } else { + if ($this->use & SERVICES_JSON_LOOSE_TYPE) { + $stk = array(SERVICES_JSON_IN_OBJ); + $obj = array(); + } else { + $stk = array(SERVICES_JSON_IN_OBJ); + $obj = new stdClass(); + } + } + + array_push($stk, array('what' => SERVICES_JSON_SLICE, + 'where' => 0, + 'delim' => false)); + + $chrs = substr($str, 1, -1); + $chrs = $this->reduce_string($chrs); + + if ($chrs == '') { + if (reset($stk) == SERVICES_JSON_IN_ARR) { + return $arr; + + } else { + return $obj; + + } + } + + //print("\nparsing {$chrs}\n"); + + $strlen_chrs = strlen($chrs); + + for ($c = 0; $c <= $strlen_chrs; ++$c) { + + $top = end($stk); + $substr_chrs_c_2 = substr($chrs, $c, 2); + + if (($c == $strlen_chrs) || (($chrs{$c} == ',') && ($top['what'] == SERVICES_JSON_SLICE))) { + // found a comma that is not inside a string, array, etc., + // OR we've reached the end of the character list + $slice = substr($chrs, $top['where'], ($c - $top['where'])); + array_push($stk, array('what' => SERVICES_JSON_SLICE, 'where' => ($c + 1), 'delim' => false)); + //print("Found split at {$c}: ".substr($chrs, $top['where'], (1 + $c - $top['where']))."\n"); + + if (reset($stk) == SERVICES_JSON_IN_ARR) { + // we are in an array, so just push an element onto the stack + array_push($arr, $this->decode($slice)); + + } elseif (reset($stk) == SERVICES_JSON_IN_OBJ) { + // we are in an object, so figure + // out the property name and set an + // element in an associative array, + // for now + $parts = array(); + + if (preg_match('/^\s*(["\'].*[^\\\]["\'])\s*:\s*(\S.*),?$/Uis', $slice, $parts)) { + // "name":value pair + $key = $this->decode($parts[1]); + $val = $this->decode($parts[2]); + + if ($this->use & SERVICES_JSON_LOOSE_TYPE) { + $obj[$key] = $val; + } else { + $obj->$key = $val; + } + } elseif (preg_match('/^\s*(\w+)\s*:\s*(\S.*),?$/Uis', $slice, $parts)) { + // name:value pair, where name is unquoted + $key = $parts[1]; + $val = $this->decode($parts[2]); + + if ($this->use & SERVICES_JSON_LOOSE_TYPE) { + $obj[$key] = $val; + } else { + $obj->$key = $val; + } + } + + } + + } elseif ((($chrs{$c} == '"') || ($chrs{$c} == "'")) && ($top['what'] != SERVICES_JSON_IN_STR)) { + // found a quote, and we are not inside a string + array_push($stk, array('what' => SERVICES_JSON_IN_STR, 'where' => $c, 'delim' => $chrs{$c})); + //print("Found start of string at {$c}\n"); + + } elseif (($chrs{$c} == $top['delim']) && + ($top['what'] == SERVICES_JSON_IN_STR) && + ((strlen(substr($chrs, 0, $c)) - strlen(rtrim(substr($chrs, 0, $c), '\\'))) % 2 != 1)) { + // found a quote, we're in a string, and it's not escaped + // we know that it's not escaped becase there is _not_ an + // odd number of backslashes at the end of the string so far + array_pop($stk); + //print("Found end of string at {$c}: ".substr($chrs, $top['where'], (1 + 1 + $c - $top['where']))."\n"); + + } elseif (($chrs{$c} == '[') && + in_array($top['what'], array(SERVICES_JSON_SLICE, SERVICES_JSON_IN_ARR, SERVICES_JSON_IN_OBJ))) { + // found a left-bracket, and we are in an array, object, or slice + array_push($stk, array('what' => SERVICES_JSON_IN_ARR, 'where' => $c, 'delim' => false)); + //print("Found start of array at {$c}\n"); + + } elseif (($chrs{$c} == ']') && ($top['what'] == SERVICES_JSON_IN_ARR)) { + // found a right-bracket, and we're in an array + array_pop($stk); + //print("Found end of array at {$c}: ".substr($chrs, $top['where'], (1 + $c - $top['where']))."\n"); + + } elseif (($chrs{$c} == '{') && + in_array($top['what'], array(SERVICES_JSON_SLICE, SERVICES_JSON_IN_ARR, SERVICES_JSON_IN_OBJ))) { + // found a left-brace, and we are in an array, object, or slice + array_push($stk, array('what' => SERVICES_JSON_IN_OBJ, 'where' => $c, 'delim' => false)); + //print("Found start of object at {$c}\n"); + + } elseif (($chrs{$c} == '}') && ($top['what'] == SERVICES_JSON_IN_OBJ)) { + // found a right-brace, and we're in an object + array_pop($stk); + //print("Found end of object at {$c}: ".substr($chrs, $top['where'], (1 + $c - $top['where']))."\n"); + + } elseif (($substr_chrs_c_2 == '/*') && + in_array($top['what'], array(SERVICES_JSON_SLICE, SERVICES_JSON_IN_ARR, SERVICES_JSON_IN_OBJ))) { + // found a comment start, and we are in an array, object, or slice + array_push($stk, array('what' => SERVICES_JSON_IN_CMT, 'where' => $c, 'delim' => false)); + $c++; + //print("Found start of comment at {$c}\n"); + + } elseif (($substr_chrs_c_2 == '*/') && ($top['what'] == SERVICES_JSON_IN_CMT)) { + // found a comment end, and we're in one now + array_pop($stk); + $c++; + + for ($i = $top['where']; $i <= $c; ++$i) + $chrs = substr_replace($chrs, ' ', $i, 1); + + //print("Found end of comment at {$c}: ".substr($chrs, $top['where'], (1 + $c - $top['where']))."\n"); + + } + + } + + if (reset($stk) == SERVICES_JSON_IN_ARR) { + return $arr; + + } elseif (reset($stk) == SERVICES_JSON_IN_OBJ) { + return $obj; + + } + + } + } + } + + /** + * @todo Ultimately, this should just call PEAR::isError() + */ + function isError($data, $code = null) + { + if (class_exists('pear')) { + return PEAR::isError($data, $code); + } elseif (is_object($data) && (get_class($data) == 'services_json_error' || + is_subclass_of($data, 'services_json_error'))) { + return true; + } + + return false; + } +} + +if (class_exists('PEAR_Error')) { + + class Services_JSON_Error extends PEAR_Error + { + function Services_JSON_Error($message = 'unknown error', $code = null, + $mode = null, $options = null, $userinfo = null) + { + parent::PEAR_Error($message, $code, $mode, $options, $userinfo); + } + } + +} else { + + /** + * @todo Ultimately, this class shall be descended from PEAR_Error + */ + class Services_JSON_Error + { + function Services_JSON_Error($message = 'unknown error', $code = null, + $mode = null, $options = null, $userinfo = null) + { + + } + } + +} + +?> diff --git a/nest-mootools.v1.11.js b/nest-mootools.v1.11.js new file mode 100644 index 0000000..26cf0c6 --- /dev/null +++ b/nest-mootools.v1.11.js @@ -0,0 +1,7102 @@ +/* +Script: Core.js + Mootools - My Object Oriented javascript. + +License: + MIT-style license. + +MooTools Copyright: + copyright (c) 2007 Valerio Proietti, + +MooTools Credits: + - Class is slightly based on Base.js (c) 2006 Dean Edwards, License + - Some functions are inspired by those found in prototype.js (c) 2005 Sam Stephenson sam [at] conio [dot] net, MIT-style license + - Documentation by Aaron Newton (aaron.newton [at] cnet [dot] com) and Valerio Proietti. +*/ + +var MooTools = { + version: '1.11' +}; + +/* Section: Core Functions */ + +/* +Function: $defined + Returns true if the passed in value/object is defined, that means is not null or undefined. + +Arguments: + obj - object to inspect +*/ + +function $defined(obj){ + return (obj != undefined); +}; + +/* +Function: $type + Returns the type of object that matches the element passed in. + +Arguments: + obj - the object to inspect. + +Example: + >var myString = 'hello'; + >$type(myString); //returns "string" + +Returns: + 'element' - if obj is a DOM element node + 'textnode' - if obj is a DOM text node + 'whitespace' - if obj is a DOM whitespace node + 'arguments' - if obj is an arguments object + 'object' - if obj is an object + 'string' - if obj is a string + 'number' - if obj is a number + 'boolean' - if obj is a boolean + 'function' - if obj is a function + 'regexp' - if obj is a regular expression + 'class' - if obj is a Class. (created with new Class, or the extend of another class). + 'collection' - if obj is a native htmlelements collection, such as childNodes, getElementsByTagName .. etc. + false - (boolean) if the object is not defined or none of the above. +*/ + +function $type(obj){ + if (!$defined(obj)) return false; + if (obj.htmlElement) return 'element'; + var type = typeof obj; + if (type == 'object' && obj.nodeName){ + switch(obj.nodeType){ + case 1: return 'element'; + case 3: return (/\S/).test(obj.nodeValue) ? 'textnode' : 'whitespace'; + } + } + if (type == 'object' || type == 'function'){ + switch(obj.constructor){ + case Array: return 'array'; + case RegExp: return 'regexp'; + case Class: return 'class'; + } + if (typeof obj.length == 'number'){ + if (obj.item) return 'collection'; + if (obj.callee) return 'arguments'; + } + } + return type; +}; + +/* +Function: $merge + merges a number of objects recursively without referencing them or their sub-objects. + +Arguments: + any number of objects. + +Example: + >var mergedObj = $merge(obj1, obj2, obj3); + >//obj1, obj2, and obj3 are unaltered +*/ + +function $merge(){ + var mix = {}; + for (var i = 0; i < arguments.length; i++){ + for (var property in arguments[i]){ + var ap = arguments[i][property]; + var mp = mix[property]; + if (mp && $type(ap) == 'object' && $type(mp) == 'object') mix[property] = $merge(mp, ap); + else mix[property] = ap; + } + } + return mix; +}; + +/* +Function: $extend + Copies all the properties from the second passed object to the first passed Object. + If you do myWhatever.extend = $extend the first parameter will become myWhatever, and your extend function will only need one parameter. + +Example: + (start code) + var firstOb = { + 'name': 'John', + 'lastName': 'Doe' + }; + var secondOb = { + 'age': '20', + 'sex': 'male', + 'lastName': 'Dorian' + }; + $extend(firstOb, secondOb); + //firstOb will become: + { + 'name': 'John', + 'lastName': 'Dorian', + 'age': '20', + 'sex': 'male' + }; + (end) + +Returns: + The first object, extended. +*/ + +var $extend = function(){ + var args = arguments; + if (!args[1]) args = [this, args[0]]; + for (var property in args[1]) args[0][property] = args[1][property]; + return args[0]; +}; + +/* +Function: $native + Will add a .extend method to the objects passed as a parameter, but the property passed in will be copied to the object's prototype only if non previously existent. + Its handy if you dont want the .extend method of an object to overwrite existing methods. + Used automatically in MooTools to implement Array/String/Function/Number methods to browser that dont support them whitout manual checking. + +Arguments: + a number of classes/native javascript objects + +*/ + +var $native = function(){ + for (var i = 0, l = arguments.length; i < l; i++){ + arguments[i].extend = function(props){ + for (var prop in props){ + if (!this.prototype[prop]) this.prototype[prop] = props[prop]; + if (!this[prop]) this[prop] = $native.generic(prop); + } + }; + } +}; + +$native.generic = function(prop){ + return function(bind){ + return this.prototype[prop].apply(bind, Array.prototype.slice.call(arguments, 1)); + }; +}; + +$native(Function, Array, String, Number); + +/* +Function: $chk + Returns true if the passed in value/object exists or is 0, otherwise returns false. + Useful to accept zeroes. + +Arguments: + obj - object to inspect +*/ + +function $chk(obj){ + return !!(obj || obj === 0); +}; + +/* +Function: $pick + Returns the first object if defined, otherwise returns the second. + +Arguments: + obj - object to test + picked - the default to return + +Example: + (start code) + function say(msg){ + alert($pick(msg, 'no meessage supplied')); + } + (end) +*/ + +function $pick(obj, picked){ + return $defined(obj) ? obj : picked; +}; + +/* +Function: $random + Returns a random integer number between the two passed in values. + +Arguments: + min - integer, the minimum value (inclusive). + max - integer, the maximum value (inclusive). + +Returns: + a random integer between min and max. +*/ + +function $random(min, max){ + return Math.floor(Math.random() * (max - min + 1) + min); +}; + +/* +Function: $time + Returns the current timestamp + +Returns: + a timestamp integer. +*/ + +function $time(){ + return new Date().getTime(); +}; + +/* +Function: $clear + clears a timeout or an Interval. + +Returns: + null + +Arguments: + timer - the setInterval or setTimeout to clear. + +Example: + >var myTimer = myFunction.delay(5000); //wait 5 seconds and execute my function. + >myTimer = $clear(myTimer); //nevermind + +See also: + , +*/ + +function $clear(timer){ + clearTimeout(timer); + clearInterval(timer); + return null; +}; + +/* +Class: Abstract + Abstract class, to be used as singleton. Will add .extend to any object + +Arguments: + an object + +Returns: + the object with an .extend property, equivalent to <$extend>. +*/ + +var Abstract = function(obj){ + obj = obj || {}; + obj.extend = $extend; + return obj; +}; + +//window, document + +var Window = new Abstract(window); +var Document = new Abstract(document); +document.head = document.getElementsByTagName('head')[0]; + +/* +Class: window + Some properties are attached to the window object by the browser detection. + +Note: + browser detection is entirely object-based. We dont sniff. + +Properties: + window.ie - will be set to true if the current browser is internet explorer (any). + window.ie6 - will be set to true if the current browser is internet explorer 6. + window.ie7 - will be set to true if the current browser is internet explorer 7. + window.gecko - will be set to true if the current browser is Mozilla/Gecko. + window.webkit - will be set to true if the current browser is Safari/Konqueror. + window.webkit419 - will be set to true if the current browser is Safari2 / webkit till version 419. + window.webkit420 - will be set to true if the current browser is Safari3 (Webkit SVN Build) / webkit over version 419. + window.opera - is set to true by opera itself. +*/ + +window.xpath = !!(document.evaluate); +if (window.ActiveXObject) window.ie = window[window.XMLHttpRequest ? 'ie7' : 'ie6'] = true; +else if (document.childNodes && !document.all && !navigator.taintEnabled) window.webkit = window[window.xpath ? 'webkit420' : 'webkit419'] = true; +else if (document.getBoxObjectFor != null) window.gecko = true; + +/*compatibility*/ + +window.khtml = window.webkit; + +Object.extend = $extend; + +/*end compatibility*/ + +//htmlelement + +if (typeof HTMLElement == 'undefined'){ + var HTMLElement = function(){}; + if (window.webkit) document.createElement("iframe"); //fixes safari + HTMLElement.prototype = (window.webkit) ? window["[[DOMElement.prototype]]"] : {}; +} +HTMLElement.prototype.htmlElement = function(){}; + +//enables background image cache for internet explorer 6 + +if (window.ie6) try {document.execCommand("BackgroundImageCache", false, true);} catch(e){}; + +/* +Script: Class.js + Contains the Class Function, aims to ease the creation of reusable Classes. + +License: + MIT-style license. +*/ + +/* +Class: Class + The base class object of the framework. + Creates a new class, its initialize method will fire upon class instantiation. + Initialize wont fire on instantiation when you pass *null*. + +Arguments: + properties - the collection of properties that apply to the class. + +Example: + (start code) + var Cat = new Class({ + initialize: function(name){ + this.name = name; + } + }); + var myCat = new Cat('Micia'); + alert(myCat.name); //alerts 'Micia' + (end) +*/ + +var Class = function(properties){ + var klass = function(){ + return (arguments[0] !== null && this.initialize && $type(this.initialize) == 'function') ? this.initialize.apply(this, arguments) : this; + }; + $extend(klass, this); + klass.prototype = properties; + klass.constructor = Class; + return klass; +}; + +/* +Property: empty + Returns an empty function +*/ + +Class.empty = function(){}; + +Class.prototype = { + + /* + Property: extend + Returns the copy of the Class extended with the passed in properties. + + Arguments: + properties - the properties to add to the base class in this new Class. + + Example: + (start code) + var Animal = new Class({ + initialize: function(age){ + this.age = age; + } + }); + var Cat = Animal.extend({ + initialize: function(name, age){ + this.parent(age); //will call the previous initialize; + this.name = name; + } + }); + var myCat = new Cat('Micia', 20); + alert(myCat.name); //alerts 'Micia' + alert(myCat.age); //alerts 20 + (end) + */ + + extend: function(properties){ + var proto = new this(null); + for (var property in properties){ + var pp = proto[property]; + proto[property] = Class.Merge(pp, properties[property]); + } + return new Class(proto); + }, + + /* + Property: implement + Implements the passed in properties to the base Class prototypes, altering the base class, unlike . + + Arguments: + properties - the properties to add to the base class. + + Example: + (start code) + var Animal = new Class({ + initialize: function(age){ + this.age = age; + } + }); + Animal.implement({ + setName: function(name){ + this.name = name + } + }); + var myAnimal = new Animal(20); + myAnimal.setName('Micia'); + alert(myAnimal.name); //alerts 'Micia' + (end) + */ + + implement: function(){ + for (var i = 0, l = arguments.length; i < l; i++) $extend(this.prototype, arguments[i]); + } + +}; + +//internal + +Class.Merge = function(previous, current){ + if (previous && previous != current){ + var type = $type(current); + if (type != $type(previous)) return current; + switch(type){ + case 'function': + var merged = function(){ + this.parent = arguments.callee.parent; + return current.apply(this, arguments); + }; + merged.parent = previous; + return merged; + case 'object': return $merge(previous, current); + } + } + return current; +}; + +/* +Script: Class.Extras.js + Contains common implementations for custom classes. In Mootools is implemented in , and and many more. + +License: + MIT-style license. +*/ + +/* +Class: Chain + An "Utility" Class. Its methods can be implemented with into any . + Currently implemented in , and . In for example, is used to execute a list of function, one after another, once the effect is completed. + The functions will not be fired all togheter, but one every completion, to create custom complex animations. + +Example: + (start code) + var myFx = new Fx.Style('element', 'opacity'); + + myFx.start(1,0).chain(function(){ + myFx.start(0,1); + }).chain(function(){ + myFx.start(1,0); + }).chain(function(){ + myFx.start(0,1); + }); + //the element will appear and disappear three times + (end) +*/ + +var Chain = new Class({ + + /* + Property: chain + adds a function to the Chain instance stack. + + Arguments: + fn - the function to append. + */ + + chain: function(fn){ + this.chains = this.chains || []; + this.chains.push(fn); + return this; + }, + + /* + Property: callChain + Executes the first function of the Chain instance stack, then removes it. The first function will then become the second. + */ + + callChain: function(){ + if (this.chains && this.chains.length) this.chains.shift().delay(10, this); + }, + + /* + Property: clearChain + Clears the stack of a Chain instance. + */ + + clearChain: function(){ + this.chains = []; + } + +}); + +/* +Class: Events + An "Utility" Class. Its methods can be implemented with into any . + In Class, for example, is used to give the possibility add any number of functions to the Effects events, like onComplete, onStart, onCancel. + Events in a Class that implements can be either added as an option, or with addEvent. Never with .options.onEventName. + +Example: + (start code) + var myFx = new Fx.Style('element', 'opacity').addEvent('onComplete', function(){ + alert('the effect is completed'); + }).addEvent('onComplete', function(){ + alert('I told you the effect is completed'); + }); + + myFx.start(0,1); + //upon completion it will display the 2 alerts, in order. + (end) + +Implementing: + This class can be implemented into other classes to add the functionality to them. + Goes well with the class. + +Example: + (start code) + var Widget = new Class({ + initialize: function(){}, + finish: function(){ + this.fireEvent('onComplete'); + } + }); + Widget.implement(new Events); + //later... + var myWidget = new Widget(); + myWidget.addEvent('onComplete', myfunction); + (end) +*/ + +var Events = new Class({ + + /* + Property: addEvent + adds an event to the stack of events of the Class instance. + + Arguments: + type - string; the event name (e.g. 'onComplete') + fn - function to execute + */ + + addEvent: function(type, fn){ + if (fn != Class.empty){ + this.$events = this.$events || {}; + this.$events[type] = this.$events[type] || []; + this.$events[type].include(fn); + } + return this; + }, + + /* + Property: fireEvent + fires all events of the specified type in the Class instance. + + Arguments: + type - string; the event name (e.g. 'onComplete') + args - array or single object; arguments to pass to the function; if more than one argument, must be an array + delay - (integer) delay (in ms) to wait to execute the event + + Example: + (start code) + var Widget = new Class({ + initialize: function(arg1, arg2){ + ... + this.fireEvent("onInitialize", [arg1, arg2], 50); + } + }); + Widget.implement(new Events); + (end) + */ + + fireEvent: function(type, args, delay){ + if (this.$events && this.$events[type]){ + this.$events[type].each(function(fn){ + fn.create({'bind': this, 'delay': delay, 'arguments': args})(); + }, this); + } + return this; + }, + + /* + Property: removeEvent + removes an event from the stack of events of the Class instance. + + Arguments: + type - string; the event name (e.g. 'onComplete') + fn - function that was added + */ + + removeEvent: function(type, fn){ + if (this.$events && this.$events[type]) this.$events[type].remove(fn); + return this; + } + +}); + +/* +Class: Options + An "Utility" Class. Its methods can be implemented with into any . + Used to automate the options settings, also adding Class when the option begins with on. + + Example: + (start code) + var Widget = new Class({ + options: { + color: '#fff', + size: { + width: 100 + height: 100 + } + }, + initialize: function(options){ + this.setOptions(options); + } + }); + Widget.implement(new Options); + //later... + var myWidget = new Widget({ + color: '#f00', + size: { + width: 200 + } + }); + //myWidget.options = {color: #f00, size: {width: 200, height: 100}} + (end) +*/ + +var Options = new Class({ + + /* + Property: setOptions + sets this.options + + Arguments: + defaults - object; the default set of options + options - object; the user entered options. can be empty too. + + Note: + if your Class has implemented, every option beginning with on, followed by a capital letter (onComplete) becomes an Class instance event. + */ + + setOptions: function(){ + this.options = $merge.apply(null, [this.options].extend(arguments)); + if (this.addEvent){ + for (var option in this.options){ + if ($type(this.options[option] == 'function') && (/^on[A-Z]/).test(option)) this.addEvent(option, this.options[option]); + } + } + return this; + } + +}); + +/* +Script: Array.js + Contains Array prototypes, <$A>, <$each> + +License: + MIT-style license. +*/ + +/* +Class: Array + A collection of The Array Object prototype methods. +*/ + +//custom methods + +Array.extend({ + + /* + Property: forEach + Iterates through an array; This method is only available for browsers without native *forEach* support. + For more info see + + *forEach* executes the provided function (callback) once for each element present in the array. callback is invoked only for indexes of the array which have assigned values; it is not invoked for indexes which have been deleted or which have never been assigned values. + + Arguments: + fn - function to execute with each item in the array; passed the item and the index of that item in the array + bind - the object to bind "this" to (see ) + + Example: + >['apple','banana','lemon'].each(function(item, index){ + > alert(index + " = " + item); //alerts "0 = apple" etc. + >}, bindObj); //optional second arg for binding, not used here + */ + + forEach: function(fn, bind){ + for (var i = 0, j = this.length; i < j; i++) fn.call(bind, this[i], i, this); + }, + + /* + Property: filter + This method is provided only for browsers without native *filter* support. + For more info see + + *filter* calls a provided callback function once for each element in an array, and constructs a new array of all the values for which callback returns a true value. callback is invoked only for indexes of the array which have assigned values; it is not invoked for indexes which have been deleted or which have never been assigned values. Array elements which do not pass the callback test are simply skipped, and are not included in the new array. + + Arguments: + fn - function to execute with each item in the array; passed the item and the index of that item in the array + bind - the object to bind "this" to (see ) + + Example: + >var biggerThanTwenty = [10,3,25,100].filter(function(item, index){ + > return item > 20; + >}); + >//biggerThanTwenty = [25,100] + */ + + filter: function(fn, bind){ + var results = []; + for (var i = 0, j = this.length; i < j; i++){ + if (fn.call(bind, this[i], i, this)) results.push(this[i]); + } + return results; + }, + + /* + Property: map + This method is provided only for browsers without native *map* support. + For more info see + + *map* calls a provided callback function once for each element in an array, in order, and constructs a new array from the results. callback is invoked only for indexes of the array which have assigned values; it is not invoked for indexes which have been deleted or which have never been assigned values. + + Arguments: + fn - function to execute with each item in the array; passed the item and the index of that item in the array + bind - the object to bind "this" to (see ) + + Example: + >var timesTwo = [1,2,3].map(function(item, index){ + > return item*2; + >}); + >//timesTwo = [2,4,6]; + */ + + map: function(fn, bind){ + var results = []; + for (var i = 0, j = this.length; i < j; i++) results[i] = fn.call(bind, this[i], i, this); + return results; + }, + + /* + Property: every + This method is provided only for browsers without native *every* support. + For more info see + + *every* executes the provided callback function once for each element present in the array until it finds one where callback returns a false value. If such an element is found, the every method immediately returns false. Otherwise, if callback returned a true value for all elements, every will return true. callback is invoked only for indexes of the array which have assigned values; it is not invoked for indexes which have been deleted or which have never been assigned values. + + Arguments: + fn - function to execute with each item in the array; passed the item and the index of that item in the array + bind - the object to bind "this" to (see ) + + Example: + >var areAllBigEnough = [10,4,25,100].every(function(item, index){ + > return item > 20; + >}); + >//areAllBigEnough = false + */ + + every: function(fn, bind){ + for (var i = 0, j = this.length; i < j; i++){ + if (!fn.call(bind, this[i], i, this)) return false; + } + return true; + }, + + /* + Property: some + This method is provided only for browsers without native *some* support. + For more info see + + *some* executes the callback function once for each element present in the array until it finds one where callback returns a true value. If such an element is found, some immediately returns true. Otherwise, some returns false. callback is invoked only for indexes of the array which have assigned values; it is not invoked for indexes which have been deleted or which have never been assigned values. + + Arguments: + fn - function to execute with each item in the array; passed the item and the index of that item in the array + bind - the object to bind "this" to (see ) + + Example: + >var isAnyBigEnough = [10,4,25,100].some(function(item, index){ + > return item > 20; + >}); + >//isAnyBigEnough = true + */ + + some: function(fn, bind){ + for (var i = 0, j = this.length; i < j; i++){ + if (fn.call(bind, this[i], i, this)) return true; + } + return false; + }, + + /* + Property: indexOf + This method is provided only for browsers without native *indexOf* support. + For more info see + + *indexOf* compares a search element to elements of the Array using strict equality (the same method used by the ===, or triple-equals, operator). + + Arguments: + item - any type of object; element to locate in the array + from - integer; optional; the index of the array at which to begin the search (defaults to 0) + + Example: + >['apple','lemon','banana'].indexOf('lemon'); //returns 1 + >['apple','lemon'].indexOf('banana'); //returns -1 + */ + + indexOf: function(item, from){ + var len = this.length; + for (var i = (from < 0) ? Math.max(0, len + from) : from || 0; i < len; i++){ + if (this[i] === item) return i; + } + return -1; + }, + + /* + Property: each + Same as . + + Arguments: + fn - function to execute with each item in the array; passed the item and the index of that item in the array + bind - optional, the object that the "this" of the function will refer to. + + Example: + >var Animals = ['Cat', 'Dog', 'Coala']; + >Animals.each(function(animal){ + > document.write(animal) + >}); + */ + + /* + Property: copy + returns a copy of the array. + + Returns: + a new array which is a copy of the current one. + + Arguments: + start - integer; optional; the index where to start the copy, default is 0. If negative, it is taken as the offset from the end of the array. + length - integer; optional; the number of elements to copy. By default, copies all elements from start to the end of the array. + + Example: + >var letters = ["a","b","c"]; + >var copy = letters.copy(); // ["a","b","c"] (new instance) + */ + + copy: function(start, length){ + start = start || 0; + if (start < 0) start = this.length + start; + length = length || (this.length - start); + var newArray = []; + for (var i = 0; i < length; i++) newArray[i] = this[start++]; + return newArray; + }, + + /* + Property: remove + Removes all occurrences of an item from the array. + + Arguments: + item - the item to remove + + Returns: + the Array with all occurrences of the item removed. + + Example: + >["1","2","3","2"].remove("2") // ["1","3"]; + */ + + remove: function(item){ + var i = 0; + var len = this.length; + while (i < len){ + if (this[i] === item){ + this.splice(i, 1); + len--; + } else { + i++; + } + } + return this; + }, + + /* + Property: contains + Tests an array for the presence of an item. + + Arguments: + item - the item to search for in the array. + from - integer; optional; the index at which to begin the search, default is 0. If negative, it is taken as the offset from the end of the array. + + Returns: + true - the item was found + false - it wasn't + + Example: + >["a","b","c"].contains("a"); // true + >["a","b","c"].contains("d"); // false + */ + + contains: function(item, from){ + return this.indexOf(item, from) != -1; + }, + + /* + Property: associate + Creates an object with key-value pairs based on the array of keywords passed in + and the current content of the array. + + Arguments: + keys - the array of keywords. + + Example: + (start code) + var Animals = ['Cat', 'Dog', 'Coala', 'Lizard']; + var Speech = ['Miao', 'Bau', 'Fruuu', 'Mute']; + var Speeches = Animals.associate(Speech); + //Speeches['Miao'] is now Cat. + //Speeches['Bau'] is now Dog. + //... + (end) + */ + + associate: function(keys){ + var obj = {}, length = Math.min(this.length, keys.length); + for (var i = 0; i < length; i++) obj[keys[i]] = this[i]; + return obj; + }, + + /* + Property: extend + Extends an array with another one. + + Arguments: + array - the array to extend ours with + + Example: + >var Animals = ['Cat', 'Dog', 'Coala']; + >Animals.extend(['Lizard']); + >//Animals is now: ['Cat', 'Dog', 'Coala', 'Lizard']; + */ + + extend: function(array){ + for (var i = 0, j = array.length; i < j; i++) this.push(array[i]); + return this; + }, + + /* + Property: merge + merges an array in another array, without duplicates. (case- and type-sensitive) + + Arguments: + array - the array to merge from. + + Example: + >['Cat','Dog'].merge(['Dog','Coala']); //returns ['Cat','Dog','Coala'] + */ + + merge: function(array){ + for (var i = 0, l = array.length; i < l; i++) this.include(array[i]); + return this; + }, + + /* + Property: include + includes the passed in element in the array, only if its not already present. (case- and type-sensitive) + + Arguments: + item - item to add to the array (if not present) + + Example: + >['Cat','Dog'].include('Dog'); //returns ['Cat','Dog'] + >['Cat','Dog'].include('Coala'); //returns ['Cat','Dog','Coala'] + */ + + include: function(item){ + if (!this.contains(item)) this.push(item); + return this; + }, + + /* + Property: getRandom + returns a random item in the Array + */ + + getRandom: function(){ + return this[$random(0, this.length - 1)] || null; + }, + + /* + Property: getLast + returns the last item in the Array + */ + + getLast: function(){ + return this[this.length - 1] || null; + } + +}); + +//copies + +Array.prototype.each = Array.prototype.forEach; +Array.each = Array.forEach; + +/* Section: Utility Functions */ + +/* +Function: $A() + Same as , but as function. + Useful to apply Array prototypes to iterable objects, as a collection of DOM elements or the arguments object. + +Example: + (start code) + function myFunction(){ + $A(arguments).each(argument, function(){ + alert(argument); + }); + }; + //the above will alert all the arguments passed to the function myFunction. + (end) +*/ + +function $A(array){ + return Array.copy(array); +}; + +/* +Function: $each + Use to iterate through iterables that are not regular arrays, such as builtin getElementsByTagName calls, arguments of a function, or an object. + +Arguments: + iterable - an iterable element or an objct. + function - function to apply to the iterable. + bind - optional, the 'this' of the function will refer to this object. + +Function argument: + The function argument will be passed the following arguments. + + item - the current item in the iterator being procesed + index - integer; the index of the item, or key in case of an object. + +Examples: + (start code) + $each(['Sun','Mon','Tue'], function(day, index){ + alert('name:' + day + ', index: ' + index); + }); + //alerts "name: Sun, index: 0", "name: Mon, index: 1", etc. + //over an object + $each({first: "Sunday", second: "Monday", third: "Tuesday"}, function(value, key){ + alert("the " + key + " day of the week is " + value); + }); + //alerts "the first day of the week is Sunday", + //"the second day of the week is Monday", etc. + (end) +*/ + +function $each(iterable, fn, bind){ + if (iterable && typeof iterable.length == 'number' && $type(iterable) != 'object'){ + Array.forEach(iterable, fn, bind); + } else { + for (var name in iterable) fn.call(bind || iterable, iterable[name], name); + } +}; + +/*compatibility*/ + +Array.prototype.test = Array.prototype.contains; + +/*end compatibility*/ + +/* +Script: String.js + Contains String prototypes. + +License: + MIT-style license. +*/ + +/* +Class: String + A collection of The String Object prototype methods. +*/ + +String.extend({ + + /* + Property: test + Tests a string with a regular expression. + + Arguments: + regex - a string or regular expression object, the regular expression you want to match the string with + params - optional, if first parameter is a string, any parameters you want to pass to the regex ('g' has no effect) + + Returns: + true if a match for the regular expression is found in the string, false if not. + See + + Example: + >"I like cookies".test("cookie"); // returns true + >"I like cookies".test("COOKIE", "i") // ignore case, returns true + >"I like cookies".test("cake"); // returns false + */ + + test: function(regex, params){ + return (($type(regex) == 'string') ? new RegExp(regex, params) : regex).test(this); + }, + + /* + Property: toInt + parses a string to an integer. + + Returns: + either an int or "NaN" if the string is not a number. + + Example: + >var value = "10px".toInt(); // value is 10 + */ + + toInt: function(){ + return parseInt(this, 10); + }, + + /* + Property: toFloat + parses a string to an float. + + Returns: + either a float or "NaN" if the string is not a number. + + Example: + >var value = "10.848".toFloat(); // value is 10.848 + */ + + toFloat: function(){ + return parseFloat(this); + }, + + /* + Property: camelCase + Converts a hiphenated string to a camelcase string. + + Example: + >"I-like-cookies".camelCase(); //"ILikeCookies" + + Returns: + the camel cased string + */ + + camelCase: function(){ + return this.replace(/-\D/g, function(match){ + return match.charAt(1).toUpperCase(); + }); + }, + + /* + Property: hyphenate + Converts a camelCased string to a hyphen-ated string. + + Example: + >"ILikeCookies".hyphenate(); //"I-like-cookies" + */ + + hyphenate: function(){ + return this.replace(/\w[A-Z]/g, function(match){ + return (match.charAt(0) + '-' + match.charAt(1).toLowerCase()); + }); + }, + + /* + Property: capitalize + Converts the first letter in each word of a string to Uppercase. + + Example: + >"i like cookies".capitalize(); //"I Like Cookies" + + Returns: + the capitalized string + */ + + capitalize: function(){ + return this.replace(/\b[a-z]/g, function(match){ + return match.toUpperCase(); + }); + }, + + /* + Property: trim + Trims the leading and trailing spaces off a string. + + Example: + >" i like cookies ".trim() //"i like cookies" + + Returns: + the trimmed string + */ + + trim: function(){ + return this.replace(/^\s+|\s+$/g, ''); + }, + + /* + Property: clean + trims () a string AND removes all the double spaces in a string. + + Returns: + the cleaned string + + Example: + >" i like cookies \n\n".clean() //"i like cookies" + */ + + clean: function(){ + return this.replace(/\s{2,}/g, ' ').trim(); + }, + + /* + Property: rgbToHex + Converts an RGB value to hexidecimal. The string must be in the format of "rgb(255,255,255)" or "rgba(255,255,255,1)"; + + Arguments: + array - boolean value, defaults to false. Use true if you want the array ['FF','33','00'] as output instead of "#FF3300" + + Returns: + hex string or array. returns "transparent" if the output is set as string and the fourth value of rgba in input string is 0. + + Example: + >"rgb(17,34,51)".rgbToHex(); //"#112233" + >"rgba(17,34,51,0)".rgbToHex(); //"transparent" + >"rgb(17,34,51)".rgbToHex(true); //['11','22','33'] + */ + + rgbToHex: function(array){ + var rgb = this.match(/\d{1,3}/g); + return (rgb) ? rgb.rgbToHex(array) : false; + }, + + /* + Property: hexToRgb + Converts a hexidecimal color value to RGB. Input string must be the hex color value (with or without the hash). Also accepts triplets ('333'); + + Arguments: + array - boolean value, defaults to false. Use true if you want the array [255,255,255] as output instead of "rgb(255,255,255)"; + + Returns: + rgb string or array. + + Example: + >"#112233".hexToRgb(); //"rgb(17,34,51)" + >"#112233".hexToRgb(true); //[17,34,51] + */ + + hexToRgb: function(array){ + var hex = this.match(/^#?(\w{1,2})(\w{1,2})(\w{1,2})$/); + return (hex) ? hex.slice(1).hexToRgb(array) : false; + }, + + /* + Property: contains + checks if the passed in string is contained in the String. also accepts an optional second parameter, to check if the string is contained in a list of separated values. + + Example: + >'a b c'.contains('c', ' '); //true + >'a bc'.contains('bc'); //true + >'a bc'.contains('b', ' '); //false + */ + + contains: function(string, s){ + return (s) ? (s + this + s).indexOf(s + string + s) > -1 : this.indexOf(string) > -1; + }, + + /* + Property: escapeRegExp + Returns string with escaped regular expression characters + + Example: + >var search = 'animals.sheeps[1]'.escapeRegExp(); // search is now 'animals\.sheeps\[1\]' + + Returns: + Escaped string + */ + + escapeRegExp: function(){ + return this.replace(/([.*+?^${}()|[\]\/\\])/g, '\\$1'); + } + +}); + +Array.extend({ + + /* + Property: rgbToHex + see , but as an array method. + */ + + rgbToHex: function(array){ + if (this.length < 3) return false; + if (this.length == 4 && this[3] == 0 && !array) return 'transparent'; + var hex = []; + for (var i = 0; i < 3; i++){ + var bit = (this[i] - 0).toString(16); + hex.push((bit.length == 1) ? '0' + bit : bit); + } + return array ? hex : '#' + hex.join(''); + }, + + /* + Property: hexToRgb + same as , but as an array method. + */ + + hexToRgb: function(array){ + if (this.length != 3) return false; + var rgb = []; + for (var i = 0; i < 3; i++){ + rgb.push(parseInt((this[i].length == 1) ? this[i] + this[i] : this[i], 16)); + } + return array ? rgb : 'rgb(' + rgb.join(',') + ')'; + } + +}); + +/* +Script: Function.js + Contains Function prototypes and utility functions . + +License: + MIT-style license. + +Credits: + - Some functions are inspired by those found in prototype.js (c) 2005 Sam Stephenson sam [at] conio [dot] net, MIT-style license +*/ + +/* +Class: Function + A collection of The Function Object prototype methods. +*/ + +Function.extend({ + + /* + Property: create + Main function to create closures. + + Returns: + a function. + + Arguments: + options - An Options object. + + Options: + bind - The object that the "this" of the function will refer to. Default is the current function. + event - If set to true, the function will act as an event listener and receive an event as first argument. + If set to a class name, the function will receive a new instance of this class (with the event passed as argument's constructor) as first argument. + Default is false. + arguments - A single argument or array of arguments that will be passed to the function when called. + + If both the event and arguments options are set, the event is passed as first argument and the arguments array will follow. + + Default is no custom arguments, the function will receive the standard arguments when called. + + delay - Numeric value: if set, the returned function will delay the actual execution by this amount of milliseconds and return a timer handle when called. + Default is no delay. + periodical - Numeric value: if set, the returned function will periodically perform the actual execution with this specified interval and return a timer handle when called. + Default is no periodical execution. + attempt - If set to true, the returned function will try to execute and return either the results or false on error. Default is false. + */ + + create: function(options){ + var fn = this; + options = $merge({ + 'bind': fn, + 'event': false, + 'arguments': null, + 'delay': false, + 'periodical': false, + 'attempt': false + }, options); + if ($chk(options.arguments) && $type(options.arguments) != 'array') options.arguments = [options.arguments]; + return function(event){ + var args; + if (options.event){ + event = event || window.event; + args = [(options.event === true) ? event : new options.event(event)]; + if (options.arguments) args.extend(options.arguments); + } + else args = options.arguments || arguments; + var returns = function(){ + return fn.apply($pick(options.bind, fn), args); + }; + if (options.delay) return setTimeout(returns, options.delay); + if (options.periodical) return setInterval(returns, options.periodical); + if (options.attempt) try {return returns();} catch(err){return false;}; + return returns(); + }; + }, + + /* + Property: pass + Shortcut to create closures with arguments and bind. + + Returns: + a function. + + Arguments: + args - the arguments passed. must be an array if arguments > 1 + bind - optional, the object that the "this" of the function will refer to. + + Example: + >myFunction.pass([arg1, arg2], myElement); + */ + + pass: function(args, bind){ + return this.create({'arguments': args, 'bind': bind}); + }, + + /* + Property: attempt + Tries to execute the function, returns either the result of the function or false on error. + + Arguments: + args - the arguments passed. must be an array if arguments > 1 + bind - optional, the object that the "this" of the function will refer to. + + Example: + >myFunction.attempt([arg1, arg2], myElement); + */ + + attempt: function(args, bind){ + return this.create({'arguments': args, 'bind': bind, 'attempt': true})(); + }, + + /* + Property: bind + method to easily create closures with "this" altered. + + Arguments: + bind - optional, the object that the "this" of the function will refer to. + args - optional, the arguments passed. must be an array if arguments > 1 + + Returns: + a function. + + Example: + >function myFunction(){ + > this.setStyle('color', 'red'); + > // note that 'this' here refers to myFunction, not an element + > // we'll need to bind this function to the element we want to alter + >}; + >var myBoundFunction = myFunction.bind(myElement); + >myBoundFunction(); // this will make the element myElement red. + */ + + bind: function(bind, args){ + return this.create({'bind': bind, 'arguments': args}); + }, + + /* + Property: bindAsEventListener + cross browser method to pass event firer + + Arguments: + bind - optional, the object that the "this" of the function will refer to. + args - optional, the arguments passed. must be an array if arguments > 1 + + Returns: + a function with the parameter bind as its "this" and as a pre-passed argument event or window.event, depending on the browser. + + Example: + >function myFunction(event){ + > alert(event.clientx) //returns the coordinates of the mouse.. + >}; + >myElement.onclick = myFunction.bindAsEventListener(myElement); + */ + + bindAsEventListener: function(bind, args){ + return this.create({'bind': bind, 'event': true, 'arguments': args}); + }, + + /* + Property: delay + Delays the execution of a function by a specified duration. + + Arguments: + delay - the duration to wait in milliseconds. + bind - optional, the object that the "this" of the function will refer to. + args - optional, the arguments passed. must be an array if arguments > 1 + + Example: + >myFunction.delay(50, myElement) //wait 50 milliseconds, then call myFunction and bind myElement to it + >(function(){alert('one second later...')}).delay(1000); //wait a second and alert + */ + + delay: function(delay, bind, args){ + return this.create({'delay': delay, 'bind': bind, 'arguments': args})(); + }, + + /* + Property: periodical + Executes a function in the specified intervals of time + + Arguments: + interval - the duration of the intervals between executions. + bind - optional, the object that the "this" of the function will refer to. + args - optional, the arguments passed. must be an array if arguments > 1 + */ + + periodical: function(interval, bind, args){ + return this.create({'periodical': interval, 'bind': bind, 'arguments': args})(); + } + +}); + +/* +Script: Number.js + Contains the Number prototypes. + +License: + MIT-style license. +*/ + +/* +Class: Number + A collection of The Number Object prototype methods. +*/ + +Number.extend({ + + /* + Property: toInt + Returns this number; useful because toInt must work on both Strings and Numbers. + */ + + toInt: function(){ + return parseInt(this); + }, + + /* + Property: toFloat + Returns this number as a float; useful because toFloat must work on both Strings and Numbers. + */ + + toFloat: function(){ + return parseFloat(this); + }, + + /* + Property: limit + Limits the number. + + Arguments: + min - number, minimum value + max - number, maximum value + + Returns: + the number in the given limits. + + Example: + >(12).limit(2, 6.5) // returns 6.5 + >(-4).limit(2, 6.5) // returns 2 + >(4.3).limit(2, 6.5) // returns 4.3 + */ + + limit: function(min, max){ + return Math.min(max, Math.max(min, this)); + }, + + /* + Property: round + Returns the number rounded to specified precision. + + Arguments: + precision - integer, number of digits after the decimal point. Can also be negative or zero (default). + + Example: + >12.45.round() // returns 12 + >12.45.round(1) // returns 12.5 + >12.45.round(-1) // returns 10 + + Returns: + The rounded number. + */ + + round: function(precision){ + precision = Math.pow(10, precision || 0); + return Math.round(this * precision) / precision; + }, + + /* + Property: times + Executes a passed in function the specified number of times + + Arguments: + function - the function to be executed on each iteration of the loop + + Example: + >(4).times(alert); + */ + + times: function(fn){ + for (var i = 0; i < this; i++) fn(i); + } + +}); + +/* +Script: Element.js + Contains useful Element prototypes, to be used with the dollar function <$>. + +License: + MIT-style license. + +Credits: + - Some functions are inspired by those found in prototype.js (c) 2005 Sam Stephenson sam [at] conio [dot] net, MIT-style license +*/ + +/* +Class: Element + Custom class to allow all of its methods to be used with any DOM element via the dollar function <$>. +*/ + +var Element = new Class({ + + /* + Property: initialize + Creates a new element of the type passed in. + + Arguments: + el - string; the tag name for the element you wish to create. you can also pass in an element reference, in which case it will be extended. + props - object; the properties you want to add to your element. + Accepts the same keys as , but also allows events and styles + + Props: + the key styles will be used as setStyles, the key events will be used as addEvents. any other key is used as setProperty. + + Example: + (start code) + new Element('a', { + 'styles': { + 'display': 'block', + 'border': '1px solid black' + }, + 'events': { + 'click': function(){ + //aaa + }, + 'mousedown': function(){ + //aaa + } + }, + 'class': 'myClassSuperClass', + 'href': 'http://mad4milk.net' + }); + + (end) + */ + + initialize: function(el, props){ + if ($type(el) == 'string'){ + if (window.ie && props && (props.name || props.type)){ + var name = (props.name) ? ' name="' + props.name + '"' : ''; + var type = (props.type) ? ' type="' + props.type + '"' : ''; + delete props.name; + delete props.type; + el = '<' + el + name + type + '>'; + } + el = document.createElement(el); + } + el = $(el); + return (!props || !el) ? el : el.set(props); + } + +}); + +/* +Class: Elements + - Every dom function such as <$$>, or in general every function that returns a collection of nodes in mootools, returns them as an Elements class. + - The purpose of the Elements class is to allow methods to work also on array. + - Elements is also an Array, so it accepts all the methods. + - Every node of the Elements instance is already extended with <$>. + +Example: + >$$('myselector').each(function(el){ + > //... + >}); + + some iterations here, $$('myselector') is also an array. + + >$$('myselector').setStyle('color', 'red'); + every element returned by $$('myselector') also accepts methods, in this example every element will be made red. +*/ + +var Elements = new Class({ + + initialize: function(elements){ + return (elements) ? $extend(elements, this) : this; + } + +}); + +Elements.extend = function(props){ + for (var prop in props){ + this.prototype[prop] = props[prop]; + this[prop] = $native.generic(prop); + } +}; + +/* +Section: Utility Functions + +Function: $ + returns the element passed in with all the Element prototypes applied. + +Arguments: + el - a reference to an actual element or a string representing the id of an element + +Example: + >$('myElement') // gets a DOM element by id with all the Element prototypes applied. + >var div = document.getElementById('myElement'); + >$(div) //returns an Element also with all the mootools extentions applied. + + You'll use this when you aren't sure if a variable is an actual element or an id, as + well as just shorthand for document.getElementById(). + +Returns: + a DOM element or false (if no id was found). + +Note: + you need to call $ on an element only once to get all the prototypes. + But its no harm to call it multiple times, as it will detect if it has been already extended. +*/ + +function $(el){ + if (!el) return null; + if (el.htmlElement) return Garbage.collect(el); + if ([window, document].contains(el)) return el; + var type = $type(el); + if (type == 'string'){ + el = document.getElementById(el); + type = (el) ? 'element' : false; + } + if (type != 'element') return null; + if (el.htmlElement) return Garbage.collect(el); + if (['object', 'embed'].contains(el.tagName.toLowerCase())) return el; + $extend(el, Element.prototype); + el.htmlElement = function(){}; + return Garbage.collect(el); +}; + +/* +Function: $$ + Selects, and extends DOM elements. Elements arrays returned with $$ will also accept all the methods. + The return type of element methods run through $$ is always an array. If the return array is only made by elements, + $$ will be applied automatically. + +Arguments: + HTML Collections, arrays of elements, arrays of strings as element ids, elements, strings as selectors. + Any number of the above as arguments are accepted. + +Note: + if you load , $$ will also accept CSS Selectors, otherwise the only selectors supported are tag names. + +Example: + >$$('a') //an array of all anchor tags on the page + >$$('a', 'b') //an array of all anchor and bold tags on the page + >$$('#myElement') //array containing only the element with id = myElement. (only with ) + >$$('#myElement a.myClass') //an array of all anchor tags with the class "myClass" + >//within the DOM element with id "myElement" (only with ) + >$$(myelement, myelement2, 'a', ['myid', myid2, 'myid3'], document.getElementsByTagName('div')) //an array containing: + >// the element referenced as myelement if existing, + >// the element referenced as myelement2 if existing, + >// all the elements with a as tag in the page, + >// the element with id = myid if existing + >// the element with id = myid2 if existing + >// the element with id = myid3 if existing + >// all the elements with div as tag in the page + +Returns: + array - array of all the dom elements matched, extended with <$>. Returns as . +*/ + +document.getElementsBySelector = document.getElementsByTagName; + +function $$(){ + var elements = []; + for (var i = 0, j = arguments.length; i < j; i++){ + var selector = arguments[i]; + switch($type(selector)){ + case 'element': elements.push(selector); + case 'boolean': break; + case false: break; + case 'string': selector = document.getElementsBySelector(selector, true); + default: elements.extend(selector); + } + } + return $$.unique(elements); +}; + +$$.unique = function(array){ + var elements = []; + for (var i = 0, l = array.length; i < l; i++){ + if (array[i].$included) continue; + var element = $(array[i]); + if (element && !element.$included){ + element.$included = true; + elements.push(element); + } + } + for (var n = 0, d = elements.length; n < d; n++) elements[n].$included = null; + return new Elements(elements); +}; + +Elements.Multi = function(property){ + return function(){ + var args = arguments; + var items = []; + var elements = true; + for (var i = 0, j = this.length, returns; i < j; i++){ + returns = this[i][property].apply(this[i], args); + if ($type(returns) != 'element') elements = false; + items.push(returns); + }; + return (elements) ? $$.unique(items) : items; + }; +}; + +Element.extend = function(properties){ + for (var property in properties){ + HTMLElement.prototype[property] = properties[property]; + Element.prototype[property] = properties[property]; + Element[property] = $native.generic(property); + var elementsProperty = (Array.prototype[property]) ? property + 'Elements' : property; + Elements.prototype[elementsProperty] = Elements.Multi(property); + } +}; + +/* +Class: Element + Custom class to allow all of its methods to be used with any DOM element via the dollar function <$>. +*/ + +Element.extend({ + + /* + Property: set + you can set events, styles and properties with this shortcut. same as calling new Element. + */ + + set: function(props){ + for (var prop in props){ + var val = props[prop]; + switch(prop){ + case 'styles': this.setStyles(val); break; + case 'events': if (this.addEvents) this.addEvents(val); break; + case 'properties': this.setProperties(val); break; + default: this.setProperty(prop, val); + } + } + return this; + }, + + inject: function(el, where){ + el = $(el); + switch(where){ + case 'before': el.parentNode.insertBefore(this, el); break; + case 'after': + var next = el.getNext(); + if (!next) el.parentNode.appendChild(this); + else el.parentNode.insertBefore(this, next); + break; + case 'top': + var first = el.firstChild; + if (first){ + el.insertBefore(this, first); + break; + } + default: el.appendChild(this); + } + return this; + }, + + /* + Property: injectBefore + Inserts the Element before the passed element. + + Arguments: + el - an element reference or the id of the element to be injected in. + + Example: + >html: + >
+ >
+ >js: + >$('mySecondElement').injectBefore('myElement'); + >resulting html: + >
+ >
+ */ + + injectBefore: function(el){ + return this.inject(el, 'before'); + }, + + /* + Property: injectAfter + Same as , but inserts the element after. + */ + + injectAfter: function(el){ + return this.inject(el, 'after'); + }, + + /* + Property: injectInside + Same as , but inserts the element inside. + */ + + injectInside: function(el){ + return this.inject(el, 'bottom'); + }, + + /* + Property: injectTop + Same as , but inserts the element inside, at the top. + */ + + injectTop: function(el){ + return this.inject(el, 'top'); + }, + + /* + Property: adopt + Inserts the passed elements inside the Element. + + Arguments: + accepts elements references, element ids as string, selectors ($$('stuff')) / array of elements, array of ids as strings and collections. + */ + + adopt: function(){ + var elements = []; + $each(arguments, function(argument){ + elements = elements.concat(argument); + }); + $$(elements).inject(this); + return this; + }, + + /* + Property: remove + Removes the Element from the DOM. + + Example: + >$('myElement').remove() //bye bye + */ + + remove: function(){ + return this.parentNode.removeChild(this); + }, + + /* + Property: clone + Clones the Element and returns the cloned one. + + Arguments: + contents - boolean, when true the Element is cloned with childNodes, default true + + Returns: + the cloned element + + Example: + >var clone = $('myElement').clone().injectAfter('myElement'); + >//clones the Element and append the clone after the Element. + */ + + clone: function(contents){ + var el = $(this.cloneNode(contents !== false)); + if (!el.$events) return el; + el.$events = {}; + for (var type in this.$events) el.$events[type] = { + 'keys': $A(this.$events[type].keys), + 'values': $A(this.$events[type].values) + }; + return el.removeEvents(); + }, + + /* + Property: replaceWith + Replaces the Element with an element passed. + + Arguments: + el - a string representing the element to be injected in (myElementId, or div), or an element reference. + If you pass div or another tag, the element will be created. + + Returns: + the passed in element + + Example: + >$('myOldElement').replaceWith($('myNewElement')); //$('myOldElement') is gone, and $('myNewElement') is in its place. + */ + + replaceWith: function(el){ + el = $(el); + this.parentNode.replaceChild(el, this); + return el; + }, + + /* + Property: appendText + Appends text node to a DOM element. + + Arguments: + text - the text to append. + + Example: + >
hey
+ >$('myElement').appendText(' howdy'); //myElement innerHTML is now "hey howdy" + */ + + appendText: function(text){ + this.appendChild(document.createTextNode(text)); + return this; + }, + + /* + Property: hasClass + Tests the Element to see if it has the passed in className. + + Returns: + true - the Element has the class + false - it doesn't + + Arguments: + className - string; the class name to test. + + Example: + >
+ >$('myElement').hasClass('testClass'); //returns true + */ + + hasClass: function(className){ + return this.className.contains(className, ' '); + }, + + /* + Property: addClass + Adds the passed in class to the Element, if the element doesnt already have it. + + Arguments: + className - string; the class name to add + + Example: + >
+ >$('myElement').addClass('newClass'); //
+ */ + + addClass: function(className){ + if (!this.hasClass(className)) this.className = (this.className + ' ' + className).clean(); + return this; + }, + + /* + Property: removeClass + Works like , but removes the class from the element. + */ + + removeClass: function(className){ + this.className = this.className.replace(new RegExp('(^|\\s)' + className + '(?:\\s|$)'), '$1').clean(); + return this; + }, + + /* + Property: toggleClass + Adds or removes the passed in class name to the element, depending on if it's present or not. + + Arguments: + className - the class to add or remove + + Example: + >
+ >$('myElement').toggleClass('myClass'); + >
+ >$('myElement').toggleClass('myClass'); + >
+ */ + + toggleClass: function(className){ + return this.hasClass(className) ? this.removeClass(className) : this.addClass(className); + }, + + /* + Property: setStyle + Sets a css property to the Element. + + Arguments: + property - the property to set + value - the value to which to set it; for numeric values that require "px" you can pass an integer + + Example: + >$('myElement').setStyle('width', '300px'); //the width is now 300px + >$('myElement').setStyle('width', 300); //the width is now 300px + */ + + setStyle: function(property, value){ + switch(property){ + case 'opacity': return this.setOpacity(parseFloat(value)); + case 'float': property = (window.ie) ? 'styleFloat' : 'cssFloat'; + } + property = property.camelCase(); + switch($type(value)){ + case 'number': if (!['zIndex', 'zoom'].contains(property)) value += 'px'; break; + case 'array': value = 'rgb(' + value.join(',') + ')'; + } + this.style[property] = value; + return this; + }, + + /* + Property: setStyles + Applies a collection of styles to the Element. + + Arguments: + source - an object or string containing all the styles to apply. When its a string it overrides old style. + + Examples: + >$('myElement').setStyles({ + > border: '1px solid #000', + > width: 300, + > height: 400 + >}); + + OR + + >$('myElement').setStyles('border: 1px solid #000; width: 300px; height: 400px;'); + */ + + setStyles: function(source){ + switch($type(source)){ + case 'object': Element.setMany(this, 'setStyle', source); break; + case 'string': this.style.cssText = source; + } + return this; + }, + + /* + Property: setOpacity + Sets the opacity of the Element, and sets also visibility == "hidden" if opacity == 0, and visibility = "visible" if opacity > 0. + + Arguments: + opacity - float; Accepts values from 0 to 1. + + Example: + >$('myElement').setOpacity(0.5) //make it 50% transparent + */ + + setOpacity: function(opacity){ + if (opacity == 0){ + if (this.style.visibility != "hidden") this.style.visibility = "hidden"; + } else { + if (this.style.visibility != "visible") this.style.visibility = "visible"; + } + if (!this.currentStyle || !this.currentStyle.hasLayout) this.style.zoom = 1; + if (window.ie) this.style.filter = (opacity == 1) ? '' : "alpha(opacity=" + opacity * 100 + ")"; + this.style.opacity = this.$tmp.opacity = opacity; + return this; + }, + + /* + Property: getStyle + Returns the style of the Element given the property passed in. + + Arguments: + property - the css style property you want to retrieve + + Example: + >$('myElement').getStyle('width'); //returns "400px" + >//but you can also use + >$('myElement').getStyle('width').toInt(); //returns 400 + + Returns: + the style as a string + */ + + getStyle: function(property){ + property = property.camelCase(); + var result = this.style[property]; + if (!$chk(result)){ + if (property == 'opacity') return this.$tmp.opacity; + result = []; + for (var style in Element.Styles){ + if (property == style){ + Element.Styles[style].each(function(s){ + var style = this.getStyle(s); + result.push(parseInt(style) ? style : '0px'); + }, this); + if (property == 'border'){ + var every = result.every(function(bit){ + return (bit == result[0]); + }); + return (every) ? result[0] : false; + } + return result.join(' '); + } + } + if (property.contains('border')){ + if (Element.Styles.border.contains(property)){ + return ['Width', 'Style', 'Color'].map(function(p){ + return this.getStyle(property + p); + }, this).join(' '); + } else if (Element.borderShort.contains(property)){ + return ['Top', 'Right', 'Bottom', 'Left'].map(function(p){ + return this.getStyle('border' + p + property.replace('border', '')); + }, this).join(' '); + } + } + if (document.defaultView) result = document.defaultView.getComputedStyle(this, null).getPropertyValue(property.hyphenate()); + else if (this.currentStyle) result = this.currentStyle[property]; + } + if (window.ie) result = Element.fixStyle(property, result, this); + if (result && property.test(/color/i) && result.contains('rgb')){ + return result.split('rgb').splice(1,4).map(function(color){ + return color.rgbToHex(); + }).join(' '); + } + return result; + }, + + /* + Property: getStyles + Returns an object of styles of the Element for each argument passed in. + Arguments: + properties - strings; any number of style properties + Example: + >$('myElement').getStyles('width','height','padding'); + >//returns an object like: + >{width: "10px", height: "10px", padding: "10px 0px 10px 0px"} + */ + + getStyles: function(){ + return Element.getMany(this, 'getStyle', arguments); + }, + + walk: function(brother, start){ + brother += 'Sibling'; + var el = (start) ? this[start] : this[brother]; + while (el && $type(el) != 'element') el = el[brother]; + return $(el); + }, + + /* + Property: getPrevious + Returns the previousSibling of the Element, excluding text nodes. + + Example: + >$('myElement').getPrevious(); //get the previous DOM element from myElement + + Returns: + the sibling element or undefined if none found. + */ + + getPrevious: function(){ + return this.walk('previous'); + }, + + /* + Property: getNext + Works as Element.getPrevious, but tries to find the nextSibling. + */ + + getNext: function(){ + return this.walk('next'); + }, + + /* + Property: getFirst + Works as , but tries to find the firstChild. + */ + + getFirst: function(){ + return this.walk('next', 'firstChild'); + }, + + /* + Property: getLast + Works as , but tries to find the lastChild. + */ + + getLast: function(){ + return this.walk('previous', 'lastChild'); + }, + + /* + Property: getParent + returns the $(element.parentNode) + */ + + getParent: function(){ + return $(this.parentNode); + }, + + /* + Property: getChildren + returns all the $(element.childNodes), excluding text nodes. Returns as . + */ + + getChildren: function(){ + return $$(this.childNodes); + }, + + /* + Property: hasChild + returns true if the passed in element is a child of the $(element). + */ + + hasChild: function(el){ + return !!$A(this.getElementsByTagName('*')).contains(el); + }, + + /* + Property: getProperty + Gets the an attribute of the Element. + + Arguments: + property - string; the attribute to retrieve + + Example: + >$('myImage').getProperty('src') // returns whatever.gif + + Returns: + the value, or an empty string + */ + + getProperty: function(property){ + var index = Element.Properties[property]; + if (index) return this[index]; + var flag = Element.PropertiesIFlag[property] || 0; + if (!window.ie || flag) return this.getAttribute(property, flag); + var node = this.attributes[property]; + return (node) ? node.nodeValue : null; + }, + + /* + Property: removeProperty + Removes an attribute from the Element + + Arguments: + property - string; the attribute to remove + */ + + removeProperty: function(property){ + var index = Element.Properties[property]; + if (index) this[index] = ''; + else this.removeAttribute(property); + return this; + }, + + /* + Property: getProperties + same as , but for properties + */ + + getProperties: function(){ + return Element.getMany(this, 'getProperty', arguments); + }, + + /* + Property: setProperty + Sets an attribute for the Element. + + Arguments: + property - string; the property to assign the value passed in + value - the value to assign to the property passed in + + Example: + >$('myImage').setProperty('src', 'whatever.gif'); //myImage now points to whatever.gif for its source + */ + + setProperty: function(property, value){ + var index = Element.Properties[property]; + if (index) this[index] = value; + else this.setAttribute(property, value); + return this; + }, + + /* + Property: setProperties + Sets numerous attributes for the Element. + + Arguments: + source - an object with key/value pairs. + + Example: + (start code) + $('myElement').setProperties({ + src: 'whatever.gif', + alt: 'whatever dude' + }); + whatever dude + (end) + */ + + setProperties: function(source){ + return Element.setMany(this, 'setProperty', source); + }, + + /* + Property: setHTML + Sets the innerHTML of the Element. + + Arguments: + html - string; the new innerHTML for the element. + + Example: + >$('myElement').setHTML(newHTML) //the innerHTML of myElement is now = newHTML + */ + + setHTML: function(){ + this.innerHTML = $A(arguments).join(''); + return this; + }, + + /* + Property: setText + Sets the inner text of the Element. + + Arguments: + text - string; the new text content for the element. + + Example: + >$('myElement').setText('some text') //the text of myElement is now = 'some text' + */ + + setText: function(text){ + var tag = this.getTag(); + if (['style', 'script'].contains(tag)){ + if (window.ie){ + if (tag == 'style') this.styleSheet.cssText = text; + else if (tag == 'script') this.setProperty('text', text); + return this; + } else { + this.removeChild(this.firstChild); + return this.appendText(text); + } + } + this[$defined(this.innerText) ? 'innerText' : 'textContent'] = text; + return this; + }, + + /* + Property: getText + Gets the inner text of the Element. + */ + + getText: function(){ + var tag = this.getTag(); + if (['style', 'script'].contains(tag)){ + if (window.ie){ + if (tag == 'style') return this.styleSheet.cssText; + else if (tag == 'script') return this.getProperty('text'); + } else { + return this.innerHTML; + } + } + return ($pick(this.innerText, this.textContent)); + }, + + /* + Property: getTag + Returns the tagName of the element in lower case. + + Example: + >$('myImage').getTag() // returns 'img' + + Returns: + The tag name in lower case + */ + + getTag: function(){ + return this.tagName.toLowerCase(); + }, + + /* + Property: empty + Empties an element of all its children. + + Example: + >$('myDiv').empty() // empties the Div and returns it + + Returns: + The element. + */ + + empty: function(){ + Garbage.trash(this.getElementsByTagName('*')); + return this.setHTML(''); + } + +}); + +Element.fixStyle = function(property, result, element){ + if ($chk(parseInt(result))) return result; + if (['height', 'width'].contains(property)){ + var values = (property == 'width') ? ['left', 'right'] : ['top', 'bottom']; + var size = 0; + values.each(function(value){ + size += element.getStyle('border-' + value + '-width').toInt() + element.getStyle('padding-' + value).toInt(); + }); + return element['offset' + property.capitalize()] - size + 'px'; + } else if (property.test(/border(.+)Width|margin|padding/)){ + return '0px'; + } + return result; +}; + +Element.Styles = {'border': [], 'padding': [], 'margin': []}; +['Top', 'Right', 'Bottom', 'Left'].each(function(direction){ + for (var style in Element.Styles) Element.Styles[style].push(style + direction); +}); + +Element.borderShort = ['borderWidth', 'borderStyle', 'borderColor']; + +Element.getMany = function(el, method, keys){ + var result = {}; + $each(keys, function(key){ + result[key] = el[method](key); + }); + return result; +}; + +Element.setMany = function(el, method, pairs){ + for (var key in pairs) el[method](key, pairs[key]); + return el; +}; + +Element.Properties = new Abstract({ + 'class': 'className', 'for': 'htmlFor', 'colspan': 'colSpan', 'rowspan': 'rowSpan', + 'accesskey': 'accessKey', 'tabindex': 'tabIndex', 'maxlength': 'maxLength', + 'readonly': 'readOnly', 'frameborder': 'frameBorder', 'value': 'value', + 'disabled': 'disabled', 'checked': 'checked', 'multiple': 'multiple', 'selected': 'selected' +}); +Element.PropertiesIFlag = { + 'href': 2, 'src': 2 +}; + +Element.Methods = { + Listeners: { + addListener: function(type, fn){ + if (this.addEventListener) this.addEventListener(type, fn, false); + else this.attachEvent('on' + type, fn); + return this; + }, + + removeListener: function(type, fn){ + if (this.removeEventListener) this.removeEventListener(type, fn, false); + else this.detachEvent('on' + type, fn); + return this; + } + } +}; + +window.extend(Element.Methods.Listeners); +document.extend(Element.Methods.Listeners); +Element.extend(Element.Methods.Listeners); + +var Garbage = { + + elements: [], + + collect: function(el){ + if (!el.$tmp){ + Garbage.elements.push(el); + el.$tmp = {'opacity': 1}; + } + return el; + }, + + trash: function(elements){ + for (var i = 0, j = elements.length, el; i < j; i++){ + if (!(el = elements[i]) || !el.$tmp) continue; + if (el.$events) el.fireEvent('trash').removeEvents(); + for (var p in el.$tmp) el.$tmp[p] = null; + for (var d in Element.prototype) el[d] = null; + Garbage.elements[Garbage.elements.indexOf(el)] = null; + el.htmlElement = el.$tmp = el = null; + } + Garbage.elements.remove(null); + }, + + empty: function(){ + Garbage.collect(window); + Garbage.collect(document); + Garbage.trash(Garbage.elements); + } + +}; + +window.addListener('beforeunload', function(){ + window.addListener('unload', Garbage.empty); + if (window.ie) window.addListener('unload', CollectGarbage); +}); + +/* +Script: Element.Event.js + Contains the Event Class, Element methods to deal with Element events, custom Events, and the Function prototype bindWithEvent. + +License: + MIT-style license. +*/ + +/* +Class: Event + Cross browser methods to manage events. + +Arguments: + event - the event + +Properties: + shift - true if the user pressed the shift + control - true if the user pressed the control + alt - true if the user pressed the alt + meta - true if the user pressed the meta key + wheel - the amount of third button scrolling + code - the keycode of the key pressed + page.x - the x position of the mouse, relative to the full window + page.y - the y position of the mouse, relative to the full window + client.x - the x position of the mouse, relative to the viewport + client.y - the y position of the mouse, relative to the viewport + key - the key pressed as a lowercase string. key also returns 'enter', 'up', 'down', 'left', 'right', 'space', 'backspace', 'delete', 'esc'. Handy for these special keys. + target - the event target + relatedTarget - the event related target + +Example: + (start code) + $('myLink').onkeydown = function(event){ + var event = new Event(event); + //event is now the Event class. + alert(event.key); //returns the lowercase letter pressed + alert(event.shift); //returns true if the key pressed is shift + if (event.key == 's' && event.control) alert('document saved'); + }; + (end) +*/ + +var Event = new Class({ + + initialize: function(event){ + if (event && event.$extended) return event; + this.$extended = true; + event = event || window.event; + this.event = event; + this.type = event.type; + this.target = event.target || event.srcElement; + if (this.target.nodeType == 3) this.target = this.target.parentNode; + this.shift = event.shiftKey; + this.control = event.ctrlKey; + this.alt = event.altKey; + this.meta = event.metaKey; + if (['DOMMouseScroll', 'mousewheel'].contains(this.type)){ + this.wheel = (event.wheelDelta) ? event.wheelDelta / 120 : -(event.detail || 0) / 3; + } else if (this.type.contains('key')){ + this.code = event.which || event.keyCode; + for (var name in Event.keys){ + if (Event.keys[name] == this.code){ + this.key = name; + break; + } + } + if (this.type == 'keydown'){ + var fKey = this.code - 111; + if (fKey > 0 && fKey < 13) this.key = 'f' + fKey; + } + this.key = this.key || String.fromCharCode(this.code).toLowerCase(); + } else if (this.type.test(/(click|mouse|menu)/)){ + this.page = { + 'x': event.pageX || event.clientX + document.documentElement.scrollLeft, + 'y': event.pageY || event.clientY + document.documentElement.scrollTop + }; + this.client = { + 'x': event.pageX ? event.pageX - window.pageXOffset : event.clientX, + 'y': event.pageY ? event.pageY - window.pageYOffset : event.clientY + }; + this.rightClick = (event.which == 3) || (event.button == 2); + switch(this.type){ + case 'mouseover': this.relatedTarget = event.relatedTarget || event.fromElement; break; + case 'mouseout': this.relatedTarget = event.relatedTarget || event.toElement; + } + this.fixRelatedTarget(); + } + return this; + }, + + /* + Property: stop + cross browser method to stop an event + */ + + stop: function(){ + return this.stopPropagation().preventDefault(); + }, + + /* + Property: stopPropagation + cross browser method to stop the propagation of an event + */ + + stopPropagation: function(){ + if (this.event.stopPropagation) this.event.stopPropagation(); + else this.event.cancelBubble = true; + return this; + }, + + /* + Property: preventDefault + cross browser method to prevent the default action of the event + */ + + preventDefault: function(){ + if (this.event.preventDefault) this.event.preventDefault(); + else this.event.returnValue = false; + return this; + } + +}); + +Event.fix = { + + relatedTarget: function(){ + if (this.relatedTarget && this.relatedTarget.nodeType == 3) this.relatedTarget = this.relatedTarget.parentNode; + }, + + relatedTargetGecko: function(){ + try {Event.fix.relatedTarget.call(this);} catch(e){this.relatedTarget = this.target;} + } + +}; + +Event.prototype.fixRelatedTarget = (window.gecko) ? Event.fix.relatedTargetGecko : Event.fix.relatedTarget; + +/* +Property: keys + you can add additional Event keys codes this way: + +Example: + (start code) + Event.keys.whatever = 80; + $(myelement).addEvent(keydown, function(event){ + event = new Event(event); + if (event.key == 'whatever') console.log(whatever key clicked). + }); + (end) +*/ + +Event.keys = new Abstract({ + 'enter': 13, + 'up': 38, + 'down': 40, + 'left': 37, + 'right': 39, + 'esc': 27, + 'space': 32, + 'backspace': 8, + 'tab': 9, + 'delete': 46 +}); + +/* +Class: Element + Custom class to allow all of its methods to be used with any DOM element via the dollar function <$>. +*/ + +Element.Methods.Events = { + + /* + Property: addEvent + Attaches an event listener to a DOM element. + + Arguments: + type - the event to monitor ('click', 'load', etc) without the prefix 'on'. + fn - the function to execute + + Example: + >$('myElement').addEvent('click', function(){alert('clicked!')}); + */ + + addEvent: function(type, fn){ + this.$events = this.$events || {}; + this.$events[type] = this.$events[type] || {'keys': [], 'values': []}; + if (this.$events[type].keys.contains(fn)) return this; + this.$events[type].keys.push(fn); + var realType = type; + var custom = Element.Events[type]; + if (custom){ + if (custom.add) custom.add.call(this, fn); + if (custom.map) fn = custom.map; + if (custom.type) realType = custom.type; + } + if (!this.addEventListener) fn = fn.create({'bind': this, 'event': true}); + this.$events[type].values.push(fn); + return (Element.NativeEvents.contains(realType)) ? this.addListener(realType, fn) : this; + }, + + /* + Property: removeEvent + Works as Element.addEvent, but instead removes the previously added event listener. + */ + + removeEvent: function(type, fn){ + if (!this.$events || !this.$events[type]) return this; + var pos = this.$events[type].keys.indexOf(fn); + if (pos == -1) return this; + var key = this.$events[type].keys.splice(pos,1)[0]; + var value = this.$events[type].values.splice(pos,1)[0]; + var custom = Element.Events[type]; + if (custom){ + if (custom.remove) custom.remove.call(this, fn); + if (custom.type) type = custom.type; + } + return (Element.NativeEvents.contains(type)) ? this.removeListener(type, value) : this; + }, + + /* + Property: addEvents + As , but accepts an object and add multiple events at once. + */ + + addEvents: function(source){ + return Element.setMany(this, 'addEvent', source); + }, + + /* + Property: removeEvents + removes all events of a certain type from an element. if no argument is passed in, removes all events. + + Arguments: + type - string; the event name (e.g. 'click') + */ + + removeEvents: function(type){ + if (!this.$events) return this; + if (!type){ + for (var evType in this.$events) this.removeEvents(evType); + this.$events = null; + } else if (this.$events[type]){ + this.$events[type].keys.each(function(fn){ + this.removeEvent(type, fn); + }, this); + this.$events[type] = null; + } + return this; + }, + + /* + Property: fireEvent + executes all events of the specified type present in the element. + + Arguments: + type - string; the event name (e.g. 'click') + args - array or single object; arguments to pass to the function; if more than one argument, must be an array + delay - (integer) delay (in ms) to wait to execute the event + */ + + fireEvent: function(type, args, delay){ + if (this.$events && this.$events[type]){ + this.$events[type].keys.each(function(fn){ + fn.create({'bind': this, 'delay': delay, 'arguments': args})(); + }, this); + } + return this; + }, + + /* + Property: cloneEvents + Clones all events from an element to this element. + + Arguments: + from - element, copy all events from this element + type - optional, copies only events of this type + */ + + cloneEvents: function(from, type){ + if (!from.$events) return this; + if (!type){ + for (var evType in from.$events) this.cloneEvents(from, evType); + } else if (from.$events[type]){ + from.$events[type].keys.each(function(fn){ + this.addEvent(type, fn); + }, this); + } + return this; + } + +}; + +window.extend(Element.Methods.Events); +document.extend(Element.Methods.Events); +Element.extend(Element.Methods.Events); + +/* Section: Custom Events */ + +Element.Events = new Abstract({ + + /* + Event: mouseenter + In addition to the standard javascript events (load, mouseover, mouseout, click, etc.) contains two custom events + this event fires when the mouse enters the area of the dom element; will not be fired again if the mouse crosses over children of the element (unlike mouseover) + + + Example: + >$(myElement).addEvent('mouseenter', myFunction); + */ + + 'mouseenter': { + type: 'mouseover', + map: function(event){ + event = new Event(event); + if (event.relatedTarget != this && !this.hasChild(event.relatedTarget)) this.fireEvent('mouseenter', event); + } + }, + + /* + Event: mouseleave + this event fires when the mouse exits the area of the dom element; will not be fired again if the mouse crosses over children of the element (unlike mouseout) + + + Example: + >$(myElement).addEvent('mouseleave', myFunction); + */ + + 'mouseleave': { + type: 'mouseout', + map: function(event){ + event = new Event(event); + if (event.relatedTarget != this && !this.hasChild(event.relatedTarget)) this.fireEvent('mouseleave', event); + } + }, + + 'mousewheel': { + type: (window.gecko) ? 'DOMMouseScroll' : 'mousewheel' + } + +}); + +Element.NativeEvents = [ + 'click', 'dblclick', 'mouseup', 'mousedown', //mouse buttons + 'mousewheel', 'DOMMouseScroll', //mouse wheel + 'mouseover', 'mouseout', 'mousemove', //mouse movement + 'keydown', 'keypress', 'keyup', //keys + 'load', 'unload', 'beforeunload', 'resize', 'move', //window + 'focus', 'blur', 'change', 'submit', 'reset', 'select', //forms elements + 'error', 'abort', 'contextmenu', 'scroll' //misc +]; + +/* +Class: Function + A collection of The Function Object prototype methods. +*/ + +Function.extend({ + + /* + Property: bindWithEvent + automatically passes MooTools Event Class. + + Arguments: + bind - optional, the object that the "this" of the function will refer to. + args - optional, an argument to pass to the function; if more than one argument, it must be an array of arguments. + + Returns: + a function with the parameter bind as its "this" and as a pre-passed argument event or window.event, depending on the browser. + + Example: + >function myFunction(event){ + > alert(event.client.x) //returns the coordinates of the mouse.. + >}; + >myElement.addEvent('click', myFunction.bindWithEvent(myElement)); + */ + + bindWithEvent: function(bind, args){ + return this.create({'bind': bind, 'arguments': args, 'event': Event}); + } + +}); + + +/* +Script: Element.Filters.js + add Filters capability to . + +License: + MIT-style license. +*/ + +/* +Class: Elements + A collection of methods to be used with <$$> elements collections. +*/ + +Elements.extend({ + + /* + Property: filterByTag + Filters the collection by a specified tag name. + Returns a new Elements collection, while the original remains untouched. + */ + + filterByTag: function(tag){ + return new Elements(this.filter(function(el){ + return (Element.getTag(el) == tag); + })); + }, + + /* + Property: filterByClass + Filters the collection by a specified class name. + Returns a new Elements collection, while the original remains untouched. + */ + + filterByClass: function(className, nocash){ + var elements = this.filter(function(el){ + return (el.className && el.className.contains(className, ' ')); + }); + return (nocash) ? elements : new Elements(elements); + }, + + /* + Property: filterById + Filters the collection by a specified ID. + Returns a new Elements collection, while the original remains untouched. + */ + + filterById: function(id, nocash){ + var elements = this.filter(function(el){ + return (el.id == id); + }); + return (nocash) ? elements : new Elements(elements); + }, + + /* + Property: filterByAttribute + Filters the collection by a specified attribute. + Returns a new Elements collection, while the original remains untouched. + + Arguments: + name - the attribute name. + operator - optional, the attribute operator. + value - optional, the attribute value, only valid if the operator is specified. + */ + + filterByAttribute: function(name, operator, value, nocash){ + var elements = this.filter(function(el){ + var current = Element.getProperty(el, name); + if (!current) return false; + if (!operator) return true; + switch(operator){ + case '=': return (current == value); + case '*=': return (current.contains(value)); + case '^=': return (current.substr(0, value.length) == value); + case '$=': return (current.substr(current.length - value.length) == value); + case '!=': return (current != value); + case '~=': return current.contains(value, ' '); + } + return false; + }); + return (nocash) ? elements : new Elements(elements); + } + +}); + +/* +Script: Element.Selectors.js + Css Query related functions and extensions + +License: + MIT-style license. +*/ + +/* Section: Utility Functions */ + +/* +Function: $E + Selects a single (i.e. the first found) Element based on the selector passed in and an optional filter element. + Returns as . + +Arguments: + selector - string; the css selector to match + filter - optional; a DOM element to limit the scope of the selector match; defaults to document. + +Example: + >$E('a', 'myElement') //find the first anchor tag inside the DOM element with id 'myElement' + +Returns: + a DOM element - the first element that matches the selector +*/ + +function $E(selector, filter){ + return ($(filter) || document).getElement(selector); +}; + +/* +Function: $ES + Returns a collection of Elements that match the selector passed in limited to the scope of the optional filter. + See Also: for an alternate syntax. + Returns as . + +Returns: + an array of dom elements that match the selector within the filter + +Arguments: + selector - string; css selector to match + filter - optional; a DOM element to limit the scope of the selector match; defaults to document. + +Examples: + >$ES("a") //gets all the anchor tags; synonymous with $$("a") + >$ES('a','myElement') //get all the anchor tags within $('myElement') +*/ + +function $ES(selector, filter){ + return ($(filter) || document).getElementsBySelector(selector); +}; + +$$.shared = { + + 'regexp': /^(\w*|\*)(?:#([\w-]+)|\.([\w-]+))?(?:\[(\w+)(?:([!*^$]?=)["']?([^"'\]]*)["']?)?])?$/, + + 'xpath': { + + getParam: function(items, context, param, i){ + var temp = [context.namespaceURI ? 'xhtml:' : '', param[1]]; + if (param[2]) temp.push('[@id="', param[2], '"]'); + if (param[3]) temp.push('[contains(concat(" ", @class, " "), " ', param[3], ' ")]'); + if (param[4]){ + if (param[5] && param[6]){ + switch(param[5]){ + case '*=': temp.push('[contains(@', param[4], ', "', param[6], '")]'); break; + case '^=': temp.push('[starts-with(@', param[4], ', "', param[6], '")]'); break; + case '$=': temp.push('[substring(@', param[4], ', string-length(@', param[4], ') - ', param[6].length, ' + 1) = "', param[6], '"]'); break; + case '=': temp.push('[@', param[4], '="', param[6], '"]'); break; + case '!=': temp.push('[@', param[4], '!="', param[6], '"]'); + } + } else { + temp.push('[@', param[4], ']'); + } + } + items.push(temp.join('')); + return items; + }, + + getItems: function(items, context, nocash){ + var elements = []; + var xpath = document.evaluate('.//' + items.join('//'), context, $$.shared.resolver, XPathResult.UNORDERED_NODE_SNAPSHOT_TYPE, null); + for (var i = 0, j = xpath.snapshotLength; i < j; i++) elements.push(xpath.snapshotItem(i)); + return (nocash) ? elements : new Elements(elements.map($)); + } + + }, + + 'normal': { + + getParam: function(items, context, param, i){ + if (i == 0){ + if (param[2]){ + var el = context.getElementById(param[2]); + if (!el || ((param[1] != '*') && (Element.getTag(el) != param[1]))) return false; + items = [el]; + } else { + items = $A(context.getElementsByTagName(param[1])); + } + } else { + items = $$.shared.getElementsByTagName(items, param[1]); + if (param[2]) items = Elements.filterById(items, param[2], true); + } + if (param[3]) items = Elements.filterByClass(items, param[3], true); + if (param[4]) items = Elements.filterByAttribute(items, param[4], param[5], param[6], true); + return items; + }, + + getItems: function(items, context, nocash){ + return (nocash) ? items : $$.unique(items); + } + + }, + + resolver: function(prefix){ + return (prefix == 'xhtml') ? 'http://www.w3.org/1999/xhtml' : false; + }, + + getElementsByTagName: function(context, tagName){ + var found = []; + for (var i = 0, j = context.length; i < j; i++) found.extend(context[i].getElementsByTagName(tagName)); + return found; + } + +}; + +$$.shared.method = (window.xpath) ? 'xpath' : 'normal'; + +/* +Class: Element + Custom class to allow all of its methods to be used with any DOM element via the dollar function <$>. +*/ + +Element.Methods.Dom = { + + /* + Property: getElements + Gets all the elements within an element that match the given (single) selector. + Returns as . + + Arguments: + selector - string; the css selector to match + + Examples: + >$('myElement').getElements('a'); // get all anchors within myElement + >$('myElement').getElements('input[name=dialog]') //get all input tags with name 'dialog' + >$('myElement').getElements('input[name$=log]') //get all input tags with names ending with 'log' + + Notes: + Supports these operators in attribute selectors: + + - = : is equal to + - ^= : starts-with + - $= : ends-with + - != : is not equal to + + Xpath is used automatically for compliant browsers. + */ + + getElements: function(selector, nocash){ + var items = []; + selector = selector.trim().split(' '); + for (var i = 0, j = selector.length; i < j; i++){ + var sel = selector[i]; + var param = sel.match($$.shared.regexp); + if (!param) break; + param[1] = param[1] || '*'; + var temp = $$.shared[$$.shared.method].getParam(items, this, param, i); + if (!temp) break; + items = temp; + } + return $$.shared[$$.shared.method].getItems(items, this, nocash); + }, + + /* + Property: getElement + Same as , but returns only the first. Alternate syntax for <$E>, where filter is the Element. + Returns as . + + Arguments: + selector - string; css selector + */ + + getElement: function(selector){ + return $(this.getElements(selector, true)[0] || false); + }, + + /* + Property: getElementsBySelector + Same as , but allows for comma separated selectors, as in css. Alternate syntax for <$$>, where filter is the Element. + Returns as . + + Arguments: + selector - string; css selector + */ + + getElementsBySelector: function(selector, nocash){ + var elements = []; + selector = selector.split(','); + for (var i = 0, j = selector.length; i < j; i++) elements = elements.concat(this.getElements(selector[i], true)); + return (nocash) ? elements : $$.unique(elements); + } + +}; + +Element.extend({ + + /* + Property: getElementById + Targets an element with the specified id found inside the Element. Does not overwrite document.getElementById. + + Arguments: + id - string; the id of the element to find. + */ + + getElementById: function(id){ + var el = document.getElementById(id); + if (!el) return false; + for (var parent = el.parentNode; parent != this; parent = parent.parentNode){ + if (!parent) return false; + } + return el; + }/*compatibility*/, + + getElementsByClassName: function(className){ + return this.getElements('.' + className); + } + + /*end compatibility*/ + +}); + +document.extend(Element.Methods.Dom); +Element.extend(Element.Methods.Dom); + +/* +Script: Element.Form.js + Contains Element prototypes to deal with Forms and their elements. + +License: + MIT-style license. +*/ + +/* +Class: Element + Custom class to allow all of its methods to be used with any DOM element via the dollar function <$>. +*/ + +Element.extend({ + + /* + Property: getValue + Returns the value of the Element, if its tag is textarea, select or input. getValue called on a multiple select will return an array. + */ + + getValue: function(){ + switch(this.getTag()){ + case 'select': + var values = []; + $each(this.options, function(option){ + if (option.selected) values.push($pick(option.value, option.text)); + }); + return (this.multiple) ? values : values[0]; + case 'input': if (!(this.checked && ['checkbox', 'radio'].contains(this.type)) && !['hidden', 'text', 'password'].contains(this.type)) break; + case 'textarea': return this.value; + } + return false; + }, + + getFormElements: function(){ + return $$(this.getElementsByTagName('input'), this.getElementsByTagName('select'), this.getElementsByTagName('textarea')); + }, + + /* + Property: toQueryString + Reads the children inputs of the Element and generates a query string, based on their values. Used internally in + + Example: + (start code) +
+ + +
+ + + (end) + + Returns: + email=bob@bob.com&zipCode=90210 + */ + + toQueryString: function(){ + var queryString = []; + this.getFormElements().each(function(el){ + var name = el.name; + var value = el.getValue(); + if (value === false || !name || el.disabled) return; + var qs = function(val){ + queryString.push(name + '=' + encodeURIComponent(val)); + }; + if ($type(value) == 'array') value.each(qs); + else qs(value); + }); + return queryString.join('&'); + } + +}); + +/* +Script: Element.Dimensions.js + Contains Element prototypes to deal with Element size and position in space. + +Note: + The functions in this script require n XHTML doctype. + +License: + MIT-style license. +*/ + +/* +Class: Element + Custom class to allow all of its methods to be used with any DOM element via the dollar function <$>. +*/ + +Element.extend({ + + /* + Property: scrollTo + Scrolls the element to the specified coordinated (if the element has an overflow) + + Arguments: + x - the x coordinate + y - the y coordinate + + Example: + >$('myElement').scrollTo(0, 100) + */ + + scrollTo: function(x, y){ + this.scrollLeft = x; + this.scrollTop = y; + }, + + /* + Property: getSize + Return an Object representing the size/scroll values of the element. + + Example: + (start code) + $('myElement').getSize(); + (end) + + Returns: + (start code) + { + 'scroll': {'x': 100, 'y': 100}, + 'size': {'x': 200, 'y': 400}, + 'scrollSize': {'x': 300, 'y': 500} + } + (end) + */ + + getSize: function(){ + return { + 'scroll': {'x': this.scrollLeft, 'y': this.scrollTop}, + 'size': {'x': this.offsetWidth, 'y': this.offsetHeight}, + 'scrollSize': {'x': this.scrollWidth, 'y': this.scrollHeight} + }; + }, + + /* + Property: getPosition + Returns the real offsets of the element. + + Arguments: + overflown - optional, an array of nested scrolling containers for scroll offset calculation, use this if your element is inside any element containing scrollbars + + Example: + >$('element').getPosition(); + + Returns: + >{x: 100, y:500}; + */ + + getPosition: function(overflown){ + overflown = overflown || []; + var el = this, left = 0, top = 0; + do { + left += el.offsetLeft || 0; + top += el.offsetTop || 0; + el = el.offsetParent; + } while (el); + overflown.each(function(element){ + left -= element.scrollLeft || 0; + top -= element.scrollTop || 0; + }); + return {'x': left, 'y': top}; + }, + + /* + Property: getTop + Returns the distance from the top of the window to the Element. + + Arguments: + overflown - optional, an array of nested scrolling containers, see Element::getPosition + */ + + getTop: function(overflown){ + return this.getPosition(overflown).y; + }, + + /* + Property: getLeft + Returns the distance from the left of the window to the Element. + + Arguments: + overflown - optional, an array of nested scrolling containers, see Element::getPosition + */ + + getLeft: function(overflown){ + return this.getPosition(overflown).x; + }, + + /* + Property: getCoordinates + Returns an object with width, height, left, right, top, and bottom, representing the values of the Element + + Arguments: + overflown - optional, an array of nested scrolling containers, see Element::getPosition + + Example: + (start code) + var myValues = $('myElement').getCoordinates(); + (end) + + Returns: + (start code) + { + width: 200, + height: 300, + left: 100, + top: 50, + right: 300, + bottom: 350 + } + (end) + */ + + getCoordinates: function(overflown){ + var position = this.getPosition(overflown); + var obj = { + 'width': this.offsetWidth, + 'height': this.offsetHeight, + 'left': position.x, + 'top': position.y + }; + obj.right = obj.left + obj.width; + obj.bottom = obj.top + obj.height; + return obj; + } + +}); + +/* +Script: Window.DomReady.js + Contains the custom event domready, for window. + +License: + MIT-style license. +*/ + +/* Section: Custom Events */ + +/* +Event: domready + executes a function when the dom tree is loaded, without waiting for images. Only works when called from window. + +Credits: + (c) Dean Edwards/Matthias Miller/John Resig, remastered for MooTools. + +Arguments: + fn - the function to execute when the DOM is ready + +Example: + > window.addEvent('domready', function(){ + > alert('the dom is ready'); + > }); +*/ + +Element.Events.domready = { + + add: function(fn){ + if (window.loaded){ + fn.call(this); + return; + } + var domReady = function(){ + if (window.loaded) return; + window.loaded = true; + window.timer = $clear(window.timer); + this.fireEvent('domready'); + }.bind(this); + if (document.readyState && window.webkit){ + window.timer = function(){ + if (['loaded','complete'].contains(document.readyState)) domReady(); + }.periodical(50); + } else if (document.readyState && window.ie){ + if (!$('ie_ready')){ + var src = (window.location.protocol == 'https:') ? '://0' : 'javascript:void(0)'; + document.write(' + (end) + */ + + send: function(options){ + return new Ajax(this.getProperty('action'), $merge({data: this.toQueryString()}, options, {method: 'post'})).request(); + } + +}); + +/* +Script: Cookie.js + A cookie reader/creator + +Credits: + based on the functions by Peter-Paul Koch (http://quirksmode.org) +*/ + +/* +Class: Cookie + Class for creating, getting, and removing cookies. +*/ + +var Cookie = new Abstract({ + + options: { + domain: false, + path: false, + duration: false, + secure: false + }, + + /* + Property: set + Sets a cookie in the browser. + + Arguments: + key - the key (name) for the cookie + value - the value to set, cannot contain semicolons + options - an object representing the Cookie options. See Options below. Default values are stored in Cookie.options. + + Options: + domain - the domain the Cookie belongs to. If you want to share the cookie with pages located on a different domain, you have to set this value. Defaults to the current domain. + path - the path the Cookie belongs to. If you want to share the cookie with pages located in a different path, you have to set this value, for example to "/" to share the cookie with all pages on the domain. Defaults to the current path. + duration - the duration of the Cookie before it expires, in days. + If set to false or 0, the cookie will be a session cookie that expires when the browser is closed. This is default. + secure - Stored cookie information can be accessed only from a secure environment. + + Returns: + An object with the options, the key and the value. You can give it as first parameter to Cookie.remove. + + Example: + >Cookie.set('username', 'Harald'); // session cookie (duration is false), or ... + >Cookie.set('username', 'JackBauer', {duration: 1}); // save this for 1 day + + */ + + set: function(key, value, options){ + options = $merge(this.options, options); + value = encodeURIComponent(value); + if (options.domain) value += '; domain=' + options.domain; + if (options.path) value += '; path=' + options.path; + if (options.duration){ + var date = new Date(); + date.setTime(date.getTime() + options.duration * 24 * 60 * 60 * 1000); + value += '; expires=' + date.toGMTString(); + } + if (options.secure) value += '; secure'; + document.cookie = key + '=' + value; + return $extend(options, {'key': key, 'value': value}); + }, + + /* + Property: get + Gets the value of a cookie. + + Arguments: + key - the name of the cookie you wish to retrieve. + + Returns: + The cookie string value, or false if not found. + + Example: + >Cookie.get("username") //returns JackBauer + */ + + get: function(key){ + var value = document.cookie.match('(?:^|;)\\s*' + key.escapeRegExp() + '=([^;]*)'); + return value ? decodeURIComponent(value[1]) : false; + }, + + /* + Property: remove + Removes a cookie from the browser. + + Arguments: + cookie - the name of the cookie to remove or a previous cookie (for domains) + options - optional. you can also pass the domain and path here. Same as options in + + Examples: + >Cookie.remove('username') //bye-bye JackBauer, cya in 24 hours + > + >var myCookie = Cookie.set('username', 'Aaron', {domain: 'mootools.net'}); // Cookie.set returns an object with all values need to remove the cookie + >Cookie.remove(myCookie); + */ + + remove: function(cookie, options){ + if ($type(cookie) == 'object') this.set(cookie.key, '', $merge(cookie, {duration: -1})); + else this.set(cookie, '', $merge(options, {duration: -1})); + } + +}); + +/* +Script: Json.js + Simple Json parser and Stringyfier, See: + +License: + MIT-style license. +*/ + +/* +Class: Json + Simple Json parser and Stringyfier, See: +*/ + +var Json = { + + /* + Property: toString + Converts an object to a string, to be passed in server-side scripts as a parameter. Although its not normal usage for this class, this method can also be used to convert functions and arrays to strings. + + Arguments: + obj - the object to convert to string + + Returns: + A json string + + Example: + (start code) + Json.toString({apple: 'red', lemon: 'yellow'}); '{"apple":"red","lemon":"yellow"}' + (end) + */ + + toString: function(obj){ + switch($type(obj)){ + case 'string': + return '"' + obj.replace(/(["\\])/g, '\\$1') + '"'; + case 'array': + return '[' + obj.map(Json.toString).join(',') + ']'; + case 'object': + var string = []; + for (var property in obj) string.push(Json.toString(property) + ':' + Json.toString(obj[property])); + return '{' + string.join(',') + '}'; + case 'number': + if (isFinite(obj)) break; + case false: + return 'null'; + } + return String(obj); + }, + + /* + Property: evaluate + converts a json string to an javascript Object. + + Arguments: + str - the string to evaluate. if its not a string, it returns false. + secure - optionally, performs syntax check on json string. Defaults to false. + + Credits: + Json test regexp is by Douglas Crockford . + + Example: + >var myObject = Json.evaluate('{"apple":"red","lemon":"yellow"}'); + >//myObject will become {apple: 'red', lemon: 'yellow'} + */ + + evaluate: function(str, secure){ + return (($type(str) != 'string') || (secure && !str.test(/^("(\\.|[^"\\\n\r])*?"|[,:{}\[\]0-9.\-+Eaeflnr-u \n\r\t])+?$/))) ? null : eval('(' + str + ')'); + } + +}; + +/* +Script: Json.Remote.js + Contains . + +License: + MIT-style license. +*/ + +/* +Class: Json.Remote + Wrapped XHR with automated sending and receiving of Javascript Objects in Json Format. + Inherits methods, properties, options and events from . + +Arguments: + url - the url you want to send your object to. + options - see options + +Example: + this code will send user information based on name/last name + (start code) + var jSonRequest = new Json.Remote("http://site.com/tellMeAge.php", {onComplete: function(person){ + alert(person.age); //is 25 years + alert(person.height); //is 170 cm + alert(person.weight); //is 120 kg + }}).send({'name': 'John', 'lastName': 'Doe'}); + (end) +*/ + +Json.Remote = XHR.extend({ + + initialize: function(url, options){ + this.url = url; + this.addEvent('onSuccess', this.onComplete); + this.parent(options); + this.setHeader('X-Request', 'JSON'); + }, + + send: function(obj){ + return this.parent(this.url, 'json=' + Json.toString(obj)); + }, + + onComplete: function(){ + this.fireEvent('onComplete', [Json.evaluate(this.response.text, this.options.secure)]); + } + +}); + +/* +Script: Assets.js + provides dynamic loading for images, css and javascript files. + +License: + MIT-style license. +*/ + +var Asset = new Abstract({ + + /* + Property: javascript + Injects a javascript file in the page. + + Arguments: + source - the path of the javascript file + properties - some additional attributes you might want to add to the script element + + Example: + > new Asset.javascript('/scripts/myScript.js', {id: 'myScript'}); + */ + + javascript: function(source, properties){ + properties = $merge({ + 'onload': Class.empty + }, properties); + var script = new Element('script', {'src': source}).addEvents({ + 'load': properties.onload, + 'readystatechange': function(){ + if (this.readyState == 'complete') this.fireEvent('load'); + } + }); + delete properties.onload; + return script.setProperties(properties).inject(document.head); + }, + + /* + Property: css + Injects a css file in the page. + + Arguments: + source - the path of the css file + properties - some additional attributes you might want to add to the link element + + Example: + > new Asset.css('/css/myStyle.css', {id: 'myStyle', title: 'myStyle'}); + */ + + css: function(source, properties){ + return new Element('link', $merge({ + 'rel': 'stylesheet', 'media': 'screen', 'type': 'text/css', 'href': source + }, properties)).inject(document.head); + }, + + /* + Property: image + Preloads an image and returns the img element. does not inject it to the page. + + Arguments: + source - the path of the image file + properties - some additional attributes you might want to add to the img element + + Example: + > new Asset.image('/images/myImage.png', {id: 'myImage', title: 'myImage', onload: myFunction}); + + Returns: + the img element. you can inject it anywhere you want with // + */ + + image: function(source, properties){ + properties = $merge({ + 'onload': Class.empty, + 'onabort': Class.empty, + 'onerror': Class.empty + }, properties); + var image = new Image(); + image.src = source; + var element = new Element('img', {'src': source}); + ['load', 'abort', 'error'].each(function(type){ + var event = properties['on' + type]; + delete properties['on' + type]; + element.addEvent(type, function(){ + this.removeEvent(type, arguments.callee); + event.call(this); + }); + }); + if (image.width && image.height) element.fireEvent('load', element, 1); + return element.setProperties(properties); + }, + + /* + Property: images + Preloads an array of images (as strings) and returns an array of img elements. does not inject them to the page. + + Arguments: + sources - array, the paths of the image files + options - object, see below + + Options: + onComplete - a function to execute when all image files are loaded in the browser's cache + onProgress - a function to execute when one image file is loaded in the browser's cache + + Example: + (start code) + new Asset.images(['/images/myImage.png', '/images/myImage2.gif'], { + onComplete: function(){ + alert('all images loaded!'); + } + }); + (end) + + Returns: + the img elements as $$. you can inject them anywhere you want with // + */ + + images: function(sources, options){ + options = $merge({ + onComplete: Class.empty, + onProgress: Class.empty + }, options); + if (!sources.push) sources = [sources]; + var images = []; + var counter = 0; + sources.each(function(source){ + var img = new Asset.image(source, { + 'onload': function(){ + options.onProgress.call(this, counter); + counter++; + if (counter == sources.length) options.onComplete(); + } + }); + images.push(img); + }); + return new Elements(images); + } + +}); + +/* +Script: Hash.js + Contains the class Hash. + +License: + MIT-style license. +*/ + +/* +Class: Hash + It wraps an object that it uses internally as a map. The user must use set(), get(), and remove() to add/change, retrieve and remove values, it must not access the internal object directly. null/undefined values are allowed. + +Note: + Each hash instance has the length property. + +Arguments: + obj - an object to convert into a Hash instance. + +Example: + (start code) + var hash = new Hash({a: 'hi', b: 'world', c: 'howdy'}); + hash.remove('b'); // b is removed. + hash.set('c', 'hello'); + hash.get('c'); // returns 'hello' + hash.length // returns 2 (a and c) + (end) +*/ + +var Hash = new Class({ + + length: 0, + + initialize: function(object){ + this.obj = object || {}; + this.setLength(); + }, + + /* + Property: get + Retrieves a value from the hash. + + Arguments: + key - The key + + Returns: + The value + */ + + get: function(key){ + return (this.hasKey(key)) ? this.obj[key] : null; + }, + + /* + Property: hasKey + Check the presence of a specified key-value pair in the hash. + + Arguments: + key - The key + + Returns: + True if the Hash contains a value for the specified key, otherwise false + */ + + hasKey: function(key){ + return (key in this.obj); + }, + + /* + Property: set + Adds a key-value pair to the hash or replaces a previous value associated with the key. + + Arguments: + key - The key + value - The value + */ + + set: function(key, value){ + if (!this.hasKey(key)) this.length++; + this.obj[key] = value; + return this; + }, + + setLength: function(){ + this.length = 0; + for (var p in this.obj) this.length++; + return this; + }, + + /* + Property: remove + Removes a key-value pair from the hash. + + Arguments: + key - The key + */ + + remove: function(key){ + if (this.hasKey(key)){ + delete this.obj[key]; + this.length--; + } + return this; + }, + + /* + Property: each + Calls a function for each key-value pair. The first argument passed to the function will be the value, the second one will be the key, like $each. + + Arguments: + fn - The function to call for each key-value pair + bind - Optional, the object that will be referred to as "this" in the function + */ + + each: function(fn, bind){ + $each(this.obj, fn, bind); + }, + + /* + Property: extend + Extends the current hash with an object containing key-value pairs. Values for duplicate keys will be replaced by the new ones. + + Arguments: + obj - An object containing key-value pairs + */ + + extend: function(obj){ + $extend(this.obj, obj); + return this.setLength(); + }, + + /* + Property: merge + Merges the current hash with multiple objects. + */ + + merge: function(){ + this.obj = $merge.apply(null, [this.obj].extend(arguments)); + return this.setLength(); + }, + + /* + Property: empty + Empties all hash values properties and values. + */ + + empty: function(){ + this.obj = {}; + this.length = 0; + return this; + }, + + /* + Property: keys + Returns an array containing all the keys, in the same order as the values returned by . + + Returns: + An array containing all the keys of the hash + */ + + keys: function(){ + var keys = []; + for (var property in this.obj) keys.push(property); + return keys; + }, + + /* + Property: values + Returns an array containing all the values, in the same order as the keys returned by . + + Returns: + An array containing all the values of the hash + */ + + values: function(){ + var values = []; + for (var property in this.obj) values.push(this.obj[property]); + return values; + } + +}); + +/* Section: Utility Functions */ + +/* +Function: $H + Shortcut to create a Hash from an Object. +*/ + +function $H(obj){ + return new Hash(obj); +}; + +/* +Script: Hash.Cookie.js + Stores and loads an Hash as a cookie using Json format. +*/ + +/* +Class: Hash.Cookie + Inherits all the methods from , additional methods are save and load. + Hash json string has a limit of 4kb (4096byte), so be careful with your Hash size. + Creating a new instance automatically loads the data from the Cookie into the Hash. + If the Hash is emptied, the cookie is also removed. + +Arguments: + name - the key (name) for the cookie + options - options are identical to and are simply passed along to it. + In addition, it has the autoSave option, to save the cookie at every operation. defaults to true. + +Example: + (start code) + var fruits = new Hash.Cookie('myCookieName', {duration: 3600}); + fruits.extend({ + 'lemon': 'yellow', + 'apple': 'red' + }); + fruits.set('melon', 'green'); + fruits.get('lemon'); // yellow + + // ... on another page ... values load automatically + + var fruits = new Hash.Cookie('myCookieName', {duration: 365}); + fruits.get('melon'); // green + + fruits.erase(); // delete cookie + (end) +*/ + +Hash.Cookie = Hash.extend({ + + initialize: function(name, options){ + this.name = name; + this.options = $extend({'autoSave': true}, options || {}); + this.load(); + }, + + /* + Property: save + Saves the Hash to the cookie. If the hash is empty, removes the cookie. + + Returns: + Returns false when the JSON string cookie is too long (4kb), otherwise true. + + Example: + (start code) + var login = new Hash.Cookie('userstatus', {autoSave: false}); + + login.extend({ + 'username': 'John', + 'credentials': [4, 7, 9] + }); + login.set('last_message', 'User logged in!'); + + login.save(); // finally save the Hash + (end) + */ + + save: function(){ + if (this.length == 0){ + Cookie.remove(this.name, this.options); + return true; + } + var str = Json.toString(this.obj); + if (str.length > 4096) return false; //cookie would be truncated! + Cookie.set(this.name, str, this.options); + return true; + }, + + /* + Property: load + Loads the cookie and assigns it to the Hash. + */ + + load: function(){ + this.obj = Json.evaluate(Cookie.get(this.name), true) || {}; + this.setLength(); + } + +}); + +Hash.Cookie.Methods = {}; +['extend', 'set', 'merge', 'empty', 'remove'].each(function(method){ + Hash.Cookie.Methods[method] = function(){ + Hash.prototype[method].apply(this, arguments); + if (this.options.autoSave) this.save(); + return this; + }; +}); +Hash.Cookie.implement(Hash.Cookie.Methods); + +/* +Script: Color.js + Contains the Color class. + +License: + MIT-style license. +*/ + +/* +Class: Color + Creates a new Color Object, which is an array with some color specific methods. +Arguments: + color - the hex, the RGB array or the HSB array of the color to create. For HSB colors, you need to specify the second argument. + type - a string representing the type of the color to create. needs to be specified if you intend to create the color with HSB values, or an array of HEX values. Can be 'rgb', 'hsb' or 'hex'. + +Example: + (start code) + var black = new Color('#000'); + var purple = new Color([255,0,255]); + // mix black with white and purple, each time at 10% of the new color + var darkpurple = black.mix('#fff', purple, 10); + $('myDiv').setStyle('background-color', darkpurple); + (end) +*/ + +var Color = new Class({ + + initialize: function(color, type){ + type = type || (color.push ? 'rgb' : 'hex'); + var rgb, hsb; + switch(type){ + case 'rgb': + rgb = color; + hsb = rgb.rgbToHsb(); + break; + case 'hsb': + rgb = color.hsbToRgb(); + hsb = color; + break; + default: + rgb = color.hexToRgb(true); + hsb = rgb.rgbToHsb(); + } + rgb.hsb = hsb; + rgb.hex = rgb.rgbToHex(); + return $extend(rgb, Color.prototype); + }, + + /* + Property: mix + Mixes two or more colors with the Color. + + Arguments: + color - a color to mix. you can use as arguments how many colors as you want to mix with the original one. + alpha - if you use a number as the last argument, it will be threated as the amount of the color to mix. + */ + + mix: function(){ + var colors = $A(arguments); + var alpha = ($type(colors[colors.length - 1]) == 'number') ? colors.pop() : 50; + var rgb = this.copy(); + colors.each(function(color){ + color = new Color(color); + for (var i = 0; i < 3; i++) rgb[i] = Math.round((rgb[i] / 100 * (100 - alpha)) + (color[i] / 100 * alpha)); + }); + return new Color(rgb, 'rgb'); + }, + + /* + Property: invert + Inverts the Color. + */ + + invert: function(){ + return new Color(this.map(function(value){ + return 255 - value; + })); + }, + + /* + Property: setHue + Modifies the hue of the Color, and returns a new one. + + Arguments: + value - the hue to set + */ + + setHue: function(value){ + return new Color([value, this.hsb[1], this.hsb[2]], 'hsb'); + }, + + /* + Property: setSaturation + Changes the saturation of the Color, and returns a new one. + + Arguments: + percent - the percentage of the saturation to set + */ + + setSaturation: function(percent){ + return new Color([this.hsb[0], percent, this.hsb[2]], 'hsb'); + }, + + /* + Property: setBrightness + Changes the brightness of the Color, and returns a new one. + + Arguments: + percent - the percentage of the brightness to set + */ + + setBrightness: function(percent){ + return new Color([this.hsb[0], this.hsb[1], percent], 'hsb'); + } + +}); + +/* Section: Utility Functions */ + +/* +Function: $RGB + Shortcut to create a new color, based on red, green, blue values. + +Arguments: + r - (integer) red value (0-255) + g - (integer) green value (0-255) + b - (integer) blue value (0-255) + +*/ + +function $RGB(r, g, b){ + return new Color([r, g, b], 'rgb'); +}; + +/* +Function: $HSB + Shortcut to create a new color, based on hue, saturation, brightness values. + +Arguments: + h - (integer) hue value (0-100) + s - (integer) saturation value (0-100) + b - (integer) brightness value (0-100) +*/ + +function $HSB(h, s, b){ + return new Color([h, s, b], 'hsb'); +}; + +/* +Class: Array + A collection of The Array Object prototype methods. +*/ + +Array.extend({ + + /* + Property: rgbToHsb + Converts a RGB array to an HSB array. + + Returns: + the HSB array. + */ + + rgbToHsb: function(){ + var red = this[0], green = this[1], blue = this[2]; + var hue, saturation, brightness; + var max = Math.max(red, green, blue), min = Math.min(red, green, blue); + var delta = max - min; + brightness = max / 255; + saturation = (max != 0) ? delta / max : 0; + if (saturation == 0){ + hue = 0; + } else { + var rr = (max - red) / delta; + var gr = (max - green) / delta; + var br = (max - blue) / delta; + if (red == max) hue = br - gr; + else if (green == max) hue = 2 + rr - br; + else hue = 4 + gr - rr; + hue /= 6; + if (hue < 0) hue++; + } + return [Math.round(hue * 360), Math.round(saturation * 100), Math.round(brightness * 100)]; + }, + + /* + Property: hsbToRgb + Converts an HSB array to an RGB array. + + Returns: + the RGB array. + */ + + hsbToRgb: function(){ + var br = Math.round(this[2] / 100 * 255); + if (this[1] == 0){ + return [br, br, br]; + } else { + var hue = this[0] % 360; + var f = hue % 60; + var p = Math.round((this[2] * (100 - this[1])) / 10000 * 255); + var q = Math.round((this[2] * (6000 - this[1] * f)) / 600000 * 255); + var t = Math.round((this[2] * (6000 - this[1] * (60 - f))) / 600000 * 255); + switch(Math.floor(hue / 60)){ + case 0: return [br, t, p]; + case 1: return [q, br, p]; + case 2: return [p, br, t]; + case 3: return [p, q, br]; + case 4: return [t, p, br]; + case 5: return [br, p, q]; + } + } + return false; + } + +}); + +/* +Script: Scroller.js + Contains the . + +License: + MIT-style license. +*/ + +/* +Class: Scroller + The Scroller is a class to scroll any element with an overflow (including the window) when the mouse cursor reaches certain buondaries of that element. + You must call its start method to start listening to mouse movements. + +Note: + The Scroller requires an XHTML doctype. + +Arguments: + element - required, the element to scroll. + options - optional, see options below, and options. + +Options: + area - integer, the necessary boundaries to make the element scroll. + velocity - integer, velocity ratio, the modifier for the window scrolling speed. + +Events: + onChange - optionally, when the mouse reaches some boundaries, you can choose to alter some other values, instead of the scrolling offsets. + Automatically passes as parameters x and y values. +*/ + +var Scroller = new Class({ + + options: { + area: 20, + velocity: 1, + onChange: function(x, y){ + this.element.scrollTo(x, y); + } + }, + + initialize: function(element, options){ + this.setOptions(options); + this.element = $(element); + this.mousemover = ([window, document].contains(element)) ? $(document.body) : this.element; + }, + + /* + Property: start + The scroller starts listening to mouse movements. + */ + + start: function(){ + this.coord = this.getCoords.bindWithEvent(this); + this.mousemover.addListener('mousemove', this.coord); + }, + + /* + Property: stop + The scroller stops listening to mouse movements. + */ + + stop: function(){ + this.mousemover.removeListener('mousemove', this.coord); + this.timer = $clear(this.timer); + }, + + getCoords: function(event){ + this.page = (this.element == window) ? event.client : event.page; + if (!this.timer) this.timer = this.scroll.periodical(50, this); + }, + + scroll: function(){ + var el = this.element.getSize(); + var pos = this.element.getPosition(); + + var change = {'x': 0, 'y': 0}; + for (var z in this.page){ + if (this.page[z] < (this.options.area + pos[z]) && el.scroll[z] != 0) + change[z] = (this.page[z] - this.options.area - pos[z]) * this.options.velocity; + else if (this.page[z] + this.options.area > (el.size[z] + pos[z]) && el.scroll[z] + el.size[z] != el.scrollSize[z]) + change[z] = (this.page[z] - el.size[z] + this.options.area - pos[z]) * this.options.velocity; + } + if (change.y || change.x) this.fireEvent('onChange', [el.scroll.x + change.x, el.scroll.y + change.y]); + } + +}); + +Scroller.implement(new Events, new Options); + +/* +Script: Slider.js + Contains + +License: + MIT-style license. +*/ + +/* +Class: Slider + Creates a slider with two elements: a knob and a container. Returns the values. + +Note: + The Slider requires an XHTML doctype. + +Arguments: + element - the knob container + knob - the handle + options - see Options below + +Options: + steps - the number of steps for your slider. + mode - either 'horizontal' or 'vertical'. defaults to horizontal. + offset - relative offset for knob position. default to 0. + +Events: + onChange - a function to fire when the value changes. + onComplete - a function to fire when you're done dragging. + onTick - optionally, you can alter the onTick behavior, for example displaying an effect of the knob moving to the desired position. + Passes as parameter the new position. +*/ + +var Slider = new Class({ + + options: { + onChange: Class.empty, + onComplete: Class.empty, + onTick: function(pos){ + this.knob.setStyle(this.p, pos); + }, + mode: 'horizontal', + steps: 100, + offset: 0 + }, + + initialize: function(el, knob, options){ + this.element = $(el); + this.knob = $(knob); + this.setOptions(options); + this.previousChange = -1; + this.previousEnd = -1; + this.step = -1; + this.element.addEvent('mousedown', this.clickedElement.bindWithEvent(this)); + var mod, offset; + switch(this.options.mode){ + case 'horizontal': + this.z = 'x'; + this.p = 'left'; + mod = {'x': 'left', 'y': false}; + offset = 'offsetWidth'; + break; + case 'vertical': + this.z = 'y'; + this.p = 'top'; + mod = {'x': false, 'y': 'top'}; + offset = 'offsetHeight'; + } + this.max = this.element[offset] - this.knob[offset] + (this.options.offset * 2); + this.half = this.knob[offset]/2; + this.getPos = this.element['get' + this.p.capitalize()].bind(this.element); + this.knob.setStyle('position', 'relative').setStyle(this.p, - this.options.offset); + var lim = {}; + lim[this.z] = [- this.options.offset, this.max - this.options.offset]; + this.drag = new Drag.Base(this.knob, { + limit: lim, + modifiers: mod, + snap: 0, + onStart: function(){ + this.draggedKnob(); + }.bind(this), + onDrag: function(){ + this.draggedKnob(); + }.bind(this), + onComplete: function(){ + this.draggedKnob(); + this.end(); + }.bind(this) + }); + if (this.options.initialize) this.options.initialize.call(this); + }, + + /* + Property: set + The slider will get the step you pass. + + Arguments: + step - one integer + */ + + set: function(step){ + this.step = step.limit(0, this.options.steps); + this.checkStep(); + this.end(); + this.fireEvent('onTick', this.toPosition(this.step)); + return this; + }, + + clickedElement: function(event){ + var position = event.page[this.z] - this.getPos() - this.half; + position = position.limit(-this.options.offset, this.max -this.options.offset); + this.step = this.toStep(position); + this.checkStep(); + this.end(); + this.fireEvent('onTick', position); + }, + + draggedKnob: function(){ + this.step = this.toStep(this.drag.value.now[this.z]); + this.checkStep(); + }, + + checkStep: function(){ + if (this.previousChange != this.step){ + this.previousChange = this.step; + this.fireEvent('onChange', this.step); + } + }, + + end: function(){ + if (this.previousEnd !== this.step){ + this.previousEnd = this.step; + this.fireEvent('onComplete', this.step + ''); + } + }, + + toStep: function(position){ + return Math.round((position + this.options.offset) / this.max * this.options.steps); + }, + + toPosition: function(step){ + return this.max * step / this.options.steps; + } + +}); + +Slider.implement(new Events); +Slider.implement(new Options); + +/* +Script: SmoothScroll.js + Contains + +License: + MIT-style license. +*/ + +/* +Class: SmoothScroll + Auto targets all the anchors in a page and display a smooth scrolling effect upon clicking them. + Inherits methods, properties, options and events from . + +Note: + SmoothScroll requires an XHTML doctype. + +Arguments: + options - the Fx.Scroll options (see: ) plus links, a collection of elements you want your smoothscroll on. Defaults to document.links. + +Example: + >new SmoothScroll(); +*/ + +var SmoothScroll = Fx.Scroll.extend({ + + initialize: function(options){ + this.parent(window, options); + this.links = (this.options.links) ? $$(this.options.links) : $$(document.links); + var location = window.location.href.match(/^[^#]*/)[0] + '#'; + this.links.each(function(link){ + if (link.href.indexOf(location) != 0) return; + var anchor = link.href.substr(location.length); + if (anchor && $(anchor)) this.useLink(link, anchor); + }, this); + if (!window.webkit419) this.addEvent('onComplete', function(){ + window.location.hash = this.anchor; + }); + }, + + useLink: function(link, anchor){ + link.addEvent('click', function(event){ + this.anchor = anchor; + this.toElement(anchor); + event.stop(); + }.bindWithEvent(this)); + } + +}); + +/* +Script: Sortables.js + Contains Class. + +License: + MIT-style license. +*/ + +/* +Class: Sortables + Creates an interface for and drop, resorting of a list. + +Note: + The Sortables require an XHTML doctype. + +Arguments: + list - required, the list that will become sortable. + options - an Object, see options below. + +Options: + handles - a collection of elements to be used for drag handles. defaults to the elements. + +Events: + onStart - function executed when the item starts dragging + onComplete - function executed when the item ends dragging +*/ + +var Sortables = new Class({ + + options: { + handles: false, + onStart: Class.empty, + onComplete: Class.empty, + ghost: true, + snap: 3, + onDragStart: function(element, ghost){ + ghost.setStyle('opacity', 0.7); + element.setStyle('opacity', 0.7); + }, + onDragComplete: function(element, ghost){ + element.setStyle('opacity', 1); + ghost.remove(); + this.trash.remove(); + } + }, + + initialize: function(list, options){ + this.setOptions(options); + this.list = $(list); + this.elements = this.list.getChildren(); + this.handles = (this.options.handles) ? $$(this.options.handles) : this.elements; + this.bound = { + 'start': [], + 'moveGhost': this.moveGhost.bindWithEvent(this) + }; + for (var i = 0, l = this.handles.length; i < l; i++){ + this.bound.start[i] = this.start.bindWithEvent(this, this.elements[i]); + } + this.attach(); + if (this.options.initialize) this.options.initialize.call(this); + this.bound.move = this.move.bindWithEvent(this); + this.bound.end = this.end.bind(this); + }, + + attach: function(){ + this.handles.each(function(handle, i){ + handle.addEvent('mousedown', this.bound.start[i]); + }, this); + }, + + detach: function(){ + this.handles.each(function(handle, i){ + handle.removeEvent('mousedown', this.bound.start[i]); + }, this); + }, + + start: function(event, el){ + this.active = el; + this.coordinates = this.list.getCoordinates(); + if (this.options.ghost){ + var position = el.getPosition(); + this.offset = event.page.y - position.y; + this.trash = new Element('div').inject(document.body); + this.ghost = el.clone().inject(this.trash).setStyles({ + 'position': 'absolute', + 'left': position.x, + 'top': event.page.y - this.offset + }); + document.addListener('mousemove', this.bound.moveGhost); + this.fireEvent('onDragStart', [el, this.ghost]); + } + document.addListener('mousemove', this.bound.move); + document.addListener('mouseup', this.bound.end); + this.fireEvent('onStart', el); + event.stop(); + }, + + moveGhost: function(event){ + var value = event.page.y - this.offset; + value = value.limit(this.coordinates.top, this.coordinates.bottom - this.ghost.offsetHeight); + this.ghost.setStyle('top', value); + event.stop(); + }, + + move: function(event){ + var now = event.page.y; + this.previous = this.previous || now; + var up = ((this.previous - now) > 0); + var prev = this.active.getPrevious(); + var next = this.active.getNext(); + if (prev && up && now < prev.getCoordinates().bottom) this.active.injectBefore(prev); + if (next && !up && now > next.getCoordinates().top) this.active.injectAfter(next); + this.previous = now; + }, + + serialize: function(converter){ + return this.list.getChildren().map(converter || function(el){ + return this.elements.indexOf(el); + }, this); + }, + + end: function(){ + this.previous = null; + document.removeListener('mousemove', this.bound.move); + document.removeListener('mouseup', this.bound.end); + if (this.options.ghost){ + document.removeListener('mousemove', this.bound.moveGhost); + this.fireEvent('onDragComplete', [this.active, this.ghost]); + } + this.fireEvent('onComplete', this.active); + } + +}); + +Sortables.implement(new Events, new Options); + +/* +Script: Tips.js + Tooltips, BubbleTips, whatever they are, they will appear on mouseover + +License: + MIT-style license. + +Credits: + The idea behind Tips.js is based on Bubble Tooltips () by Alessandro Fulcitiniti +*/ + +/* +Class: Tips + Display a tip on any element with a title and/or href. + +Note: + Tips requires an XHTML doctype. + +Arguments: + elements - a collection of elements to apply the tooltips to on mouseover. + options - an object. See options Below. + +Options: + maxTitleChars - the maximum number of characters to display in the title of the tip. defaults to 30. + showDelay - the delay the onShow method is called. (defaults to 100 ms) + hideDelay - the delay the onHide method is called. (defaults to 100 ms) + + className - the prefix for your tooltip classNames. defaults to 'tool'. + + the whole tooltip will have as classname: tool-tip + + the title will have as classname: tool-title + + the text will have as classname: tool-text + + offsets - the distance of your tooltip from the mouse. an Object with x/y properties. + fixed - if set to true, the toolTip will not follow the mouse. + +Events: + onShow - optionally you can alter the default onShow behaviour with this option (like displaying a fade in effect); + onHide - optionally you can alter the default onHide behaviour with this option (like displaying a fade out effect); + +Example: + (start code) + + + (end) + +Note: + The title of the element will always be used as the tooltip body. If you put :: on your title, the text before :: will become the tooltip title. +*/ + +var Tips = new Class({ + + options: { + onShow: function(tip){ + tip.setStyle('visibility', 'visible'); + }, + onHide: function(tip){ + tip.setStyle('visibility', 'hidden'); + }, + maxTitleChars: 30, + showDelay: 100, + hideDelay: 100, + className: 'tool', + offsets: {'x': 16, 'y': 16}, + fixed: false + }, + + initialize: function(elements, options){ + this.setOptions(options); + this.toolTip = new Element('div', { + 'class': this.options.className + '-tip', + 'styles': { + 'position': 'absolute', + 'top': '0', + 'left': '0', + 'visibility': 'hidden' + } + }).inject(document.body); + this.wrapper = new Element('div').inject(this.toolTip); + $$(elements).each(this.build, this); + if (this.options.initialize) this.options.initialize.call(this); + }, + + build: function(el){ + el.$tmp.myTitle = (el.href && el.getTag() == 'a') ? el.href.replace('http://', '') : (el.rel || false); + if (el.title){ + var dual = el.title.split('::'); + if (dual.length > 1){ + el.$tmp.myTitle = dual[0].trim(); + el.$tmp.myText = dual[1].trim(); + } else { + el.$tmp.myText = el.title; + } + el.removeAttribute('title'); + } else { + el.$tmp.myText = false; + } + if (el.$tmp.myTitle && el.$tmp.myTitle.length > this.options.maxTitleChars) el.$tmp.myTitle = el.$tmp.myTitle.substr(0, this.options.maxTitleChars - 1) + "…"; + el.addEvent('mouseenter', function(event){ + this.start(el); + if (!this.options.fixed) this.locate(event); + else this.position(el); + }.bind(this)); + if (!this.options.fixed) el.addEvent('mousemove', this.locate.bindWithEvent(this)); + var end = this.end.bind(this); + el.addEvent('mouseleave', end); + el.addEvent('trash', end); + }, + + start: function(el){ + this.wrapper.empty(); + if (el.$tmp.myTitle){ + this.title = new Element('span').inject(new Element('div', {'class': this.options.className + '-title'}).inject(this.wrapper)).setHTML(el.$tmp.myTitle); + } + if (el.$tmp.myText){ + this.text = new Element('span').inject(new Element('div', {'class': this.options.className + '-text'}).inject(this.wrapper)).setHTML(el.$tmp.myText); + } + $clear(this.timer); + this.timer = this.show.delay(this.options.showDelay, this); + }, + + end: function(event){ + $clear(this.timer); + this.timer = this.hide.delay(this.options.hideDelay, this); + }, + + position: function(element){ + var pos = element.getPosition(); + this.toolTip.setStyles({ + 'left': pos.x + this.options.offsets.x, + 'top': pos.y + this.options.offsets.y + }); + }, + + locate: function(event){ + var win = {'x': window.getWidth(), 'y': window.getHeight()}; + var scroll = {'x': window.getScrollLeft(), 'y': window.getScrollTop()}; + var tip = {'x': this.toolTip.offsetWidth, 'y': this.toolTip.offsetHeight}; + var prop = {'x': 'left', 'y': 'top'}; + for (var z in prop){ + var pos = event.page[z] + this.options.offsets[z]; + if ((pos + tip[z] - scroll[z]) > win[z]) pos = event.page[z] - this.options.offsets[z] - tip[z]; + this.toolTip.setStyle(prop[z], pos); + }; + }, + + show: function(){ + if (this.options.timeout) this.timer = this.hide.delay(this.options.timeout, this); + this.fireEvent('onShow', [this.toolTip]); + }, + + hide: function(){ + this.fireEvent('onHide', [this.toolTip]); + } + +}); + +Tips.implement(new Events, new Options); + +/* +Script: Group.js + For Grouping Classes or Elements Events. The Event added to the Group will fire when all of the events of the items of the group are fired. + +License: + MIT-style license. +*/ + +/* +Class: Group + An "Utility" Class. + +Arguments: + List of Class instances + +Example: + (start code) + xhr1 = new Ajax('data.js', {evalScript: true}); + xhr2 = new Ajax('abstraction.js', {evalScript: true}); + xhr3 = new Ajax('template.js', {evalScript: true}); + + var group = new Group(xhr1, xhr2, xhr3); + group.addEvent('onComplete', function(){ + alert('All Scripts loaded'); + }); + + xhr1.request(); + xhr2.request(); + xhr3.request(); + (end) + +*/ + +var Group = new Class({ + + initialize: function(){ + this.instances = $A(arguments); + this.events = {}; + this.checker = {}; + }, + + /* + Property: addEvent + adds an event to the stack of events of the Class instances. + + Arguments: + type - string; the event name (e.g. 'onComplete') + fn - function to execute when all instances fired this event + */ + + addEvent: function(type, fn){ + this.checker[type] = this.checker[type] || {}; + this.events[type] = this.events[type] || []; + if (this.events[type].contains(fn)) return false; + else this.events[type].push(fn); + this.instances.each(function(instance, i){ + instance.addEvent(type, this.check.bind(this, [type, instance, i])); + }, this); + return this; + }, + + check: function(type, instance, i){ + this.checker[type][i] = true; + var every = this.instances.every(function(current, j){ + return this.checker[type][j] || false; + }, this); + if (!every) return; + this.checker[type] = {}; + this.events[type].each(function(event){ + event.call(this, this.instances, instance); + }, this); + } + +}); + +/* +Script: Accordion.js + Contains + +License: + MIT-style license. +*/ + +/* +Class: Accordion + The Accordion class creates a group of elements that are toggled when their handles are clicked. When one elements toggles in, the others toggles back. + Inherits methods, properties, options and events from . + +Note: + The Accordion requires an XHTML doctype. + +Arguments: + togglers - required, a collection of elements, the elements handlers that will be clickable. + elements - required, a collection of elements the transitions will be applied to. + options - optional, see options below, and options and events. + +Options: + show - integer, the Index of the element to show at start. + display - integer, the Index of the element to show at start (with a transition). defaults to 0. + fixedHeight - integer, if you want the elements to have a fixed height. defaults to false. + fixedWidth - integer, if you want the elements to have a fixed width. defaults to false. + height - boolean, will add a height transition to the accordion if true. defaults to true. + opacity - boolean, will add an opacity transition to the accordion if true. defaults to true. + width - boolean, will add a width transition to the accordion if true. defaults to false, css mastery is required to make this work! + alwaysHide - boolean, will allow to hide all elements if true, instead of always keeping one element shown. defaults to false. + +Events: + onActive - function to execute when an element starts to show + onBackground - function to execute when an element starts to hide +*/ + +var Accordion = Fx.Elements.extend({ + + options: { + onActive: Class.empty, + onBackground: Class.empty, + display: 0, + show: false, + height: true, + width: false, + opacity: true, + fixedHeight: false, + fixedWidth: false, + wait: false, + alwaysHide: false + }, + + initialize: function(){ + var options, togglers, elements, container; + $each(arguments, function(argument, i){ + switch($type(argument)){ + case 'object': options = argument; break; + case 'element': container = $(argument); break; + default: + var temp = $$(argument); + if (!togglers) togglers = temp; + else elements = temp; + } + }); + this.togglers = togglers || []; + this.elements = elements || []; + this.container = $(container); + this.setOptions(options); + this.previous = -1; + if (this.options.alwaysHide) this.options.wait = true; + if ($chk(this.options.show)){ + this.options.display = false; + this.previous = this.options.show; + } + if (this.options.start){ + this.options.display = false; + this.options.show = false; + } + this.effects = {}; + if (this.options.opacity) this.effects.opacity = 'fullOpacity'; + if (this.options.width) this.effects.width = this.options.fixedWidth ? 'fullWidth' : 'offsetWidth'; + if (this.options.height) this.effects.height = this.options.fixedHeight ? 'fullHeight' : 'scrollHeight'; + for (var i = 0, l = this.togglers.length; i < l; i++) this.addSection(this.togglers[i], this.elements[i]); + this.elements.each(function(el, i){ + if (this.options.show === i){ + this.fireEvent('onActive', [this.togglers[i], el]); + } else { + for (var fx in this.effects) el.setStyle(fx, 0); + } + }, this); + this.parent(this.elements); + if ($chk(this.options.display)) this.display(this.options.display); + }, + + /* + Property: addSection + Dynamically adds a new section into the accordion at the specified position. + + Arguments: + toggler - (dom element) the element that toggles the accordion section open. + element - (dom element) the element that stretches open when the toggler is clicked. + pos - (integer) the index where these objects are to be inserted within the accordion. + */ + + addSection: function(toggler, element, pos){ + toggler = $(toggler); + element = $(element); + var test = this.togglers.contains(toggler); + var len = this.togglers.length; + this.togglers.include(toggler); + this.elements.include(element); + if (len && (!test || pos)){ + pos = $pick(pos, len - 1); + toggler.injectBefore(this.togglers[pos]); + element.injectAfter(toggler); + } else if (this.container && !test){ + toggler.inject(this.container); + element.inject(this.container); + } + var idx = this.togglers.indexOf(toggler); + toggler.addEvent('click', this.display.bind(this, idx)); + if (this.options.height) element.setStyles({'padding-top': 0, 'border-top': 'none', 'padding-bottom': 0, 'border-bottom': 'none'}); + if (this.options.width) element.setStyles({'padding-left': 0, 'border-left': 'none', 'padding-right': 0, 'border-right': 'none'}); + element.fullOpacity = 1; + if (this.options.fixedWidth) element.fullWidth = this.options.fixedWidth; + if (this.options.fixedHeight) element.fullHeight = this.options.fixedHeight; + element.setStyle('overflow', 'hidden'); + if (!test){ + for (var fx in this.effects) element.setStyle(fx, 0); + } + return this; + }, + + /* + Property: display + Shows a specific section and hides all others. Useful when triggering an accordion from outside. + + Arguments: + index - integer, the index of the item to show, or the actual element to show. + */ + + display: function(index){ + index = ($type(index) == 'element') ? this.elements.indexOf(index) : index; + if ((this.timer && this.options.wait) || (index === this.previous && !this.options.alwaysHide)) return this; + this.previous = index; + var obj = {}; + this.elements.each(function(el, i){ + obj[i] = {}; + var hide = (i != index) || (this.options.alwaysHide && (el.offsetHeight > 0)); + this.fireEvent(hide ? 'onBackground' : 'onActive', [this.togglers[i], el]); + for (var fx in this.effects) obj[i][fx] = hide ? 0 : el[this.effects[fx]]; + }, this); + return this.start(obj); + }, + + showThisHideOpen: function(index){return this.display(index);} + +}); + +Fx.Accordion = Accordion; \ No newline at end of file diff --git a/nested.js b/nested.js new file mode 100644 index 0000000..b7d8737 --- /dev/null +++ b/nested.js @@ -0,0 +1,254 @@ +// Version: 1.20 +// Date: 2007-01-25 +// Author: CrazyDave +// Website: http://www.clanccc.co.uk/moo/nested.html +var Nested = new Class({ + getOptions: function() { + return { + childTag: 'LI', + ghost: true, + childStep: 60, // attempts to become a child if the mouse is moved this number of pixels right + handleClass: null, + onStart: Class.empty, + onComplete: Class.empty, + collapse: false, // true/false + collapseClass: 'nCollapse', // Class added to collapsed items + expandKey: 'shift', // control | shift + lock: null, // parent || depth || class + lockClass: 'unlocked' + }; + }, + + initialize: function(list, options) { + this.setOptions(this.getOptions(), options); + if (!this.options.expandKey.match(/^(control|shift)$/)) { + this.options.expandKey = 'shift'; + } + this.list = $(list); + this.options.parentTag = this.list.nodeName; + this.bound = {}; + this.bound.start = this.start.bindWithEvent(this); + this.list.addEvent('mousedown', this.bound.start); + if (this.options.collapse) { + this.bound.collapse = this.collapse.bindWithEvent(this); + //this.list.addEvent('click', this.bound.collapse); + } + if (this.options.initialize) this.options.initialize.call(this); + }, + + start: function(event) { + var el = $(event.target); + if (this.options.handleClass) { + while (el.nodeName != this.options.childTag && !el.hasClass(this.options.handleClass) && el != this.list) { + el = el.getParent(); + } + if (!el.hasClass(this.options.handleClass)) return true; + } + while (el.nodeName != this.options.childTag && el != this.list) { + el = el.parentNode; + } + if (el.nodeName != this.options.childTag) return true; + el = $(el); + if (this.options.lock == 'class' && !el.hasClass(this.options.lockClass)) return; + if (this.options.ghost) { // Create the ghost + this.ghost = el.clone().setStyles({ + 'list-style-type': 'none', + 'opacity': 0.5, + 'position': 'absolute', + 'visibility': 'hidden', + 'top': event.page.y+'px', + 'left': (event.page.x+10)+'px' + }).injectInside(document.body); + } + el.depth = this.getDepth(el); + el.moved = false; + this.bound.movement = this.movement.bindWithEvent(this, el); + this.bound.end = this.end.bind(this, el); + this.list.removeEvent('mousedown', this.bound.start); + this.list.addEvent('mousedown', this.bound.end); + this.list.addEvent('mousemove', this.bound.movement); + document.addEvent('mouseup', this.bound.end); + if (window.ie) { // IE fix to stop selection of text when dragging + this.bound.stop = this.stop.bindWithEvent(this); + $(document.body).addEvent('drag', this.bound.stop).addEvent('selectstart', this.bound.stop); + } + this.fireEvent('onStart', el); + event.stop(); + }, + + collapse: function(event) { + var el = $(event.target); + if (this.options.handleClass) { + while (el.nodeName != this.options.childTag && !el.hasClass(this.options.handleClass) && el != this.list) { + el = el.getParent(); + } + if (!el.hasClass(this.options.handleClass)) return true; + } + while (el.nodeName != this.options.childTag && el != this.list) { + el = el.parentNode; + } + if (el == this.list) return; + el = $(el); + if (!el.moved) { + var sub = $E(this.options.parentTag, el); + if (sub) { + if (sub.getStyle('display') == 'none') { + sub.setStyle('display', 'block'); + el.removeClass(this.options.collapseClass); + } else { + sub.setStyle('display', 'none'); + el.addClass(this.options.collapseClass); + } + } + } + event.stop(); + }, + + stop: function(event) { + event.stop(); + return false; + }, + + getDepth: function(el, add) { + var counter = (add) ? 1 : 0; + while (el != this.list) { + if (el.nodeName == this.options.parentTag) counter += 1; + el = el.parentNode; + } + return counter; + }, + + movement: function(event, el) { + var dir, over, check, items; + var dest, move, prev, prevParent; + var abort = false; + if (this.options.ghost && el.moved) { // Position the ghost + this.ghost.setStyles({ + 'position': 'absolute', + 'visibility': 'visible', + 'top': event.page.y+'px', + 'left': (event.page.x+10)+'px' + }); + } + over = event.target; + while (over.nodeName != this.options.childTag && over != this.list) { + over = over.parentNode; + } + if (over == this.list) return; + if (event[this.options.expandKey] && over != el && over.hasClass(this.options.collapseClass)) { + check = $E(this.options.parentTag, over); + over.removeClass(this.options.collapseClass); + check.setStyle('display', 'block'); + } + // Check if it's actually inline with a child element of the event firer + orig = over; + if (el != over) { + items = $ES(this.options.childTag, over); + items.each(function(item) { + if (event.page.y > item.getTop() && item.offsetHeight > 0) over = item; + }); + } + // Make sure we end up with a childTag element + if (over.nodeName != this.options.childTag) return; + + // store the previous parent 'ol' to remove it if a move makes it empty + prevParent = el.getParent(); + dir = (event.page.y < el.getTop()) ? 'up' : 'down'; + move = 'before'; + dest = el; + + if (el != over) { + check = over; + while (check != null && check != el) { + check = check.parentNode; + } // Make sure we're not trying to move something below itself + if (check == el) return; + if (dir == 'up') { + move = 'before'; dest = over; + } else { + sub = $E(this.options.childTag, over); + if (sub && sub.offsetHeight > 0) { + move = 'before'; dest = sub; + } else { + move = 'after'; dest = over; + } + } + } + + // Check if we're trying to go deeper -->> + prev = (move == 'before') ? dest.getPrevious() : dest; + if (prev) { + move = 'after'; + dest = prev; + check = $E(this.options.parentTag, dest); + while (check && event.page.x > check.getLeft() && check.offsetHeight > 0) { + dest = check.getLast(); + check = $E(this.options.parentTag, dest); + } + if (!check && event.page.x > dest.getLeft()+this.options.childStep) { + move = 'inside'; + } + } + + last = dest.getParent().getLast(); + while (((move == 'after' && last == dest) || last == el) && dest.getParent() != this.list && event.page.x < dest.getLeft()) { + move = 'after'; + dest = $(dest.parentNode.parentNode); + last = dest.getParent().getLast(); + } + + abort = false; + if (move != '') { + abort += (dest == el); + abort += (move == 'after' && dest.getNext() == el); + abort += (move == 'before' && dest.getPrevious() == el); + abort += (this.options.lock == 'depth' && el.depth != this.getDepth(dest, (move == 'inside'))); + abort += (this.options.lock == 'parent' && (move == 'inside' || dest.parentNode != el.parentNode)); + abort += (dest.offsetHeight == 0); + sub = $E(this.options.parentTag, over); + sub = (sub) ? sub.getTop() : 0; + sub = (sub > 0) ? sub-over.getTop() : over.offsetHeight; + abort += (event.page.y < (sub-el.offsetHeight)+over.getTop()); + if (!abort) { + if (move == 'inside') dest = new Element(this.options.parentTag).injectInside(dest); + $(el).inject(dest, move); + el.moved = true; + if (!prevParent.getFirst()) prevParent.remove(); + } + } + event.stop(); + }, + + detach: function() { + this.list.removeEvent('mousedown', this.start.bindWithEvent(this)); + if (this.options.collapse) this.list.removeEvent('click', this.bound.collapse); + }, + + serialize: function(listEl) { + var serial = []; + var kids; + if (!listEl) listEl = this.list; + $$(listEl.childNodes).each(function(node, i) { + kids = $E(this.options.parentTag, node); + serial[i] = { + id: node.id, + hide: (node.hasClass('remove')) ? 'exclude' : "", + children: (kids) ? this.serialize(kids) : [] + }; + }.bind(this)); + return serial; + }, + + end: function(el) { + if (this.options.ghost) this.ghost.remove(); + this.list.removeEvent('mousemove', this.bound.movement); + document.removeEvent('mouseup', this.bound.end); + this.list.removeEvent('mousedown', this.bound.end); + this.list.addEvent('mousedown', this.bound.start); + this.fireEvent('onComplete', el); + if (window.ie) $(document.body).removeEvent('drag', this.bound.stop).removeEvent('selectstart', this.bound.stop); + } +}); + +Nested.implement(new Events); +Nested.implement(new Options); \ No newline at end of file diff --git a/page.png b/page.png new file mode 100644 index 0000000..de8e003 Binary files /dev/null and b/page.png differ diff --git a/pagemash.php b/pagemash.php index 3942d2b..d8e5a28 100644 --- a/pagemash.php +++ b/pagemash.php @@ -4,29 +4,42 @@ Plugin Name: pageMash Plugin URI: http://joelstarnes.co.uk/pagemash/ Description: pageMash > pageManagement [WP_Admin > Manage > pageMash] Author: Joel Starnes -Version: 0.1.3 +Version: 1.0.0 Author URI: http://joelstarnes.co.uk/ CHANGELOG: Release: Date: Description: 0.1.0 10 Feb 2008 Initial release -0.1.1 12 Feb 2008 Fixed Removed external include -0.1.2 15 Feb 2008 Fixed CSS&JS headers to only display on pagemash -0.1.3 19 Feb 2008 Fixed exclude pages feature +0.1.1 12 Feb 2008 Minor fixes > Removed external include +0.1.2 15 Feb 2008 Minor fixes > Fixed CSS&JS headers to only display on pagemash +1.0.0 beta 19 Feb 2008 Major update > Recusive page handles unlimited nested children, + collapsable list items, interface makeover... +TODO: + @todo optimize for instantUpdateFeature + @todo update moo code? + @todo default exclude pages off / write toggle option? + @todo svn branch? + @todo release in beta + +FIXME: + @fixme with instantUpdateFeature hide will not send the update + */ #########CONFIG OPTIONS############################################ $minlevel = 7; /*[deafult=7]*/ /* Minimum user level to access page order */ +$excludePagesFeature = false; /*[deafult=true]*/ +/* Allows you to set pages not to be listed + Will only work if you have modified the template. */ + $instantUpdateFeature = false; /*[deafult=false]*/ /* Updates the database instantly after a move using ajax otherwise it will wait for update button press. - nb. enabling this feature will put strain on the mysql server */ + nb. this feature has not been optimised and enabling will cause + much increased server load */ -$excludePagesFeature = true; /*[deafult=true]*/ -/* Allows you to set pages not to be listed - Will only work if you have modified the template. */ ################################################################### /* CREDITS: @@ -53,41 +66,68 @@ ShiftThis - WP Page Order Plugin [http://www.shiftthis.net/wordpress-order-pages Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA */ -function pageMash_main(){ - global $wpdb, $wp_version, $instantUpdateFeature, $excludePagesFeature; - //get pages from database - if($wp_version >= 2.1){ - $pageposts = $wpdb->get_results("SELECT * FROM $wpdb->posts WHERE post_type = 'page' AND post_parent = '0' ORDER BY menu_order"); +function pageMash_getPages($post_parent){ + //this is a recurrsive function which calls itself to produce a nested list of elements + //$post_parent should be 0 for root pages, or contain a pageID to return it's sub-pages + global $wpdb, $wp_version, $instantUpdateFeature, $excludePagesFeature, $excludePagesList; + if($wp_version >= 2.1){ //get pages from database + $pageposts = $wpdb->get_results("SELECT * FROM $wpdb->posts WHERE post_type = 'page' AND post_parent = '$post_parent' ORDER BY menu_order"); }else{ - $pageposts = $wpdb->get_results("SELECT * FROM $wpdb->posts WHERE post_status = 'static' AND post_parent = '0' ORDER BY menu_order"); + $pageposts = $wpdb->get_results("SELECT * FROM $wpdb->posts WHERE post_status = 'static' AND post_parent = '$post_parent' ORDER BY menu_order"); } - //get pages set to exclude - $excludePagesList = '>,'.get_option('exclude_pages'); - //precede with '>,' otherwise the first pageid will return 0 when strpos() is called to find it. - //the initial coma allows us to search for ',$pageid,' so as to avoid partial matches + if ($pageposts == true){ //if $pageposts == true then it does have sub-page(s), so list them. + echo '
    '; + + foreach ($pageposts as $page): //list pages, [the 'li' ID must be the page ID] ?> +
  • ID.',')){echo 'class="remove"';}//if page is in exclude list, add class remove ?>> + post_title;?> + + id:ID;?> + [edit] + + [hide] + + + ID) //call this function to list any sub-pages (passing it the pageID) ?> +
  • + '; + return true; + } else { + return false; + } +} + +function pageMash_main(){ + global $wpdb, $wp_version, $instantUpdateFeature, $excludePagesFeature, $excludePagesList; + + //get pages-to-hide from database + $excludePagesObj = $wpdb->get_results("SELECT option_value FROM $wpdb->options WHERE option_name = 'exclude_pages'"); + $excludePagesList = '>,'.$excludePagesObj[0]->option_value; + //precede with '>,' otherwise the first pageid will return 0 when strpos() is called to find it. + //the initial coma allows us to search for ',$pageid,' so as to avoid partial matches ?> - +
    - version [0.1.3] + version [1.0.0 beta]

    pageMash - pageManagement

    -

    You can use this to organise and manage your pages.

    - -
      - - -
    • ID.',')){echo 'class="remove"';}//if page is in exclude list, add class remove ?>> - post_title;?> - [edit] -
    • - - -
    +

    + Just drag the pages up or down to change the page order and left or right to change the page's parent, then hit 'update'.
    + The icon to the left of each page shows if it has child pages, double click anywhere on that item to toggle expand|collapse of it's children. +

    + +
    + +
    +

    - +

    @@ -97,53 +137,102 @@ function pageMash_main(){
    -

    How to

    -

    Just drag the pages into the order you like, hit 'update' and enjoy the scrummy ajaxified goodness.

    -

    - - Click the little red icon to left of each page to hide that page or press the 'edit' button to edit that page. Sorted.
    - - Note: This plugin only orders top level pages -

    -

    To use this plugin you need to use the wp_list_pages() function with the parameters as shown below:

    - -<?php if(function_exists('pageMash_exclude_pages')){$exclude_pages=pageMash_exclude_pages();} else{$exclude_pages='';}?>
    -<?php wp_list_pages('title_li=<h2>Pages</h2>&exclude='.$exclude_pages);?> +

    How to Install

    +

    In most cases, to use this plugin you will not need to change anything, however if its not working you will either need to:

    +
      +
    1. Check your 'pages' widget in the WP admin panel under the Presentation>Widgets tab and click the little icon on the pages widget and ensure that sort by is set to 'page order'.
    2. +
    3. If you want the pages listed else-where or do not use the widgets or want you would like to use the excludePagesFeature, then you need to edit your template as shown below: +
        +
      1. To use the code in your sidebar.php file you need to remove all widgets in your WP admin to active the sidebar code and then find the wp_list_pages() function and change it to the code below
      2. +
      3. To insert the pages in your header; modify header.php insert the code anywhere inside the body tag. (You may want to add the depth=1 parameter on the 2nd line if you only want top level pages listed)
      4. +
      + Then to enable the excludePagesFeature find the line $excludePagesFeature = false; near the top of pagemash.php and change the value to true. +
    4. +
    +

    Code:

    + + <?php if(function_exists('pageMash_exclude_pages')){$exclude_pages=pageMash_exclude_pages();} else{$exclude_pages='';}?>
    + <?php wp_list_pages('title_li=<h2>Pages</h2>&exclude='.$exclude_pages);?>
    -

    For more information on the wp_list_pages() function checkout the Wordpress Codex and if you have any further questions, just drop me an email.

    +

    The plugin code is very simple and flexible, for more information look at the wp_list_pages() function on the Wordpress Codex and if you have any further questions or feedback, just drop me an email.

    '.$_GET["page"], 'pagemash')){ // only include header stuff on pagemash admin page +if(strrpos('>'.$_GET["page"], 'pagemash')): // only include header stuff on pagemash admin page //stylesheet & javascript to go in page header global $instantUpdateFeature, $excludePagesFeature; ?> - + + + \ No newline at end of file diff --git a/saveList.php b/saveList.php new file mode 100644 index 0000000..54947f8 --- /dev/null +++ b/saveList.php @@ -0,0 +1,44 @@ +decode(stripslashes($_POST['m'])); + +function saveList($parent, $children) { + global $wpdb, $excludePages; + + $parent = (int) $parent; + $result = array(); + $i = 1; + foreach ($children as $k => $v) { + + //IDs are 'JM_#' so strip first 3 characters + $id = (int) substr($children[$k]->id, 3); + + //if it had the remove class it is now added to the excludePages var + if($v->hide=='exclude') $excludePages .= $id.','; + + //update pages in db + $postquery = "UPDATE $wpdb->posts SET menu_order='$i', post_parent='$parent' WHERE ID='$id'"; + $wpdb->query($postquery); + + echo $postquery; + echo "\n"; + + if (isset($v->children[0])) {saveList($id, $v->children);} + $i++; + } +} + +echo saveList(0, $aMenu); + +//update excludePages option in database +update_option("exclude_pages", $excludePages, '', 'yes'); +?> \ No newline at end of file