Онлайн-руководство разработчика NetCat
Модуль «Поиск по сайту» 12.2.1Начало работы с модулем 12.2.2Язык запросов 12.2.3Способы хранения индекса 12.2.4Интерфейс модуля в панели управления сайтом 12.2.5Области индексирования 12.2.6Области HTML-страниц 12.2.7Области поиска на сайте 12.2.8Индексирование по расписанию, запуск индексирования в фоновом режиме 12.2.9Правила индексирования 12.2.10Постановка задачи переиндексирования в очередь 12.2.11Интеграция модуля в макеты дизайна сайта 12.2.12Простая форма поиска 12.2.13Расширенная форма поиска 12.2.14Вывод результатов поиска 12.2.15Стилизация списка подсказок 12.2.16Расширенные настройки 12.2.17Разработка расширений модуля 12.2.18Обзор архитектуры модуля 12.2.19Обработчики документов различных типов 12.2.20Текстовые фильтры 12.2.21Анализаторы текста 12.2.22Корректировщики запросов 12.2.23Подключение других поисковых систем 12.2.24Решение проблем с поиском 12.2.25Решение проблем с индексированием 12.2.26Справочник API

Класс навигации

Начиная с версии 5.4 в системе возможно использование класса навигации, методы которого повторяют уже имеющиеся функции.

Получить доступ к объекту:

<?php
    $nav = $nc_core->nav;
    // или
    $nav = nc_nav::get_instance();
?>

В настоящее время класс не имеет аналогов некоторым функциям, которые формируют: навигацию по сайтам (список сайтов), постраничную навигацию и навигацию по инфоблокам.

Дополнительные шаблоны

Класс навигации и его функции можно использовать в дополнительных шаблонах. Функционал работы с дополнительными шаблонами описан в соответствующем разделе.

Функции навигации

get_sub( $parent_id = 0 ) — формирование списка подкатегорий раздела

аналог nc_browse_sub()

Примеры использования:

<?php
    // корневые разделы
    $menu = $nav->get_sub();
    // подразделы раздела ID = 7
    $menu = $nav->get_sub(7);
    // Альтернативный способ
    $menu = $nav->sub(7)->get();
?>

Пример вывода меню:

<ul class='main-menu'>
    <? foreach ($nc_core->nav->get_sub() as $sd): ?>
        <? if ($sd->active): ?>
            <li><b><?= $sd->name ?></b></li>
        <? else: ?>
            <li><a href='<?= $sd->url ?>'><?= $sd->name ?></a></li>
        <? endif ?>
    <? endforeach ?>
</ul>


get_by_level( $level ),
get_current_level( $level ) — формирование списка подкатегорий раздела

аналог nc_browse_level()

<?php
    $menu = $nc_core->nav->get_by_level(0);
    $menu = $nc_core->nav->level(0)->get();
?>

Пример вывода меню первого уровня:

<ul class='sub-menu'>
    <? foreach ($nc_core->nav->get_by_level(1) as $sd): ?>
        <? if ($sd->active): ?>
            <li><b><?= $sd->name ?></b></li>
        <? else: ?>
            <li><a href='<?= $sd->url ?>'><?= $sd->name ?></a></li>
        <? endif ?>
    <? endforeach ?>
</ul>


get_path() — путь по сайту (хлебные крошки)

аналог nc_browse_path() и nc_browse_path_range()

Примеры использования:

<? foreach ($nc_core->nav->get_path() as $sd): ?>
    <? if ($sd->current): ?>
        <?=$sd->name ?>
    <? else: ?>
        <a href='<?=$sd->url ?>'><?=$sd->name ?></a> /
    <? endif ?>
<? endforeach ?>

Возвращает только часть пути (“хлебных крошек”). Аргументы работают точно так же как и php-функции array_slice

<?php
    // Вернет путь без первого элемента
    $nc_core->nav->get_path(1);
    // Вернет путь от корня сайта до 3 кровня вложенности максимум
    $nc_core->nav->get_path(0, 3);
    // Вернет весь путь но без последнего раздела
    $nc_core->nav->get_path(0, -1);
