Joomla 6: возможности, ключи и приёмы

1.1 Имя, версии и кодовые названия

Joomla 6.0 («Kuimarisha») вышла 14 октября 2025 года вместе с 5.4 («Kutegemea») [7]. Версия 6.1 («Nyota») вышла 14 апреля 2026 года [8] сторонний, а 6.1.4 от 29 сентября 2026 года стала последним исправляющим выпуском этой ветки к дню выхода 6.2 исходники. Версия 6.2 («Mwezi») вышла 13 октября 2026 года [9] документация; кодовое название и дату выпуска хранит файл версии пакета исходники. Исправляющие выпуски ветки 6.1 — с 6.1.1 по 6.1.4 — вышли 26 мая, 7 июля, 18 августа и 29 сентября 2026 года, а первый кандидат в релизы 6.2 — 29 сентября исследование (глава 3 «Релизы и дорожная карта» [10]).

1.2 Версии и сроки поддержки

Дорожная карта проекта различает два срока: до какой даты ветка получает обычные исправления ошибок и до какой — только исправления безопасности [11] документация.

Из таблицы следуют три практических вывода. Поддержка безопасности ветки 4.x закончилась 14 октября 2025 года: сайты на ней нужно переводить, а не ждать. Ветка 5.x вышла из режима обычных исправлений 13 октября 2026 года: в этот день выпущена 5.4.10, последняя в таком режиме [11] документация исходники; год после этого она получает только исправления безопасности. Для новых проектов разумна ветка 6.x: сроки её поддержки самые длинные.

Joomla 6.2.0 вышла 13 октября 2026 года в 16:00 UTC: так показывают тег в репозитории и объявление проекта [9] документация исходники. Выпуск уложился в плановую дату, как и предыдущий: 6.1 была назначена на «около 14 апреля 2026 года» [12] документация и вышла 14 апреля [8] сторонний, а 6.2 назначена на 13 октября и вышла в этот день; первый кандидат появился 29 сентября, rc2 — 6 октября [13] документация. Время тоже привычное: 6.0.0, 6.1.0, 6.1.2, 6.1.3, 6.1.4 и 6.2.0 опубликованы между 15:57 и 16:02 UTC по времени публикации на GitHub исходники. От rc2 до стабильного выпуска изменились четыре файла: файл версии, список пакетов Composer, манифест пакета и файл метаданных FIDO для WebAuthn стенд; поэтому проверки, сделанные на 6.2.0-rc2, остаются в силе для 6.2.0 стенд. Выпуски идут по шестимесячному ритму — октябрь и апрель. Из объявления о 6.1 видно, что последней минорной версией ряда проект считает 6.4: автоматические обновления не пересекают границу мажорной версии, ни «с 5.4 на 6.x», ни «с 6.4 на 7.x» [14] документация.

1.3 Требования

Минимальная версия PHP — 8.3.0: проверка стоит в самом пакете, в файле платформенных требований Composer исходники. Исследование автора сверило требования с руководством разработчика на 8 октября 2026 года исследование (глава 4 «Технический фундамент» [10]). PHP: минимум 8.3.0, рекомендуется 8.4. MySQL: минимум 8.0.13, рекомендуется 8.4. MariaDB: минимум 10.4, поддерживается 10.6, рекомендуется 12.0. PostgreSQL: минимум 12, поддерживается 14, рекомендуется 17.6. Apache: 2.4. Nginx: поддерживается 1.26, рекомендуется 1.29. Те же минимумы для MySQL и MariaDB называет и сторонний обзор [15] сторонний. Перед развёртыванием таблицу стоит сверить с руководством заново [7].

Установщик 6.1.4 знает ключ --public-folder, а в консоли есть команда site:create-public-folder: ядро умеет работать из отдельной публичной папки, оставляя код и конфигурацию вне корня сайта стенд.

1.4 Что внутри пакета

Установка 6.1.4 содержит 251 расширение, и тот же набор стоит в 6.2.0 стенд.

Самые многочисленные группы плагинов: system — 24, webservices и fields — по 18, content — 10, schemaorg и task — по 9, editors-xtd и quickicon — по 8 стенд. Под ядром лежат 89 пакетов Composer. Основу составляют пакеты Joomla Framework версии 4 (application, di, event, database, router, session, console и другие), консоль Symfony 7.4.7, почтовая библиотека PHPMailer 6.12.0, библиотека web-auth/webauthn-lib 4.5.2 для беспарольного входа и пакет tobscure/json-api, на котором строится вывод API исходники.

1.5 Переход с 5.4 на 6.x

Проект называет переход с 5.4 на 6.0 обновлением, а не миграцией, и поддерживает его через плагин «Behaviour — Backward Compatibility 6» [7] документация. По руководству проекта, в 5.4 этот плагин установлен, включён и ничего не делает; в новой установке 6.x он установлен, но выключен; как плагин группы behaviour, он загружается раньше остальных [16] документация. На стенде 6.1.4 плагин compat6 действительно выключен стенд.

Плагин даёт три вещи, и это видно по его языковым строкам: псевдонимы классов, которые переименовали или перенесли в пространства имён; сами удалённые устаревшие классы; пустые заглушки удалённых ассетов, чтобы старый код не падал с исключением исходники. В его карте классов лежит, например, псевдоним JFactory на Joomla\CMS\Factory исходники. Значит, расширение, которое всё ещё зовёт JFactory, при выключенном плагине работать не будет.

Руководство даёт и порядок действий: старый плагин совместимости Joomla 5 перед обновлением отключают, ошибки разбирают ещё на 5.4, а повторяют обновление, только когда сайт без него работает [16] документация. Смысл порядка простой: если сайт упадёт на 5.4, плагин легко включить обратно, а если он упадёт посреди обновления, пути назад нет. Не стоит и заводить собственный плагин в группе behaviour: группа может исчезнуть [16] документация.

2.1 Версия 6.0

Основу выпуска составляют две перемены: минимальный PHP поднят до 8.3, а из кода удалено то, что было помечено устаревшим; сайтам, которым нужно время, предусмотрен плагин совместимости. Из новшеств, названных в объявлении [7] документация:

Обучающий тур 6.0 в пакете называет ещё несколько мелочей: письмо при одобрении регистрации администратором, свои классы в выпадающем списке диалога изображений TinyMCE, пакетное снятие метки, общий вид менеджера статей для избранных исходники.

2.2 Версия 6.1

Выпуск 6.1 принёс четыре заметных новшества и ряд мелких [14] документация:

Из мелких: кнопка abbr в TinyMCE и подсказки о состоянии языковых переопределений исходники. В пакете 6.1.4 из капч есть единственная — powcaptcha; плагинов капч внешних сервисов в составе нет стенд. Объявление называет её возвращением защиты от спама.

2.3 Версия 6.2

Состав 6.2 известен по заметкам о выпуске [9] документация, по пакету 6.2.0 и по встроенному обучающему туру исходники:

Сверх списка в коде 6.2.0 нашлись перечисляемый тип поля формы EnumField, класс MailController в компоненте «Конфигурация», на который перенесена отправка пробного письма, и новые плагины TinyMCE для выбора ссылок и файлов исходники. Английских языковых строк в 6.2.0 на 372 больше, чем в 6.1.4: 13 504 против 13 132 исходники. В заметках для разработчиков к 6.2 новых объявлений об устаревании нет [18] документация, а в коде их тринадцать; они перечислены в таблице устаревшего в главе об устройстве ядра исходники.

Исследование автора, опираясь на объявление о релиз-кандидате, называет ещё две вещи: новую систему сборки и тестовую библиотеку PHPUnit 12 исследование (глава 3 «Релизы и дорожная карта» [10]). Запасные языки важнее всего для казахстанских сайтов: запасным для kk-KZ назначают ru-RU, и непереведённые казахские строки интерфейса показываются по-русски, а не по-английски исследование (глава 13 (русскоязычная среда и положение в РК) [10]).

Стороннее издание сообщало, что экспериментальную связку Joomla с серверами MCP — протоколом подключения моделей ИИ к инструментам — не включат ни в один выпуск ветки 6.x [8] сторонний; официального подтверждения этому доклад не нашёл.

3.1 Слои

