class views_handler_field_term_node_tid
- 3.x modules/taxonomy/views_handler_field_term_node_tid.inc views_handler_field_term_node_tid
- 2.x modules/taxonomy/views_handler_field_term_node_tid.inc views_handler_field_term_node_tid
Field handler for terms.
Hierarchy
- class \views_object
- class \views_handler
Expanded class hierarchy of views_handler_field_term_node_tid
2 string references to 'views_handler_field_term_node_tid'
- taxonomy_views_data in modules/
taxonomy.views.inc - Implementation of hook_views_data()
- taxonomy_views_handlers in modules/
taxonomy.views.inc - Implementation of hook_views_handlers() to register all of the basic handlers views uses.
File
- modules/
taxonomy/ views_handler_field_term_node_tid.inc, line 6
View source
class views_handler_field_term_node_tid extends views_handler_field_prerender_list {
function init(&$view, $options) {
parent::init($view, $options);
if ($view->base_table == 'node_revisions') {
$this->additional_fields['vid'] = array('table' => 'node_revisions', 'field' => 'vid');
}
else {
$this->additional_fields['vid'] = array('table' => 'node', 'field' => 'vid');
}
}
function option_definition() {
$options = parent::option_definition();
$options['link_to_taxonomy'] = array('default' => TRUE);
$options['limit'] = array('default' => FALSE);
$options['vids'] = array('default' => array());
return $options;
}
/**
* Provide "link to term" option.
*/
function options_form(&$form, &$form_state) {
parent::options_form($form, $form_state);
$form['link_to_taxonomy'] = array(
'#title' => t('Link this field to its term page'),
'#type' => 'checkbox',
'#default_value' => !empty($this->options['link_to_taxonomy']),
);
$form['limit'] = array(
'#type' => 'checkbox',
'#title' => t('Limit terms by vocabulary'),
'#default_value' => $this->options['limit'],
);
$options = array();
$vocabularies = taxonomy_get_vocabularies();
foreach ($vocabularies as $voc) {
$options[$voc->vid] = check_plain($voc->name);
}
$form['vids'] = array(
'#prefix' => '<div><div id="edit-options-vids">',
'#suffix' => '</div></div>',
'#type' => 'checkboxes',
'#title' => t('Vocabularies'),
'#options' => $options,
'#default_value' => $this->options['vids'],
'#process' => array('expand_checkboxes', 'views_process_dependency'),
'#dependency' => array('edit-options-limit' => array(TRUE)),
);
}
/**
* Add this term to the query
*/
function query() {
$this->add_additional_fields();
}
function pre_render($values) {
$this->field_alias = $this->aliases['vid'];
$vids = array();
foreach ($values as $result) {
if (!empty($result->{$this->aliases['vid']})) {
$vids[] = $result->{$this->aliases['vid']};
}
}
if ($vids) {
$voc = '';
$voc_ids = array_filter($this->options['vids']);
if (!empty($this->options['limit']) && !empty($voc_ids)) {
$voc = " AND td.vid IN (" . implode(', ', array_keys($voc_ids)) . ")";
}
$result = db_query("SELECT tn.vid AS node_vid, td.*, v.name as vocabulary FROM {term_data} td INNER JOIN {term_node} tn ON td.tid = tn.tid INNER JOIN {vocabulary} v ON v.vid = td.vid WHERE tn.vid IN (" . implode(', ', $vids) . ")$voc ORDER BY td.weight, td.name");
while ($term = db_fetch_object($result)) {
$this->items[$term->node_vid][$term->tid]['name'] = check_plain($term->name);
$this->items[$term->node_vid][$term->tid]['tid'] = $term->tid;
$this->items[$term->node_vid][$term->tid]['vid'] = $term->vid;
$this->items[$term->node_vid][$term->tid]['vocabulary'] = check_plain($term->vocabulary);
if (!empty($this->options['link_to_taxonomy'])) {
$this->items[$term->node_vid][$term->tid]['make_link'] = TRUE;
$this->items[$term->node_vid][$term->tid]['path'] = taxonomy_term_path($term);
}
}
}
}
function render_item($count, $item) {
return $item['name'];
}
function document_self_tokens(&$tokens) {
$tokens['[' . $this->options['id'] . '-tid' . ']'] = t('The taxonomy term ID for the term.');
$tokens['[' . $this->options['id'] . '-name' . ']'] = t('The taxonomy term name for the term.');
$tokens['[' . $this->options['id'] . '-vid' . ']'] = t('The vocabulary ID for the vocabulary the term belongs to.');
$tokens['[' . $this->options['id'] . '-vocabulary' . ']'] = t('The name for the vocabulary the term belongs to.');
}
function add_self_tokens(&$tokens, $item) {
$tokens['[' . $this->options['id'] . '-tid' . ']'] = $item['tid'];
$tokens['[' . $this->options['id'] . '-name' . ']'] = $item['name'];
$tokens['[' . $this->options['id'] . '-vid' . ']'] = $item['vid'];
$tokens['[' . $this->options['id'] . '-vocabulary' . ']'] = $item['vocabulary'];
}
}
Members
Name | Modifiers | Type | Description |
---|---|---|---|
views_handler:: |
function | Take input from exposed filters and assign to this handler, if necessary. | |
views_handler:: |
function | Check whether current user has access to this handler. | |
views_handler:: |
function | Determine if the handler is considered 'broken', meaning it's a a placeholder used when a handler can't be found. | |
views_handler:: |
function | Determine if a handler can be exposed. | |
views_handler:: |
function | Ensure the main table for this handler is in the query. This is used a lot. | |
views_handler:: |
function | Render our chunk of the exposed filter form when selecting | |
views_handler:: |
function | Get information about the exposed form for the form renderer. | |
views_handler:: |
function | Submit the exposed filter form | |
views_handler:: |
function | Validate the exposed filter form | |
views_handler:: |
function | Set new exposed option defaults when exposed setting is flipped on. | |
views_handler:: |
function | Provide defaults for the handler. | |
views_handler:: |
function | Provide a form for setting options. | |
views_handler:: |
function | Perform any necessary changes to the form values prior to storage. There is no need for this function to actually store the data. | |
views_handler:: |
function | Validate the options form. | |
views_handler:: |
function | Get the join object that should be used for this handler. | |
views_handler:: |
function | If a handler has 'extra options' it will get a little settings widget and another form called extra_options. | |
views_handler:: |
function | Determine if this item is 'exposed', meaning it provides form elements to let users modify the view. | |
views_handler:: |
function | Determine if the argument needs a style plugin. | |
views_handler:: |
function | Perform any necessary changes to the form values prior to storage. There is no need for this function to actually store the data. | |
views_handler:: |
function | Validate the options form. | |
views_handler:: |
function | Run before the view is built. | |
views_handler:: |
function | Called just prior to query(), this lets a handler set up any relationship it needs. | |
views_handler:: |
function | If set to remember exposed input in the session, store it there. | |
views_handler:: |
function | Return a string representing this handler's name in the UI. | |
views_handler:: |
function | Validates the handler against the complete View. | |
views_handler_field:: |
function | Add 'additional' fields to the query. | |
views_handler_field:: |
function |
Provide extra data to the administration form Overrides views_handler:: |
|
views_handler_field:: |
function | Render a field using advanced settings. | |
views_handler_field:: |
function | Called to determine what to tell the clicksorter. | |
views_handler_field:: |
function | Determine if this field is click sortable. | |
views_handler_field:: |
function |
Construct a new field handler. Overrides views_object:: |
|
views_handler_field:: |
function | Return DIV or SPAN based upon the field's element type. | |
views_handler_field:: |
function | Get the 'render' tokens to use for advanced rendering. | |
views_handler_field:: |
function | Get this field's label. | |
views_handler_field:: |
function | Render this field as altered text, from a fieldset set by the user. | |
views_handler_field:: |
function | Render this field as a link, with the info from a fieldset set by the user. | |
views_handler_field:: |
function | Perform an advanced text render for the item. | |
views_handler_field:: |
function | Trim the field down to the specified length. | |
views_handler_field:: |
function | Call out to the theme() function, which probably just calls render() but allows sites to override output fairly easily. | |
views_handler_field:: |
function | ||
views_handler_field_prerender_list:: |
function |
Determine if advanced rendering is allowed. Overrides views_handler_field:: |
|
views_handler_field_prerender_list:: |
function | Return an array of items for the field. | |
views_handler_field_prerender_list:: |
function |
Render the field. Overrides views_handler_field:: |
|
views_handler_field_prerender_list:: |
function | Render all items in this field together. | |
views_handler_field_term_node_tid:: |
function |
Add any special tokens this field might use for itself. Overrides views_handler_field:: |
|
views_handler_field_term_node_tid:: |
function |
Document any special tokens this field might use for itself. Overrides views_handler_field:: |
|
views_handler_field_term_node_tid:: |
function |
init the handler with necessary data. Overrides views_handler_field:: |
|
views_handler_field_term_node_tid:: |
function |
Provide "link to term" option. Overrides views_handler_field_prerender_list:: |
|
views_handler_field_term_node_tid:: |
function |
Information about options for all kinds of purposes will be held here. Overrides views_handler_field_prerender_list:: |
|
views_handler_field_term_node_tid:: |
function |
Run before any fields are rendered. Overrides views_handler_field:: |
|
views_handler_field_term_node_tid:: |
function |
Add this term to the query Overrides views_handler_field:: |
|
views_handler_field_term_node_tid:: |
function | ||
views_object:: |
function | ||
views_object:: |
function | Set default options on this object. Called by the constructor in a complex chain to deal with backward compatibility. | |
views_object:: |
function | Set default options. For backward compatibility, it sends the options array; this is a feature that will likely disappear at some point. | |
views_object:: |
function | Let the handler know what its full definition is. | |
views_object:: |
function | Unpack options over our existing defaults, drilling down into arrays so that defaults don't get totally blown away. | |
views_object:: |
function |