Jonathan Miller
4b9a675d0f
Generic: Repo Health / Site Health (push) Has been skipped
Generic: Repo Health / Access control (push) Successful in 1s
Generic: Project CI / Lint & Validate (push) Successful in 36s
Platform: moko-platform CI / Gate 1: Code Quality (push) Failing after 40s
Generic: Project CI / Tests (push) Has been cancelled
Platform: moko-platform CI / Gate 2: Unit Tests (8.1) (push) Has been cancelled
Platform: moko-platform CI / Gate 2: Unit Tests (8.2) (push) Has been cancelled
Platform: moko-platform CI / Gate 2: Unit Tests (8.3) (push) Has been cancelled
Platform: moko-platform CI / Gate 3: Self-Health Check (push) Has been cancelled
Platform: moko-platform CI / Gate 4: Governance (push) Has been cancelled
Platform: moko-platform CI / Gate 5: Template Integrity (push) Has been cancelled
Platform: moko-platform CI / CI Summary (push) Has been cancelled
Generic: Repo Health / Scripts governance (push) Has been cancelled
Generic: Repo Health / Repository health (push) Has been cancelled
Generic: Repo Health / Report Issues (push) Has been cancelled
All Joomla element names, PHP classes, language files, folder structure, and manifest references renamed from mokosuite to mokosuiteclient. This repo is now the client-facing tracker for the MokoSuite platform.
53 lines
2.8 KiB
Markdown
53 lines
2.8 KiB
Markdown
# 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)
|