?>

В функциях и модификаторах возможно использование следующих значений:

  • name — название раздела
  • id — идентификатор раздела
  • url — путь к разделу
  • active, current — активный (текущий) раздел

Модификаторы

sub( $parent_id = 0 ) — указание номера раздела

$menu = $nav->sub(7)->get();


level($level) — указание номера уровня

$menu = $nc_core->nav->level(0)->get();


as_object() — вывод в виде объектов
 

as_array() — вывод в виде массива
 

ignore_check( $ignore = true ) — игнорирование вывода только включённых разделов, если $ignore_check равен 1, то выведутся все разделы

<?php
    $all_subs = $nav->ignore_check()->get_sub();
    // или
    $all_subs = $nav->ignore_check()->sub()->get();
?>


order_by( $field, $type = ‘asc’ ) — изменяет порядок сортировки возвращаемого результата.

<?php
    // Сортирует по названию раздела
    $nav->order_by('name')->get_sub();
    // В обратном порядке
    $nav->order_by('name', 'desc')->get_sub();
?>

Использование нескольких параметров сортировки

<?php
    $nav->order_by('Favorite')->order_by('name')->get_sub();
?>


where( $field, $operator = null, $value = null ),
or_where( $field, $operator = null, $value = null ) — выборка корневых разделов для которых поле menu имеет значение main

<?php
    $nav->where('menu', 'main')->order_by('name')->get_sub();
    // Вернет тот же результат
    $nav->where('menu', 'main')->order_by('name')->level(0)->get();
?>

Примеры работы модификатора where()

<?php
    // ... WHERE `menu` = 'main' ...
    $nav->where('menu', 'main');
    // ... WHERE `menu` != 'main' ...
    $nav->where('menu', '!=', 'main');
    // ... WHERE `menu` = 'main' AND `Checked` = 1 ...
    $nav->where('menu', 'main')->where('Checked', 1);
    // ... WHERE `menu` = 'main' OR `menu` = 'all' ...
    $nav->where('menu', 'main')->or_where('menu', 'all');
?>


where_in( $field, $values )
or_where_in( $field, $values ) — выборка конкретных разделов

<?php
    $nav->where_in('id', array(100, 101, 103))->order_by('name')->get();
?>

Примеры вывода меню с модификаторами:

Вывод меню в котором отображаются только разделы с id = 3 и 5

<ul class='main-menu'>
    <? foreach ($nc_core->nav->where_in("id", array(3,5))->get_sub() as $sd): ?>
        <? if ($sd->active): ?>
            <li><b><?= $sd->name ?></b></li>
        <? else: ?>
            <li><a href='<?= $sd->url ?>'><?= $sd->name ?></a></li>
        <? endif ?>
    <? endforeach ?>
</ul>

Вывод меню в котором отображаются все разделы, включая выключенные

<ul class='main-menu'>
    <? foreach ($nc_core->nav->ignore_check()->get_sub() as $sd): ?>
        <? if ($sd->active): ?>
            <li><b><?= $sd->name ?></b></li>
        <? else: ?>
            <li><a href='<?= $sd->url ?>'><?= $sd->name ?></a></li>
        <? endif ?>
    <? endforeach ?>
</ul>

Комментарии 23

По моему получилось намного замороченней чем стандартные функции. Поясните плиз для каких целей используется класс?
   
Известно, зачем - для нестандартной навигации.
Например, есть у вас меню, которое вы выводите через стандартную функцию nc_browse_sub, а вам вдруг понадобилось при отображении каждого пункта меню выполнять некую php-функцию. Функция nc_browse_sub не позволяет в шаблон вывода вставлять запуск функций, а с помощью класса навигации Вы бы смогли это сделать.
Разумеется, для стандартных вариантов навигации проще использовать привычные функции, а не этот сложный класс навигации.
   
slivki  Продвижение сайтов в Уфе 05 апреля 2015, 13:03:35
Да он по моему не такой сложный
   
dyarikov  Студия Titanium 10 апреля 2015, 15:15:13
Раньше было три варианта пункта меню: неактивный, на котором находимся, и внутри которого находимся. Как это теперь реализуется? Особенно на примере новости.
   
