[5.4] Automated Core Update Client

administrator/components/com_admin/sql/updates/mysql/5.4.0-2025-05-10.sql

@@ -0,0 +1,26 @@
+INSERT INTO `#__extensions` (`package_id`, `name`, `type`, `element`, `folder`, `client_id`, `enabled`, `access`, `protected`, `locked`, `manifest_cache`, `params`, `custom_data`, `ordering`, `state`)
+SELECT 0, 'plg_quickicon_autoupdate', 'plugin', 'autoupdate', 'quickicon', 0, 1, 1, 0, 1, '', '', '', -1, 0
+WHERE NOT EXISTS (SELECT * FROM `#__extensions` e WHERE e.`type` = 'plugin' AND e.`element` = 'autoupdate' AND e.`folder` = 'quickicon' AND e.`client_id` = 0);
+
+INSERT INTO `#__extensions` (`package_id`, `name`, `type`, `element`, `folder`, `client_id`, `enabled`, `access`, `protected`, `locked`, `manifest_cache`, `params`, `custom_data`, `ordering`, `state`)
+SELECT 0, 'plg_webservices_joomlaupdate', 'plugin', 'joomlaupdate', 'webservices', 0, 1, 1, 0, 1, '', '', '', -1, 0
+WHERE NOT EXISTS (SELECT * FROM `#__extensions` e WHERE e.`type` = 'plugin' AND e.`element` = 'joomlaupdate' AND e.`folder` = 'webservices' AND e.`client_id` = 0);
+
+INSERT INTO `#__mail_templates` (`template_id`, `extension`, `language`, `subject`, `body`, `htmlbody`, `attachments`, `params`) VALUES
+('com_joomlaupdate.update.success', 'com_joomlaupdate', '', 'COM_JOOMLAUPDATE_UPDATE_SUCCESS_MAIL_SUBJECT', 'COM_JOOMLAUPDATE_UPDATE_SUCCESS_MAIL_BODY', '', '', '{"tags":["newversion","oldversion","sitename","url"]}'),
+('com_joomlaupdate.update.failed', 'com_joomlaupdate', '', 'COM_JOOMLAUPDATE_UPDATE_FAILED_MAIL_SUBJECT', 'COM_JOOMLAUPDATE_UPDATE_FAILED_MAIL_BODY', '', '', '{"tags":["newversion","oldversion","sitename","url"]}');
+
+-- add post-installation message for automated updates
+INSERT INTO `#__postinstall_messages` (`extension_id`, `title_key`, `description_key`, `action_key`, `language_extension`, `language_client_id`, `type`, `action_file`, `action`, `condition_file`, `condition_method`, `version_introduced`, `enabled`)
+SELECT `extension_id`, 'COM_JOOMLAUPDATE_POSTINSTALL_MSG_AUTOMATED_UPDATES_TITLE', 'COM_JOOMLAUPDATE_POSTINSTALL_MSG_AUTOMATED_UPDATES_DESCRIPTION', 'COM_JOOMLAUPDATE_POSTINSTALL_MSG_AUTOMATED_UPDATES_ACTION', 'com_joomlaupdate', 1, 'action', 'admin://components/com_joomlaupdate/postinstall/autoupdate.php', 'com_joomlaupdate_postinstall_autoupdate_action', 'admin://components/com_joomlaupdate/postinstall/autoupdate.php', 'com_joomlaupdate_postinstall_autoupdate_condition', '5.4.0', 1 FROM `#__extensions` WHERE `name` = 'files_joomla';
+
+-- disable autostart for the previous tour
+UPDATE `#__guidedtours` SET `autostart` = 0 WHERE `uid` = 'joomla-whatsnew-5-3';
+
+INSERT INTO `#__guidedtours` (`title`, `description`, `extensions`, `url`, `published`, `language`, `note`, `access`, `uid`, `autostart`, `created`, `created_by`, `modified`, `modified_by`) VALUES
+	('COM_GUIDEDTOURS_TOUR_WHATSNEW_5_4_TITLE', 'COM_GUIDEDTOURS_TOUR_WHATSNEW_5_4_DESCRIPTION', '["com_cpanel"]', 'administrator/index.php', 1, '*', '', 1, 'joomla-whatsnew-5-4', 1, CURRENT_TIMESTAMP(), 0, CURRENT_TIMESTAMP(), 0);
+
+INSERT INTO `#__guidedtour_steps` (`title`, `description`, `position`, `target`, `type`, `interactive_type`, `url`, `published`, `language`, `note`, `params`, `tour_id`, `created`, `created_by`, `modified`, `modified_by`)
+SELECT 'COM_GUIDEDTOURS_TOUR_WHATSNEW_5_4_STEP_0_TITLE', 'COM_GUIDEDTOURS_TOUR_WHATSNEW_5_4_STEP_0_DESCRIPTION', 'right', '#sidebarmenu nav > ul:first-of-type > li:last-child', 0, 1, '', 1, '*', '', '"{\"required\":1,\"requiredvalue\":\"\"}"', MAX(`id`), CURRENT_TIMESTAMP(), 0, CURRENT_TIMESTAMP(), 0
+FROM `#__guidedtours`
+WHERE `uid` = 'joomla-whatsnew-5-4';

