fead: add date field to moduleinfo.json (#149)

* feat: add date to module info
* feat: sort modules by date in list view

Author: RobinTheHood

src/Classes/ModuleConverter.php

@@ -25,6 +25,7 @@ public static function convertToArray(Module $module): array
             'sourceDir' => $module->getSourceDir(),
             'sourceMmlcDir' => $module->getSourceMmlcDir(),
             'version' => $module->getVersion(),
+            'date' => $module->getDate(),
             'shortDescription' => $module->getShortDescription(),
             'description' => $module->getDescription(),
             'developer' => $module->getDeveloper(),

src/Classes/ModuleFactory.php

@@ -79,6 +79,7 @@ public static function createFromArray(array $array): Module
         $module->setSourceDir($array['sourceDir'] ?? self::DIR_MODULE_SRC);
         $module->setSourceMmlcDir($array['sourceMmlcDir'] ?? self::DIR_MODULE_SRC_MMLC);
         $module->setVersion($array['version'] ?? 'auto');
+        $module->setDate($array['date'] ?? 'unknown');
         $module->setShortDescription($array['shortDescription'] ?? '');
         $module->setDescription($array['description'] ?? '');
         $module->setDeveloper($array['developer'] ?? '');

src/Classes/ModuleInfo.php

@@ -66,6 +66,13 @@ class ModuleInfo
      */
     protected $version;
 
+    /**
+     * Beispiel: 2023-06-20 19:42:32
+     *
+     * @var string
+     */
+    protected $date;
+
     /**
      * Eine Kurzbeschreibung des Moduls in menschen lesbarer Form.
      *
@@ -247,6 +254,16 @@ public function setVersion(string $value): void
         $this->version = $value;
     }
 
+    public function getDate(): string
+    {
+        return $this->date;
+    }
+
+    public function setDate(string $value): void
+    {
+        $this->date = $value;
+    }
+
     public function getShortDescription(): string
     {
         return $this->shortDescription;

src/Classes/ModuleSorter.php

@@ -82,4 +82,31 @@ public static function sortByVersion(array $modules): array
         });
         return $modules;
     }
+
+    /**
+     * @param Module[] $modules
+     * @return Module[] Return a array of modules sorted by version.
+     */
+    public static function sortByDate(array $modules): array
+    {
+        usort($modules, function (Module $moduleA, Module $moduleB): int {
+            $dateA = $moduleA->getDate();
+            if ($dateA === 'unknown') {
+                $dateA = '0000-00-00 00:00:00';
+            }
+
+            $dateB = $moduleB->getDate();
+            if ($dateB === 'unknown') {
+                $dateB = '0000-00-00 00:00:00';
+            }
+
+            if ($dateA < $dateB) {
+                return 1;
+            } elseif ($dateA > $dateB) {
+                return -1;
+            }
+            return 0;
+        });
+        return $modules;
+    }
 }

src/Classes/ViewModels/ModuleViewModel.php

@@ -169,6 +169,11 @@ public function getVersion(): string
         return $this->module->getVersion();
     }
 
+    public function getDate(): string
+    {
+        return $this->module->getDate();
+    }
+
     public function isRemote(): bool
     {
         return $this->module->isRemote();

src/Templates/ModuleInfo.tmpl.php

@@ -254,6 +254,11 @@
                                             <td><?= $moduleView->getVersion(); ?></td>
                                         </tr>
 
+                                        <tr>
+                                            <td>Datum</td>
+                                            <td><?= $moduleView->getDate(); ?></td>
+                                        </tr>
+
                                         <tr>
                                             <td>Kompatibel mit Modified</td>
                                             <td>
@@ -332,7 +337,9 @@
                                             <td>Alle Versionen</td>
                                             <td>
                                                 <?php foreach ($module->getVersions() as $moduleVersion) {?>
-                                                    <a href="?action=moduleInfo&archiveName=<?= $moduleVersion->getArchiveName() ?>&version=<?= $moduleVersion->getVersion()?>"><?= $moduleVersion->getVersion(); ?></a>
+                                                    <a href="?action=moduleInfo&archiveName=<?= $moduleVersion->getArchiveName() ?>&version=<?= $moduleVersion->getVersion()?>">
+                                                        <?= $moduleVersion->getVersion(); ?>
+                                                    </a>
                                                     <?php if ($moduleVersion->isInstalled()) { ?>
                                                         <span>installiert</span>
                                                     <?php } elseif ($moduleVersion->isLoaded()) { ?>

src/Templates/ModuleListing.tmpl.php

@@ -3,6 +3,7 @@
 
 use RobinTheHood\ModifiedModuleLoaderClient\ModuleStatus;
 use RobinTheHood\ModifiedModuleLoaderClient\Category;
+use RobinTheHood\ModifiedModuleLoaderClient\ModuleSorter;
 use RobinTheHood\ModifiedModuleLoaderClient\Notification;
 use RobinTheHood\ModifiedModuleLoaderClient\ViewModels\NotificationViewModel;
 
@@ -35,6 +36,7 @@
                         <h2><?= Category::getCategoryName($category); ?></h2>
                         <div class="category">
                             <?php
+                            $modules = ModuleSorter::sortByDate($modules);
                             foreach ($modules as $module) {
                                 if ($module->getVisibility() == 'hidden') {
                                     continue;