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

namespace Joomla\Component\Users\Administrator\Extension;

\defined('JPATH_PLATFORM') or die;

use Joomla\CMS\Component\Router\RouterServiceInterface;
use Joomla\CMS\Component\Router\RouterServiceTrait;
use Joomla\CMS\Extension\BootableExtensionInterface;
use Joomla\CMS\Extension\MVCComponent;
use Joomla\CMS\Factory;
use Joomla\CMS\Fields\FieldsServiceInterface;
use Joomla\CMS\HTML\HTMLRegistryAwareTrait;
use Joomla\Component\Users\Administrator\Service\HTML\Users;
use Psr\Container\ContainerInterface;

/**
 * Component class for com_users
 *
 * @since  4.0.0
 */
class UsersComponent extends MVCComponent implements BootableExtensionInterface, RouterServiceInterface, FieldsServiceInterface
{
	use RouterServiceTrait;
	use HTMLRegistryAwareTrait;

	/**
	 * Booting the extension. This is the function to set up the environment of the extension like
	 * registering new class loaders, etc.
	 *
	 * If required, some initial set up can be done from services of the container, eg.
	 * registering HTML services.
	 *
	 * @param   ContainerInterface  $container  The container
	 *
	 * @return  void
	 *
	 * @since   4.0.0
	 */
	public function boot(ContainerInterface $container)
	{
		$this->getRegistry()->register('users', new Users);
	}

	/**
	 * Returns a valid section for the given section. If it is not valid then null is returned.
	 *
	 * @param   string       $section  The section to get the mapping for
	 * @param   object|null  $item     The content item or null
	 *
	 * @return  string|null  The new section or null
	 *
	 * @since   4.0.0
	 */
	public function validateSection($section, $item = null)
	{
		if (Factory::getApplication()->isClient('site'))
		{
			switch ($section)
			{
				case 'registration':
				case 'profile':
					return 'user';
			}
		}

		if ($section === 'user')
		{
			return $section;
		}

		// We don't know other sections.
		return null;
	}

	/**
	 * Returns valid contexts.
	 *
	 * @return  array  Associative array with contexts as keys and translated strings as values
	 *
	 * @since   4.0.0
	 */
	public function getContexts(): array
	{
		$language = Factory::getApplication()->getLanguage();
		$language->load('com_users', JPATH_ADMINISTRATOR);

		return [
			'com_users.user' => $language->_('COM_USERS'),
		];
	}
}
