Koko Analytics – 워드프레스용 프라이버시 친화적인 통계

변경이력

2.1.0 – Dec 08, 2025

• 새로운 설정 페이지 구조!
• WP 코어의 기존 제거 가능한 쿼리 인수를 알림에 사용하십시오.

2.0.22 – Dec 01, 2025

• 블록 유형에 대해 apiVersion을 지정하여 WP 6.9에서 새로운 iframe 편집기를 사용할 수 있도록 합니다.

2.0.21 – Nov 28, 2025

• 차단된 리퍼러 도메인을 소급 적용하여 정리합니다.
• 설정 페이지에서 이중 에코 현상 수정.
• 특정 MySQL 설치 환경에서 고아 참조 행을 삭제할 때 발생하는 쿼리 중단 현상 수정.
• WP CLI에 wp koko-analytics prune 명령어를 추가합니다.

2.0.20 – Nov 14, 2025

• 데이터 내보내기 파일의 하드코딩된 테이블 접두사 수정.
• V2 형식으로의 데이터 마이그레이션 시 배치 크기(500행 → 1000행) 증가.
• V2로 데이터 마이그레이션 후 임시 테이블을 삭제합니다.

2.0.19 – Oct 15, 2025

• 추가 HTTP 요청을 줄이고 지나치게 공격적인 캐시 문제를 해결하기 위해 추적 스크립트(500바이트 미만)를 페이지 HTML에 인라인으로 출력합니다.
• Plausible용 가져오기 기능 추가.
• 예쁜 퍼머링크가 활성화된 경우 공개 대시보드 URL을 /koko-analytics-dashboard/로 변경합니다.
• 게시물 미리보기 방문을 제외합니다.

2.0.18 – Sep 24, 2025

• 이전 자동 로더가 해당 클래스의 위치를 알 수 있도록 Pageview_Aggregator 클래스에 파일 이름 별칭을 추가합니다. 임시 버퍼 파일에 데이터가 있는 1.x에서 업그레이드하는 사용자의 오류를 수정합니다.
• 데이터 임포터가 이제 기본 WPDB 연결을 사용하고 오류를 표시합니다.
• 포스트 제목이 비어 있거나 null인 경우 경로로 대체합니다.
• 공개 대시보드에서 Koko Analytics Pro 관련 섹션을 더 작은 ‘제공’ 링크로 대체합니다.

2.0.17 – Sep 20, 2025

• 가장 많이 본 게시물 위젯을 구형 단축코드 클래스 이름으로 수정.

2.0.16 – Sep 19, 2025

• 지속적 객체 캐시가 데이터베이스 마이그레이션 잠금 메커니즘을 방해하지 않도록 방지합니다.
• 데이터베이스 내보내기 파일명에 사이트 URL 추가.
• 내보내기 시점에 테이블 구조를 함께 내보냅니다.
• 임포터의 데이터베이스 연결 시 오류 발생 시 예외 처리 대신 경고 로그 기록으로 변경.

2.0.15 – Sep 17, 2025

• 그룹화 결과에 대한 테이블 총 행 수 계산 오류 수정.
• Borlabs Cookie 라이브러리 스크립트와의 호환성 문제 수정.
• koko_analytics_write_data_export 액션 후크를 추가합니다.
• 특정 사용자 시작 관리 작업 후 성공/오류 메시지 표시.
• 대시보드에서 성능이 약간 향상되었습니다.

2.0.14 – Sep 15, 2025

• 공개 게시물이 500개 이상인 사이트의 v2 데이터 마이그레이션 문제 수정.
• 더 이상 항목이 없음에도 페이지네이션이 표시되는 문제 수정.
• 설정 페이지의 파일 업로드 버튼 스타일링 수정.
• 봇이나 크롤러로 보이는 모든 것에 대해 공개 대시보드 접근을 차단합니다.

2.0.13 – Sep 11, 2025

• wp_koko_analytics_post_stats 테이블의 post_id 열은 MEDIUMINT가 아닌 INT 유형이어야 합니다. 이렇게 하면 게시물 ID가 16777215 보다 큰 사이트의 문제가 해결됩니다.
• 특정 번역에서 날짜 선택기 드롭다운 제목이 여러 줄에 걸쳐 표시되는 문제 수정.

