View::addDisplay

public View::addDisplay($plugin_id = 'page', $title = NULL, $id = NULL)

public function addDisplay($plugin_id = 'page', $title = NULL, $id = NULL) {
  if (empty($plugin_id)) {
    return FALSE;
  }

  $plugin = Views::pluginManager('display')->getDefinition($plugin_id);

  if (empty($plugin)) {
    $plugin['title'] = t('Broken');
  }

  if (empty($id)) {
    $id = $this->generateDisplayId($plugin_id);

    // Generate a unique human-readable name by inspecting the counter at the
    // end of the previous display ID, e.g., 'page_1'.
    if ($id !== 'default') {
      preg_match("/[0-9]+/", $id, $count);
      $count = $count[0];
    }
    else {
      $count = '';
    }

    if (empty($title)) {
      // If there is no title provided, use the plugin title, and if there are
      // multiple displays, append the count.
      $title = $plugin['title'];
      if ($count > 1) {
        $title .= ' ' . $count;
      }
    }
  }

  $display_options = array(
    'display_plugin' => $plugin_id,
    'id' => $id,
    // Cast the display title to a string since it is an object.
    // @see \Drupal\Core\StringTranslation\TranslatableMarkup
    'display_title' => (string) $title,
    'position' => $id === 'default' ? 0 : count($this->display),
    'display_options' => array(),
  );

  // Add the display options to the view.
  $this->display[$id] = $display_options;
  return $id;
}