CRM_Event_Form_EventFormTrait uses trait:short
Trait implements getContactValue + overridable getContactID functions.
These are commonly used on forms - although getContactID() would often
be overridden. By using these functions it is not necessary to know
if the Contact ID has already been defined as getContactID() will retrieve
them form the values available (unless it is yet to be created).
Table of Contents
Properties
- $entityLookupDefinitions : array<string|int, mixed>
- Array of defined entity identifiers.
- $entityLookupValues : array<string|int, mixed>
- Array of defined entity values.
Methods
- getEventID() : int|null
- Get the selected Event ID.
- getEventValue() : mixed
- Get the value for a field relating to the event.
- getParticipantID() : int|null
- Get id of participant being acted on.
- getParticipantValue() : mixed
- Get a value from the participant being acted on.
- isDefined() : bool
- Check if an entity can be looked up
- isEventFull() : bool
- Is the event full already.
- lookup() : mixed
- Retrieve a field value for a defined entity
- define() : void
- Defines a record so its values can be retrieved using `$this->lookup()`
- getDefinition() : array{entityName: string, identifier: array}|null
- Retrieve entity definition (entityName string, identifier [keys/values])
Properties
$entityLookupDefinitions
Array of defined entity identifiers.
private
array<string|int, mixed>
$entityLookupDefinitions
= []
$entityLookupValues
Array of defined entity values.
private
array<string|int, mixed>
$entityLookupValues
= []
Methods
getEventID()
Get the selected Event ID.
public
getEventID() : int|null
Tags
Return values
int|nullgetEventValue()
Get the value for a field relating to the event.
public
getEventValue(string $fieldName) : mixed
All values returned in apiv4 format. Escaping may be required.
Parameters
- $fieldName : string
Tags
getParticipantID()
Get id of participant being acted on.
public
getParticipantID() : int|null
Return values
int|nullgetParticipantValue()
Get a value from the participant being acted on.
public
getParticipantValue(string $fieldName) : mixed
All values returned in apiv4 format. Escaping may be required.
Parameters
- $fieldName : string
Tags
isDefined()
Check if an entity can be looked up
public
isDefined(string $nickname) : bool
Parameters
- $nickname : string
Return values
boolisEventFull()
Is the event full already.
public
isEventFull() : bool
This function may be calculated by v4 api in time, in which case the function will call that instead but will remain available.
Tags
Return values
boollookup()
Retrieve a field value for a defined entity
public
lookup(string $nickname, string $fieldName) : mixed
Parameters
- $nickname : string
-
Handle set by
$this->define() - $fieldName : string
Tags
define()
Defines a record so its values can be retrieved using `$this->lookup()`
protected
define(string $apiEntityName, string $nickname, array<string|int, mixed> $identifier) : void
Parameters
- $apiEntityName : string
- $nickname : string
-
Handle to use to retrieve values with
$this->lookup() - $identifier : array<string|int, mixed>
-
A unique key or combination of keys to uniquely identify the record (usually id) Most commonly looks like
['id' => 123]
getDefinition()
Retrieve entity definition (entityName string, identifier [keys/values])
protected
getDefinition(string $nickname) : array{entityName: string, identifier: array}|null
Parameters
- $nickname : string