Главная / Документация

Онлайн-руководство разработчика NetCat

1Введение 2Установка и настройка системы 3Знакомство с системой 4Инструменты системы 5Работа со структурой сайта 6Работа с материалами 7Пользователи и права 8Макеты дизайна 9Навигация 10Компоненты 11Виджет-компоненты 12Модули 13Разработка модуля 14Системные таблицы 15Списки 16Системный объект nc_core 17Система событий 18Прочие инструменты разработчика 19Инструменты для продвижения (SEO, SMO) 20Мобильные и адаптивные сайты 21Сайты Longpage и Shortpage 22Прочее 23API

1.1Начало обучения 1.2Получение лицензии и её регистрация 1.3Демо–сайт 1.4Создание интернет-магазина на основе шаблона

2.1Технические требования к хостингу 2.2Файловая структура системы 2.3Процесс установки 2.4Настройка файла конфигурации 2.5Активация системы 2.6Фильтр входящих данных 2.7Перевод сайта на HTTPS 2.8Двухфакторная аутентификация

3.1Основные понятия. Архитектура 3.2Административный раздел 3.3Главное меню 3.4Рабочая область 3.5Панель быстрого редактирования 3.6Базовые настройки системы 3.7Описание базы данных

4.1Виджеты 4.2Управление задачами (CRON) 4.3Переадресация 4.4Статистика посещений 4.5Управление рекламой 4.6Неработающие ссылки 4.7Файл-менеджер 4.8SEO-анализ 4.9Копирование разделов 4.10Корзина удаленных объектов 4.11Командная строка SQL 4.12Архивы проекта 4.13Экспорт и импорт данных 4.14Экспорт/импорт CSV 4.15Обновления системы 4.16Логирование 4.17Рассылка по базе

5.1Управление сайтами 5.2Карта сайта 5.3Добавление сайта 5.4Удаление сайта 5.5Управление разделами 5.6Инфоблоки раздела 5.7Копирование разделов

6.1Добавление, изменение и удаление объектов 6.2Перенос и копирование объектов 6.3Черновики 6.4Отображение материалов 6.5Фильтры 6.6Визуальный редактор содержимого

7.1Регистрация пользователя 7.2Список пользователей, выборка 7.3Система разграничения прав пользователя 7.4Группы пользователей 7.5Класс для работы с правами пользователей

8.1Подготовка и внедрение HTML-шаблона 8.2Внедрение структуры 8.3Навигация 8.4Заголовки и мета-теги 8.5Пользовательские настройки в макете 8.6Использование PHP 8.7Отображение данных с других страниц (инфоблоков) 8.8Наследование макетов 8.9Перемещение макетов 8.10Врезки (дополнительные шаблоны макетов) 8.11Асинхронные врезки: динамическая загрузка дополнительных шаблонов 8.12Справочник API

9.1Класс навигации 9.2Функции навигации

10.1Данные 10.2Прикрепление инфоблоков к разделам 10.3Варианты вывода инфоблоков на странице раздела 10.4Типы полей 10.5Создание компонента 10.6Системные настройки 10.7Постраничная навигация 10.8Поиск и выборка 10.9Формы компонентов 10.10Зеркальный инфоблок 10.11Шаблоны компонентов 10.12Стили шаблонов компонентов 10.13Пользовательские настройки компонента 10.14Компонент-агрегатор 10.15Экспорт-импорт компонентов 10.16Предустановленные компоненты 10.17Inline-редактирование текста 10.18Inline-редактирование изображений 10.19Справочник API

11.1Интерфейс управления виджет-компонентами 11.2Создание виджет-компонента 11.3Экспорт-импорт виджет-компонентов 11.4Интерфейс управления виджетами 11.5Внедрение виджета 11.6Список функций 11.7Предустановленные виджеты 11.8Справочник API

