' . t('Module overviews are provided by modules. Overviews available for your installed modules:'), '
'); // Verify that an empty section is handled correctly. $this->assertRaw('' . t('This description should appear.'), '
'); $this->assertText(t('There is currently nothing in this section.')); // Make sure links are properly added for modules implementing hook_help(). foreach ($this->getModuleList() as $module => $name) { $this->assertLink($name, 0, format_string('Link properly added to @name (admin/help/@module)', ['@module' => $module, '@name' => $name])); } // Ensure that module which does not provide an module overview page is // handled correctly. $this->clickLink(\Drupal::moduleHandler()->getName('help_test')); $this->assertRaw(t('No help is available for module %module.', ['%module' => \Drupal::moduleHandler()->getName('help_test')])); // Verify that the order of topics is alphabetical by displayed module // name, by checking the order of some modules, including some that would // have a different order if it was done by machine name instead. $this->drupalGet('admin/help'); $page_text = $this->getTextContent(); $start = strpos($page_text, 'Module overviews'); $pos = $start; $list = ['Block', 'Color', 'Custom Block', 'History', 'Text Editor']; foreach ($list as $name) { $this->assertLink($name); $new_pos = strpos($page_text, $name, $start); $this->assertTrue($new_pos > $pos, 'Order of ' . $name . ' is correct on page'); $pos = $new_pos; } } /** * Verifies the logged in user has access to the various help pages. * * @param int $response * (optional) An HTTP response code. Defaults to 200. */ protected function verifyHelp($response = 200) { $this->drupalGet('admin/index'); $this->assertResponse($response); if ($response == 200) { $this->assertText('This page shows you all available administration tasks for each module.'); } else { $this->assertNoText('This page shows you all available administration tasks for each module.'); } foreach ($this->getModuleList() as $module => $name) { // View module help page. $this->drupalGet('admin/help/' . $module); $this->assertResponse($response); if ($response == 200) { $this->assertTitle($name . ' | Drupal', format_string('%module title was displayed', ['%module' => $module])); $this->assertEquals($name, $this->cssSelect('h1.page-title')[0]->getText(), "$module heading was displayed"); $admin_tasks = system_get_module_admin_tasks($module, system_get_info('module', $module)); if (!empty($admin_tasks)) { $this->assertText(t('@module administration pages', ['@module' => $name])); } foreach ($admin_tasks as $task) { $this->assertLink($task['title']); // Ensure there are no double escaped '&' or '<' characters. $this->assertNoEscaped('&', 'The help text does not have double escaped &.'); $this->assertNoEscaped('<', 'The help text does not have double escaped <.'); // Ensure there are no escaped '<' characters. $this->assertNoEscaped('<', 'The help text does not have single escaped <.'); } // Ensure there are no double escaped '&' or '<' characters. $this->assertNoEscaped('&'); $this->assertNoEscaped('<'); // Ensure there are no escaped '<' characters. $this->assertNoEscaped('<'); } } } /** * Gets the list of enabled modules that implement hook_help(). * * @return array * A list of enabled modules. */ protected function getModuleList() { $modules = []; $module_data = system_rebuild_module_data(); foreach (\Drupal::moduleHandler()->getImplementations('help') as $module) { $modules[$module] = $module_data[$module]->info['name']; } return $modules; } }