# Entry

### onParticipantDisplay

**Description**\
This event is triggered in `CompetitionViewParticipant::display` (site).

```php
public function onParticipantDisplay($context, $item)
{
    // Do something
}
```

**Arguments**\
`$context` - the context of the event, ‘com\_competition.participant’.\
`$item` - the entry object.

### onParticipantBeforeDelete

### onParticipantAfterDelete

**Description**\
These events are triggered in `CompetitionModelParticipant::delete` (admin). If the plugin returns `false` for `onParticipantBeforeDelete` event then the entry is not being deleted.

```php
public function onParticipantBeforeDelete($context, $table)
{
    // Do something
    return true;
}
```

**Arguments**\
`$context` - the context of the event, ‘com\_competition.participant’.\
`$table` - a reference to `CompetitionTableParticipant` object.

### onParticipantBeforeSave

### onParticipantAfterSave

**Description**\
These plugins are triggered in `CompetitionModelAppform::saveParticipant` (site) and `CompetitionModelParticipant::save` (admin). If the plugin returns `false` for `onParticipantBeforeSave` event then the entry is not being saved to the database and transaction is rolled back.

Please note that `onParticipantAfterSave` event is triggered inside the transaction that can be rolled back. To make sure that all the data is saved use the `*AfterSaveTransactionCommit` event.

```php
public function onParticipantAfterSave($context, $table)
{
    // Do something
    return;
}
```

**Arguments**\
`$context` - the context of the event: ‘com\_competition.participant’ or ‘com\_competition.appform’.\
`$table` - a reference to CompetitionTableParticipant object.\
`$isNew` - true for new entry, false otherwise.

### onParticipantBeforeSaveTransactionCommit

### onParticipantAfterSaveTransactionCommit

**Description**\
These plugins are triggered in `CompetitionModeParticipant::save` (admin). If the plugin returns `false` for `onParticipantBeforeSaveTransactionCommit` event then the entry is not being saved to the database and transaction is rolled back.

```php
public function onParticipantBeforeSaveTransactionCommit($context, $data, $isNew)
{
    // Abort save and all transaction
    return false;
}
```

**Arguments**\
`$context` - the context of the event, ‘com\_competition.participant’.\
`$data` - the validated entry form data.\
`$isNew` - true for new entry, false otherwise.

### onParticipantAllowedCompetitionVotes

**Description**\
This event is triggered in `CompetitionModelParticipant::getVoteData` (site) and allows to modify the maximum allowed votes for contest. For example to provide additional votes for a user.

```php
public function onParticipantAllowedCompetitionVotes($context, $participantId, $competition, &$allowedVotes)
{
    // Set the allowed votes
    $allowedVotes = 2;
    
    return true;
}
```

**Arguments**\
`$context` - the context of the event, ‘com\_competition.participant’.\
`$participantId` - the entry ID.\
`$competition` - a contest object.\
`&$allowedVotes` - allowed contest votes.

### onParticipantAllowedParticipantVotes

**Description**\
This event is triggered in `CompetitionModelParticipant::getVoteData` (site) and allows to modify the maximum allowed votes per entry. For example to provide additional votes for a user.

```php
public function onParticipantAllowedParticipantVotes($context, $participantId, $competition, &$allowedVotes)
{
    // Set the allowed votes
    $allowedVotes = 2;
    
    return true;
}
```

**Arguments**\
`$context` - the context of the event, ‘com\_competition.participant’.\
`$participantId` - the entry ID.\
`$competition` - a reference to contest object.\
`&$allowedVotes` - allowed entry votes.

### onParticipantCheckVoteFrequency

**Description**\
This event is triggered in `CompetitionModelParticipant::getVoteData` (site). If the plugin returns `false` then vote frequency check is being skipped. This allows to provide an immediate vote for a user.

```php
public function onParticipantCheckVoteFrequency($context, $participantId, $competition)
{
    // Skip this check and allow to vote immediately
    return false;
}
```

**Arguments**\
`$context` - the context of the event, ‘com\_competition.participant’.\
`$participantId` - the entry ID.\
`$competition` - a reference to contest object.

### onParticipantBeforeVoteSave

### onParticipantAfterVoteSave

**Description**\
These events are triggered in `CompetitionModelParticipant::vote` (site). If the plugin returns `false` for `onParticipantBeforeVoteSave` event then the vote is not being saved to the database and error is being retruned to a user.

```php
public function onParticipantBeforeVoteSave($context, $table, Registry $competitionParams)
{
    // Abort vote saving
    return false;
}
```

**Arguments**\
`$context` - the context of the event, ‘com\_competition.participant’.\
`$table` - a reference to `CompetitionTableVote` object. `$competitionParams` - the parameters of competition in which a vote was taken.

### onParticipantBeforeChangeState

**Description**\
This event is triggered in `CompetitionModelParticipant::publish` (admin) before participant has its state changed.

```php
public function onParticipantBeforeChangeState($context, $pk, $value)
{
    // Abort vote saving
    return false;
}
```

**Arguments**\
`$context` - the context of the event, ‘com\_competition.participant’.\
`$pk` - the ID of entry.\
`$value` - the value of the state: -2 - deleted; 0 - unpublished; 1 - published.

### onParticipantChangeState

**Description**\
This event is triggered in `CompetitionModelParticipant::publish` (admin) after entry has its state changed.

```php
public function onParticipantChangeState($context, $pks, $value)
{
    // Abort vote saving
    return false;
}
```

**Arguments**\
`$context` - the context of the event, ‘com\_competition.participant’.\
`$pks` - a list of the primary keys to change.\
`$value` - the value of the state: -2 - deleted; 0 - unpublished; 1 - published.

### onParticipantBeforeApprove

**Description**\
This event is triggered in `CompetitionModelParticipant::approve` (admin) before entry has its approval state changed.

```php
public function onParticipantBeforeApprove($context, $table, $value)
{
    // Do something
}
```

**Arguments**\
`$context` - the context of the event, ‘com\_competition.participant’.\
`$table` - the entry table object.\
`$value` - the value of the state: 0 - unapproved; 1 - approved.

### onParticipantApprove

**Description**\
This event is triggered in `CompetitionModelParticipant::approve` (admin) after the entry has its approval state changed.

```php
public function onParticipantApprove($context, $pks, $value)
{
    // Do something
    return;
}
```

**Arguments**\
`$context` - the context of the event, ‘com\_competition.participant’.\
`$item` - a list of the primary keys to change.\
`$params` - the value of the state: 0 - unapproved; 1 - approved.


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.norrnext.com/norrcompetition/customisation/events/entry.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.