Koko Analytics – Privacy-Friendly Statistics

변경이력

2.0.20 – Nov 14, 2025

• Fix hard-coded table prefix in data export file.
• Increase batch size during data migration to v2 format from 500 to 1000 rows.
• Drop temporary table after data migration to v2.

2.0.19 – Oct 15, 2025

• Print (< 500 bytes) tracking script inline in page HTML to save on an additional HTTP request and resolve overly aggressive cache issues.
• Add importer for Plausible.
• Change public dashboard URL to /koko-analytics-dashboard/ if pretty permalinks are enabled.
• Exclude visits to post previews.

2.0.18 – Sep 24, 2025

• Add filename alias for Pageview_Aggregator class so old autoloader knows where to find it. This fixes an error for users upgrading from 1.x with data in the temporary buffer file.
• Data importer now uses default WPDB connection and shows errors.
• Fallback to path if post title is empty or null.
• Replace section about Koko Analytics Pro with a smaller ‘powered by …’ link for public dashboards.

2.0.17 – Sep 20, 2025

• Fix most viewed posts widget using old shortcode class name.

2.0.16 – Sep 19, 2025

• Prevent persistent object caches from breaking database migration lock mechanism.
• Add site URL to database export filename.
• Export table structure at the time of export.
• Database connection in importer now logs warnings instead of throwing an exception on database errors.

2.0.15 – Sep 17, 2025

• Fix count of total number of rows in table for grouped result.
• Fix compatibility with Borlabs Cookie library script.
• Add koko_analytics_write_data_export action hook.
• Show success/error message after certain user-initiated admin actions.
• Minor performance gain on dashboard.

2.0.14 – Sep 15, 2025

• Fix issue in v2 data migration for sites with over 500 distinct public posts.
• Fix pagination showing up despite there being no more items.
• Fix styling of file upload button on settings page.
• Disallow access to public dashboard for anything resembling a bot or crawler.

2.0.13 – Sep 11, 2025

• post_id column on wp_koko_analytics_post_stats table should be of type INT, not MEDIUMINT. This fixes an issue on sites with post ID’s larger than 16777215.
• Fix datepicker dropdown heading spanning multiple lines on certain translations.

2.0.12 – Sep 09, 2025

• Fix incorrect post paths from data migration to v2.
• Fix table cell width on small screens for pageviews column.
• Add normalizer rule for AMP urls.
• Group on path_id to prevent duplicate paths for front-pages.
• Minor performance improvement in class autoloader.
• Run database migrations at wp_loaded hook to ensure all custom post types are registered.

2.0.11 – Aug 29, 2025

• Add script to correctly map post ID to path for sites where this went wrong.

2.0.10 – Aug 29, 2025

• Show page title again for records that have one.
• Fix the same path mapping to multiple entries in the wp_koko_analytics_paths table.
• Defend against stale client-side configuration object due to aggressive full-page caching.
• Drop database tables when using “reset statistics” button.

2.0.9 – Aug 28, 2025

• Automatically run the v2 data migration for tables with less than 25.000 total records.
• Pageviews column should be at least 6 characters wide to allow for 6-figure numbers.
• Improve performance of post stats migration script.
• Ship aggregator class on old filesystem location to prevent error from old autoloader.

2.0.8 – Aug 28, 2025

• Add WP CLI command for initiating post stats migration to v2: wp koko-analytics migrate_post_stats_to_v2
• Add WP CLI command for initiating referrer stats migration to v2: wp koko-analytics migrate_referrer_stats_to_v2
• Slightly decrease font-size for analytics ashboard in general and chart tooltip.
• Drop database tables on plugin uninstall.
• Truncate new paths table when resetting statistics.
• Switch to a single column grid at 1200px instead of 992px.

2.0.7 – Aug 28, 2025

• Run data migration at later hook so that custom post types have a chance to register.
• Delete seriously malformed referrer URL’s from stats.
• Fix z-index of datepicker component.

2.0.5 – Aug 27, 2025

• Failsafe against missing referrer URL in buffer file.
• Fix warning about array to string conversion in wpdb class.
• Fix warning about foreach argument being null.
• Fix [koko_analytics_counter] shortcode not using path from post in “the loop” anymore.

2.0.3 – Aug 27, 2025

• Fix referrer migration notice re-appearing if certain records could not be migrated (due to being malformed).
• Fix table columns being pushed off the screen due to long text not truncating.
• Ensure post_stats primary key is properly created for new sites.

2.0.2 – Aug 27, 2025

• Delay running potentially expensive database migration until after site administrator clicks a button.

2.0.1 – Aug 27, 2025

This release introduces path based tracking and improved dashboard styles. If you have many different posts/pages or are concerned about your historical data being affected, please back-up your Koko Analytics database tables before updating to this version.

• With path based tracking, any page can be tracked. This includes category archives, search result pages and non-existing pages. The most viewed posts widget and shortcode are unaffected and retain their previous functionality.
• Improved dashboard CSS styling so that the standalone dashboard is now styled the same as the WordPress embedded dashboard.
• Only whitelisted referrer domains can include full page URL’s.
• Referrers are not automatically hyperlinked anymore.
• Various other minor performance, security or code maintenance improvements.

1.8.6 – Jul 24, 2025

• Mention geo-location, a new premium feature, in the settings page sidebar.
• Improved height of select and textarea elements on settings page.

1.8.5 – Jul 21, 2025

• Add new action hook to add table rows before the submit button on the settings page: koko_analytics_extra_settings_rows_before_submit
• Rewrite optimized endpoint to allow for filter and action hooks.
• Allow other plugins to filter pageview data in optimized endpoint.
• Allow other plugins to add PHP files to include in optimized endpoint.

1.8.4 – Jun 18, 2025

• Backwards compatibility with older versions of the tracking script. This is a special update for sites refusing to serve the latest version of the Koko Analytics script because of very stubborn caching plugins…

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 쇼트코드의 속도를 높입니다.
• 이제 마이그레이션 러너는 각 개별 단계 후에 로컬 데이터베이스 버전을 업데이트합니다.
• 이제 마이그레이션 러너에는 원자적으로 실행되도록 하는 간단한 잠금 메커니즘이 있습니다.
• 현지화된 형식으로 데이터베이스 크기를 출력합니다.
• wp_date()를 통해 현지화된 형식으로 날짜를 출력합니다. 도미니크 실링에게 감사드립니다.
• 설정 페이지에서 누락된 텍스트 도메인을 추가합니다. 도미니크 실링(Dominik Schilling)에게 감사드립니다.

1.4.5 – Nov 14, 2024

• 대시보드의 모든 숫자에 현지화된 숫자 서식을 사용합니다.
• Add feature to export and import data. …