administrator/components/com_admin/sql/updates/postgresql/5.4.0-2025-05-10.sql

@@ -0,0 +1,26 @@
+INSERT INTO "#__extensions" ("package_id", "name", "type", "element", "folder", "client_id", "enabled", "access", "protected", "locked", "manifest_cache", "params", "custom_data", "ordering", "state")
+SELECT 0, 'plg_quickicon_autoupdate', 'plugin', 'autoupdate', 'quickicon', 0, 1, 1, 0, 1, '', '', '', -1, 0
+WHERE NOT EXISTS (SELECT * FROM "#__extensions" e WHERE e."type" = 'plugin' AND e."element" = 'autoupdate' AND e."folder" = 'quickicon' AND e."client_id" = 0);
+
+INSERT INTO "#__extensions" ("package_id", "name", "type", "element", "folder", "client_id", "enabled", "access", "protected", "locked", "manifest_cache", "params", "custom_data", "ordering", "state")
+SELECT 0, 'plg_webservices_joomlaupdate', 'plugin', 'joomlaupdate', 'webservices', 0, 1, 1, 0, 1, '', '', '', -1, 0
+WHERE NOT EXISTS (SELECT * FROM "#__extensions" e WHERE e."type" = 'plugin' AND e."element" = 'joomlaupdate' AND e."folder" = 'webservices' AND e."client_id" = 0);
+
+INSERT INTO "#__mail_templates" ("template_id", "extension", "language", "subject", "body", "htmlbody", "attachments", "params") VALUES
+('com_joomlaupdate.update.success', 'com_joomlaupdate', '', 'COM_JOOMLAUPDATE_UPDATE_SUCCESS_MAIL_SUBJECT', 'COM_JOOMLAUPDATE_UPDATE_SUCCESS_MAIL_BODY', '', '', '{"tags":["newversion","oldversion","sitename","url"]}'),
+('com_joomlaupdate.update.failed', 'com_joomlaupdate', '', 'COM_JOOMLAUPDATE_UPDATE_FAILED_MAIL_SUBJECT', 'COM_JOOMLAUPDATE_UPDATE_FAILED_MAIL_BODY', '', '', '{"tags":["newversion","oldversion","sitename","url"]}');
+
+-- add post-installation message for automated updates
+INSERT INTO "#__postinstall_messages" ("extension_id", "title_key", "description_key", "action_key", "language_extension", "language_client_id", "type", "action_file", "action", "condition_file", "condition_method", "version_introduced", "enabled")
+SELECT "extension_id", 'COM_JOOMLAUPDATE_POSTINSTALL_MSG_AUTOMATED_UPDATES_TITLE', 'COM_JOOMLAUPDATE_POSTINSTALL_MSG_AUTOMATED_UPDATES_DESCRIPTION', 'COM_JOOMLAUPDATE_POSTINSTALL_MSG_AUTOMATED_UPDATES_ACTION', 'com_joomlaupdate', 1, 'action', 'admin://components/com_joomlaupdate/postinstall/autoupdate.php', 'com_joomlaupdate_postinstall_autoupdate_action', 'admin://components/com_joomlaupdate/postinstall/autoupdate.php', 'com_joomlaupdate_postinstall_autoupdate_condition', '5.4.0', 1 FROM "#__extensions" WHERE "name" = 'files_joomla';
+
+-- disable autostart for the previous tour
+UPDATE "#__guidedtours" SET "autostart" = 0 WHERE "uid" = 'joomla-whatsnew-5-3';
+
+INSERT INTO "#__guidedtours" ("title", "description", "extensions", "url", "published", "language", "note", "access", "uid", "autostart", "created", "created_by", "modified", "modified_by") VALUES
+	('COM_GUIDEDTOURS_TOUR_WHATSNEW_5_4_TITLE', 'COM_GUIDEDTOURS_TOUR_WHATSNEW_5_4_DESCRIPTION', '["com_cpanel"]', 'administrator/index.php', 1, '*', '', 1, 'joomla-whatsnew-5-4', 1, CURRENT_TIMESTAMP, 0, CURRENT_TIMESTAMP, 0);
+
+INSERT INTO "#__guidedtour_steps" ("title", "description", "position", "target", "type", "interactive_type", "url", "published", "language", "note", "params", "tour_id", "created", "created_by", "modified", "modified_by")
+SELECT 'COM_GUIDEDTOURS_TOUR_WHATSNEW_5_4_STEP_0_TITLE', 'COM_GUIDEDTOURS_TOUR_WHATSNEW_5_4_STEP_0_DESCRIPTION', 'right', '#sidebarmenu nav > ul:first-of-type > li:last-child', 0, 1, '', 1, '*', '', '"{\"required\":1,\"requiredvalue\":\"\"}"', MAX("id"), CURRENT_TIMESTAMP, 0, CURRENT_TIMESTAMP, 0
+FROM "#__guidedtours"
+WHERE "uid" = 'joomla-whatsnew-5-4';

