- md5
- 3a66feee7f97861e4e5220cbef852b9b
- sha1
- 423c3d4e518ae84b320cb9efdc8244aaa166d90f
- sha256
- 2a22ba9ae2f0fa77d495f20524b69f1f8672ad2f33553e40d0056583f260ff46
123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119
<?php
/**
* Joomla! Content Management System
*
* @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\CMS\Editor;
use Joomla\CMS\Editor\Exception\EditorNotFoundException;
use Joomla\CMS\Event\Editor\EditorSetupEvent;
use Joomla\Event\DispatcherAwareInterface;
use Joomla\Event\DispatcherAwareTrait;
// phpcs:disable PSR1.Files.SideEffects
\defined('_JEXEC') or die;
// phpcs:enable PSR1.Files.SideEffects
/**
* Editor Registry class
* @since 5.0.0
*/
final class EditorsRegistry implements EditorsRegistryInterface, DispatcherAwareInterface
{
use DispatcherAwareTrait;
/**
* List of registered elements
*
* @var EditorProviderInterface[]
* @since 5.0.0
*/
private $registry = [];
/**
* Internal flag of initialisation
*
* @var boolean
* @since 5.0.0
*/
private $initialised = false;
/**
* Return list of all registered elements
*
* @return EditorProviderInterface[]
* @since 5.0.0
*/
public function getAll(): array
{
return array_values($this->registry);
}
/**
* Check whether the element exists in the registry.
*
* @param string $name Element name
*
* @return bool
* @since 5.0.0
*/
public function has(string $name): bool
{
return !empty($this->registry[$name]);
}
/**
* Return element by name.
*
* @param string $name Element name
*
* @return EditorProviderInterface
* @throws EditorNotFoundException
* @since 5.0.0
*/
public function get(string $name): EditorProviderInterface
{
if (empty($this->registry[$name])) {
throw new EditorNotFoundException(\sprintf('Editor element "%s" not found in the registry.', $name));
}
return $this->registry[$name];
}
/**
* Register element in registry, add new or override existing.
*
* @param EditorProviderInterface $instance
*
* @return EditorsRegistryInterface
* @since 5.0.0
*/
public function add(EditorProviderInterface $instance): EditorsRegistryInterface
{
$this->registry[$instance->getName()] = $instance;
return $this;
}
/**
* Trigger event to allow register the element through plugins.
*
* @return EditorsRegistryInterface
* @since 5.0.0
*/
public function initRegistry(): EditorsRegistryInterface
{
if (!$this->initialised) {
$this->initialised = true;
$event = new EditorSetupEvent('onEditorSetup', ['subject' => $this]);
$this->getDispatcher()->dispatch($event->getName(), $event);
}
return $this;
}
}
The same content is in 112 releases, Joomla 5.2.0-beta3 to 6.2.1-rc1. See them all, or every version of this file.