그누보드5 연동 가이드
T2Editor는 그누보드5와 긴밀하게 연동될 수 있도록 설계되었습니다. 연동 절차와 고려사항은 다음과 같습니다:
- 플러그인 폴더에 업로드:
t2editor폴더를 그누보드5의/plugin또는/editor디렉터리에 업로드합니다. - 보드 설정: 게시판 관리자 페이지에서 T2Editor를 기본 에디터로 선택합니다.
- 스킨 및 테마: 기존 그누보드5 스킨과의 충돌을 피하기 위해
content.css를 적절한 위치에 포함시킵니다. - 권한 관리: 협업과 업로드 기능을 사용하기 위해
data와collab디렉터리에 707 권한을 부여합니다. - 버전 호환성: 그누보드5 5.5 이상에서 테스트 되었으며, 이전 버전에서는 호환성 문제가 발생할 수 있습니다.
- 업데이트 주의: 그누보드5를 업데이트할 때 T2Editor의 파일이 덮어쓰여지지 않도록 백업을 유지하세요.
참고 자료
- 설치 및 권한 설정: 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
- DSclub 8.2.0 배포 페이지: https://dsclub.kr/zip/998
- SIR T2Editor 8.1.2 소개 글: https://sir.kr/boards/g5_plugin/15016