administrator/components/com_joomlaupdate/config.xml

@@ -72,4 +72,60 @@
 		</field>
 
 	</fieldset>
+	<fieldset
+		name="automated-updates"
+		label="COM_JOOMLAUPDATE_CONFIG_AUTOMATED_UPDATES_LABEL"
+	>
+		<field
+			name="autoupdate"
+			type="radio"
+			label="COM_JOOMLAUPDATE_CONFIG_AUTOUPDATE_LABEL"
+			description="COM_JOOMLAUPDATE_CONFIG_AUTOUPDATE_DESC"
+			default="0"
+			layout="joomla.form.field.radio.switcher"
+			showon="updatesource:default[AND]minimum_stability:4"
+			validate="options"
+			>
+			<option value="0">JNO</option>
+			<option value="1">JYES</option>
+		</field>
+
+		<field
+			name="autoupdate_status"
+			type="hidden"
+		/>
+
+		<field
+			name="update_token"
+			type="text"
+			label="COM_JOOMLAUPDATE_CONFIG_UPDATE_TOKEN_LABEL"
+			description="COM_JOOMLAUPDATE_CONFIG_UPDATE_TOKEN_DESC"
+			readonly="true"
+			showon="updatesource:default[AND]minimum_stability:4[AND]autoupdate:1"
+		/>
+		<field
+			name="update_last_check"
+			type="calendar"
+			showtime="true"
+			filter="user_utc"
+			label="COM_JOOMLAUPDATE_CONFIG_UPDATE_LAST_CHECK_LABEL"
+			description="COM_JOOMLAUPDATE_CONFIG_UPDATE_LAST_CHECK_DESC"
+			readonly="true"
+			showon="updatesource:default[AND]minimum_stability:4[AND]autoupdate:1"
+		/>
+		<field
+			name="automated_updates_disabled"
+			type="note"
+			label="COM_JOOMLAUPDATE_CONFIG_AUTOMATED_UPDATES_DISABLED_LABEL"
+			class="alert alert-info w-100"
+			showon="updatesource!:default[OR]minimum_stability!:4"
+		/>
+		<field
+			name="automated_updates_email"
+			type="text"
+			label="COM_JOOMLAUPDATE_CONFIG_AUTOUPDATE_UPDATE_EMAIL_LABEL"
+			description="COM_JOOMLAUPDATE_CONFIG_AUTOUPDATE_UPDATE_EMAIL_DESCRIPTION"
+			showon="updatesource:default[AND]minimum_stability:4[AND]autoupdate:1"
+		/>
+	</fieldset>
 </config>

