first commit

modules/mod_articles_archive/src/Dispatcher/Dispatcher.php

@@ -0,0 +1,45 @@
+<?php
+
+/**
+ * @package     Joomla.Site
+ * @subpackage  mod_articles_archive
+ *
+ * @copyright   (C) 2023 Open Source Matters, Inc. <https://www.joomla.org>
+ * @license     GNU General Public License version 2 or later; see LICENSE.txt
+ */
+
+namespace Joomla\Module\ArticlesArchive\Site\Dispatcher;
+
+use Joomla\CMS\Dispatcher\AbstractModuleDispatcher;
+use Joomla\CMS\Helper\HelperFactoryAwareInterface;
+use Joomla\CMS\Helper\HelperFactoryAwareTrait;
+
+// phpcs:disable PSR1.Files.SideEffects
+\defined('_JEXEC') or die;
+// phpcs:enable PSR1.Files.SideEffects
+
+/**
+ * Dispatcher class for mod_articles_archive
+ *
+ * @since  4.4.0
+ */
+class Dispatcher extends AbstractModuleDispatcher implements HelperFactoryAwareInterface
+{
+    use HelperFactoryAwareTrait;
+
+    /**
+     * Returns the layout data.
+     *
+     * @return  array
+     *
+     * @since   4.4.0
+     */
+    protected function getLayoutData(): array
+    {
+        $data = parent::getLayoutData();
+
+        $data['list'] = $this->getHelperFactory()->getHelper('ArticlesArchiveHelper')->getArticlesByMonths($data['params'], $data['app']);
+
+        return $data;
+    }
+}

modules/mod_articles_archive/src/Helper/ArticlesArchiveHelper.php

@@ -0,0 +1,125 @@
+<?php
+
+/**
+ * @package     Joomla.Site
+ * @subpackage  mod_articles_archive
+ *
+ * @copyright   (C) 2006 Open Source Matters, Inc. <https://www.joomla.org>
+ * @license     GNU General Public License version 2 or later; see LICENSE.txt
+ */
+
+namespace Joomla\Module\ArticlesArchive\Site\Helper;
+
+use Joomla\CMS\Application\SiteApplication;
+use Joomla\CMS\Factory;
+use Joomla\CMS\HTML\HTMLHelper;
+use Joomla\CMS\Language\Text;
+use Joomla\CMS\Router\Route;
+use Joomla\Component\Content\Administrator\Extension\ContentComponent;
+use Joomla\Database\DatabaseAwareInterface;
+use Joomla\Database\DatabaseAwareTrait;
+use Joomla\Database\ParameterType;
+use Joomla\Registry\Registry;
+
+// phpcs:disable PSR1.Files.SideEffects
+\defined('_JEXEC') or die;
+// phpcs:enable PSR1.Files.SideEffects
+
+/**
+ * Helper for mod_articles_archive
+ *
+ * @since  1.5
+ */
+class ArticlesArchiveHelper implements DatabaseAwareInterface
+{
+    use DatabaseAwareTrait;
+
+    /**
+     * Retrieve a list of months with archived articles
+     *
+     * @param   Registry         $moduleParams  The module parameters.
+     * @param   SiteApplication  $app           The current application.
+     *
+     * @return  \stdClass[]
+     *
+     * @since   4.4.0
+     */
+    public function getArticlesByMonths(Registry $moduleParams, SiteApplication $app): array
+    {
+        $db        = $this->getDatabase();
+        $query     = $db->getQuery(true);
+
+        $query->select($query->month($db->quoteName('created')) . ' AS created_month')
+            ->select('MIN(' . $db->quoteName('created') . ') AS created')
+            ->select($query->year($db->quoteName('created')) . ' AS created_year')
+            ->from($db->quoteName('#__content', 'c'))
+            ->where($db->quoteName('c.state') . ' = ' . ContentComponent::CONDITION_ARCHIVED)
+            ->group($query->year($db->quoteName('c.created')) . ', ' . $query->month($db->quoteName('c.created')))
+            ->order($query->year($db->quoteName('c.created')) . ' DESC, ' . $query->month($db->quoteName('c.created')) . ' DESC');
+
+        // Filter by language
+        if ($app->getLanguageFilter()) {
+            $query->whereIn($db->quoteName('language'), [$app->getLanguage()->getTag(), '*'], ParameterType::STRING);
+        }
+
+        $query->setLimit((int) $moduleParams->get('count'));
+        $db->setQuery($query);
+
+        try {
+            $rows = (array) $db->loadObjectList();
+        } catch (\RuntimeException $e) {
+            $app->enqueueMessage(Text::_('JERROR_AN_ERROR_HAS_OCCURRED'), 'error');
+
+            return [];
+        }
+
+        $menu   = $app->getMenu();
+        $item   = $menu->getItems('link', 'index.php?option=com_content&view=archive', true);
+        $itemid = (isset($item) && !empty($item->id)) ? '&Itemid=' . $item->id : '';
+
+        $i     = 0;
+        $lists = [];
+
+        foreach ($rows as $row) {
+            $date = Factory::getDate($row->created);
+
+            $createdMonth = $date->format('n');
+            $createdYear  = $date->format('Y');
+
+            $createdYearCal = HTMLHelper::_('date', $row->created, 'Y');
+            $monthNameCal   = HTMLHelper::_('date', $row->created, 'F');
+
+            $lists[$i] = new \stdClass();
+
+            $lists[$i]->link = Route::_('index.php?option=com_content&view=archive&year=' . $createdYear . '&month=' . $createdMonth . $itemid);
+            $lists[$i]->text = Text::sprintf('MOD_ARTICLES_ARCHIVE_DATE', $monthNameCal, $createdYearCal);
+
+            $i++;
+        }
+
+        return $lists;
+    }
+
+    /**
+     * Retrieve list of archived articles
+     *
+     * @param   Registry  &$params module parameters
+     *
+     * @return  \stdClass[]
+     *
+     * @since   1.5
+     *
+     * @deprecated  4.4.0  will be removed in 6.0
+     *              Use the non-static method getArticlesByMonths
+     *              Example: Factory::getApplication()->bootModule('mod_articles_archive', 'site')
+     *                           ->getHelper('ArticlesArchiveHelper')
+     *                           ->getArticlesByMonths($params, Factory::getApplication())
+     */
+    public static function getList(&$params)
+    {
+        /** @var SiteApplication $app */
+        $app = Factory::getApplication();
+
+        return (new self())->getArticlesByMonths($params, $app);
+    }
+}