12.1Модуль «Голосование» 12.2Модуль «Поиск по сайту» 12.3Модуль «Статистика посещений» 12.4Модуль «Подписка и рассылка» 12.5Модуль «Личный кабинет» 12.6Модуль «Управление рекламой» 12.7Модуль «Управление ссылками» 12.8Модуль «Интернет-магазин» 12.9Модуль «Минимагазин». Новый 12.10Модуль «Минимагазин» 12.11Модуль «Приём платежей и онлайн-кассы» 12.12Модуль «Облако тегов» 12.13Модуль «Календарь» 12.14Модуль «Блог и сообщество» 12.15Модуль «Защита форм картинкой» 12.16Модуль «Кэширование» 12.17Модуль «Маршрутизация» 12.18Модуль «Счета и акты» 12.19Модуль «Комментарии» 12.20Модуль «Логирование» 12.21Модуль «Форум» 12.22Модуль «Конструктор лендингов» 12.23Модуль «Айри CDN» 12.24Модуль «Отправка СМС-сообщений»

13.1Структура модуля 13.2Подробное описание файлов 13.3Процесс написания модуля 13.4Элементы управления 13.5Подготовка установочного архива 13.6Права на модули

17.1Прикрепление событий 17.2Трансляция событий 17.3Пользовательские события 17.4Список системных событий 17.5Предсобытия 17.6Пример

18.1Мультиязычность 18.2Использование BB-кодов 18.3Использование ключа подтверждения операций 18.4Отслеживание ошибок 18.5Подсветка синтаксиса с автовставкой 18.6Использование кодировки UTF-8 18.7Использования строковых функций и регулярных выражений 18.8Использование JavaScript и CSS 18.9Транслитерация 18.10Класс работы с письмами (mail) 18.11Класс работы с письмами (smtp) 18.12Класс работы с изображениями 18.13Автоматическая обработка изображений

19.1Title, keywords и description 19.2Генерация sitemap.xml 19.3Заголовок Last-Modified 19.4Страница 404 19.5Формирование url 19.6Анализ сайта 19.7Веб-аналитика 19.8Переадресации 19.9Robots.txt 19.10Настройка сайта для социальных сетей

20.1Мобильные сайты 20.2Адаптивные сайты

21.1Настройка сайта и раздела 21.2Вспомогательные функции 21.3JS-составляющая системы 21.4Механизм формирования HTML

22.1Обновление системы 22.2Действия при заражении сайта 22.3Перевод сайта с cp1251 на utf-8 22.4Ошибка при переносе сайта с Windows-сервера на *nix

12.1.1Добавление опроса 12.1.2Справочник API

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

12.3.1Настройка сбора статистики от Openstat 12.3.2Настройка сбора статистики от NetCat 12.3.3Интеграция с Google Analytics и Яндекс.Метрикой

12.4.1Видеоурок 12.4.2Добавление и изменение рассылки 12.4.3Типы рассылок 12.4.4Шаблон письма 12.4.5Условия и действия 12.4.6Подписка пользователя 12.4.7Подписка на объект 12.4.8Компонент «Список подписок» 12.4.9Подписки пользователя 12.4.10Список подписчиков 12.4.11Периоды получения писем 12.4.12Константы модуля 12.4.13Структура таблиц 12.4.14Единоразовая рассылка 12.4.15Статистика рассылок 12.4.16Настройки модуля 12.4.17Доступы на рассылку и назначение прав 12.4.18Интеграция с модулем «Форум» 12.4.19Совместимость с предыдущими версиями 12.4.20Классы модуля

12.5.1Внедрение личного кабинета 12.5.2Регистрация пользователя 12.5.3Авторизация и завершение сеанса работы пользователя 12.5.4Изменение регистрационных данных 12.5.5Изменение пароля 12.5.6Восстановление пароля 12.5.7Отображение списка пользователей на сайте 12.5.8Отображение пользователей присутствующих на сайте 12.5.9Личные сообщения 12.5.10Авторизация по хэшу 12.5.11Авторизация через внешние сервисы 12.5.12Авторизация через rutoken 12.5.13Друзья-Враги 12.5.14Функции модуля и константы 12.5.15Личный счет 12.5.16Административная часть модуля 12.5.17Классы и функции модуля 12.5.18Справочник API

