summaryrefslogtreecommitdiff
path: root/kolab.org/www/drupal-7.26/modules/help/help.test
diff options
context:
space:
mode:
Diffstat (limited to 'kolab.org/www/drupal-7.26/modules/help/help.test')
-rw-r--r--kolab.org/www/drupal-7.26/modules/help/help.test137
1 files changed, 137 insertions, 0 deletions
diff --git a/kolab.org/www/drupal-7.26/modules/help/help.test b/kolab.org/www/drupal-7.26/modules/help/help.test
new file mode 100644
index 0000000..da12ccc
--- /dev/null
+++ b/kolab.org/www/drupal-7.26/modules/help/help.test
@@ -0,0 +1,137 @@
+<?php
+
+/**
+ * @file
+ * Tests for help.module.
+ */
+
+/**
+ * Tests help display and user access for all modules implementing help.
+ */
+class HelpTestCase extends DrupalWebTestCase {
+ /**
+ * The admin user that will be created.
+ */
+ protected $big_user;
+
+ /**
+ * The anonymous user that will be created.
+ */
+ protected $any_user;
+
+ public static function getInfo() {
+ return array(
+ 'name' => 'Help functionality',
+ 'description' => 'Verify help display and user access to help based on permissions.',
+ 'group' => 'Help',
+ );
+ }
+
+ function setUp() {
+ parent::setUp('blog', 'poll');
+
+ $this->getModuleList();
+
+ // Create users.
+ $this->big_user = $this->drupalCreateUser(array('access administration pages', 'view the administration theme', 'administer permissions'));
+ $this->any_user = $this->drupalCreateUser(array());
+ }
+
+ /**
+ * Logs in users, creates dblog events, and tests dblog functionality.
+ */
+ function testHelp() {
+ // Login the admin user.
+ $this->drupalLogin($this->big_user);
+ $this->verifyHelp();
+
+ // Login the regular user.
+ $this->drupalLogin($this->any_user);
+ $this->verifyHelp(403);
+
+ // Check for css on admin/help.
+ $this->drupalLogin($this->big_user);
+ $this->drupalGet('admin/help');
+ $this->assertRaw(drupal_get_path('module', 'help') . '/help.css', 'The help.css file is present in the HTML.');
+
+ // Verify that introductory help text exists, goes for 100% module coverage.
+ $this->assertRaw(t('For more information, refer to the specific topics listed in the next section or to the <a href="@drupal">online Drupal handbooks</a>.', array('@drupal' => 'http://drupal.org/documentation')), 'Help intro text correctly appears.');
+
+ // Verify that help topics text appears.
+ $this->assertRaw('<h2>' . t('Help topics') . '</h2><p>' . t('Help is available on the following items:') . '</p>', 'Help topics text correctly appears.');
+
+ // Make sure links are properly added for modules implementing hook_help().
+ foreach ($this->modules as $module => $name) {
+ $this->assertLink($name, 0, format_string('Link properly added to @name (admin/help/@module)', array('@module' => $module, '@name' => $name)));
+ }
+ }
+
+ /**
+ * Verifies the logged in user has access to the various help nodes.
+ *
+ * @param integer $response
+ * An HTTP response code.
+ */
+ protected function verifyHelp($response = 200) {
+ foreach ($this->modules as $module => $name) {
+ // View module help node.
+ $this->drupalGet('admin/help/' . $module);
+ $this->assertResponse($response);
+ if ($response == 200) {
+ $this->assertTitle($name . ' | Drupal', format_string('%module title was displayed', array('%module' => $module)));
+ $this->assertRaw('<h1 class="page-title">' . t($name) . '</h1>', format_string('%module heading was displayed', array('%module' => $module)));
+ }
+ }
+ }
+
+ /**
+ * Gets the list of enabled modules that implement hook_help().
+ *
+ * @return array
+ * A list of enabled modules.
+ */
+ protected function getModuleList() {
+ $this->modules = array();
+ $result = db_query("SELECT name, filename, info FROM {system} WHERE type = 'module' AND status = 1 ORDER BY weight ASC, filename ASC");
+ foreach ($result as $module) {
+ if (file_exists($module->filename) && function_exists($module->name . '_help')) {
+ $fullname = unserialize($module->info);
+ $this->modules[$module->name] = $fullname['name'];
+ }
+ }
+ }
+}
+
+/**
+ * Tests a module without help to verify it is not listed in the help page.
+ */
+class NoHelpTestCase extends DrupalWebTestCase {
+ /**
+ * The user who will be created.
+ */
+ protected $big_user;
+
+ public static function getInfo() {
+ return array(
+ 'name' => 'No help',
+ 'description' => 'Verify no help is displayed for modules not providing any help.',
+ 'group' => 'Help',
+ );
+ }
+
+ function setUp() {
+ // Use one of the test modules that do not implement hook_help().
+ parent::setUp('menu_test');
+ $this->big_user = $this->drupalCreateUser(array('access administration pages'));
+ }
+
+ /**
+ * Ensures modules not implementing help do not appear on admin/help.
+ */
+ function testMainPageNoHelp() {
+ $this->drupalLogin($this->big_user);
+
+ $this->drupalGet('admin/help');
+ $this->assertNoText('Hook menu tests', 'Making sure the test module menu_test does not display a help link in admin/help');
+ }
+}