danielebarchiesi@0: <?php
danielebarchiesi@0: 
danielebarchiesi@0: /**
danielebarchiesi@0:  * @file
danielebarchiesi@0:  *
danielebarchiesi@0:  * Plugin to provide a terms context
danielebarchiesi@0:  */
danielebarchiesi@0: 
danielebarchiesi@0: /**
danielebarchiesi@0:  * Plugins are described by creating a $plugin array which will be used
danielebarchiesi@0:  * by the system that includes this file.
danielebarchiesi@0:  */
danielebarchiesi@0: $plugin = array(
danielebarchiesi@0:   'title' => t("Taxonomy terms"),
danielebarchiesi@0:   'description' => t('Multiple taxonomy terms, as a group.'),
danielebarchiesi@0:   'context' => 'ctools_context_create_terms',
danielebarchiesi@0:   'keyword' => 'terms',
danielebarchiesi@0:   // This context is deprecated and should not be usable in the UI.
danielebarchiesi@0:   'no ui' => TRUE,
danielebarchiesi@0:   'context name' => 'terms',
danielebarchiesi@0:   'convert list' => array(
danielebarchiesi@0:     'tid' => t('Term ID of first term'),
danielebarchiesi@0:     'tids' => t('Term ID of all term, separated by + or ,'),
danielebarchiesi@0:     'name' => t('Term name of first term'),
danielebarchiesi@0:     'name_dashed' => t('Term name of first term, lowercased and spaces converted to dashes'),
danielebarchiesi@0:     'names' => t('Term name of all terms, separated by + or ,'),
danielebarchiesi@0:     'names_dashed' => t('Term name of all terms, separated by + or , and lowercased and spaces converted to dashes'),
danielebarchiesi@0:     'vid' => t('Vocabulary ID of first term'),
danielebarchiesi@0:   ),
danielebarchiesi@0:   'convert' => 'ctools_context_terms_convert',
danielebarchiesi@0: );
danielebarchiesi@0: 
danielebarchiesi@0: /**
danielebarchiesi@0:  * It's important to remember that $conf is optional here, because contexts
danielebarchiesi@0:  * are not always created from the UI.
danielebarchiesi@0:  */
danielebarchiesi@0: function ctools_context_create_terms($empty, $data = NULL, $conf = FALSE) {
danielebarchiesi@0:   // The input is expected to be an object as created by ctools_break_phrase
danielebarchiesi@0:   // which contains a group of terms.
danielebarchiesi@0: 
danielebarchiesi@0:   $context = new ctools_context(array('terms', 'entity:taxonomy_term'));
danielebarchiesi@0:   $context->plugin = 'terms';
danielebarchiesi@0: 
danielebarchiesi@0:   if ($empty) {
danielebarchiesi@0:     return $context;
danielebarchiesi@0:   }
danielebarchiesi@0: 
danielebarchiesi@0:   if (!empty($data) && is_object($data)) {
danielebarchiesi@0:     $context->operator = $data->operator;
danielebarchiesi@0:     $context->tids     = $data->value;
danielebarchiesi@0:     if (!isset($data->term)) {
danielebarchiesi@0:       // load the first term:
danielebarchiesi@0:       reset($context->tids);
danielebarchiesi@0:       $data->term = taxonomy_term_load(current($context->tids));
danielebarchiesi@0:     }
danielebarchiesi@0:     $context->data     = $data->term;
danielebarchiesi@0:     $context->title    = $data->term->name;
danielebarchiesi@0:     $context->argument = implode($context->operator == 'or' ? '+' : ',', array_unique($context->tids));
danielebarchiesi@0:     return $context;
danielebarchiesi@0:   }
danielebarchiesi@0: }
danielebarchiesi@0: 
danielebarchiesi@0: /**
danielebarchiesi@0:  * Convert a context into a string.
danielebarchiesi@0:  */
danielebarchiesi@0: function ctools_context_terms_convert($context, $type) {
danielebarchiesi@0:   switch ($type) {
danielebarchiesi@0:     case 'tid':
danielebarchiesi@0:       return $context->data->tid;
danielebarchiesi@0:     case 'tids':
danielebarchiesi@0:       return $context->argument;
danielebarchiesi@0:     case 'name':
danielebarchiesi@0:       return $context->data->name;
danielebarchiesi@0:     case 'name_dashed':
danielebarchiesi@0:       return drupal_strtolower(str_replace(' ', '-', $context->data->name));
danielebarchiesi@0:     case 'names':
danielebarchiesi@0:     case 'names_dashed':
danielebarchiesi@0:       // We only run this query if this item was requested:
danielebarchiesi@0:       if (!isset($context->names)) {
danielebarchiesi@0:         if (empty($context->tids)) {
danielebarchiesi@0:           $context->names = '';
danielebarchiesi@0:         }
danielebarchiesi@0:         else {
danielebarchiesi@0:           $result = db_query('SELECT tid, name FROM {taxonomy_term_data} WHERE tid IN (:tids)', array(':tids' => $context->tids));
danielebarchiesi@0:           foreach ($result as $term) {
danielebarchiesi@0:             $names[$term->tid] = $term->name;
danielebarchiesi@0:             if ($type == 'names_dashed') {
danielebarchiesi@0:               $names[$term->tid] = drupal_strtolower(str_replace(' ', '-', $names[$term->tid]));
danielebarchiesi@0:             }
danielebarchiesi@0:           }
danielebarchiesi@0:           $context->names = implode($context->operator == 'or' ? ' + ' : ', ', $names);
danielebarchiesi@0:         }
danielebarchiesi@0:       }
danielebarchiesi@0:       return $context->names;
danielebarchiesi@0:     case 'vid':
danielebarchiesi@0:       return $context->data->vid;
danielebarchiesi@0:   }
danielebarchiesi@0: }