[v1.19] Update for HumHub 1.19

.github/workflows/codeception-min-version.yml

@@ -13,3 +13,4 @@ jobs:
     with:
       module-id: cfiles
       use-rest-module: true
+      rest-module-branch: develop

Events.php

@@ -2,6 +2,8 @@
 
 namespace humhub\modules\cfiles;
 
+use humhub\commands\IntegrityController;
+use humhub\helpers\ControllerHelper;
 use humhub\modules\cfiles\extensions\custom_pages\elements\FileElement;
 use humhub\modules\cfiles\extensions\custom_pages\elements\FilesElement;
 use humhub\modules\cfiles\extensions\custom_pages\elements\FolderElement;
@@ -14,7 +16,10 @@
 use humhub\modules\file\actions\DownloadAction;
 use humhub\modules\file\models\File as BaseFile;
 use humhub\modules\space\models\Space;
+use humhub\modules\space\widgets\Menu;
+use humhub\modules\ui\menu\MenuLink;
 use humhub\modules\user\models\User;
+use humhub\modules\user\widgets\ProfileMenu;
 use Yii;
 use yii\base\Event;
 
@@ -27,15 +32,16 @@ class Events
 {
     public static function onSpaceMenuInit($event)
     {
+        /* @var Menu $menu */
+        $menu = $event->sender;
 
-        if ($event->sender->space !== null && $event->sender->space->moduleManager->isEnabled('cfiles')) {
-            $event->sender->addItem([
+        if ($menu->space !== null && $menu->space->moduleManager->isEnabled('cfiles')) {
+            $menu->addEntry(new MenuLink([
                 'label' => Yii::t('CfilesModule.base', 'Files'),
-                'group' => 'modules',
                 'url' => $event->sender->space->createUrl('/cfiles/browse'),
-                'icon' => '<i class="fa fa-files-o"></i>',
-                'isActive' => (Yii::$app->controller->module && Yii::$app->controller->module->id == 'cfiles'),
-            ]);
+                'icon' => 'files-o',
+                'isActive' => ControllerHelper::isActivePath('cfiles'),
+            ]));
         }
     }
 
@@ -46,6 +52,7 @@ public static function onSpaceMenuInit($event)
      */
     public static function onIntegrityCheck($event)
     {
+        /* @var IntegrityController $integrityController */
         $integrityController = $event->sender;
         $integrityController->showTestHeadline("CFile Module (" . File::find()->count() . " entries)");
 
@@ -76,13 +83,15 @@ public static function onIntegrityCheck($event)
 
     public static function onProfileMenuInit($event)
     {
-        if ($event->sender->user !== null && $event->sender->user->moduleManager->isEnabled('cfiles')) {
-            $event->sender->addItem([
+        /* @var ProfileMenu $menu */
+        $menu = $event->sender;
+        if ($menu->user !== null && $menu->user->moduleManager->isEnabled('cfiles')) {
+            $menu->addEntry(new MenuLink([
                 'label' => Yii::t('CfilesModule.base', 'Files'),
                 'url' => $event->sender->user->createUrl('/cfiles/browse'),
-                'icon' => '<i class="fa fa-files-o"></i>',
-                'isActive' => (Yii::$app->controller->module && Yii::$app->controller->module->id == 'cfiles'),
-            ]);
+                'icon' => 'files-o',
+                'isActive' => ControllerHelper::isActivePath('cfiles'),
+            ]));
         }
     }
 

Module.php

@@ -2,7 +2,6 @@
 
 namespace humhub\modules\cfiles;
 
-use humhub\components\console\Application as ConsoleApplication;
 use humhub\modules\cfiles\models\ConfigureContainerForm;
 use humhub\modules\cfiles\models\rows\FileSystemItemRow;
 use humhub\modules\space\models\Space;
@@ -16,6 +15,16 @@
 
 class Module extends ContentContainerModule
 {
+    /**
+     * @var int Files uploaded into the same folder by the same user are announced by a single
+     *      notification, once no further file was uploaded for this many minutes.
+     *      0 announces every upload request on its own.
+     *
+     * @see \humhub\modules\cfiles\libs\FileUploadBatch
+     * @since 0.19
+     */
+    public int $uploadNotificationDelay = 10;
+
     /**
      * @var string sort name as 'name', 'size', 'updated_at'
      * @see FileSystemItemRow::ORDER_MAPPING
@@ -30,19 +39,6 @@ class Module extends ContentContainerModule
     public $defaultPostedFilesSort = FileSystemItemRow::ORDER_TYPE_UPDATED_AT;
     public $defaultPostedFilesOrder = SORT_ASC;
 
-    /**
-     * @inheritdoc
-     */
-    public function init()
-    {
-        parent::init();
-
-        if (Yii::$app instanceof ConsoleApplication) {
-            // Prevents the Yii HelpCommand from crawling all web controllers and possibly throwing errors at REST endpoints if the REST module is not available.
-            $this->controllerNamespace = 'cfiles/commands';
-        }
-    }
-
     /**
      * @inheritdoc
      */

docs/CHANGELOG.md

@@ -1,6 +1,26 @@
 Changelog
 =========
 
+0.19.0 - Unreleased
+-------------------
+- Enh #288: Send a single notification to announce all files uploaded within a short period of time, rather than sending one notification per file (humhub/humhub#5334)
+
+0.18.3 - July 22, 2026
+----------------------
+- Fix #287: Fix PHP error from deprecated search event/constant removed in HumHub 1.19
+
+0.18.2 - July 20, 2026
+----------------------
+- Fix #272: Fix Content linking with Comment
+
+0.18.1 - July 8, 2026
+---------------------
+- Enh #286: Add aria-label attribute for icon-only buttons
+
+0.18.0 - June 5, 2026
+---------------------
+- Enh #272: Update for HumHub 1.19
+
 0.17.4 - May 5, 2026
 --------------------
 - Fix #278: Improved download count accuracy

jobs/SendFileUploadNotification.php

@@ -0,0 +1,74 @@
+<?php
+
+/**
+ * @link https://www.humhub.org/
+ * @copyright Copyright (c) 2026 HumHub GmbH & Co. KG
+ * @license https://www.humhub.com/licences
+ */
+
+namespace humhub\modules\cfiles\jobs;
+
+use humhub\modules\cfiles\libs\FileUploadBatch;
+use humhub\modules\queue\ActiveJob;
+use Yii;
+
+/**
+ * Announces a batch of uploaded files with a single notification.
+ *
+ * The job is queued with a delay by [[FileUploadBatch::add()]] when the first file of a batch
+ * arrives. Since further uploads restart the quiet period, the job re-queues itself as long as
+ * the batch is not due yet.
+ *
+ * @since 0.19
+ */
+class SendFileUploadNotification extends ActiveJob
+{
+    /**
+     * @var int upper bound of re-queues, so that queue drivers which ignore the delay (the
+     *      Instant and Sync drivers run jobs right away) announce the batch instead of
+     *      re-queueing themselves endlessly.
+     */
+    public const MAX_ATTEMPTS = 10;
+
+    /**
+     * @var int
+     */
+    public $folderId;
+
+    /**
+     * @var int
+     */
+    public $userId;
+
+    /**
+     * @var int how often this job was already re-queued for the same batch
+     */
+    public $attempt = 0;
+
+    /**
+     * @inheritdoc
+     */
+    public function run()
+    {
+        $batch = FileUploadBatch::load((int)$this->folderId, (int)$this->userId);
+
+        if ($batch->isEmpty()) {
+            // Already announced, or the batch was lost through a cache flush
+            return;
+        }
+
+        $remainingDelay = $batch->getRemainingDelay();
+
+        if ($remainingDelay > 0 && $this->attempt < self::MAX_ATTEMPTS) {
+            // Uploads continued after this job was queued, wait for them to settle
+            Yii::$app->queue->delay($remainingDelay)->push(new self([
+                'folderId' => $this->folderId,
+                'userId' => $this->userId,
+                'attempt' => $this->attempt + 1,
+            ]));
+            return;
+        }
+
+        $batch->notify();
+    }
+}