fix(joomla6): update webservices plugins for Joomla 6 typed event API #13

Closed
opened 2026-05-26 18:34:43 +00:00 by jmiller · 3 comments
Owner

Summary

Joomla 6 changed the event handler system. Plugins using SubscriberInterface now receive a typed event object as the first argument instead of pass-by-reference parameters. This breaks all plg_webservices_* plugins.

Breaking Change

Old (Joomla 4/5):

public function onBeforeApiRoute(&\): void

New (Joomla 6):

use Joomla\CMS\Event\Application\BeforeApiRouteEvent;

public function onBeforeApiRoute(BeforeApiRouteEvent \): void
{
    \ = \->getRouter();
}

Workflow Impact

  • The universal auto-release and pre-release workflows should consider a Joomla 6 compatibility check
  • api/templates/system/index.php must exist for Joomla 6.1 — verify in packaging/deployment
  • Consider adding a Joomla 6 event handler validator to the CI pipeline

Related

## Summary Joomla 6 changed the event handler system. Plugins using `SubscriberInterface` now receive a typed event object as the first argument instead of pass-by-reference parameters. This breaks all `plg_webservices_*` plugins. ## Breaking Change Old (Joomla 4/5): ```php public function onBeforeApiRoute(&\): void ``` New (Joomla 6): ```php use Joomla\CMS\Event\Application\BeforeApiRouteEvent; public function onBeforeApiRoute(BeforeApiRouteEvent \): void { \ = \->getRouter(); } ``` ## Workflow Impact - The universal auto-release and pre-release workflows should consider a Joomla 6 compatibility check - `api/templates/system/index.php` must exist for Joomla 6.1 — verify in packaging/deployment - Consider adding a Joomla 6 event handler validator to the CI pipeline ## Related - MokoConsulting/MokoWaaS#48 (source issue) - MokoConsulting/moko-platform#164 (tracking issue)
Author
Owner

Branch created: feature/13-fix-joomla6-update-webservices-plugins-f

git fetch origin
git checkout feature/13-fix-joomla6-update-webservices-plugins-f
Branch created: [`feature/13-fix-joomla6-update-webservices-plugins-f`](https://git.mokoconsulting.tech/MokoConsulting/Template-Joomla/src/branch/feature/13-fix-joomla6-update-webservices-plugins-f) ```bash git fetch origin git checkout feature/13-fix-joomla6-update-webservices-plugins-f ```
Author
Owner
**Related issues:** - MokoConsulting/MokoWaaS#48 (source — hotfixed on live) - MokoConsulting/moko-platform#164 (tracking) - MokoConsulting/Template-Generic#32 - MokoConsulting/Template-Joomla#13
Author
Owner

Proof

Workflows updated on both dev and main branches:

  • auto-release.yml: added RC promotion, removed paths filter, added promote-rc job
  • pre-release.yml: auto-triggers on dev merge, removed paths filter

The Joomla 6 typed event fix is a per-repo code change (fixed in MokoWaaS#48). A Joomla 6 compat validator for the CI pipeline is tracked as moko-platform#164.

## Proof Workflows updated on both dev and main branches: - auto-release.yml: added RC promotion, removed paths filter, added promote-rc job - pre-release.yml: auto-triggers on dev merge, removed paths filter The Joomla 6 typed event fix is a per-repo code change (fixed in MokoWaaS#48). A Joomla 6 compat validator for the CI pipeline is tracked as moko-platform#164.
Sign in to join this conversation.
No labels
1 Participants
Notifications
Due Date
No due date set.
Dependencies

No dependencies set.

Reference: MokoConsulting/Template-Joomla#13