Summary of Changes

Changes to ease the use of multiple models in one view for custom (or core) components in Joomla 4.

By moving just three lines of code from BaseController->display()
to a new method BaseController->setViewModels(Object $view),
you can easily assign the models you want to any of your views.

Everything works exactly the same. The method are called at the same point the lines were before.
But the diference is:

• now you can overwrite the new method in the DisplayController of your custom component like this:

    public function display($cachable = false, $urlparams = [])
    {
         return parent::display();
    }


    public function setViewModels(Object $view)
    {
        parent::setViewModels($view);

        $viewName = $view->getName();

        // Push the Second model into the Foos view 
        if ($viewName == strtolower("Foos") && ($model = $this->getModel('Second')) ){
            $view->setModel($model);
        }

        // Push the Third model into the Foos view 
        if ($viewName == strtolower("Foos") && ($model = $this->getModel('Third')) ){
            $view->setModel($model);
        }
    }

Here you see that you don't need to touch your DisplayController->DisplayController() method to assign the models.
Nor call to Factories. All you need is in the DisplayController with minimum code.
You only overwrite the DisplayController->setViewModels(), call the parent (that assigns the default model as usual),
and assigns a couple of new models to the "Foos" view.

Now you only have to call it properly and easily in your view, like this:

	public function display($tpl = null)
	{
            $this->msg  = $this->get('Msg');
            $this->msg2 = $this->get('Msg', 'Second');
            $this->msg3 = $this->get('Msg', 'Third');
        
	    return parent::display($tpl);
	}

Here you see how to call the methods of the Second and Third Model.

Just like it is described here: Using multiple models in an MVC component
Only now, you don't need to care about custom display() methods in your views.
The default display() works perfectly fine.

Testing Instructions

I developed this little Component com_foos to test the changes.
You only need to apply the changes to your Joomla 4.2 installation and install the component as usual.

Actual result BEFORE applying this Pull Request

Break MVC model to call several models for one view, using factories called in helpers,
or need to rewrite your own DisplayController->DisplayController().

See How can I use two models in my custom component view in Joomla4?

Expected result AFTER applying this Pull Request

If you pick in the Backend > Component > COM_FOOS menu link, you will see:

Hello Foo from the model: DEFAULT
Hello FOOS from the ADMINISTRATOR model: SECOND
Hello FOOS from the ADMINISTRATOR model: THIRD

Each one of this messages, comming from a different model attached to the Foos View.

If you create a menu link in the FronEnd of the testing site, for the com_foos component as usual, you will see:

Hello FOO from the SITE model: DEFAULT
Hello FOO from the SITE model: SECOND
Hello FOOS from the ADMINISTRATOR model: THIRD

Each one of this messages, comming from a different model attached to the Foo View.

Note that the THIRD model is a backend model. You can assign it exactly the same way.

Link to documentations

Please select:

• Documentation link for docs.joomla.org:

• [ X ] No documentation changes for docs.joomla.org needed

• Pull Request link for manual.joomla.org:

• [ X ] No documentation changes for manual.joomla.org needed