SEBLOD - Конструктор контента (CCK) для Joomla. Часть 5. Типы поиска

В прошлой статье серии мы рассмотрели, что такое типы контента Seblod. Кроме создания и просмотра контента, для максимально гибкого управления требуется также его фильтрация. Seblod позволяет фильтровать контент очень гибко. Если в Joomla мы имеем фильтрацию только по категориям, то через Seblod мы можем фильтровать материалы практически по любому полю, которое в них используется. Также нам доступны различные условия фильтрации(больше, меньше, равно, и.т.д).

Для фильтрации в Seblod служат типы поиска. О том как создавать типы поиска Seblod, настраивать их и управлять фильтрацией контента я расскажу в этой статье.

Типы поиска SEBLOD. Вступление

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

Что мы можем искать? Да что угодно, и даже больше! Тип поиска может использоваться не только для того, чтобы отфильтровать материалы по автору или категории. Мы можем получить все материалы автора. Дать возможность автору редактировать свои материалы, выбирая из списка, а не как в стандартной Joomla, ковыряясь во всех материалах и выискивая иконки редактирования около своих.

Также тип поиска может использоваться для создания различных модулей. Например, модуля последних новостей. Для его создания нужно просто создать тип поиска, сортирующий материалы по дате добавления(публикации). При этом можно добавить фильтр по категориям, автору и т.д.(пример: последние новости от user’а №1). Если раньше вам приходилось искать по несколько дней подходящий модуль, то теперь достаточно просто правильно настроить тип поиска и вывести его в оболочку модуля. Я не говорю, что всё совсем просто, нет. Чтобы использовать мощь SEBLOD на 100%, нужно обладать широкими знаниями как самого компонента, так и HTML, CSS, PHP. Ну да ладно, ближе к делу. Рассмотрим, как работает тип поиска Seblod.

Менеджер списков и типов поиска

Перейдя в «Seblod» –> «Lists & Search Types», мы попадем в менеджер списков и типов поиска.

Данный менеджер похож на менеджер типов контента и форм. Изначально он имеет три типа поиска – по статьям, по категориям и по пользователям.

Создадим новый тип поиска, кликнув по кнопке «Создать». Перед нами откроется всплывающее окно, позволяющее указать, по какому типу контента мы собирается искать, и выбрать шаблон будущего поиска. К сожалению, эта опция пока не работает . Впрочем, шаблон можно потом и переопределить, рассмотрим переопределение шаблона позже.

После выбора типа контента жмем кнопку «Create List & Search Type» и видим следующее окно:

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

• Search Form – форма поиска. В ней мы задаем поля, по которым будет производится поиск.
• Order – поля, по которым будет производится сортировка результатов поиска. Теоретически, поля, заданные в этой вкладке, должны сортировать результаты поиска. Т.е. вместе с результатами должна появляться некая форма «Сортировать по:», но таковой я получить так и не смог. Не совсем понятно, или это недоработка, которую устранят в следующих версиях, или какая-то хитрая сортировка по умолчанию.
• List – шаблон результатов поиска, когда результаты выводятся в виде списка.
• Item – шаблон результатов поиска, когда результаты выводятся в виде блога.

Здесь нужно чуть подробнее остановиться на том, что же такое List и Item. Искушенным Joomla’водам значение этих терминов должно быть понятно сразу. Тем же, кто не так давно знаком с Joomla, объясню.

Представим, что у нас есть категория с новостями. Как мы можем показать ее? Очевидно, что должен быть показан список новостей, но в каком виде? В Joomla есть два основных вида отображения для материалов категории: «Блог» и «Список». Блог показывает каждый материал с заголовком и вступительным текстом, точно также, как на главной странице этого сайта. Список показывает заголовки материалов в виде таблицы или маркированного списка, т.к. просто список ссылок(как в карте сайта).

Теперь вернемся к Seblod. Для результатов поиска он имеет такие же виды отображения, что и Joomla, но… Seblod позволяет настраивать эти виды настолько гибко, что мы может получить практически любой вид отображения. По умолчанию виды отображения работают так:

• Шаблон «Блог» (seb_blog) выводит для каждого материала списка шаблон контента(по умолчанию seb_one).
• Шаблон «Список» (seb_table) выводит таблицу, в строках которой имеется список материалов, а в столбцах параметры этих материалов (поля типа контента Seblod).

