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

Онлайн-руководство разработчика 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_objects_list()

nc_objects_list( $sub, $cc, $params, $show_in_admin_mode=false )

выводит данные из другого инфоблока

Функция выводит объекты инфоблока номер $cc (ID в таблице Sub_Class) раздела $sub (ID в таблице Subdivision). В третьем параметре передается набор дополнительных необязательных параметров в формате: &param1name=value&param2name=value.

Параметр	Описание
nc_ctpl	номер шаблона компонента, который будет использован для вывода данных
nc_title=1	подключить специальный шаблон «для титульной страницы»
recNum	количество объектов, которое будет выведено
curPos	номер объекта по очереди, с которого надо начать вывод
nc_page	номер страницы (если переменная nc_page задана, значение переменной curPos будет установлено исходя из номера страницы и количества объектов на странице)
	любые другие параметры, которые должны обрабатываться в компоненте для сортировки, выборки, настройки отображения и т.д.

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

<?= nc_objects_list( 11, 22, "&recNum=3&show_random=1&nc_ctpl=33" ); ?>

Эта функция отобразит три объекта из инфоблока номер 22 раздела номер 11. Данные будут отображены в шаблоне компонента номер 33. При этом, параметр $show_random должен быть обработан в шаблоне компонента, иначе он ни на что не влияет.

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

Максим 18 мая 2015, 14:28:42

show_random - понятно, будет показывать объекты произвольно. А как задать параметр показа по убыванию (возростанию) цены?

amigo 01 июня 2015, 14:08:17

Максим, передавайте дополнительный параметр:
[CODE]<?= nc_objects_list( 11, 22, "&recNum=3&show_random=1&nc_ctpl=33&sort_by=up" ); ?>[/CODE]
в системных настройках проверяйте переменную:
[CODE]if ($sort_by == "up") {
$query_order = "Price DESC";
}[/CODE]

fazli ymv 10 октября 2015, 12:47:56

Как настроить выборку по производителю ?

VV VVStudio 27 июля 2015, 08:38:20

Ребят, у вас у самих в коде шаблона:
nc_objects_list(0, $template_settings['news_cc'], '&recNum=5');

Т.е. получается что $sub вообще не обязательно указывать. Я прав? Ну и да.. логично, зачем он вообще тут нужен не понимаю. Может стоит создать еще один такой метод, который на вход будет только $cc принимать?:

Руслан Густокашин Студия Вэлпис 27 июля 2015, 08:44:49

Да, с определенной версии netcat $sub стал необязательным. Он оставлен в функции только для совместимости со старыми проектами.

VV VVStudio 27 июля 2015, 09:24:32

А можно это как то в документации указать?
А то приходится это их каких то других случайных источников узнавать.
Спасибо!

Руслан Густокашин Студия Вэлпис 27 июля 2015, 09:29:06

Да, хорошо бы! Надеюсь, разработчики прочитают эти комментарии и поправят документацию.:)

nops Группа 5а5 14 сентября 2015, 20:57:40

А подскажите. если я хочу вывести данные исходя из раздела, в котором нахожусь. У меня реализован вывод случайных фотографий из фотогалереи, на всех страницах фотоальбома вот так:[CODE]".nc_objects_list( 645,680, "&nc_ctpl=109&recNum=1" )."[/CODE]
Я добавил еще один раздел и в нем инфоблоки, номера которых другие. Сейчас получается, что я в шаблоне указал выводить конкретно данные из указанного раздела.
Подскажите, что написать, что номера раздела и инфоблока подставлялись сами исходя из того, в из какого раздела открыта страница?

Руслан Густокашин Студия Вэлпис 15 сентября 2015, 10:17:15

Вместо номера раздела в функцию nc_objects_list можно передавать 0 - все равно этот номер уже никак не проверяется и все основывается на номере инфоблока (680 в вашем случае).
Поставьте вместо 680 $cc - скорее всего это будет то, что вам нужно, если я верно понял обстоятельства вашей задачи. :)

nops Группа 5а5 15 сентября 2015, 12:03:10

Да, я так и сделал.
Знаете как бывает?! Сначала голову ломаешь, напишешь в итоге вопрос, и решение само собой приходит...;-)
Огромное спасибо за уделенное время:-)

Руслан Густокашин Студия Вэлпис 15 сентября 2015, 12:08:37

Да, бывает! хорошо, что разобрались. :)

proskurnin 18 ноября 2016, 01:26:25

Как реализовать при помощи show_random выборку трех случайных статей?

Руслан Густокашин Студия Вэлпис 18 ноября 2016, 04:40:20

Сделайте в системных настройках отображаемого компонента такую конструкцию:
if($show_random) $query_order="RAND()";
А переменная recNum уже и так обработается системой, для нее IF делать не нужно.

kazadai90 06 февраля 2017, 14:23:56

У вас ужасная документация! Люди, срочно делайте что-нибудь с этим. Я уж молчу, что у вас верстка вся на сайте плывет

Nexwich Панасин Александр 12 июля 2017, 11:29:11

Им наплевать.

Control ООО "Контрол" 22 мая 2017, 11:18:23

Вывожу в раздел 3 последних новости (реализовано слайдером)
Как убрать обвёртку которую делает сам неткат? Она мешает работе слайдера

<div class="tpl-block-list tpl-component-113" id="nc-block-ebc73cb64dde79a83d91720f19cb1040">
...
</div>

Nexwich Панасин Александр 12 июля 2017, 11:28:09

UPDATE `Class` SET `DisableBlockMarkup` = 1

skyvin 01 ноября 2017, 16:23:08

Это в системные настройки нужно вставлять?

Александр Акцент-Дон 25 мая 2018, 11:06:15

Это в Инструменты - Командная строка SQL и дать один раз этот запрос. Потом если ещё создали новый компонент ещё раз дать такой запрос. С версии 5.9. это можно галочкой сделать в Настройках системы 1 раз и не мучаться больше.

Александр Акцент-Дон 25 мая 2018, 11:07:28

Подскажите, ранее если компонент в разделе был выключен, то если из него через nc_objects_list выводить объекты, они выводились. Сейчас в 5.9. не хочет выводиться ни в какую... Это ошибка или так переделали неудачно ?!

Дмитрий Коновалов Activica 25 июня 2018, 09:54:44

Что значит параметр $show_in_admin_mode ?
У этой функции есть еще параметр $get_current_cc, который не указан в документации - что он значит?

Дмитрий Коновалов Activica 25 июня 2018, 09:55:43

Вы можете еще документировать параметры в коде? чтоб не приходилось каждый раз обращаться к документации, где половина параметров оказывается не описаны?

Александр Александр / ITGeekz 09 июля 2018, 16:15:58

не понятно как обратиться к конкретному объекту - за номером 290 (например) и как выводить скажем не все объекты в каталоге, а перечень (например за ID 292, 293,294, 297) - оставшиеся же не попадут в вывод

Макс 16 декабря 2019, 10:55:58

Как задать отбор? нужно вывести выборку записей с отбором в цикле.
Вместо такого вот:
$res = $nc_core->db->get_results("SELECT * FROM `Message169` WHERE `subUnit`=$f_Message_ID", ARRAY_A );
...
foreach($res as $row){ ....
............ // вывод значений на страницу....
}

Наверх