class SupportTicketViewBuilder in Support Ticketing System 8

Render controller for support tickets.

View source

class SupportTicketViewBuilder extends EntityViewBuilder {

  /**
   * {@inheritdoc}
   */
  public function buildComponents(array &$build, array $entities, array $displays, $view_mode) {

    /** @var \Drupal\support_ticket\SupportTicketInterface[] $entities */
    if (empty($entities)) {
      return;
    }
    parent::buildComponents($build, $entities, $displays, $view_mode);
    foreach ($entities as $id => $entity) {
      $bundle = $entity
        ->bundle();
      $display = $displays[$bundle];
      if ($display
        ->getComponent('links')) {
        $build[$id]['links'] = array(
          '#lazy_builder' => [
            get_called_class() . '::renderLinks',
            [
              $entity
                ->id(),
              $view_mode,
              $entity
                ->language()
                ->getId(),
            ],
          ],
          '#create_placeholder' => TRUE,
        );
      }

      // Add Language field text element to support ticket render array.
      if ($display
        ->getComponent('langcode')) {
        $build[$id]['langcode'] = array(
          '#type' => 'item',
          '#title' => t('Language'),
          '#markup' => $entity
            ->language()
            ->getName(),
          '#prefix' => '<div id="field-language-display">',
          '#suffix' => '</div>',
        );
      }
    }
  }

  /**
   * #lazy_builder callback; builds a support ticket's links.
   *
   * @param string $support_ticket_entity_id
   *   The support ticket entity ID.
   * @param string $view_mode
   *   The view mode in which the support ticket entity is being viewed.
   * @param string $langcode
   *   The language in which the support ticket entity is being viewed.
   *
   * @return array
   *   A renderable array representing the support ticket links.
   */
  public static function renderLinks($support_ticket_entity_id, $view_mode, $langcode) {
    $links = array(
      '#theme' => 'links__support_ticket',
      '#pre_render' => array(
        'drupal_pre_render_links',
      ),
      '#attributes' => array(
        'class' => array(
          'links',
          'inline',
        ),
      ),
    );
    $entity = SupportTicket::load($support_ticket_entity_id)
      ->getTranslation($langcode);
    $links['support_ticket'] = static::buildLinks($entity, $view_mode);

    // Allow other modules to alter the support_ticket links.
    $hook_context = array(
      'view_mode' => $view_mode,
      'langcode' => $langcode,
    );
    \Drupal::moduleHandler()
      ->alter('support_ticket_links', $links, $entity, $hook_context);
    return $links;
  }

  /**
   * Build the default links (Read more) for a support ticket.
   *
   * @param \Drupal\support_ticket\SupportTicketInterface $entity
   *   The support ticket object.
   * @param string $view_mode
   *   A view mode identifier.
   *
   * @return array
   *   An array that can be processed by drupal_pre_render_links().
   */
  protected static function buildLinks(SupportTicketInterface $entity, $view_mode) {
    $links = array();

    // Always display a read more link on teasers because we have no way
    // to know when a teaser view is different than a full view.
    if ($view_mode == 'teaser') {
      $support_ticket_title_stripped = strip_tags($entity
        ->label());
      $links['support_ticket-readmore'] = array(
        'title' => t('Read more<span class="visually-hidden"> about @title</span>', array(
          '@title' => $support_ticket_title_stripped,
        )),
        'url' => $entity
          ->urlInfo(),
        'language' => $entity
          ->language(),
        'attributes' => array(
          'rel' => 'tag',
          'title' => $support_ticket_title_stripped,
        ),
      );
    }
    return array(
      '#theme' => 'links__support_ticket__support_ticket',
      '#links' => $links,
      '#attributes' => array(
        'class' => array(
          'links',
          'inline',
        ),
      ),
    );
  }

  /**
   * {@inheritdoc}
   */
  protected function alterBuild(array &$build, EntityInterface $entity, EntityViewDisplayInterface $display, $view_mode) {

    /** @var \Drupal\support_ticket\SupportTicketInterface $entity */
    parent::alterBuild($build, $entity, $display, $view_mode);
    if ($entity
      ->id()) {
      $build['#contextual_links']['support_ticket'] = array(
        'route_parameters' => array(
          'support_ticket' => $entity
            ->id(),
        ),
        'metadata' => array(
          'changed' => $entity
            ->getChangedTime(),
        ),
      );
    }
  }

}

Members

