Rhymix 개발 팁들

comment.insert_comment 트리거 내용

수표 — Sat, 20 Feb 2021 15:50:59 +0900

stdClass Object
(
    [_filter] => insert_comment
    [error_return_url] => /board1/537
    [act] => procBoardInsertComment
    [mid] => board1
    [document_srl] => 537
    [content] => <p>Contents</p>
    [module] => board
    [module_srl] => 351
    [comment_srl] => 745
    [status] => 1
    [__isupdate] => 
    [parent_srl] => 0
    [uploaded_count] => 0
    [member_srl] => 4
    [user_id] => [User ID]
    [user_name] => admin
    [nick_name] => [User Nickname]
    [email_address] => [User ID]@[domain.com]
    [homepage] => 
    [list_order] => -746
    [regdate] => 20210220154906
    [notify_message] => N
    [is_secret] => N
    [updated_file_count] => 0
)

RX] document.updateVotedCount 트리거 $obj

수표 — Wed, 20 Jan 2021 02:11:06 +0900

stdClass Object
(
    [member_srl] => 4
    [module_srl] => 351
    [document_srl] => 411
    [update_target] => voted_count
    [point] => 1
    [before_point] => 0
    [after_point] => 1
    [cancel] => 
)

stdClass Object
(
    [member_srl] => 148621
    [module_srl] => 192
    [document_srl] => 11395989
    [update_target] => voted_count
    [point] => 1
    [before_point] => 47
    [after_point] => 48
    [cancel] => 
)

RX] setPoint trigger $obj 내용

수표 — Wed, 20 Jan 2021 00:03:29 +0900

stdClass Object
(
    [member_srl] => 4
    [mode] => update //add, minus, update, signup이 있음
    [current_point] => {이전 포인트}
    [current_level] => {이전 레벨}
    [set_point] => {설정하는 포인트}
    [new_group_list] => Array
        (
        )

    [del_group_list] => Array
        (
        )

    [new_level] => {새롭게 된 레벨}
)

RX] Comment 트리거 $obj 내용

수표 — Fri, 13 Nov 2020 17:38:43 +0900

comment.insertComment 트리거

stdClass Object
(
    [_filter] => insert_comment
    [error_return_url] => /gd_dev_world/390
    [mid] => gd_dev_world
    [document_srl] => 390
    [content] => <p>asdfasdf</p>
    [use_editor] => Y
    [use_html] => Y
    [module] => board
    [act] => procBoardInsertComment
    [module_srl] => 391
    [comment_srl] => 472
    [status] => 1
    [__isupdate] => 
    [parent_srl] => 0
    [uploaded_count] => 0
    [member_srl] => 4
    [user_id] => matthew218
    [user_name] => admin
    [nick_name] => Waterticket
    [email_address] => matthew218@naver.com
    [homepage] => 
    [list_order] => -473
    [regdate] => 20201113173520
    [notify_message] => N
    [is_secret] => N
)

content => 입력한 댓글 내용

comment.deleteComment 트리거

commentItem Object
(
    [comment_srl] => 472
    [grant_cache] => 
    [columnList] => Array
        (
        )

    [error] => 0
    [message] => success
    [variables] => Array
        (
            [comment_srl] => 472
            [module_srl] => 391
            [document_srl] => 390
            [parent_srl] => 0
            [is_secret] => N
            [content] => <p>asdfasdf</p>
            [voted_count] => 0
            [blamed_count] => 0
            [notify_message] => N
            [password] => 
            [user_id] => matthew218
            [user_name] => admin
            [nick_name] => Waterticket
            [member_srl] => 4
            [email_address] => matthew218@naver.com
            [homepage] => 
            [uploaded_count] => 0
            [regdate] => 20201113173520
            [last_update] => 20201113173521
            [ipaddress] => 123.123.123.123 // IP주소
            [list_order] => -473
            [status] => 1
        )

    [httpStatusCode] => 200
    [module_srl] => 391
    [document_srl] => 390
    [parent_srl] => 0
    [is_secret] => N
    [content] => <p>asdfasdf</p>
    [voted_count] => 0
    [blamed_count] => 0
    [notify_message] => N
    [password] => 
    [user_id] => matthew218
    [user_name] => admin
    [nick_name] => Waterticket
    [member_srl] => 4
    [email_address] => matthew218@naver.com
    [homepage] => 
    [uploaded_count] => 0
    [regdate] => 20201113173520
    [last_update] => 20201113173521
    [ipaddress] => 123.123.123.123 // IP주소
    [list_order] => -473
    [status] => 1
    [isMoveToTrash] => 
)

content => 입력한 댓글 내용

ipaddress => 삭제 요청한자의 IP 주소 (여기서는 123.123.123.123 으로 수정함)

1. 모듈의 기본 구성

