You are here

class BookExport in Drupal 9

Same name and namespace in other branches
  1. 8 core/modules/book/src/BookExport.php \Drupal\book\BookExport

Provides methods for exporting book to different formats.

If you would like to add another format, swap this class in container.

Hierarchy

Expanded class hierarchy of BookExport

1 file declares its use of BookExport
BookController.php in core/modules/book/src/Controller/BookController.php
1 string reference to 'BookExport'
book.services.yml in core/modules/book/book.services.yml
core/modules/book/book.services.yml
1 service uses BookExport
book.export in core/modules/book/book.services.yml
Drupal\book\BookExport

File

core/modules/book/src/BookExport.php, line 14

Namespace

Drupal\book
View source
class BookExport {

  /**
   * The node storage.
   *
   * @var \Drupal\Core\Entity\EntityStorageInterface
   */
  protected $nodeStorage;

  /**
   * The node view builder.
   *
   * @var \Drupal\Core\Entity\EntityViewBuilderInterface
   */
  protected $viewBuilder;

  /**
   * The book manager.
   *
   * @var \Drupal\book\BookManagerInterface
   */
  protected $bookManager;

  /**
   * The entity repository service.
   *
   * @var \Drupal\Core\Entity\EntityRepositoryInterface
   */
  protected $entityRepository;

  /**
   * Constructs a BookExport object.
   *
   * @param \Drupal\Core\Entity\EntityTypeManagerInterface $entity_type_manager
   *   The entity type manager.
   * @param \Drupal\book\BookManagerInterface $book_manager
   *   The book manager.
   * @param \Drupal\Core\Entity\EntityRepositoryInterface|null $entity_repository
   *   The entity repository service.
   */
  public function __construct(EntityTypeManagerInterface $entity_type_manager, BookManagerInterface $book_manager, EntityRepositoryInterface $entity_repository = NULL) {
    $this->nodeStorage = $entity_type_manager
      ->getStorage('node');
    $this->viewBuilder = $entity_type_manager
      ->getViewBuilder('node');
    $this->bookManager = $book_manager;
    if (!$entity_repository) {
      @trigger_error('The entity.repository service must be passed to ' . __NAMESPACE__ . '\\BookExport::__construct(). It was added in drupal:9.2.0 and will be required before drupal:10.0.0.', E_USER_DEPRECATED);
      $entity_repository = \Drupal::service('entity.repository');
    }
    $this->entityRepository = $entity_repository;
  }

  /**
   * Generates HTML for export when invoked by book_export().
   *
   * The given node is embedded to its absolute depth in a top level section. For
   * example, a child node with depth 2 in the hierarchy is contained in
   * (otherwise empty) <div> elements corresponding to depth 0 and depth 1.
   * This is intended to support WYSIWYG output; for instance, level 3 sections
   * always look like level 3 sections, no matter their depth relative to the
   * node selected to be exported as printer-friendly HTML.
   *
   * @param \Drupal\node\NodeInterface $node
   *   The node to export.
   *
   * @return array
   *   A render array representing the HTML for a node and its children in the
   *   book hierarchy.
   *
   * @throws \Exception
   *   Thrown when the node was not attached to a book.
   */
  public function bookExportHtml(NodeInterface $node) {
    if (!isset($node->book)) {
      throw new \Exception();
    }
    $tree = $this->bookManager
      ->bookSubtreeData($node->book);
    $contents = $this
      ->exportTraverse($tree, [
      $this,
      'bookNodeExport',
    ]);
    $node = $this->entityRepository
      ->getTranslationFromContext($node);
    return [
      '#theme' => 'book_export_html',
      '#title' => $node
        ->label(),
      '#contents' => $contents,
      '#depth' => $node->book['depth'],
      '#cache' => [
        'tags' => $node
          ->getEntityType()
          ->getListCacheTags(),
      ],
    ];
  }

  /**
   * Traverses the book tree to build printable or exportable output.
   *
   * During the traversal, the callback is applied to each node and is called
   * recursively for each child of the node (in weight, title order).
   *
   * @param array $tree
   *   A subtree of the book menu hierarchy, rooted at the current page.
   * @param callable $callable
   *   A callback to be called upon visiting a node in the tree.
   *
   * @return array
   *   The render array generated in visiting each node.
   */
  protected function exportTraverse(array $tree, $callable) {

    // If there is no valid callable, use the default callback.
    $callable = !empty($callable) ? $callable : [
      $this,
      'bookNodeExport',
    ];
    $build = [];
    foreach ($tree as $data) {

      // Access checking is already performed when building the tree.
      if ($node = $this->nodeStorage
        ->load($data['link']['nid'])) {
        $node = $this->entityRepository
          ->getTranslationFromContext($node);
        $children = $data['below'] ? $this
          ->exportTraverse($data['below'], $callable) : '';
        $build[] = call_user_func($callable, $node, $children);
      }
    }
    return $build;
  }

  /**
   * Generates printer-friendly HTML for a node.
   *
   * @param \Drupal\node\NodeInterface $node
   *   The node that will be output.
   * @param string $children
   *   (optional) All the rendered child nodes within the current node. Defaults
   *   to an empty string.
   *
   * @return array
   *   A render array for the exported HTML of a given node.
   *
   * @see \Drupal\book\BookExport::exportTraverse()
   */
  protected function bookNodeExport(NodeInterface $node, $children = '') {
    $build = $this->viewBuilder
      ->view($node, 'print', NULL);
    unset($build['#theme']);
    return [
      '#theme' => 'book_node_export_html',
      '#content' => $build,
      '#node' => $node,
      '#children' => $children,
    ];
  }

}

Members

Namesort descending Modifiers Type Description Overrides
BookExport::$bookManager protected property The book manager.
BookExport::$entityRepository protected property The entity repository service.
BookExport::$nodeStorage protected property The node storage.
BookExport::$viewBuilder protected property The node view builder.
BookExport::bookExportHtml public function Generates HTML for export when invoked by book_export().
BookExport::bookNodeExport protected function Generates printer-friendly HTML for a node.
BookExport::exportTraverse protected function Traverses the book tree to build printable or exportable output.
BookExport::__construct public function Constructs a BookExport object.