12.6.1Настройка трансляции баннеров на странице 12.6.2Генерация статистики 12.6.3Настройки модуля 12.6.4Справочник API

12.7.1Описание функциональности 12.7.2Компоненты модуля 12.7.3Настройка модуля 12.7.4Шаблоны писем

12.8.1Настройка модуля 12.8.2Настройка интернет-магазина 12.8.3Валюты 12.8.4Цены для разных групп пользователей 12.8.5Минимальная цена 12.8.6Способы доставки 12.8.7Способы оплаты 12.8.8Настройка шаблонов писем 12.8.9Бланки 12.8.10Скидки 12.8.11Сиюминутные скидки 12.8.12Купоны 12.8.13Редактирование заказов 12.8.14Статистика 12.8.15Компоненты товаров 12.8.16Варианты товаров 12.8.17Коллекции объектов 12.8.18Фильтр товаров 12.8.19Списки товаров 12.8.20Корзина 12.8.21Заказ 12.8.22Обмен данными (Netcat 5.9 и старше) 12.8.23Экспорт товаров в маркетплейсы 12.8.24Выгрузка в Яндекс.Маркет в формате YML 12.8.25Классы расчёта доставки 12.8.26Справочник API 12.8.27[архив] Переход c версии 5.2 на 5.3 12.8.28[архив] Интернет-магазин <5.3 12.8.29[архив] Обмен данными (до версии Netcat 5.9) 12.8.30[архив] Виджеты интернет-магазина

12.9.1Настройка модуля 12.9.2Настройка интернет-магазина 12.9.3Валюты 12.9.4Варианты доставки 12.9.5Варианты оплаты 12.9.6Настройка шаблонов писем 12.9.7Скидки 12.9.8Статистика 12.9.9Компоненты товаров 12.9.10Заказы 12.9.11Дополнительная информация

12.10.1Подключение модуля 12.10.2Массовое добавление товаров в корзину 12.10.3Заказы и скидки 12.10.4Корзина 12.10.5Шаблоны отображения 12.10.6Конвертер в «Интернет-магазин»

12.11.1Настройка платежей 12.11.2Примеры использования 12.11.3Обработчики событий 12.11.4Использование без интернет-магазина 12.11.5Онлайн-кассы и электронные чеки 12.11.6Корректировочные счета, доплата и возврат 12.11.7Добавление новой платежной системы

12.12.1Первые шаги 12.12.2Добавление и вывод 12.12.3Функции модуля

12.13.1Функции модуля

12.14.1Функции модуля 12.14.2Настройки модуля 12.14.3Управление действиями в компонентах

12.15.1Защита форм 12.15.2Функции, доступные после установки модуля 12.15.3Модификация модуля Captcha 12.15.4Аудио-каптча 12.15.5reCAPTCHA

12.16.1Использование функционала кэширования 12.16.2Блок «nocache» 12.16.3Административная часть 12.16.4Настройки кэша 12.16.5Информация 12.16.6Данные аудита 12.16.7Константы модуля 12.16.8Использование Memcached

12.17.1Маршруты 12.17.2Получение адресов страниц

12.18.1Настройки 12.18.2Клиенты 12.18.3Счета 12.18.4Акты

12.19.1Использование функционала комментариев 12.19.2Функционал модуля 12.19.3Методы класса 12.19.4Настройки 12.19.5Комментарии

12.21.1Объект списка форумов 12.21.2Объект топиков 12.21.3Объект ответов 12.21.4Информация для разработчиков 12.21.5Настройки форума 12.21.6Конвертер из старых версий 12.21.7Константы модуля

12.22.1Создание лендинга из карточки товара 12.22.2Создание лендинга из заготовки(пресета) 12.22.3Редактирование существующего лендинга

12.24.1Настройка модуля 12.24.2Создание интеграции с API поставщиком услуг 12.24.3Справочник API

nc_browse_sub()

