laravel-umami

Laravel Umami предоставляет простой способ добавить аналитику Umami в Laravel-приложение. Пакет опирается на spatie/laravel-settings для хранения всех значений конфигурации Umami в базе данных, что упрощает изменение настроек без вмешательства в код. Ключевые возможности: - Простое подключение в Blade: добавьте @include('umami::script') в макет для загрузки скрипта отслеживания. - Настройки на основе базы данных: ID сайта, URL хоста, белый список доменов, флаг автоотслеживания и другие параметры хранятся в таблице settings и могут быть изменены через код или административный интерфейс. - Автоматическое отслеживание просмотров страниц и событий из коробки с возможностью исключения query-строк или хэш-фрагментов. - Поддержка пользовательских тегов и ограничения по доменам для более точной аналитики. Шаги установки: 1. Установите пакет через Composer. 2. Убедитесь, что spatie/laravel-settings установлен и его миграция выполнена. 3. Опубликуйте и запустите миграцию настроек Umami, предоставляемую пакетом. 4. Добавьте подключение скрипта в ваш Blade-макет. Пример конфигурации (PHP): ``` use JeffersonGoncalves\Umami\Settings\UmamiSettings; $settings = app(UmamiSettings::class); $settings->website_id = 'your-website-id'; $settings->host_analytics = 'https://your-umami-instance.com'; $settings->save(); ``` Доступные настройки: - website_id (обязательная) - host_analytics (по умолчанию https://cloud.umami.is) - host_url (опциональное перекрытие) - auto_track (логический, по умолчанию true) - domains (через запятую) - tag (опциональный групповой тег) - exclude_search и exclude_hash (логические для удаления частей URL) Пакет совместим с PHP 8.2+ и Laravel 11+. Тесты запускаются через `composer test`. Распространяется под лицензией MIT. Для получения дополнительной информации см. README репозитория, changelog и руководство по внесению вкладов.