Joomla не есть единый монолит. Внизу лежит Joomla Framework — набор независимых PHP-пакетов (application, di, event, database, router, session, console, input, registry, uri и другие); в 6.1.4 они подключены в четвёртой версии исходники. Framework развивается как отдельный проект со своим сайтом [7] документация, так что его пакеты можно брать и без CMS. По сведениям исследования автора, у Framework около тридцати двух активных пакетов под именами joomla/*, скачанных вместе более 14,6 млн раз; серия 4.x легла в основу CMS 6.0, а серия 3.x — в основу CMS 5 исследование (глава 4 «Технический фундамент» [10]). Выше стоит сама CMS: каталог libraries/src с фабрикой Factory, слоем MVC, формами, ассетами и типизированными событиями. Над CMS поднимаются четыре приложения — сайт, административная часть, API и консоль, — а на самом верху находятся расширения: компоненты, модули, плагины, шаблоны, библиотеки, пакеты, файлы и языки. Классы libraries/src портал jpath.ru делит на основные (Application, Database, Document, Factory, Form, Input, Language, Router, Session, Uri, User и другие), служебные (Authentication, Categories, Date, Image, Mail, Pagination, Toolbar и другие) и вспомогательные — классы вида …Helper [19] сторонний.

3.2 Четыре входа в систему

У Joomla 6 четыре точки входа, и у каждой своё приложение — класс, который принимает запрос, прогоняет его по конвейеру и возвращает ответ исходники.

Все четыре входа загружают общий каркас includes/framework.php, поднимают контейнер зависимостей и берут из него своё приложение. В файлах api/includes/app.php и cli/joomla.php одинаково стоит набор из пяти алиасов сессии, который заменяет веб-сессию на консольную: session, JSession, Joomla\CMS\Session\Session, Joomla\Session\Session и Joomla\Session\SessionInterface — все на session.cli исходники. Без этих алиасов приложение вне веб-контекста падает при первом обращении к сессии; рабочий гайд проекта называет их обязательными [20] практика.

Кроме четырёх приложений, в libraries/src/Application лежит класс DaemonApplication: он превращает консольное приложение в службу (демона), а события DaemonForkEvent и DaemonReceiveSignalEvent описывают его работу; своего входа в корне сайта у него нет исходники. Портал jpath.ru называет его пятым типом приложений [6] сторонний.

3.3 Цикл выполнения веб-приложения

Портал jpath.ru разбирает выполнение веб-приложения на этапы и называет их по-русски, с исходным словом в скобках [6] сторонний. Ниже эти названия сверены с классами событий 6.1.4 исходники. Статья описывает сайт Joomla 3 и помечена порталом словом «Устарело», поэтому порядок читают как схему, а не как описание кода шестой ветки.

Плагины из этого доклада стоят на двух этапах: подключение ассетов — на рендеринге, в событии onBeforeCompileHead, а проба адреса и редирект — на маршрутизации, в событии onAfterRoute. Событие onBeforeRespond в статье не названо; класс BeforeRespondEvent в 6.1.4 есть.

3.4 Контейнер зависимостей и сервис-провайдеры

Контейнер зависимостей (DI-контейнер, DIC) доступен через Factory::getContainer(). Базу данных, пользователей, почту, маршрутизатор берут из него по имени интерфейса стенд:

<?php
use Joomla\CMS\Factory;
use Joomla\Database\DatabaseInterface;

$db = Factory::getContainer()->get(DatabaseInterface::class);

Глобальный контейнер собирается в Factory::createContainer() из списка сервис-провайдеров. В статье портала jpath.ru 2022 года их девятнадцать [21] сторонний; в 6.1.4 их двадцать три: к прежним добавились провайдеры CaptchaRegistry, EditorsRegistry, Input и Mailer исходники. Та же статья напоминает, что контейнер не заменяет Factory прямо: в контроллерах вместо Factory::getDocument() правильнее $this->app->getDocument(), и тогда класс можно проверять подменой приложения [21] сторонний. У каждого компонента свой контейнер, из которого берут фабрики моделей: вызов Factory::getApplication()->bootComponent('com_content')->getMVCFactory()->createModel('Articles', 'Site') работает и на сайте, и в админке, и в API [21] сторонний; этот приём применён в главе о содержимом при записи материала из кода.

Расширения современного вида приносят файл services/provider.php, который возвращает анонимный класс с интерфейсом ServiceProviderInterface и записывает в контейнер способ создать плагин, модуль или компонент. Образцом служат плагины ядра: из 159 их провайдеров все 159 пользуются set(), а 153 — ещё и lazy(), так что плагин создаётся при первом обращении стенд; у system/skipto настройки берутся из PluginHelper::getPlugin(), а у task/globalcheckin дополнительно подаётся база данных через setDatabase() исходники. Статья портала для Joomla 4 показывает метод share() [21] сторонний; в 6.1.4 он существует рядом с set(), lazy(), protect(), alias() и extend() стенд, но в провайдерах плагинов ядра принята связка set() и lazy(). Рабочие провайдеры для трёх своих плагинов приведены ниже, в главах о командной строке и о приёмах кода.

3.5 Карта неймспейсов

Какой префикс какому каталогу соответствует, Joomla знает из файла administrator/cache/autoload_psr4.php: в нём, например, Joomla\Component\Content\Administrator\ сопоставлен administrator/components/com_content/src стенд. Файл строит класс JNamespacePsr4Map, а вызывает его метод приложения createExtensionNamespaceMap() исходники. Веб-приложения и консоль делают это сами при запуске; в собственном сценарии, который лежит вне этой цепочки, вызов нужен вручную.

Рабочая заготовка автономного сценария, проверенная на 6.1.4, — она повторяет cli/joomla.php, но вместо запуска команд оставляет приложение в распоряжении сценария стенд:

<?php
define('_JEXEC', 1);
define('JPATH_BASE', dirname(__DIR__));            // сценарий лежит в cli/
require_once JPATH_BASE . '/includes/defines.php';
require_once JPATH_BASE . '/includes/framework.php';

use Joomla\CMS\Factory;

$container = Factory::getContainer();
$container->alias('session', 'session.cli')
    ->alias('JSession', 'session.cli')
    ->alias(\Joomla\CMS\Session\Session::class, 'session.cli')
    ->alias(\Joomla\Session\Session::class, 'session.cli')
    ->alias(\Joomla\Session\SessionInterface::class, 'session.cli');

$app = $container->get(\Joomla\Console\Application::class);
Factory::$application = $app;
$app->createExtensionNamespaceMap();   // до любых class_exists() по классам расширений

Две подробности пригодятся при записи данных. Модель материала в автономном сценарии и в консольной команде требует константу JPATH_COMPONENT: определяет её только ComponentHelper::renderComponent() при веб-вызове компонента исходники, и без неё загрузка формы падает с «Undefined constant …_COMPONENT» стенд. Статья портала jpath.ru 2024 года считает, что в Joomla 4 и выше константу задавать не нужно [22] сторонний; в консольной команде 6.1.4 это не подтвердилось стенд. А метки при сохранении через модель попадают в базу, только если до сохранения подключены плагины группы behaviour — об этом в главе о содержимом.

3.6 События и плагины

Событие есть именованный момент работы приложения («после маршрутизации», «перед сборкой заголовка страницы», «перед сохранением материала»), а плагин — подписчик, который откликается на него. В 6.1.4 события описаны типизированными классами: в каталоге libraries/src/Event лежат 216 файлов, сгруппированных по областям — Application, Content, User, Model, Table, Workflow, WebAsset, Finder и так далее исходники. Подписчик объявляет интерфейс SubscriberInterface и возвращает из getSubscribedEvents() карту «событие → метод»; метод получает объект своего типа события, например BeforeCompileHeadEvent или AfterRouteEvent стенд.

Старый способ — публичные методы с именами вида onContentPrepare — пока поддержан: базовый класс плагина допускает слушателей старого образца (legacy listeners), но для каждого такого плагина пишет предупреждение об устаревании «The plugin should implement SubscriberInterface» исходники. Консольное приложение при запуске подключает плагины трёх групп — behaviour, system и console, — а приложение API подключает группу webservices исходники. Из этого следует практическое правило: команда командной строки живёт в плагине группы console, маршрут API — в плагине группы webservices.

Плагины сведены в 24 группы (число плагинов в скобках): system (24), webservices (18), fields (18), content (10), schemaorg (9), task (9), editors-xtd (8), quickicon (8), privacy (6), installer (5), finder (5), multifactorauth (5), user (5), extension (4), authentication (3), behaviour (3), editors (3), media-action (3), workflow (3), api-authentication (2), sampledata (2), actionlog, captcha и filesystem (по одному) стенд.

3.7 Что объявлено устаревшим

Часть привычных вызовов в 6.1.4 и 6.2.0 ещё работает, но помечена к удалению в 7.0 или в 8.0. Новый код на них писать не стоит.

Не всё из старого устарело: методы addScriptOptions(), addCustomTag() и addHeadLink() у документа не помечены, а помощник HTMLHelper::_('bootstrap.tab', …) и родственные ему (modal, collapse, dropdown, offcanvas, popover, toast и другие) в 6.1.4 на месте исходники.

4.1 Два состояния ассета

У ассета два состояния: зарегистрированный и используемый [23] документация. Зарегистрированный ассет только занесён в реестр: менеджер знает, что такой есть, но на страницу не выводит. Используемый ассет менеджер при сборке страницы выводит вместе с его зависимостями. Обратиться к незарегистрированному ассету нельзя: это вызывает исключение UnknownAssetException. Всё, что описано в joomla.asset.json, находится в первом состоянии, пока код не попросит его.

4.2 Где живут реестры

Описания ассетов лежат в файлах joomla.asset.json. В 6.1.4 их 38: общий реестр сторонних библиотек media/vendor/joomla.asset.json, системный media/system/joomla.asset.json, а ещё у ряда компонентов и плагинов и у обоих шаблонов стенд. Системный реестр содержит 65 записей (57 скриптов и 8 стилей), реестр библиотек — 57 (38 скриптов, 12 стилей и 7 пресетов), у Cassiopeia — 12, у админской Atum — 15 исходники. Руководство 2021 года перечисляло ещё и media/legacy/joomla.asset.json [23]; в пакете 6.1.4 такого файла нет исходники. Позднее определение перекрывает раннее по имени ассета: этим пользуются, чтобы заменить адрес скрипта, не трогая код расширения [23] документация.

Имена, которые стоит знать (проверены по реестрам 6.1.4) исходники:

В примере из руководства 2021 года стоит имя fields.validate; в системном реестре 6.1.4 такого имени нет, а проверка форм зовётся form.validate исходники. Старые примеры стоит сверять с реестром, прежде чем копировать.

4.3 Методы менеджера

Методы строятся по образцу «действие + тип», и этот образец виден в коде: имя метода, начинающееся с use, disable, register или add, разбирается магическим вызовом и пересылается типовому методу исходники. Из этого выводится весь набор.

Подпись регистрации одна для скриптов и стилей: имя, адрес, параметры (['version' => 'auto']), атрибуты тега (['defer' => true]), зависимости (['core']) [23] документация. Инлайн-код можно поставить до или после зависимости параметром ['position' => 'before'] или 'after', и менеджер выведет его в нужном месте относительно файла [23] документация. Если отключить ассет, от которого зависят другие, менеджер включит его снова: зависимость сильнее запрета [23] документация.

Пресет — особый ассет, который включает сразу несколько других; в списке тип указывается после решётки: core#script, foobar#style [23] документация. Веб-компоненты регистрируются с флагом webcomponent и грузятся не обычным скриптом, а асинхронным загрузчиком; имя для них принято начинать со слова webcomponent. [23] документация. Наконец, для особых нужд можно подставить собственный класс элемента: он решает, например, какой файл выдать для текущего языка, и через WebAssetAttachBehaviorInterface добавляет параметры скрипта в момент подключения — до события onBeforeCompileHead [23] документация.

4.4 Короткий путь «расширение/файл»

Причина такого поведения — раскладка файлов, которой требует помощник HTMLHelper: /media/расширение/тип/файл, где тип — css, js или images [25] сторонний. Запись com_foo/bar.css при опции relative разворачивается в /media/com_foo/css/bar.css, а тот же файл можно переопределить в шаблоне по адресу /templates/{шаблон}/css/com_foo/bar.css [25] сторонний; на стенде 6.1.4 сработал другой адрес — /media/templates/site/{шаблон}/css/com_foo/bar.css стенд. В коде 6.1.4 поиск идёт сперва по самому шаблону, затем по родителю дочернего шаблона и лишь потом по каталогу media исходники. Менеджер ассетов пользуется тем же помощником, поэтому короткий адрес у него тот же.

Проверено на плагине группы system, который подписан на событие «перед сборкой заголовка» стенд:

<?php
public function attachAssets(BeforeCompileHeadEvent $event): void
{
    $app = $this->getApplication();

    if (!$app->isClient('site')) {
        return;
    }

    $wa = $app->getDocument()->getWebAssetManager();

    $wa->registerAndUseStyle('wmlab.style', 'plg_system_wmlab/wmlab.css', ['version' => 'auto']);
    $wa->registerAndUseScript('wmlab.script', 'plg_system_wmlab/wmlab.js', ['version' => 'auto'], ['defer' => true], ['core']);
    $wa->addInlineScript('document.documentElement.dataset.wmlab = "1";', ['position' => 'after'], [], ['wmlab.script']);
}

На главной странице чистой 6.1.4 получились три строки в <head> стенд:

<link href="/media/plg_system_wmlab/css/wmlab.css?5c832e" rel="stylesheet">
<script src="/media/plg_system_wmlab/js/wmlab.js?5c832e" defer></script>
<script>document.documentElement.dataset.wmlab = "1";</script>

Суффикс ?5c832e — не версия файла, а общая версия медиафайлов сайта: тот же суффикс у всех ассетов ядра на той же странице. Параметр version => auto велит менеджеру взять именно её. Рабочий гайд проекта выводит отсюда порядок сброса кэшей: пересохранить общие настройки — это меняет версию медиафайлов — и лишь потом чистить остальное [20] практика.

О режиме отладки статья 2021 года пишет, что помощник подставляет к имени файла суффикс -uncompressed [25] сторонний. В коде 6.1.4 такое имя встречается только в описании параметров: помощник подбирает пару имя.js и имя.min.js, и выбор между ними зависит от режима отладки, а при включённом detectDebug предпочитаются несжатые файлы исходники. Свои скрипты и стили поэтому отдают в двух видах — app.js и app.min.js.

4.5 Что Cassiopeia грузит по умолчанию

На главной странице чистой установки 6.1.4 шаблон Cassiopeia выводит стили joomla-fontawesome (ленивой загрузкой), template, colors_standard, mod-menu, joomla-alert и скрипты core, template, menu, keepalive, passwordview, messages — большей частью модулями ES. Ни jQuery, ни Bootstrap JS в списке нет стенд. Нужный компонент подключают явно, одним из двух путей: ассетом ($wa->useScript('bootstrap.tab')) или помощником HTMLHelper::_('bootstrap.tab', '.selector', []), который в 6.1.4 по-прежнему существует исходники. Первый путь предпочтителен: он прозрачен для менеджера и для проверки зависимостей.

Файлы media/templates/site/cassiopeia/css/user.css и js/user.js в чистой установке не созданы, но ассеты template.user для них заведены в реестре шаблона: положив файл, его подключают без единой строки кода исходники. Этот приём описан ещё в 2022 году для Joomla 4.1 [26] сторонний.

5.1 Два шаблона и их позиции

В Joomla 6 два основных шаблона: Cassiopeia для сайта и Atum для админки; рядом в пакете лежит третий — Cassiopeia Extended, дочерний стенд. Шаблон отвечает за каркас страницы и за позиции — именованные места, куда администратор ставит модули. В Cassiopeia 6.1.4 их шестнадцать исходники:

Раскладку Cassiopeia строит CSS Grid: в template.css 6.1.4 класс .site-grid встречается восемь раз исходники. Практический вывод сделал ещё автор статьи 2022 года: перестановка позиций на десктопе — несколько строк grid-template-areas в user.css, без правки PHP [26] сторонний. Оговорка: в той статье области сетки названы коротко (side-l, bot-a), а позиции модулей — полными именами (sidebar-left, bottom-a); сверять нужно по template.css своей версии.

5.2 Дочерние шаблоны

Дочерний шаблон наследует всё от родителя и меняет только то, что объявлено в нём самом. Механизм появился в Joomla 4.1, и вместе с ним пути ресурсов шаблона переехали из templates/cassiopeia/ в media/templates/site/cassiopeia/ [26] сторонний; файл user.css, созданный в старом месте, при обновлении был перенесён автоматически. В манифесте родителя Cassiopeia стоит <inheritable>1</inheritable> — разрешение быть родителем исходники. Дочерний шаблон создаётся кнопкой в разделе шаблонов сайта [26] сторонний, после чего его назначают шаблоном по умолчанию.

С версии 6.0 в ядре есть готовый образец — Cassiopeia Extended [7] документация. Он устроен показательно исходники:

• в манифесте указан <parent>cassiopeia</parent> и <inheritable>0</inheritable>: потомок сам родителем быть не может;
• в каталоге шаблона лежат только component.php, error.php, index.php, offline.php, html/ и templateDetails.xml, а стили и изображения вынесены в media/templates/site/cassiopeia_extended/;
• манифест объявляет свои параметры: на вкладке «Дополнительно» — brand, logoFile, siteTitle, siteDescription, fluidContainer, stickyHeader, backTop; на вкладке цветов — двенадцать полей от headerbg до footercolor; на вкладке шрифтов — выбор схемы и системные шрифты для текста и заголовков.

Из этого образца вытекает общее правило: параметры шаблона заводятся полями в templateDetails.xml дочернего шаблона, читаются в его index.php через $this->params->get('имя') и выводятся там, где нужно; так делает и статья 2022 года для собственных скриптов в <head> [26] сторонний.

Дочерний шаблон решает лишь половину задачи — отличает облик сайта от родительского; вторую половину делают стили. Стиль (template style) есть шаблон плюс набор его параметров, и назначается он пункту меню. Так разделу «Экономика» можно дать один вид, спецпроекту — шапку без колонок, архиву — компактный; переключается это одним полем «Стиль шаблона», без условий в коде исследование (часть 5 «Дочерние шаблоны» [27]). Там же, на настоящей установке 6.1.4, показано, как кнопкой создаётся дочерний шаблон и как рядом с двумя штатными стилями заводится третий, с другими цветами и шрифтами; показано и то, как интерактивный лонгрид встраивается в материал и открывается на своём стиле.

5.3 Переопределения

Переопределение создают в разделе шаблонов сайта на вкладке «Создание переопределений»: выбирают, например, mod_custom, и в templates/<шаблон>/html/mod_custom/default.php появляется копия макета [26] сторонний. Если файл переименовать и положить рядом, он станет альтернативным макетом — его можно выбрать в параметрах модуля. Так один модуль получает несколько видов, которые выбирают в его параметрах. Отдельный слой — стили модуля: в Cassiopeia это card и noCard, а ядро добавляет html5, none, outline и table стенд: два первых лежат в templates/cassiopeia/html/layouts/chromes/, остальные — в общем каталоге layouts/chromes/.

Чтобы не пропустить изменение оригинала после обновления, в ядре есть пара плагинов: installer/override и quickicon/overridecheck; второй, по описанию, проверяет переопределения при обновлении и выводит уведомление на панели управления, но только если включён первый стенд. Рядом в базе есть таблица #__template_overrides стенд. Рабочее правило проектов автора строже: переопределение сверяют с ядерным макетом построчно, а штатные параметры (лимит знаков вступления, число столбцов) должны продолжать работать, а не подменяться настройкой, живущей только в шаблоне практика.

За идеями удобно ходить в коллекцию из 57 переопределений для модулей mod_articles_news, mod_articles_category, mod_articles_popular, mod_articles_latest и mod_stats: она открыта и показывает, как далеко можно уйти от стандартной разметки без единой правки ядра [28] сторонний.

5.4 Cassiopeia без PHP

Многое делается одним user.css. Переменные цвета объявлены в template.css 6.1.4 как --cassiopeia-color-primary, --cassiopeia-color-hover и --cassiopeia-color-brand исходники; статья 2022 года показывает, как переопределить их глобально и для отдельной страницы через CSS-класс страницы, который задаётся в параметрах пункта меню [26] сторонний. Классы для блога категории, названные в той же статье, в 6.1.4 на месте: boxed, image-left, image-right, image-bottom, image-alternate, columns-2…4 и masonry-2…4, а для обтекания изображений — float-start и float-end исходники. В 6.2 у вводного и полного изображения появятся отдельные поля классов для самого img и для окружающего figure исходники.

Ещё два приёма из той же статьи, сохранившие силу. Подвал сайта показывает две языковые константы, MOD_FOOTER_LINE1 и MOD_FOOTER_LINE2, и обе переопределяются в «Переопределении констант» без правки модуля [26] сторонний. Логотип в одном ряду с меню получают отдельным модулем «HTML-код» в позиции menu [26] сторонний.

Особняком стоят шаблонные фреймворки сторонних студий. Статья 2022 года о T4 Framework 2.1.3 описывала поддержку разметки Open Graph для статьи, категории и пункта меню и страницу автора с блоком в статье [29] сторонний; на 12 октября 2026 года на сайте студии есть отдельная страница о подготовке к Joomla 6. Совместимость любого стороннего шаблона и расширения с шестой веткой проверяют по версии именно вашего экземпляра, а не по историческим заметкам. Сводку по конструкторам и шаблонным фреймворкам на 8 октября 2026 года даёт исследование автора исследование (глава 14 «Шаблоны и конструкторы» [10]). YOOtheme Pro 5 совместим с Joomla 6; Astroid 3.3.0 — свободный фреймворк с несколькими макетами; Gantry 5.6.0 — первый выпуск новой команды Tiger12 после закрытия RocketTheme 30 июня 2025 года; Helix Ultimate на Bootstrap 5 популярен в странах СНГ; SP Page Builder 6.0.0 берёт динамическое содержимое из материалов. Для портала с десятками модулей на главной исследование советует собственный лёгкий шаблон на UIkit 3 с переопределениями макетов ядра, а не конструктор страниц: накладные расходы конструкторов на такой странице заметны исследование.

5.5 Свой макет модуля с ассетами

Статья 2022 года предлагала вставлять CSS и JS в переопределённый макет модуля старым способом — методами документа addStyleSheet() и addScriptDeclaration() [26] сторонний. В 6.1.4 они всё ещё есть, но помечены к удалению в 7.0, поэтому тот же приём записывают через менеджер ассетов. Образец ниже на стенде не запускался и приведён как схема:

<?php
// templates/<шаблон>/html/mod_custom/wm_reveal.php — альтернативный макет модуля
defined('_JEXEC') or die;

use Joomla\CMS\Factory;

/** @var \stdClass $module */
$wa = Factory::getApplication()->getDocument()->getWebAssetManager();

