ca_pull_trigger

Versions

6

ca_pull_trigger()

Pull a trigger and evaluate any predicates associated with that trigger.

Parameters

... Accepts a variable number of arguments. The first should always be the string name of the trigger to pull with any additional arguments being the arguments expected by the trigger and used for evaluation.

Return value

TRUE or FALSE indicating if at least one predicate was evaluated.

Code

contributions/ubercart/ca/ca.module, line 162

<?php
function ca_pull_trigger() {
  // Trigger actions can pull other triggers. Lock predicates when they are
  // marked for evaluation so they can't be evaluated again.
  static $locked;

  $args = func_get_args();
  $trigger = array_shift($args);

  // Load the data for the specified trigger.
  $trigger_data = ca_load_trigger($trigger);

  // Fail if the specified trigger doesn't exist.
  if (!$trigger_data) {
    return FALSE;
  }

  // Load any predicates associated with the trigger.
  $predicates = ca_load_trigger_predicates($trigger);

  // Fail if we didn't find any predicates.
  if (!$predicates || count($predicates) == 0) {
    return FALSE;
  }

  // Prepare the arguments for evaluation.
  $arguments = ca_parse_trigger_args($trigger_data, $args);

  // Fail if we didn't receive the right type of or enough arguments.
  if (!$arguments) {
    return FALSE;
  }

  // Loop through the predicates and evaluate them one by one.
  foreach ($predicates as $pid => $predicate) {
    // Prevent the predicate from being evaluated if it already has been with
    // the same arguments.
    $key = $pid . serialize($arguments);
    if (!isset($locked[$key])) {
      // If all of a predicate's conditions evaluate to TRUE...
      if (ca_evaluate_conditions($predicate, $arguments)) {
        // Then perform its actions.
        ca_perform_actions($predicate, $arguments);
      }
    }
    $locked[$key] = TRUE;
  }

  return TRUE;
}
?>

Post new comment

Your name: *

E-mail: *

The content of this field is kept private and will not be shown publicly.

Homepage:

Subject:

Comment: *

• Allowed HTML tags: <a> <em> <strong> <cite> <code> <ul> <ol> <li> <dl> <dt> <dd>
• Lines and paragraphs break automatically.
• You may post code using <code>...</code> (generic) or <?php ... ?> (highlighted PHP) tags.
• Web page addresses and e-mail addresses turn into links automatically.

More information about formatting options

CAPTCHA

This question is for testing whether you are a human visitor and to prevent automated spam submissions.

What code is in the image?: *

Enter the characters shown in the image.