Contest

Contest events are dispatched during the lifecycle of contests (competitions) across both administrator and frontend environments.

---

onCompetitionDisplay

• Event Class: \NorrNext\Component\Competition\Administrator\Event\Display\CompetitionDisplayEvent

• Context: com_competition.competition

• Triggered In: Frontend Contest view (site/src/View/Competition/HtmlView.php)

Description

Fired when a contest page is initialized for rendering, allowing plugins to inspect or enrich the contest entity.

use NorrNext\Component\Competition\Administrator\Event\Display\CompetitionDisplayEvent;

public function onCompetitionDisplay(CompetitionDisplayEvent $event): void
{
    $context = $event->getContext(); // 'com_competition.competition'
    $contest = $event->getItem();    // stdClass / Competition object
}

---

onCompetitionBeforeSave

• Event Class: \NorrNext\Component\Competition\Administrator\Event\Model\BeforeSaveEvent

• Context: com_competition.competition

• Triggered In: CompetitionModel::save() (admin)

• Cancellable: Yes (returning false aborts the save)

Description

Triggered within the database transaction before the contest record is saved. Returning false aborts the operation and rolls back the transaction.

use NorrNext\Component\Competition\Administrator\Event\Model\BeforeSaveEvent;

public function onCompetitionBeforeSave(BeforeSaveEvent $event): bool
{
    $table = $event->getItem();  // Table object
    $isNew = $event->getIsNew(); // bool

    // Validation check
    if ($isNew && empty($table->title)) {
        return false; // Abort save
    }

    return true;
}

---

onCompetitionAfterSave

• Event Class: \NorrNext\Component\Competition\Administrator\Event\Model\AfterSaveEvent

• Context: com_competition.competition

• Triggered In: CompetitionModel::save() (admin)

Description

Triggered after the contest record is successfully written to the database table.

use NorrNext\Component\Competition\Administrator\Event\Model\AfterSaveEvent;

public function onCompetitionAfterSave(AfterSaveEvent $event): void
{
    $table = $event->getItem();  // Saved table object
    $isNew = $event->getIsNew(); // bool
}

---

onCompetitionBeforeDelete

• Event Class: \NorrNext\Component\Competition\Administrator\Event\Model\BeforeDeleteEvent

• Context: com_competition.competition

• Triggered In: CompetitionModel::delete() (admin)

• Cancellable: Yes (returning false aborts deletion)

Description

Triggered before deleting a contest. Returning false prevents deletion.

use NorrNext\Component\Competition\Administrator\Event\Model\BeforeDeleteEvent;

public function onCompetitionBeforeDelete(BeforeDeleteEvent $event): bool
{
    $table = $event->getItem(); // Contest table object to be deleted

    // Prevent deletion if condition is met
    return true;
}

---

onCompetitionAfterDelete

• Event Class: \NorrNext\Component\Competition\Administrator\Event\Model\AfterDeleteEvent

• Context: com_competition.competition

• Triggered In: CompetitionModel::delete() (admin)

Description

Triggered after the contest and associated cascade records are deleted from the database.

use NorrNext\Component\Competition\Administrator\Event\Model\AfterDeleteEvent;

public function onCompetitionAfterDelete(AfterDeleteEvent $event): void
{
    $table = $event->getItem(); // Deleted contest table object
}

---

onCompetitionChangeState

• Context: com_competition.competition

• Triggered In: CompetitionModel::publish() (admin)

Description

Fired after one or more contests have their published state changed.

use Joomla\Event\Event;

public function onCompetitionChangeState(Event $event): void
{
    $context = $event->getArgument('context');
    $pks     = $event->getArgument('pks', []);
    $value   = $event->getArgument('value'); // 1 = Published, 0 = Unpublished, -2 = Trashed
}

---

onCompetitionChangeStatus

• Event Class: \NorrNext\Component\Competition\Administrator\Event\Competition\ChangeStatusEvent

• Context: com_competition.competition

• Triggered In: Automatic contest lifecycle checks

Description

Fired when a contest status changes automatically (for example, when the contest voting period closes and the status transitions from Active to Closed).

use NorrNext\Component\Competition\Administrator\Event\Competition\ChangeStatusEvent;

public function onCompetitionChangeStatus(ChangeStatusEvent $event): void
{
    $contest = $event->getCompetition(); // Contest entity
    $status  = $event->getStatus();      // 0 = Closed, 1 = Active
}