$wa->addInlineStyle('.wm-reveal{opacity:0;transform:translateY(8px);transition:opacity .4s,transform .4s}.wm-reveal.is-in{opacity:1;transform:none}');
$wa->addInlineScript('document.addEventListener("DOMContentLoaded",()=>{const io=new IntersectionObserver(es=>es.forEach(e=>{if(e.isIntersecting){e.target.classList.add("is-in");io.unobserve(e.target)}}),{threshold:.5});document.querySelectorAll(".wm-reveal").forEach(el=>io.observe(el))});');

echo '<div class="wm-reveal">' . $module->content . '</div>';

6.1 Категории и метки как рубрики

Категории Joomla образуют вложенное дерево, и в таблице хранятся границы ветвей lft и rgt; после вставки через код дерево пересчитывают методом rebuild(), а #__assets и lft/rgt руками не правят — иначе ломаются права на весь сайт [20] практика. Метки тоже иерархичны: при создании через API у метки есть parent_id, и корню соответствует единица стенд. Для новостного сайта это даёт гибкое дерево рубрик: например, метка «экономика» с вложенными «нефть» и «металлы».

Исследование автора формулирует для этого правило двух осей исследование (глава 8 «Таксономия: костяк и дерево смыслов» [10]). Категории — немногочисленный устойчивый костяк отделов: у материала она одна, и она задаёт адрес, права, процесс публикации и макет. Метки — растущая семантика: у материала их сколько угодно, они образуют дерево и общие для всех типов содержимого. Страница метки — готовая посадочная страница со своим макетом, метаданными, изображениями и уровнем доступа. Пункт меню «Материалы по метке» умеет включать потомков и выбирать режим совпадения — «все метки» или «любая из меток». Право создавать метки отбирают у авторов и оставляют редакторам отделов, иначе метки множатся дублями и опечатками. Границы названы там же: у самого материала метки выводятся плоско, а у метки нет собственного процесса публикации — только статус и версия исследование.

Ключ конфигурации unicodeslugs по умолчанию выключен стенд; пока он выключен, алиасы строятся латиницей, и русский заголовок получает транслитерированный адрес. Включённый ключ оставляет кириллицу в адресе: так устроено порождение алиаса в ArticleModel::save() исходники.

Связь материала с метками хранится в таблице #__contentitem_tag_map, а работают метки и история версий через два плагина группы behaviour — taggable и versionable стенд. Отсюда ловушка, которую рабочий гайд описывает так: метки, сохранённые из кода, молча не записываются, если до сохранения не подключены плагины поведения [20]. На стенде это воспроизводится точно стенд: статья, сохранённая через модель без подключения, получила ноль строк в карте меток; та же статья после PluginHelper::importPlugin('behaviour') получила три.

<?php
use Joomla\CMS\Plugin\PluginHelper;

define('JPATH_COMPONENT', JPATH_ADMINISTRATOR . '/components/com_content');  // нужна модели в автономном сценарии

PluginHelper::importPlugin('behaviour');    // до сохранения, иначе метки теряются

$model = $app->bootComponent('com_content')->getMVCFactory()
    ->createModel('Article', 'Administrator', ['ignore_request' => true]);

$ok = $model->save([
    'id' => 0, 'title' => 'Заголовок', 'alias' => 'zagolovok', 'articletext' => '<p>Текст</p>',
    'catid' => 8, 'state' => 1, 'access' => 1, 'language' => '*',
    'tags' => [2, 3, 4],                     // идентификаторы существующих меток
]);
$id = $ok ? (int) $model->getState('article.id') : 0;

Метки не вставляют прямым INSERT в #__contentitem_tag_map: не построится запись служебной таблицы UCM, и метка не будет работать полноценно [20] практика.

6.2 Материал из кода: форма, проверка, поля

Статья портала jpath.ru в редакции 31 июля 2024 года даёт полный порядок создания материала с настраиваемыми полями из консольного расширения [22] сторонний. Порядок такой: взять модель через фабрику компонента; получить форму материала и проверить данные; сымитировать задачу сохранения — $app->getInput()->set('task', 'save'); сохранить; затем записать значения полей моделью Field компонента com_fields, передав ID поля, ID материала и значение. Для списков и флажков со многими значениями значение передают массивом. Порядок воспроизведён на 6.1.4 консольной командой, и в нём нашлись три поправки стенд:

<?php
use Joomla\CMS\Factory;
use Joomla\CMS\User\UserFactoryInterface;

// внутри команды: в консоли константу никто не определяет
if (!\defined('JPATH_COMPONENT')) {
    \define('JPATH_COMPONENT', JPATH_ADMINISTRATOR . '/components/com_content');
}

$app   = Factory::getApplication();
$admin = Factory::getContainer()->get(UserFactoryInterface::class)->loadUserByUsername('admin');
$app->loadIdentity($admin);

$model   = $app->bootComponent('com_content')->getMVCFactory()->createModel('Article', 'Administrator', ['ignore_request' => true]);
$article = ['id' => 0, 'title' => 'Заголовок', 'alias' => '', 'introtext' => '<p>Текст</p>',
            'catid' => 8, 'state' => 0, 'language' => '*', 'access' => 1];

$form = $model->getForm($article, false);
if (!$form || !$model->validate($form, $article)) {
    // ошибка: $model->getError()
}

$app->getInput()->set('task', 'save');          // без этого пустой алиас не будет порождён
$model->save($article);
$id = (int) $model->getState('article.id');

// поля: canEditFieldValue() смотрит на Factory::getUser(), а не на loadIdentity()
Factory::getSession()->set('user', $admin);
$fields = $app->bootComponent('com_fields')->getMVCFactory()->createModel('Field', 'Administrator', ['ignore_request' => true]);
$ok = $fields->setFieldValue(2, $id, 'Интерфакс');   // номер поля, номер материала, значение

Первая поправка — константа JPATH_COMPONENT. Статья считает, что в Joomla 4 и выше её задавать не нужно; в консольной команде 6.1.4 без неё форма не грузится, потому что константу определяет только ComponentHelper::renderComponent() при веб-вызове компонента стенд исходники. Вторая касается алиаса. Имитация задачи нужна ради него: когда алиас пуст, а задача — save, модель строит его из заголовка, и при включённом ключе unicodeslugs оставляет кириллицу, а при выключенном транслитерирует исходники. Повтор того же заголовка в той же категории модель встречает ошибкой COM_CONTENT_ERROR_UNIQUE_ALIAS стенд. На стенде с одним английским языком заголовок «Статья из консольной команды» получил алиас stata-iz-konsolnoj-komandy: итог транслитерации зависит от языкового пакета сайта стенд.

