name : LatestHelper.php
<?php

/**
 * @package     Joomla.Administrator
 * @subpackage  mod_latest
 *
 * @copyright   (C) 2010 Open Source Matters, Inc. <https://www.joomla.org>
 * @license     GNU General Public License version 2 or later; see LICENSE.txt
 */

namespace Joomla\Module\Latest\Administrator\Helper;

use Joomla\CMS\Application\CMSApplicationInterface;
use Joomla\CMS\Factory;
use Joomla\CMS\Language\Text;
use Joomla\CMS\Router\Route;
use Joomla\Component\Content\Administrator\Model\ArticlesModel;
use Joomla\Registry\Registry;

// phpcs:disable PSR1.Files.SideEffects
\defined('_JEXEC') or die;
// phpcs:enable PSR1.Files.SideEffects

/**
 * Helper for mod_latest
 *
 * @since  1.5
 */
class LatestHelper
{
    /**
     * Get a list of articles.
     *
     * @param   Registry                 $params  The module parameters.
     * @param   ArticlesModel            $model   The model.
     * @param   CMSApplicationInterface  $app  The application instance.
     *
     * @return  mixed  An array of articles, or false on error.
     *
     * @since   5.4.0
     */
    public function getArticles(Registry $params, ArticlesModel $model, CMSApplicationInterface $app): mixed
    {
        $user = $app->getIdentity();

        // Set List SELECT
        $model->setState('list.select', 'a.id, a.title, a.checked_out, a.checked_out_time, a.modified,' .
            ' a.access, a.created, a.created_by, a.created_by_alias, a.featured, a.state, a.publish_up, a.publish_down');

        // Set Ordering filter
        switch ($params->get('ordering', 'c_dsc')) {
            case 'm_dsc':
                $model->setState('list.ordering', 'a.modified DESC, a.created');
                $model->setState('list.direction', 'DESC');
                break;

            case 'c_dsc':
            default:
                $model->setState('list.ordering', 'a.created');
                $model->setState('list.direction', 'DESC');
                break;
        }

        // Set Category Filter
        $categoryId = $params->get('catid', null);

        if (is_numeric($categoryId)) {
            $model->setState('filter.category_id', $categoryId);
        }

        // Set User Filter.
        $userId = $user->id;

        switch ($params->get('user_id', '0')) {
            case 'by_me':
                $model->setState('filter.author_id', $userId);
                break;

            case 'not_me':
                $model->setState('filter.author_id', $userId);
                $model->setState('filter.author_id.include', false);
                break;
        }

        // Set the Start and Limit
        $model->setState('list.start', 0);
        $model->setState('list.limit', $params->get('count', 5));

        $items = $model->getItems();

        if ($error = $model->getError()) {
            throw new \Exception($error, 500);
        }

        // Set the links
        foreach ($items as &$item) {
            $item->link = '';

            if (
                $user->authorise('core.edit', 'com_content.article.' . $item->id)
                || ($user->authorise('core.edit.own', 'com_content.article.' . $item->id) && ($userId === $item->created_by))
            ) {
                $item->link = Route::_('index.php?option=com_content&task=article.edit&id=' . $item->id);
            }
        }

        return $items;
    }

    /**
     * Get the alternate title for the module.
     *
     * @param   Registry                 $params  The module parameters.
     * @param   CMSApplicationInterface  $app     The application instance.
     *
     * @return  string  The alternate title for the module.
     *
     * @since   5.4.0
     */
    public function getModuleTitle(Registry $params, CMSApplicationInterface $app): string
    {
        $who   = $params->get('user_id', 0);
        $catid = (int) $params->get('catid', null);
        $type  = $params->get('ordering') === 'c_dsc' ? '_CREATED' : '_MODIFIED';
        $title = '';

        if ($catid) {
            $category = $app->bootComponent('com_content')->getCategory()->get($catid);
            $title    = Text::_('MOD_POPULAR_UNEXISTING');

            if ($category) {
                $title = $category->title;
            }
        }

        return Text::plural(
            'MOD_LATEST_TITLE' . $type . ($catid ? '_CATEGORY' : '') . ($who != '0' ? "_$who" : ''),
            (int) $params->get('count', 5),
            $title
        );
    }

    /**
     * Get a list of articles.
     *
     * @param   Registry       $params  The module parameters.
     * @param   ArticlesModel  $model   The model.
     *
     * @return  mixed  An array of articles, or false on error.
     *
     * @deprecated 5.4.0 will be removed in 7.0
     *             Use the non-static method getArticles
     *             Example: Factory::getApplication()->bootModule('mod_latest', 'administrator')
     *                          ->getHelper('LatestHelper')
     *                          ->getArticles($params, $model, Factory::getApplication())
     */
    public static function getList(Registry $params, ArticlesModel $model)
    {
        return (new self())->getArticles($params, $model, Factory::getApplication());
    }

    /**
     * Get the alternate title for the module.
     *
     * @param   Registry  $params  The module parameters.
     *
     * @return  string  The alternate title for the module.
     *
     * @deprecated 5.4.0 will be removed in 7.0
     *             Use the non-static method getModuleTitle
     *             Example: Factory::getApplication()->bootModule('mod_latest', 'administrator')
     *                          ->getHelper('LatestHelper')
     *                          ->getModuleTitle($params, Factory::getApplication())
     */
    public static function getTitle($params)
    {
        return (new self())->getModuleTitle($params, Factory::getApplication());
    }
}

© 2025 Cubjrnet7