2.0.12 – Sep 09, 2025

• V2로 데이터 마이그레이션 시 잘못된 게시물 경로 수정.
• 작은 화면에서 페이지뷰 열의 테이블 셀 너비 수정.
• AMP URL용 정규화 규칙 추가.
• 프론트 페이지의 중복 경로 방지를 위해 path_id로 그룹화.
• 클래스 자동 로더에서 성능이 약간 개선되었습니다.
• 모든 사용자 정의 글 유형이 등록되었는지 확인하기 위해 wp_loaded 후크에서 데이터베이스 마이그레이션을 실행합니다.

2.0.11 – Aug 29, 2025

• 이 기능이 제대로 작동하지 않는 사이트에서 게시물 ID를 경로에 올바르게 매핑하는 스크립트 추가.

2.0.10 – Aug 29, 2025

• 페이지 제목이 있는 레코드에 대해 제목을 다시 표시합니다.
• wp_koko_analytics_paths 테이블의 여러 항목에 동일한 경로 매핑을 수정합니다.
• 과도한 전체 페이지 캐싱으로 인한 클라이언트 측 구성 객체의 오래된 상태를 방지합니다.
• “통계 초기화” 버튼 사용 시 데이터베이스 테이블을 삭제합니다.

2.0.9 – Aug 28, 2025

• 총 레코드 수가 25,000개 미만인 테이블에 대해 v2 데이터 마이그레이션을 자동 실행합니다.
• 페이지뷰 열은 6자리 숫자를 수용할 수 있도록 최소 6자 너비여야 합니다.
• 포스트 통계 마이그레이션 스크립트 성능 개선.
• 구형 오토로더 오류 방지를 위해 어그리게이터 클래스를 기존 파일 시스템 위치에 배포합니다.

2.0.8 – Aug 28, 2025

• V2로 게시물 통계 마이그레이션을 시작하는 WP CLI 명령어 추가: wp koko-analytics migrate_post_stats_to_v2
• 리퍼러 통계 v2 마이그레이션 시작용 WP CLI 명령어 추가: wp koko-analytics migrate_referrer_stats_to_v2
• 분석 대시보드 전체 및 차트 툴팁의 글꼴 크기를 약간 줄입니다.
• 플러그인 제거 시 데이터베이스 테이블을 삭제합니다.
• 통계 초기화 시 새 경로 테이블을 잘라냅니다.
• 1200px에서 단일 열 그리드로 전환합니다(기존 992px 기준).

2.0.7 – Aug 28, 2025

• 커스텀 포스트 타입이 등록될 수 있도록 데이터 마이그레이션을 후행 훅에서 실행합니다.
• 심각하게 잘못된 리퍼러 URL을 통계에서 삭제합니다.
• 데이트피커 컴포넌트의 z-index 수정.

2.0.5 – Aug 27, 2025

• 버퍼 파일에서 리퍼러 URL이 누락된 경우 안전 장치 적용.
• Wpdb 클래스에서 배열을 문자열로 변환할 때 발생하는 경고 수정.
• Foreach 인자가 null인 경우 발생하는 경고 수정.
• [koko_analytics_counter] 단축코드가 더 이상 “루프” 내 포스트 경로를 사용하지 않도록 수정.

2.0.3 – Aug 27, 2025

• 특정 레코드(형식 오류로 인해) 마이그레이션 실패 시 재표시되던 리퍼러 마이그레이션 알림 수정.
• 긴 텍스트가 잘리지 않아 테이블 열이 화면 밖으로 밀려나는 문제 수정.
• 새 사이트에 대해 post_stats 기본 키가 올바르게 생성되도록 보장합니다.

2.0.2 – Aug 27, 2025

• 사이트 관리자가 버튼을 클릭한 후에만 비용이 많이 드는 데이터베이스 마이그레이션 실행 지연.

2.0.1 – Aug 27, 2025

