PrepareSaveEvent

Extends AbstractImmutableEvent

Class for SchemaPrepareSaveEvent event Example: new PrepareFormEvent('onSchemaPrepareForm', ['subject' => $subject, 'context' => $context, 'item' => $table, 'isNew' => $isNew, 'schema' => $schema]);

since

5.0.0

package

Joomla CMS

Methods

__construct

Constructor.

__construct( name, mixed||string|int arguments = []) : 
throws

BadMethodCallException

since

5.0.0

Arguments

name

stringThe event name.

arguments

array<string|int, mixed>The event arguments.

Response

mixed

create

Creates a new CMS event object for a given event name and subject. The following arguments must be given: subject object The subject of the event. This is the core object you are going to manipulate.

create( eventName, mixed||string|int arguments = []) : 
inherited static

eventClass string The Event class name. If you do not provide it Joomla\CMS\Events<eventNameWithoutOnPrefix> will be used.

since

4.0.0

throws

BadMethodCallExceptionIf you do not provide a subject argument

Arguments

eventName

stringThe name of the event, e.g. onTableBeforeLoad

arguments

array<string|int, mixed>Additional arguments to pass to the event

Response

static

getArgument

Get an event argument value.

getArgument( name,  default = null) : 
inherited

It will use a pre-processing method if one exists. The method has the signature:

onGet<ArgumentName>($value): mixed

where:

$value is the value currently stored in the $arguments array of the event It returns the value to return to the caller.

since

4.0.0

Arguments

name

stringThe argument name.

default

mixedThe default value if not found.

Response

mixedThe argument value or the default value.

getContext

Getter for the context argument.

getContext() : 
since

5.0.0

Response

string

getData

Getter for the data argument.

getData() : 
since

5.0.0

Response

object

getEventClassByEventName

Get the concrete event class name for the given event name.

getEventClassByEventName( eventName) : 
inherited static

This method falls back to the generic Joomla\Event\Event class if the event name is unknown to this trait.

since

4.2.0

Arguments

eventName

stringThe event name

Response

stringThe event class name

getIsNew

Getter for the isNew argument.

getIsNew() : 
since

5.0.0

Response

bool

getItem

Getter for the item argument.

getItem() : \Joomla\CMS\Table\TableInterface
since

5.0.0

Response

TableInterface

getSchema

Getter for the schema argument.

getSchema() : mixed||string|int
since

5.0.0

Response

array<string|int, mixed>

offsetSet

Set the value of an event argument.

offsetSet( name,  value) : 
inherited
since

4.0.0

throws

BadMethodCallException

Arguments

name

stringThe argument name.

value

mixedThe argument value.

Response

void

offsetUnset

Remove an event argument.

offsetUnset( name) : 
inherited
since

4.0.0

throws

BadMethodCallException

Arguments

name

stringThe argument name.

Response

void

onSetContext

Setter for the context argument.

onSetContext( value) : 
since

5.0.0

Arguments

value

stringThe value to set

Response

string

onSetIsNew

Setter for the isNew argument.

onSetIsNew( value) : 
since

5.0.0

Arguments

value

boolThe value to set

Response

bool

onSetItem

Setter for the item argument.

onSetItem(\Joomla\CMS\Table\TableInterface value) : \Joomla\CMS\Table\TableInterface
since

5.0.0

Arguments

value

TableInterfaceThe value to set

Response

TableInterface

onSetSchema

Setter for the schema argument.

onSetSchema(mixed||string|int value) : mixed||string|int
since

5.0.0

Arguments

value

array<string|int, mixed>The value to set

Response

array<string|int, mixed>

onSetSubject

Setter for the subject argument.

onSetSubject( value) : 
since

5.0.0

Arguments

value

objectThe value to set

Response

object

setArgument

Add argument to event.

setArgument( name,  value) : 
inherited

It will use a pre-processing method if one exists. The method has the signature:

onSet<ArgumentName>($value): mixed

where:

$value is the value being set by the user It returns the value to return to set in the $arguments array of the event.

since

4.0.0

Arguments

name

stringArgument name.

value

mixedValue.

Response

$this

Properties

eventNameToConcreteClass

Maps event names to concrete Event classes.

inherited static

This is only for events with invariable names. Events with variable names are handled with PHP logic in the getEventClassByEventName class.

since

4.2.0

Type(s)

array<string|int, mixed>