Name	Modifiers	Type	Description	Overrides
DependencySerializationTrait::$_entityStorages	protected	property	An array of entity type IDs keyed by the property name of their storages.
DependencySerializationTrait::$_serviceIds	protected	property	An array of service IDs keyed by property name used for serialization.
DependencySerializationTrait::__sleep	public	function		1
DependencySerializationTrait::__wakeup	public	function		2
DeprecatedServicePropertyTrait::__get	public	function	Allows to access deprecated/removed properties.
EntityHandlerBase::$moduleHandler	protected	property	The module handler to invoke hooks on.	2
EntityHandlerBase::moduleHandler	protected	function	Gets the module handler.	2
EntityHandlerBase::setModuleHandler	public	function	Sets the module handler for this handler.
EntityViewBuilder::$cacheBin	protected	property	The cache bin used to store the render cache.
EntityViewBuilder::$deprecatedProperties	protected	property
EntityViewBuilder::$entityDisplayRepository	protected	property	The entity display repository.
EntityViewBuilder::$entityRepository	protected	property	The entity repository service.
EntityViewBuilder::$entityType	protected	property	Information about the entity type.
EntityViewBuilder::$entityTypeId	protected	property	The type of entities for which this view builder is instantiated.
EntityViewBuilder::$languageManager	protected	property	The language manager.
EntityViewBuilder::$singleFieldDisplays	protected	property	The EntityViewDisplay objects created for individual field rendering.
EntityViewBuilder::$themeRegistry	protected	property	The theme registry.
EntityViewBuilder::addContextualLinks	protected	function	Add contextual links.
EntityViewBuilder::build	public	function	Builds an entity's view; augments entity defaults.
EntityViewBuilder::buildMultiple	public	function	Builds multiple entities' views; augments entity defaults.
EntityViewBuilder::createInstance	public static	function	Instantiates a new instance of this entity handler. Overrides EntityHandlerInterface::createInstance	2
EntityViewBuilder::getBuildDefaults	protected	function	Provides entity-specific defaults to the build process.	4
EntityViewBuilder::getCacheTags	public	function	The cache tag associated with this entity view builder. Overrides EntityViewBuilderInterface::getCacheTags
EntityViewBuilder::getSingleFieldDisplay	protected	function	Gets an EntityViewDisplay for rendering an individual field.
EntityViewBuilder::isViewModeCacheable	protected	function	Determines whether the view mode is cacheable.
EntityViewBuilder::resetCache	public	function	Resets the entity render cache. Overrides EntityViewBuilderInterface::resetCache
EntityViewBuilder::trustedCallbacks	public static	function	Lists the trusted callbacks provided by the implementing class. Overrides TrustedCallbackInterface::trustedCallbacks	2
EntityViewBuilder::view	public	function	Builds the render array for the provided entity. Overrides EntityViewBuilderInterface::view	4
EntityViewBuilder::viewField	public	function	Builds a renderable array for the value of a single field in an entity. Overrides EntityViewBuilderInterface::viewField
EntityViewBuilder::viewFieldItem	public	function	Builds a renderable array for a single field item. Overrides EntityViewBuilderInterface::viewFieldItem
EntityViewBuilder::viewMultiple	public	function	Builds the render array for the provided entities. Overrides EntityViewBuilderInterface::viewMultiple	4
EntityViewBuilder::__construct	public	function	Constructs a new EntityViewBuilder.	2
StringTranslationTrait::$stringTranslation	protected	property	The string translation service.	1
StringTranslationTrait::formatPlural	protected	function	Formats a string containing a count of items.
StringTranslationTrait::getNumberOfPlurals	protected	function	Returns the number of plurals supported by a given language.
StringTranslationTrait::getStringTranslation	protected	function	Gets the string translation service.
StringTranslationTrait::setStringTranslation	public	function	Sets the string translation service to use.	2
StringTranslationTrait::t	protected	function	Translates a string to the current language or to a given language.
SupportTicketViewBuilder::alterBuild	protected	function	Specific per-entity building. Overrides EntityViewBuilder::alterBuild
SupportTicketViewBuilder::buildComponents	public	function	Builds the component fields and properties of a set of entities. Overrides EntityViewBuilder::buildComponents
SupportTicketViewBuilder::buildLinks	protected static	function	Build the default links (Read more) for a support ticket.
SupportTicketViewBuilder::renderLinks	public static	function	#lazy_builder callback; builds a support ticket's links.
TrustedCallbackInterface::THROW_EXCEPTION		constant	Untrusted callbacks throw exceptions.
TrustedCallbackInterface::TRIGGER_SILENCED_DEPRECATION		constant	Untrusted callbacks trigger silenced E_USER_DEPRECATION errors.
TrustedCallbackInterface::TRIGGER_WARNING		constant	Untrusted callbacks trigger E_USER_WARNING errors.

You are here

class SupportTicketViewBuilder in Support Ticketing System 8

Hierarchy

File

Namespace

Members

API Navigation