Компоненты 2.0::Стандартная страница поиска
Компонент служит для создания страницы поиска. Этот компонент можно использовать как самостоятельно для создания страницы поиска, так и в сочетании с компонентом Форма поиска. Вне зависимости от настроек поиск в системе осуществляется в соответствии с правами пользователя.
В поставку продукта входят два шаблона компонента: по умолчанию (.default) и со встроенной поддержкой облака тегов (tags). Если используется шаблон tags, то при настройке компонента доступна группа параметров Дополнительно.
Пример вызова
<?$APPLICATION->IncludeComponent("bitrix:search.page","tags",
Array(
"TAGS_SORT" => "NAME",
"TAGS_PAGE_ELEMENTS" => "150",
"TAGS_PERIOD" => "30",
"TAGS_URL_SEARCH" => "/search/index.php",
"TAGS_INHERIT" => "Y",
"FONT_MAX" => "50",
"FONT_MIN" => "10",
"COLOR_NEW" => "000000",
"COLOR_OLD" => "C8C8C8",
"PERIOD_NEW_TAGS" => "7",
"SHOW_CHAIN" => "Y",
"COLOR_TYPE" => "Y",
"WIDTH" => "100%",
"AJAX_MODE" => "Y",
"RESTART" => "Y",
"CHECK_DATES" => "N",
"arrWHERE" => Array("iblock_books","blog"),
"arrFILTER" => Array(),
"SHOW_WHERE" => "Y",
"PAGE_RESULT_COUNT" => "50",
"CACHE_TYPE" => "A",
"CACHE_TIME" => "3600",
"PAGER_TITLE" => "Результаты поиска",
"PAGER_SHOW_ALWAYS" => "Y",
"PAGER_TEMPLATE" => "",
"AJAX_OPTION_SHADOW" => "Y",
"AJAX_OPTION_JUMP" => "N",
"AJAX_OPTION_STYLE" => "Y",
"AJAX_OPTION_HISTORY" => "Y"
)
);?>
Описание параметров
Источник данных - RESTART
- [Y|N] При установленной опции сначала будет выполнен поиск с учетом морфологии, а если ничего не найдено, то будет запущен поиск без учета морфологии.
- CHECK_DATES
- [Y|N] Если опция установлена, то поиск будет осуществляться только в активных по дате документах.
- arrWHERE
- Значения, которые должны быть включены в выпадающий список формы поиска "Где искать" (форум, блоги, инфоблоки).
- arrFILTER
- Параметр служит для ограничение области поиска: статическими файлами (main), либо форумами(forum), либо одним из типов инфоблоков, определенных в системе, либо блогами. Можно также выбрать несколько из перечисленных источников информации либо выбрать пункт Не ограничивать.
Если выбрать:
- [main] Cтатические файлы, то появляется для заполнения поле Путь к файлу начинается с любого из перечисленных, в котором можно указать путь к разделу или файлу, где будет осуществлен поиск, например, /about/. Если поле пусто, то поиск осуществляется во всех статических файлах системы.
- [forum] Форумы. Ниже отображается поле со всеми форумами, созданными на сайте. Среди них можно выбрать один или несколько форумов либо выбрать вариант (все), тогда поиск будет осуществлен во всех форумах системы.
- Один из типов инфоблоков (например, [iblock_news] Новости). При нажатии ОК станут доступны все инфоблоки, созданные внутри выбранного типа. Среди них можно выбрать один или несколько инфоблоков либо выбрать вариант (все), тогда поиск будет осуществлен во всех инфоблоках этого типа.
- [blog] Блоги. При данном ограничении поиск будет осуществлен только в рамках блогов.
Внешний вид - SHOW_WHERE
- [Y|N] Если опция установлена, то в публичном разделе будет выведен выпадающий список с вариантами ограничения поиска, указанными в параметре arrWHERE.
- PAGE_RESULT_COUNT
- Параметр определяет количество результатов поиска, которое будет выведено на одной странице, остальные ссылки будут выведены с помощью постраничной навигации.
Управление режимом AJAX - AJAX_MODE
- [Y|N] При установленной опции для компонента будет включен режим AJAX.
- AJAX_OPTION_SHADOW
- [Y|N] Если параметр принимает значение "Y", то при выполнении AJAX-перехода будет затенена область, которая должна измениться.
- AJAX_OPTION_JUMP
- [Y|N] Если пользователь совершит AJAX-переход, то при установленой опции по окончании загрузки произойдет прокрутка к началу компонента.
- AJAX_OPTION_STYLE
- [Y|N] Если параметр принимает значение "Y", то при совершении AJAX-переходов будет происходить подгрузка и обработка списка стилей, вызванных компонентом.
- AJAX_OPTION_HISTORY
- [Y|N] Когда пользователь выполняет AJAX-переходы, то при включенной опции можно использовать кнопки браузера "Назад" и "Вперед".
Настройки кеширования - CACHE_TYPE
- Тип кеширования. Доступны следующие значения:
- А - Авто
Автоматическое кеширование. Действует при включенном автокешировании на странице Настройки кеширования (Настройки > Настройки продукта > Автокеширование) и при установленном времени кеширования в поле CACHE_TIME (сек.).
- Y - Кешировать
При данном типе кеширования время кеширования (CACHE_TIME) должно быть установлено. Настройки автокеширования не влияют на данный тип кеширования.
- N - Не кешировать
При выборе этого типа кеширование не происходит, независимо от настроек автокеширования (Настройки > Настройки продукта > Автокеширование)
- CACHE_TIME
- Время кеширования в секундах.
Настройки постраничной навигации - PAGER_TITLE
- Заголовок постраничной навигации.
- PAGER_SHOW_ALWAYS
- [Y|N] При установленной опции навигация будет отображаться всегда, даже если результаты поиска помещаются на одной странице.
- PAGER_TEMPLATE
- Название шаблона постраничной навигации.
Дополнительно - TAGS_SORT
- Укажите тип сортировки тегов: по имени (NAME) или по популярности (CNT).
- TAGS_PAGE_ELEMENTS
- Параметр ограничивает количество выводимых тегов.
- TAGS_PERIOD
- Период выборки тегов (дней).
- TAGS_URL_SEARCH
- Путь к странице поиска (от корня сайта).
- TAGS_INHERIT
- [Y|N] Опция служит для сужения области поиска.
- FONT_MAX
- Устанавливается максимальный размер шрифта написания тегов (в пикселах).
- FONT_MIN
- Минимальный размер шрифта в пикселах.
- COLOR_NEW
- Указывается код цвета тегов, дата создания которых наиболее поздняя.
- COLOR_OLD
- Указывается код цвета тегов, дата создания которых наиболее ранняя..
- PERIOD_NEW_TAGS
- Период, в течение которого считать тег новым (дней).
- SHOW_CHAIN
- [Y|N] При установленной опции будет показана цепочка навигации. Параметр работает, если TAGS_INHERIT принимает значение "Y".
- COLOR_TYPE
- [Y|N] При отмеченной опции переход между цветами COLOR_NEW и COLOR_OLD будет плавным.
- WIDTH
- Ширина облака тегов (пример: "100%" или "100px", "100pt", "100in") .