hook_shortcut_default_set

hook_shortcut_default_set($account)

Return the name of a default shortcut set for the provided user account.

This hook allows modules to define default shortcut sets for a particular user that differ from the site-wide default (for example, a module may want to define default shortcuts on a per-role basis).

The default shortcut set is used only when the user does not have any other shortcut set explicitly assigned to them.

Note that only one default shortcut set can exist per user, so when multiple modules implement this hook, the last (i.e., highest weighted) module which returns a valid shortcut set name will prevail.

Parameters

$account: The user account whose default shortcut set is being requested.

Return value

string The name of the shortcut set that this module recommends for that user, if there is one.

Related topics

Hooks

Define functions that alter the behavior of Drupal core.

File

core/modules/shortcut/shortcut.api.php, line 33

Hooks provided by the Shortcut module.

Code

function hook_shortcut_default_set($account) {
  // Use a special set of default shortcuts for administrators only.
  $roles = \Drupal::entityManager()->getStorage('user_role')->loadByProperties(['is_admin' => TRUE]);
  $user_admin_roles = array_intersect(array_keys($roles), $account->getRoles());
  if ($user_admin_roles) {
    return 'admin-shortcuts';
  }
}