# README для плагина "Cookie Notice" для NGCMS

## Описание

Плагин показывает гостям сайта всплывающее уведомление об использовании файлов cookie.
Уведомление отображается **один раз** — факт принятия сохраняется в `localStorage` браузера на заданное количество дней.

## Установка

1. Скопируйте папку `cookienotice` в директорию `/engine/plugins/`
2. Зайдите в панель администратора NGCMS
3. Перейдите в раздел «Плагины»
4. Найдите плагин «Cookie Notice» и нажмите «Установить»
5. После установки перейдите в настройки плагина

## Настройка

| Поле                   | Описание                                       | По умолчанию                |
| ---------------------- | ---------------------------------------------- | --------------------------- |
| Заголовок              | Заголовок всплывающего окна                    | Использование файлов Cookie |
| Текст уведомления      | Основной текст (поддерживает HTML)             | Стандартный текст           |
| Текст кнопки «Принять» | Подпись на кнопке согласия                     | Принять                     |
| Срок согласия (дней)   | Через сколько дней показать снова (0 = всегда) | 365                         |
| Позиция                | bottom / top / center                          | bottom                      |
| Только для гостей      | Не показывать авторизованным пользователям     | Включено                    |

## Использование в шаблоне

Добавьте вызов в TWIG-шаблон (обычно в `main.tpl` перед закрывающим `</body>`):

```twig
{{ callPlugin("cookienotice.show", {})|raw }}
```

## Дополнительные параметры вызова

Использовать альтернативный шаблон:

```twig
{{ callPlugin("cookienotice.show", {template: "cookienotice"})|raw }}
```

## Позиции блока

- `bottom` — фиксированная полоса снизу страницы (по умолчанию)
- `top` — фиксированная полоса сверху страницы
- `center` — модальное окно по центру экрана

## Кастомизация

Шаблон виджета: `/engine/plugins/cookienotice/tpl/cookienotice.tpl`
Для создания собственного оформления скопируйте шаблон в папку активного
тематического шаблона: `/templates/{ваш_шаблон}/plugins/cookienotice/`
и отредактируйте CSS внутри него.
