function PluginBase::unpackOptions

Unpacks options over our existing defaults.

This will drill down into arrays so that defaults don't get totally blown away.

Overrides ViewsPluginInterface::unpackOptions

File

core/modules/views/src/Plugin/views/PluginBase.php, line 222

Class

PluginBase

Base class for any views plugin types.

Namespace

Code

public function unpackOptions(&$storage, $options, $definition = NULL, $all = TRUE, $check = TRUE) {
  if ($check && !is_array($options)) {
    return;
  }
  if (!isset($definition)) {
    $definition = $this->defineOptions();
  }
  foreach ($options as $key => $value) {
    if (is_array($value)) {
      // Ignore arrays with no definition.
      if (!$all && empty($definition[$key])) {
        continue;
      }
      if (!isset($storage[$key]) || !is_array($storage[$key])) {
        $storage[$key] = [];
      }
      // If we're just unpacking our known options, and we're dropping an
      // unknown array (as might happen for a dependent plugin fields) go
      // ahead and drop that in.
      if (!$all && isset($definition[$key]) && !isset($definition[$key]['contains'])) {
        $storage[$key] = $value;
        continue;
      }
      $this->unpackOptions($storage[$key], $value, $definition[$key]['contains'] ?? [], $all, FALSE);
    }
    elseif ($all || !empty($definition[$key])) {
      $storage[$key] = $value;
    }
  }
}