Третья поправка самая коварная. Метод setFieldValue() возвращает false молча, без исключения и без сообщения, если пользователь не прошёл проверку права core.edit.value; а проверка в 6.1.4 идёт через устаревший Factory::getUser(), который в консоли не видит пользователя, загруженного loadIdentity(), даже когда это суперпользователь. На стенде помогла запись пользователя в сессию, как в примере: после неё проверка прошла, метод вернул true, и значение легло в таблицу #__fields_values стенд. Поэтому возвращаемое значение метода проверяют всегда.

Поля материала сверены с таблицей. В 6.1.4 в таблице #__content тридцать столбцов: id, asset_id, title, alias, introtext, fulltext, state, catid, created, created_by, created_by_alias, modified, modified_by, checked_out, checked_out_time, publish_up, publish_down, images, urls, attribs, version, ordering, metakey, metadesc, access, hits, metadata, featured, language, note стенд. Перечень, который статья даёт для массива сохранения, с ними совпадает; виртуальное поле articletext столбцом не служит.

6.3 Настраиваемые поля

В пакете 6.1.4 восемнадцать типов настраиваемых полей (custom fields): calendar, checkboxes, color, editor, imagelist, integer, list, media, note, number, radio, sql, subform, text, textarea, url, user, usergrouplist стенд. В 6.0 появились note и number, в 6.1 поле media научили выводить звук, видео и документы [7, 14] документация. Поле привязано к контексту — строке вида com_content.article, com_users.user, com_contact.contact: одинаковое устройство полей для статей, категорий, контактов и пользователей видно по маршрутам API, где у каждого контекста свой путь /v1/fields/… стенд.

Описания и подсказки полей — данные сайта, а не шаблона: они живут в таблицах #__fields и #__fields_values, и править их файлами шаблона нельзя, только SQL, сидером или админкой [20] практика.

Читать поля в макете. Фрагмент для Joomla 3 в авторской подборке [30] сторонний брал поля автора материала через JLoader::register('FieldsHelper', …) и JFactory::getUser(), а нужное поле выбирал по номеру в массиве. В Joomla 6 тот же приём записывается классами с пространствами имён и выбором по имени поля стенд:

<?php
// templates/<шаблон>/html/com_content/article/default.php
use Joomla\CMS\Factory;
use Joomla\CMS\User\UserFactoryInterface;
use Joomla\Component\Fields\Administrator\Helper\FieldsHelper;

$author = Factory::getContainer()->get(UserFactoryInterface::class)
    ->loadUserById((int) $this->item->created_by);

$bio = null;
foreach (FieldsHelper::getFields('com_users.user', $author, true) as $field) {
    if ($field->name === 'bio') {
        $bio = $field->value;           // значение уже подготовлено к выводу
    }
}

Третий параметр true просит подготовить значение к выводу; вернётся массив объектов с полями name, title, value стенд. Выбор по имени надёжнее выбора по номеру: порядок полей в админке меняют.

Поля в API. Значения настраиваемых полей читаются и пишутся обычными атрибутами с именем поля: PATCH с телом {"istochnik": "Reuters"} записал значение, а в ответе на GET поле пришло как istochnik — и в карточке, и в списке стенд. Создание самого поля через API требует двух вещей: явного context и непустых params; без context запись создаётся в базе с пустым контекстом, вызов отвечает 404, а «призрачное» поле остаётся и должно быть удалено вручную стенд.

Современный выбор из списка. В админских формах многострочный выбор рисуют атрибутом layout="joomla.form.field.list-fancy-select": макет есть в ядре, а за ним стоят ассеты choicesjs и webcomponent.field-fancy-select исходники. Пример для поля в XML формы:

<field name="topics" type="list" multiple="true"
       layout="joomla.form.field.list-fancy-select" label="Рубрики">
    <option value="economy">Экономика</option>
    <option value="energy">Энергетика</option>
</field>

6.4 Версии, рабочий процесс и связи

Версионирование, которое раньше охватывало только таблицу материала, в 6.0 расширено на значения настраиваемых полей, а по обучающему туру — на метки и категории; в 6.1 ту же возможность получили модули, и их экземпляры теперь можно связывать между языками [7, 14] документация. Рабочий процесс (workflow) — этапы и переходы публикации — давно есть в ядре: три плагина группы workflow называются featuring, publishing и notification стенд. В 6.1 процесс получил визуальный редактор: включают рабочие процессы в менеджере статей и ищут кнопку с диаграммой исходники. Редакционный конвейер на этих средствах собран и снят в исследовании автора (глава 7 «Конвейер новости» [10]; часть 2 «Процесс «Новости»: стадии, переходы, права» [27]) исследование. Четыре роли — репортёр, редактор отдела, корректор и главный редактор для материалов особой важности — заводятся четырьмя группами, детьми группы Registered; отделы — категориями; процесс «Новости» состоит из пяти этапов (черновик, на редактуре, на корректуре, на утверждении, опубликовано) и девяти переходов. У каждого перехода четыре вкладки: откуда и куда, действия, письма и права доступа; право «выполнить переход» раздаётся группам и решает, кто вправе опубликовать материал, а кто обязан отправить его главному редактору. Включают процессы одной настройкой компонента «Материалы» на вкладке «Интеграция»; выключить их можно в любой момент без потери содержания, потому что состояния публикации и этапы хранятся порознь исследование.

Три границы того же разбора стоит запомнить. Переходы не ветвятся по значению поля, поэтому «особая важность» — это выбор редактора или отдельная категория, а не флажок. Комментариев на полях у ядра нет, и замечания корректора живут в заметке к версии. Процесс закрепляется за материалом при первом сохранении, а сменить его потом может только суперпользователь пакетной операцией «Установить этап», поэтому категорию важного материала задают сразу исследование.

6.5 Похожие материалы

В ядре есть два готовых модуля — mod_related_items и mod_tags_similar («Похожие теги» в русском интерфейсе), который собирает блок «читать по теме» с настраиваемой близостью совпадения меток стенд исследование; прежде чем писать собственный запрос, их стоит проверить на своих данных. Рецепт из авторской подборки — «10 похожих публикаций» для Joomla 4 [31] сторонний — исходит из общих меток; его же в Joomla 6 записывают конструктором запросов (query builder) createQuery() с привязкой параметров вместо склейки строк стенд:

<?php
use Joomla\CMS\Factory;
use Joomla\Database\DatabaseInterface;
use Joomla\Database\ParameterType;

$db  = Factory::getContainer()->get(DatabaseInterface::class);
$cur = (int) $article->id;                       // текущий материал

$query = $db->createQuery()
    ->select([$db->quoteName('c.id'), $db->quoteName('c.title'),
              'COUNT(' . $db->quoteName('m2.tag_id') . ') AS ' . $db->quoteName('shared')])
    ->from($db->quoteName('#__contentitem_tag_map', 'm1'))
    ->join('INNER', $db->quoteName('#__contentitem_tag_map', 'm2')
        . ' ON ' . $db->quoteName('m2.tag_id') . ' = ' . $db->quoteName('m1.tag_id')
        . ' AND ' . $db->quoteName('m2.type_alias') . ' = ' . $db->quoteName('m1.type_alias'))
    ->join('INNER', $db->quoteName('#__content', 'c')
        . ' ON ' . $db->quoteName('c.id') . ' = ' . $db->quoteName('m2.content_item_id'))
    ->where($db->quoteName('m1.content_item_id') . ' = :cur')
    ->where($db->quoteName('m1.type_alias') . ' = ' . $db->quote('com_content.article'))
    ->where($db->quoteName('m2.content_item_id') . ' <> :cur2')
    ->where($db->quoteName('c.state') . ' = 1')
    ->group([$db->quoteName('c.id'), $db->quoteName('c.title'), $db->quoteName('c.created')])
    ->order([$db->quoteName('shared') . ' DESC', $db->quoteName('c.created') . ' DESC'])
    ->bind(':cur', $cur, ParameterType::INTEGER)
    ->bind(':cur2', $cur, ParameterType::INTEGER);

$db->setQuery($query, 0, 10);                    // не более десяти
$items = $db->loadObjectList();

На стенде для материала с метками 2, 3 и 4 запрос вернул две статьи с двумя общими метками каждая, упорядочив их по числу общих меток и по дате стенд. Ссылку к найденному материалу строит RouteHelper::getArticleRoute($id . ':' . $alias, $catid, $language): она даёт строку вида index.php?option=com_content&view=article&id=6:proba&catid=8; её пропускают через Route::_() стенд. Для боевого сайта к запросу добавляют условия по access, language, publish_up и publish_down; здесь они опущены для краткости.

6.6 Счётчики у меток и категорий

Две практические задачи портала jpath.ru — показать число материалов рядом с пунктом меню категории и рядом с меткой — решены там для Joomla 3 переопределением макетов [32] [33] сторонний. В 6.1.4 первая решается так же, а вторая требует поправки.

Пункт меню категории. Макет, который выводит пункт типа «компонент», называется modules/mod_menu/tmpl/default_component.php и в 6.1.4 существует исходники; его копию кладут в templates/<шаблон>/html/mod_menu/. Число берут у объекта категорий с включённым подсчётом стенд:

<?php
use Joomla\CMS\Categories\Categories;

$numItems = Categories::getInstance('Content', ['countItems' => 1])->get((int) $item->query['id'])->numitems;

На стенде для категории с ID 8 результат — пять; прямой подсчёт опубликованных материалов в ней дал то же число стенд. Подсчёт делает запрос к базе, поэтому его применяют к небольшому числу пунктов [32] сторонний.

Метка. Макет меток — layouts/joomla/content/tags.php исходники; его переопределяют в templates/<шаблон>/html/layouts/joomla/content/. Рецепт 2021 года вызывает TagsHelper::getTagItemsQuery($tag->tag_id, 1) статически, считая единицу ID типа содержимого [33] сторонний. В 6.1.4 статический вызов падает с ошибкой «Non-static method … cannot be called statically»: метод стал нестатическим. На экземпляре он работает, и тип по-прежнему задаётся ID — 1 или [1]; описание метода говорит об алиасах, но вызов с алиасом падает с «A key is required» стенд. К тому же рецепт делает по запросу на каждую метку. Вместо этого за один запрос получают числа для всех меток сразу стенд:

<?php
$query = $db->createQuery()
    ->select([$db->quoteName('m.tag_id'), 'COUNT(*) AS ' . $db->quoteName('n')])
    ->from($db->quoteName('#__contentitem_tag_map', 'm'))
    ->join('INNER', $db->quoteName('#__content', 'c') . ' ON ' . $db->quoteName('c.id') . ' = ' . $db->quoteName('m.content_item_id'))
    ->where($db->quoteName('m.type_alias') . ' = ' . $db->quote('com_content.article'))
    ->where($db->quoteName('c.state') . ' = 1')
    ->group($db->quoteName('m.tag_id'));

$counts = [];
foreach ($db->setQuery($query)->loadObjectList() as $row) {
    $counts[(int) $row->tag_id] = (int) $row->n;       // номер метки => число материалов
}

На стенде этот запрос вернул для меток 2, 3 и 4 числа 2, 3 и 2 стенд.

7.1 Что это и где живёт

Web Services API (веб-службы, REST-интерфейс) — отдельная точка входа api/index.php, через которую программа читает и меняет содержимое сайта без админки. Слово «API» без уточнения означает в докладе именно его; программный интерфейс самого ядра на PHP портал jpath.ru зовёт «Joomla API» и делит на API CMS, API компонентов ядра и API сторонних библиотек [19] сторонний. Адреса имеют вид /api/index.php/v1/<область>/<ресурс>. На стенде 6.1.4 ядро регистрирует 236 маршрутов: 101 для GET, 48 для POST, 45 для PATCH и 42 для DELETE стенд. В 6.2.0 тот же подсчёт даёт столько же маршрутов стенд. Маршруты приносят плагины группы webservices; в чистой установке их 18, и все включены стенд. Области охвата: материалы и категории, метки, настраиваемые поля и их группы, меню и их пункты, модули, стили шаблонов, пользователи с группами и уровнями доступа, языки и переопределения, конфигурация сайта и компонентов, расширения и плагины, обновление ядра, медиафайлы, баннеры, контакты, ленты, редиректы, сообщения и запросы о персональных данных; подробная карта дана в приложении Б.

Типичный ответ списка выглядит так стенд:

{
  "links": {"self": ".../v1/content/articles?page[limit]=2", "next": "...", "last": "..."},
  "data": [
    {"type": "articles", "id": "2",
     "attributes": {"title": "Вторая статья", "alias": "stat-2", "state": 1, "language": "*", "tags": {"2": "экономика", "3": "нефть"}},
     "relationships": {"category": {"data": {"type": "categories", "id": "8"}}}}
  ],
  "meta": {"total-pages": 2}
}

