trait ModulesEnabledTrait in Drupal 10
Provides helpers for enabling modules.
@internal
Hierarchy
- trait \Drupal\system\Form\ModulesEnabledTrait uses StringTranslationTrait
File
- core/
modules/ system/ src/ Form/ ModulesEnabledTrait.php, line 15
Namespace
Drupal\system\FormView source
trait ModulesEnabledTrait {
use StringTranslationTrait;
/**
* Gets the current user.
*
* @return \Drupal\Core\Session\AccountInterface
* The current user.
*/
protected abstract function currentUser();
/**
* Provides a confirmation message after modules have been enabled.
*
* @param string[] $modules
* Enabled module names, keyed by machine names.
*
* @return \Drupal\Core\StringTranslation\PluralTranslatableMarkup
* A confirmation message. If any of the enabled modules have permissions
* that the current user can manage, then include a link to the permissions
* page for those modules.
*/
protected function modulesEnabledConfirmationMessage(array $modules) : PluralTranslatableMarkup {
$machine_names = implode(',', array_keys($modules));
$url = Url::fromRoute('user.admin_permissions.module', [
'modules' => $machine_names,
]);
$module_names = implode(', ', array_values($modules));
$t_args = [
'%name' => $module_names,
'%names' => $module_names,
];
if ($url
->access($this
->currentUser())) {
return $this
->formatPlural(count($modules), 'Module %name has been enabled. Configure <a href=":link">related permissions</a>.', '@count modules have been enabled: %names. Configure <a href=":link">related permissions</a>.', $t_args + [
':link' => $url
->toString(),
]);
}
return $this
->formatPlural(count($modules), 'Module %name has been enabled.', '@count modules have been enabled: %names.', $t_args);
}
/**
* Provides a fail message after attempt to install a module.
*
* @param string[] $modules
* Enabled module names, keyed by machine names.
* @param Drupal\Core\Config\PreExistingConfigException $exception
* Exception thrown if configuration with the same name already exists.
*
* @return \Drupal\Core\StringTranslation\PluralTranslatableMarkup
* A confirmation message. If any of the enabled modules have permissions
* that the current user can manage, then include a link to the permissions
* page for those modules.
*/
protected function modulesFailToEnableMessage(array $modules, PreExistingConfigException $exception) : PluralTranslatableMarkup {
$config_objects = $exception
->flattenConfigObjects($exception
->getConfigObjects());
return $this
->formatPlural(count($config_objects), 'Unable to install @extension, %config_names already exists in active configuration.', 'Unable to install @extension, %config_names already exist in active configuration.', [
'%config_names' => implode(', ', $config_objects),
'@extension' => $modules['install'][$exception
->getExtension()],
]);
}
}
Members
Name | Modifiers | Type | Description | Overrides |
---|---|---|---|---|
ModulesEnabledTrait:: |
abstract protected | function | Gets the current user. | |
ModulesEnabledTrait:: |
protected | function | Provides a confirmation message after modules have been enabled. | |
ModulesEnabledTrait:: |
protected | function | Provides a fail message after attempt to install a module. | |
StringTranslationTrait:: |
protected | property | The string translation service. | 3 |
StringTranslationTrait:: |
protected | function | Formats a string containing a count of items. | |
StringTranslationTrait:: |
protected | function | Returns the number of plurals supported by a given language. | |
StringTranslationTrait:: |
protected | function | Gets the string translation service. | |
StringTranslationTrait:: |
public | function | Sets the string translation service to use. | 1 |
StringTranslationTrait:: |
protected | function | Translates a string to the current language or to a given language. |