프로젝트 소개

publii-goatcounter-analytics-plugin은 오픈소스 정적 사이트 생성기이자 CMS인 [Publii](https://getpublii.com/)의 플러그인입니다. 이 플러그인은 사이트 소유자가 사용자 프라이버시를 해치지 않고 [GoatCounter](https://www.goatcounter.com) 분석 및 선택형 방문자 카운터를 출판된 웹사이트에 삽입할 수 있도록 합니다. ## 기능 - Publii에서 생성된 사이트에 GoatCounter 추적 코드를 간단히 통합 - HTML, SVG, PNG 등 여러 포맷 옵션이 있는 선택형 방문자 카운터 표시 - CSS 셀렉터를 사용한 카운터 위치 사용자 정의(기본값: `footer`) - 카운터에서 "by GoatCounter" 브랜드 텍스트 제거 옵션 - 라이브 게시 전 분석 테스트를 위한 미리보기 모드 지원 ## 설정 플러그인을 구성하려면: 1. **GoatCounter 엔드포인트 입력**: GoatCounter 엔드포인트 URL을 복사하여 Publii 내 플러그인 설정 필드에 붙여넣습니다. 2. **플러그인 설정으로 이동**: Publii에서 사이트 설정으로 가서 플러그인 섹션 아래의 GoatCounter Integration 플러그인을 찾습니다. 3. **GoatCounter 코드 입력**: 사이트를 연결하기 위해 제공된 필드에 GoatCounter 분석 코드를 붙여넣습니다. 4. **미리보기 모드**: 테스트 중 미리보기 모드에서 분석 출력을 선택적으로 활성화할 수 있습니다. 왜곡된 데이터가 발생하지 않도록 실시간으로 게시하기 전에 비활성화합니다. ## 방문자 카운터 사이트에 방문자 카운터를 표시하려면: 1. **카운터 활성화**: 플러그인 설정에서 "Show Visitor Counter" 옵션을 체크합니다. 또한 GoatCounter 사이트 설정 패널에서 "Allow adding visitor counts on your website" 옵션을 켜야 하는데, 이는 기본적으로 꺼져 있습니다. 2. **CSS 셀렉터 설정**: 카운터가 추가될 부모 요소의 CSS 셀렉터를 지정합니다(기본값: `footer`). 3. **카운터 타입 선택**: HTML, SVG, PNG 포맷 중 선택합니다. 4. **브랜드 제거**: 선택적으로 "by GoatCounter" 출처 텍스트를 숨길 수 있습니다. ## 사용자 정의 선택한 카운터 유형에 따라 CSS 사용자 정의를 사용할 수 있습니다: - **HTML 카운터**: 주변 `div`와 내부 요소를 스타일링합니다. - **SVG 카운터**: CSS를 통해 `#gcvc-border`, `#gcvc-for`, `#gcvc-views`, `#gcvc-by` 요소를 사용자 정의합니다. 자세한 스타일링 가이드는 [GoatCounter 문서](https://www.goatcounter.com/help/visitor-counter)를 참조하십시오. ## GDPR 동의 이 플러그인은 GoatCounter가 일반적으로 명시적 동의 고지 없이도 GDPR 준수 대상으로 간주되기 때문에 GDPR 승인을 처리하지 않습니다. 자세한 내용은 [GDPR consent notices](https://www.goatcounter.com/help/gdpr)를 참조하십시오. ## 라이선스 MIT License. pull request나 GitHub 이슈를 통한 기여를 환영합니다.