如何更改菜单链接的标题？

随着时间的推移，用户可以在我的网站上收集一些“要点”。我有一个带有一些链接的顶层菜单（例如，“家庭”，“个人资料”，“注销”）。我想更改菜单项“配置文件”，并添加当前连接的用户拥有的点数。

我尝试了几次钩子，然后几乎成功获得了想要的东西hook_link_alter()。

function mycustommodule_link_alter(&$variables) {
  if ($variables['text'] == "profile") {
    // Do some work.
    $variables['text'] = $variables['text'] . " (you have $nb_points points)";
  }
}

我清除了缓存（带有drush cr），菜单项显示了我想要的值。但是，如果该值由于某些原因发生变化，则表明它是旧值。我必须一直清除缓存以更新其值。

如何避免在每次从用户获得的点更改时都清除缓存以更新菜单标题？

我建议实现自定义菜单链接插件。下面的代码假定您的模块名称为example。

<?php

namespace Drupal\example\Plugin\Menu;

use Drupal\Core\Database\Connection;
use Drupal\Core\Menu\MenuLinkDefault;
use Drupal\Core\Menu\StaticMenuLinkOverridesInterface;
use Symfony\Component\DependencyInjection\ContainerInterface;

/**
 * A menu link that displays number of points.
 */
class ExampleMenuLink extends MenuLinkDefault {

  /**
   * The database connection.
   *
   * @var \Drupal\Core\Database\Connection
   */
  protected $dbConnection;

  /**
   * Constructs a new points menu link.
   *
   * @param array $configuration
   *   A configuration array containing information about the plugin instance.
   * @param string $plugin_id
   *   The plugin_id for the plugin instance.
   * @param mixed $plugin_definition
   *   The plugin implementation definition.
   * @param \Drupal\Core\Menu\StaticMenuLinkOverridesInterface $static_override
   *   The static override storage.
   * @param \Drupal\Core\Database\Connection $db_connection
   *   The database connection.
   */
  public function __construct(array $configuration, $plugin_id, $plugin_definition, StaticMenuLinkOverridesInterface $static_override, Connection $db_connection) {
    parent::__construct($configuration, $plugin_id, $plugin_definition, $static_override);
    $this->dbConnection = $db_connection;
  }

  /**
   * {@inheritdoc}
   */
  public static function create(ContainerInterface $container, array $configuration, $plugin_id, $plugin_definition) {
    return new static(
      $configuration,
      $plugin_id,
      $plugin_definition,
      $container->get('menu_link.static.overrides'),
      $container->get('database')
    );
  }

  /**
   * {@inheritdoc}
   */
  public function getTitle() {
    $count = $this->dbConnection->query('SELECT COUNT(*) FROM {example_points}')->fetchField();
    return $this->t('You have (@count) points', ['@count' => $count]);
  }

  /**
   * {@inheritdoc}
   */
  public function getCacheTags() {
    // Invalidate these tags when number of points is changed.
    return ['example.points_count'];
  }

}

如果您不想注入数据库服务，则该类将变得更加简单。

<?php

namespace Drupal\example\Plugin\Menu;

use Drupal\Core\Menu\MenuLinkDefault;
use Drupal\Core\Menu\StaticMenuLinkOverridesInterface;
use Symfony\Component\DependencyInjection\ContainerInterface;

/**
 * A menu link that displays number of points.
 */
class ExampleMenuLink extends MenuLinkDefault {

  /**
   * {@inheritdoc}
   */
  public function getTitle() {
    $count = \Drupal::database()->query('SELECT COUNT(*) FROM {example_points}')->fetchField();
    return $this->t('You have (@count) points', ['@count' => $count]);
  }

  /**
   * {@inheritdoc}
   */
  public function getCacheTags() {
    // Invalidate these tags when number of points is changed.
    return ['example.points_count'];
  }

}

接下来，您需要将链接定义放入example.links.menu.yml文件。

example.user_points:
  route_name: <front>
  menu_name: main
  class: Drupal\example\Plugin\Menu\ExampleMenuLink
  weight: 30

缓存问题

无论何时更改点数，菜单链接缓存都应按以下方式失效。

 \Drupal::service('cache_tags.invalidator')->invalidateTags(['example.points_count']);

您需要为此找到合适的位置。如果由贡献模块管理的点检查模块API并选择适当的钩子（hook_points_insert（），hook_points_delete（）等）。

由于积分是针对每个用户帐户分别计算的，因此您可以考虑使用每个帐户缓存标签（例如['example.points_count.' . $uid]）。因此，将为点数不变的用户保留缓存。

为了生成Menu链接插件的代码，我使用了Drupal Code Generator。

我遇到了同样的问题。菜单项已缓存，因此在您清除缓存之前，它始终显示旧值。另一种方法是使用hook_page_attachments()，将点附加到drupalSettings.YOUR_MODULE_OR_THEME.YOUR_VARIABLE，并使用JavaScript访问它们，然后在浏览器中呈现。

通常的方法是每当站点性能显示“配置文件”菜单时，就禁用页面的缓存。

hook_preprocess_menu()通过设置$variables['#cache']['max-age']为0来禁用该菜单的缓存。