수표 — Thu, 29 Oct 2020 15:16:29 +0900

example_hoto 모듈

위 파일은 이 글에서 설명한 모듈 생성기를 사용하여 생성한 모듈이다

파일 구성을 보면 아래와 같다.

/
├  conf    <= 모듈의 기본 정보를 담음
│├ info.xml
│└ module.xml
├  lang    <= 모듈에 사용되는 문자열등을 담음
│└ lang.xml
├  m.skins <= 모바일에서 보여지는 스킨
├  queries <= DB 쿼리등을 담고 있음
├  schemas <= DB 테이블 정보등을 담고 있음
├  skins   <= PC에서 보여지는 스킨
│└  default/...
├  tpl     <= 관리자 화면에서 보여지는 설정 페이지
│└  ...
│
├ example_hoto.admin.controller.php
├ example_hoto.admin.model.php
├ example_hoto.admin.view.php
├ example_hoto.class.php
├ example_hoto.controller.php
├ example_hoto.mobile.php
├ example_hoto.model.php
├ example_hoto.view.php

상당히 XE의 모듈은 정교하게 만들어져있다.

MVC 구조를 기반으로 두고 있기에, 유지보수와 단체 개발이 편리한 점이 장점이다

먼저 파일들을 하나하나 들여다보며, 구조를 설명하겠다

- conf/info.xml: 모듈의 기본 정보를 담음

- conf/module.xml: 모듈의 구성요소를 설정함

action: 도메인/?mid=example_hoto&act={action의 name} 형식으로 접속하는것을 정의한다.

- lang/lang.xml

모듈에서 사용하는 string을 정의한다.

여러개의 언어를 지원할 수 있도록 만들어져 있다.

queries, schemas, skin 관련 기능은 나중에 문서를 따로 만들어 설명하겠다.

- example_hoto.class.php

기본적으로 XE 모듈은 class를 이용하여 기능들을 분리한다.