А есть ведь $sd->current и $sd->active выше в примерах, они как раз для этой цели. Если не current и не active, значит элемент unactive.
   
dyarikov  Студия Titanium 10 апреля 2015, 16:42:38
Есть, но страницу объекта от страницы списка не отличает.
   
dyarikov  Студия Titanium 10 апреля 2015, 17:33:55
Руслан, по-моему функционал не совсем тот же.
Старый код отрабатывал вложенные разделы и отображение объекта из списка на одной странице. Новый, см. ниже, не отрабатывает. Выходит, что новое сделали, а типовой функционал сразу стал проблемой.

[CODE] <div class="column-right">
<? foreach ($nc_core->nav->where_in('id', array(630, 631))->order_by('id')->get() as $sd): ?>
<? if ($sd->current): ?><div class="selected"><strong><?= $sd->name ?></strong></div>
<? elseif ($sd->active): ?><div class="selected"><a href='<?= $sd->url ?>'><?= $sd->name ?></a></div>
<? else: ?><div><a href='<?= $sd->url ?>'><?= $sd->name ?></a></div><? endif ?>
<? endforeach ?>
</div>[/CODE]
   
А вы пробовали выводить внутри foreach значения sd->current и sd->active, просто так, не прибегая к if'ам? У меня есть подозрение, что они, возможно, не взаимоисключающие.
   
Александр  Zavarka Team 14 мая 2015, 16:06:48
да, так и есть.
active и current всегда вместе идут.
И поэтому даже на странице объекта оба значения остаются активными. Это баг.
Получается, что нельзя убрать ссылку на раздел на странице списка и поставить её на странице объекта.
   
Александр  Zavarka Team 14 мая 2015, 16:09:28
Хотя нет, можно.
На помощь приходит [B]$action[/B].
[B]if ($sd1->active && $action == 'index')[/B] - значит страница списка
[B]if ($sd1->active && $action == 'full')[/B] - значит страница объекта
   
Евгений Соколов  Deviks 29 июня 2015, 17:50:54
А как вывести дочерние элементы у корневого пункта меню?
   
fazli  ymv 22 октября 2015, 18:07:05
Поддерживаю вопрос: Как настроить многоуровневое меню с модификаторами ?
[CODE]<ul class='main-menu'>
<? foreach ($nc_core->nav->where_in("id", array(3,5))->get_sub() as $sd): ?>
<? if ($sd->active): ?>
<li><b><?= $sd->name ?></b></li>
<? else: ?>
<li><a href='<?= $sd->url ?>'><?= $sd->name ?></a></li>
<? endif ?>
<? endforeach ?>
<ul>[/CODE]
тут прописан вывод только одноуровневого меню.
   
Евгений  Patrol Studio 30 марта 2016, 13:00:21
Извините, у вас в примерах тег <ul> не закрытый!
   
Здравствуйте. Приношу извинения за большую задержку с ответом.
Ошибка исправлена.
   
Владимир  Web-Element 06 марта 2018, 18:45:55
Возможно ли на втором сайте в системе вывести навигацию по разделам первого сайта в системе? Если да, то как?
   
DazeArt  Смоленский Андрей 10 апреля 2018, 20:58:09
Неожиданный сюрприз... Раньше при выводе разделов таким образом
<? foreach ($nc_core->nav->where_in("id", array(18,6,3,9,44,14,7))->ignore_check()->get_sub() as $sd): ?>
Вывод был в порядке следование идентификаторов в массиве, а после обновления они стали выводиться по приоритету раздела. А было удобно, что можно как угодно выстраивать.
   
DazeArt  Смоленский Андрей 19 апреля 2018, 23:15:04
Слушайте, верните как было! Можно было без всяких извращений формировать порядок меню как угодно. А теперь через какие изыски этого добиваться?
   
Дмитрий Коновалов  Activica 12 июля 2018, 15:46:31
as_object() — вывод в виде объектов

as_array() — вывод в виде массива

как этим пользоваться?
   
