BlockContentCreationTest.php

Same filename in other branches
  1. 9 core/modules/block_content/tests/src/Functional/BlockContentCreationTest.php
  2. 8.9.x core/modules/block_content/tests/src/Functional/BlockContentCreationTest.php
  3. 11.x core/modules/block_content/tests/src/Functional/BlockContentCreationTest.php

Namespace

Drupal\Tests\block_content\Functional

File

core/modules/block_content/tests/src/Functional/BlockContentCreationTest.php

View source
<?php

declare (strict_types=1);
namespace Drupal\Tests\block_content\Functional;

use Drupal\block_content\BlockContentInterface;
use Drupal\block_content\Entity\BlockContent;
use Drupal\Core\Database\Database;
// cspell:ignore testblock

/**
 * Create a block and test saving it.
 *
 * @group block_content
 */
class BlockContentCreationTest extends BlockContentTestBase {
    
    /**
     * Modules to install.
     *
     * Enable dummy module that implements hook_block_insert() for exceptions and
     * field_ui to edit display settings.
     *
     * @var array
     */
    protected static $modules = [
        'block_content_test',
        'dblog',
        'field_ui',
    ];
    
    /**
     * {@inheritdoc}
     */
    protected $defaultTheme = 'stark';
    
    /**
     * Permissions to grant admin user.
     *
     * @var array
     */
    protected $permissions = [
        'administer blocks',
        'administer block_content display',
        'access block library',
        'administer block content',
    ];
    
    /**
     * Sets the test up.
     */
    protected function setUp() : void {
        parent::setUp();
        $this->drupalLogin($this->adminUser);
    }
    
    /**
     * Creates a "Basic block" block and verifies its consistency in the database.
     */
    public function testBlockContentCreation() : void {
        $this->drupalLogin($this->adminUser);
        // Create a block.
        $edit = [];
        $edit['info[0][value]'] = 'Test Block';
        $edit['body[0][value]'] = $this->randomMachineName(16);
        $this->drupalGet('block/add/basic');
        $this->submitForm($edit, 'Save');
        // Check that the Basic block has been created.
        $this->assertSession()
            ->pageTextContains('basic ' . $edit['info[0][value]'] . ' has been created.');
        // Check that the view mode setting is hidden because only one exists.
        $this->assertSession()
            ->fieldNotExists('settings[view_mode]');
        // Check that the block exists in the database.
        $block = $this->getBlockByLabel($edit['info[0][value]']);
        $this->assertNotEmpty($block, 'Content Block found in database.');
    }
    
    /**
     * Creates a "Basic page" block with multiple view modes.
     */
    public function testBlockContentCreationMultipleViewModes() : void {
        // Add a new view mode and verify if it is selected as expected.
        $this->drupalLogin($this->drupalCreateUser([
            'administer display modes',
        ]));
        $this->drupalGet('admin/structure/display-modes/view/add/block_content');
        $edit = [
            'id' => 'test_view_mode',
            'label' => 'Test View Mode',
        ];
        $this->submitForm($edit, 'Save');
        $this->assertSession()
            ->pageTextContains('Saved the ' . $edit['label'] . ' view mode.');
        $this->drupalLogin($this->adminUser);
        // Create a block.
        $edit = [];
        $edit['info[0][value]'] = 'Test Block';
        $edit['body[0][value]'] = $this->randomMachineName(16);
        $this->drupalGet('block/add/basic');
        $this->submitForm($edit, 'Save and configure');
        // Save our block permanently
        $this->submitForm([
            'region' => 'content',
        ], 'Save block');
        // Set test_view_mode as a custom display to be available on the list.
        $this->drupalGet('admin/structure/block-content/manage/basic/display');
        $custom_view_mode = [
            'display_modes_custom[test_view_mode]' => 1,
        ];
        $this->submitForm($custom_view_mode, 'Save');
        // Go to the configure page and change the view mode.
        $this->drupalGet('admin/structure/block/manage/stark_testblock');
        // Test the available view mode options.
        // Verify that the default view mode is available.
        $this->assertSession()
            ->optionExists('edit-settings-view-mode', 'default');
        // Verify that the test view mode is available.
        $this->assertSession()
            ->optionExists('edit-settings-view-mode', 'test_view_mode');
        $view_mode['settings[view_mode]'] = 'test_view_mode';
        $this->submitForm($view_mode, 'Save block');
        // Check that the view mode setting is shown because more than one exists.
        $this->drupalGet('admin/structure/block/manage/stark_testblock');
        $this->assertSession()
            ->fieldExists('settings[view_mode]');
        // Change the view mode.
        $view_mode['region'] = 'content';
        $view_mode['settings[view_mode]'] = 'test_view_mode';
        $this->submitForm($view_mode, 'Save block');
        // Go to the configure page and verify the view mode has changed.
        $this->drupalGet('admin/structure/block/manage/stark_testblock');
        $this->assertSession()
            ->fieldValueEquals('settings[view_mode]', 'test_view_mode');
        // Check that the block exists in the database.
        $block = $this->getBlockByLabel($edit['info[0][value]']);
        $this->assertNotEmpty($block, 'Content Block found in database.');
    }
    
