Fatal Error (500) Using Joomla 6.1 Core API - GetTemplate Issue In OnContentPrepareForm
S-D CONSULTING
Hi Joomshaper team,
I am writing to report a critical bug in the Helix Ultimate System Plugin that causes a 500 Internal Server Error when trying to create Articles or Tags via the native Joomla Core API (Web Services) in Joomla 6.1.0.
Some time ago, on Joomla 5.4.x, I created a component that creates Joomla articles, formatted in JSON so they can be formatted in Page Builder, creates tags and images, and adds an addon that correlates other articles with the same tags at the bottom.
After upgrading to Joomla 6.1, my script crashed with a 500 error. I thought the problem might be related to the update and more stringent changes to the Joomla API. After debugging, I discovered that the problem is HELIX (latest version), which constantly listens for every activity done in Joomla, even with the API.
Description of the issue: When pushing a POST request to the Joomla API to create a new article or tag, Joomla triggers the onContentPrepareForm event. The Helix Ultimate system plugin hooks into this event and attempts to fetch the active template at line 120 of plugins/system/helixultimate/helixultimate.php: $template = Factory::getApplication()->getTemplate(true);
Since the request is handled by the ApiApplication (which has no frontend template assigned, unlike SiteApplication), Joomla 6.1 throws a fatal InvalidArgumentException, crashing the entire API call.
Environment:
Joomla version: 6.1.0
PHP version: 8.x
Helix Ultimate version: last version
Error Log / Stack Trace:
CRITICAL 10.4.71.1 error Uncaught Throwable of type InvalidArgumentException thrown with message "Could not find template "system".". Stack trace:
#0 [ROOT]/plugins/system/helixultimate/helixultimate.php(120): Joomla\CMS\Application\CMSApplication->getTemplate()
#1 [ROOT]/libraries/src/Plugin/CMSPlugin.php(386): PlgSystemHelixultimate->onContentPrepareForm()
#2 [ROOT]/libraries/vendor/joomla/event/src/Dispatcher.php(454): Joomla\CMS\Plugin\CMSPlugin->{closure:Joomla\CMS\Plugin\CMSPlugin::registerLegacyListener():370}()
#3 [ROOT]/libraries/src/MVC/Model/FormBehaviorTrait.php(196): Joomla\Event\Dispatcher->dispatch()
#4 [ROOT]/administrator/components/com_tags/src/Model/TagModel.php(190): Joomla\CMS\MVC\Model\FormModel->loadForm()
...
#12 [ROOT]/libraries/src/Application/ApiApplication.php(116): Joomla\CMS\Application\ApiApplication->dispatch()
Proposed Fix / Workaround:
I managed to temporarily fix the issue on my server by adding an early exit for API clients at the very beginning of the onContentPrepareForm method in helixultimate.php:
PHP
public function onContentPrepareForm(Form $form, $data)
{
// Fix for Joomla API context
if (\Joomla\CMS\Factory::getApplication()->isClient('api')) {
return true;
}
$doc = Factory::getDocument();
// ... rest of the code
}Could you please review this issue and include a proper context check in the next Helix Ultimate update? API automations are completely broken without this patch.
Thank you for your great work!
Best regards,
Ziaul Kabir
Accepted AnswerHi,
Thanks for the detailed report and for identifying the root cause.
We have forwarded this to our development team for further review and investigation. Your findings and suggested workaround are very helpful and will assist in addressing the issue properly.
We will keep you updated once we have more information.
Thanks for your patience.
Best regards,
S-D CONSULTING
Accepted AnswerThanks, I read that HELIX version 2.2.5 was released today, I think this fix hasn't been applied, correct?
S-D CONSULTING
Accepted AnswerFor additional information, I ran the HELIX update, but the error reoccurred and I applied the FIX again
At line 114 of helixultimate.php in plugin/system/helixultimate
// --- FIX for API JOOMLA 6.1 ---
if (\Joomla\CMS\Factory::getApplication()->isClient('api')) {
return true;
}
// --- END FIX ---Michael
Accepted AnswerI also use the Joomla Core API with Helix Ultimate System Plugin and get the same internal server error 500. When will this issue be fixed?
Ziaul Kabir
Accepted AnswerThis will be added in an upcoming release.
However, we are unable to provide an exact timeframe at this moment.
Thank you for your understanding.
Best regards,
Ziaul Kabir
Accepted AnswerNo, This issues still not fixed in this version of Helix Ultimate and it will be added in next release.
Thanks for your understanding.
S-D CONSULTING
Accepted AnswerOkay, thanks for the reply. I emphasize the importance of this update, as not everyone uses only the basic Joomla features. The Joomla APIs are very robust and efficient and are widely used. Unfortunately, in this case, HELIX is confirming its invasion of functions it shouldn't touch.
I tested the fix I proposed, and it also works on Helix 2.2.6. I'm writing this primarily for anyone who has encountered the same problem, as it's a simple one-line fix.
Ziaul Kabir
Accepted AnswerIt’s great to hear that your issue has been resolved. If everything is working fine now, please mark the question as complete by accepting any of our answers.
Thank you!
S-D CONSULTING
Accepted AnswerI'm sorry, but I'll close this ticket by accepting your response once you confirm that you've implemented the fix in the HELIX update. Currently, the only solution I see that works is the one I proposed, which several users have used.
I'd like confirmation here. The next update (perhaps with a release date) will include the fix that won't affect the Joomla API.
Ziaul Kabir
Accepted AnswerHello,
I apologize for the misunderstanding.
The issues have already been fixed and will be included in the next release.
Thank you for your patience and understanding.
Best regards,
Michael
Accepted Answeris this issue fixed in Helix Ultimate Framework 2.2.7?
Marius Lindemann
Accepted AnswerI still have the problem with 2.2.8. I cant save pages or articles. Backend shows Request failed with status code 500 when saving. In Frontent nothing happens when saving.
Michael
Accepted AnswerI updated to 2.2.8 and can confirm that the fix is applied and working.
helixultimate.php
public function onContentPrepareForm(Form $form, $data)
{
$app = \Joomla\CMS\Factory::getApplication();
if ($app->isClient('api') || $app->isClient('console') || !method_exists($app, 'getTemplate'))
{
return true;
}I was able to create Articles with POST {{domain}}/{{base_path}}/content/articles
(Note: I also updated to Joomla 6.1.2)