라이믹스/매뉴얼/확장 기능 제작

상위 문서: 라이믹스/매뉴얼

1. 개요#

라이믹스는 코어를 직접 수정하지 않고도 모듈, 애드온, 위젯, 레이아웃과 스킨을 조합하여 기능을 확장할 수 있다. 각 자료는 정해진 구조에 따라 독립적으로 배포되므로 서로 다른 제작자의 자료를 한 사이트에서 함께 사용할 수 있다.

2026년 10월 17일 기준 최신 정식 버전은 2.1.38이다. 공식 문서가 설명하는 차기 기능과 현재 설치된 버전의 지원 범위를 구분한다. 공식 로드맵의 플러그인·이벤트 개편은 릴리즈 대기, 통합 테마는 테스트 중으로 안내되어 있다.

2. 종류 선택#

종류	주된 역할	사용 예
모듈	독립적인 화면·URL·API와 데이터 처리	게시판, 회원 관리, 쇼핑몰
애드온	기존 요청의 특정 시점에 개입	출력 내용 가공, 헤더 추가
위젯	다른 화면에 삽입하는 기능 단위	최근 글 목록 등
레이아웃	사이트 전체의 공통 화면 구성	헤더, 메뉴, 푸터
스킨	모듈이나 위젯의 표시 방식	게시판 목록·본문, 위젯의 목록 모양

레이아웃과 스킨은 라이믹스/매뉴얼/테마 제작에서 다룬다. 공식 확장 기능 개요의 위젯 상세 설명은 아직 작성 중이므로, 위젯 제작 시에는 실제 사용 버전의 코어와 기존 위젯 구조도 함께 확인한다.

3. 모듈#

모듈은 MVC 구조로 기능을 구성하고, 자신의 URL, DB 스키마, 언어 파일, 템플릿 등을 한 디렉터리 안에 모아 배포할 수 있다. 같은 게시판 모듈을 여러 번 연결하여 /notice와 /qna를 각각 운영하는 것도 가능하다.

example.com/        → 페이지
example.com/notice  → 공지사항 게시판
example.com/qna     → 질문 게시판
example.com/shop    → 쇼핑몰 모듈

mid는 URL에서 모듈 인스턴스를 구분하는 데 사용하며, 각 모듈은 연결된 URL 아래의 액션과 경로를 정의한다. 짧은주소 정의는 라이믹스/라우터를 참고한다.

4. 애드온#

애드온은 요청 처리 중 정해진 호출 지점에 포함되어 실행되는 코드이다. 독립적인 화면이나 URL 없이 기존 페이지에 개입하는 기능에 사용할 수 있다. 파일 안에서는 현재 $called_position을 확인하여 필요한 시점에만 실행한다.

공식 매뉴얼은 새 자료를 만들 때 모듈 제작이 가능하다면 애드온보다 모듈을 권장한다. 기능이 복잡해지면 모듈로 관리하는 편이 적합할 수 있고, 모듈도 이벤트를 구독하여 다른 기능에 개입할 수 있기 때문이다.

5. 이벤트로 연결하기#

다른 모듈의 실행을 바꾸기 위해 그 파일을 직접 고치는 대신, 모듈이 제공하는 이벤트에 핸들러를 등록한다. 작업 전의 before와 작업 후의 after는 역할과 중단 가능 여부가 다르다. 구체적인 호출 시점은 라이믹스/매뉴얼/이벤트 목록을 참고한다.

6. 제작 전 확인#

• 지원할 라이믹스·PHP 버전을 정하고 해당 환경의 API를 사용한다.
• 사용자 입력, 로그인 상태와 권한은 서버에서 검증한다. 화면에서 버튼을 숨기는 것만으로 권한 검사를 대신하지 않는다.
• 배포할 자료의 라이선스는 라이믹스/라이선스를 확인한다.
• 코어 패치를 전제로 하기보다 이벤트·라우터·공개 API로 구현할 수 있는지 먼저 검토한다.

7. 같이 보기#

• 라이믹스/매뉴얼/DB 쿼리 operator
• 라이믹스/매뉴얼/라이믹스 프레임워크
• 라이믹스/매뉴얼/코딩 규칙

8. 출처#

이 문서는 라이믹스 공식 매뉴얼을 바탕으로 설명과 예제를 정리하였다. 공식 매뉴얼은 CC BY-SA 4.0으로 배포된다. 원문의 기여 이력은 rhymix-docs 저장소에서 확인할 수 있다.