nc_browse_sub( $sub, $template, $ignore_check = 0, $where_cond = "", $level = 0 )

Появилось в версии: 5

вывод списка подразделов заданного раздела в соответствии с шаблоном $template

Параметр	Описание
$sub	идентификатор родительсвого раздела. Если нужно вывести корневые разделы, нужно указать 0
$template	массив шаблона
$ignore_check	игнорирование вывода только включённых разделов, если $ignore_check равен 1, то выведутся все разделы
$where_cond	определяет дополнительные условия выборки из таблицы Subdivision
$level	уровень вывода меню

Массив $template должен иметь элементы со следующими индексами:

Индексы	Описание
prefix	выводится перед списком
suffix	выводится после списка
active	шаблон вывода активного элемента списка (а данном случае это касается текущего сайта)
active_link	шаблон вывода активного элемента списка в том случае, если ссылка на этот элемент идентична адресу текущей страницы
unactive	шаблон вывода неактивного элемента списка (в данном случае это касается всех сайтов, кроме текущего)
divider	шаблон разделителя между элементами списка
sortby	признак сортировки элементов

В шаблонах навигации доступны следующие макропеременные:

%NAME — название элемента (раздела);
%URL — путь к разделу;
%PARENT_SUB — номер родительского раздела (только для разделов);
%KEYWORD — ключевое слово раздела (только для разделов);
%SUB — номер раздела;
%COUNTER — номер выводимого элемента в списке (начиная с нуля);
%NEXT_LEVEL — отображение следующего уровня меню. Используется при построении многоуровневых меню.
%имя_поля_в_системной_таблице — произвольная переменная, задаваемая в блоке «Разделы» в системных таблицах.

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

В макете страницы необходимо вывести список всех подразделов раздела "Каталог продукции" (номер раздела - 123) в виде ненумерованного списка. Текущий раздел ссылкой выделяться не должен.

Фрагмент хедера или футера макета:

<?= nc_browse_sub(123, $cat_template); ?>

Фрагмент шаблона вывода навигации макета:

$cat_template['prefix']      = "<ul>";
$cat_template['suffix']      = "</ul>";
$cat_template['active']      = "<li>%NAME</li>";
$cat_template['active_link'] = "<li>%NAME</li>";
$cat_template['unactive']    = "<li><a href='%URL'>%NAME</a></li>";
$cat_template['divider']     = "";
$cat_template['sortby']      = "Priority DESC";

Вывести двухуровневое и более меню так же несложно. Для этого нужно сформировать массив шаблона следующим образом:

$cat_template[0]['prefix']      = "<ul>";
$cat_template[0]['suffix']      = "</ul>";
$cat_template[0]['active']      = "<li>%NAME %NEXT_LEVEL</li>";
$cat_template[0]['active_link'] = "<li>%NAME %NEXT_LEVEL</li>";
$cat_template[0]['unactive']    = "<li><a href='%URL'>%NAME</a> %NEXT_LEVEL</li>";
$cat_template[0]['divider']     = "";
$cat_template[0]['sortby']      = "Priority DESC";

$cat_template[1]['prefix']      = "<ul>";
$cat_template[1]['suffix']      = "</ul>";
$cat_template[1]['active']      = "<li>%NAME</li>";
$cat_template[1]['active_link'] = "<li>%NAME</li>";
$cat_template[1]['unactive']    = "<li><a href='%URL'>%NAME</a></li>";
$cat_template[1]['divider']     = "";

С помощью условия $where_cond можно ограничить условия вывода. Например есть задача: выводить только определённые разделы в пунктах меню. Для решения можно добавить чекбокс в настройке раздела: если включен — отображаем, иначе нет. Перейдите в: Разработка → Системные таблицы → Разделы и добавьте новое поле:

Название: show_in_menu
Описание: отображать в меню
Тип поля: логическая переменная (истина или ложь)
Обязательно для заполнения

Сохраните.

Теперь в настройках каждого из разделов вы можете видеть соответствующий чекбокс. В условии вывода меню нужно добавить условие:

