CoreFiles by mySites.guru
languages.php131 lines, 4,128 bytes, from Joomla_4.0.3-Stable-Full_Package.zip
Raw History Compare with 4.0.2
md5
e768b5b7a38a08e70cb019a11ec38c8e
sha1
98f6654a0db015c01f6f39cf1764c972d467cb4f
sha256
612dce3ccdbdb5c5fb18b855d90c87eb7ffea78ff20a91e2d674587a89be04dd
<?php
/**
 * @package     Joomla.Plugin
 * @subpackage  Webservices.Languages
 *
 * @copyright   (C) 2019 Open Source Matters, Inc. <https://www.joomla.org>
 * @license     GNU General Public License version 2 or later; see LICENSE.txt
 */

defined('_JEXEC') or die;

use Joomla\CMS\Factory;
use Joomla\CMS\Plugin\CMSPlugin;
use Joomla\CMS\Router\ApiRouter;
use Joomla\Router\Route;

/**
 * Web Services adapter for com_languages.
 *
 * @since  4.0.0
 */
class PlgWebservicesLanguages extends CMSPlugin
{
	/**
	 * Load the language file on instantiation.
	 *
	 * @var    boolean
	 * @since  4.0.0
	 */
	protected $autoloadLanguage = true;

	/**
	 * Registers com_languages's API's routes in the application
	 *
	 * @param   ApiRouter  &$router  The API Routing object
	 *
	 * @return  void
	 *
	 * @since   4.0.0
	 */
	public function onBeforeApiRoute(&$router)
	{
		$router->createCRUDRoutes(
			'v1/languages/content',
			'languages',
			['component' => 'com_languages']
		);

		$this->createLanguageOverridesRoutes($router);
		$this->createLanguageInstallerRoutes($router);
	}

	/**
	 * Create language overrides routes
	 *
	 * @param   ApiRouter  &$router  The API Routing object
	 *
	 * @return  void
	 *
	 * @since   4.0.0
	 */
	private function createLanguageOverridesRoutes(&$router)
	{
		$defaults = ['component' => 'com_languages'];

		$routes = [
			new Route(['POST'], 'v1/languages/overrides/search', 'strings.search', [], $defaults),
			new Route(['POST'], 'v1/languages/overrides/search/cache/refresh', 'strings.refresh', [], $defaults),
		];

		$router->addRoutes($routes);

		/** @var \Joomla\Component\Languages\Administrator\Model\LanguagesModel $model */
		$model = Factory::getApplication()->bootComponent('com_languages')
			->getMVCFactory()->createModel('Languages', 'Administrator', ['ignore_request' => true]);

		foreach ($model->getItems() as $item)
		{
			$baseName          = 'v1/languages/overrides/site/' . $item->lang_code;
			$controller        = 'overrides';
			$overridesDefaults = array_merge($defaults, ['lang_code' => $item->lang_code, 'app' => 'site']);
			$getDefaults       = array_merge(['public' => false], $overridesDefaults);

			$routes = [
				new Route(['GET'], $baseName, $controller . '.displayList', [], $getDefaults),
				new Route(['GET'], $baseName . '/:id', $controller . '.displayItem', ['id' => '([A-Z0-9_]+)'], $getDefaults),
				new Route(['POST'], $baseName, $controller . '.add', [], $overridesDefaults),
				new Route(['PATCH'], $baseName . '/:id', $controller . '.edit', ['id' => '([A-Z0-9_]+)'], $overridesDefaults),
				new Route(['DELETE'], $baseName . '/:id', $controller . '.delete', ['id' => '([A-Z0-9_]+)'], $overridesDefaults),
			];

			$router->addRoutes($routes);

			$baseName          = 'v1/languages/overrides/administrator/' . $item->lang_code;
			$overridesDefaults = array_merge($defaults, ['lang_code' => $item->lang_code, 'app' => 'administrator']);
			$getDefaults       = array_merge(['public' => false], $overridesDefaults);

			$routes = [
				new Route(['GET'], $baseName, $controller . '.displayList', [], $getDefaults),
				new Route(['GET'], $baseName . '/:id', $controller . '.displayItem', ['id' => '([A-Z0-9_]+)'], $getDefaults),
				new Route(['POST'], $baseName, $controller . '.add', [], $overridesDefaults),
				new Route(['PATCH'], $baseName . '/:id', $controller . '.edit', ['id' => '([A-Z0-9_]+)'], $overridesDefaults),
				new Route(['DELETE'], $baseName . '/:id', $controller . '.delete', ['id' => '([A-Z0-9_]+)'], $overridesDefaults),
			];

			$router->addRoutes($routes);
		}
	}

	/**
	 * Create language installer routes
	 *
	 * @param   ApiRouter  &$router  The API Routing object
	 *
	 * @return  void
	 *
	 * @since   4.0.0
	 */
	private function createLanguageInstallerRoutes(&$router)
	{
		$defaults    = ['component' => 'com_installer'];
		$getDefaults = array_merge(['public' => false], $defaults);

		$routes = [
			new Route(['GET'], 'v1/languages', 'languages.displayList', [], $getDefaults),
			new Route(['POST'], 'v1/languages', 'languages.install', [], $defaults),
		];

		$router->addRoutes($routes);
	}
}

The same content is in 49 releases, Joomla 4.0.0-rc1 to 4.2.0-beta2. See them all, or every version of this file.