You are here

public function BookManager::bookTreeAllData in Drupal 9

Same name and namespace in other branches
  1. 8 core/modules/book/src/BookManager.php \Drupal\book\BookManager::bookTreeAllData()

Gets the data structure representing a named menu tree.

Since this can be the full tree including hidden items, the data returned may be used for generating an admin interface or a select.

Note: based on menu_tree_all_data().

Parameters

int $bid: The Book ID to find links for.

array|null $link: (optional) A fully loaded menu link, or NULL. If a link is supplied, only the path to root will be included in the returned tree - as if this link represented the current page in a visible menu.

int|null $max_depth: (optional) Maximum depth of links to retrieve. Typically useful if only one or two levels of a sub tree are needed in conjunction with a non-NULL $link, in which case $max_depth should be greater than $link['depth'].

Return value

array A tree of menu links in an array, in the order they should be rendered.

Overrides BookManagerInterface::bookTreeAllData

2 calls to BookManager::bookTreeAllData()
BookManager::bookTreeGetFlat in core/modules/book/src/BookManager.php
Gets the book for a page and returns it as a linear array.
BookManager::getTableOfContents in core/modules/book/src/BookManager.php
Returns an array of book pages in table of contents order.

File

core/modules/book/src/BookManager.php, line 541

Class

BookManager
Defines a book manager.

Namespace

Drupal\book

Code

public function bookTreeAllData($bid, $link = NULL, $max_depth = NULL) {

  // Use $nid as flag for whether the data being loaded is for the whole tree.
  $nid = isset($link['nid']) ? $link['nid'] : 0;
  $langcode = $this->languageManager
    ->getCurrentLanguage(LanguageInterface::TYPE_CONTENT)
    ->getId();

  // Create a cache ID for the given $nid, $link, $langcode and $max_depth.
  $cid = implode(':', [
    'book-links',
    $bid,
    $nid,
    $langcode,
    (int) $max_depth,
  ]);

  // Get it from cache, if available.
  if ($cache = $this->memoryCache
    ->get($cid)) {
    return $cache->data;
  }

  // If the tree data was not in the static cache, build $tree_parameters.
  $tree_parameters = [
    'min_depth' => 1,
    'max_depth' => $max_depth,
  ];
  if ($nid) {
    $active_trail = $this
      ->getActiveTrailIds($bid, $link);
    $tree_parameters['expanded'] = $active_trail;
    $tree_parameters['active_trail'] = $active_trail;
    $tree_parameters['active_trail'][] = $nid;
  }

  // Build the tree using the parameters.
  $tree_build = $this
    ->bookTreeBuild($bid, $tree_parameters);

  // Cache the tree build in memory.
  $this->memoryCache
    ->set($cid, $tree_build);
  return $tree_build;
}