7.2 Ключ доступа: токен

Для входа через API служит группа плагинов api-authentication. В ней два плагина: token включён, basic по умолчанию выключен стенд. Токен выдаёт плагин пользователя user/token: он добавляет в профиль пользователя поля токена — включение и само значение исходники. Алгоритм прочитан в исходниках исходники:

1. При создании токена в таблице #__user_profiles для пользователя сохраняется зерно — 32 случайных байта в кодировке base64 — под ключом joomlatoken.token, а признак включения — под ключом joomlatoken.enabled.
2. Выдаваемый токен — base64 от строки алгоритм:ID_пользователя:HMAC, где HMAC вычислен от зерна секретом сайта (ключ secret в configuration.php); допустимые алгоритмы — sha256 и sha512.
3. Токен передают либо в заголовке Authorization: Bearer <токен> — слово Bearer с заглавной буквы и пробел после него обязательны, — либо в заголовке X-Joomla-Token.
4. Плагин раскодирует токен, пересчитывает HMAC по зерну пользователя и сравнивает за постоянное время, чтобы по длительности нельзя было угадать совпадение; затем проверяет, что токен включён и что пользователь состоит в разрешённой группе. По умолчанию разрешена группа 8 — в стандартной установке это Super Users.

Практические следствия исходники. Запрос выполняется от имени владельца токена, и права определяются его группами. Токен привязан к секрету сайта: если сменить secret, все выданные токены перестанут действовать — это следует из алгоритма. Токен надо хранить как пароль.

Как ведёт себя проверка, показали пробные запросы стенд: запрос без токена, с неверным токеном и с написанным строчными bearer получает 401 и тело {"errors":[{"title":"Forbidden"}]}; заголовок X-Joomla-Token с тем же токеном даёт 200.

7.3 Первые запросы

Чтение списка с постраничным выводом стенд:

TOKEN='…'     # токен из профиля пользователя
curl -s -H "Authorization: Bearer $TOKEN" -H "Accept: application/vnd.api+json" \
  "https://example.kz/api/index.php/v1/content/articles?page[limit]=2&page[offset]=0"

Создание материала. Текст передаётся в поле articletext, метки — списком идентификаторов стенд:

curl -s -X POST -H "Authorization: Bearer $TOKEN" -H "Content-Type: application/json" \
  -d '{"title":"Первая статья","alias":"pervaya","articletext":"<p>Текст</p>",
       "catid":8,"language":"*","state":1,"access":1,"tags":[2,3]}' \
  "https://example.kz/api/index.php/v1/content/articles"

Успешное создание отвечает 200, а не 201. Правка частичная: PATCH с одним полем меняет только его. Удаление двухступенчатое: опубликованный материал нельзя удалить сразу, ответ 409 с пояснением «must be trashed before it can be deleted»; сначала PATCH со state равным -2, затем DELETE, который отвечает 204 стенд. Через тот же токен работает и мобильная подача репортёра: создание материала — запрос POST /api/index.php/v1/content/articles; в исследовании автора этот путь описан как часть редакционного конвейера исследование (глава 7 «Конвейер новости» [10]).

7.4 Что умеют списки

Последняя строка — не ошибка таблицы: параметр fields[articles] в 6.1.4 список материалов не сокращает, приходят все атрибуты. Лишний вес ответа приходится резать на стороне клиента.

7.5 Ловушки API

Две оговорки о заголовке авторизации исходники: плагин ищет токен в HTTP_AUTHORIZATION, а при пустом значении — в REDIRECT_HTTP_AUTHORIZATION и, под mod_php, в apache_request_headers(). Стандартный файл htaccess.txt содержит правило, которое передаёт заголовок Authorization в PHP (E=HTTP_AUTHORIZATION) исходники; если сервер всё же убирает заголовок, остаётся запасной X-Joomla-Token.

7.6 Своя точка API

Новый маршрут добавляет плагин группы webservices: он подписывается на событие onBeforeApiRoute и просит у маршрутизатора набор CRUD-маршрутов. Подпись метода прочитана в ядре: createCRUDRoutes($baseName, $controller, $defaults = [], $publicGets = false); она создаёт чтение списка и записи, а также создание, правку и удаление, и четвёртый параметр открывает чтение без токена исходники.

Схема повторяет плагин webservices/tags из ядра; на стенде эта часть не запускалась исходники:

<?php
// plugins/webservices/zametki/src/Extension/Zametki.php
public static function getSubscribedEvents(): array
{
    return ['onBeforeApiRoute' => 'onBeforeApiRoute'];
}

public function onBeforeApiRoute(BeforeApiRouteEvent $event): void
{
    $router = $event->getRouter();
    $router->createCRUDRoutes('v1/zametki', 'zametki', ['component' => 'com_zametki']);
}

Контроллер, наследующий ApiController, и представление в формате JSON: API лежат в каталоге api/components/com_zametki/; руководство по этому вопросу есть на русском среди переводов документации [34] сторонний.

7.7 Кросс-доменные запросы (CORS)

Для API в configuration.php предусмотрены ключи cors, cors_allow_origin, cors_allow_methods и cors_allow_headers; по умолчанию cors выключен стенд. Приложение API умеет отвечать на предварительный запрос браузера (метод OPTIONS): за это отвечает метод handlePreflight() в ApiApplication исходники. Включать CORS стоит только вместе с перечнем доверенных источников, а не со звёздочкой.

7.8 Безопасность API

Все 18 плагинов webservices включены по умолчанию стенд. На сайте, где API не нужен, их отключают, а где нужен — выдают токен отдельному интеграционному пользователю с минимальными правами, а не владельцу сайта практика. Токен передают только по HTTPS и ограничивают адрес и роль пользователя; при подозрении на утечку токен отключают в профиле или меняют secret.

8.1 Команды ядра

Консольное приложение запускается файлом cli/joomla.php; в 6.1.4 и в 6.2.0 набор команд одинаков и содержит 36 именованных команд стенд.

Одна из команд требует осторожности. core:autoupdate:register регистрирует сайт в службе автоматических обновлений проекта; по тексту установщика, при регистрации проекту передаются адрес сайта, версия PHP, тип и версия базы данных, версия CMS и сведения об операционной системе исходники. Установщик Joomla предлагает автообновления при установке и позволяет отказаться от них исходники.

8.2 Планировщик

Планировщик Joomla — компонент com_scheduler с таблицей #__scheduler_tasks; в ней, среди прочего, есть признак cli_exclusive — задача только для командной строки стенд. Исполнителями служат плагины группы task: в пакете их девять — checkfiles, deleteactionlogs, globalcheckin, privacyconsent, requests, rotatelogs, sessiongc, sitestatus, updatenotification стенд. Системный плагин schedulerunner отвечает за ленивый запуск (при заходах на сайт), вебкрон и запуск по кнопке исходники; для надёжного расписания используют команду стенд:

*/5 * * * * /usr/bin/php /var/www/site/cli/joomla.php scheduler:run --all >/dev/null 2>&1

В чистой установке заведены три задачи: «Rotate Logs» (следующий запуск через месяц), «Session GC» и «Update Notification» стенд. Ключ --id у scheduler:run — ID задачи в таблице, а не порядковый номер в списке: на стенде команда --id=1 запустила не мою задачу, а «Rotate Logs», потому что ID с 1 по 3 заняты задачами ядра. Журнал исполнения пишется в administrator/logs/joomla_scheduler.php стенд. Редакции полезны две задачи по расписанию: ночная переиндексация Smart Search командой finder:index и сборка файла карты сайта. У Smart Search по умолчанию пакет индексации равен тридцати единицам, а подсказки отключают, если на сайте есть закрытые материалы исследование (глава 10 «Высокая нагрузка на практике» [10]).

8.3 Своя команда: плагин группы console

Команда живёт в плагине группы console: приложение подключает эту группу при запуске и объявляет событие application.before_execute, в ответ на которое плагин добавляет команды исходники. Заготовка из трёх файлов проверена на 6.1.4 стенд. Манифест:

<?xml version="1.0" encoding="UTF-8"?>
<extension type="plugin" group="console" method="upgrade">
    <name>plg_console_wmlab</name>
    <version>1.0.0</version>
    <description>Пример команды командной строки</description>
    <namespace path="src">Lab\Plugin\Console\Wmlab</namespace>
    <files>
        <folder plugin="wmlab">services</folder>
        <folder>src</folder>
    </files>
</extension>

Провайдер сервисов (services/provider.php). Он создаёт плагин, подаёт ему диспетчер событий и приложение; запись устроена по образцу плагинов ядра — set() с lazy(), и плагин создаётся при первом обращении стенд:

<?php
defined('_JEXEC') or die;

use Joomla\CMS\Extension\PluginInterface;
use Joomla\CMS\Factory;
use Joomla\CMS\Plugin\PluginHelper;
use Joomla\DI\Container;
use Joomla\DI\ServiceProviderInterface;
use Joomla\Event\DispatcherInterface;
use Lab\Plugin\Console\Wmlab\Extension\Wmlab;

return new class () implements ServiceProviderInterface {
    public function register(Container $container): void
    {
        $container->set(
            PluginInterface::class,
            $container->lazy(Wmlab::class, function (Container $container) {
                $plugin = new Wmlab(
                    $container->get(DispatcherInterface::class),
                    (array) PluginHelper::getPlugin('console', 'wmlab')
                );
                $plugin->setApplication(Factory::getApplication());

                return $plugin;
            })
        );
    }
};

Плагин (src/Extension/Wmlab.php) подписывается на событие и добавляет команду:

<?php
namespace Lab\Plugin\Console\Wmlab\Extension;

defined('_JEXEC') or die;

use Joomla\Application\ApplicationEvents;
use Joomla\CMS\Plugin\CMSPlugin;
use Joomla\Event\SubscriberInterface;
use Lab\Plugin\Console\Wmlab\Command\HelloCommand;

final class Wmlab extends CMSPlugin implements SubscriberInterface
{
    public static function getSubscribedEvents(): array
    {
        return [ApplicationEvents::BEFORE_EXECUTE => 'registerCommands'];
    }

    public function registerCommands(): void
    {
        $this->getApplication()->addCommand(new HelloCommand());
    }
}

Сама команда (src/Command/HelloCommand.php) в стиле команд ядра: имя задаётся свойством $defaultName, работа — в doExecute():

<?php
namespace Lab\Plugin\Console\Wmlab\Command;

defined('_JEXEC') or die;

use Joomla\CMS\Version;
use Joomla\Console\Command\AbstractCommand;
use Symfony\Component\Console\Input\InputInterface;
use Symfony\Component\Console\Input\InputOption;
use Symfony\Component\Console\Output\OutputInterface;
use Symfony\Component\Console\Style\SymfonyStyle;

final class HelloCommand extends AbstractCommand
{
    protected static $defaultName = 'wmlab:hello';

    protected function doExecute(InputInterface $input, OutputInterface $output): int
    {
        $io = new SymfonyStyle($input, $output);
        $io->success(sprintf('Привет, %s! Joomla %s', $input->getOption('name'), (new Version())->getShortVersion()));

        return 0;
    }

    protected function configure(): void
    {
        $this->setDescription('Пример команды из плагина группы console');
        $this->addOption('name', null, InputOption::VALUE_OPTIONAL, 'Имя', 'мир');
    }
}

Пакет собирают в архив, ставят командой extension:install --path=… и включают плагин; после этого команда видна в списке своей области имён и работает стенд:

$ php cli/joomla.php wmlab:hello --name=Бейбит
 [OK] Привет, Бейбит! Joomla 6.1.4

8.4 Своя задача планировщика

Плагин группы task делает три вещи: объявляет тип задачи, исполняет её и пишет в журнал. Всё остальное берёт на себя типаж TaskPluginTrait. Провайдер повторяет предыдущий с заменой группы и класса, а плагин выглядит так стенд:

<?php
namespace Lab\Plugin\Task\Wmlab\Extension;

defined('_JEXEC') or die;

use Joomla\CMS\Plugin\CMSPlugin;
use Joomla\Component\Scheduler\Administrator\Event\ExecuteTaskEvent;
use Joomla\Component\Scheduler\Administrator\Task\Status as TaskStatus;
use Joomla\Component\Scheduler\Administrator\Traits\TaskPluginTrait;
use Joomla\Event\SubscriberInterface;

final class Wmlab extends CMSPlugin implements SubscriberInterface
{
    use TaskPluginTrait;

    protected const TASKS_MAP = [
        'plg_task_wmlab_hello' => [
            'langConstPrefix' => 'PLG_TASK_WMLAB_HELLO',   // PLG_TASK_WMLAB_HELLO_TITLE и _DESC в языковом файле
            'method'          => 'hello',
        ],
    ];