이번 릴리스에서는 경로 기반 추적 기능과 개선된 대시보드 스타일을 도입했습니다. 다양한 게시물/페이지를 보유하고 있거나 기존 데이터에 영향이 갈까 우려되는 경우, 본 버전으로 업데이트하기 전에 코코 애널리틱스 데이터베이스 테이블을 백업하시기 바랍니다.

• 경로 기반 추적을 통해 모든 페이지를 추적할 수 있습니다. 여기에는 카테고리 아카이브, 검색 결과 페이지, 존재하지 않는 페이지도 포함됩니다. 가장 많이 본 게시물 위젯과 단축코드는 영향을 받지 않으며 기존 기능을 유지합니다.
• 독립형 대시보드의 CSS 스타일을 개선하여 워드프레스 내장 대시보드와 동일한 스타일 적용.
• 화이트리스트에 등록된 리퍼러 도메인만 전체 페이지 URL을 포함할 수 있습니다.
• 리퍼러가 더 이상 자동으로 하이퍼링크되지 않습니다.
• 기타 다양한 사소한 성능, 보안 또는 코드 유지보수 개선 사항.

1.8.6 – Jul 24, 2025

• 설정 페이지 사이드바에서 새로운 프리미엄 기능인 지리적 위치를 언급합니다.
• 설정 페이지의 select 및 textarea 요소 높이 개선.

1.8.5 – Jul 21, 2025

• 설정 페이지의 제출 버튼 앞에 테이블 행을 추가하는 새 작업 후크를 추가합니다: koko_analytics_extra_settings_rows_before_submit
• 필터 및 액션 훅을 허용하도록 최적화된 엔드포인트를 재작성합니다.
• 최적화된 엔드포인트에서 페이지뷰 데이터를 다른 플러그인이 필터링할 수 있도록 허용.
• 최적화된 엔드포인트에 포함할 PHP 파일을 다른 플러그인이 추가할 수 있도록 허용.

1.8.4 – Jun 18, 2025

• 구버전 추적 스크립트와의 하위 호환성 유지. 매우 완고한 캐싱 플러그인으로 인해 최신 코코 애널리틱스 스크립트 제공을 거부하는 사이트를 위한 특별 업데이트입니다…

1.8.2 – Jun 13, 2025

• PHP 8.0 이하에서 쿠키 없는 추적 수정.

1.8.1 – Jun 13, 2025

• 버전 1.8.0에서 도입된 최적화된 엔드포인트가 작동하지 않는 문제 수정

1.8.0 – Jun 12, 2025

• 새로운 추적 방법을 추가했습니다: 쿠키리스 추적.
• 쿠키 기반 추적을 사용하는 경우 쿠키 수명이 자정에 만료되도록 변경되었습니다(따라서 최대 24시간).
• 클라이언트 측 추적 스크립트를 간소화하여 이제 500바이트보다 작아졌습니다.
• 제외된 IP 주소는 이제 최적화된 엔드포인트에서 정상적으로 작동합니다.
• ‘모든 시간’에 대한 새로운 대시보드 날짜 사전 설정이 추가되었습니다.
• 작은 화면에서 많은 양의 데이터를 볼 때 막대가 보이지 않던 차트 문제를 수정했습니다.

1.7.4 – May 14, 2025

• 인라인 스크립트 태그를 인쇄하려면 wp_print_inline_script 함수를 사용합니다.
• 최적화된 엔드포인트 파일의 존재 여부를 확인하려면 file_exists 대신 is_file를 사용하세요.
• 최적화된 엔드포인트 파일이 플러그인 자체에서 생성된 경우 확인에 실패한 경우에만 제거합니다.

1.7.3 – Apr 15, 2025

• 설정 페이지 양식에 리퍼러를 명시적으로 추가합니다.
• 이전 메소드를 호출하는 WP CLI 명령 수정. 감사합니다 오스카 아르졸라!

1.7.2 – Mar 24, 2025

• 대시보드 위젯 차트에서 차트 그룹 옵션을 숨깁니다.
• Href 정규화 프로그램을 통해 대시보드 위젯에서 리퍼러 URL을 실행합니다.
• 차트 HTML 생성을 위한 아주 사소한 성능 최적화.