administrator/components/com_joomlaupdate/postinstall/autoupdate.php

@@ -0,0 +1,63 @@
+<?php
+
+/**
+ * @package     Joomla.Administrator
+ * @subpackage  com_joomlaupdate
+ *
+ * @copyright   (C) 2025 Open Source Matters, Inc. <https://www.joomla.org>
+ * @license     GNU General Public License version 2 or later; see LICENSE.txt
+ */
+
+use Joomla\CMS\Component\ComponentHelper;
+use Joomla\CMS\Factory;
+use Joomla\CMS\Table\Extension;
+use Joomla\Component\Joomlaupdate\Administrator\Enum\AutoupdateRegisterState;
+use Joomla\Component\Joomlaupdate\Administrator\Enum\AutoupdateState;
+use Joomla\Database\DatabaseInterface;
+use Joomla\Registry\Registry;
+
+// phpcs:disable PSR1.Files.SideEffects
+\defined('_JEXEC') or die;
+// phpcs:enable PSR1.Files.SideEffects
+
+/**
+ * Post-installation message about the new Automated Update: condition check.
+ *
+ * Returns true it is disabled.
+ *
+ * @return  bool
+ * @since   __DEPLOY_VERSION__
+ */
+function com_joomlaupdate_postinstall_autoupdate_condition(): bool
+{
+    return AutoupdateState::tryFrom(ComponentHelper::getParams('com_joomlaupdate')->get('autoupdate', '0')) === AutoupdateState::Disabled;
+}
+
+/**
+ * Post-installation message about the new Automated Update: action.
+ *
+ * Enables the Automated Update.
+ *
+ * @return  void
+ * @since   __DEPLOY_VERSION__
+ */
+function com_joomlaupdate_postinstall_autoupdate_action(): void
+{
+    $db = Factory::getContainer()->get(DatabaseInterface::class);
+
+    // Get extension row
+    $extension   = new Extension($db);
+    $extensionId = $extension->find(['element' => 'com_joomlaupdate']);
+    $extension->load($extensionId);
+
+    // Set new update registration state
+    $params = new Registry($extension->params);
+    $params->set('autoupdate', AutoupdateState::Enabled);
+    $params->set('autoupdate_status', AutoupdateRegisterState::Subscribe);
+
+    $extension->params = $params->toString();
+
+    if (!$extension->store()) {
+        throw new \RuntimeException($extension->getError());
+    }
+}

administrator/components/com_joomlaupdate/src/Controller/UpdateController.php

@@ -10,13 +10,16 @@
 
 namespace Joomla\Component\Joomlaupdate\Administrator\Controller;
 
+use Joomla\CMS\Component\ComponentHelper;
 use Joomla\CMS\Factory;
 use Joomla\CMS\Installer\Installer;
 use Joomla\CMS\Language\Text;
 use Joomla\CMS\Log\Log;
 use Joomla\CMS\MVC\Controller\BaseController;
 use Joomla\CMS\Response\JsonResponse;
 use Joomla\CMS\Session\Session;
