Token UI browser + jQuery treeTable

Summary:

1. Adds a 'jquery.treeTable' library which essentially just contains jquery.treeTable.js and jquery.treeTable.css. There were other images included but see #2.
2. Adds a arrow-right.png so we can re-use our own internal images for the expand/collapse arrows. If this were accepted into core, we would want to add an arrow-left.png and arrow-right.png into the /misc folder.
3. Adds a token_tree theme element so that it can be used like the following:
   
   <?php
  $build['token_tree'] = array(
    '#theme' => 'token_tree',
    '#token_types' => array('node', 'comment'), // Specific token types to include.
    '#global_types' => FALSE, // Whether or not to include global token types like current-user, date, etc.
    '#click_insert' => TRUE, // Make tokens clickable & insert into last focused textfield
    '#recursion_limit' => 2, // Since tokens like comment and taxonomy terms can recurse infinitely, we have to set some kind of limit.
  );
?>

Todos:

1. Officially get the treeTable plugin MIT/GPLv2 dual licensed.
2. See if Dries wants this patch for core.
3. Improve documentation.
4. treeTable also supports a 'selectable' table and need 'light' versions of the arrows for the selected rows. Not sure what we can do for this.

Improvements, comments, etc are completely welcome.

I've been in contact with the jQuery treeTable author as noted in the other issue and he's up for dual-licensing. I've made an official issue for the plugin at http://plugins.jquery.com/node/13634.

sub

I'd actually say that 'current-user', 'date' and 'site' are global tokens since they do not need data and will always work. The #global_tokens is just a TRUE/FALSE to include all possible global token types. User can easily put a FALSE value for that and manually specify the exact token values to be included in the tree.

The recusion limit is defaulted to 4 levels in the path. 2 was just a bad example, but it's over-ridable.

@arhak: Technically the first part of the token doesn't count towards the recursion limit since it is only a type, and isn't a token that has chains, so that token is possible with a 4-depth limit. :)

Dave, just to clarify -- is the reason for the depth limit because the entire tree gets pre-rendered? I've been kicking around the idea of an XML or JSON chunk describing all the token types and their relationships to each other (via the 'type' property) just being passed to the client side, and building the tree there to avoid the overhead. Would that be brutal, do you think?

Makes sense. Eventually it would be cool to move to that sort of approach, but what you've posted above is also enough of a black box that the public interface to it wouldn't need to change if that approach were used down the line... I'd actually be thumbs-up on committing it to the D7 token branch as is, and treating it as something experimental. Token module in D7 could also form-alter the helper information into the spots in core that use tokens but don't fully explain them...

@cubicphuse: Woo-hoo! Welcome to the Drupal community and YOU ROCK!

Note that it must be GPLV2 and later to be included in Drupal's cvs repository.

Marking this issue as fixed since its been committed to 7.x and 6.x.