1.7.1 – Mar 10, 2025

• 일부 데이터베이스에서 데이터에 공백이 있는 경우 차트 막대가 제대로 정렬되지 않는 문제를 수정했습니다.
• 플러그인 패키지에 manifest.json 파일을 포함합니다.
• 업로드 디렉터리가 있는지 확인한 후 scandir를 호출하세요.
• 통계가 없는 경우 쿼리 루프 블록이 모든 게시물을 표시하지 않도록 수정했습니다.
• 대시보드 HTML에 대한 일부 W3C 유효성 검사 경고를 해결합니다.
• Reddit 하위 도메인을 단일 리퍼러 항목으로 통합합니다.

1.7.0 – Feb 25, 2025

• WP 엔진에서 호스팅되는 사이트와의 호환성(PHP 확장자를 가진 파일을 WP 업로드 디렉터리에 쓸 수 없음).
• 최적화된 엔드포인트 파일에서 상대 경로를 사용하여 사이트 자체를 파일 시스템에서 자유롭게 이동할 수 있습니다.
• 데이터 손실 없이 집계 로직을 변경할 수 있도록 upgrader_process_complete 후크에서 애그리게이터를 실행합니다.
• 파일이 여전히 존재하고 작동하는 것으로 확인된 경우에만 최적화된 엔드포인트를 사용하세요. 이렇게 하면 파일을 제거하면 즉시 기본 AJAX 엔드포인트로 전환할 수 있습니다.
• 가장 많이 본 글 위젯/단축코드에서 빈 결과 집합 대신 모든 글이 표시되는 버그가 수정되었습니다.
• 차트에 옵션별로 그룹을 추가합니다.
• 비교를 위해 기간을 더 잘 정렬합니다.

1.6.6 – Feb 18, 2025

• 쿠키를 사용하지 않을 때 동일 페이지 리퍼러 감지 수정.
• 날짜 선택기를 사용하여 날짜 기간을 변경할 때 페이지 필터를 유지합니다.
• 대시보드 위젯의 실시간 페이지뷰는 자정 직후에 조회한 경우 오늘의 페이지뷰로 제한합니다.

1.6.5 – Feb 10, 2025

• 버스트 통계의 데이터 가져오기 기능을 추가합니다.
• REST 엔드포인트에서 monthly 쿼리 매개변수에 “false” 및 “no”를 전달할 수 있도록 허용합니다.
• 매우 특정한 요청에서만 실행되는 코드를 적극적으로 지연 로딩하여 플러그인 부트스트랩 코드의 PHP 실행 시간을 최적화합니다. 일반 요청의 경우 OPcache를 사용하면 0.05ms에서 0.03ms(!)로, OPcache를 사용하지 않으면 1.44ms에서 0.54ms로 단축됩니다.
• 버퍼 파일에서 영구 저장소로 데이터를 집계하는 클래스에 대한 사소한 코드 개선.

1.6.4 – Jan 25, 2025

• 대시보드 데이터가 항상 REST API 엔드포인트를 통해 공개적으로 액세스할 수 있도록 수정합니다.

1.6.3 – Jan 21, 2025

• 누락된 koko_analytics_aggregate_stats 이벤트를 예약합니다.
• 페이지뷰 수가 항상 올바른 날짜에 추가되도록 하려면 WP Cron이 24시간 이상 중단되더라도 페이지뷰 수가 항상 올바른 날짜에 추가되도록 하세요.
• WP 크론 스톨의 경우 실시간 방문자 수 정확도가 개선되었습니다.
• 임시 버퍼 파일을 업로드 디렉터리 내의 자체 디렉터리로 이동합니다.
• 버전 1.6.2에 도입된 PHP 7.4의 구문 오류 수정
• 젯팩 가져오기: 하루 분량의 데이터를 가져올 때 0으로 나누기 수정
• 젯팩 가져오기: 젯팩 가져오기의 HTTP 요청 시간 제한을 5초에서 90초로 늘렸습니다.
• 젯팩 가져오기: 사용자 정의 청크 크기를 선택할 수 있어 글이나 페이지가 많은 사이트에 유용할 수 있습니다.
• 기본적으로 플러그인 제거 시 데이터베이스 테이블을 삭제하지 않습니다.