    /**
     * Tests the redirect workflow of creating a block_content and block.
     */
    public function testBlockContentFormSubmitHandlers() : void {
        $this->drupalLogin($this->adminUser);
        // Create a block and place in block layout.
        $this->drupalGet('/admin/content/block');
        $this->clickLink('Add content block');
        // Verify destination URL, when clicking "Save and configure" this
        // destination will be ignored.
        $base = base_path();
        $url = 'block/add?destination=' . $base . 'admin/content/block';
        $this->assertSession()
            ->addressEquals($url);
        $edit = [];
        $edit['info[0][value]'] = 'Test Block';
        $edit['body[0][value]'] = $this->randomMachineName(16);
        $this->submitForm($edit, 'Save and configure');
        $this->assertSession()
            ->pageTextContains('basic ' . $edit['info[0][value]'] . ' has been created.');
        $this->assertSession()
            ->pageTextContains('Configure block');
        // Verify when editing a block "Save and configure" does not appear.
        $this->drupalGet('/admin/content/block/1');
        $this->assertSession()
            ->buttonNotExists('Save and configure');
        // Create a block but go back to block library.
        $edit = [];
        $edit['info[0][value]'] = 'Test Block';
        $edit['body[0][value]'] = $this->randomMachineName(16);
        $this->drupalGet('block/add/basic');
        $this->submitForm($edit, 'Save');
        // Check that the Basic block has been created.
        $this->assertSession()
            ->pageTextContains('basic ' . $edit['info[0][value]'] . ' has been created.');
        $this->assertSession()
            ->addressEquals('/admin/content/block');
        // Check that the user is redirected to the block library on edit.
        $block = $this->getBlockByLabel($edit['info[0][value]']);
        $this->drupalGet($block->toUrl('edit-form'));
        $this->submitForm([
            'info[0][value]' => 'Test Block Updated',
        ], 'Save');
        $this->assertSession()
            ->addressEquals('admin/content/block');
        // Test with user who doesn't have permission to place a block.
        $this->drupalLogin($this->drupalCreateUser([
            'administer block content',
        ]));
        $this->drupalGet('block/add/basic');
        $this->assertSession()
            ->buttonNotExists('Save and configure');
    }
    
    /**
     * Create a default content block.
     *
     * Creates a content block from defaults and ensures that the 'basic block'
     * type is being used.
     */
    public function testDefaultBlockContentCreation() : void {
        $edit = [];
        $edit['info[0][value]'] = $this->randomMachineName(8);
        $edit['body[0][value]'] = $this->randomMachineName(16);
        // Don't pass the content block type in the URL so the default is forced.
        $this->drupalGet('block/add');
        $this->submitForm($edit, 'Save');
        // Check that the block has been created and that it is a basic block.
        $this->assertSession()
            ->pageTextContains('basic ' . $edit['info[0][value]'] . ' has been created.');
        // Check that the block exists in the database.
        $block = $this->getBlockByLabel($edit['info[0][value]']);
        $this->assertNotEmpty($block, 'Default Content Block found in database.');
    }
    
