업로드·미디어 처리 흐름 가이드

이미지, 파일, 동영상은 T2Editor에서 가장 자주 문제를 일으키는 기능군입니다. 사용자는 단순히 버튼을 눌러 올리는 것처럼 느끼지만, 실제로는 플러그인 UI, 업로드 설정, 서버 저장, 미리보기 렌더링, 보기 페이지 스타일, 경우에 따라 PDF 뷰어까지 여러 축이 연결됩니다.

초보자와 웹마스터를 위한 이해

운영자 관점에서 업로드 기능은 세 가지 질문으로 관리하면 됩니다. 첫째, 어떤 파일을 허용할 것인가. 둘째, 어디에 저장할 것인가. 셋째, 저장 후 어떻게 보여줄 것인가. 이 세 질문이 명확하지 않으면 업로드는 되는데 보기 화면이 깨지거나, 저장은 되는데 서버 공간 관리가 어려워지는 문제가 생깁니다.

처리 흐름 요약

사용자가 플러그인 버튼 또는 드래그앤드롭으로 파일을 선택합니다.
플러그인 JS가 파일 정보를 읽고 필요하면 클라이언트 미리보기를 구성합니다.
업로드 엔드포인트가 설정값을 기준으로 확장자와 용량을 검증합니다.
서버 저장 후 경로와 메타정보를 응답합니다.
에디터는 응답을 받아 미디어 블록을 편집 영역에 삽입합니다.
보기 화면에서는 content.css와 플러그인 CSS가 해당 블록을 렌더링합니다.

전문 개발자를 위한 분석

이미지 플러그인은 업로드 직후 미리보기와 블록 삽입 경험이 중요합니다. 파일 플러그인은 저장 경로와 다운로드, PDF 보기 흐름까지 함께 봐야 하고, 비디오 플러그인은 로컬 파일과 링크 임베드의 정책이 다를 수 있습니다. 따라서 세 플러그인을 같은 업로드 기능으로 묶어 생각하면 안 되고, 공통 설정과 개별 렌더링을 구분해야 합니다.

테스트 포인트

허용 확장자 외 파일 차단
대용량 파일 업로드 실패 시 안내 문구
이미지 미리보기 정상 여부
PDF 뷰어 진입 여부
모바일 환경에서 업로드 버튼 접근성
보기 페이지 스타일 정상 여부

참고 자료

DSclub T2Editor 서비스 페이지: https://dsclub.kr/service/editor
DSclub 개발 및 관리 가이드: https://dsclub.kr/code/1403
SIR T2Editor 8.1.2 소개 글: https://sir.kr/boards/g5_plugin/15016