danielebarchiesi@0: <?php
danielebarchiesi@0: 
danielebarchiesi@0: /**
danielebarchiesi@0:  * @file
danielebarchiesi@0:  *
danielebarchiesi@0:  * Plugin to provide an argument handler for a vocabulary id
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("Vocabulary: ID"),
danielebarchiesi@0:   // keyword to use for %substitution
danielebarchiesi@0:   'keyword' => 'vocabulary',
danielebarchiesi@0:   'description' => t('Creates a vocabulary context from a vocabulary ID argument.'),
danielebarchiesi@0:   'context' => 'ctools_vid_context',
danielebarchiesi@0:   'placeholder form' => array(
danielebarchiesi@0:     '#type' => 'textfield',
danielebarchiesi@0:     '#description' => t('Enter the vocabulary ID for this argument'),
danielebarchiesi@0:   ),
danielebarchiesi@0:   'no ui' => TRUE,
danielebarchiesi@0: );
danielebarchiesi@0: 
danielebarchiesi@0: /**
danielebarchiesi@0:  * Discover if this argument gives us the vocabulary we crave.
danielebarchiesi@0:  */
danielebarchiesi@0: function ctools_vid_context($arg = NULL, $conf = NULL, $empty = FALSE) {
danielebarchiesi@0:   // If unset it wants a generic, unfilled context.
danielebarchiesi@0:   if ($empty) {
danielebarchiesi@0:     return ctools_context_create_empty('entity:taxonomy_vocabulary');
danielebarchiesi@0:   }
danielebarchiesi@0: 
danielebarchiesi@0:   if (!is_numeric($arg)) {
danielebarchiesi@0:     return NULL;
danielebarchiesi@0:   }
danielebarchiesi@0: 
danielebarchiesi@0:   $vocabulary = taxonomy_vocabulary_load($arg);
danielebarchiesi@0:   if (!$vocabulary) {
danielebarchiesi@0:     return NULL;
danielebarchiesi@0:   }
danielebarchiesi@0: 
danielebarchiesi@0:   return ctools_context_create('vocabulary', $vocabulary);
danielebarchiesi@0: }
danielebarchiesi@0: