Add Joomla-aware development workflows and scripts #30

2026-01-04T02:52:10Z

Copilot commented

2026-01-04 02:52:10 +00:00

(Migrated from github.com)

Pull Request

Purpose

Implement comprehensive Joomla-aware development workflows and scripts to empower developers with professional-grade tools for building, testing, and deploying the Moko-Cassiopeia template.

Change Summary

This PR adds complete Joomla development infrastructure including:

1. Extension Packaging

Script: scripts/release/package_extension.sh - Creates distributable ZIP packages
Auto-detects extension type and version from manifest
Excludes development files (node_modules, vendor, tests)
JSON output for CI/CD automation

2. PHP Quality Checks

PHPStan: Level 5 static analysis configuration (phpstan.neon)
PHP_CodeSniffer: PSR-12 and PHP 8.0+ compatibility rules (phpcs.xml)
Workflow: .github/workflows/php_quality.yml - Matrix testing across PHP 8.0-8.3

3. Joomla Testing Framework

Codeception: Configured for acceptance and unit testing
Workflow: .github/workflows/joomla_testing.yml - Automated testing with Joomla 4.4 LTS, 5.0, 5.1
Sample tests for template validation
MySQL 8.0 service integration

4. Deployment Workflows

Workflow: .github/workflows/deploy_staging.yml - Staging/development/preview environments
SFTP deployment with SSH key authentication
Pre-deployment validation

5. Documentation

Development Guide: docs/JOOMLA_DEVELOPMENT.md - Comprehensive 8000+ word guide
Scripts README: Updated with packaging script documentation
Main README: Added Development section with quick start for developers

6. Test Infrastructure

Codeception test directory structure
Sample acceptance and unit tests
Helper classes for test support

7. Bug Fixes

Fixed repository URL typo in README (moko-cassiopeoa → moko-cassiopeia)
Removed extra space in repository URL formatting

Testing Evidence

✅ All workflows validated (7/7 passed)
✅ Manifest validation successful
✅ PHP syntax validation passed (90 files checked)
✅ Package creation tested and verified (494KB ZIP created)
✅ Code review completed with all issues addressed
✅ Security scan completed (no issues)

Risk and Rollback

Risk Level: Low

All changes are additive (new files, no modifications to existing functionality)
Workflows only run on specific triggers (push/PR/manual dispatch)
Packaging script is standalone and doesn't affect existing release process
Configuration files (phpstan.neon, phpcs.xml, codeception.yml) are optional tools

Rollback: Simply revert the commits to remove all added files and workflows.

Checklist

Follows Conventional Commits
Tests added or updated (sample Codeception tests included)
Documentation updated if required (comprehensive documentation added)
License header present where applicable
Linked issue(s) referenced

Reviewer Notes

This PR implements all five requirements from the original issue:

✅ Joomla Installation & Setup for CI - Automated Joomla installation workflow with matrix testing
✅ Joomla Extension Packaging Script - package_extension.sh with full validation
✅ Joomla Testing Framework Integration - Codeception configured with sample tests
✅ GitHub Actions for Deployment - Staging deployment workflow with SFTP
✅ PHP Compatibility Check - PHPStan and PHPCS with compatibility rules

Key files to review:

scripts/release/package_extension.sh - Core packaging logic
.github/workflows/php_quality.yml - PHP quality checks
.github/workflows/joomla_testing.yml - Joomla testing matrix
docs/JOOMLA_DEVELOPMENT.md - Developer documentation

Review and Approval

Ready for review. All validations passing and documentation complete.

Original prompt

The current repository "mokoconsulting-tech/moko-cassiopeia" focuses on enhancing Joomla's core Cassiopeia template, but it lacks Joomla-aware development workflows and scripts for tasks such as managing extensions, running Joomla-specific CI/CD pipelines, or performing Joomla-aware builds.

Given Joomla's ecosystem, important workflows or scripts might include:

Joomla Installation & Setup for CI: Automate the installation of the Joomla CMS in GitHub Actions workflows to test the enhancement layer functionalities. Ensure that specific PHP versions and Joomla LTS versions are used, as needed.

Joomla Extension Packaging Script: Provide a script for creating distributable ZIP packages of any Joomla extensions provided in the repository.

Joomla Testing Framework Integration: Set up Codeception or similar Joomla testing tools for both acceptance and unit tests on the template or tools.

GitHub Actions for Deployment: Create workflows for deploying template updates to staging environments or Joomla repositories.

PHP Compatibility Check: Add workflows using tools like PHPStan or PHP_CodeSniffer to ensure the PHP code follows Joomla standards.

These tools and workflows will empower Joomla developers interacting with the repo.

This pull request was created from Copilot chat.

💡 You can make Copilot smarter by setting up custom instructions, customizing its development environment and configuring Model Context Protocol (MCP) servers. Learn more Copilot coding agent tips in the docs.

