HelpBlockTest.php

<?php

declare (strict_types=1);
namespace Drupal\Tests\help\Kernel;

use Drupal\KernelTests\KernelTestBase;
use Drupal\Tests\block\Traits\BlockCreationTrait;
use Drupal\Tests\HttpKernelUiHelperTrait;
use PHPUnit\Framework\Attributes\Group;
use PHPUnit\Framework\Attributes\RunTestsInSeparateProcesses;

/**
 * Tests display of help block.
 */
class HelpBlockTest extends KernelTestBase {
  use HttpKernelUiHelperTrait;
  use BlockCreationTrait;
  
  /**
   * {@inheritdoc}
   */
  protected static $modules = [
    'help',
    'help_page_test',
    'block',
    'more_help_page_test',
    'system',
    'user',
  ];
  
  /**
   * The help block instance.
   *
   * @var \Drupal\block\Entity\Block
   */
  protected $helpBlock;
  
  /**
   * {@inheritdoc}
   */
  protected function setUp() : void {
    parent::setUp();
    $this->installEntitySchema('block');
    $this->container
      ->get('theme_installer')
      ->install([
      'stark',
    ]);
    $this->config('system.theme')
      ->set('default', 'stark')
      ->save();
    $this->helpBlock = $this->placeBlock('help_block');
  }
  
  /**
   * Logs in users, tests help pages.
   */
  public function testHelp() : void {
    $this->drupalGet('help_page_test/has_help');
    $this->assertSession()
      ->pageTextContains('I have help!');
    $this->assertSession()
      ->pageTextContains($this->helpBlock
      ->label());
    $this->drupalGet('help_page_test/no_help');
    // The help block should not appear when there is no help.
    $this->assertSession()
      ->pageTextNotContains($this->helpBlock
      ->label());
    // Ensure that if two hook_help() implementations both return a render array
    // the output is as expected.
    $this->drupalGet('help_page_test/test_array');
    $this->assertSession()
      ->pageTextContains('Help text from more_help_page_test_help module.');
    $this->assertSession()
      ->pageTextContains('Help text from help_page_test_help module.');
  }

}