+use Joomla\CMS\Updater\Updater;
+use Joomla\Component\Joomlaupdate\Administrator\Enum\AutoupdateRegisterState;
 use Joomla\Component\Joomlaupdate\Administrator\Model\UpdateModel;
 
 // phpcs:disable PSR1.Files.SideEffects
@@ -712,4 +715,60 @@ public function ajax()
 
         $this->app->close();
     }
+
+    /**
+     * Fetch and report health status of the automated updates in \JSON format, for AJAX requests
+     *
+     * @return  void
+     *
+     * @since   __DEPLOY_VERSION__
+     */
+    public function healthstatus()
+    {
+        if (!Session::checkToken('get')) {
+            $this->app->setHeader('status', 403, true);
+            $this->app->sendHeaders();
+            echo Text::_('JINVALID_TOKEN_NOTICE');
+            $this->app->close();
+        }
+
+        $params = ComponentHelper::getParams('com_joomlaupdate');
+
+        // Edge case: the current state requires the registration, i.e. because it's a new installation
+        $registrationState = AutoupdateRegisterState::tryFrom($params->get('autoupdate_status', 0));
+
+        if (
+            $this->app->getIdentity()->authorise('core.admin', 'com_joomlaupdate')
+            && $registrationState === AutoupdateRegisterState::Subscribe
+        ) {
+            /** @var UpdateModel $model */
+            $model  = $this->getModel('Update');
+            $result = $model->changeAutoUpdateRegistration($registrationState);
+
+            $result = [
+                'active'  => true,
+                'healthy' => $result,
+            ];
+
+            echo json_encode($result);
+
+            $this->app->close();
+        }
+
+        // Default case: connection already configured, check update source and date
+        $lastCheck = date_create_from_format('Y-m-d H:i:s', $params->get('update_last_check', ''));
+
+        $result = [
+            'active' => (
+                (int) $params->get('autoupdate')
+                && $params->get('updatesource', 'default') === 'default'
+                && (int) $params->get('minimum_stability', Updater::STABILITY_STABLE) === Updater::STABILITY_STABLE
+            ),
+            'healthy' => $lastCheck !== false && $lastCheck->diff(new \DateTime())->days < 4,
+        ];
+
+        echo json_encode($result);
+
+        $this->app->close();
+    }
 }

administrator/components/com_joomlaupdate/src/Enum/AutoupdateRegisterState.php

@@ -0,0 +1,26 @@
+<?php
+
+/**
+ * @package     Joomla.Administrator
+ * @subpackage  com_joomlaupdate
+ *
+ * @copyright   (C) 2025 Open Source Matters, Inc. <https://www.joomla.org>
+ * @license     GNU General Public License version 2 or later; see LICENSE.txt
+ */
+
+namespace Joomla\Component\Joomlaupdate\Administrator\Enum;
+
+// phpcs:disable PSR1.Files.SideEffects
+\defined('_JEXEC') or die;
+// phpcs:enable PSR1.Files.SideEffects
+
+/**
+ * Autoupdate State Enum
+ */
+enum AutoupdateRegisterState: int
+{
+    case Unsubscribe  = -1;
+    case Unsubscribed = 0;
+    case Subscribe    = 1;
+    case Subscribed   = 2;
+}

administrator/components/com_joomlaupdate/src/Enum/AutoupdateState.php

@@ -0,0 +1,24 @@
+<?php
+
+/**
+ * @package     Joomla.Administrator
+ * @subpackage  com_joomlaupdate
+ *
+ * @copyright   (C) 2025 Open Source Matters, Inc. <https://www.joomla.org>
+ * @license     GNU General Public License version 2 or later; see LICENSE.txt
+ */
+
+namespace Joomla\Component\Joomlaupdate\Administrator\Enum;
+
+// phpcs:disable PSR1.Files.SideEffects
+\defined('_JEXEC') or die;
+// phpcs:enable PSR1.Files.SideEffects
+
+/**
+ * Autoupdate State Enum
+ */
+enum AutoupdateState: int
+{
+    case Disabled = 0;
+    case Enabled  = 1;
+}