ui.plugins.inc

Contains UI for diverse plugins provided by Rules.

File

ui/ui.plugins.inc

View source
<?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

Title Deprecated Summary
RulesLoopUI UI for Rules loops.
RulesReactionRuleUI Reaction rule specific UI.
RulesRuleSetUI Rule set specific UI.
RulesRuleUI Rule specific UI.