<?= nc_browse_sub(123, $cat_template, 0, $where_cond = "show_in_menu='1'"); ?>

См. также

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

Demetriy Донковцев Дмитрий 15 мая 2014, 00:34:05

Поправьте пожалуйста, у вас здесь ошибка, надо записать так:
[CODE]
$cat_template[0]['prefix'] = "<ul>";
$cat_template[0]['suffix'] = "</ul>";
$cat_template[0]['active'] = "<li>%NAME %NEXT_LEVEL</li>";
$cat_template[0]['active_link'] = "<li>%NAME %NEXT_LEVEL</li>";
$cat_template[0]['unactive'] = "<li><a href='%URL'>%NAME</a> %NEXT_LEVEL</li>";
$cat_template[0]['divider'] = "";
$cat_template[0]['sortby'] = "Priority DESC";

$cat_template[1]['prefix'] = "<ul>";
$cat_template[1]['suffix'] = "</ul>";
$cat_template[1]['active'] = "<li>%NAME</li>";
$cat_template[1]['active_link'] = "<li>%NAME</li>";
$cat_template[1]['unactive'] = "<li><a href='%URL'>%NAME</a></li>";
$cat_template[1]['divider'] = "";
[/CODE]

amigo 15 мая 2014, 15:36:18

Дмитрий, спасибо, за сообщение. Поправлено

sparton Шекера Евгений 13 июня 2014, 15:16:13

А как вывести значение поля EnglishName из поля Subdivision? %EnglishName - не работает

amigo 13 июня 2014, 21:13:05

Можно так: [CODE]\$data[\$i][EnglishName][/CODE]
для вывода использовать [B]s_browse_[/B]

sparton Шекера Евгений 16 июня 2014, 12:22:52

да вот s_browse - понятно. хотелось бы чтобы и в новой версии nc_browse_ тоже была возможность вывода полей

nops Группа 5а5 03 июля 2014, 15:47:08

Коллеги.
Подскажите. За некоторыми изменениями, к меня:
[CODE]$topmenu[0]['prefix'] = "";
$topmenu[0]['active'] = "<li class='first current '><a href='%URL'>%NAME %NEXT_LEVEL</a></li>";
$topmenu[0]['unactive'] = "<li class='even '><a href='%URL'>%NAME %NEXT_LEVEL</a></li>";
$topmenu[0]['suffix'] = "";

$topmenu[1]['prefix'] = "<ul class='level-1'>";
$topmenu[1]['active'] = "<li class='first current '><a href='%URL'>%NAME</a></li>";
$topmenu[1]['unactive'] = "<li class='first '><a href='%URL'>%NAME</a></li>";
$topmenu[1]['suffix'] = "</ul>";[/CODE]

В Header вывожу так: [CODE]<?=nc_browse_sub(0,$topmenu) ?>[/CODE]
Верхний уровень меню все хорошо отображается, а вот последующие... Начинаются проблемы, а именно, в подменю каждого уровня, теред первым <li> добавляется ссылка на головной пункт меню:
[IMG='http://puu.sh/9UXUY/ef16f8b791.png']
Где я допустил ошибку, не могу разобраться.

nops Группа 5а5 03 июля 2014, 15:55:08

Коллеги, разобрался самостоятельно. Просто невнимательность. На случай, если у кого-то произойдет такое же по неопытности или невнимательности, то вот решение:
вот код:
[CODE]$topmenu[0]['active'] = "<li class='first current '><a href='%URL'>%NAME %NEXT_LEVEL</a></li>";

$topmenu[0]['unactive'] = "<li class='even '><a href='%URL'>%NAME %NEXT_LEVEL</a></li>";[/CODE]
Ошибка в месте написания глобальной переменной %NEXT_LEVEL
Необходимо вынести ее за пределы <a href="">.....</a>
Выглядеть должно:
[CODE]$topmenu[0]['active'] = "<li class='first current '><a href='%URL'>%NAME</a>%NEXT_LEVEL</li>";
$topmenu[0]['unactive'] = "<li class='even '><a href='%URL'>%NAME</a>%NEXT_LEVEL</li>";[/CODE]