    protected $autoloadLanguage = true;

    public static function getSubscribedEvents(): array
    {
        return [
            'onTaskOptionsList' => 'advertiseRoutines',
            'onExecuteTask'     => 'standardRoutineHandler',
        ];
    }

    private function hello(ExecuteTaskEvent $event): int
    {
        $this->logTask('wmlab hello task started');
        file_put_contents(JPATH_ROOT . '/tmp/wmlab-task.txt', date('c') . "\n", FILE_APPEND);

        return TaskStatus::OK;
    }
}

Языковой файл plg_task_wmlab.ini обязан содержать PLG_TASK_WMLAB_HELLO_TITLE и PLG_TASK_WMLAB_HELLO_DESC: по ним тип задачи показан в админке. Метод задачи возвращает код состояния — TaskStatus::OK или другой — и именно он попадает в счётчики. Результат на стенде стенд: задача отработала за доли секунды, в таблице стали times_executed = 1 и last_exit_code = 0, следующий запуск назначен через пять минут, а в журнал легли три строки: «Running task#04…», «Task> wmlab hello task started» и «Successfully finished task#04…». Строку задачи на стенде завели вручную записью в таблицу; в работе её создают в админке через форму «Новая задача».

9.1 Анатомия расширения

Современное расширение — каталог с манифестом, папкой services/ и папкой src/, где лежат классы с пространством имён. Манифест системного плагина, проверенный на 6.1.4, показывает все основные узлы стенд:

<?xml version="1.0" encoding="UTF-8"?>
<extension type="plugin" group="system" method="upgrade">
    <name>plg_system_wmlab</name>
    <version>1.0.0</version>
    <description>Пример: ассеты, редирект и адрес</description>
    <namespace path="src">Lab\Plugin\System\Wmlab</namespace>
    <files>
        <folder plugin="wmlab">services</folder>
        <folder>src</folder>
    </files>
    <media destination="plg_system_wmlab" folder="media">
        <folder>css</folder>
        <folder>js</folder>
    </media>
</extension>

Узел <namespace path="src"> связывает префикс с папкой и попадает в карту неймспейсов при установке; plugin="wmlab" у папки services называет файл плагина; <media> копирует ресурсы в media/<назначение>/, откуда их потом берёт менеджер ассетов. Установка из командной строки — php cli/joomla.php extension:install --path=пакет.zip; плагин по умолчанию отключён и включается в админке или командой extension:enable стенд.

9.2 Системный плагин: события, ассеты, редирект

Провайдер сервисов системного плагина повторяет провайдер консольного из предыдущей главы, с заменой группы и класса стенд. Сам плагин подписывается на два события — сборку заголовка страницы и конец маршрутизации — и показывает приёмы, которые чаще всего нужны стенд:

<?php
namespace Lab\Plugin\System\Wmlab\Extension;

defined('_JEXEC') or die;

use Joomla\CMS\Event\Application\AfterRouteEvent;
use Joomla\CMS\Event\Application\BeforeCompileHeadEvent;
use Joomla\CMS\Plugin\CMSPlugin;
use Joomla\CMS\Uri\Uri;
use Joomla\Event\SubscriberInterface;

final class Wmlab extends CMSPlugin implements SubscriberInterface
{
    public static function getSubscribedEvents(): array
    {
        return [
            'onBeforeCompileHead' => 'attachAssets',
            'onAfterRoute'        => 'probe',
        ];
    }

    public function attachAssets(BeforeCompileHeadEvent $event): void
    {
        // см. главу о Web Asset Manager
    }

    public function probe(AfterRouteEvent $event): void
    {
        $app  = $this->getApplication();
        $mode = $app->getInput()->getCmd('wmlab');

        if (!$app->isClient('site') || $mode === '') {
            return;
        }

        if ($mode === 'redirect') {
            $app->enqueueMessage('Сообщение после редиректа', 'message');
            $app->redirect(Uri::root() . 'index.php?wmlab=url', 303);
        }

        if ($mode === 'url') {
            $app->enqueueMessage('URL: ' . Uri::getInstance()->toString(), 'notice');
        }
    }
}

9.3 Редирект и адрес текущей страницы

Рецепт из авторской подборки — сообщение посетителю и редирект в Joomla 4 — в 6.1.4 остаётся верным [31] сторонний. Сигнатура метода в ядре — redirect($url, $status = 303): второй параметр есть код состояния HTTP исходники. Привычка из Joomla 3 — передавать вторым аргументом текст сообщения — теперь ломает запрос: redirect($url, 'Сообщение', 'message') на стенде дала 500 с текстом «You have not supplied a valid HTTP status code» стенд. Правильнее ставить сообщение в очередь отдельным вызовом, а в redirect передавать адрес и код стенд:

<?php
use Joomla\CMS\Factory;
use Joomla\CMS\Router\Route;

$app = Factory::getApplication();
$app->enqueueMessage('Текст, который увидит посетитель после перехода', 'message');
$app->redirect(Route::_('index.php?option=com_content&view=featured'), 303);

На стенде проверка шла с полным адресом Uri::root() . 'index.php?wmlab=url': ответ пришёл как 303 See other с заголовком Location, а на следующей странице сообщение показано стенд; для адресов с человекочитаемыми ссылками (SEF) внутренний адрес пропускают через Route::_(). Типы сообщений — message, notice, warning, error.

Адрес текущей страницы получают так стенд:

<?php
use Joomla\CMS\Uri\Uri;

$current = Uri::getInstance()->toString();    // например, http://сайт/index.php?wmlab=url
$root    = Uri::root();                       // корень сайта

9.4 База данных

Работа с базой в Joomla 6 строится на трёх правилах, и каждое подтверждено на стенде стенд. Соединение берут из контейнера по интерфейсу DatabaseInterface, а не через устаревшее Factory::getDbo(). Запрос строят вызовом $db->createQuery(); значения подставляют параметрами ->bind(':имя', $значение, ParameterType::INTEGER), а не склейкой строк; имена таблиц и столбцов оборачивают в quoteName(), префикс таблиц записывают как #__. Результат запроса читают loadResult(), loadObjectList() и их родственниками; ограничение по числу строк — вторым и третьим параметрами setQuery($query, $offset, $limit).

Для записи в таблицы компонентов гайд проекта советует поднимать классы таблиц прямо, а не через устаревшие фабрики: например, \Joomla\Component\Content\Administrator\Table\ArticleTable [20] практика; существование класса в 6.1.4 подтверждено стенд. Правила от того же гайда: после вставки категории вызывать rebuild() дерева; #__assets и столбцы lft/rgt руками не править; точечные правки на живом сайте делать SQL или админкой, а перед пакетными UPDATE снимать дамп затронутых таблиц [20] практика.

9.5 Формы

Форма пункта меню — ловушка, которая обошлась проекту дважды: форма вычищает параметры, не объявленные в XML макета. Поэтому XML каждого собственного макета должен быть полным: человеческое название (прямой строкой или константой с парой строк в .ini и .sys.ini), блок <fields name="request"> с оригинальными полями и все используемые параметры как поля формы; названия типов в окне выбора берутся из .sys.ini [20] практика. Для языковых файлов порядок загрузки таков: глобальная копия из language/xx-XX/ побеждает копию в каталоге шаблона; копию шаблона держат байт-в-байт равной глобальной, а для каждого языка заводят пару .ini и .sys.ini [20] практика.

9.6 Скрипты вне веб-контекста

Всё нужное для автономного сценария уже собрано в главе об устройстве ядра и в главе о содержимом. Остаётся напомнить три бытовых ловушки хостинга, которые, по гайду проекта, стоили часов работы [20] практика. Первая: open_basedir на панели HestiaCP режет доступ к /tmp, и путь для временных файлов задают свой. Вторая: при отладке веб-сценария меняют имя файла (seed2.php, seed3.php), иначе OPcache продолжает выдавать старый байткод. Третья: сессию в веб-режиме стартуют после присвоения Factory::$application, но до первого вывода, иначе придёт «headers already sent».

10.1 Ключи конфигурации

Главный файл настроек — configuration.php в корне сайта; его путь задаёт константа JPATH_CONFIGURATION исходники. В 6.1.4 в нём 67 ключей, и тот же набор стоит в 6.2.0 стенд. Читать и менять их можно и из консоли: php cli/joomla.php config:get sef вернёт таблицу из имени и значения, а config:set запишет новое значение стенд. Полный перечень с умолчаниями чистой установки дан в приложении А; здесь — ключи, от которых зависит безопасность.

10.2 Три вида «токена»

В Joomla слово «токен» встречается в трёх разных вещах, и путать их опасно. Первый — токен API, описанный в главе об API. Второй — токен формы: каждая страница содержит в параметрах скрипта значение csrf.token, и формы обязаны вернуть его при отправке; он живёт столько же, сколько сессия стенд. Третий — ключ доступа к обновлениям платных расширений (download key); за напоминание о нём отвечает плагин quickicon/downloadkey исходники, а к безопасности входа он отношения не имеет.

10.3 Вход: многофакторная аутентификация и ключи доступа

В 6.1.4 пять методов второго фактора — плагины группы multifactorauth: email, fixed, totp, webauthn и yubikey; плагины входа — cookie, joomla, ldap; отдельный системный плагин webauthn обслуживает беспарольный вход стенд. Основа последнего — библиотека web-auth/webauthn-lib версии 4.5.2 исходники. Руководства по WebAuthn и по многофакторной аутентификации для Joomla 4 переведены на русский и собраны на «Лунной Базе» [34] сторонний.

10.4 Капча на доказательстве работы

В пакете 6.1.4 капча одна — плагин powcaptcha с классами Extension\POWCaptcha и Provider\POWCaptchaProvider стенд; движок называют Altcha, а ассет altcha стоит в реестре библиотек [17] сторонний. Включают в два шага: разрешают плагин в списке плагинов и выбирают его капчей по умолчанию в общих настройках, то есть записывают его имя в ключ captcha исходники; в чистой установке там '0' — капчи нет стенд.

10.5 Заголовки ответа

Системный плагин httpheaders включён по умолчанию стенд. Уже на главной странице чистой установки и в ответах API видны три заголовка: X-Frame-Options: SAMEORIGIN, Referrer-Policy: strict-origin-when-cross-origin и Cross-Origin-Opener-Policy: same-origin стенд. Настройки плагина охватывают X-Frame-Options, Referrer-Policy и COOP, любые дополнительные заголовки с выбором стороны (сайт или админка), HSTS (срок, поддомены, предзагрузка) и политику безопасности содержимого: включение, область применения, режим «только отчёты», одноразовые метки nonce, хеши скриптов и стилей, strict-dynamic, frame-ancestors 'self' и собственные директивы исходники.

10.6 Обновления: TUF и автоматический режим

Защищённая доставка обновлений через TUF существует с 5.1, автоматическое обновление ядра — с 5.4 и 6.0 [7] документация. Автообновление действует только внутри мажорной ветки: переход «с 5.4 на 6.x» и «с 6.4 на 7.x» выполняют вручную в админке или внешним средством [14] документация. В консоли за это отвечают core:update:channel и пара core:autoupdate:register/unregister; про передаваемые при регистрации сведения сказано в главе о командной строке. В 6.2 к этому добавлен флаг безопасности у обновлений расширений: разработчик указывает важность от «нет» до «критической», и такие обновления подсвечиваются в списке и на значке панели управления исходники. По дорожной карте проекта поддержка безопасности ветки 4.x закончилась 14 октября 2025 года [11] документация; сайты на ней остались без исправлений безопасности.

10.7 Кто отвечает за безопасность ядра

За уязвимости ядра отвечает постоянная команда JSST — Joomla Security Strike Team: она принимает сообщения об уязвимостях, присваивает им идентификаторы CVE и выпускает исправления в плановых релизах. Отдельная политика проекта требует помечать код, написанный с помощью моделей ИИ, и запрещает слепую сдачу машинного кода без понимания; нарушители теряют доступ к репозиторию исследование (глава 2 «Что такое Joomla сегодня» [10]). Для редакции это значит, что ядро, на котором она строит сайт, проверяется людьми.

10.8 Лог действий и персональные данные

Для лога действий в ядре есть плагин actionlog и задача deleteactionlogs, для работы с персональными данными — одноимённый компонент, шесть плагинов группы privacy, плагин и задача privacyconsent стенд; запросы о данных и согласия доступны и через API по адресам /v1/privacy/requests и /v1/privacy/consents стенд.

10.9 Перечень для закалки

Короткий перечень для сайта, выходящего в работу; пункты, которые подтверждены стендом, помечены.

