MokoConsulting/MokoSuiteClient
0
0
Fork 0
Code Issues 83 Pull Requests 1 Releases 3 Wiki Activity

feat: site analytics client — traffic analysis like Google Analytics #219

New Issue
Open
opened 2026-06-20 17:46:54 +00:00 by jmiller · 1 comment
jmiller commented 2026-06-20 17:46:54 +00:00
Owner
Copy Link
Copy Source

Summary

MokoSuiteClient needs a built-in analytics client that provides Google Analytics-style traffic analysis without requiring a third-party service. All data stays on the site or is sent to MokoSuiteClientHQ for aggregated dashboards.

Requirements

Data Collection (Frontend Plugin)

  • Page views (URL, title, referrer, timestamp)
  • Unique visitors (hashed IP + UA fingerprint, no PII)
  • Session tracking (session ID, duration, page count)
  • Traffic sources (referrer domain, UTM parameters, direct/organic/social)
  • Device/browser detection (UA parsing — device type, browser, OS)
  • Geographic location (via DB-IP integration already in MokoSuiteClient)
  • Bounce rate calculation (single-page sessions)
  • Entry/exit pages

Storage

  • Dedicated database tables for raw hits + daily aggregates
  • Automatic data retention / pruning (configurable, e.g. 90 days raw, 2 years aggregated)
  • Lightweight — must not degrade site performance

Reporting (Admin Dashboard)

  • Visitors over time (daily/weekly/monthly charts)
  • Top pages, top referrers, top search terms
  • Traffic source breakdown (direct, organic, social, referral)
  • Device/browser/OS breakdown
  • Geographic map or country breakdown
  • Real-time active visitors count
  • Comparison periods (this week vs last week)

Privacy

  • No cookies required (fingerprint-based, GDPR-friendly)
  • Respect Do Not Track header (configurable)
  • IP anonymization (hash, never store raw)
  • Bot/crawler filtering (exclude known bots from stats)

HQ Integration

  • Send daily aggregates to MokoSuiteClientHQ via heartbeat
  • HQ dashboard shows analytics across all managed sites

Architecture

  • plg_system_mokosuiteclient_analytics — frontend hit collector (lightweight JS-free server-side tracking)
  • Component views in com_mokosuiteclient — analytics dashboard with charts
  • plg_task_mokosuiteclient_analytics — scheduled aggregation + pruning task
  • Database tables: #__mokosuiteclient_analytics_hits, #__mokosuiteclient_analytics_daily

Prior Work

A MokoSuiteAnalytics repo previously existed but was deleted. This feature should be built directly into MokoSuiteClient as a core component.

## Summary MokoSuiteClient needs a built-in analytics client that provides Google Analytics-style traffic analysis without requiring a third-party service. All data stays on the site or is sent to MokoSuiteClientHQ for aggregated dashboards. ## Requirements ### Data Collection (Frontend Plugin) - Page views (URL, title, referrer, timestamp) - Unique visitors (hashed IP + UA fingerprint, no PII) - Session tracking (session ID, duration, page count) - Traffic sources (referrer domain, UTM parameters, direct/organic/social) - Device/browser detection (UA parsing — device type, browser, OS) - Geographic location (via DB-IP integration already in MokoSuiteClient) - Bounce rate calculation (single-page sessions) - Entry/exit pages ### Storage - Dedicated database tables for raw hits + daily aggregates - Automatic data retention / pruning (configurable, e.g. 90 days raw, 2 years aggregated) - Lightweight — must not degrade site performance ### Reporting (Admin Dashboard) - Visitors over time (daily/weekly/monthly charts) - Top pages, top referrers, top search terms - Traffic source breakdown (direct, organic, social, referral) - Device/browser/OS breakdown - Geographic map or country breakdown - Real-time active visitors count - Comparison periods (this week vs last week) ### Privacy - No cookies required (fingerprint-based, GDPR-friendly) - Respect Do Not Track header (configurable) - IP anonymization (hash, never store raw) - Bot/crawler filtering (exclude known bots from stats) ### HQ Integration - Send daily aggregates to MokoSuiteClientHQ via heartbeat - HQ dashboard shows analytics across all managed sites ## Architecture - `plg_system_mokosuiteclient_analytics` — frontend hit collector (lightweight JS-free server-side tracking) - Component views in `com_mokosuiteclient` — analytics dashboard with charts - `plg_task_mokosuiteclient_analytics` — scheduled aggregation + pruning task - Database tables: `#__mokosuiteclient_analytics_hits`, `#__mokosuiteclient_analytics_daily` ## Prior Work A MokoSuiteAnalytics repo previously existed but was deleted. This feature should be built directly into MokoSuiteClient as a core component.
jmiller commented 2026-06-20 18:40:19 +00:00
Author
Owner
Copy Link
Copy Source