Антон 18 сентября 2019, 03:36:21
Давно пора шаблонизатор начинать придумывать, если хочется что бы народ классом навигации пользовался активнее! Эта каша из PHP и HTML полное безобразие! Код читать сложно, набирать муторно. Минимум два раза в каждой строчке печатать скобку с вопросом ОЧЕНЬ утомляет. Со старыми ф-циями код выглядит гораздо лучше!

Я вот только начал свое изучение НетКет. Третий месяц в нем работаю. Но для меня это автомобиль с квадраными колесами. Вроде бы и ездит, но очень неудобно. Идеи в ЦМС неплохие заложены, но реализованы в основном через одно место. Зачем люди за НетКет деньги платят, пока не очень понимаю! ))))))
   
Андрей  a-lime 17 ноября 2019, 10:41:56
Класс очень удобный! Можно вывести меню где угодно и любого необходимого формата. Ломал голову как сделать многоуровневое меню для bootstrap 4, с помощью функций. Так и не придумал как)). А с помощью класса сделал за 5 минут. Если не понятно как работать с классом, то посмотрите, например, вывод var_dump для $sd из примера выше.

Вот примерно такой код для вывода двухуровнего меню:

<ul class='main-menu'>
<? foreach ($nc_core->nav->get_sub() as $sd): ?>
<li>
<a href='<?= $sd->url ?>'><?= $sd->name ?></a>
<?
if ($nc_core->nav->get_sub($sd->Subdivision_ID)):
foreach ($nc_core->nav->get_sub($sd->Subdivision_ID) as $sd_sub):
?>
<ul>
<li><a href='<?= $sd_sub->url ?>'><?= $sd_sub->name ?></a></li>
</ul>
<?
endforeach;
endif;
?>
</li>
<? endforeach ?>
</ul>
   
Андрей  a-lime 17 ноября 2019, 11:08:44
Если кому-то будет нужно, то вот пример вывода двухуровневого горизонтального меню для Bootstrap 4 :


<nav class="navbar navbar-expand-lg navbar-light bg-light">
<button class="navbar-toggler" type="button" data-toggle="collapse" data-target="#navbarSupportedContent" aria-controls="navbarSupportedContent" aria-expanded="false" aria-label="Toggle navigation">
<span class="navbar-toggler-icon"></span>
</button>
<div class="collapse navbar-collapse" id="navbarSupportedContent">
<ul class="navbar-nav mr-auto">
<? foreach ($nc_core->nav->get_sub() as $sd): ?>
<? if ($nc_core->nav->get_sub($sd->Subdivision_ID)): ?>
<li class="nav-item dropdown">
<a class="nav-link dropdown-toggle" href="#" id="navbarDropdown" role="button" data-toggle="dropdown" aria-haspopup="true" aria-expanded="false"><?= $sd->name; ?></a>
<div class="dropdown-menu" aria-labelledby="navbarDropdown">
<? foreach ($nc_core->nav->get_sub($sd->Subdivision_ID) as $sd_sub): ?>
<a class="dropdown-item" href="<?= $sd_sub->url; ?>"><?= $sd_sub->name; ?></a>
<? endforeach; ?>
</div>
</li>
<? else: ?>
<? if ($sd->active): ?>
<li class="nav-item active">
<a class="nav-link" href="<?= $sd->url; ?>"><?= $sd->name; ?><span class="sr-only">(current)</span></a>
</li>
<? else: ?>
<li class="nav-item active">
<a class="nav-link" href="<?= $sd->url; ?>"><?= $sd->name; ?></a>
</li>
<? endif; ?>
<? endif; ?>
<? endforeach ?>
</ul>
</div>
</nav>
   
Randir  Фэнтези Дизайн 21 августа 2021, 16:09:14
А как обратиться через класс к дополнительным полям разделов? Иконки, картинки..
   
Константин 05 сентября 2021, 21:09:41
Все просто, сделайте print($nav) и посмотрите все доступные поля для использования. Там будут и subdivision_id и другие, которые вы добавляете через системные таблицы для разделов.
   
Описание проекта