CoreFiles by mySites.guru
GuidedtoursHelper.php102 lines, 3,121 bytes, from Joomla_5.3.4-Stable-Full_Package.zip
Raw History Compare with 5.3.3
md5
cbe23a6f8f0da85f923a6a57b448b015
sha1
1befeb66f6d34f4b3ad84091b7400ea8904237fa
sha256
7aabe135422560ce3b416fbf4d6de03dae75e09c06958c5342d82a5ac21aa053
<?php

/**
 * @package     Joomla.Administrator
 * @subpackage  com_guidedtours
 *
 * @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\Component\Guidedtours\Administrator\Helper;

use Joomla\CMS\Factory;

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

/**
 * Guidedtours component helper.
 *
 * @since  5.0.0
 */
class GuidedtoursHelper
{
    /**
     * Load the translation files for a Guided Tour
     *
     * @param   string  $uid    Guided Tour Unique Identifier
     * @param   boolean $steps  Should tour steps language file be loaded
     *
     * @return  void
     *
     * @since   5.0.0
     */
    public static function loadTranslationFiles($uid, bool $steps = false)
    {
        static $cache = [];
        $uid          = strtolower($uid);

        if (isset($cache[$uid])) {
            return;
        }

        $lang   = Factory::getLanguage();

        // The uid has an extension separator so we need to check the extension language files
        if (strpos($uid, '.') > 0) {
            [$extension, $tourid] = explode('.', $uid, 2);

            $source = '';

            switch (substr($extension, 0, 3)) {
                case 'com':
                    $source = JPATH_ADMINISTRATOR . '/components/' . $extension;
                    break;

                case 'lib':
                    $source = JPATH_LIBRARIES . '/' . substr($extension, 4);
                    break;

                case 'mod':
                    $source = JPATH_SITE . '/modules/' . $extension;
                    break;

                case 'plg':
                    $parts = explode('_', $extension, 3);

                    if (\count($parts) > 2) {
                        $source = JPATH_PLUGINS . '/' . $parts[1] . '/' . $parts[2];
                    }
                    break;

                case 'pkg':
                    $source = JPATH_SITE;
                    break;

                case 'tpl':
                    $source = JPATH_BASE . '/templates/' . substr($extension, 4);
                    break;

                default:
                    $source = JPATH_ADMINISTRATOR . '/components/com_' . $extension;
                    break;
            }

            $lang->load($extension . '.' . str_replace('-', '_', $tourid), JPATH_ADMINISTRATOR)
                || $lang->load($extension . '.' . str_replace('-', '_', $tourid), $source);
            if ($steps) {
                $lang->load($extension . '.' . str_replace('-', '_', $tourid) . '_steps', JPATH_ADMINISTRATOR)
                    || $lang->load($extension . '.' . str_replace('-', '_', $tourid) . '_steps', $source);
            }
        } else {
            $lang->load('guidedtours.' . str_replace('-', '_', $uid), JPATH_ADMINISTRATOR);
            if ($steps) {
                $lang->load('guidedtours.' . str_replace('-', '_', $uid) . '_steps', JPATH_ADMINISTRATOR);
            }
        }

        $cache[$uid] = true;
    }
}

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