Newer
Older
<?php
Dries Buytaert
committed
/**
* @file
* Definition of Drupal\book\Tests\BookTest.
Dries Buytaert
committed
*/
namespace Drupal\book\Tests;
use Drupal\Core\Language\Language;
Angie Byron
committed
use Drupal\Core\Entity\EntityInterface;
catch
committed
use Drupal\simpletest\WebTestBase;
Jennifer Hodgdon
committed
/**
* Tests the functionality of the Book module.
*/
class BookTest extends WebTestBase {
/**
* Modules to enable.
*
* @var array
*/
public static $modules = array('book', 'block', 'node_access_test');
Jennifer Hodgdon
committed
/**
* A book node.
*
* @var object
*/
protected $book;
Jennifer Hodgdon
committed
/**
* A user with permission to create and edit books.
*
* @var object
*/
Angie Byron
committed
protected $book_author;
Jennifer Hodgdon
committed
/**
* A user with permission to view a book and access printer-friendly version.
*
* @var object
*/
Angie Byron
committed
protected $web_user;
Jennifer Hodgdon
committed
/**
* A user with permission to create and edit books and to administer blocks.
*
* @var object
*/
Angie Byron
committed
protected $admin_user;
Angie Byron
committed
public static function getInfo() {
return array(
'name' => 'Book functionality',
'description' => 'Create a book, add pages, and test book interface.',
'group' => 'Book',
);
}
function setUp() {
parent::setUp();
// node_access_test requires a node_access_rebuild().
node_access_rebuild();
Angie Byron
committed
Angie Byron
committed
// Create users.
$this->book_author = $this->drupalCreateUser(array('create new books', 'create book content', 'edit own book content', 'add content to books'));
$this->web_user = $this->drupalCreateUser(array('access printer-friendly version', 'node test view'));
Angie Byron
committed
$this->admin_user = $this->drupalCreateUser(array('create new books', 'create book content', 'edit own book content', 'add content to books', 'administer blocks', 'administer permissions', 'administer book outlines', 'node test view', 'administer content types', 'administer site configuration'));
}
Angie Byron
committed
/**
Jennifer Hodgdon
committed
* Creates a new book with a page hierarchy.
*/
Angie Byron
committed
function createBook() {
// Create new book.
Angie Byron
committed
$this->drupalLogin($this->book_author);
$this->book = $this->createBookNode('new');
$book = $this->book;
/*
* Add page hierarchy to book.
* Book
* |- Node 0
* |- Node 1
* |- Node 2
* |- Node 3
* |- Node 4
*/
$nodes = array();
$nodes[] = $this->createBookNode($book->nid); // Node 0.
$nodes[] = $this->createBookNode($book->nid, $nodes[0]->book['mlid']); // Node 1.
$nodes[] = $this->createBookNode($book->nid, $nodes[0]->book['mlid']); // Node 2.
$nodes[] = $this->createBookNode($book->nid); // Node 3.
$nodes[] = $this->createBookNode($book->nid); // Node 4.
$this->drupalLogout();
Angie Byron
committed
Angie Byron
committed
return $nodes;
}
/**
Jennifer Hodgdon
committed
* Tests book functionality through node interfaces.
Angie Byron
committed
*/
function testBook() {
// Create new book.
$nodes = $this->createBook();
$book = $this->book;
Angie Byron
committed
Angie Byron
committed
$this->drupalLogin($this->web_user);
// Check that book pages display along with the correct outlines and
// previous/next links.
$this->checkBookNode($book, array($nodes[0], $nodes[3], $nodes[4]), FALSE, FALSE, $nodes[0], array());
$this->checkBookNode($nodes[0], array($nodes[1], $nodes[2]), $book, $book, $nodes[1], array($book));
$this->checkBookNode($nodes[1], NULL, $nodes[0], $nodes[0], $nodes[2], array($book, $nodes[0]));
$this->checkBookNode($nodes[2], NULL, $nodes[1], $nodes[0], $nodes[3], array($book, $nodes[0]));
$this->checkBookNode($nodes[3], NULL, $nodes[2], $book, $nodes[4], array($book));
$this->checkBookNode($nodes[4], NULL, $nodes[3], $book, FALSE, array($book));
Dries Buytaert
committed
$this->drupalLogout();
// Create a second book, and move an existing book page into it.
Angie Byron
committed
$this->drupalLogin($this->book_author);
Dries Buytaert
committed
$other_book = $this->createBookNode('new');
$node = $this->createBookNode($book->nid);
$edit = array('book[bid]' => $other_book->nid);
$this->drupalPost('node/' . $node->nid . '/edit', $edit, t('Save'));
$this->drupalLogout();
Angie Byron
committed
$this->drupalLogin($this->web_user);
Dries Buytaert
committed
// Check that the nodes in the second book are displayed correctly.
// First we must set $this->book to the second book, so that the
// correct regex will be generated for testing the outline.
$this->book = $other_book;
$this->checkBookNode($other_book, array($node), FALSE, FALSE, $node, array());
$this->checkBookNode($node, NULL, $other_book, $other_book, FALSE, array($other_book));
}
/**
Jennifer Hodgdon
committed
* Checks the outline of sub-pages; previous, up, and next.
*
* Also checks the printer friendly version of the outline.
*
Angie Byron
committed
* @param \Drupal\Core\Entity\EntityInterface $node
* Node to check.
* @param $nodes
* Nodes that should be in outline.
* @param $previous
Jennifer Hodgdon
committed
* (optional) Previous link node. Defaults to FALSE.
* @param $up
Jennifer Hodgdon
committed
* (optional) Up link node. Defaults to FALSE.
* @param $next
Jennifer Hodgdon
committed
* (optional) Next link node. Defaults to FALSE.
* @param array $breadcrumb
* The nodes that should be displayed in the breadcrumb.
*/
Angie Byron
committed
function checkBookNode(EntityInterface $node, $nodes, $previous = FALSE, $up = FALSE, $next = FALSE, array $breadcrumb) {
// $number does not use drupal_static as it should not be reset
// since it uniquely identifies each call to checkBookNode().
static $number = 0;
$this->drupalGet('node/' . $node->nid);
// Check outline structure.
if ($nodes !== NULL) {
Angie Byron
committed
$this->assertPattern($this->generateOutlinePattern($nodes), format_string('Node @number outline confirmed.', array('@number' => $number)));
}
else {
Jennifer Hodgdon
committed
$this->pass(format_string('Node %number does not have outline.', array('%number' => $number)));
}
// Check previous, up, and next links.
if ($previous) {
Angie Byron
committed
$this->assertRaw(l('<b>‹</b> ' . $previous->label(), 'node/' . $previous->nid, array('html' => TRUE, 'attributes' => array('rel' => array('prev'), 'title' => t('Go to previous page')))), 'Previous page link found.');
}
if ($up) {
Dries Buytaert
committed
$this->assertRaw(l('Up', 'node/' . $up->nid, array('html'=> TRUE, 'attributes' => array('title' => t('Go to parent page')))), 'Up page link found.');
}
if ($next) {
Angie Byron
committed
$this->assertRaw(l($next->label() . ' <b>›</b>', 'node/' . $next->nid, array('html'=> TRUE, 'attributes' => array('rel' => array('next'), 'title' => t('Go to next page')))), 'Next page link found.');
}
// Compute the expected breadcrumb.
$expected_breadcrumb = array();
$expected_breadcrumb[] = url('');
foreach ($breadcrumb as $a_node) {
$expected_breadcrumb[] = url('node/' . $a_node->nid);
}
// Fetch links in the current breadcrumb.
$links = $this->xpath('//nav[@class="breadcrumb"]/ol/li/a');
$got_breadcrumb = array();
foreach ($links as $link) {
$got_breadcrumb[] = (string) $link['href'];
}
// Compare expected and got breadcrumbs.
Angie Byron
committed
$this->assertIdentical($expected_breadcrumb, $got_breadcrumb, 'The breadcrumb is correctly displayed on the page.');
// Check printer friendly version.
$this->drupalGet('book/export/html/' . $node->nid);
Angie Byron
committed
$this->assertText($node->label(), 'Printer friendly title found.');
$this->assertRaw(check_markup($node->body[Language::LANGCODE_NOT_SPECIFIED][0]['value'], $node->body[Language::LANGCODE_NOT_SPECIFIED][0]['format']), 'Printer friendly body found.');
$number++;
}
/**
Jennifer Hodgdon
committed
* Creates a regular expression to check for the sub-nodes in the outline.
*
* @param array $nodes
* An array of nodes to check in outline.
*
Jennifer Hodgdon
committed
* @return string
* A regular expression that locates sub-nodes of the outline.
*/
function generateOutlinePattern($nodes) {
$outline = '';
foreach ($nodes as $node) {
Angie Byron
committed
$outline .= '(node\/' . $node->nid . ')(.*?)(' . $node->label() . ')(.*?)';
}
return '/<nav id="book-navigation-' . $this->book->nid . '"(.*?)<ul(.*?)' . $outline . '<\/ul>/s';
}
/**
Jennifer Hodgdon
committed
* Creates a book node.
*
Jennifer Hodgdon
committed
* @param int|string $book_nid
* A book node ID or set to 'new' to create a new book.
* @param int|null $parent
* (optional) Parent book reference ID. Defaults to NULL.
*/
function createBookNode($book_nid, $parent = NULL) {
// $number does not use drupal_static as it should not be reset
// since it uniquely identifies each call to createBookNode().
static $number = 0; // Used to ensure that when sorted nodes stay in same order.
$edit = array();
$langcode = Language::LANGCODE_NOT_SPECIFIED;
$edit["title"] = $number . ' - SimpleTest test node ' . $this->randomName(10);
Angie Byron
committed
$edit["body[$langcode][0][value]"] = 'SimpleTest test body ' . $this->randomName(32) . ' ' . $this->randomName(32);
$edit['book[bid]'] = $book_nid;
if ($parent !== NULL) {
$this->drupalPost('node/add/book', $edit, t('Change book (update list of parents)'));
$edit['book[plid]'] = $parent;
$this->drupalPost(NULL, $edit, t('Save'));
}
else {
$this->drupalPost('node/add/book', $edit, t('Save'));
}
// Check to make sure the book node was created.
$node = $this->drupalGetNodeByTitle($edit['title']);
Angie Byron
committed
$this->assertNotNull(($node === FALSE ? NULL : $node), 'Book node found in database.');
$number++;
return $node;
}
Angie Byron
committed
Angie Byron
committed
/**
* Tests book export ("printer-friendly version") functionality.
*/
function testBookExport() {
// Create a book.
$nodes = $this->createBook();
Angie Byron
committed
Angie Byron
committed
// Login as web user and view printer-friendly version.
$this->drupalLogin($this->web_user);
$this->drupalGet('node/' . $this->book->nid);
$this->clickLink(t('Printer-friendly version'));
Angie Byron
committed
Angie Byron
committed
// Make sure each part of the book is there.
foreach ($nodes as $node) {
Angie Byron
committed
$this->assertText($node->label(), 'Node title found in printer friendly version.');
$this->assertRaw(check_markup($node->body[Language::LANGCODE_NOT_SPECIFIED][0]['value'], $node->body[Language::LANGCODE_NOT_SPECIFIED][0]['format']), 'Node body found in printer friendly version.');
Angie Byron
committed
}
Angie Byron
committed
Angie Byron
committed
// Make sure we can't export an unsupported format.
$this->drupalGet('book/export/foobar/' . $this->book->nid);
Angie Byron
committed
$this->assertResponse('404', 'Unsupported export format returned "not found".');
Angie Byron
committed
// Make sure we get a 404 on a not existing book node.
$this->drupalGet('book/export/html/123');
Angie Byron
committed
$this->assertResponse('404', 'Not existing book node returned "not found".');
Angie Byron
committed
// Make sure an anonymous user cannot view printer-friendly version.
$this->drupalLogout();
Angie Byron
committed
Angie Byron
committed
// Load the book and verify there is no printer-friendly version link.
$this->drupalGet('node/' . $this->book->nid);
Angie Byron
committed
$this->assertNoLink(t('Printer-friendly version'), 'Anonymous user is not shown link to printer-friendly version.');
Angie Byron
committed
Angie Byron
committed
// Try getting the URL directly, and verify it fails.
$this->drupalGet('book/export/html/' . $this->book->nid);
Angie Byron
committed
$this->assertResponse('403', 'Anonymous user properly forbidden.');
// Now grant anonymous users permission to view the printer-friendly
// version and verify that node access restrictions still prevent them from
// seeing it.
user_role_grant_permissions(DRUPAL_ANONYMOUS_RID, array('access printer-friendly version'));
$this->drupalGet('book/export/html/' . $this->book->nid);
$this->assertResponse('403', 'Anonymous user properly forbidden from seeing the printer-friendly version when denied by node access.');
Angie Byron
committed
}
Dries Buytaert
committed
Angie Byron
committed
/**
* Tests the functionality of the book navigation block.
*/
Dries Buytaert
committed
function testBookNavigationBlock() {
Angie Byron
committed
$this->drupalLogin($this->admin_user);
Dries Buytaert
committed
// Enable the block.
Angie Byron
committed
$block = $this->drupalPlaceBlock('book_navigation');
Dries Buytaert
committed
Dries Buytaert
committed
// Give anonymous users the permission 'node test view'.
Dries Buytaert
committed
$edit = array();
Dries Buytaert
committed
$edit[DRUPAL_ANONYMOUS_RID . '[node test view]'] = TRUE;
$this->drupalPost('admin/people/permissions/' . DRUPAL_ANONYMOUS_RID, $edit, t('Save permissions'));
$this->assertText(t('The changes have been saved.'), "Permission 'node test view' successfully assigned to anonymous users.");
Angie Byron
committed
// Test correct display of the block.
$nodes = $this->createBook();
$this->drupalGet('<front>');
Angie Byron
committed
$this->assertText($block->label(), 'Book navigation block is displayed.');
Angie Byron
committed
$this->assertText($this->book->label(), format_string('Link to book root (@title) is displayed.', array('@title' => $nodes[0]->label())));
$this->assertNoText($nodes[0]->label(), 'No links to individual book pages are displayed.');
Dries Buytaert
committed
}
/**
Jennifer Hodgdon
committed
* Tests the book navigation block when an access module is enabled.
*/
Dries Buytaert
committed
function testNavigationBlockOnAccessModuleEnabled() {
$this->drupalLogin($this->admin_user);
$block = $this->drupalPlaceBlock('book_navigation', array('block_mode' => 'book pages'));
Dries Buytaert
committed
// Give anonymous users the permission 'node test view'.
$edit = array();
$edit[DRUPAL_ANONYMOUS_RID . '[node test view]'] = TRUE;
$this->drupalPost('admin/people/permissions/' . DRUPAL_ANONYMOUS_RID, $edit, t('Save permissions'));
$this->assertText(t('The changes have been saved.'), "Permission 'node test view' successfully assigned to anonymous users.");
// Create a book.
$this->createBook();
// Test correct display of the block to registered users.
$this->drupalLogin($this->web_user);
$this->drupalGet('node/' . $this->book->nid);
Angie Byron
committed
$this->assertText($block->label(), 'Book navigation block is displayed to registered users.');
Dries Buytaert
committed
$this->drupalLogout();
// Test correct display of the block to anonymous users.
$this->drupalGet('node/' . $this->book->nid);
Angie Byron
committed
$this->assertText($block->label(), 'Book navigation block is displayed to anonymous users.');
// Test the 'book pages' block_mode setting.
$this->drupalGet('<front>');
$this->assertNoText($block->label(), 'Book navigation block is not shown on non-book pages.');
Dries Buytaert
committed
}
/**
* Tests the access for deleting top-level book nodes.
*/
function testBookDelete() {
$nodes = $this->createBook();
$this->drupalLogin($this->admin_user);
$edit = array();
// Test access to delete top-level and child book nodes.
$this->drupalGet('node/' . $this->book->nid . '/outline/remove');
Jennifer Hodgdon
committed
$this->assertResponse('403', 'Deleting top-level book node properly forbidden.');
$this->drupalPost('node/' . $nodes[4]->nid . '/outline/remove', $edit, t('Remove'));
$node4 = node_load($nodes[4]->nid, TRUE);
Angie Byron
committed
$this->assertTrue(empty($node4->book), 'Deleting child book node properly allowed.');
// Delete all child book nodes and retest top-level node deletion.
foreach ($nodes as $node) {
$nids[] = $node->nid;
}
node_delete_multiple($nids);
$this->drupalPost('node/' . $this->book->nid . '/outline/remove', $edit, t('Remove'));
$node = node_load($this->book->nid, TRUE);
Angie Byron
committed
$this->assertTrue(empty($node->book), 'Deleting childless top-level book node properly allowed.');
}
/*
* Tests node type changing machine name when type is a book allowed type.
*/
function testBookNodeTypeChange() {
$this->drupalLogin($this->admin_user);
// Change the name, machine name and description.
$edit = array(
'name' => 'Bar',
'type' => 'bar',
);
$this->drupalPost('admin/structure/types/manage/book', $edit, t('Save content type'));
// Ensure that the config book.settings:allowed_types has been updated with
// the new machine and the old one has been removed.
$this->assertTrue(book_type_is_allowed('bar'), 'Config book.settings:allowed_types contains the updated node type machine name "bar".');
$this->assertFalse(book_type_is_allowed('book'), 'Config book.settings:allowed_types does not contain the old node type machine name "book".');
Angie Byron
committed
$edit = array(
'name' => 'Basic page',
'title_label' => 'Title for basic page',
'type' => 'page',
);
$this->drupalPost('admin/structure/types/add', $edit, t('Save content type'));
// Add page to the allowed node types.
$edit = array(
'book_allowed_types[page]' => 'page',
'book_allowed_types[bar]' => 'bar',
);
Alex Pott
committed
$this->drupalPost('admin/structure/book/settings', $edit, t('Save configuration'));
Angie Byron
committed
$this->assertTrue(book_type_is_allowed('bar'), 'Config book.settings:allowed_types contains the bar node type.');
$this->assertTrue(book_type_is_allowed('page'), 'Config book.settings:allowed_types contains the page node type.');
// Test the order of the book.settings::allowed_types configuration is as
// expected. The point of this test is to prove that after changing a node
Alex Pott
committed
// type going to admin/structure/book/settings and pressing save without
Angie Byron
committed
// changing anything should not alter the book.settings configuration. The
// order will be:
// @code
// array(
// 'bar',
// 'page',
// );
// @endcode
$current_config = config('book.settings')->init()->get();
Alex Pott
committed
$this->drupalPost('admin/structure/book/settings', array(), t('Save configuration'));
Angie Byron
committed
$this->assertIdentical($current_config, config('book.settings')->init()->get());
// Change the name, machine name and description.
$edit = array(
'name' => 'Zebra book',
'type' => 'zebra',
);
$this->drupalPost('admin/structure/types/manage/bar', $edit, t('Save content type'));
$this->assertTrue(book_type_is_allowed('zebra'), 'Config book.settings:allowed_types contains the zebra node type.');
$this->assertTrue(book_type_is_allowed('page'), 'Config book.settings:allowed_types contains the page node type.');
// Test the order of the book.settings::allowed_types configuration is as
// expected. The order should be:
// @code
// array(
// 'page',
// 'zebra',
// );
// @endcode
$current_config = config('book.settings')->init()->get();
Alex Pott
committed
$this->drupalPost('admin/structure/book/settings', array(), t('Save configuration'));
Angie Byron
committed
$this->assertIdentical($current_config, config('book.settings')->init()->get());
$edit = array(
'name' => 'Animal book',
'type' => 'zebra',
);
$this->drupalPost('admin/structure/types/manage/zebra', $edit, t('Save content type'));
// Test the order of the book.settings::allowed_types configuration is as
// expected. The order should be:
// @code
// array(
// 'page',
// 'zebra',
// );
// @endcode
$current_config = config('book.settings')->init()->get();
Alex Pott
committed
$this->drupalPost('admin/structure/book/settings', array(), t('Save configuration'));
Angie Byron
committed
$this->assertIdentical($current_config, config('book.settings')->init()->get());
// Ensure that after all the node type changes book.settings:child_type has
// the expected value.
$this->assertEqual(config('book.settings')->get('child_type'), 'zebra');
Angie Byron
committed
/**
* Tests re-ordering of books.
*/
public function testBookOrdering() {
// Create new book.
$nodes = $this->createBook();
$book = $this->book;
$this->drupalLogin($this->admin_user);
$node1 = $this->createBookNode($book->nid);
$node2 = $this->createBookNode($book->nid);
$plid = $node1->book['mlid'];
// Head to admin screen and attempt to re-order.
Alex Pott
committed
$this->drupalGet('admin/structure/book/' . $book->nid);
Angie Byron
committed
$edit = array(
"table[book-admin-{$node1->nid}][weight]" => 1,
"table[book-admin-{$node2->nid}][weight]" => 2,
// Put node 2 under node 1.
"table[book-admin-{$node2->nid}][plid]" => $plid,
);
$this->drupalPost(NULL, $edit, t('Save book pages'));
// Verify weight was updated.
$this->assertFieldByName("table[book-admin-{$node1->nid}][weight]", 1);
$this->assertFieldByName("table[book-admin-{$node2->nid}][weight]", 2);
$this->assertFieldByName("table[book-admin-{$node2->nid}][plid]", $plid);
}
}