버전별 이슈 및 대응 가이드

T2Editor는 꾸준한 업데이트를 통해 기능이 추가되고 버그가 수정되고 있습니다. 그러나 버전이 변경될 때마다 일부 기능이 예기치 않게 동작하지 않거나, 기존 플러그인이 호환되지 않는 문제가 발생할 수 있습니다. 이 문서에서는 DSclub과 SIR 커뮤니티에서 보고된 주요 버전별 이슈와 그에 대한 해결 방법을 정리합니다. 이를 통해 웹마스터와 개발자는 버전 업그레이드 전후에 발생할 수 있는 문제를 예측하고 대비할 수 있습니다.

개요

T2Editor는 버전 5.x부터 9.x까지 다양한 릴리스를 거치면서 기능이 크게 발전했습니다. 예전 버전과 비교할 때 플러그인 구조, API 연동, UI 렌더링 방식 등이 변경되었기 때문에, 구버전 플러그인이 신버전에서 동작하지 않는 사례가 많습니다. 업데이트 로그와 커뮤니티 게시물을 기반으로 한 주요 이슈는 아래와 같습니다.

9.0.0 버전 (현행 버전)

주요 추가 사항

NSFW 필터와 밈 플러그인 통합: 9.0.0 버전에서는 NSFW(부적절 콘텐츠) 필터와 밈 이미지 검색 플러그인이 기본 포함되었습니다. 이 기능은 DSclub 서버의 API를 호출해 이미지를 필터링하고 밈을 검색합니다.
AI 플러그인 개선: 기존 8.x 버전에서 제기되던 AI 플러그인의 오류를 해결하고, 편집 내용 일부를 선택해 수정 요청을 보낼 수 있는 기능이 추가되었습니다SIR T2Editor 8.1.2 후속 공지 및 서비스 주의사항.

알려진 이슈

AI 호출 제한 적용: 9.0.0에도 IP·도메인별 호출 횟수 제한이 적용되며, 호출 횟수를 초과하면 에러가 발생합니다SIR T2Editor 8.1.2 AI·검색 기능 설명.
NSFW 필터 오탐지: NSFW 필터가 정상적인 이미지를 차단하는 경우가 있으며, 필터 알고리즘이 개선될 때까지는 임시로 필터를 비활성화하거나 차단된 이미지를 허용 목록에 추가해야 합니다.
플러그인 호환성: 8.x 버전에서 제작된 일부 커스텀 플러그인이 9.0.0에서 동작하지 않습니다. 이는 코어 이벤트 시스템 변경에 따른 것으로, 플러그인 코드를 최신 이벤트 명세에 맞춰 수정해야 합니다.
라이선스 인증: 라이선스 파일에 버전 식별자가 추가되어, 구버전 라이선스를 사용할 경우 인증이 실패합니다. DSclub에서 9.0.0 전용 라이선스를 재다운로드해야 합니다DSclub T2Editor 서비스 페이지 - 설치·오류 안내.

대응 전략

AI 플러그인을 자주 사용하는 사이트는 Groq API 등 대체 API를 도입하여 호출 제한을 회피합니다SIR T2Editor 8.1.2 후속 공지 및 서비스 주의사항.
NSFW 필터의 민감도를 낮추거나, NSFW 기능을 별도 플러그인으로 분리하여 필요할 때만 활성화합니다.
커스텀 플러그인은 이벤트 처리 함수를 t2editor_event_dispatch 구조에 맞춰 수정합니다. 이벤트 이름이 변경되었거나 파라미터가 달라졌는지 문서 core-editor-lib-php.md를 참조하세요.

8.2.0 버전

주요 추가 사항

플러그인 로딩 지연 기능: 기본 플러그인 외에 커스텀 플러그인을 0~3 단계로 로딩 우선순위를 지정할 수 있습니다SIR T2Editor 8.1.2 기능 설명.
터치 최적화 및 다크모드 개선: 모바일 환경에서의 사용성을 크게 향상시켰고, 다크모드 전환 시 발생하던 스타일 버그를 수정했습니다SIR T2Editor 8.1.2 기능 설명.
T2Search 및 AI 기능 도입: 외부 검색 및 AI 기능이 본격적으로 도입되어 콘텐츠 작성 효율이 높아졌습니다SIR T2Editor 8.1.2 AI·검색 기능 설명.

알려진 이슈

AI 플러그인 오류: 일부 서버 환경에서 AI 플러그인의 요청이 실패하는 문제가 보고되었습니다. DSclub의 패치 노트에 따르면 8.1.3에서 해결될 예정이었지만, 일부 사용자 환경에서는 여전히 오류가 발생할 수 있습니다SIR T2Editor 8.1.2 후속 공지 및 서비스 주의사항.
자동 저장 기능 미작동: 작성 중인 게시물이 주기적으로 저장되지 않는 문제가 있었습니다. DSclub은 8.1.3 패치에서 이 문제를 수정했다고 공지했습니다SIR T2Editor 8.1.2 후속 공지 및 서비스 주의사항.
네이티브 플러그인과의 충돌: 8.2.0부터 플러그인 로딩 지연 기능이 도입되면서, 로딩 순서를 잘못 설정하면 에디터 초기화 시점에 필요한 플러그인이 로드되지 않아 버튼이 비활성화되는 문제가 발생했습니다.