    /**
     * Verifies that a transaction rolls back the failed creation.
     */
    public function testFailedBlockCreation() : void {
        // Create a block.
        try {
            $this->createBlockContent('fail_creation');
            $this->fail('Expected exception has not been thrown.');
        } catch (\Exception $e) {
            // Expected exception; just continue testing.
        }
        $connection = Database::getConnection();
        // Check that the block does not exist in the database.
        $id = $connection->select('block_content_field_data', 'b')
            ->fields('b', [
            'id',
        ])
            ->condition('info', 'fail_creation')
            ->execute()
            ->fetchField();
        $this->assertFalse($id);
    }
    
    /**
     * Tests deleting a block.
     */
    public function testBlockDelete() : void {
        // Create a block.
        $edit = [];
        $edit['info[0][value]'] = $this->randomMachineName(8);
        $body = $this->randomMachineName(16);
        $edit['body[0][value]'] = $body;
        $this->drupalGet('block/add/basic');
        $this->submitForm($edit, 'Save');
        // Place the block.
        $instance = [
            'id' => mb_strtolower($edit['info[0][value]']),
            'settings[label]' => $edit['info[0][value]'],
            'region' => 'sidebar_first',
        ];
        $block = BlockContent::load(1);
        $url = 'admin/structure/block/add/block_content:' . $block->uuid() . '/' . $this->config('system.theme')
            ->get('default');
        $this->drupalGet($url);
        $this->submitForm($instance, 'Save block');
        $block = BlockContent::load(1);
        // Test getInstances method.
        $this->assertCount(1, $block->getInstances());
        // Navigate to home page.
        $this->drupalGet('');
        $this->assertSession()
            ->pageTextContains($body);
        // Delete the block.
        $this->drupalGet('admin/content/block/1/delete');
        $this->assertSession()
            ->pageTextContains('This will also remove 1 placed block instance.');
        $this->submitForm([], 'Delete');
        $this->assertSession()
            ->pageTextContains('The content block ' . $edit['info[0][value]'] . ' has been deleted.');
        // Create another block and force the plugin cache to flush.
        $edit2 = [];
        $edit2['info[0][value]'] = $this->randomMachineName(8);
        $body2 = $this->randomMachineName(16);
        $edit2['body[0][value]'] = $body2;
        $this->drupalGet('block/add/basic');
        $this->submitForm($edit2, 'Save');
        $this->assertSession()
            ->responseNotContains('Error message');
        // Create another block with no instances, and test we don't get a
        // confirmation message about deleting instances.
        $edit3 = [];
        $edit3['info[0][value]'] = $this->randomMachineName(8);
        $body = $this->randomMachineName(16);
        $edit3['body[0][value]'] = $body;
        $this->drupalGet('block/add/basic');
        $this->submitForm($edit3, 'Save');
        // Show the delete confirm form.
        $this->drupalGet('admin/content/block/3/delete');
        $this->assertSession()
            ->pageTextNotContains('This will also remove');
    }
    
    /**
     * Tests placed content blocks create a dependency in the block placement.
     */
    public function testConfigDependencies() : void {
        $block = $this->createBlockContent();
        // Place the block.
        $block_placement_id = mb_strtolower($block->label());
        $instance = [
            'id' => $block_placement_id,
            'settings[label]' => $block->label(),
            'region' => 'sidebar_first',
        ];
        $block = BlockContent::load(1);
        $url = 'admin/structure/block/add/block_content:' . $block->uuid() . '/' . $this->config('system.theme')
            ->get('default');
        $this->drupalGet($url);
        $this->submitForm($instance, 'Save block');
        $dependencies = \Drupal::service('config.manager')->findConfigEntityDependenciesAsEntities('content', [
            $block->getConfigDependencyName(),
        ]);
        $block_placement = reset($dependencies);
        $this->assertEquals($block_placement_id, $block_placement->id(), "The block placement config entity has a dependency on the block content entity.");
    }
    
    /**
     * Load a block based on the label.
     */
    private function getBlockByLabel(string $label) : ?BlockContentInterface {
        $blocks = \Drupal::entityTypeManager()->getStorage('block_content')
            ->loadByProperties([
            'info' => $label,
        ]);
        if (empty($blocks)) {
            return NULL;
        }
        return reset($blocks);
    }

}

Classes

Title Deprecated Summary
BlockContentCreationTest Create a block and test saving it.

Buggy or inaccurate documentation? Please file an issue. Need support? Need help programming? Connect with the Drupal community.