ui.plugins.inc in Rules 7.2

Contains UI for diverse plugins provided by Rules.

File

ui/ui.plugins.inc

<?php

/**
 * @file
 * Contains UI for diverse plugins provided by Rules.
 */

/**
 * Rule specific UI.
 */
class RulesRuleUI extends RulesActionContainerUI {
  protected $rule;
  protected $conditions;

  /**
   * Constructs a RulesRuleUI object.
   *
   * @param FacesExtendable $object
   */
  public function __construct(FacesExtendable $object) {
    parent::__construct($object);
    $this->rule = $object;
    $this->conditions = $this->rule
      ->conditionContainer();
  }
  public function form(&$form, &$form_state, $options = array(), $iterator = NULL) {
    $form_state['rules_element'] = $this->rule;
    $label = $this->element
      ->label();

    // Automatically add a counter to unlabelled rules.
    if ($label == t('unlabeled') && !$this->element
      ->isRoot() && !empty($options['init'])) {
      $parent = $this->element
        ->parentElement();
      $label .= ' ' . count($parent
        ->getIterator());
    }

    // Components have already a label. If used inside a rule-set add a label
    // though. It's called 'Name' in the UI though.
    if (!$this->element
      ->isRoot()) {
      $form['label'] = array(
        '#type' => 'textfield',
        '#title' => t('Name'),
        '#default_value' => empty($options['init']) ? $label : '',
        '#required' => TRUE,
        '#weight' => 5,
        '#description' => t('A human-readable name shortly describing the rule.'),
      );
    }
    $form += array(
      'conditions' => array(
        '#weight' => -5,
        '#tree' => TRUE,
      ),
    );
    $this->conditions
      ->form($form['conditions'], $form_state);
    unset($form['conditions']['negate']);

    // Add actions form.
    $iterator = new RecursiveIteratorIterator($this->rule
      ->actions(), RecursiveIteratorIterator::SELF_FIRST);
    parent::form($form, $form_state, $options, $iterator);

    // Hide nested elements during creation.
    $form['elements']['#access'] = empty($options['init']);
    $form['conditions']['elements']['#access'] = empty($options['init']);
    $form_state['redirect'] = RulesPluginUI::path($this->element
      ->root()->name, 'edit', $this->element);
    if (!empty($options['button'])) {
      $form['submit']['#value'] = t('Save changes');
    }
  }

  /**
   * Applies the values of the form to the rule configuration.
   */
  public function form_extract_values($form, &$form_state) {
    $form_values = RulesPluginUI::getFormStateValues($form, $form_state);

    // Run condition and action container value extraction.
    if (isset($form['conditions'])) {
      $this->conditions
        ->extender('RulesConditionContainerUI')
        ->form_extract_values($form['conditions'], $form_state);
    }
    if (!empty($form_values['label'])) {
      $this->element->label = $form_values['label'];
    }
    parent::form_extract_values($form, $form_state);
  }
  public function operations() {

    // When rules are listed only show the edit and delete operations.
    $ops = parent::operations();
    $ops['#links'] = array_intersect_key($ops['#links'], array_flip(array(
      'edit',
      'delete',
    )));
    return $ops;
  }

}

/**
 * Reaction rule specific UI.
 */
class RulesReactionRuleUI extends RulesRuleUI {
  public function form(&$form, &$form_state, $options = array(), $iterator = NULL) {
    $form['events'] = array(
      '#type' => 'container',
      '#weight' => -10,
      '#access' => empty($options['init']),
    );
    $form['events']['table'] = array(
      '#theme' => 'table',
      '#caption' => 'Events',
      '#header' => array(
        t('Event'),
        t('Operations'),
      ),
      '#empty' => t('None'),
    );
    $form['events']['table']['#attributes']['class'][] = 'rules-elements-table';
    foreach ($this->rule
      ->events() as $event_name) {
      $event_handler = rules_get_event_handler($event_name, $this->rule
        ->getEventSettings($event_name));
      $event_operations = array(
        '#theme' => 'links__rules',
        '#attributes' => array(
          'class' => array(
            'rules-operations',
            'action-links',
            'rules_rule_event',
          ),
        ),
        '#links' => array(
          'delete_event' => array(
            'title' => t('delete'),
            'href' => RulesPluginUI::path($this->rule->name, 'delete/event/' . $event_name),
            'query' => drupal_get_destination(),
          ),
        ),
      );
      $form['events']['table']['#rows'][$event_name] = array(
        'data' => array(
          $event_handler
            ->summary(),
          array(
            'data' => $event_operations,
          ),
        ),
      );
    }

    // Add the "add event" row.
    $cell['colspan'] = 3;
    $cell['data']['#theme'] = 'links__rules';
    $cell['data']['#attributes']['class'][] = 'rules-operations-add';
    $cell['data']['#attributes']['class'][] = 'action-links';
    $cell['data']['#links']['add_event'] = array(
      'title' => t('Add event'),
      'href' => RulesPluginUI::path($this->rule->name, 'add/event'),
      'query' => drupal_get_destination(),
    );
    $form['events']['table']['#rows'][] = array(
      'data' => array(
        $cell,
      ),
      'class' => array(
        'rules-elements-add',
      ),
    );
    parent::form($form, $form_state, $options);
    unset($form['label']);
  }

