# =========================================================================== #
# Next Generation CMS // Плагины // Менеджер галерей (ng-helpers v0.2.2)     #
# =========================================================================== #
Модернизированная версия плагина галереи с использованием ng-helpers v0.2.2.
МОДЕРНИЗАЦИЯ С NG-HELPERS v0.2.2 [31 января 2026]:
✅ array_get() - безопасный доступ к $_REQUEST/$_POST (30+ замен)
✅ logger(message, level, file) - структурированное логирование
✅ Защита от "Undefined index" предупреждений
✅ Улучшенная безопасность всех параметров галерей и виджетов
ОСОБЕННОСТИ ВЕРСИИ:
✓ Оптимизированные SQL-запросы (JOIN вместо подзапросов)
✓ Интеграция с ng-helpers (кэширование, логирование, форматирование)
✓ Автоматическое подключение CSS/JS для скинов
✓ Корректное удаление связанных комментариев при деинсталляции
✓ Современные toast-уведомления через notify()
✓ Улучшенная обработка ошибок
Плагин позволяет:
 - создавать меню галереи;
 - управлять выводом галерей загруженных на сайт штатным образом;
 - создавать виджеты, для отображения изображений на сайте.
Особенности работы плагина:
 - плагин имеет собственную страницу;
 - плагин поддерживает отображение "хлебных крошек" при помощи плагина "breadcrumbs";
 - плагин имеет кеш, который очищается не чаще заданных промежутков времени, а также
   при внесении любых изменений в настройки плагина. При этом если вы изменяете
   настройки ЧПУ или редактируете шаблоны, процедуру очистки кеша необходимо
   выполнять вручную, при помощи кнопки "Очистить кеш" в настройках плагина.
Для того, чтобы отобразить список категорий галерей используйте переменную
{{ plugin_gallery_category }} в файле main.tpl.
Для отображения виджета - {{ plugin_gallery_NAME }} в файле main.tpl,
где NAME - это Заголовок виджета, который задается в настройках.
===============================================================================
Шаблон отображения списка категорий:
===============================================================================
category.tpl - Шаблон списка категорий
    {{ url_tpl }} - Ссылка на папку с шаблоном
    {{ url_main }} - Ссылка на главную страницу плагина
    {{ galleries }} - Массив галерей (категорий)
        {{ gallery.id }} - ID галереи в БД
        {{ gallery.name }} - Имя галереи
        {{ gallery.title }} - Название галереи
        {{ gallery.url }} - Ссылка на галерею
        {{ gallery.icon }} - Ссылка на изображение
        {{ gallery.icon_thumb }} - Ссылка на уменьшеное изображение, если такое изображение отсутствует то равен {{ gallery.icon }}
        {{ gallery.count }} - Количество изображений в галереи
===============================================================================
Шаблон главной страницы плагина со списком галерей:
===============================================================================
page_index.tpl - Шаблон страницы
    {{ plugin_title }} - Заголовок плагина (по умолчанию Галерея)
    {{ url_tpl }} - Ссылка на папку с шаблоном
    {{ url_main }} - Ссылка на главную страницу плагина, т.е. на эту
    {{ galleries }} - Массив галерей (категорий)
        {{ gallery.id }} - ID галереи в БД
        {{ gallery.name }} - Имя галереи
        {{ gallery.title }} - Название галереи
        {{ gallery.url }} - Ссылка на страницу галереи
        {{ gallery.icon }} - Ссылка на изображение
        {{ gallery.icon_thumb }} - Ссылка на уменьшеное изображение, если такое изображение отсутствует то равен {{ gallery.icon }}
        {{ gallery.count }} - Количество изображений в галереи
        {{ gallery.description }}- Описание изображения
        {{ gallery.keywords }} - Ключевые слова галереи
    {{ pagesss }} - Постраничная навигация
===============================================================================
Шаблон страницы галереи:
===============================================================================
page_gallery.tpl - Шаблон страницы
    {{ plugin_title }} - Заголовок плагина (по умолчанию Галерея)
    {{ url_tpl }} - Ссылка на папку с шаблоном
    {{ url_main }} - Ссылка на главную страницу плагина
    {{ gallery }} - Массив свойств текущей галереи
        {{ gallery.url }} - Ссылка на галерею
        {{ gallery.title }} - Название галереи
        {{ gallery.description }} - Описание галереи
        {{ gallery.keywords }} - Ключевые слова галереи
    {{ images }} - Массив изображений
        {{ image.id }} - ID изображения в БД
        {{ image.name }} - Имя изображения
        {{ image.url }} - Ссылка на страницу изображения
        {{ image.src }} - Ссылка на изображение
        {{ image.src_thumb }} - Ссылка на уменьшеное изображение, если такое изображение отсутствует то равен {{ image.src }}
        {{ image.description }}- Описание изображения
        {{ image.com }} - Количество комментариев к изображению
        {{ image.views }} - Количество просмотров изображения
        {{ image.width }} - Ширина изображения
        {{ image.height }} - Высота изображения
        {{ image.size }} - Размер изображения
    {{ pagesss }} - Постраничная навигация
===============================================================================
Шаблон страницы изображения:
===============================================================================
page_image.tpl - Шаблон страницы
    {{ plugin_title }} - Заголовок плагина (по умолчанию Галерея)
    {{ url_tpl }} - Ссылка на папку с шаблоном
    {{ url_main }} - Ссылка на главную страницу плагина
    {{ gallery }} - Массив свойств галереи, в которой находится изображение
        {{ gallery.url }} - Ссылка на галерею
        {{ gallery.title }} - Название галереи
        {{ gallery.description }} - Описание галереи
        {{ gallery.keywords }} - Ключевые слова галереи
    {{ image }} - Массив свойств изображения
        {{ image.id }} - ID изображения в БД
        {{ image.src }} - Ссылка на изображение
        {{ image.src_thumb }} - Ссылка на уменьшеное изображение, если такое изображение отсутствует то равен {{ image.src }}
        {{ image.name }} - Имя изображения
        {{ image.description }}- Описание изображения
        {{ image.com }} - Количество комментариев к изображению
        {{ image.views }} - Количество просмотров изображения
        {{ image.width }} - Ширина изображения
        {{ image.height }} - Высота изображения
        {{ image.size }} - Размер изображения
    Навигация по изображениям
    {{ prevlink }} - Предыдущее изображение в галереи, если текущее не крайнее
    {{ gallerylink }} - Ссылка на галерею
    {{ nextlink }} - Следующее изображение в галереи, если текущее не крайнее
    {{ plugin_comments }} - Отображение плагина комментариев
===============================================================================
Шаблоны отображения виджета:
===============================================================================
widget.tpl - Шаблон виджета
    {{ url_tpl }} - Ссылка на папку с шаблоном
    {{ url_main }} - Ссылка на главную страницу плагина
    {{ widget_title }} - Название виджета
    {{ images }} - Массив изображений
        {{ image.id }} - ID изображения в БД
        {{ image.title }} - Имя изображения
        {{ image.com }} - Количество комментариев к изображению
        {{ image.views }} - Количество просмотров изображения
        {{ image.src }} - Ссылка на изображение
        {{ image.src_thumb }} - Ссылка на уменьшеное изображение, если такое изображение отсутствует то равен {{ image.src }}
        {{ image.url }} - Ссылка на страницу изображения
        {{ image.description }}- Описание изображения
        {{ image.gallery_url }} - Ссылка на галерею
        {{ image.gallery_title }} - Название галереи
