View source
<?php
namespace Drupal\help\Controller;
use Drupal\Core\Cache\CacheableMetadata;
use Drupal\Core\Controller\ControllerBase;
use Drupal\Core\Extension\ExtensionLifecycle;
use Drupal\Core\Extension\ModuleExtensionList;
use Drupal\Core\Routing\RouteMatchInterface;
use Drupal\help\HelpSectionManager;
use Symfony\Component\DependencyInjection\ContainerInterface;
use Symfony\Component\HttpKernel\Exception\NotFoundHttpException;
class HelpController extends ControllerBase {
protected $routeMatch;
protected $helpManager;
protected $moduleExtensionList;
public function __construct(RouteMatchInterface $route_match, HelpSectionManager $help_manager, ModuleExtensionList $module_extension_list) {
$this->routeMatch = $route_match;
$this->helpManager = $help_manager;
$this->moduleExtensionList = $module_extension_list;
}
public static function create(ContainerInterface $container) {
return new static($container
->get('current_route_match'), $container
->get('plugin.manager.help_section'), $container
->get('extension.list.module'));
}
public function helpMain() {
$output = [];
$cacheability = new CacheableMetadata();
$cacheability
->addCacheContexts([
'user.permissions',
]);
$plugins = $this->helpManager
->getDefinitions();
$cacheability
->addCacheableDependency($this->helpManager);
foreach ($plugins as $plugin_id => $plugin_definition) {
if (!empty($plugin_definition['permission']) && !$this
->currentuser()
->hasPermission($plugin_definition['permission'])) {
continue;
}
$plugin = $this->helpManager
->createInstance($plugin_id);
$this_output = [
'#theme' => 'help_section',
'#title' => $plugin
->getTitle(),
'#description' => $plugin
->getDescription(),
'#empty' => $this
->t('There is currently nothing in this section.'),
'#links' => [],
'#weight' => $plugin_definition['weight'],
];
$links = $plugin
->listTopics();
if (is_array($links) && count($links)) {
$this_output['#links'] = $links;
}
$cacheability
->addCacheableDependency($plugin);
$output[$plugin_id] = $this_output;
}
$cacheability
->applyTo($output);
return $output;
}
public function helpPage($name) {
$build = [];
if ($this
->moduleHandler()
->implementsHook($name, 'help')) {
$module_name = $this
->moduleHandler()
->getName($name);
$build['#title'] = $module_name;
$info = $this->moduleExtensionList
->getExtensionInfo($name);
if ($info[ExtensionLifecycle::LIFECYCLE_IDENTIFIER] === ExtensionLifecycle::EXPERIMENTAL) {
$this
->messenger()
->addWarning($this
->t('This module is experimental. <a href=":url">Experimental modules</a> are provided for testing purposes only. Use at your own risk.', [
':url' => 'https://www.drupal.org/core/experimental',
]));
}
$temp = $this
->moduleHandler()
->invoke($name, 'help', [
"help.page.{$name}",
$this->routeMatch,
]);
if (empty($temp)) {
$build['top'] = [
'#markup' => $this
->t('No help is available for module %module.', [
'%module' => $module_name,
]),
];
}
else {
if (!is_array($temp)) {
$temp = [
'#markup' => $temp,
];
}
$build['top'] = $temp;
}
$admin_tasks = system_get_module_admin_tasks($name, $info);
if (!empty($admin_tasks)) {
$links = [];
foreach ($admin_tasks as $task) {
$link['url'] = $task['url'];
$link['title'] = $task['title'];
$links[] = $link;
}
$build['links'] = [
'#theme' => 'links__help',
'#heading' => [
'level' => 'h3',
'text' => $this
->t('@module administration pages', [
'@module' => $module_name,
]),
],
'#links' => $links,
];
}
return $build;
}
else {
throw new NotFoundHttpException();
}
}
}