function ModulesListForm::buildRow

Same name in other branches
  1. 8.9.x core/modules/system/src/Form/ModulesListForm.php \Drupal\system\Form\ModulesListForm::buildRow()
  2. 10 core/modules/system/src/Form/ModulesListForm.php \Drupal\system\Form\ModulesListForm::buildRow()
  3. 11.x core/modules/system/src/Form/ModulesListForm.php \Drupal\system\Form\ModulesListForm::buildRow()

Builds a table row for the system modules page.

Parameters

array $modules: The list existing modules.

\Drupal\Core\Extension\Extension $module: The module for which to build the form row.

$distribution: The distribution.

Return value

array The form row for the given module.

1 call to ModulesListForm::buildRow()
ModulesListForm::buildForm in core/modules/system/src/Form/ModulesListForm.php
Form constructor.

File

core/modules/system/src/Form/ModulesListForm.php, line 253

Class

ModulesListForm
Provides module installation interface.

Namespace

Drupal\system\Form

Code

protected function buildRow(array $modules, Extension $module, $distribution) {
    // Set the basic properties.
    $row['#required'] = [];
    $row['#requires'] = [];
    $row['#required_by'] = [];
    $lifecycle = $module->info[ExtensionLifecycle::LIFECYCLE_IDENTIFIER];
    $row['name']['#markup'] = $module->info['name'];
    if ($lifecycle !== ExtensionLifecycle::STABLE && !empty($module->info[ExtensionLifecycle::LIFECYCLE_LINK_IDENTIFIER])) {
        $row['name']['#markup'] .= ' ' . Link::fromTextAndUrl('(' . $this->t('@lifecycle', [
            '@lifecycle' => ucfirst($lifecycle),
        ]) . ')', Url::fromUri($module->info[ExtensionLifecycle::LIFECYCLE_LINK_IDENTIFIER], [
            'attributes' => [
                'class' => [
                    'module-link--non-stable',
                ],
                'aria-label' => $this->t('View information on the @lifecycle status of the module @module', [
                    '@lifecycle' => ucfirst($lifecycle),
                    '@module' => $module->info['name'],
                ]),
            ],
        ]))
            ->toString();
    }
    $row['description']['#markup'] = $this->t($module->info['description']);
    $row['version']['#markup'] = $module->info['version'];
    // Generate link for module's help page. Assume that if a hook_help()
    // implementation exists then the module provides an overview page, rather
    // than checking to see if the page exists, which is costly.
    if ($this->moduleHandler
        ->moduleExists('help') && $module->status && $this->moduleHandler
        ->hasImplementations('help', $module->getName())) {
        $row['links']['help'] = [
            '#type' => 'link',
            '#title' => $this->t('Help <span class="visually-hidden">for @module</span>', [
                '@module' => $module->info['name'],
            ]),
            '#url' => Url::fromRoute('help.page', [
                'name' => $module->getName(),
            ]),
            '#options' => [
                'attributes' => [
                    'class' => [
                        'module-link',
                        'module-link-help',
                    ],
                ],
            ],
        ];
    }
    // Generate link for module's permission, if the user has access to it.
    if ($module->status && $this->currentUser
        ->hasPermission('administer permissions') && $this->permissionHandler
        ->moduleProvidesPermissions($module->getName())) {
        $row['links']['permissions'] = [
            '#type' => 'link',
            '#title' => $this->t('Permissions <span class="visually-hidden">for @module</span>', [
                '@module' => $module->info['name'],
            ]),
            '#url' => Url::fromRoute('user.admin_permissions.module', [
                'modules' => $module->getName(),
            ]),
            '#options' => [
                'attributes' => [
                    'class' => [
                        'module-link',
                        'module-link-permissions',
                    ],
                ],
            ],
        ];
    }
    // Generate link for module's configuration page, if it has one.
    if ($module->status && isset($module->info['configure'])) {
        $route_parameters = $module->info['configure_parameters'] ?? [];
        if ($this->accessManager
            ->checkNamedRoute($module->info['configure'], $route_parameters, $this->currentUser)) {
            $row['links']['configure'] = [
                '#type' => 'link',
                '#title' => $this->t('Configure <span class="visually-hidden">@module</span>', [
                    '@module' => $module->info['name'],
                ]),
                '#url' => Url::fromRoute($module->info['configure'], $route_parameters),
                '#options' => [
                    'attributes' => [
                        'class' => [
                            'module-link',
                            'module-link-configure',
                        ],
                    ],
                ],
            ];
        }
    }
    // Present a checkbox for installing and indicating the status of a module.
    $row['enable'] = [
        '#type' => 'checkbox',
        '#title' => $this->t('Install'),
        '#default_value' => (bool) $module->status,
        '#disabled' => (bool) $module->status,
    ];
    // Disable the checkbox for required modules.
    if (!empty($module->info['required'])) {
        // Used when displaying modules that are required by the installation profile
        $row['enable']['#disabled'] = TRUE;
        $row['#required_by'][] = $distribution . (!empty($module->info['explanation']) ? ' (' . $module->info['explanation'] . ')' : '');
    }
    // Check the compatibilities.
    $compatible = TRUE;
    // Initialize an empty array of reasons why the module is incompatible. Add
    // each reason as a separate element of the array.
    $reasons = [];
    // Check the core compatibility.
    if ($module->info['core_incompatible']) {
        $compatible = FALSE;
        $reasons[] = $this->t('This version is not compatible with Drupal @core_version and should be replaced.', [
            '@core_version' => \Drupal::VERSION,
        ]);
        $row['#requires']['core'] = $this->t('Drupal Core (@core_requirement) (<span class="admin-missing">incompatible with</span> version @core_version)', [
            '@core_requirement' => $module->info['core_version_requirement'] ?? $module->info['core'],
            '@core_version' => \Drupal::VERSION,
        ]);
    }
    // Ensure this module is compatible with the currently installed version of PHP.
    if (version_compare(phpversion(), $module->info['php']) < 0) {
        $compatible = FALSE;
        $required = $module->info['php'] . (substr_count($module->info['php'], '.') < 2 ? '.*' : '');
        $reasons[] = $this->t('This module requires PHP version @php_required and is incompatible with PHP version @php_version.', [
            '@php_required' => $required,
            '@php_version' => phpversion(),
        ]);
    }
    // If this module is not compatible, disable the checkbox.
    if (!$compatible) {
        $status = implode(' ', $reasons);
        $row['enable']['#disabled'] = TRUE;
        $row['description']['#markup'] = $status;
        $row['#attributes']['class'][] = 'incompatible';
    }
    // If this module requires other modules, add them to the array.
    
    /** @var \Drupal\Core\Extension\Dependency $dependency_object */
    foreach ($module->requires as $dependency => $dependency_object) {
        // @todo Add logic for not displaying hidden modules in
        //   https://drupal.org/node/3117829.
        if ($incompatible = $this->checkDependencyMessage($modules, $dependency, $dependency_object)) {
            $row['#requires'][$dependency] = $incompatible;
            $row['enable']['#disabled'] = TRUE;
            continue;
        }
        $name = $modules[$dependency]->info['name'];
        $row['#requires'][$dependency] = $modules[$dependency]->status ? $this->t('@module', [
            '@module' => $name,
        ]) : $this->t('@module (<span class="admin-disabled">disabled</span>)', [
            '@module' => $name,
        ]);
    }
    // If this module is required by other modules, list those, and then make it
    // impossible to disable this one.
    foreach ($module->required_by as $dependent => $version) {
        if (isset($modules[$dependent]) && empty($modules[$dependent]->info['hidden'])) {
            if ($modules[$dependent]->status == 1 && $module->status == 1) {
                $row['#required_by'][$dependent] = $this->t('@module', [
                    '@module' => $modules[$dependent]->info['name'],
                ]);
                $row['enable']['#disabled'] = TRUE;
            }
            else {
                $row['#required_by'][$dependent] = $this->t('@module (<span class="admin-disabled">disabled</span>)', [
                    '@module' => $modules[$dependent]->info['name'],
                ]);
            }
        }
    }
    return $row;
}

Buggy or inaccurate documentation? Please file an issue. Need support? Need help programming? Connect with the Drupal community.