Branch created: feature/219-feat-site-analytics-client-traffic-analy

git fetch origin
git checkout feature/219-feat-site-analytics-client-traffic-analy
Branch created: [`feature/219-feat-site-analytics-client-traffic-analy`](https://git.mokoconsulting.tech/MokoConsulting/MokoSuiteClient/src/branch/feature/219-feat-site-analytics-client-traffic-analy) ```bash git fetch origin git checkout feature/219-feat-site-analytics-client-traffic-analy ```
Sign in to join this conversation.
Labels
Clear labels
architecture
automation
Automated processes or scripts
 breaking-change
Breaking API or functionality change
 bug
build
Build system changes
 ci-cd
CI/CD pipeline changes
 config
Configuration file changes
 css
CSS/styling changes
 dependencies
Dependency updates
 deploy-failure
Automated deploy failure tracking
 docker
Docker configuration changes
 documentation
Documentation changes
 dolibarr
Dolibarr module or extension
 duplicate
enhancement
generic
Generic project or library
 good first issue
Good for newcomers
 health-check
Repository health check results
 health: excellent
Health score 90-100
 health: fair
Health score 50-69
 health: good
Health score 70-89
 health: poor
Health score below 50
 help wanted
Extra attention needed
 html
HTML template changes
 invalid
javascript
JavaScript code changes
 joomla
Joomla extension or component
 major-release
Major version release (breaking changes)
 minor-release
Minor version release (XX.YY.00)
 mokostandards
MokoStandards compliance
 needs-review
Awaiting code review
 needs-testing
Requires manual or automated testing
 patch-release
Patch version release (XX.YY.ZZ)
 php
PHP code changes
 priority: critical
priority: high
priority: low
priority: medium
push-failure
File push failure requiring attention
 python
Python code changes
 question
regression
Regression from a previous working state
 release-candidate
Release candidate build
 security
Security-related changes
 size/l
Large change (101-300 lines)
 size/m
Medium change (31-100 lines)
 size/s
Small change (11-30 lines)
 size/xl
Extra large change (301-1000 lines)
 size/xs
Extra small change (1-10 lines)
 size/xxl
Extremely large change (1000+ lines)
 standards-drift
Repository drifted from MokoStandards
 standards-update
MokoStandards sync update
 standards-violation
Standards compliance failure
 status: blocked
status: in-progress
status: needs-review
status: on-hold
Temporarily on hold
 status: pending
Pending action or decision
 status: wontfix
This will not be worked on
 sync-failure
Bulk sync failure requiring attention
 sync-report
Bulk sync run report
 template-validation-failure
Template workflow validation failure
 test-failure
Automated test failure
 tests
Test suite changes
 type: bug
Something isn't working
 type: chore
Maintenance tasks
 type: enhancement
Enhancement to existing feature
 type: feature
New feature or request
 type: refactor
Code refactoring
 type: release
Release preparation or tracking
 type: test
Test suite additions or changes
 type: version
Version-related change
 typescript
TypeScript code changes
 version
Version bump or release
 version-branch
Version branch related
 version-drift
Version mismatch detected
 work-in-progress
Work in progress, not ready for merge
No labels
Priority Medium
Type Feature
Milestone
No items
No Milestone
Assignees
Clear assignees
jmiller (Jonathan Miller)
No Assignees
1 Participants
Notifications
Due Date
No due date set.
Dependencies

No dependencies set.

Reference: MokoConsulting/MokoSuiteClient#219
Delete Branch "%!s()"

Deleting a branch is permanent. Although the deleted branch may continue to exist for a short time before it actually gets removed, it CANNOT be undone in most cases. Continue?