  /**
   * Adds the configuration settings form (label, tags, description, ..).
   */
  public function settingsForm(&$form, &$form_state) {
    parent::settingsForm($form, $form_state);
    $form['settings']['active'] = array(
      '#type' => 'checkbox',
      '#title' => t('Active'),
      '#default_value' => !isset($this->rule->active) || $this->rule->active,
    );
    $form['settings']['weight'] = array(
      '#type' => 'weight',
      '#title' => t('Weight'),
      '#default_value' => $this->element->weight,
      '#weight' => 5,
      '#delta' => 10,
      '#description' => t('Order rules that react on the same event. Rules with a higher weight are evaluated after rules with less weight.'),
    );
    unset($form['settings']['component_provides']);
  }
  public function settingsFormExtractValues($form, &$form_state) {
    $form_values = RulesPluginUI::getFormStateValues($form['settings'], $form_state);
    parent::settingsFormExtractValues($form, $form_state);
    $this->rule->active = $form_values['active'];
    $this->rule->weight = $form_values['weight'];
  }

}

/**
 * Rule set specific UI.
 */
class RulesRuleSetUI extends RulesActionContainerUI {
  public function form(&$form, &$form_state, $options = array(), $iterator = NULL) {

    // Pass an iterator just iterating over the rules, thus no further child
    // elements will be displayed.
    parent::form($form, $form_state, $options, $this->element
      ->getIterator());

    // Only show the add rule link.
    $form['elements']['#add']['#links'] = array_intersect_key($form['elements']['#add']['#links'], array(
      'add_rule' => 1,
    ));
    $form['elements']['#attributes']['class'][] = 'rules-rule-set';
    $form['elements']['#caption'] = t('Rules');
  }

}

/**
 * UI for Rules loops.
 */
class RulesLoopUI extends RulesActionContainerUI {
  public function form(&$form, &$form_state, $options = array(), $iterator = NULL) {
    parent::form($form, $form_state, $options);
    $settings = $this->element->settings;
    $form['item'] = array(
      '#type' => 'fieldset',
      '#title' => t('Current list item'),
      '#description' => t('The variable used for holding each list item in the loop. This variable will be available inside the loop only.'),
      '#tree' => TRUE,
    );
    $form['item']['label'] = array(
      '#type' => 'textfield',
      '#title' => t('Variable label'),
      '#default_value' => $settings['item:label'],
      '#required' => TRUE,
    );
    $form['item']['var'] = array(
      '#type' => 'textfield',
      '#title' => t('Variable name'),
      '#default_value' => $settings['item:var'],
      '#description' => t('The variable name must contain only lowercase letters, numbers, and underscores and must be unique in the current scope.'),
      '#element_validate' => array(
        'rules_ui_element_machine_name_validate',
      ),
      '#required' => TRUE,
    );
  }
  public function form_extract_values($form, &$form_state) {
    parent::form_extract_values($form, $form_state);
    $form_values = RulesPluginUI::getFormStateValues($form, $form_state);
    $this->element->settings['item:var'] = $form_values['item']['var'];
    $this->element->settings['item:label'] = $form_values['item']['label'];
  }
  public function form_validate($form, &$form_state) {
    parent::form_validate($form, $form_state);
    $vars = $this->element
      ->availableVariables();
    $name = $this->element->settings['item:var'];
    if (isset($vars[$name])) {
      form_error($form['item']['var'], t('The variable name %name is already taken.', array(
        '%name' => $name,
      )));
    }
  }
  public function buildContent() {
    $content = parent::buildContent();
    $content['description']['item'] = array(
      '#caption' => t('List item'),
      '#theme' => 'rules_content_group',
    );
    $content['description']['item']['var'] = array(
      '#theme' => 'rules_variable_view',
      '#info' => $this->element
        ->listItemInfo(),
      '#name' => $this->element->settings['item:var'],
    );
    return $content;
  }

}

Classes

Name	Description
RulesLoopUI	UI for Rules loops.
RulesReactionRuleUI	Reaction rule specific UI.
RulesRuleSetUI	Rule set specific UI.
RulesRuleUI	Rule specific UI.