Об этом проекте

publii-goatcounter-analytics-plugin — это плагин для [Publii](https://getpublii.com/), открытой статической системы генерации сайтов и CMS. Он позволяет владельцам сайтов встраивать аналитику [GoatCounter](https://www.goatcounter.com) и необязательный счётчик посетителей в опубликованные сайты, не нарушая конфиденциальность пользователей. ## Особенности - Простая интеграция кода отслеживания GoatCounter в сайты, сгенерированные Publii. - Необязательный отображение счётчика посетителей с несколькими форматами: HTML, SVG и PNG. - Настраиваемое размещение счётчика с использованием CSS-селекторов (по умолчанию `footer`). - Возможность удалить текст «by GoatCounter» из счётчика. - Поддержка режима превью для тестирования аналитики перед публикацией вживую. ## Настройка Чтобы настроить плагин: 1. **Введите конечную точку GoatCounter**: Скопируйте URL конечной точки вашего GoatCounter в поле конфигурации плагина в Publii. 2. **Перейдите к настройкам плагина**: В Publii перейдите в настройки вашего сайта и найдите плагин интеграции GoatCounter в разделе Плагины. 3. **Введите код GoatCounter**: Вставьте ваш аналитический код GoatCounter в предоставленное поле, чтобы привязать ваш сайт. 4. **Режим превью**: По желанию включите вывод аналитики в режиме превью для тестирования. Отключите перед запуском в продакшн, чтобы избежать искажения данных. ## Счётчик посетителей Чтобы отобразить счётчик посетителей на вашем сайте: 1. **Включите счётчик**: Отметьте опцию «Показать счётчик посетителей» в настройках плагина. Также необходимо включить «Разрешить добавление счётчиков посетителей на ваш веб-сайт» в панели настроек вашего сайта GoatCounter, которая по умолчанию отключена. 2. **Установите CSS-селектор**: Укажите родительский элемент CSS-селектор, куда будет добавлен счётчик (по умолчанию `footer`). 3. **Выберите тип счётчика**: Выберите формат HTML, SVG или PNG. 4. **Удалите брендирование**: По желанию скройте текст «by GoatCounter». ## Настройка CSS-кастомизация доступна в зависимости от выбранного типа счётчика: - **HTML-счётчик**: Стилизация окружающего `div` и внутренних элементов. - **SVG-счётчик**: Настройка элементов `#gcvc-border`, `#gcvc-for`, `#gcvc-views` и `#gcvc-by` через CSS. Обратитесь к [документации GoatCounter](https://www.goatcounter.com/help/visitor-counter) для получения подробных рекомендаций по стилизации. ## Согласие GDPR Этот плагин не обрабатывает согласие GDPR, поскольку GoatCounter обычно считается соответствующим без необходимости явных уведомлений о согласии. См. [уведомления о согласии GDPR](https://www.goatcounter.com/help/gdpr) для получения дополнительной информации. ## Лицензия MIT License. Приветствуются вкладки через pull-запросы или вопросы на GitHub.