Модуль Cataloger - Часть 2
Вывод специальных списков
Эти функции Вы можете использовать на любой странице Вашего сайта. Они позволяют выводить списки последних добавленных в каталог записей или список случайных записей.
Показ записей
Чтобы вывести список всех записей (опционально только записи из одной категории) Вы можете использовать функцию "all". Использование функции через параметр:
{cms_module module='Cataloger' action='all'
sub_template='my_sub_template'}
В примере дополнительно задан параметр template, для определения шаблона этого списка. Опционально Вы можете использовать параметр alias='page_alias', который указывает на категорию, в которой будет производиться поиск выводимых записей.
Особое значение имеет "page_alias=/" Таким образом Вы ссылаетесь на корневую категорию для вывода, то есть разрешаете записи из всех категорий. Это очень полезная вещь. К примеру, если Вы хотите вывести список всех категорий в выпадающем меню, Вы можете использовать тег:
{cms_module module='Cataloger' action='all'
sub_template='my_sub_template' alias='/' recurse='categories_all'}
В шаблоне будет формироваться выпадающее меню и при выборе одного из значений, страница будет перекидываться на соответствующую категории страницу:
<select name="foo" onchange="document.location=this.options[this.selectedIndex].value;">
<option value="">Select A target</option>
</select>
Если же Вы хотите, чтобы в списке показывались только категории первого уровня, то Вы просто заменяете соответствующий параметр recurse='categories_all' на recurse='categories_one'. Или если Вы хотите указать список записей вместо категорий, то используйте этот тег:
{cms_module module='Cataloger' action='all'
sub_template='my_sub_template' alias='/' recurse='items_all'}
Естественно, Вы можете показывать только категории, соответствующие текущей странице, если опустите значение "alias='/'". Вы видите, что здесь можно комбинировать до бесконечности.
Поддерживаемые значения для параметра recurse:
- items_one - Записи из не более чем одного уровня начиная с текущей страницы (или значения alias)
- items_all - Записи из всех уровней начиная с текущей страницы (или значения alias)
- categories_one - Категории из не более чем одного уровня начиная с текущей страницы (или значения alias)
- categories_all - Категории из всех уровней начиная с текущей страницы (или значения alias)
- mixed_one - Записи и категории из не более чем одного уровня начиная с текущей страницы (или значения alias)
- mixed_all - Записи и категории из всех уровней начиная с текущей страницы (или значения alias)
Показ новых записей
Эта функция позволяет выводить список новых записей из определенной категории. Добавить список можно так:
{cms_module module='Cataloger' action='recent'
sub_template='my_sub_template'}
В этом примере параметр sub_template указывает на шаблон, который будет использоваться для вывода списка. Существуют еще два опциональных параметра count='3' и alias='page_alias'. Первый определяет количество выводимых элементов, а второй указывает на категорию, в которой записи находятся. Специальное значение "page_alias=/" позволяет вывести записи из всех категорий каталога.
Случайные записи
Вывод любого количества случайных записей из каталога делается так:
{cms_module module='Cataloger' action='random'
sub_template='my_sub_template'}
В этом примере параметр sub_template указывает на шаблон, который будет использоваться для вывода списка. Существуют еще два опциональных параметра count='3' и alias='page_alias'. Первый определяет количество выводимых элементов, а второй указывает на категорию, в которой записи находятся. Специальное значение "page_alias=/" позволяет вывести записи из всех категорий каталога.