class UmamiHooks
Same name and namespace in other branches
- 11.x core/profiles/demo_umami/themes/umami/src/Hook/UmamiHooks.php \Drupal\umami\Hook\UmamiHooks
Hook implementations for umami.
Hierarchy
- class \Drupal\umami\Hook\UmamiHooks uses \Drupal\Core\StringTranslation\StringTranslationTrait
Expanded class hierarchy of UmamiHooks
File
-
core/
profiles/ demo_umami/ themes/ umami/ src/ Hook/ UmamiHooks.php, line 17
Namespace
Drupal\umami\HookView source
class UmamiHooks {
use StringTranslationTrait;
/**
* Implements hook_preprocess_HOOK() for html.
*
* Adds body classes if certain regions have content.
*/
public function preprocessHtml(&$variables) : void {
// Add a sidebar class if the sidebar has content in it.
if (!empty($variables['page']['sidebar'])) {
$variables['attributes']['class'][] = 'two-columns';
$variables['#attached']['library'][] = 'umami/two-columns';
}
else {
$variables['attributes']['class'][] = 'one-column';
}
}
/**
* Implements hook_preprocess_HOOK() for field.
*/
public function preprocessField(&$variables, $hook) : void {
$element = $variables['element'];
// Add class to label and items fields to be styled using the meta styles.
if (isset($element['#field_name'])) {
if ($element['#field_name'] == 'field_recipe_category' || $element['#field_name'] == 'field_tags' || $element['#field_name'] == 'field_difficulty') {
$variables['attributes']['class'][] = 'label-items';
if ($element['#view_mode'] == 'card' && $element['#field_name'] == 'field_difficulty') {
$variables['attributes']['class'][] = 'umami-card__label-items';
}
}
}
}
/**
* Implements hook_preprocess_HOOK() for block.
*/
public function preprocessBlock(&$variables) : void {
$variables['title_attributes']['class'][] = 'block__title';
// Add a class indicating the content block bundle.
if (isset($variables['elements']['content']['#block_content'])) {
$variables['attributes']['class'][] = Html::getClass('block-type-' . $variables['elements']['content']['#block_content']->bundle());
}
}
/**
* Implements hook_theme_suggestions_HOOK_alter() for block templates.
*/
public function themeSuggestionsBlockAlter(array &$suggestions, array $variables) : void {
// Block suggestions for content block bundles.
if (isset($variables['elements']['content']['#block_content'])) {
array_splice($suggestions, 1, 0, 'block__bundle__' . $variables['elements']['content']['#block_content']->bundle());
}
}
/**
* Implements hook_preprocess_HOOK() for block--bundle--banner-block.
*/
public function preprocessBlockBundleBannerBlock(&$variables) : void {
if (isset($variables['content']['field_content_link'])) {
foreach (Element::children($variables['content']['field_content_link']) as $key) {
$variables['content']['field_content_link'][$key]['#attributes']['class'][] = 'button';
$variables['content']['field_content_link'][$key]['#attributes']['class'][] = 'button--primary';
$variables['content']['field_content_link'][$key]['#attributes']['class'][] = 'banner__button';
}
}
}
/**
* Implements hook_preprocess_HOOK() for block bundle footer promo.
*/
public function preprocessBlockBundleFooterPromoBlock(&$variables) : void {
if (isset($variables['content']['field_content_link'])) {
foreach (Element::children($variables['content']['field_content_link']) as $key) {
$variables['content']['field_content_link'][$key]['#attributes']['class'][] = 'footer-block__link';
}
}
}
/**
* Implements hook_preprocess_HOOK() for breadcrumb.
*/
public function preprocessBreadcrumb(&$variables) : void {
// We are creating a variable for the Current Page Title, to allow us to
// print it after the breadcrumbs loop has run.
$route_match = \Drupal::routeMatch();
// Search page titles aren't resolved using the title_resolver service - it
// will always return 'Search' instead of 'Search for [term]', which would
// give us a breadcrumb of Home >> Search >> Search.
// @todo Revisit after https://www.drupal.org/project/drupal/issues/2359901
// @todo Revisit after https://www.drupal.org/project/drupal/issues/2403359
$entity = $route_match->getParameter('entity');
if ($entity instanceof SearchPageInterface) {
$variables['current_page_title'] = $entity->getPlugin()
->suggestedTitle();
}
else {
$variables['current_page_title'] = \Drupal::service('title_resolver')->getTitle(\Drupal::request(), $route_match->getRouteObject());
}
// Since we are printing the 'Current Page Title', add the URL cache
// context. If we don't, then we might end up with something like
// "Home > Articles" on the Recipes page, which should read
// "Home > Recipes".
$variables['#cache']['contexts'][] = 'url';
}
/**
* Implements hook_preprocess_HOOK() for menu-local-task.
*/
public function preprocessMenuLocalTask(&$variables) : void {
$variables['link']['#options']['attributes']['class'][] = 'tabs__link';
}
/**
* Implements hook_form_FORM_ID_alter() for search_block_form.
*/
public function formSearchBlockFormAlter(&$form, FormStateInterface $form_state) : void {
$form['keys']['#attributes']['placeholder'] = $this->t('Search by keyword, ingredient, dish');
}
/**
* Implements hook_preprocess_HOOK() for links--media-library-menu.
*
* This targets the menu of available media types in the media library's modal
* dialog.
*
* @todo Do this in the relevant template once
* https://www.drupal.org/project/drupal/issues/3088856 is resolved.
*/
public function preprocessLinksMediaLibraryMenu(array &$variables) : void {
foreach ($variables['links'] as &$link) {
$link['link']['#options']['attributes']['class'][] = 'media-library-menu__link';
}
}
/**
* Implements hook_form_alter().
*
* @todo revisit in https://drupal.org/node/3110132
*/
public function formAlter(array &$form, FormStateInterface $form_state, $form_id) : void {
$form_object = $form_state->getFormObject();
if ($form_object instanceof ViewsForm && str_starts_with($form_object->getBaseFormId(), 'views_form_media_library')) {
$form['#attributes']['class'][] = 'media-library-views-form';
}
}
/**
* Implements hook_preprocess_HOOK() for image-widget.
*
* @todo Revisit in https://drupal.org/node/3117430
*/
public function preprocessImageWidget(&$variables) : void {
if (!empty($variables['element']['fids']['#value'])) {
$file = reset($variables['element']['#files']);
$variables['data']["file_{$file->id()}"]['filename']['#suffix'] = ' <span class="file-size">(' . ByteSizeMarkup::create($file->getSize()) . ')</span> ';
}
}
/**
* Implements hook_preprocess_HOOK() for links.
*
* This makes it so array keys of #links items are added as a class. This
* functionality was removed in Drupal 8.1, but still necessary in some
* instances.
*
* @todo remove in https://drupal.org/node/3120962
*/
public function preprocessLinks(&$variables) : void {
if (!empty($variables['links'])) {
foreach ($variables['links'] as $key => $value) {
if (!is_numeric($key)) {
$class = Html::getClass($key);
$variables['links'][$key]['attributes']->addClass($class);
}
}
}
}
}
Members
| Title Sort descending | Modifiers | Object type | Summary | Overrides |
|---|---|---|---|---|
| StringTranslationTrait::$stringTranslation | protected | property | The string translation service. | 3 |
| 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. | 1 |
| UmamiHooks::formAlter | public | function | Implements hook_form_alter(). | |
| UmamiHooks::formSearchBlockFormAlter | public | function | Implements hook_form_FORM_ID_alter() for search_block_form. | |
| UmamiHooks::preprocessBlock | public | function | Implements hook_preprocess_HOOK() for block. | |
| UmamiHooks::preprocessBlockBundleBannerBlock | public | function | Implements hook_preprocess_HOOK() for block--bundle--banner-block. | |
| UmamiHooks::preprocessBlockBundleFooterPromoBlock | public | function | Implements hook_preprocess_HOOK() for block bundle footer promo. | |
| UmamiHooks::preprocessBreadcrumb | public | function | Implements hook_preprocess_HOOK() for breadcrumb. | |
| UmamiHooks::preprocessField | public | function | Implements hook_preprocess_HOOK() for field. | |
| UmamiHooks::preprocessHtml | public | function | Implements hook_preprocess_HOOK() for html. | |
| UmamiHooks::preprocessImageWidget | public | function | Implements hook_preprocess_HOOK() for image-widget. | |
| UmamiHooks::preprocessLinks | public | function | Implements hook_preprocess_HOOK() for links. | |
| UmamiHooks::preprocessLinksMediaLibraryMenu | public | function | Implements hook_preprocess_HOOK() for links--media-library-menu. | |
| UmamiHooks::preprocessMenuLocalTask | public | function | Implements hook_preprocess_HOOK() for menu-local-task. | |
| UmamiHooks::themeSuggestionsBlockAlter | public | function | Implements hook_theme_suggestions_HOOK_alter() for block templates. |
Buggy or inaccurate documentation? Please file an issue. Need support? Need help programming? Connect with the Drupal community.