danielebarchiesi@0: <?php
danielebarchiesi@0: 
danielebarchiesi@0: /**
danielebarchiesi@0:  * @file
danielebarchiesi@0:  * Plugin to provide access control/visibility based on existence of a specified context
danielebarchiesi@0:  */
danielebarchiesi@0: 
danielebarchiesi@0: $plugin = array(
danielebarchiesi@0:   'title' => t("Context exists"),
danielebarchiesi@0:   'description' => t('Control access by whether or not a context exists and contains data.'),
danielebarchiesi@0:   'callback' => 'ctools_context_exists_ctools_access_check',
danielebarchiesi@0:   'settings form' => 'ctools_context_exists_ctools_access_settings',
danielebarchiesi@0:   'summary' => 'ctools_context_exists_ctools_access_summary',
danielebarchiesi@0:   'required context' => new ctools_context_required(t('Context'), 'any', TRUE),
danielebarchiesi@0:   'defaults' => array('exists' => TRUE),
danielebarchiesi@0: );
danielebarchiesi@0: 
danielebarchiesi@0: /**
danielebarchiesi@0:  * Settings form
danielebarchiesi@0:  */
danielebarchiesi@0: function ctools_context_exists_ctools_access_settings($form, &$form_state, $conf) {
danielebarchiesi@0:   $form['settings']['exists'] = array(
danielebarchiesi@0:     '#type' => 'radios',
danielebarchiesi@0:     '#description' => t("Check to see if the context exists (contains data) or does not exist (contains no data). For example, if a context is optional and the path does not contain an argument for that context, it will not exist."),
danielebarchiesi@0:     '#options' => array(TRUE => t('Exists'), FALSE => t("Doesn't exist")),
danielebarchiesi@0:     '#default_value' => $conf['exists'],
danielebarchiesi@0:   );
danielebarchiesi@0:   return $form;
danielebarchiesi@0: }
danielebarchiesi@0: 
danielebarchiesi@0: /**
danielebarchiesi@0:  * Check for access
danielebarchiesi@0:  */
danielebarchiesi@0: function ctools_context_exists_ctools_access_check($conf, $context) {
danielebarchiesi@0:   // xor returns false if the two bools are the same, and true if they are not.
danielebarchiesi@0:   // i.e, if we asked for context_exists and it does, return true.
danielebarchiesi@0:   // If we asked for context does not exist and it does, return false.
danielebarchiesi@0:   return (empty($context->data) xor !empty($conf['exists']));
danielebarchiesi@0: }
danielebarchiesi@0: 
danielebarchiesi@0: /**
danielebarchiesi@0:  * Provide a summary description based upon the specified context
danielebarchiesi@0:  */
danielebarchiesi@0: function ctools_context_exists_ctools_access_summary($conf, $context) {
danielebarchiesi@0:   if (!empty($conf['exists'])) {
danielebarchiesi@0:     return t('@identifier exists', array('@identifier' => $context->identifier));
danielebarchiesi@0:   }
danielebarchiesi@0:   else {
danielebarchiesi@0:     return t('@identifier does not exist', array('@identifier' => $context->identifier));
danielebarchiesi@0:   }
danielebarchiesi@0: }