Joomla! 5 support. We have addressed the backwards incompatible changes introduced in the week leading to the release of Joomla! 5.0-Beta1. Please note that Joomla! 5 is still in beta and should not be used on production sites.
New email templates for edited posts. In the past, the same email template as the new ticket or ticket reply was used when editing the post (depending on whether it was the first post of a ticket or not). Now you have a specific mail template for edited posts.
Mail fetch: recognise replies based on the existence of "Re:" or equivalent in the email subject. In the past, replies to tickets were recognised based on the existence of the "reply below this line" text, or a mail header. The former may be accidentally left out of the mail template, and the latter may be removed by some mail clients. ATS can now recognise ticket replies based on the subject line, as long as it contains a reply marker (e.g. “Re:”; this can be configured) and the ticket number in the format #1234 (a hash sign followed by the ticket number). The default reply marker list covers a multitude of languages, not just English.
Image and link URLs are converted to absolute, allowing them to work in the backend and over email. In the past, any image added to a ticket in the frontend would only be visible if you viewed the ticket in the frontend of the site. Viewing the ticket text in the notification email, or the backend would result in a broken image. We addressed this by automatically converting relative image paths inserted by Joomla!'s Media Manager into absolute paths.
Bug fixes and minor improvements. Please take a look at the CHANGELOG below.
We have changed the PHP namespaces of our extensions to match the (as yet undocumented) intention of Joomla!'s core maintainers about third party extensions' PHP namespaces.
The namespaces in all of our extensions now start with our company name, i.e. Akeeba\. In the past this was indeed the case for our components, but our plugins and modules had the generic prefix Joomla\ due to an unfortunate misunderstanding of how the new at the time (and still officially undocumented) Joomla 4 MVC was meant to work back in late 2020, when we started migrating our extensions.
This one-time change has some implications on whether Joomla! will be able to find and load the code with the updated namespace. If it cannot, it will display (usually briefly) an error message stating “class not found”, “missing class”, or something similar to that. This is the result of how Joomla! works, and your server's configuration. Here are the two key points which can cause problems:
autoload_psr4.php file in its cache directory, generally a welcome performance-enhancing behaviour. Whenever you install an extension update, or a core Joomla! update, Joomla! tries to delete and create this file afresh.
.php files have changed during the caching period set up in PHP's configuration. To work around that limitation, Joomla! asks PHP to clear the OPcache for each .php file it writes to disk during the course of an extension or core Joomla! update.
While Joomla! generally works well, we observed a few issues which do get in the way:
autoload_psr4.php is unwriteable Joomla fails to renew this file silently. As a result, it misleads the user into believing that an extension is misbehaving when, in fact, it's a Joomla! failure to check if this file is writeable (therefore can be updated, therefore can be trusted) before using it.
autoload_psr4.php may not be created afresh if an update fails, but has already written files on disk. This creates a discrepancy between the code available on your server and what Joomla! has cached about this code in that file, breaking your site.
provider.php file of every extension using the modern Joomla! 4 MVC. The undocumented workaround for this behaviour is to use PHP's clearstatcache() to tell it to check the disk again before calling the code to reset the OPcache for a file.
Our extensions include post-installation code designed to mitigate these issues to the extent humanly possible:
autoload_psr4.php file and ask Joomla! to create it afresh. Then, we reset its PHP filesystem stats cache and the PHP OPcache on that file, just like what Joomla! does during a core Joomla! update.
.php files in our extensions and resets PHP's OPcache for them, exactly like what Joomla! does during a core Joomla! update. This is more comprehensive that Joomla's code currently used in its Joomla\Filesystem\File::write() method.
Despite our best efforts, we understand that some far less common server configurations may make it impossible for the mitigations to work. Namely, we have identified the following cases, mitigations, and expected impact:
autoload_psr4.php file and / or its containing folder is not writeable to PHP itself the file will be impossible to delete. As a result, Joomla! will keep using the old, out-of-date file, breaking your site. Note that most affected sites would already have issues installing or updating Joomla! and third party extensions. Mitigation: You will need to delete that file (administrator/cache/autoload_psr4.php) yourself. Expected impact: rare; less than 0.1% of sites.
.php files. Mitigation: You will have to either wait until the OPcache expires (usually between a few seconds to a few hours), or ask your host for help on resetting the OPcache. Expected impact: very rare; less than 0.01% of sites.
Despite us taking all reasonable precautions to refrain from inadvertently breaking your sites, some rather rare server configurations might get in the way of a stark minority of our clients. If your site stops responding, at all or intermittently, with an error indicating “class not found” please do the following:
administrator/cache/autoload_psr4.php file, and reload the page.
We would like to state that the likelihood of these issues occurring is vanishingly small. The vast majority of our clients will NOT experience any of that. We include this statement with our software because we believe in transparency, and are proponents of the “forewarned is forearmed” mantra.