Term Queue simply allows you to make arbitrary collections of taxonomy terms (even across vocabularies) to use on your site. You can use it for lists such as "Top 10" or "New Something or other", whatever you want really. It makes use of the core weight based drag & drop for ordering and is very easy to use with a simple API for getting at your term queues.

Documentation (For Theme Developers):

In addition to allowing you to create collections of taxonomy terms, Term Queue will also generate theme-able blocks which allow you to quickly display your term queues on your site. To this end, you may want to be aware of the naming conventions employed in overriding the default theme functions that style your term queues. There are currently two ways to style a Term Queue. One way is to provide a style to be used across all of your term queues, and the other way is to theme a specific term queue.

To Provide A General Style:

By creating a theme function named "term_queue", taking in parameters "queue" and "terms", you can style how your term queue is output inside of the block. The "queue" parameter gives you access to information about a specific Term Queue object itself, while the "terms" parameter gives you access to that Term Queue's terms.

Example Term Queue Theme:
<?php
function your-theme-name_term_queue($queue, $terms)
{
 
$links = array();
    foreach(
$terms as $term){
     
$link = array(
       
'href' => 'taxonomy/term/' . $term->tid,
       
'title' => $term->name
     
);
       
$links[] = $link;
    }
    return
theme('links', $links, array('class' => 'term-queue-links'));
}
?>

To Provide A Per-Queue Style:

If you're using Term Queue in more than one place on your site, you may wish to style different term queues in different ways. Term Queue allows you to do this through the use of a separate theming function, which follows the style of:

your-theme-name_term_queue__the-term-queue-id($queue, $terms)

This works in the same fashion as the general styling function described above, but will only style term queues with the ID that matches the one you have provided in the function signature.

Example Function Call:
<?php function your-theme-name_term_queue__1($queue, $terms) ?>

From the Term Queue administration menu, you can retrieve a Term Queue's ID by hovering over the "Edit Terms" link. The ID is the last URL parameter (http://yoursite/admin/build/term_queue/id)

This project is sponsored by Phase2 Technology

Project Information

Downloads