BlockContentSaveTest.php

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

Namespace

Drupal\Tests\block_content\Functional

File

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

View source
<?php

namespace Drupal\Tests\block_content\Functional;

use Drupal\block_content\Entity\BlockContent;

/**
 * Tests $block_content->save() for saving content.
 *
 * @group block_content
 */
class BlockContentSaveTest extends BlockContentTestBase {
    
    /**
     * Modules to enable.
     *
     * @var array
     */
    protected static $modules = [
        'block_content_test',
    ];
    
    /**
     * {@inheritdoc}
     */
    protected $defaultTheme = 'stark';
    
    /**
     * Sets the test up.
     */
    protected function setUp() : void {
        parent::setUp();
        $this->drupalLogin($this->adminUser);
    }
    
    /**
     * Checks whether custom block IDs are saved properly during an import.
     */
    public function testImport() {
        // Custom block ID must be a number that is not in the database.
        $max_id = (int) \Drupal::entityQueryAggregate('block_content')->accessCheck(FALSE)
            ->aggregate('id', 'max')
            ->execute()[0]['id_max'];
        $test_id = $max_id + mt_rand(1000, 1000000);
        $info = $this->randomMachineName(8);
        $block_array = [
            'info' => $info,
            'body' => [
                'value' => $this->randomMachineName(32),
            ],
            'type' => 'basic',
            'id' => $test_id,
        ];
        $block = BlockContent::create($block_array);
        $block->enforceIsNew(TRUE);
        $block->save();
        // Verify that block_submit did not wipe the provided id.
        $this->assertEquals($test_id, $block->id(), 'Block imported using provide id');
        // Test the import saved.
        $block_by_id = BlockContent::load($test_id);
        $this->assertNotEmpty($block_by_id, 'Custom block load by block ID.');
        $this->assertSame($block_array['body']['value'], $block_by_id->body->value);
    }
    
    /**
     * Tests determining changes in hook_block_presave().
     *
     * Verifies the static block load cache is cleared upon save.
     */
    public function testDeterminingChanges() {
        // Initial creation.
        $block = $this->createBlockContent('test_changes');
        $this->assertEquals(REQUEST_TIME, $block->getChangedTime(), 'Creating a block sets default "changed" timestamp.');
        // Update the block without applying changes.
        $block->save();
        $this->assertEquals('test_changes', $block->label(), 'No changes have been determined.');
        // Apply changes.
        $block->setInfo('updated');
        $block->save();
        // The hook implementations block_content_test_block_content_presave() and
        // block_content_test_block_content_update() determine changes and change
        // the title as well as programmatically set the 'changed' timestamp.
        $this->assertEquals('updated_presave_update', $block->label(), 'Changes have been determined.');
        $this->assertEquals(979534800, $block->getChangedTime(), 'Saving a custom block uses "changed" timestamp set in presave hook.');
        // Test the static block load cache to be cleared.
        $block = BlockContent::load($block->id());
        $this->assertEquals('updated_presave', $block->label(), 'Static cache has been cleared.');
    }
    
    /**
     * Tests saving a block on block insert.
     *
     * This test ensures that a block has been fully saved when
     * hook_block_content_insert() is invoked, so that the block can be saved again
     * in a hook implementation without errors.
     *
     * @see block_test_block_insert()
     */
    public function testBlockContentSaveOnInsert() {
        // block_content_test_block_content_insert() triggers a save on insert if the
        // title equals 'new'.
        $block = $this->createBlockContent('new');
        $this->assertEquals('BlockContent ' . $block->id(), $block->label(), 'Custom block saved on block insert.');
    }

}

Classes

Title Deprecated Summary
BlockContentSaveTest Tests $block_content->save() for saving content.

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