OnGetApiFields
Extends AbstractImmutableEventEvent for getting extra API Fields and Relations to render with an entity
since |
4.0.0 |
---|---|
package |
Joomla CMS |
Methods
__construct
Constructor. Overridden to go through the argument setters.
__construct(string name, array arguments = []) : mixed
since |
4.0.0 |
---|
Arguments
- name
string
The event name.- arguments
array
The event arguments.
Response
mixed
addFields
Allows the user to add names of properties that will be interpreted as relations Note that if there is an existing data property it will also be displayed as well as the relation due to the internal implementation (this behaviour is not part of this API however and should not be guaranteed)
addFields(string[] fields) : void
Arguments
- fields
string[]
The array of additional fields to add to the data of the attribute
addRelations
Allows the user to add names of properties that will be interpreted as relations Note that if there is an existing data property it will also be displayed as well as the relation due to the internal implementation (this behaviour is not part of this API however and should not be guaranteed)
addRelations(string[] fields) : void
Arguments
- fields
string[]
The array of additional fields to add as relations
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(string eventName, array arguments = []) : 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 |
|
Arguments
- eventName
string
The name of the event, e.g. onTableBeforeLoad- arguments
array
Additional arguments to pass to the event
Response
static
getAllPropertiesToRender
Get properties to render.
getAllPropertiesToRender() : array
Response
array
getAllRelationsToRender
Get properties to render.
getAllRelationsToRender() : array
Response
array
getArgument
Get an event argument value. It will use a getter method if one exists. The getters have the signature:
getArgument(string name, mixed default = null) : mixed
get<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
string
The argument name.- default
mixed
The default value if not found.
Response
mixed
The argument value or the default value.
getEventClassByEventName
Get the concrete event class name for the given event name.
getEventClassByEventName(string eventName) : string
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
string
The event name
Response
string
The event class name
offsetSet
Set the value of an event argument.
offsetSet(string name, mixed value) : void
since |
4.0.0 |
---|---|
throws |
|
Arguments
- name
string
The argument name.- value
mixed
The argument value.
offsetUnset
Remove an event argument.
offsetUnset(string name) : void
since |
4.0.0 |
---|---|
throws |
|
Arguments
- name
string
The argument name.
setArgument
Add argument to event. It will use a setter method if one exists. The setters have the signature:
setArgument(string name, mixed value) : $this
set<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
string
Argument name.- value
mixed
Value.
Response
$this
setFields
Setter for the fields argument
setFields(mixed value) : array
throws |
|
---|
Arguments
- value
mixed
The value to set
Response
array
setRelations
Setter for the relations argument
setRelations(mixed value) : array
throws |
|
---|
Arguments
- value
mixed
The value to set
Response
array
setType
Setter for the type argument
setType(int value) : mixed
throws |
|
---|
Arguments
- value
int
The constant from VIEW_TYPE
Response
mixed
Constants
LIST
List of types of view supported
Value | 'list' |
---|---|
since |
4.0.0 |
ITEM
List of types of view supported
Value | 'item' |
---|---|
since |
4.0.0 |
Properties
extraRelations
List of names of properties that will be rendered as relations
extraAttributes
List of names of properties that will be rendered as data
constructed
A flag to see if the constructor has been already called.
eventNameToConcreteClass
Maps event names to concrete Event classes.
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