11.1 Кэш

Кэш Joomla настраивается ключами caching (по умолчанию 0 — выключено), cache_handler (по умолчанию file) и cachetime (по умолчанию 15 минут) стенд. Хранилищ в ядре четыре: файловое, APCu, Memcached и Redis исходники. Страничный кэш реализует системный плагин cache стенд.

11.2 Слои кэша на новостном сайте

Исследование автора описывает кэш Joomla как трёхслойный исследование (глава 10 «Высокая нагрузка на практике» [10]). Системный плагин «Кэширование страниц» хранит страницу целиком; консервативный режим кэширует вывод компонентов и тех модулей, которым кэширование разрешено; прогрессивный кэширует все модули и годится только сайтам без личных блоков. Хранилище — файлы, Redis или Memcached; в ядре 6.1.4 есть и APCu исходники. Ловушка для новостников: правка материала не сбрасывает кэш страниц, где он показан, — сброс делают вручную или через внешний слой исследование. Измерения журнала Joomla Community Magazine за апрель 2025 года, на которые опирается исследование, показали: сервер LiteSpeed снижает время до первого байта с 336 до 224 мс, а Redis в консервативном режиме ускоряет начало отрисовки с 0,9 до 0,6 с исследование. Цифры чужие и относятся к одному сайту, так что свои измерения они не заменяют.

11.3 Сессии

Сессии хранятся в базе (session_handler = database), живут lifetime = 15 минут, общей сессии между сайтами нет (shared_session = false), а метаданные сессий включены (session_metadata = true) стенд. Мусор убирают задача «Session GC» в планировщике и команды session:gc и session:metadata:gc стенд.

11.4 База данных

В таблице материалов #__content на стенде заведены индексы по первичному ключу и по столбцам access, checked_out, state, catid, created_by, language, alias, а также составной по featured и catid; в таблице меню — уникальный индекс по четвёрке client_id, parent_id, alias, language стенд. Составного индекса по state, catid и срокам публикации среди них нет. Добавлять его стоит только после измерения: сравнивают план запроса командой EXPLAIN до и после, на реальных данных сайта практика. Обсуждение #45737 в репозитории ядра, разобранное в исследовании автора, описывает сайт на Joomla 3 со 150 тыс. материалов в 1 705 категориях. Составной индекс по (catid, state) сократил там время главной страницы с 20 до 1 секунды, а замена LEFT JOIN на STRAIGHT_JOIN в выборке — время выбора двухсот материалов с 94 до 5 секунд исследование (глава 10 «Высокая нагрузка на практике» [10]). Предупреждение из того же обсуждения: индексные эксперименты, помогавшие большим сайтам, вредили обычным; поэтому измеряют до и после. Индекс поиска (таблицы #__finder_*) можно перестроить командой finder:index, и в дамп он не нужен [20] практика.

11.5 Поиск на большом сайте

Smart Search — поисковый движок на чистом PHP; для очень больших сайтов руководство советует выносить поиск в Solr. Индекс растёт с каждым материалом, а сохранение материала во время полной переиндексации может испортить индекс, поэтому полную переиндексацию ставят на ночь, в планировщик исследование (глава 10 «Высокая нагрузка на практике» [10]).

11.6 Страница и ассеты

Шаблон Cassiopeia выводит стили joomla-fontawesome ленивой загрузкой, а большинство скриптов — модулями ES; ни jQuery, ни Bootstrap JS по умолчанию не грузятся стенд. В Joomla 6 добавлен слой кэширования для разбора языковых файлов [7] документация. Адреса ассетов содержат общую версию медиафайлов, и браузер получает свежий файл после её смены стенд. Из этого складывается простой порядок экономии: не включать лишнего, подключать ассеты через менеджер, а не вставлять <script> в макеты, и измерять до и после каждой правки.

12.1 Адреса: SEF

Ключи sef (включён), sef_rewrite (выключен), sef_suffix (выключен) и unicodeslugs (выключен) определяют вид адресов стенд. Для адресов без index.php в пути нужны sef_rewrite и переписывание адресов веб-сервером; в пакете лежит заготовка htaccess.txt, которую для Apache копируют в .htaccess исходники. Основа маршрутизации — пункты меню. Ключ пункта в таблице — четвёрка client_id, parent_id, alias, language; поля menutype в нём нет стенд. Из этого рабочий гайд выводит два правила: одинаковые алиасы в разных меню конфликтуют, а пункт-псевдоним на другой пункт-псевдоним не маршрутизируется и даёт ?Itemid=N вместо человекочитаемой ссылки; реестр статей поэтому ведут по ключу «категория/алиас», потому что тёзки в разных категориях законны [20] практика.

12.2 Несколько языков

За многоязычность отвечают плагины languagefilter и languagecode, модуль mod_languages и компонент «Многоязычные связи», который связывает материалы между языками стенд. В 6.1 связи получили и модули [14] документация, а языковые переопределения — подсказку о состоянии и быстрое создание недостающих исходники. Загрузку языковых строк в 6.0 ускорил кэширующий слой [7] документация.

Для двуязычных русско-казахских сайтов автор держится трёх правил. Имена людей на казахской версии пишут казахским написанием (с буквами ә, і, ұ и отчествами на -ұлы и -қызы), на русской — русским. Казахские переводы ориентируют на лексику советского периода, а не на новейшие неологизмы, а привычные международные слова вроде «алиас» оставляют как есть. «Пошта» остаётся «пошта»: это верная казахская форма, а не новообразование практика.

12.3 Русскоязычная среда и положение в РК

Русскоязычную среду Joomla в этом смысле можно назвать экосистемой исследование (глава 13 (русскоязычная среда и положение в РК) [10]). По числу сайтов русский язык стоит на третьем месте в мире после английского и немецкого: на нём написано 12,3% сайтов на Joomla. Русская локализация ведётся на GitHub командой JPathRu; пакет для 6.0.1 вышел 25 ноября 2025 года. Портал joomlaportal.ru сам работает на Joomla 6.1.4 и публикует новости о выпусках в день выхода. Рядом работают профессиональный чат и студии со своими расширениями — WebTolk, Joomline, RadicalMart, NorrNext. Звенья поддерживают друг друга: переводчики дают интерфейс, студии — расширения под новую ветку, портал и каналы — новости и ответы.

В РК картина иная. По оценке автора, экосистемы там пока нет: есть отдельные разработчики-одиночки, но нет среды, в которой переводы, расширения и обмен опытом поддерживают друг друга практика. Это видно по фактам, которые исследование автора зафиксировало на 8 октября 2026 года исследование. Казахский пакет kk-KZ последний раз выходил для Joomla 4.4.0 в ноябре 2023 года, а для пятой и шестой веток его нет. Kaspi Pay даёт официальный эквайринг через REST API, но готовых плагинов для магазинов на Joomla в открытых источниках не нашлось; официальный модуль Freedom Pay для JoomShopping проверялся на старых версиях магазина, и совместимость с Joomla 6 не подтверждена.

Смягчение даёт само ядро: с версии 6.2 запасной язык задаётся по строкам, и русский можно назначить запасным для казахского, так что непереведённые строки интерфейса покажутся по-русски, а не по-английски исследование. Содержание при этом переводят руками: связи лишь соединяют переводы материалов, категорий, меню и, с 6.1, модулей исследование. А пробел в платёжных системах исследование записывает и как свободную нишу: кто первым напишет плагин Kaspi Pay или Freedom Pay под JoomShopping 5 либо RadicalMart, получит преимущество исследование (глава 13 (русскоязычная среда и положение в РК) [10]).

12.4 Структурированные данные

В Joomla 6 структурированными данными занимается системный плагин schemaorg и девять плагинов типов: article, blogposting, book, custom, event, jobposting, organization, person, recipe стенд. Уже на главной странице чистой установки есть блок JSON-LD с BreadcrumbList и идентификатором вида …/#/schema/BreadcrumbList/17 стенд. Метаразметки Open Graph на главной чистой установки нет: проверка нашла ноль тегов og: стенд; её добавляют шаблонным фреймворком, как это сделал T4 Framework в 2022 году [29] сторонний, или собственным плагином. Поиск по сайту — Smart Search с пятью плагинами индексации (categories, contacts, content, newsfeeds, tags), индекс перестраивает finder:index стенд.

Границу штатной разметки исследование автора нашло по исходникам ветки 6.1-dev: плагин article выводит жёстко заданный тип Article, а не NewsArticle; полей keywords и articleSection в его форме нет, и из материала плагин сам ничего не подставляет, лишь форматирует даты и картинку исследование (глава 11 «Видимость: поиск, схемы, карты сайта» [10]). Редакции, которая выпускает десятки новостей в день, остаётся выбор между готовым расширением с автозаполнением и собственным плагином типа NewsArticle, берущим keywords из меток, а articleSection из категории: архитектура плагинов типов такому плагину не мешает исследование.

Карт сайта ядро не строит. Исследование разбирает JL Sitemap — компонент, который заранее собирает карту в готовый файл sitemap.xml, так что обращение робота не нагружает базу. Версия 2.2.0 от 25 мая 2026 года пишет файлы атомарно: новая карта заменяет старую, только когда собрана целиком. Для новостной карты Google News названы OSMap, SchuWeb Sitemap и JSitemap Pro; плагин WT IndexNow извещает Яндекс и Bing о новых адресах; Quantum Manager 3.3.0 заменяет штатный Медиа-менеджер и совместим с Joomla 6 без плагина совместимости исследование (глава 11 «Видимость: поиск, схемы, карты сайта» [10]).

Для ответных систем на основе моделей ИИ автор в проектах добавляет к сборке сайта файлы llms.txt и llms.json и разметку Open Graph практика. Влияние таких мер на выдачу в этой проверке не измерялось, и доклад не обещает его.

13.1 Консоль

1. Чистый сайт одной командой. php installation/joomla.php install со всеми ключами — --site-name, --admin-user, --admin-username, --admin-password, --admin-email, --db-type, --db-host, --db-user, --db-pass, --db-name, --db-prefix, --no-interaction; так на стенде установлены обе версии стенд.
2. Публичная папка. Ключ установщика --public-folder и команда site:create-public-folder выносят публичную часть из корня с кодом стенд.
3. Список команд своей области. php cli/joomla.php list wmlab показывает только команды области wmlab; версия — php cli/joomla.php --version стенд.
4. Ключ конфигурации из консоли. config:get sef печатает таблицу «имя — значение»; у команды есть параметр --group стенд.
5. Все назревшие задачи. scheduler:run --all; задачу по ID — scheduler:run --id=N, и ID берут из scheduler:list стенд.
6. Закрыть сайт на время работ. site:down и site:up стенд.
7. Выгрузка и загрузка базы. database:export и database:import стенд.
8. Перестроить поиск. finder:index стенд.

13.2 Ассеты

1. Короткий адрес. расширение/файл — папку css или js Joomla подставит сама; лишняя папка в адресе — молчаливый отказ стенд.
2. Инлайн после файла. addInlineScript($код, ['position' => 'after'], [], ['имя.ассета']) выводит код сразу за нужным скриптом стенд.
3. Подмена адреса чужого скрипта. Зарегистрировать ассет с тем же именем и другим адресом, например с CDN: позднее определение перекрывает раннее [23] документация.
4. Отключить ненужное. disableScript('jquery-noconflict'); но если от ассета зависят другие, он включится снова [23] документация.
5. Свежий файл после правки. Пересохранить общие настройки: меняется общая версия медиафайлов, и браузеры берут новые адреса [20] практика.
6. Bootstrap точечно. useScript('bootstrap.tab') вместо подключения всего пакета; по умолчанию Bootstrap JS не грузится стенд.

13.3 API

1. Заголовок на запас. Если сервер глотает Authorization, токен передают в X-Joomla-Token стенд.
2. Постраничный вывод. page[limit] и page[offset], число страниц — в meta.total-pages стенд.
3. Метки через API. В теле нужны parent_id (корень — 1) и description (хотя бы пустая строка) стенд.
4. Значения полей по имени. PATCH {"имя_поля": "значение"} стенд.
5. Удалить материал. Сначала state: -2, затем DELETE стенд.

13.4 Данные и поля

