이벤트 라는 것은 글을 쓰는 것, 코멘트를 작성하는 것, 회원가입을 하는 것, 회원 정보를 수정하는 것, 쪽지를 보내는 것, 투표를 하는것, 기타 등등 어떤 행위를 나타냅니다.
( 생일을 맞이하거나, 회사의 출근과 퇴근, 아침식사, 점식식사, 저녁식사, 시험의 합격과 불합격, 게임에서 미션 성공과 실패, 여자친구와 기념일이 몇일이 되었거나 또는 키보드에서 특정 키를 눌었거나 하는 등 일상생활에서 일어날수 있는 행동의 전부가 이벤트의 일종입니다. 프로그램에서 이러한 이벤트를 탐지 할수 있다면 이벤트가 발생했을시 HOOK 을 통하여 해당 이벤트에서 실행될 내용을 더 하거나 또는 뺄수가 있습니다. ( 추가 또는 삭제 ) )
run_event 함수는 이벤트 시작 시 사용하는 함수입니다.
함수 인수중 $tag 는 어떤 행위를 짧게 영문자, 숫자,_ 문자열 형식으로 표기한 것을 나타냅니다. ( 아래 표기 참고 )
(
글을 쓰는 것 = write_update_after ,
코멘트를 작성하는 것 = comment_update_after,
회원가입을 하는 것 = register_form_update_after,
쪽지를 보내는 것 = memo_form_update_after
)
함수 인수중 $arg 는 add_event 함수 사용시 전해줄 인수를 나타냅니다.
function add_event($tag, $func, $priority=G5_HOOK_DEFAULT_PRIORITY, $args=0)
add_event 함수는 이벤트 시작 전에 실행될 이벤트 내용을 입력하는 함수입니다.
예를 들어 글을 쓰는 것 이벤트가 일어났을때, 관리자에게 문자를 보내고 싶다면 아래와 같이 코드를 작성합니다.
add_event('write_update_after', '실행될 문자 보내는 함수명', 10, 5);
function 실행될 문자 보내는 함수명($board, $wr_id, $w, $qstr, $redirect_url){
관리자에게 문자를 보냄...
}
run_event 함수 실행전에 add_event 함수로 입력된 내용들은 run_event 함수가 실행시 전부 실행되며,
run_event 함수 실행 이후에 add_event로 입력된 이벤트 내용은 실행되지 않습니다.
function run_replace($tag, $arg = '')
run_replace 함수는 어떤 특정 값이 수정 될수 있거나 변경 될수 있는 값을 가르킬 때 사용하는 함수입니다.
함수 인수 중 $tag 변수는 어떤 특정 값을 영문자, 숫자,_ 문자열 형식으로 표기한 것을 나타냅니다.
함수 인수중 $arg 는 add_replace 함수 사용시 전해줄 인수를 나타냅니다.
function add_replace($tag, $func, $priority=G5_HOOK_DEFAULT_PRIORITY, $args=0)
add_replace 함수는 run_replace 함수가 적용된 특정값을 수정 또는 변경시 사용되는 함수입니다.
run_replace 함수 실행전에 add_replace 함수로 입력된 내용들은 run_replace 함수가 실행시 전부 적용 되며,
run_replace 함수 실행 이후에 add_replace로 입력된 내용은 적용 되지 않습니다.
function delete_event($tag, $func, $priority=G5_HOOK_DEFAULT_PRIORITY)
run_event 함수가 실행전에 add_event 함수로 입력된 이벤트 내용을 지우고 싶을때 사용하는 함수입니다.
function delete_replace($tag, $func, $priority=G5_HOOK_DEFAULT_PRIORITY)
run_replace 함수가 실행전에 add_replace 함수로 적용될 내용을 지우고 싶을때 사용하는 함수입니다.