그누보드5 연동 가이드
T2Editor는 그누보드5와 긴밀하게 연동될 수 있도록 설계되었습니다.
이 문서는 CMS 3경로 중 그누보드5만 다룹니다. 10.5.1은 어댑터 4종(그누보드5·라이믹스·스탠데얼론·워드프레스)으로 나뉘어 있고 10.3.0에서 라이믹스 2.1.x 스킨 연동과 워드프레스 업로드 연동이 추가됐습니다. 다른 환경을 쓴다면 이 문서의 경로·권한 지시를 그대로 적용하지 마십시오. 그누보드5에서 CMS 관리자 로그인이 T2Editor 관리자 권한을 대신하며, CMS 인증이 실패하는 환경에서는 T2Editor 자체 비밀번호로 로그인할 수 있습니다(10.5.1). N-05-cms-adapter-and-data-paths.md·01-installation-guide.md를 보십시오.
이 문서는 2026-09-28에 v10.5.1 기준으로 다시 썼습니다. 9.x 이하 계열은 EOL이며 업데이트 대상이 아닙니다. 연동 절차와 고려사항은 다음과 같습니다:
- 플러그인 폴더에 업로드:
t2editor폴더를g5/plugin/editor/t2editor/에 업로드합니다. CMS 판정은 설정으로 고르는 게 아니라 설치된 폴더의 파일 구조를 보고 스스로 합니다(10.5.0 CMS 어댑터). 그누보드5는 에디터가<g5>/plugin/editor아래에 있을 때만 그누보드5으로 판정하므로, 한 단계만 잘못 올려도 스탠대얼론으로 떨어집니다. - 보드 설정: 게시판 관리자 페이지에서 T2Editor를 기본 에디터로 선택합니다.
- 스킨 및 테마: 기존 그누보드5 스킨과의 충돌을 피하기 위해
content.css를 적절한 위치에 포함시킵니다. 이 지시는 10.5.1에서도 유효합니다. 에디터는 제출 시 본문에<link …/css/content.css>를 자동 삽입하지만, 그누보드5 CMS의 HTML 보안 필터가 이<link>를 지우기 때문에 스킨 쪽에서 직접 링크해 주는 것이 안전합니다. 지우면 작성 화면은 멀쩡해 보이지만 보기 화면의 표·링크카드·미디어 블록이 밋밋해집니다. N-06-server-sanitize-and-content-style.md를 보십시오. - 권한 관리: 그누보드5에서 쓰기 권한이 필요한 곳은 CMS 데이터 폴더입니다 — 미디어·첨부파일은
g5/data/editor/, 내부 데이터는g5/data/t2editor_db/(관리자 설정·인증 정보·협업 데이터·업데이트 기록·서드파티 설치 정보), 협업 데이터는g5/data/t2editor_db/collab/입니다. 10.5.1부터 이 내부 데이터는 예전의data/editor/t2editor_db가 아니라data/t2editor_db에 저장되며, 기존 파일은 자동으로 새 위치에 이전됩니다. 권한은 그누보드5의G5_DIR_PERMISSION을 그대로 따르므로t2editor/안에data·collab폴더를 새로 만들지 마십시오. 따로 chmod하기보다 그누보드5 관리자 → 환경설정 권한 설정을 먼저 확인하십시오. - 버전 호환성: 그누보드5 판본별 지원 범위는 공식 릴리즈 노트에 기재되어 있지 않습니다. 그누보드5를 갱신한 뒤에는 최소 한 개 테스트 게시판에서 작성·수정·삭제·첨부·보기 흐름을 다시 확인하십시오. (이 문서의 기존 서술인 "5.5 이상에서 테스트됨"은 확인 가능한 근거가 없어 삭제했습니다.) [확인 필요] — 그누보드5 최소 지원 판본.
- 업데이트 주의: 그누보드5를 업데이트할 때 T2Editor의 파일이 덮어쓰여지지 않도록 백업을 유지하세요.
참고로 설치 자리는 CMS마다 다릅니다. 그누보드5 g5/plugin/editor/t2editor/ · 라이믹스 rhymix/modules/editor/skins/t2editor/(폴더 이름이 t2editor가 아니면 관리자 목록에 뜨지 않습니다) · 스탠데얼론은 웹 루트나 원하는 경로의 t2editor/. 그 밖의 경로는 v10.5.1에 없습니다. N-05-cms-adapter-and-data-paths.md를 보십시오.
최초 설치 게이트: 업로드 뒤 첫 글쓰기 화면에서 T2Editor 최초 설치 안내가 뜨고, 끝까지 통과하기 전까지 편집 기능이 잠깁니다. 그누보드5·라이믹스는 CMS 관리자 로그인으로 인증을 쓰지만, CMS 인증이 실패하거나 빌더 환경에서 인식되지 않으면 ① admin/t2admin.key.txt 파일명을 admin/t2admin.key로 변경하고 ② 관리자 페이지에서 자체 비밀번호를 설정해야 합니다. 안내에 실패 항목이 남아 있으면 화면에 그대로 표시되므로 그 항목을 먼저 해결하십시오.
참고 자료
- 설치 및 권한 설정: DSclub T2Editor 서비스 페이지 - 설치·오류 안내
- 기능 설명: SIR T2Editor 8.1.2 소개 글
실제 연동에서 자주 놓치는 지점
그누보드5 연동에서 가장 많이 놓치는 부분은 본문 출력용 스타일 파일 포함, 업로드 디렉터리 권한, 게시판별 에디터 선택입니다. 설치만 끝내고 content.css를 출력 페이지에 반영하지 않으면 작성 화면은 멀쩡해 보여도 본문 보기 화면에서 미디어 블록이 깨질 수 있습니다. 또 관리자 페이지에서 전체 기본값만 바꾸고 개별 게시판 설정을 수정하지 않으면 특정 게시판에서는 여전히 기존 에디터가 유지될 수 있습니다.
스킨 충돌 대응법
그누보드5 스킨은 프로젝트마다 차이가 크므로, T2Editor가 출력하는 클래스와 기존 스킨 CSS가 충돌할 수 있습니다. 이때는 T2Editor 쪽 CSS를 무작정 수정하기보다 먼저 충돌하는 선택자를 찾아 스킨 쪽에서 범위를 제한하는 방식으로 해결하는 것이 좋습니다. 예를 들어 .view-content img처럼 지나치게 넓은 규칙이 있다면 T2Editor 미디어 블록을 별도로 제외해 주는 방식이 안전합니다.
버전 업데이트 시 점검 목록
그누보드5 자체 업데이트 후에는 에디터 호출 경로, 관리자 에디터 선택 값, 첨부파일 필터링 정책, view 스킨 CSS 포함 상태를 다시 검사해야 합니다. 에디터가 교체되거나 게시판 설정이 초기화되는 경우도 있으므로 업데이트 직후에는 최소한 한 개 테스트 게시판에서 작성·수정·삭제·첨부·보기 흐름을 다시 검수하는 것을 권장합니다.
참고 자료
- DSclub T2Editor 서비스 페이지: https://dsclub.kr/service/editor
- 현행 배포·설치 기준: https://dsclub.kr/service/editor
- 참고 이력(설치 절차의 정본으로 쓰지 마십시오): DSclub 8.2.0 배포 페이지 https://dsclub.kr/zip/998 은 2026-03 판본의 기록이며 현재 판본의 폴더 구조와 다릅니다.
- SIR T2Editor 8.1.2 소개 글: https://sir.kr/boards/g5_plugin/15016
- 설치 절차 3경로: 01-installation-guide.md
- CMS 어댑터와 데이터 경로: N-05-cms-adapter-and-data-paths.md