| 트리거 | 호출시점 | 설명 |
|---|---|---|
| display | before, after | 요청의 응답을 출력하기 전과 후에 호출 |
| layout | before | |
| moduleHandler.init | before, after | |
| moduleHandler.proc | after | |
| moduleObject.proc | before, after | |
| admin.dashboard | before | 관리페이지 대시보드에 항목을 추가 |
display 🚧 초안 작성중
요청의 응답을 출력하기 전과 후에 호출된다.
php
/**
* 요청의 응답을 출력하기 전과 후에 호출
* @param string &$output 출력할 내용
*/
function (&$output = '') {
// 예시: $output 변수를 참조로 받아 내용을 추가하거나 변경 가능
$output .= '추가할 내용';
}layout 🚧 초안 작성중
moduleHandler.init before | after
모듈을 동작시키기 위해 요청 정보를 처리하여 실행할 모듈과 액션을 찾는 초기화 과정에서 호출된다.
ModuleHandler 인스턴스는 다른 방법으로 참조하기 어려우며, 이 이벤트를 활용해 참조할 수 있다.
- before :
ModuleHandler객체가 전달되어 수집된 정보를 받을 수 있다 - after : 수집한 정보로 실행할 모듈의 객체를 받을 수 있다
before
php
/**
* @see \ModuleHandler::__construct()
* @param \ModuleHandler $moduleHandler
*/
class EventHandler
{
protected static \ModuleHandler $moduleHandler;
/*
* ModuleHandler 인스턴스는 다른 방법으로 참조할 수 없기 때문에
* 이 이벤트를 사용해 미리 참조를 보관해두고 활용하는 예시이다.
*/
/**
* ModuleHandler 객체를 받아 보관해둔다
*
* @param \ModuleHandler $moduleHandler
*/
public static function beforeModuleHandlerInit(&$moduleHandler)
{
self::$moduleHandler = $moduleHandler;
}
public static function beforeDisplay()
{
// 최종 실행된 모듈의 정보과 액션을 정확히 확인할 수 있다
debugPrint(self::$moduleHandler->module);
debugPrint(self::$moduleHandler->act);
}
}xml
<module>
<eventHandlers>
<eventHandler before="moduleHandler.init"
class="Src\EventHandler"
method="beforeModuleHandlerInit" />
<eventHandler before="display"
class="Src\EventHandler"
method="beforeDisplay" />
</eventHandlers>
</module>after 🚧 초안 작성중
moduleHandler.proc 🚧 초안 작성중
moduleObject.proc 🚧 초안 작성중
admin.dashboard - 관리페이지 대시보드 before
관리페이지 대시보드에 항목을 추가할 수 있다.
왼쪽, 오른쪽 나뉘어져 있고 출력되는 항목은 각 좌, 우 배열의 순서대로 출력된다.
php
/**
* @param object{
* left: string[],
* right: string[],
* } &$dashboard 대시보드 항목
*/
function (&$dashboard) {
// 예시: 대시보드 항목을 추가
$html = <<<HTML
<section>
<h2>대시보드 항목의 제목</h2>
<div style="padding: 10px;">
<p>항목의 컨텐츠</p>
</div>
<!-- `more` 클래스를 지정하면 제목의 오른쪽에 표시된다 -->
<div class="more">
<a href="#">링크 예시 <i class="xi-angle-right"></i></a>
</div>
</section>
HTML;
// 대시보드 오른쪽에 첫번째로 추가 예시
array_unshift($dashboard->right, $html);
}