WT Article Select

Описание

WT Article Select — это плагин пользовательского поля Joomla для выбора материала через стандартное модальное окно выбора статьи. Плагин предназначен для работы в контексте пользовательских полей и расширяет стандартное поведение поля возможностью загружать дополнительные данные выбранного материала во время рендеринга, а именно полный объект материала и пользовательские поля материала.

Возможности плагина

Плагин позволяет выбрать материал Joomla в качестве значения custom field и использовать это значение в макете поля как ссылку на материал. При необходимости плагин может дополнительно загрузить полный объект материала и пользовательские поля выбранного материала.

Параметры плагина

• Загружать данные материала? Если включено, во время подготовки поля загружается полный объект выбранного материала и передаётся в $field->article.
• Загружать поля материала? Если включено, загружаются пользовательские поля выбранного материала и передаются в $field->jcfields.
• Показывать кнопку создания материала? Если включено, в административной форме поле может открывать стандартное окно Joomla для создания нового материала.
• Показывать кнопку редактирования материала? Если включено, в административной форме поле может открывать стандартное окно Joomla для редактирования выбранного материала.

Параметры поля

На уровне конкретного поля доступны те же четыре параметра. Для каждого из них можно выбрать собственное значение или оставить режим использования глобальных параметров плагина.

Контракт данных при рендеринге

• $field->value содержит ссылку на выбранный материал.
• $field->rawvalue содержит исходное сохранённое значение поля.
• $field->article_id содержит идентификатор выбранного материала.
• $field->article_title содержит заголовок материала для вывода ссылки.
• $field->article содержит полный объект материала, если включён параметр загрузки данных материала.
• $field->jcfields содержит пользовательские поля материала, если включён параметр загрузки полей материала.

Поведение макета по умолчанию

Макет поля по умолчанию выводит ссылку на материал даже в том случае, когда загрузка полного объекта материала и его пользовательских полей отключена. Для построения ссылки используются подготовленные runtime-данные плагина.

Как происходит рендер пользовательских полей в Joomla?

Эта небольшая статья рассказывает о том, как происходит рендеринг пользовательских полей "под капотом" Joomla. Информация будет Вам полезна для создания переопределений и вёрстки своего вывода полей в Ваших новых проектах. А также упростит поиск и поддержку сайтов на Joomla, пришедших от других разработчиков.

Подробности

Использование в админке

Поле использует core-тип modal_article и опирается на стандартный интерфейс Joomla. Если включены соответствующие параметры и позволяют ACL-права, в форме могут отображаться кнопки создания и редактирования материала.