terms_from_node.inc
Plugin to provide an relationship handler for all terms from node.
File
-
plugins/
relationships/ terms_from_node.inc
View source
<?php
/**
* @file
* Plugin to provide an relationship handler for all terms from node.
*/
/**
* Plugins are described by creating a $plugin array which will be used
* by the system that includes this file.
*/
$plugin = array(
'title' => t('Multiple terms from node'),
'keyword' => 'terms',
'description' => t('Adds a taxonomy terms from a node context; if multiple terms are selected, they wil be concatenated.'),
'required context' => new ctools_context_required(t('Node'), 'node'),
'context' => 'ctools_terms_from_node_context',
'edit form' => 'ctools_terms_from_node_settings_form',
'defaults' => array(
'vocabulary' => array(),
'concatenator' => ',',
),
);
/**
* Return a new context based on an existing context.
*/
function ctools_terms_from_node_context($context, $conf) {
// If unset it wants a generic, unfilled context, which is just NULL.
if (empty($context->data)) {
return ctools_context_create_empty('terms', NULL);
}
// Collect all terms for the chosen vocabulary and concatenate them.
$node = $context->data;
$terms = array();
$fields = field_info_instances('node', $node->type);
foreach ($fields as $name => $info) {
$field_info = field_info_field($name);
if ($field_info['type'] == 'taxonomy_term_reference' && (empty($conf['vocabulary']) || !empty($conf['vocabulary'][$field_info['settings']['allowed_values'][0]['vocabulary']]))) {
$items = field_get_items('node', $node, $name);
if (is_array($items)) {
foreach ($items as $item) {
$terms[] = $item['tid'];
}
}
}
elseif ($field_info['type'] == 'entityreference' && $field_info['settings']['target_type'] == 'taxonomy_term') {
$items = field_get_items('node', $node, $name);
if (is_array($items)) {
$tids = array();
foreach ($items as $item) {
$tids[] = $item['target_id'];
}
$term_objects = taxonomy_term_load_multiple($tids);
foreach ($term_objects as $term) {
if (empty($conf['vocabulary']) || in_array($term->vocabulary_machine_name, $conf['vocabulary'])) {
$terms[] = $term->tid;
}
}
}
}
}
if (!empty($terms)) {
$all_terms = ctools_break_phrase(implode($conf['concatenator'], $terms));
return ctools_context_create('terms', $all_terms);
}
}
/**
* Settings form for the relationship.
*/
function ctools_terms_from_node_settings_form($form, &$form_state) {
$conf = $form_state['conf'];
$options = array();
foreach (taxonomy_vocabulary_get_names() as $name => $vocabulary) {
$options[$name] = $vocabulary->name;
}
$form['vocabulary'] = array(
'#title' => t('Vocabulary'),
'#type' => 'checkboxes',
'#options' => $options,
'#default_value' => $conf['vocabulary'],
'#prefix' => '<div class="clearfix">',
'#suffix' => '</div>',
);
$form['concatenator'] = array(
'#title' => t('Concatenator'),
'#type' => 'select',
'#options' => array(
',' => ', (AND)',
'+' => '+ (OR)',
),
'#default_value' => $conf['concatenator'],
'#prefix' => '<div class="clearfix">',
'#suffix' => '</div>',
'#description' => t("When the value from this context is passed on to a view as argument, the terms can be concatenated in the form of 1+2+3 (for OR) or 1,2,3 (for AND)."),
);
return $form;
}
Functions
Title | Deprecated | Summary |
---|---|---|
ctools_terms_from_node_context | Return a new context based on an existing context. | |
ctools_terms_from_node_settings_form | Settings form for the relationship. |