class Example_hoto extends ModuleObject
{
   ...

보통은 위와 같이 시작한다.

Example_hoto 클래스를 생성하며, ModuleObject 클래스를 상속받았기에, XE Module에서 제공하는 기본적인 함수를 사용할 수 있다.

또 트리거라는 개념이 나오게 되는데, 트리거는 아래 글을 참고하자

(참조: https://conory.com/blog/14432)

또한 모듈 생성기를 통한 함수들을 살펴보자

public function setConfig($config)

// stdClass형 데이터를 저장할 수 있다
// getConfig를 통해 불러올 수 있다
// DB에 저장되므로 일시적 저장이 아닌 영구적인 저장이다
// 모듈의 설정 데이터를 저장할때 주로 사용된다


public function getConfig()

// 모듈 설정을 가져온다
// setConfig을 통해 저장했던 Object를 그대로 리턴해준다


public function setCache($key, $value, $ttl = 86400, $group_key = null)

// 모듈 캐시를 설정해준다.
// 잘 변하지 않는 거대한 연산이 필요한 데이터를 저장하는데 요긴하다
// value에는 여러가지 타입의 변수가 들어가도 상관 없다


public function getCache($key, $ttl = 86400, $group_key = null)

// 설정한 캐시를 가져온다.


public function deleteCache($key, $group_key = null)

// 특정한 캐시를 제거한다


public function clearCache($group_key = null)

// 전체 캐시를 제거한다


public function createObject($status = 0, $message = 'success' /* $arg1, $arg2 ... */)

// Object를 리턴한다
// Object는 보통 View와 Controller 사이에서 처리결과 등을 리턴해줄때 사용된다
// return $this->createObject(-1,'error'); 와 같이 사용한다


public function checkTriggers()

// 위에 $_insert_triggers, $_delete_triggers에 있는 트리거를 확인한다


public function registerTriggers()

// 트리거를 등록한다




/* Rhymix 기본 함수 */
public function moduleInstall()

// 모듈이 최초 설치 될때 실행되는 함수이다


public function checkUpdate()

// 모듈의 변경사항이 있는지 확인하고, 업데이트 여부를 확인한다.
// true를 리턴하면 업데이트가 필요하다는 것이다.
// 업데이트 필요시, 관리자 대시보드에서 모듈 업데이트가 필요하다는 메세지가 표시된다


public function moduleUpdate()

// 관리자 대시보드에서 '모듈 업데이트' 버튼을 클릭시 실행되는 함수이다
// 여기서 업데이트 작업을 실행해주면 된다


public function recompileCache()

// 캐시파일 재생성시 실행되는 함수이다.

위와 같은 함수들이 있다.

- example_hoto.view.php

사용자들에게 표시되는 view를 위한 파일이다

뭔가 함수이름 중 하나가 익숙하지 않은가?

conf/module.xml 파일을 다시한번 보자 (위에 있음)

dispExample_hotoIndex act가 실행시 위에 함수가 실행되게 된다.

이를 위해서 module.xml에 미리 등록을 시켜둔것이다.

만약 module.xml에 act를 등록시켜두지 않거나, view.php에 act 함수를 만들어두지 않는다면 바로 오류를 뿜으며 멈춰버리니, 새로운 act를 등록할때 주의하자.

init() 함수는 해당 모듈을 불러올때 스킨 폴더를 설정해주는 것이다.

그리고 dispExample_hotoIndex 함수 속을 보면 아래 함수가 실행된다

$this->setTemplateFile('index');

이 함수는 템플릿을 설정해주는 함수인데, 현재는 skins/default/index.html을 불러온다.

dispExample_hotoIndex 함수속에서 DB에서 값을 불러와 설정하거나, 변수를 설정해서 템플릿에 전송해줄 수 있지만, 다음 글에서 설명해보겠다.

- example_hoto.model.php

이 파일은 너무 깔끔하다

Model에서는 보통 DB를 통한 데이터 저장/불러오기 등의 작업을 수행하고 view나 controller에서 사용할 수 있는 함수등을 선언한다.

하지만 지금은 모듈에 특별한 기능이 없기에 Model에도 아무런 함수가 없는것이다.

나중에 채워줄것이므로, 단순히 데이터를 다룬다는 점을 생각하고 넘어가자.

- example_hoto.controller.php

여기에는 trigger 함수들이 나와있다.

위에 class.php 파일에서 선언한 trigger가 작동하면, 위에 함수가 실행되는것이다.

또한 trigger 뿐만 아니라, 백그라운드 작업등을 담당하는데, 예를들어 view에서 form을 통해 데이터를 전달하면 그 데이터는 controller로 전송된다.

사용 방법은 view.php에 설명과 거의 비슷하나, controller에서 사용하는 함수들은 추후 설명하겠다.

admin.view.php, admin.model.php, admin.controller.php 들은 어드민용이라는 점을 제외하면 위에 설명한것과 동일하기에 넘어가겠다.

이상으로 모듈의 기본구조 설명을 마친다.

다른 모듈에서 특정 모듈이 설치되어 있는지 확인하는 방법

수표 — Thu, 29 Oct 2020 14:12:12 +0900

<?php

if(getClass('test') === NULL){
  // test 모듈/애드온이 존재하지 않을경우
}

getModel('document') → 오브젝트 반환
getModel('comment') → 오브젝트 반환
getModel('jgsdvfsiyhfhf') → NULL 반환

// 기진곰님 답변
// https://xetown.com/questions/1452965

예를들어 존재하는 모듈인 document, comment 모듈을 체크하면 클래스 오브젝트를 반환하지만, jgsdvfsiyhfhf 같이 존재하지 않는 모듈을 가져오면 NULL을 반환하게 된다.

물론 addon 모듈처럼 Model 클래스를 정의하지 않는 경우도 있으니

getModel보다는 getClass로 체크하는 것이 더 확실하지만,

실제로 사용하는 것이 Model 클래스라면 그걸 직접 확인한다고 문제가 되지는 않는다.

라이믹스나 비교적 최근 버전의 XE라면 클래스 오토로딩이 적용되어 있으니

그냥 if(class_exists('TestModel')) 로 체크해도 문제가 없다.

0. 모듈 개발시 꼭 들어가는 사이트

수표 — Thu, 29 Oct 2020 14:07:11 +0900

1. 모듈 생성 사이트: https://www.poesis.org/tools/modulegen/

POESIS - XE 모듈 생성기

TOOLS XE 모듈 생성기

www.poesis.org

Rhymix 모듈의 토대를 자동으로 생성해주는 사이트이다.

신규 모듈 만들때, 토대를 다지는 작업을 건너뛸 수 있어 정말 좋다.

이런식으로 설정을 해준다면 자동으로 모듈을 만들어서 토대 파일을 준다.

2. XE타운: https://xetown.com/

XETOWN - 웹마스터 커뮤니티

웹사이트 구축 및 운영에 관한 웹마스터 커뮤니티입니다.

xetown.com

모르는 함수나 설정이 있을때, 위 사이트에 들어가서 질문/검색을 해보면 어지간한 정보는 전부 나오게 된다

정말 없으면 안되는 사이트이다

이 블로그는 Rhymix를 이용한 기능 개발을 위한 팁 블로그입니다

수표 — Wed, 28 Oct 2020 16:56:34 +0900

이 블로그는 Rhymix(XpressEngine 1의 개선판)를 사용하며 알게된 개발 팁등을 적는 블로그 입니다.

공식 블로그는 아니며, 저 개인이 직접 모듈/애드온 개발을 위해 공부한 지식들을 적습니다.

RX가 좀 더 활성화되길 바라며 블로그를 만듭니다