1. Метки из кода. До сохранения — PluginHelper::importPlugin('behaviour') стенд.
2. Модель в автономном сценарии. Задать JPATH_COMPONENT стенд.
3. Слаг вручную. Строку id:alias собирают сами, если модель списка её не отдаёт стенд практика.
4. Похожие материалы. Сначала проверить mod_tags_similar, потом писать запрос по общим меткам стенд.
5. Поля автора в статье. FieldsHelper::getFields('com_users.user', $user, true) и выбор по имени стенд.
6. Современный выбор из списка. layout="joomla.form.field.list-fancy-select" исходники.
7. Значение поля из консоли. Перед setFieldValue() положить пользователя в сессию — Factory::getSession()->set('user', $user) — и проверить возвращаемое значение стенд.
8. Алиас из заголовка. Модель строит его только при пустом алиасе и задаче save исходники; на русских заголовках сверяют транслитерацию с языковым пакетом сайта стенд.
9. Счётчик у меток одним запросом. Группировка по tag_id по таблице карты меток вместо запроса на каждую метку стенд.

13.5 Шаблон

1. Свои стили и скрипты без дочернего шаблона. media/templates/site/cassiopeia/css/user.css и js/user.js подключаются ассетами template.user исходники.
2. Цвет для одной страницы. CSS-класс страницы в параметрах пункта меню плюс переопределение --cassiopeia-color-primary под этим классом [26] сторонний.
3. Раскладка блога. Классы boxed, image-left, image-right, image-alternate, columns-2…4, masonry-2…4 в параметрах пункта меню «Блог категории» исходники.
4. Перестановка позиций. grid-template-areas для .site-grid в user.css [26] сторонний.
5. Подвал без «сделано на Joomla». Переопределить константы MOD_FOOTER_LINE1 и MOD_FOOTER_LINE2 [26] сторонний.
6. Альтернативный макет модуля. Копия default.php под другим именем в html/<модуль>/ [26] сторонний.
7. Вид модуля. Шесть стилей — card, noCard, html5, none, outline, table — лежат в каталогах chromes стенд; по статье 2022 года outline выводит имя позиции и стиля для отладки [26] сторонний.

13.6 Обновление и совместимость

1. Прогон на копии с выключенным compat6. Если шаблон и расширения работают при выключенном плагине совместимости, сайт готов к будущему без него документация практика.
2. Перед ядром — расширения. update:extensions:check стенд.
3. Снимок базы. database:export стенд.
4. Сверка переопределений. Значок «Joomla! Overrides Update Notification» на панели управления при включённом плагине installer/override стенд.

13.7 Редакция и нагрузка

Приёмы из исследования автора (глава 7 «Конвейер новости» [10]; глава 10 «Высокая нагрузка на практике» [10]; часть 2 «Процесс «Новости»: стадии, переходы, права» [27]).

1. Свои группы вместо штатных. Штатные Author, Editor и Publisher не трогают, а заводят четыре своих группы детьми Registered: так права не наследуются от чужих ролей исследование.
2. Процессы включаются одной настройкой. Материалы → Настройки → вкладка «Интеграция»; по умолчанию они выключены исследование.
3. Категория — сразу и правильно. Процесс закрепляется за материалом при первом сохранении; сменить его потом может только суперпользователь пакетной операцией «Сменить этап» исследование.
4. Черновик на глазах у автора. Чтобы репортёр видел на сайте собственный неопубликованный материал, его группу включают в уровень доступа Special или в свой уровень «Редакция» исследование.
5. Метки — только редакторам отделов. Право создавать метки отбирают у авторов исследование.
6. Своё меню админки на роль. Меню типа «администратор», связанный модуль в позиции menu и пункт «Контейнер меню компонентов»; штатный контейнер остаётся частью меню — исследование называет это «неизбежным дублированием» исследование.
7. Очередь корректора — один фильтр. Колонка «Этап» в списке материалов и фильтр по этапу «На корректуре» исследование.
8. Ночная переиндексация. finder:index по расписанию исследование.
9. Составной индекс на большом архиве. (catid, state) — после измерения на копии исследование.
10. Страничный кэш сам не сбрасывается. После правки материала нужен ручной сброс или внешний слой исследование.

14.1 Кейс 1. Рабочий гайд проекта TAMGARD/wmarka

Первый кейс — свод знаний, собранный в работе над сайтом TAMGARD и шаблоном wmarka [20] практика. Гайд написан на стенде с Joomla 6.1.2, PHP 8.4 и панелью HestiaCP; на стенде 53 материала, 12 категорий, 12 настраиваемых полей с 144 значениями. Для доклада он ценен тем, что фиксирует находки, которых нет в документации, и каждая либо подтверждена проверкой на 6.1.4, либо остаётся наблюдением автора.

Архитектура сидера. Центральная часть гайда — установщик контента для чистых стендов, и его четыре принципа применимы к любому проекту. Первый — идемпотентность: повторный прогон не плодит дубли, потому что записи сверяются по ключу «категория/алиас» для статей и по четвёрке (client, parent, alias, lang) для меню. Второй — строгий порядок: категории, поля (с описаниями), статьи (с метками), контакт, меню (включая скрытые дочерние маршруты и страницы рубрик), модули, привязки, стиль шаблона. Третий — два режима запуска: из консоли (php cli/seed-tamgard.php) и из веба (ключ, run, файл-флаг .done и force), второй спасает на хостинге без SSH. Четвёртый — данные отдельно от кода: источником правды служит articles.json, а сидер лишь применяет его.

Железное правило эксплуатации. На живом сайте с ручными правками сидер не перезапускают: он двигает пункты меню методом setLocation в положение «последний потомок» и откатывает контент. Сидер — установщик чистых стендов; всё точечное делают SQL или админкой, а перед выходом в работу из веб-корня удаляют cli/seed-*.php и cli/tamgard-seed/ [20] практика.

Выгрузка данных. Полный дамп базы в JSON — каждая таблица массивом строк — читается скриптом без разбора диалекта SQL, поэтому гайд берёт его для аналитических выгрузок. Две подробности из гайда. При чистке HTML сначала выбрасывают атрибуты в тегах (uk-*, data-*) и только потом снимают сами теги; в обратном порядке содержимое атрибутов, как uk-scrollspy="target: > div; cls: uk-animation-fade", протаскивается в текст выгрузки. Поля images, attribs, params и metadata — JSON-строки внутри строки; их разбирают, а не режут регулярным выражением [20] практика.

14.2 Кейс 2. Перенос прототипа на штатные средства Joomla

Второй кейс — документ о том, что вернуть на штатные средства при переносе страничного прототипа в шаблон Joomla [35] практика. Прототип работал в среде, которая перестраивала разметку и откатывала изменения узлов, описанных в шаблоне; в Joomla разметка статична, и три обходных приёма снимаются.

Два правила из этого документа стоят отдельного упоминания. Первое касается обводки знаков: non-scaling-stroke применяют только к знакам одного кегля — к интерфейсному набору в 22 пикселя; знаки, живущие в нескольких размерах, имеют пропорциональную обводку в долях сетки, и при переносе это решение сохраняется. Второе — три предохранителя, написанные после того, как механические замены шесть раз задели то, что не следовало:

• замена по стилевому файлу должна обходить блок :root: глобальная замена литералов однажды переписала сами токены палитры самоссылками вида --blue: var(--blue) и обрушила цвет на всех страницах;
• перед заведением токена проверяют, свободно ли его имя и в теме, и в страничных стилях: имя --on-blue-dim уже занимала голубая метка, и новая роль её перекрыла;
• сверяют разметку листов деки и её печатной версии по закрытому списку допустимых различий.

Там же стоит урок о счёте: окна текста вместо разбора дерева по стеку тегов заставляли счёт нарушений врать — прямых потомков, которые не ячейки, выходило 107 вместо 40, карточек без тела 64 вместо 5, алиасов 343 вместо 5 [35] практика.

14.3 Кейс 3. bestnews.kz: сайт на собственных расширениях

Третий кейс — спортивный новостной сайт bestnews.kz, созданный автором с самого начала проекта на собственном шаблоне wmarka и UIkit 3 практика. Сторонних расширений на нём почти нет: это JUImage для адаптивных изображений и Quantum Manager; остальное — собственные плагины и макеты. Галерея и универсальная видеогалерея работают как плагины поверх настраиваемых полей материала, а главная страница почти целиком собрана из собственных переопределений mod_custom. Для перехода на Joomla 6 это выгодное положение: чужого кода, который нужно проверять, мало. Шаблон wmarka и его дочерние шаблоны доводят до работы на Joomla 6 с выключенным плагином совместимости, проверяя на копии сайта практика.

Отдельный узел кейса — центр матчей КХЛ на двух пользовательских HTML-модулях. Шесть PHP-файлов (настройки, команды, помощник, карточка матча и две раскладки) берут данные из открытых спортивных источников и держат их в кэше по схеме «отдать старое, пока обновляется новое» с ручным обновлением по токену и диагностической точкой. Из багов центра вытекают уроки, годные далеко за пределами хоккея практика:

• читать таблицу по подписям столбцов, а не по их номеру: цифры очков принимались за голы, когда порядок столбцов отличался от ожидаемого;
• сопоставлять метки точно, а не подстрокой: короткое имя столбца совпадало с другим, более длинным;
• вести цикл по источнику, пока не собраны и сыгранные, и предстоящие матчи: иначе вкладка результатов теряла сыгранные;
• ограничивать разбор якорем заголовка лиги, чтобы фарм-клубы из соседнего турнира не просачивались в результаты;
• брать за образец реальную разметку источника, а не предположение о ней: проверка на настоящей странице была решающим приёмом при каждой поломке.

Правило сайта, которое пригодится любому, кто режет изображения через JUImage: каждая нарезка должна ложиться в папку img/ в корне сайта, а не в cache/; часть переопределений mod_custom это нарушала, и после правки правило стало проверяемым практика.

14.4 Кейс 4. Рецепты 2021–2022 годов и их судьба на 6.1.4

Четвёртый кейс — проверка присланной автором подборки рецептов для Joomla 3 и 4, в том числе статей портала jpath.ru: насколько они живы в Joomla 6. Оговорка: все четыре статьи раздела «Практические решения» помечены на самом портале словом «Устарело» [36]. Результат сводит таблица стенд.

14.5 Кейс 5. Редакционный конвейер на чистой Joomla 6.1.4

Пятый кейс — разбор редакционного процесса с четырьмя ролями, собранный и снятый на чистой Joomla 6.1.4 без единого стороннего расширения [27] исследование. Установка шла из пакета с GitHub через консольный установщик, как и стенд этого доклада; русский пакет — ru-RU 6.1.4.1 команды JPathRu. В разборе 36 снимков в пяти частях: основа (группы, уровень доступа «Редакция», включение процессов); процесс «Новости» (этапы, переходы, письма, права); админка глазами каждой из четырёх ролей; те же права в лицевых формах; дочерние шаблоны и стили (часть 1 «Основа: кто есть кто» [27]; часть 3 «Глазами каждой роли» [27]; часть 4 «Лицевая сторона» [27]).

Из наблюдений разбора читателю этого доклада пригодятся три. Админка не «урезается» отдельным режимом: шаблон Atum сам читает права группы, и у репортёра в меню остаётся один раздел, у корректора два, у главного редактора всё редакционное, кроме «Системы». Один и тот же этап даёт разным ролям разные кнопки: на корректуре редактору доступны «Опубликовать» и «На утверждение главреду», а корректору только «Вернуть редактору». И одно расхождение с документацией: руководство, написанное для ветки 4.x, помещает поле этапа лицевой формы на вкладку «Публикация», а в 6.1.4 оно стоит на вкладке «Параметры» исследование. Чего разбор не делал, он называет прямо: собственное меню админки на роль не настраивалось.

14.6 Кейс 6. Живые порталы на Joomla

Шестой кейс — перечень новостных порталов, которые на 8 октября 2026 года, по карточкам сервиса W3Techs, работают на Joomla [10] исследование. Версию определяют по тегу generator, который легко скрыть, поэтому перечень нельзя считать полным.

Jutarnji list — второй по посещаемости новостной сайт Хорватии, а Slobodna Dalmacija — вторая газета того же издательского дома; два главных портала одной медиагруппы на одной платформе убеждают сильнее любых рекламных страниц. У таблицы два урока для этого доклада. Все найденные крупные порталы работают ещё на ветке 3.x — это предупреждение редакциям, которые не закладывают обновления в бюджет. И большинство из них стоит за сетями доставки содержимого. В исследовании есть и казахстанский штрих: 4 июля 2011 года Tengrinews сообщал, что государственная компания KazContent строит сайты региональных печатных изданий на Joomla — десять готовы, шестнадцать в работе, редакции платят лишь за домен исследование (глава 12 «Живые порталы на Joomla» [10]).

14.7 Методы jpath.ru: что изменилось и что правильнее

Таблица собрана по статьям портала jpath.ru, которые вошли в доклад, и сверена с 6.1.4. В правом столбце названо то, что правильнее сегодня; это не утверждение, что иначе нельзя: часть старых способов работает и теперь.