- md5
- 77af43e1ba6fb17cf81b74e9b35e48be
- sha1
- 87a659f64b9679de442fa870379115af72a679f7
- sha256
- d4699c9b87cf49d29407224b485b7f178db7b9c28bd38dac4a4c74a4d312a2a3
123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135
<?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
*/
namespace Joomla\Plugin\WebServices\Languages\Extension;
use Joomla\CMS\Factory;
use Joomla\CMS\Plugin\CMSPlugin;
use Joomla\CMS\Router\ApiRouter;
use Joomla\Router\Route;
// phpcs:disable PSR1.Files.SideEffects
\defined('_JEXEC') or die;
// phpcs:enable PSR1.Files.SideEffects
/**
* Web Services adapter for com_languages.
*
* @since 4.0.0
*/
final class Languages 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 42 releases, Joomla 4.4.0-alpha1 to 5.0.0-beta1. See them all, or every version of this file.