Menu callback; provides module enable/disable interface.

The list of modules gets populated by module.info files, which contain each module's name, description, and information about which modules it requires. See drupal_parse_info_file() for information on module.info descriptors.

Dependency checking is performed to ensure that a module:

• can not be enabled if there are disabled modules it requires.
• can not be disabled if there are enabled modules which depend on it.

Parameters

$form_state: An associative array containing the current state of the form.

Return value

The form array.

See also

theme_system_modules()

system_modules_submit()

Related topics

1 string reference to 'system_modules'

system_menu in modules/system/system.module

Implements hook_menu().

File

modules/system/system.admin.inc, line 791

Code

function system_modules ($form, $form_state = array()) {
 // Get current list of modules.
 $files = system_rebuild_module_data ();
 // Remove hidden modules from display list.
 $visible_files = $files;
 foreach ($visible_files as $filename => $file) {
 if (!empty($file->info['hidden'])) {
 unset($visible_files[$filename]);
 }
 }
 uasort ($visible_files, 'system_sort_modules_by_info_name');
 // If the modules form was submitted, then system_modules_submit() runs first
 // and if there are unfilled required modules, then $form_state['storage'] is
 // filled, triggering a rebuild. In this case we need to display a
 // confirmation form.
 if (!empty($form_state['storage'])) {
 return system_modules_confirm_form ($visible_files, $form_state['storage']);
 }
 $modules = array();
 $form['modules'] = array(
 '#tree' => TRUE,
 );
 // Used when checking if module implements a help page.
 $help_arg = module_exists ('help') ? drupal_help_arg () : FALSE;
 // Used when displaying modules that are required by the installation profile.
 require_once DRUPAL_ROOT  . '/includes/install.inc';
 $distribution_name = check_plain (drupal_install_profile_distribution_name ());
 // Iterate through each of the modules.
 foreach ($visible_files as $filename => $module) {
 $extra = array();
 $extra['enabled'] = (bool) $module->status;
 if (!empty($module->info['required'])) {
 $extra['disabled'] = TRUE;
 $extra['required_by'][] = $distribution_name . (!empty($module->info['explanation']) ? ' (' . $module->info['explanation'] . ')' : '');
 }
 // If this module requires other modules, add them to the array.
 foreach ($module->requires as $requires => $v) {
 if (!isset($files[$requires])) {
 $extra['requires'][$requires] = t ('@module (<span class="admin-missing">missing</span>)', array(
 '@module' => drupal_ucfirst ($requires),
 ));
 $extra['disabled'] = TRUE;
 }
 elseif (isset($visible_files[$requires])) {
 $requires_name = $files[$requires]->info['name'];
 // Disable this module if it is incompatible with the dependency's version.
 if ($incompatible_version = drupal_check_incompatibility ($v, str_replace (DRUPAL_CORE_COMPATIBILITY  . '-', '', (string) $files[$requires]->info['version']))) {
 $extra['requires'][$requires] = t ('@module (<span class="admin-missing">incompatible with</span> version @version)', array(
 '@module' => $requires_name . $incompatible_version,
 '@version' => $files[$requires]->info['version'],
 ));
 $extra['disabled'] = TRUE;
 }
 elseif ($files[$requires]->info['core'] != DRUPAL_CORE_COMPATIBILITY ) {
 $extra['requires'][$requires] = t ('@module (<span class="admin-missing">incompatible with</span> this version of Drupal core)', array(
 '@module' => $requires_name,
 ));
 $extra['disabled'] = TRUE;
 }
 elseif ($files[$requires]->status) {
 $extra['requires'][$requires] = t ('@module (<span class="admin-enabled">enabled</span>)', array(
 '@module' => $requires_name,
 ));
 }
 else {
 $extra['requires'][$requires] = t ('@module (<span class="admin-disabled">disabled</span>)', array(
 '@module' => $requires_name,
 ));
 }
 }
 }
 // Generate link for module's help page, if there is one.
 if ($help_arg && $module->status && in_array ($filename, module_implements ('help'))) {
 if (module_invoke ($filename, 'help', "admin/help#{$filename}", $help_arg)) {
 $extra['links']['help'] = array(
 '#type' => 'link',
 '#title' => t ('Help'),
 '#href' => "admin/help/{$filename}",
 '#options' => array(
 'attributes' => array(
 'class' => array(
 'module-link',
 'module-link-help',
 ),
 'title' => t ('Help'),
 ),
 ),
 );
 }
 }
 // Generate link for module's permission, if the user has access to it.
 if ($module->status && user_access ('administer permissions') && in_array ($filename, module_implements ('permission'))) {
 $extra['links']['permissions'] = array(
 '#type' => 'link',
 '#title' => t ('Permissions'),
 '#href' => 'admin/people/permissions',
 '#options' => array(
 'fragment' => 'module-' . $filename,
 'attributes' => array(
 'class' => array(
 'module-link',
 'module-link-permissions',
 ),
 'title' => t ('Configure permissions'),
 ),
 ),
 );
 }
 // Generate link for module's configuration page, if the module provides
 // one.
 if ($module->status && isset($module->info['configure'])) {
 $configure_link = menu_get_item ($module->info['configure']);
 if ($configure_link === FALSE) {
 watchdog ('system', 'Module %module specifies an invalid path for configuration: %configure', array(
 '%module' => $module->info['name'],
 '%configure' => $module->info['configure'],
 ));
 }
 else {
 if ($configure_link['access']) {
 $extra['links']['configure'] = array(
 '#type' => 'link',
 '#title' => t ('Configure'),
 '#href' => $configure_link['href'],
 '#options' => array(
 'attributes' => array(
 'class' => array(
 'module-link',
 'module-link-configure',
 ),
 'title' => $configure_link['description'],
 ),
 ),
 );
 }
 }
 }
 // If this module is required by other modules, list those, and then make it
 // impossible to disable this one.
 foreach ($module->required_by as $required_by => $v) {
 // Hidden modules are unset already.
 if (isset($visible_files[$required_by])) {
 if ($files[$required_by]->status == 1 && $module->status == 1) {
 $extra['required_by'][] = t ('@module (<span class="admin-enabled">enabled</span>)', array(
 '@module' => $files[$required_by]->info['name'],
 ));
 $extra['disabled'] = TRUE;
 }
 else {
 $extra['required_by'][] = t ('@module (<span class="admin-disabled">disabled</span>)', array(
 '@module' => $files[$required_by]->info['name'],
 ));
 }
 }
 }
 $form['modules'][$module->info['package']][$filename] = _system_modules_build_row ($module->info, $extra);
 }
 // Add basic information to the fieldsets.
 foreach (element_children ($form['modules']) as $package) {
 $form['modules'][$package] += array(
 '#type' => 'fieldset',
 '#title' => t ($package),
 '#collapsible' => TRUE,
 '#theme' => 'system_modules_fieldset',
 '#header' => array(
 array(
 'data' => t ('Enabled'),
 'class' => array(
 'checkbox',
 ),
 ),
 t ('Name'),
 t ('Version'),
 t ('Description'),
 array(
 'data' => t ('Operations'),
 'colspan' => 3,
 ),
 ),
 // Ensure that the "Core" package fieldset comes first.
'#weight' => $package == 'Core' ? -10 : NULL,
 // Hide this package unless we're running a test.
'#access' => !($package == 'Only For Testing' && !drupal_valid_test_ua ()),
 );
 }
 // Lastly, sort all fieldsets by title.
 uasort ($form['modules'], 'element_sort_by_title');
 $form['actions'] = array(
 '#type' => 'actions',
 );
 $form['actions']['submit'] = array(
 '#type' => 'submit',
 '#value' => t ('Save configuration'),
 );
 $form['#action'] = url ('admin/modules/list/confirm');
 return $form;
}

---