laravel-umami

Laravel Umami는 Laravel 애플리케이션에 Umami 분석을 쉽게 추가할 수 있는 패키지를 제공합니다. 이 패키지는 spatie/laravel-settings에 의존하여 모든 Umami 설정 값을 데이터베이스에 저장하므로, 코드를 수정하지 않고도 설정을 쉽게 변경할 수 있습니다. 주요 기능: - 간단한 Blade 포함: 레이아웃에 @include('umami::script')를 추가하면 추적 스크립트가 로드됩니다. - 데이터베이스 기반 설정: 웹사이트 ID, 호스트 URL, 도메인允许 목록, 자동 추적 플래그 등 다양한 옵션이 settings 테이블에 저장되며 코드나 관리자 UI를 통해 편집 가능합니다. - 쿼리 문자열 또는 해시 부분 제외 옵션과 함께 페이지뷰와 이벤트를 기본값으로 자동 추적합니다. - 더 정확한 분석을 위해 사용자 정의 태그와 도메인 제한을 지원합니다. 설치 단계: 1. Composer로 패키지를 설치합니다. 2. spatie/laravel-settings가 설치되어 있고 마이그레이션이 실행되었는지 확인합니다. 3. 패키지가 제공하는 Umami 설정 마이그레이션을 발행하고 실행합니다. 4. Blade 레이아웃에 스크립트 include를 추가합니다. 설정 예시 (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, 변경 로그, 기여 지침을 참조하세요.