Pull Request for Issue #38555 .

Summary of Changes

• Adds setMVCFactory and getMVCFactory public methods to the BaseController
• Adds a new \Joomla\CMS\MVC\Factory\MVCFactoryWrapper class for wrapping the MVCFactory service to extend it.

Testing Instructions

1. Without the patch: Install the component https://github.com/nikosdion/com_example/commit/06f43fde850b79673500697e41c4945602fa34152.

2. With the patch: Install the component https://github.com/nikosdion/com_example/commit/4413a9a399e0634cc7d37967188210a8185cc35d

Actual result BEFORE applying this Pull Request

You get an error.

That's because the custom MVCFactoryWrapper of the component cannot force itself as the MVCFactory service of the Controller. As a result, when the Controller calls its getModel or getView methods it uses the undecorated MVCFactory object which, of course, is blissfully unaware of our custom service. Therefore the Model which wants to use this service breaks.

Expected result AFTER applying this Pull Request

It works!

Our custom MVCFactoryWrapper extends from \Joomla\CMS\MVC\Factory\MVCFactoryWrapper which means that the created Controller and Model objects use our decorated wrapper as their MVCFactory instead of the undecorated service. Our decorated wrapper is aware of our custom service, therefore it can push it to the created models, even if they are created through the Controller's createModel method.

Documentation Changes Required

I will be documenting that in the developer's docs as there is currently nothing of the sort.