XpressEngine/모듈

1. 개요#

모듈은 XE1과 라이믹스에서 게시판·회원·검색 등의 기능을 구현하는 확장 단위이다. 코어에 포함된 모듈과 별도로 배포하는 서드파티 모듈이 있으며, 애드온보다 넓은 기능과 설정 화면을 구현할 수 있다. 모든 모듈이 독립적인 게시판 화면을 갖는 것은 아니다.

XE3의 플러그인은 별도의 구조를 사용한다. XE1 모듈을 XE3의 플러그인 폴더에 복사하여 설치할 수는 없다.

2. 구조와 역할#

일반적으로 modules/모듈명/ 아래에 배치한다. conf/info.xml은 배포 정보, conf/module.xml은 액션 등을 정의하며, 모델·컨트롤러·뷰, 스키마·쿼리, 관리자 화면과 스킨을 필요에 따라 둔다. 라이믹스의 최신 구조와 API는 확장 기능 제작, 이벤트 목록, DB 쿼리를 참고한다.

3. 자료 선택과 설치#

1. XE1용인지 라이믹스용인지 먼저 구분한다. 코어 버전뿐 아니라 PHP·DB 버전과 필요한 확장 기능도 확인한다.
2. XE1 자료실, 라이믹스 공식 자료실, 제작자의 저장소에서 변경 기록과 설치 설명을 확인한다.
3. 파일과 DB를 백업하고 시험 사이트에서 설치·업데이트한다.
4. 직접 설치할 때는 폴더가 modules/name/name/처럼 중복되지 않도록 업로드한다. 관리자 화면의 설치·DB 업데이트 안내를 처리한다.
5. 권한이 다른 계정으로 기능을 시험하고, 오류 로그와 성능을 확인한다.

라이믹스 2.1.34부터 공식 자료실의 대상 자료는 쉬운 설치를 지원한다. 모든 유료·과거 자료가 대상인 것은 아니므로 배포 페이지의 지원 여부를 확인한다.

4. 관리 시 유의점#

• 권한: 관리자 메뉴를 숨기는 것만으로 보호되지 않는다. 저장·삭제·업로드 액션에서 권한과 요청 검증을 수행해야 한다. 라이믹스/매뉴얼/확장 기능 보안 점검 참고.
• 호환성: 설치 가능, 블랙리스트 미등재, 최신 PHP 호환은 서로 다른 조건이다. 라이믹스/매뉴얼/서드파티 자료 호환성 체크리스트로 확인한다.
• 제거: 사용 중지와 삭제를 구분한다. 모듈에 따라 제거 시 전용 테이블·설정·파일이 지워질 수 있으므로 제작자의 절차를 따른다.
• 장애: 코어를 직접 수정하여 억지로 실행하기 전에 오류 로그와 최근 변경 사항을 확인한다. 라이믹스/매뉴얼/업로드 오류와 서버 진단 참고.

5. 관련 모듈#

문서	용도와 적용 시 유의점
멀티 도메인	XE1용. 라이믹스에서는 블랙리스트 대상
슈퍼 캐시	캐시와 성능 설정. 현재 배포본과 구형 XE용 배포본의 호환성 구분 필요
Reaction	추천·리액션 확장
소셜 로그인	외부 계정 인증 연동
구충제	봇·IP 요청 제한과 트래픽 관리

6. 출처#

• XE1 공식 저장소
• 라이믹스 공식 매뉴얼