# MokoStandards-Template-Joomla

Unified scaffolding templates for all Joomla extension types.

## Structure

```
.gitea/workflows/     ← Standard 10-workflow CI/CD suite
types/
  plugin/             ← Joomla plugin scaffold
  template/           ← Joomla site template scaffold (full src/)
  module/             ← Joomla module scaffold
  component/          ← Joomla component scaffold
  package/            ← Joomla package scaffold
  library/            ← Joomla library scaffold
```

## Usage

1. Create a new repo from this template (or clone manually)
2. Copy the relevant `types/<type>/` content to your project root
3. Customize the manifest XML, namespace, and source files
4. Workflows are already configured — push to trigger CI

## Shared Files

The root contains files shared by all extension types:
- `.gitea/workflows/` — CI/CD (auto-release, ci-joomla, pr-check, etc.)
- `.editorconfig`, `.gitignore`, `.gitattributes` — editor/git config
- `composer.json`, `phpstan.neon`, `Makefile` — build tooling
- `updates.xml` — Joomla update server manifest template
- `LICENSE`, `SECURITY.md`, `CONTRIBUTING.md` — standard docs

## Workflow Suite (10 workflows)

| Workflow | Purpose |
|----------|---------|
| `auto-release.yml` | Stable release on PR merge to main |
| `pre-release.yml` | Manual dev/alpha/beta/rc builds |
| `ci-joomla.yml` | PHP lint, PHPStan, coding standards |
| `pr-check.yml` | PR gate: manifest + build validation |
| `deploy-manual.yml` | Manual SFTP deploy |
| `repo-health.yml` | Structure compliance checks |
| `update-server.yml` | updates.xml validation |
| `security-audit.yml` | Dependency vulnerability scanning |
| `notify.yml` | ntfy notifications |
| `cleanup.yml` | Merged branch + old run cleanup |

## Version Policy

- **Stable** (PR merge to main): Minor bump (`03.00.07` -> `03.01.00`)
- **Pre-release** (manual): Patch bump (`03.00.07` -> `03.00.08`)

## Release Cascade

Higher releases auto-delete lower pre-release channels:
- stable -> all | rc -> beta,alpha,dev | beta -> alpha,dev | alpha -> dev

## Platform Type

`.mokostandards` platform: `joomla-template` or `waas-component`

## Canonical Source

This repo is the **single source of truth** for Joomla workflows and scaffolding.
Sync to production repos by copying `.gitea/workflows/` from here.

## License

GPL-3.0-or-later - Moko Consulting