Друпал 8: Routing, links, permissions, tabs или Hello YML

name: Test page
description: 'Hello World - is my first module!'
type: module
core: 8.x
version: 1.0
package: Frantsuzzz

testpage.helloworld1:
  path: '/helloworld'
  defaults:
    _title: 'Hello World'
    _controller: '\Drupal\testpage\Controller\TestPageController::renderPage'
  requirements:
    _permission: 'view content'

/**
 * @file
 * Contains \Drupal\testpage\Controller\TestPageController.
 */

/**
 * Пространство имен нашего контроллера.
 */
namespace Drupal\testpage\Controller;

/**
 * Используем друпальный класс ControllerBase.
 */
use Drupal\Core\Controller\ControllerBase;

/**
 * Объявляем наш класс-контроллер.
 */
class TestPageController extends ControllerBase {

  //Метод, который возвращает render array с содержимым страницы
  public function renderPage() {
    $output = array();
    $output['#title'] = 'Hello world title';
    $output['#markup'] = 'Hello World!';
    return $output;
  }
}

view testpage:
  title: 'View testpage'
  description: 'View test page "Hello world".'
  restrict access: TRUE

testpage.testpage3:
  path: '/admin/config/development/helloworld'
  defaults:
    _title: 'Admin Hello World'
    _controller: '\Drupal\testpage\Controller\TestPageController::renderPage'
  requirements:
    _permission: 'access administration pages'

testpage.testpage3:
  #Заголовок пункта меню
  title: 'Hello world admin'
  #Описание пункта меню
  description: 'Weloworld page for admin page'
  #Маршрут (определяет путь ссылки)
  route_name: testpage.testpage3
  #родительский маршрут (system.admin_config_development - определен в модуле system)
  parent: system.admin_config_development
  #Вес ссылки в меню
  weight: 10

#Наш новый раздел на панели конфигурации
testpage.admin_config_custom:
  path: '/admin/config/custom'
  defaults:
#Контроллер для таких разделов уже определен в модуле system
    _controller: '\Drupal\system\Controller\SystemController::systemAdminMenuBlockPage'
    _title: 'Custom settings'
  requirements:
    _permission: 'access administration pages'

#Что бы не путаться в примерах, мы добавим новый маршрут для страницы HelloWorld
testpage.testpage4:
  path: '/admin/config/custom/helloworld'
  defaults:
    _title: 'Admin Custom Hello World'
    _controller: '\Drupal\testpage\Controller\TestPageController::renderPage'
  requirements:
    _permission: 'access administration pages'

testpage.admin_config_custom:
  title: 'Custom settings'
  route_name: testpage.admin_config_custom
  parent: system.admin_config
  description: 'Custom panel'
  weight: -10

testpage.testpage4:
  title: 'Hello world admin (custom)'
  description: 'Weloworld page for admin page'
  route_name: testpage.testpage4
  parent: testpage.admin_config_custom
  weight: 10

testpage.testpage5:
  path: '/admin/config/custom/helloworld/tab2'
  defaults:
    _title: 'Hello World Tab2'
#в качестве контроллера не будем ничего придумывать, просто используем все тот-же helloworld :-)
    _controller: '\Drupal\testpage\Controller\TestPageController::renderPage'
  requirements:
    _permission: 'access administration pages'

#Опишем вкладку по умолчанию
testpage.tabdefault:
#Имя маршрута (путь для вкладки по умолчанию)
  route_name: testpage.testpage4
#Родительский маршрут. Т.к. вкладка по-умолчанию, то используем тот-же маршрут
  base_route: testpage.testpage4
  title: 'Tab default'

#Вторая вкладка
testpage.tab2:
#Маршрут для второй вкладки
  route_name: testpage.testpage5
  title: 'Tab2'
#Родительский маршрут - указываем ИМЯ МАРШРУТА, который у нашей основной вкладки
  base_route: testpage.testpage4

testpage.testpage6:
  path: '/admin/config/custom/helloworld/tab3/subtab1'
  defaults:
    _title: 'Hello World Tab2'
    _controller: '\Drupal\testpage\Controller\TestPageController::renderPage'
  requirements:
    _permission: 'access administration pages'

testpage.testpage7:
  path: '/admin/config/custom/helloworld/tab3/subtab2'
  defaults:
    _title: 'Hello World Tab2'
    _controller: '\Drupal\testpage\Controller\TestPageController::renderPage'
  requirements:
    _permission: 'access administration pages'

#Добавляем третью вкладку
testpage.tab3:
  route_name: testpage.testpage6
  title: 'Tab3'
  base_route: testpage.testpage4

#Регистрируем вкладки второго уровня
testpage.tab3sub1:
  route_name: testpage.testpage6
  title: Sub1
#Имя (id) родительской вкладки
  parent_id: testpage.tab3

testpage.tab3sub2:
  route_name: testpage.testpage7
  title: Sub2
  parent_id: testpage.tab3