# MokoSuiteClient

MokoSuiteClient is a Joomla 5.x / 6.x extension package that provides a configurable white-label identity layer, tenant management, health monitoring, and remote administration API for the MokoSuiteClient platform.

Developed by [Moko Consulting](https://mokoconsulting.tech). Licensed under GPL-3.0-or-later.

## Features

- **White-label branding** -- customizable brand name, colors, favicon, login page, and admin template theming
- **Master user enforcement** -- designate a single operator account with elevated privileges; restrict other Super Admins
- **Tenant restrictions** -- hide system info, block installer access, restrict global config and template editing, hide menu items
- **Site aliases** -- multi-domain support with per-alias offline mode, robots directives, and backend redirects
- **Health monitoring** -- 16 diagnostic checks exposed via authenticated JSON API
- **Remote management API** -- 6 endpoints for health, info, install, update, cache clear, and backup
- **Grafana integration** -- automatic heartbeat registration with Grafana Infinity datasource provisioning
- **Plugin protection** -- protected flag, self-healing, hidden from non-master users, blocks disable/uninstall
- **Security hardening** -- forced HTTPS, session timeouts, password policy, upload restrictions
- **Emergency access** -- file-based two-factor verification for master user recovery
- **Automatic updates** -- via Joomla update server hosted on Gitea

## Requirements

| Requirement | Minimum |
|---|---|
| Joomla | 5.0.0+ (5.x and 6.x supported) |
| PHP | 8.1.0+ |

## Package Contents

The `pkg_mokosuiteclient` package installs three extensions:

| Extension | Type | Purpose |
|---|---|---|
| `plg_system_mokosuiteclient` | System Plugin | Core branding, restrictions, health checks, API endpoints |
| `com_mokosuiteclient` | Component | REST API controllers (health, cache, update) |
| `plg_webservices_mokosuiteclient` | Webservices Plugin | Registers Joomla API routes for `v1/mokosuiteclient/*` |

## Wiki Pages

- [Configuration](Configuration) -- All plugin settings organized by tab
- [Health Monitoring](Health-Monitoring) -- The 16 diagnostic checks
- [Site Aliases](Site-Aliases) -- Multi-domain management
- [API Endpoints](API-Endpoints) -- The 6 remote management endpoints
- [Grafana Integration](Grafana-Integration) -- Monitoring dashboard setup
- [Plugin Protection](Plugin-Protection) -- Security measures preventing disable/uninstall
- [Installation](Installation) -- Step-by-step install and upgrade guide

## Links

- **Repository**: [MokoSuiteClient on Gitea](https://git.mokoconsulting.tech/MokoConsulting/MokoSuiteClient)
- **Update Server**: [updates.xml](https://git.mokoconsulting.tech/MokoConsulting/MokoSuiteClient/raw/branch/main/updates.xml)
- **Author**: [Moko Consulting](https://mokoconsulting.tech)