Использование плагина MiniCCK

Установка.

• Установить и опубликовать плагин "Контент - MiniCCK".

Настройка.

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

Каждому полю необходимо прописать:

• Название поля - служебное название, состоящее только из латинских букв, цифр и знака подчеркивания _ в нижнем регистре. Другие символы не допустимы, включая пробел.
• Заголовок поля - Это тот заголовок, что увидите вы в панели администрирования в дополнительных полях контента и пользователь на фронте вашего сайта. Для многоязычных сайтов сюда можно вписвывать языковые константы, которые будут обработаны в соответствии с языком контента.
• Тип поля - выпадающий список, где вам необходимо выбрать тип создваемого поля. Эта устновка определяет как будет выглядеть поле в административной части сайта, на фронте выведется информация выбранная или введенная вами.
• Параметры поля - это поле для введения дополнительных параметров для поля контента. Действует оно только для типов поля типа Выпадающий список, Радиокнопки, Чекбокс. Вводить сюда нужно пары ключ-значение через разделитель двойное двоеточие (::) каждую следующую пару на следующей строке. Для поля типа "изображение" сюда вводится путь от корневой папки изображений, объявленной в настройках медиаменеджера без переднего и заднего слеша. Это всего-лишь папка по умолчанию, пользователь сможет перейти к верхним папкам до корня медиаменеджера.

Удалить поле можно кнопкой "Удалить поле" расположенной напротив каждого поля.

Работа

В панели редактирования контента в компоненте com_content, после установки и настройки плагина и патча, в правой части снизу появится вкладка "Дополнительные поля" в которой вам предстоит ввести или выбрать значения для созданных вами полей. После сохранения контента при просмотре контента с фронта сайта там появится ваша дополнительная информация.

Варианты вывода полей

С версии 1.3 в плагине предусмотрено два способа вывода дополнительных полей:

• Способ "HTML" реализует обычный вывод присоединением шаблона плагина к тексту контента, так как было и в прошлых выпусках плагина.
• Способ "Объект" гораздо более гибок, но предназначен для профессионалов т.к. он не имеет собственного представления, а добавляет объект MiniCCK к объекту $article, что позволяет оперировать полями плагина в самом шаблоне com_content. Это добавляет непревзойденную гибкость в выводе полей - вы можете вывести любое поле плагина в любом месте шаблона контента, но требует от вебмастера навыков работы с шаблонами.

Для вывода полей плагина "Объектом" предусмотрено две функции - вывод заголовка поля и вывод значения поля. В шаблоне контента их можно вызывать так:

//в контенте
$this->item->minicck->getFieldLabel('field_name');
$this->item->minicck->getFieldValue($this->item->id, 'field_name');

С версии 2.2 доступна функция запроса типа контента (тип контента полезно знать для переключения макетов вывода и т.п.) и функция запроса чистых данных поля.

Тип контента можно получить так:

$this->item->minicck->getArticleType($this->item->id);

Чистые данные поля можно получить так:

$this->item->minicck->getFieldData($this->item->id, "field_name");

Получить ассоциативный массив всех полей материала можно так:

$this->item->minicck->getArticleFieldsArray($this->item->id);

Переопределение шаблонов

С версии 1.4 появились шаблоны полей (не путать с общим шаблоном плагина), а так-же возможность переопределения их в шаблоне Joomla.

Для переопределения основного шаблона плагина надо скопировать его из

/plugins/system/minicck/tmpl/название_шаблона.php

в

/templates/шаблон_сайта/html/plg_system_minicck/название_шаблона.php

После этого плагин будет использовать шаблон, находящийся в папке шаблона сайта. Так-жеможно поступить и с шаблонами полей. Копируем

/plugins/system/minicck/fields/папка_поля/tmpl/default.php

в

/templates/шаблон_сайта/html/plg_system_minicck/fields/папка_поля/default.php

После переопределения шаблонов полей и основного шаблона плагина вы смело можете их модернизировать, не боясь что они зартутся при обновлении.

Изменения в версии 3.0.

В версии 3.0. добавились дополнительные поля для категорий. Действия с ними аналогичны действиям с полями контента, за исключеним небольших нюансов при выводе полей объектом.

Плагин MiniCCK запускается непосредственно в шаблоне категории. Там описание категории выводится с обработкой контентными плагинами:

echo JHtml::_('content.prepare', $child->description, '', 'com_content.category');

В следствие этого дополнительные поля у категории не появятся раньше этой строки. Если вы хотите выводить поля раньше описания, то вам следует эту строку вместо echo присвоить переменной в шапке файла или непосредственно в начале цикла перебора категорий (в зависимости от макета). Тогда использовать поля можно будет по всему макету категории. Для использования дополнительных полей вы должны загрузить MiniCCK:

$minicck = MiniCCKCategoryData::getInstance()->getObject($categoryId);

Далее вы можете использовать $minicck аналогично контенту. Для примера выведем форматированное поле:

echo $minicck->getFieldValue($categoryId, 'field_3');

Таким-же образом доступны и другие функции работы с дополнительными полями категорий.