[Plugin] Catlist

Если коротко, то функция sedby_catlist принимает следующие аргументы:

sedby_catlist
(
   $tpl,        // 01. имя шаблона (по умолчанию comlist)
   $items,      // 02. количество записей (0 – вывести все)
   $order,      // 03. сортировка в формате MySQL
   $extra,      // 04. дополнительные MySQL-запросы
   $offset,     // 05. сдвиг на указанное количество записей
   $pagination, // 06. код паджинации для URL'ов
   $ajax_block, // 07. ID блока для AJAX-паджинации
   $cache_name, // 08. имя записи в таблице кэша
   $cache_ttl   // 09. срок жизни кэша в секундах
)

Ограничить категории можно через аргумент 04 в SQL-формате, например:

{PHP|sedby_catlist('sections', '', 'structure_path ASC', structure_area = 'page')}

Так можно исключить форумные разделы. Или:

{PHP|sedby_catlist('sections', '', 'structure_path ASC', structure_code != 'system')}

для исключения раздела system.

Я часто использую и поле structure_tpl -- например, если надо вывести "магазинные" разделы, для которых применяется шаблон shop или catalog:

{PHP|sedby_catlist('sections', '', 'structure_path ASC', 'structure_tpl = "catalog"')}

Я в этом плагине (в отличие от Pagelist) не использовал функцию sedby_compilecats() – как-то не понадобилось. Со структурой возможны следующие варианты:

Глобальный плагин

В "проектном" плагине создаем (или используем уже созданную) часть с хуком global. В ней размещаем PHP-код, который формирует массивы и / или строковые переменные с необходимыми нам разделами. Плюс данные вносим в кэш. Примерно так:

<?php
/* ====================
[BEGIN_COT_EXT]
Hooks=global
[END_COT_EXT]
==================== */

defined('COT_CODE') or die('Wrong URL');

if ($cache && $cache->db->exists('tovary', 'shop')) {
	$tovary = $cache->db->get('tovary', 'shop');
	$tovary_str = $cache->db->get('tovary_str', 'shop');
	$tovary_str_cats = $cache->db->get('tovary_str_cats', 'shop');
	$net_tovarov = $cache->db->get('net_tovarov', 'shop');
	$net_tovarov_str = $cache->db->get('net_tovarov_str', 'shop');
} else {
	$res_phones = $db->query("SELECT structure_code FROM $db_structure 
          WHERE structure_path > '100' AND structure_path < '199' ORDER BY structure_path")->fetchAll(PDO::FETCH_COLUMN);
	$res_tablets = $db->query("SELECT structure_code FROM $db_structure 
          WHERE structure_path > '200' AND structure_path < '300' ORDER BY structure_path")->fetchAll(PDO::FETCH_COLUMN);

	$tovary = [
		"phones" => $res_phones,
		"tablets" => $res_tablets,
	];

	$tovary_str = [
		implode(';', $tovary['phones']),
		implode(';', $tovary['tablets']),
	];

	$tovary_str_cats = [
		'"'.implode('","', $tovary['phones']).'"',
		'"'.implode('","', $tovary['tablets']).'"',
	];

	$net_tovarov = $db->query("SELECT structure_code FROM $db_structure 
          WHERE structure_path > '700' ORDER BY structure_path")->fetchAll(PDO::FETCH_COLUMN);

	$net_tovarov_str = '"'.implode('","', $net_tovarov).'"';
	$net_tovarov_str_cats = '"'.implode('","', $net_tovarov).'"';

	$cache && $cache->db->store('tovary', $tovary, 'shop', 604800);
	$cache && $cache->db->store('tovary_str', $tovary_str, 'shop', 604800);
	$cache && $cache->db->store('tovary_str_cats', $tovary_str_cats, 'shop', 604800);
	$cache && $cache->db->store('net_tovarov', $net_tovarov, 'shop', 604800);
	$cache && $cache->db->store('net_tovarov_str', $net_tovarov_str, 'shop', 604800);
}

В результате у нас всегда под рукой кэшированные массивы и строки для необходимых разделов. Обычно я их использую не только с catlist. С ним же это работает так:

{PHP.tovary_str_cats|sedby_catlist('catlist', 36, 'structure_path ASC', 'structure_code IN $this')}

Обрати внимание на то, что в SQL-запросе строковые данные должны быть в кавычках.

Переменные в виде ресурсов в PHP-файле темы

Прмиерно то же самое, но попроще можно сделать во frontend-теме. В PHP-файле (например, nemesis.php) определим строковый ресурс:

$R['tovary_str_cats'] = '"phones", "tablets"';

А дальше уже просто:

{PHP.R.tovary_str_cats|sedby_catlist('catlist', 36, 'structure_path ASC', 'structure_code IN $this')}

Явное указание в TPL-шаблоне

Можно и просто:

{PHP|sedby_catlist('catlist', 36, 'structure_path ASC', 'structure_code IN ""phones", "tablets""')}

Кому как подходит.

P. S. Опять же, необязательно привязываться к коду или названию раздела если можно использовать путь. Например, если у тебя необходимые разделы имеют пути вида 100.1, 100.2, 100.3 и т. д., то можно просто использовать MySQL-условие LIKE:

{PHP|sedby_catlist('catlist', 36, 'structure_path ASC', 'structure_path LIKE "100.%"')}

Опечатка, конечно:

{PHP|sedby_catlist('catlist', '', 'structure_path ASC', 'structure_code IN ("phones", "tablets")')}

По поводу i18n -- обязательно сделаю. И для крошек надо не забыть)

#165 prostogorod:

Подскажите, пожалуйста, хотя бы теоретически, как добавить мультиязычность в плагин? 
Вернее даже перевести эту переменную 'PAGE_ROW_TITLE'=> $row['structure_title'].  Тег {PAGE_ROW_URL} корректно срабатывает при включенном плагине i18n.

Постараюсь сделать на этой неделе

Добавлено 1 день спустя:

Готово. Можно скачать и протестировать.

А Pagelist просто не работает или выдает ошибки? Последнюю версию из гитхаба я вчера исправил.

Добавлено 23 часа спустя:

Протестировал – Pagelist работает. А вот с крошками надо подумать.

При использовании AJAX-паджинации в URL залетают аргументы функции sedby_pagelist() (или соответствующей плагину). Это немного не красиво, поэтому при указании данных ключей URL будет шифроваться в хэш.