대응 전략

DSclub에서 제공하는 8.1.3 이상의 패치를 적용하고, AI 플러그인 설정을 최신 버전으로 업데이트합니다SIR T2Editor 8.1.2 후속 공지 및 서비스 주의사항.
자동 저장 기능이 미작동하면 브라우저 콘솔에서 에러 메시지를 확인하고, 서버 로그에서 파일 쓰기 오류를 점검합니다.
플러그인 로딩 순서를 설정할 때 기본 제공 플러그인을 0번으로 설정하고, 커스텀 플러그인은 1~3 사이로 설정하여 에디터 초기화를 방해하지 않도록 합니다SIR T2Editor 8.1.2 기능 설명.

8.1.x 버전

특징과 변경사항

이전 버전의 버그 수정: 8.1.0 ~ 8.1.2 버전에서는 이미지 업로드 시 webp 변환 오류, 다크모드에서 색상 반전 문제, 일부 플러그인 스타일 충돌 등이 수정되었습니다DSclub T2Editor 서비스 페이지.
버전 명명 규칙 변경: DSclub은 8.1.2 이후부터 버전을 재정비하여 과거 베타 버전을 정식 버전 번호에 통합했습니다. 사용자들은 버전 번호가 달라졌다고 혼동할 수 있으므로, 패치 노트를 반드시 확인해야 합니다DSclub T2Editor 서비스 페이지 - 버전 변경 공지.

알려진 이슈 및 대응

라이선스 파일 누락: 8.1.x 버전에서 라이선스 파일이 누락된 채 배포된 사례가 있었습니다. DSclub 페이지에서 해당 버전 전용 라이선스를 별도로 다운로드하여 license.txt를 추가해야 합니다DSclub T2Editor 서비스 페이지 - 설치·오류 안내.
MIME 타입 오류: 업로드 시 PHP의 fileinfo 모듈이 비활성화되어 발생하는 오류가 있었습니다. php.ini에서 extension=fileinfo를 주석 해제하고 서버를 재시작합니다.
테이블 삽입 문제: 8.1.1 버전에서 표 삽입 시 셀 병합이 제대로 적용되지 않는 버그가 보고되었으나, 8.1.2 패치에서 수정되었습니다DSclub T2Editor 서비스 페이지.

구버전 (5.x~7.x)

T2Editor 초기 버전에서는 현재와 구조가 크게 다르기 때문에, 최신 플러그인을 그대로 사용할 수 없습니다. 다음과 같은 문제가 자주 발생합니다.

플러그인 구조 불일치: 5.x~7.x 버전의 플러그인 API는 editor.lib.php의 함수 시그니처와 이벤트명이 달라서 8.x/9.x용 플러그인이 호환되지 않습니다.
다크모드 미지원: 구버전에서는 다크모드가 기본 제공되지 않아, 8.x 이후에 작성된 테마가 깨질 수 있습니다.
라이선스 정책 차이: 5.x 버전대에서는 커스텀 플러그인 판매가 제한되었으나, 5.7.2 버전에서 라이선스가 변경되어 커스텀 플러그인 판매가 가능해졌습니다DSclub T2Editor 서비스 페이지 - 라이선스 변경 관련 안내. 하지만 core와 기본 플러그인은 여전히 무료로 유지해야 합니다.

종합 대응 가이드

업데이트 테스트 환경: 운영 사이트에 적용하기 전에 로컬 또는 스테이징 환경에서 최신 버전으로 업데이트하고 플러그인의 동작을 확인합니다.
변경 로그 확인: DSclub와 SIR에 게시된 패치 노트와 공지를 주기적으로 확인하며, 버전 간 API 변경 사항을 파악합니다DSclub T2Editor 서비스 페이지.
의존 플러그인 점검: 사용 중인 플러그인의 최신 버전 여부를 확인하고, 공식 문서에서 호환성 표를 찾습니다. 필요하다면 플러그인을 재작성합니다.
백업과 롤백 계획: 업데이트 전에 데이터베이스와 파일을 백업하고, 문제가 발생하면 이전 버전으로 롤백할 수 있는 계획을 마련합니다.
협업 디렉터리 권한 및 구성 확인: 버전 업그레이드 후에도 collab 폴더 권한이 유지되는지 확인해야 합니다SIR T2Editor 8.1.2 설치 및 권한 설정 안내.

참고 / 인용 자료

DSclub에서 제공하는 버전 히스토리와 기능 변경 사항DSclub T2Editor 서비스 페이지
버전별 라이선스 정책 변경 설명DSclub T2Editor 서비스 페이지 - 라이선스 변경 관련 안내
SIR 커뮤니티의 플러그인 로딩 지연 기능 및 설치 안내SIR T2Editor 8.1.2 기능 설명 SIR T2Editor 8.1.2 설치 및 권한 설정 안내
AI 플러그인 오류와 대체 API 제안SIR T2Editor 8.1.2 후속 공지 및 서비스 주의사항

이 문서는 T2Editor 9.0.0 버전을 기준으로 작성되었으며, 앞으로 출시되는 버전에서는 새로운 이슈가 발생할 수 있습니다. 업데이트 전에 항상 공식 문서와 커뮤니티 공지를 확인하십시오.