Чувствую, что описание получается сложным, поэтому приведу пример. Сейчас мы работаем над одним сайтом, некоторые страницы которого хорошо иллюстрируют шаблоны «Блог» и «Список». Вот пример шаблона «Блог»:

Он используется для того, чтобы вывести материалы (каждая фотография является материалом) на страницу категории.

А вот пример шаблона «Список»:

Он используется для того, чтобы показать пользователю все материалы (фотографии), которые он добавил. Здесь же имеется ссылка на редактирование данных. И то и другое – типы поиска Seblod.

Изначально, когда вы только создали тип поиска, вкладка Item(Блог) неактивна. Почему? Потому, что по умолчанию установлен шаблон List(Список). В одном типе поиска вы можете использовать только один шаблон вывода результатов. Чтобы его переопределить, нужно перейти в левых вкладках на «List», а в правых на «Template». После этого, нужный шаблон можно выбрать в опции «Template»:

Если вы выберите seb_blog и сохраните тип поиска/перейдете на другую вкладку, то увидите, что вкладка «Item» стала активной. При этом вкладка List также остается активной, но поля, заданные на ней, не будут иметь никакого значения.

Перейдем к трем правым вкладкам менеджера списков и типов поиска. Здесь мы видим:

• Configuration – здесь мы можем настроить некоторые опции типа поиска. Например, количество материалов на страницу, сообщение о том, что результаты не найдены, заголовок и др;
• Fields – здесь мы задаем поля, по которым будет производиться поиск, сортировка, и которые будут отображаться в результатах поиска;
• Template – здесь мы выбираем и настраиваем шаблон списка материалов(результатов поиска).

Основная вкладка, с которой мы будет работать, это «Fields». Именно в ней проводится большинство настроек поиска.

Создание типа поиска

Всё, что было описано про Seblod раньше, было очень простым материалом. По-настоящему сложно будет тогда, когда вы начнете настраивать типы поиска. По своей сути, тип поиска – это конструктор SQL-запроса. Иногда бывает так, что проще написать SQL-запрос, чем сконструировать его. Но не стоит сильно пугаться, всё познается, и конструктор тоже.

Так как же нам создать поиск? Для начала нужно определиться, для чего он нам, собственно, нужен. Типы поиска Seblod решают очень широкий круг задач. С их помощью мы можем не только создать форму поиска для посетителей сайта, но также создавать огромное количество различных модулей, как, например, модуль последних/лучших/случайных новостей, слайдшоу, последние посетители сайта, лучшие материалы сайта, наиболее просматриваемые материалы сайта, рейтинг пользователей сайта и многое другое. Кроме модулей мы можем создавать фильтры и списки. К примеру мы создаем меню «Архив», в котором есть пункты, соответствующие разным годам:

• 2008
• 2009
• 2010
• 2011
• 2012

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

После того, как мы определились с целью нашего типа поиска, мы начинаем строить его. Для этого прежде всего создаем форму поиска(вкладка «Site Form»). В форме поиска уже есть одно добавленное поле – CCK. Оно требуется для того, чтобы искать только по выбранному типу контента, не затрагивая остальные. Данное поле является как бы служебным и на первых парах его вообще не следует трогать. Далее начинаются сложности. У новичков много вопросов. Как искать? По каким полям? Как ограничить результаты и.т.д. Я сам, когда только разбирался с типами поиска, сильно путался в способе фильтрации. Теперь придумал для себя некий образ, который помогает упростить работу по составлению поискового фильтра. Делюсь..

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

Предположим, что нам нужно получить список последних новостей сайта. Все новости хранятся в отдельной категории «Новости». Как нам правильно составить фильтр? Легко! Из всех материалов данного типа контента нам нужно выбрать те, которые принадлежат к категории «Новости». Как это сделать? К нашему фильтру мы добавим поле «Article Category Id», означающее ID категории, к которой принадлежат материалы.

Теперь наш тип поиска работает следующим образом: мы выбираем из выпадающего списка категорию, жмем «Найти» и получаем список всех материалов категории. Но это не совсем то, что было нам нужно. Мы хотим видеть не форму с выбором категории а только материалы определенной категории. Как этого добиться? Здесь нам помогут дополнительные опции, расположенные под цифрами от 1 до 6.

Search Form

Кнопка №1

– Label– заголовок поля. Отображается перед полем ввода.

