- md5
- 959e06c6d4b690bd3e4e0be1e32b95af
- sha1
- 69f418dcdcce49123b04a4c5f383425f3a37de0c
- sha256
- d29f9de85eccc7fe97b4455b8561b7747bcc36cfc1ebd208c29b650bdfab58b6
1234567891011121314151617181920212223242526272829303132333435363738394041424344454647484950515253545556575859606162636465666768697071727374757677787980818283848586
<?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\Event\CustomFields;
// phpcs:disable PSR1.Files.SideEffects
\defined('_JEXEC') or die;
// phpcs:enable PSR1.Files.SideEffects
/**
* Class for CustomFields events
*
* @since 5.0.0
*/
class AfterPrepareFieldEvent extends AbstractPrepareFieldEvent
{
/**
* The argument names, in order expected by legacy plugins.
*
* @var array
*
* @since 5.0.0
* @deprecated 5.0 will be removed in 6.0
*/
protected $legacyArgumentsOrder = ['context', 'item', 'subject', 'value'];
/**
* Constructor.
*
* @param string $name The event name.
* @param array $arguments The event arguments.
*
* @throws \BadMethodCallException
*
* @since 5.0.0
*/
public function __construct($name, array $arguments = [])
{
parent::__construct($name, $arguments);
if (!\array_key_exists('value', $this->arguments)) {
throw new \BadMethodCallException("Argument 'value' of event {$name} is required but has not been provided");
}
// For backward compatibility make sure the value is referenced
// @todo: Remove in Joomla 6
// @deprecated: Passing argument by reference is deprecated, and will not work in Joomla 6
if (key($arguments) === 0 && \count($arguments) >= 4) {
$this->arguments['value'] = &$arguments[3];
} elseif (\array_key_exists('value', $arguments)) {
$this->arguments['value'] = &$arguments['value'];
}
}
/**
* Getter for the value.
*
* @return mixed
*
* @since 5.0.0
*/
public function getValue(): mixed
{
return $this->arguments['value'];
}
/**
* Update the value.
*
* @return mixed
*
* @since 5.0.0
*/
public function updateValue(mixed $value): static
{
$this->arguments['value'] = $value;
return $this;
}
}
The same content is in 76 releases, Joomla 5.0.0-beta3 to 6.0.0-alpha3. See them all, or every version of this file.