Koko Analytics

Abstract

1. Introduction

Screenshot of the Koko Analytics dashboard. You can view a live demo here.

Koko Analytics provides website analytics and visitor statistics directly inside your WordPress dashboard without relying on external services. It is privacy-friendly, lightweight, open source, and easy to use.

Koko Analytics is privacy friendly analytics. No personal data is processed or stored, all measurements are carried out completely anonymously and nothing is ever shared with any third-party service.

2. Objective

Privacy-friendly, open-source analytics for WordPress — GDPR compliant, cookieless, and fast

This project demonstrates how PHP can be applied to a real-world Digital Marketing & SEO problem.

3. Key Features / Modules

• A beautiful analytics dashboard built right into WordPress admin.
• View statistics for your most popular posts and pages.
• See referral statistics showing which sites send you traffic.
• Path-based tracking to see analytics for any URL, including archives and search pages.
• Reliably detect returning visitors without the use of cookies.
• Exclude visits from certain WordPress user roles or IP addresses.
• Import historical statistics from Jetpack Stats, Plausible or Burst Statistics.
• Periodically clean-up historical data older than a specified number of months or years.
• A widget, Gutenberg block or shortcode to show a list of your most visited posts or pages.
• A shortcode or Gutenberg block to show the total number of pageviews to a given page.

4. Technology Stack

5. System Requirements

General requirements for this technology stack — check the README for exact versions.

• PHP 7.4+ with a web server (XAMPP / WAMP / LAMP)
• MySQL / MariaDB
• phpMyAdmin (optional)
• Git (to clone the repository)

6. Installation & Setup

git clone https://github.com/ibericode/koko-analytics.git
cd koko-analytics

1. In your WordPress dashboard, go to Plugins → Add New
2. Search for “Koko Analytics”
3. Click Install and Activate — stats start recording immediately

git clone git@github.com:ibericode/koko-analytics.git wp-content/plugins/koko-analytics
cd wp-content/plugins/koko-analytics
composer install
npm install
npm run build

Full setup instructions are in the project README.

7. Future Enhancements

Suggested extensions you can add to make this your own project.

• Export reports to Google Sheets or PDF
• Schedule weekly automated reports
• Add competitor comparison

8. Viva / Review Questions

Common questions examiners ask for projects in this domain.

1. Which marketing or SEO problem does this tool solve?
2. Which data sources or APIs does it use (Search Console, Analytics, social platforms)?
3. Which metrics or KPIs does it report and how are they calculated?
4. How could the output help a business make decisions?
5. How would you schedule it to run automatically?

9. Source Code & License

This project is developed by ibericode and published on GitHub under the GNU General Public License v3.0. Please follow the license terms and credit the original author when you use or modify this code.