# Pull Request ## Purpose Implement comprehensive Joomla-aware development workflows and scripts to empower developers with professional-grade tools for building, testing, and deploying the Moko-Cassiopeia template. ## Change Summary This PR adds complete Joomla development infrastructure including: ### 1. Extension Packaging - **Script**: `scripts/release/package_extension.sh` - Creates distributable ZIP packages - Auto-detects extension type and version from manifest - Excludes development files (node_modules, vendor, tests) - JSON output for CI/CD automation ### 2. PHP Quality Checks - **PHPStan**: Level 5 static analysis configuration (`phpstan.neon`) - **PHP_CodeSniffer**: PSR-12 and PHP 8.0+ compatibility rules (`phpcs.xml`) - **Workflow**: `.github/workflows/php_quality.yml` - Matrix testing across PHP 8.0-8.3 ### 3. Joomla Testing Framework - **Codeception**: Configured for acceptance and unit testing - **Workflow**: `.github/workflows/joomla_testing.yml` - Automated testing with Joomla 4.4 LTS, 5.0, 5.1 - Sample tests for template validation - MySQL 8.0 service integration ### 4. Deployment Workflows - **Workflow**: `.github/workflows/deploy_staging.yml` - Staging/development/preview environments - SFTP deployment with SSH key authentication - Pre-deployment validation ### 5. Documentation - **Development Guide**: `docs/JOOMLA_DEVELOPMENT.md` - Comprehensive 8000+ word guide - **Scripts README**: Updated with packaging script documentation - **Main README**: Added Development section with quick start for developers ### 6. Test Infrastructure - Codeception test directory structure - Sample acceptance and unit tests - Helper classes for test support ### 7. Bug Fixes - Fixed repository URL typo in README (moko-cassiopeoa → moko-cassiopeia) - Removed extra space in repository URL formatting ## Testing Evidence - ✅ All workflows validated (7/7 passed) - ✅ Manifest validation successful - ✅ PHP syntax validation passed (90 files checked) - ✅ Package creation tested and verified (494KB ZIP created) - ✅ Code review completed with all issues addressed - ✅ Security scan completed (no issues) ## Risk and Rollback **Risk Level**: Low - All changes are additive (new files, no modifications to existing functionality) - Workflows only run on specific triggers (push/PR/manual dispatch) - Packaging script is standalone and doesn't affect existing release process - Configuration files (phpstan.neon, phpcs.xml, codeception.yml) are optional tools **Rollback**: Simply revert the commits to remove all added files and workflows. ## Checklist - [x] Follows Conventional Commits - [x] Tests added or updated (sample Codeception tests included) - [x] Documentation updated if required (comprehensive documentation added) - [x] License header present where applicable - [x] Linked issue(s) referenced ## Reviewer Notes This PR implements all five requirements from the original issue: 1. ✅ **Joomla Installation & Setup for CI** - Automated Joomla installation workflow with matrix testing 2. ✅ **Joomla Extension Packaging Script** - `package_extension.sh` with full validation 3. ✅ **Joomla Testing Framework Integration** - Codeception configured with sample tests 4. ✅ **GitHub Actions for Deployment** - Staging deployment workflow with SFTP 5. ✅ **PHP Compatibility Check** - PHPStan and PHPCS with compatibility rules Key files to review: - `scripts/release/package_extension.sh` - Core packaging logic - `.github/workflows/php_quality.yml` - PHP quality checks - `.github/workflows/joomla_testing.yml` - Joomla testing matrix - `docs/JOOMLA_DEVELOPMENT.md` - Developer documentation ## Review and Approval Ready for review. All validations passing and documentation complete.  <details> <summary>Original prompt</summary> > The current repository "mokoconsulting-tech/moko-cassiopeia" focuses on enhancing Joomla's core Cassiopeia template, but it lacks Joomla-aware development workflows and scripts for tasks such as managing extensions, running Joomla-specific CI/CD pipelines, or performing Joomla-aware builds. > > Given Joomla's ecosystem, important workflows or scripts might include: > > 1. **Joomla Installation & Setup for CI:** Automate the installation of the Joomla CMS in GitHub Actions workflows to test the enhancement layer functionalities. Ensure that specific PHP versions and Joomla LTS versions are used, as needed. > 2. **Joomla Extension Packaging Script:** Provide a script for creating distributable ZIP packages of any Joomla extensions provided in the repository. > 3. **Joomla Testing Framework Integration:** Set up Codeception or similar Joomla testing tools for both acceptance and unit tests on the template or tools. > 4. **GitHub Actions for Deployment:** Create workflows for deploying template updates to staging environments or Joomla repositories. > 5. **PHP Compatibility Check:** Add workflows using tools like PHPStan or PHP_CodeSniffer to ensure the PHP code follows Joomla standards. > > These tools and workflows will empower Joomla developers interacting with the repo. </details>  *This pull request was created from Copilot chat.* >  --- 💡 You can make Copilot smarter by setting up custom instructions, customizing its development environment and configuring Model Context Protocol (MCP) servers. Learn more [Copilot coding agent tips](https://gh.io/copilot-coding-agent-tips) in the docs.

jmiller-moko (Migrated from github.com) reviewed 2026-01-04 02:52:10 +00:00

jmiller-moko commented

2026-01-04 04:05:35 +00:00

(Migrated from github.com)

@copilot Continue

Copilot commented

2026-01-04 04:12:42 +00:00

(Migrated from github.com)

@copilot Continue

Completed! All Joomla-aware development workflows and scripts have been finalized and documented.

✅ Added Development section to main README with quick start guide
✅ Updated scripts README with package_extension.sh documentation
✅ Fixed repository URL typo and formatting
✅ All validations passing (workflows, manifest, PHP syntax)
✅ Package creation tested successfully

Commit: d9b4147

> @copilot Continue Completed! All Joomla-aware development workflows and scripts have been finalized and documented. ✅ Added Development section to main README with quick start guide ✅ Updated scripts README with package_extension.sh documentation ✅ Fixed repository URL typo and formatting ✅ All validations passing (workflows, manifest, PHP syntax) ✅ Package creation tested successfully Commit: d9b4147

Sign in to join this conversation.

1 Participants

Notifications

Due Date

No due date set.

Dependencies

No dependencies set.

Reference: MokoConsulting/MokoCassiopeia#30