werba Левчук Сергей 01 марта 2015, 23:58:48

А я вот так реализовал вот такое 3-х уровневое меню.

<ul id="mega-menu-1" class="mega-menu">
<li><a href="#">О компании</a></li>
<li><a href="#">Услуги</a>
<ul>
<li><a href="#">Mobile Phones & Accessories</a>
<ul>
<li><a href="#" class="link">Product 1</a></li>
<li><a href="#" class="link" >Product 2</a></li>
<li><a href="#" class="link">Product 3</a></li>
</ul>
</li>
<li><a href="#">Desktop</a>
<ul>
<li><a href="#" class="link">Product 4</a></li>
<li><a href="#" class="link">Product 5</a></li>
<li><a href="#" class="link">Product 6</a></li>
<li><a href="#" class="link">Product 7</a></li>
<li><a href="#" class="link">Product 8</a></li>
<li><a href="#" class="link">Product 9</a></li>
</ul>
</li>
<li><a href="#">Laptop</a>
<ul>
<li><a href="#" class="link">Product 10</a></li>
<li><a href="#" class="link">Product 11</a></li>
<li><a href="#" class="link">Product 12</a></li>
<li><a href="#" class="link">Product 13</a></li>
</ul>
</li>

</ul>
</li>

<li><a href="#">Объекты</a></li>
<li><a href="#">Важно знать</a></li>
<li><a href="#">Задать вопрос</a></li>
<li><a href="#">Гарантии</a></li>
<li><a href="#">Контакты</a></li>

</ul>

$cat_template[0]['prefix'] = "";
$cat_template[0]['suffix'] = "";
$cat_template[0]['active'] = "<li><a style='color:#ff9b00' >%NAME </a>" ;
$cat_template[0]['active_link'] = "";
$cat_template[0]['unactive'] = " <li><a href='%URL'>%NAME </a>%NEXT_LEVEL ";

$cat_template[1]['prefix'] = "";
$cat_template[1]['suffix'] = "";
$cat_template[1]['active'] = "";
$cat_template[1]['active_link'] = "";
$cat_template[1]['unactive'] = "<ul><li><a href='%URL'>%NAME </a> %NEXT_LEVEL ";

$cat_template[2]['prefix'] = "";
$cat_template[2]['suffix'] = "";
$cat_template[2]['active'] = "";
$cat_template[2]['active_link'] = "";
$cat_template[2]['unactive'] = "<ul><li><a class='link' href='%URL'>%NAME</a></li></ul></ul> ";

в макете дизайна вставлено это

<ul id='mega-menu-1' class='mega-menu'>
<?= nc_browse_sub(4, $cat_template); ?>
</ul>

Пример можете посмотреть на моём новом проекте www.stroyexpro.ru

A.Popov Kit.team 10 июля 2014, 13:02:50

Почему нельзя на 2-ом сайте вывести список подразделов от первого сайта с помощью этой функции?

ru__slan Руслан Асадулин 06 августа 2014, 16:47:37

каким образом мне вставить туда некий запрос, например
- подсчитать сколько объектов в текущем разделе
- вывести переменную $i которая была доступна в s_browse_sub
и вообще, каким образом делать там вставку php?

amigo 13 августа 2014, 10:02:37

Для вставки PHP воспользуйтесь функцией s_browse_sub или [URL='http://netcat.ru/developers/docs/navigation/class/']новым классом навигации[/URL].

Добавили в описание все возможные переменные.

John Smith 17 декабря 2014, 17:59:57

Не вижу чтобы в документации было как-либо рассказано о том, в каком формате должна задаваться [B]$where_cond[/B].

Методом тыка получилось сделать вывод только элементов у которых стоит в админке чекбокс (поле в системной таблице разделов). Для этого в виде строки было просто указано имя этого поля.

amigo 22 декабря 2014, 10:25:15

Добавлен пример

Наверх