dashboard.test

<?php


/**
 * @file
 * Tests for dashboard.module.
 */

/**
 * Tests the Dashboard module blocks.
 */
class DashboardBlocksTestCase extends DrupalWebTestCase {
    public static function getInfo() {
        return array(
            'name' => 'Dashboard blocks',
            'description' => 'Test blocks as used by the dashboard.',
            'group' => 'Dashboard',
        );
    }
    function setUp() {
        parent::setUp();
        // Create and log in an administrative user having access to the dashboard.
        $admin_user = $this->drupalCreateUser(array(
            'access dashboard',
            'administer blocks',
            'access administration pages',
            'administer modules',
        ));
        $this->drupalLogin($admin_user);
        // Make sure that the dashboard is using the same theme as the rest of the
        // site (and in particular, the same theme used on 403 pages). This forces
        // the dashboard blocks to be the same for an administrator as for a
        // regular user, and therefore lets us test that the dashboard blocks
        // themselves are specifically removed for a user who does not have access
        // to the dashboard page.
        theme_enable(array(
            'stark',
        ));
        variable_set('theme_default', 'stark');
        variable_set('admin_theme', 'stark');
    }
    
    /**
     * Tests adding a block to the dashboard and checking access to it.
     */
    function testDashboardAccess() {
        // Add a new custom block to a dashboard region.
        $custom_block = array();
        $custom_block['info'] = $this->randomName(8);
        $custom_block['title'] = $this->randomName(8);
        $custom_block['body[value]'] = $this->randomName(32);
        $custom_block['regions[stark]'] = 'dashboard_main';
        $this->drupalPost('admin/structure/block/add', $custom_block, t('Save block'));
        // Ensure admin access.
        $this->drupalGet('admin/dashboard');
        $this->assertResponse(200, 'Admin has access to the dashboard.');
        $this->assertRaw($custom_block['title'], 'Admin has access to a dashboard block.');
        // Ensure non-admin access is denied.
        $normal_user = $this->drupalCreateUser();
        $this->drupalLogin($normal_user);
        $this->drupalGet('admin/dashboard');
        $this->assertResponse(403, 'Non-admin has no access to the dashboard.');
        $this->assertNoText($custom_block['title'], 'Non-admin has no access to a dashboard block.');
    }
    
    /**
     * Tests that dashboard regions are displayed or hidden properly.
     */
    function testDashboardRegions() {
        $dashboard_regions = dashboard_region_descriptions();
        // Ensure blocks can be placed in dashboard regions.
        $this->drupalGet('admin/dashboard/configure');
        foreach ($dashboard_regions as $region => $description) {
            $elements = $this->xpath('//option[@value=:region]', array(
                ':region' => $region,
            ));
            $this->assertTrue(!empty($elements), format_string('%region is an available choice on the dashboard block configuration page.', array(
                '%region' => $region,
            )));
        }
        // Ensure blocks cannot be placed in dashboard regions on the standard
        // blocks configuration page.
        $this->drupalGet('admin/structure/block');
        foreach ($dashboard_regions as $region => $description) {
            $elements = $this->xpath('//option[@value=:region]', array(
                ':region' => $region,
            ));
            $this->assertTrue(empty($elements), format_string('%region is not an available choice on the block configuration page.', array(
                '%region' => $region,
            )));
        }
    }
    
    /**
     * Tests that the dashboard module can be re-enabled, retaining its blocks.
     */
    function testDisableEnable() {
        // Add a new custom block to a dashboard region.
        $custom_block = array();
        $custom_block['info'] = $this->randomName(8);
        $custom_block['title'] = $this->randomName(8);
        $custom_block['body[value]'] = $this->randomName(32);
        $custom_block['regions[stark]'] = 'dashboard_main';
        $this->drupalPost('admin/structure/block/add', $custom_block, t('Save block'));
        $this->drupalGet('admin/dashboard');
        $this->assertRaw($custom_block['title'], 'Block appears on the dashboard.');
        $edit = array();
        $edit['modules[Core][dashboard][enable]'] = FALSE;
        $this->drupalPost('admin/modules', $edit, t('Save configuration'));
        $this->assertText(t('The configuration options have been saved.'), 'Modules status has been updated.');
        $this->assertNoRaw('assigned to the invalid region', 'Dashboard blocks gracefully disabled.');
        module_list(TRUE);
        $this->assertFalse(module_exists('dashboard'), 'Dashboard disabled.');
        $edit['modules[Core][dashboard][enable]'] = 'dashboard';
        $this->drupalPost('admin/modules', $edit, t('Save configuration'));
        $this->assertText(t('The configuration options have been saved.'), 'Modules status has been updated.');
        module_list(TRUE);
        $this->assertTrue(module_exists('dashboard'), 'Dashboard enabled.');
        $this->drupalGet('admin/dashboard');
        $this->assertRaw($custom_block['title'], 'Block still appears on the dashboard.');
    }
    
    /**
     * Tests that administrative blocks are available for the dashboard.
     */
    function testBlockAvailability() {
        // Test "Recent comments", which should be available (defined as
        // "administrative") but not enabled.
        $this->drupalGet('admin/dashboard');
        $this->assertNoText(t('Recent comments'), '"Recent comments" not on dashboard.');
        $this->drupalGet('admin/dashboard/drawer');
        $this->assertText(t('Recent comments'), 'Drawer of disabled blocks includes a block defined as "administrative".');
        $this->assertNoText(t('Syndicate'), 'Drawer of disabled blocks excludes a block not defined as "administrative".');
        $this->drupalGet('admin/dashboard/configure');
        $elements = $this->xpath('//select[@id=:id]//option[@selected="selected"]', array(
            ':id' => 'edit-blocks-comment-recent-region',
        ));
        $this->assertTrue($elements[0]['value'] == 'dashboard_inactive', 'A block defined as "administrative" defaults to dashboard_inactive.');
        // Now enable the block on the dashboard.
        $values = array();
        $values['blocks[comment_recent][region]'] = 'dashboard_main';
        $this->drupalPost('admin/dashboard/configure', $values, t('Save blocks'));
        $this->drupalGet('admin/dashboard');
        $this->assertText(t('Recent comments'), '"Recent comments" was placed on dashboard.');
        $this->drupalGet('admin/dashboard/drawer');
        $this->assertNoText(t('Recent comments'), 'Drawer of disabled blocks excludes enabled blocks.');
    }

}