– Variation – вид формы. Само поле может быть скрытым (Hidden), когда форма не видна; просто величиной, которая уже введена в форме (Value), обычной формой для ввода значений (Default); формой для фильтрации (Filter); формой в которую нельзя вводить данные, а можно только видеть то, что там уже введено (Readonly).

Кнопка №2

– Live – если в форму требуется подставить «живое» значение, т.е. такое, которое будет автоматически изменяться в зависимости от каких-то условий, то здесь можно выбрать место, из которого это значение будет браться. На данный момент здесь имеются опции Default (по умолчанию задается в Live Value или вводится пользователем при заполнении формы), Stage (значение задается в окне, которое появляется при клике по ссылке Configure), User (значение так же задается в окне, которое появляется при клике по ссылке Configure, информация берется из данных текущего (авторизованного) пользователя, которые есть в базе данных); Variable (значение так же задаются во всплывающем окне).

– Live Value – значение/переменная для Live, либо ссылка Configure на окно конфигурирования значений.

Кнопка №3

– Match – здесь задаются ограничения для значений поля. Мы можем выбрать точное совпадение, совпадение по любому из слов, задать неравенства(значение в поле больше, меньше какого-либо числа) и многое другое. При выборе конкретного значения справа появляется значек "+", при нажатие на который мы переходим в окно настройки.

–Stage – уровень фильтрации. Это самая сложная опция, которая позволяет выполнить подзапрос и передать его результат в основной запрос. Она может пригодиться, например, когда какое-то значение для Live Value нельзя получить явно. В этом случае мы сначала выполняем поиск этого значения, а затем подставляем его в Live Value и выполняем основной поиск. Пример использования данной опции есть на официальном форуме Seblod.

Кнопка №4

– Access – уровень доступа к данному полю. Т.е. поле смогут увидеть только те пользователи, которые принадлежат группам, имеющим уровень доступа, выставленный здесь.

– Restriction – ограничение на расположение и действие. Если выбрать Workflow, справа появится знак "+", кликнув на который перейдем к форме выбора – только в административной части показывать поле, или на сайте, или на обоих (Both), и какие действия (Action) совершать – допускать только добавление информации в поле, только редактирование, или оба действия.

Кнопка №5

– Conditional States – зависимости одного поля от другого. Если мы нажмем Add, то сможем показать/скрыть/отключить/применить класс к полю, когда другое поле из этого же типа контента примет определенное значение.

Кнопка №6

– Markup – разметка. Позволяет оформить поле, используя CSS или предопределенные стили.
– Markup Class – стиль разметки разметка. Позволяет задать полю дополнительный CSS-класс.

Кнопка №7

– Required/Validation – при клике на ссылку Optional можно установить, обязательное или нет поле для заполнения. Тут же можно ввести подсказку, которая будет всплывать во время заполнения (Required). Для проверки того, что пользователи ввели в форме, используется Validation. В правом поле можно ввести сообщение об ошибке, если пользователь ввел неправильные данные.

Это все опции вкладки Search Form. Вернемся к нашему списку последних новостей.

Для того, чтобы показать только материалы определенной категории, нам нужно задать для поля категории «живое» значение и скрыть форму выбора категории.

Для поля Article Category Id задаем:

– Variation – Hidden

