CoreFiles by mySites.guru
AssociationHelper.php156 lines, 5,695 bytes, from Joomla_6.2.0-alpha2-Alpha-Full_Package.zip
Raw History Compare with 6.2.0-alpha1
md5
f89c505e73f45d3363f88d9e8e2788ca
sha1
4af3bf2ff9f8e9b6999cba310fa21260493e05e1
sha256
26442490cfb2baf69d4fb37e2e9a9b7360ffd0e5f7472fd990bb559709e1a52c
<?php

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

namespace Joomla\Component\Content\Site\Helper;

use Joomla\CMS\Factory;
use Joomla\CMS\Language\Associations;
use Joomla\CMS\Language\LanguageHelper;
use Joomla\CMS\Language\Multilanguage;
use Joomla\Component\Categories\Administrator\Helper\CategoryAssociationHelper;

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

/**
 * Content Component Association Helper
 *
 * @since  3.0
 */
abstract class AssociationHelper extends CategoryAssociationHelper
{
    /**
     * Method to get the associations for a given item
     *
     * @param   int|int[]  $id      ID of the item or array of IDs.
     * @param   string     $view    Name of the view
     * @param   string     $layout  View layout
     *
     * @return  array   Array of associations for the item, optionally grouped by ID
     *
     * @since  3.0
     */
    public static function getAssociations($id = 0, $view = null, $layout = null)
    {
        $jinput    = Factory::getApplication()->getInput();
        $view      ??= $jinput->get('view');
        $component = $jinput->getCmd('option');
        $id        = empty($id) ? $jinput->getInt('id') : $id;

        if ($layout === null && $jinput->get('view') == $view && $component == 'com_content') {
            $layout = $jinput->get('layout', '', 'string');
        }

        if ($view === 'article') {
            if ($id) {
                $user      = Factory::getUser();
                $groups    = implode(',', $user->getAuthorisedViewLevels());
                $db        = Factory::getDbo();
                $advClause = [];

                // Filter by user groups
                $advClause[] = 'c2.access IN (' . $groups . ')';

                // Filter by current language
                $advClause[] = 'c2.language != ' . $db->quote(Factory::getLanguage()->getTag());

                if (!$user->authorise('core.edit.state', 'com_content') && !$user->authorise('core.edit', 'com_content')) {
                    // Filter by start and end dates.
                    $date = Factory::getDate();

                    $nowDate = $db->quote($date->toSql());

                    $advClause[] = '(c2.publish_up IS NULL OR c2.publish_up <= ' . $nowDate . ')';
                    $advClause[] = '(c2.publish_down IS NULL OR c2.publish_down >= ' . $nowDate . ')';

                    // Filter by published
                    $advClause[] = 'c2.state = 1';
                }

                $associations = Associations::getAssociations(
                    'com_content',
                    '#__content',
                    'com_content.item',
                    (array) $id,
                    'id',
                    'alias',
                    'catid',
                    $advClause
                );

                $return = [];

                foreach ($associations as $itemId => $itemAssociations) {
                    foreach ($itemAssociations as $tag => $item) {
                        $return[$itemId][$tag] = RouteHelper::getArticleRoute($item->id, (int) $item->catid, $item->language, $layout);
                    }
                }

                return \is_array($id) ? $return : ($return[$id] ?? []);
            }
        }

        if ($view === 'category' || $view === 'categories') {
            return self::getCategoryAssociations($id, 'com_content', $layout);
        }

        return [];
    }

    /**
     * Method to display in frontend the associations for a given article
     *
     * @param   int|int[]  $id  ID of the article or array of IDs
     *
     * @return  array  An array containing the association URL and the related language object, optionally grouped by article ID
     *
     * @since  3.7.0
     */
    public static function displayAssociations($id)
    {
        $return = [];

        if ($associations = self::getAssociations((array) $id, 'article')) {
            $levels             = Factory::getUser()->getAuthorisedViewLevels();
            $languages          = LanguageHelper::getLanguages();
            $installedLanguages = LanguageHelper::getInstalledLanguages(0);
            $siteHomePages      = Multilanguage::getSiteHomePages();

            foreach ($associations as $itemId => $itemAssociations) {
                foreach ($languages as $language) {
                    // Do not display language when no association
                    if (empty($itemAssociations[$language->lang_code])) {
                        continue;
                    }

                    // Do not display language without frontend UI
                    if (!\array_key_exists($language->lang_code, $installedLanguages)) {
                        continue;
                    }

                    // Do not display language without specific home menu
                    if (!\array_key_exists($language->lang_code, $siteHomePages)) {
                        continue;
                    }

                    // Do not display language without authorized access level
                    if (isset($language->access) && $language->access && !\in_array($language->access, $levels)) {
                        continue;
                    }

                    $return[$itemId][$language->lang_code] = ['item' => $itemAssociations[$language->lang_code], 'language' => $language];
                }
            }
        }

        return \is_array($id) ? $return : ($return[$id] ?? []);
    }
}

The same content is in 9 releases, Joomla 6.2.0-alpha2 to 6.2.1-rc1. See them all, or every version of this file.