1.6.1 – Jan 20, 2025

• API가 오류 응답을 반환할 때 오류 로그에만 기록하는 대신 젯팩 가져오기에서 오류 세부 정보를 표시합니다.
• 플러그인 활성화에 대한 가지치기 데이터에 대한 예약 이벤트를 직접 등록하세요.
• null 매개변수를 사용하여 get_realtime_pageview_count() 함수를 호출할 수 있습니다.

1.6.0 – Jan 17, 2025

• 최소 요구되는 PHP 버전을 7.4 이상으로 상향 조정합니다.
• “this_week” 및 “last_week” 사전 설정의 날짜 생성 관련 문제를 수정했습니다.
• 차트 도구 설명 위치를 수정하여 가로로 넘치지 않도록 합니다.
• 스크롤 시 차트 도구 설명을 숨깁니다.
• 충분한 공간이 있는 대형 화면에서 페이지뷰 및 방문자 열의 열 너비를 확장합니다.
• 버전 1.5.5에 도입된 정의되지 않은 배열 키 알림을 수정합니다.
• 젯팩 임포터 기능의 모든 문자열을 번역할 수 있도록 설정하세요. Alex Lion에게 감사드립니다.
• start_date 매개변수 없이 호출할 경우 HTTP 500 오류를 반환하는 REST API 경로를 수정했습니다.

PS. 워드프레스 이외의 사이트를 추적할 수 있는 독립형 버전의 코코 애널리틱스를 개발하기 시작했습니다.

자세한 내용은 대니의 개인 블로그(https://www.dannyvankooten.com/blog/2025/building-privacy-friendly-website-analytics/)에서 확인할 수 있습니다.

1.5.5 – Jan 10, 2025

보류 중인 데이터베이스 마이그레이션을 확인하는 데 upgrader_process_complete를 사용하지 마세요. 이 특정 훅은 이전 버전의 플러그인을 사용하여 실행되므로 사용할 수 없습니다…

버전 1.5.2에서 이 변경 사항을 되돌리면 최적화 엔드포인트 파일이 기존 함수를 참조하는 문제를 해결할 수 있습니다.

1.5.4 – Jan 10, 2025

• 일부 설치에서 더 이상 기존 파일을 참조하지 않는 최적화된 엔드포인트 파일 수정.

1.5.3 – Jan 09, 2025

• 쿼리 루프 블록과의 통합을 추가합니다.
• 일요일에 ‘이번 주’ 또는 ‘지난 주’를 볼 때 날짜 범위를 수정합니다.
• 설정 페이지에서 코코 애널리틱스 프로의 비기능 설정 예시를 제거합니다.
• 최소 30일 이상 사용한 후 기부금을 요청하는 일회성 알림을 추가합니다.

1.5.2 – Dec 17, 2024

• 보류 중인 데이터베이스 마이그레이션을 실행하는 로직을 개선합니다.

1.5.1 – Dec 10, 2024

• 기본 PHP 표준 시간대를 사용하는 차트 도구 설명의 날짜를 수정하고 대신 사이트 표준 시간대를 명시적으로 사용하세요.
• 최적화되지 않은 엔드포인트에서 제외된 요청(IP 주소 또는 사용자 역할별)이 있는지 확인합니다.
• 페이지 URL에 쿼리 구성 요소가 없는 경우 대시보드에 PHP 알림이 표시되지 않도록 합니다.

1.5.0 – Nov 27, 2024

• 데이터 수집에 최대 리퍼러 URL 길이를 적용합니다.
• 방문자 및 페이지뷰 열 헤더를 작은 화면의 아이콘으로 바꿉니다.
• Stats::get_total이 이전 기간을 자동으로 가져오지 않도록 하여 koko_analytics_counter 단축코드의 속도를 높입니다.
• 마이그레이션 …