– Live Value – 5 (5 – ID категории новостей. Его либо смотрим в списке категорий Joomla, либо жмем на значек «{{» и выбираем категорию из выпадающего списка в появившемся окне).

Что получится в результате? У нас будет заполненная скрытая форма, которая будет отправляться(сабмититься) при открытии страницы(модуля поиска). В результате мы получим все материалы категории с ID = 5. Отсортировать материалы по дате добавления можно будет прямо в настройках модуля/пункта меню, который мы используем для данного типа поиска. Первая часть работы закончена. Теперь нужно настроить отображение результатов поиска.

Создание списка результатов

После того, как фильтр материалов создан, нужно настроить отображение списка результатов. Предположим, что мы хотим отображать последние новости в формате Блога. Это означает, что нам нужно заполнить полями только вкладку Item, вкладку же List мы не трогаем. Для начала переключаем шаблон отображения в режим блога(о том, как это сделать, я писал в начале статьи). Переходим на вкладку Item и добавляем в нужные позиции нужные поля.

Предположим, что нам нужно показывать следующие поля:

1. Заголовок
2. Краткое описание
3. Автор
4. Дата добавления

Добавим все эти поля в конструктор:

Также заодно разберемся с настройками, спрятанными под цифрами от 1 до 4(для List и Item они одинаковы):

Search Form

Кнопка №1

– Label – заголовок поля. Отображается перед полем ввода.

Кнопка №2

– Link – если значение должно являться ссылкой, определяет на что именно следует ссылаться. Доступен выбор следующих значений: на контент (Content), с возможностью удаления (Delete) и просмотра (View), на форму (Form), на результаты поиска (List & Search). Пример использования такой опции – функционал тегов.

– Typography – уникальное оформление значения.

Кнопка №3

– Markup – разметка. Позволяет оформить поле, используя CSS или предопределенные стили.
– Markup Class – стиль разметки разметка. Позволяет задать полю дополнительный CSS-класс.

Кнопка №4

– Access –уровень доступа к данному значению. Т.е. поле смогут увидеть только те пользователи, которые принадлежат группам, имеющим уровень доступа, выставленный здесь.

– Restriction – ограничение на расположение и действие. Если выбрать Workflow, справа появится знак "+", кликнув на который перейдем к форме выбора – только в административной части показывать поле, или на сайте, или на обоих (Both), и какие действия (Action) совершать – допускать только добавление информации в поле, только редактирование, или оба действия.

Поскольку наш список последних новостей должен иметь ссылки на их полнотекстовые версии, то мы добавим полю Article Title ссылку на полную новость(Link – Content).

Всё, тип поиска последних новостей готов. Осталось показать его на сайте.

Вывод результатов поиска на сайте

Поскольку для блока «Последние новости» подходит больше всего модуль, то в нем мы этот блок и выведем.

Перейдем в менеджер модулей. Нажмем кнопку «Создать». Выберем тип модуля «Seblod – List». Откроется окошко следующего вида:

Все поля слева стандартные для Joomla и комментариев по ним не требуется. Справа есть следующие опции, которые мы должны установить:

– Search Type (List) – выбираем из выпадающего списка наш тип поиска;

– Count – количество материалов, которое нужно показать;

– Default Order – порядок сортировки материалов по умолчанию. Поскольку наши новости называются «Последние», то выбираем «Most Recent First».

– Final Order – позволяет выбрать материалы для отображения определенным образом. Например, если в Count установлено «5», всего новостей 10, а здесь выбрано «Random», то мы получим в модуле 5 случайных новостей, расположенных в порядке возрастания даты публикации. Сейчас здесь ничего менять не будем.

В дополнительных параметрах есть область «Live + Variation» в ней мы можем указать «живые» значения и вид отображения полей для конкретно этого модуля. Приоритет этих значений выше, чем в типе контента. Это сделано для того, чтобы вы могли создавать много разных похожих модулей на основе одного типа поиска. Пример: предположим, что у нас есть не только последние новости, но и последние объявления и, скажем, последние рецепты. Нам нужно показать на сайте три модуля – по одному на каждую категорию. Чтобы не создавать 3 однотипных типа поиска, мы можем создать один тип поиска, а для модулей указывать Live и Variation прямо в этих модулях.

Заполняем все опции и публикуем модуль. Смотрим сайт:

Как видите, у нас получился модуль последних новостей. Остается только красиво оформить его в CSS и можно пользоваться. Согласитесь, сделать такой модуль со всеми необходимыми полями в Seblod гораздо проще, чем искать подходящий в огромном множестве расширений Joomla. К тому же, в случае обновления Joomla, не нужно ждать, пока обновятся все модули. Достаточно обновить только Seblod.

Избыточность кода

Есть и небольшой минус, или скорее недоработка. Поскольку в случае использования Блога каждый материал списка использует шаблон seb_one, т.е. шаблон с 42 позициями, то список даже из 10 материалов невероятно раздувает код страницы. Для этого случая я сделал упрощенный шаблон seb_simple. Он сам, а также инструкция по его установке выложены на форуме.

Если вы осилили эту и предыдущую статьи, то дальше будет уже легче. Тренируйтесь работе с типами поиска и вскоре вы поймете насколько упростится создание сайтов и расширятся ваши возможности. Впереди еще много статей по Seblod, очень много, а на сегодня всё.

-----------------

Сервис хранения бэкапов от 1$ и до 500Gb. Промо-код: BACKUP99 - скидка 99% на первый месяц. Топ-1 на zapili.net!