function RulesContainerPlugin::executeByArgs

Executes container with the given arguments.

Condition containers just return a boolean while action containers return the configured provided variables as an array of variables.

Overrides RulesPlugin::executeByArgs

File

includes/rules.core.inc, line 2346

Class

RulesContainerPlugin

Base class for ContainerPlugins like Rules, Logical Operations or Loops.

Code

public function executeByArgs($args = array()) {
    $replacements = array(
        '%label' => $this->label(),
        '@plugin' => $this->itemName,
    );
    rules_log('Executing @plugin %label.', $replacements, RulesLog::INFO, $this, TRUE);
    $this->processSettings();
    $state = $this->setUpState($args);
    // Handle recursion prevention.
    if ($state->isBlocked($this)) {
        return rules_log('Not evaluating @plugin %label to prevent recursion.', array(
            '%label' => $this->label(),
            '@plugin' => $this->plugin(),
        ), RulesLog::INFO);
    }
    // Block the config to prevent any future recursion.
    $state->block($this);
    module_invoke_all('rules_config_execute', $this);
    $result = $this->evaluate($state);
    $return = $this->returnVariables($state, $result);
    $state->unblock($this);
    $state->cleanUp();
    rules_log('Finished executing of @plugin %label.', $replacements, RulesLog::INFO, $this, FALSE);
    return $return;
}