T2Editor는 그누보드5와 연동할 뿐만 아니라, 단독으로도 사용할 수 있는 구조로 설계되어 있습니다. 독립형으로 사용할 때에는 다음 사항을 고려해야 합니다:
t2editor 폴더를 업로드하고 적절한 URL로 접근합니다.editor.lib.php를 포함한 PHP 파일에서 에디터를 불러오고 초기 설정을 수행합니다.editor.lib.php의 설정을 따릅니다./data와 /collab 디렉터리를 서버에 생성하여 권한을 707로 설정해야 합니다.독립형으로 사용할 경우 그누보드5의 게시판이나 폼과 연결되지 않으므로, 데이터 저장 및 표시를 위한 별도의 구현이 필요할 수 있습니다.
독립형 운영의 가장 큰 장점은 그누보드5의 게시판 구조에 묶이지 않고 원하는 프로젝트에 바로 붙일 수 있다는 점입니다. 자체 CMS, 사내 문서 시스템, 고객 전용 입력 폼, 간단한 관리 콘솔 등에 쉽게 이식할 수 있습니다. 반면 게시물 저장, 권한 제어, 첨부파일 정리, 스팸 차단, 관리자 UI 같은 것은 직접 설계해야 하므로 “설치가 더 자유롭다”는 것이 곧 “운영도 더 쉽다”는 뜻은 아닙니다.
독립형에서는 먼저 config/t2_config.php의 경로 상수와 URL 상수가 현재 배포 위치와 일치하는지 확인해야 합니다. 그 다음 editor.lib.php를 포함하는 테스트 페이지를 하나 만들어 최소한의 글쓰기 화면이 정상적으로 뜨는지 확인하고, 이미지 업로드·파일 업로드·자동 저장·내보내기·다크 모드 전환을 차례로 검수하는 것이 좋습니다. 기능이 하나라도 실패하면 서버 권한과 업로드 경로부터 먼저 점검해야 합니다.
그누보드5 환경에서는 어느 정도 검증과 권한 처리가 이미 존재하지만, 독립형에서는 업로드 검증과 입력 검증을 직접 준비해야 합니다. 허용 확장자, MIME 검사, 업로드 파일명 정규화, 저장 디렉터리 접근 제한, XSS 필터링 여부를 반드시 운영 전에 검토하십시오. 특히 코드 블록과 HTML 내보내기 기능을 함께 사용할 때는 뷰어 쪽 필터 정책을 명확히 해두는 것이 좋습니다.
T2Editor는 그누보드5와 연동할 뿐만 아니라, 단독으로도 사용할 수 있는 구조로 설계되어 있습니다. 독립형으로 사용할 때에는 다음 사항을 고려해야 합니다:
t2editor 폴더를 업로드하고 적절한 URL로 접근합니다.editor.lib.php를 포함한 PHP 파일에서 에디터를 불러오고 초기 설정을 수행합니다.editor.lib.php의 설정을 따릅니다./data와 /collab 디렉터리를 서버에 생성하여 권한을 707로 설정해야 합니다.독립형으로 사용할 경우 그누보드5의 게시판이나 폼과 연결되지 않으므로, 데이터 저장 및 표시를 위한 별도의 구현이 필요할 수 있습니다.
독립형 운영의 가장 큰 장점은 그누보드5의 게시판 구조에 묶이지 않고 원하는 프로젝트에 바로 붙일 수 있다는 점입니다. 자체 CMS, 사내 문서 시스템, 고객 전용 입력 폼, 간단한 관리 콘솔 등에 쉽게 이식할 수 있습니다. 반면 게시물 저장, 권한 제어, 첨부파일 정리, 스팸 차단, 관리자 UI 같은 것은 직접 설계해야 하므로 “설치가 더 자유롭다”는 것이 곧 “운영도 더 쉽다”는 뜻은 아닙니다.
독립형에서는 먼저 config/t2_config.php의 경로 상수와 URL 상수가 현재 배포 위치와 일치하는지 확인해야 합니다. 그 다음 editor.lib.php를 포함하는 테스트 페이지를 하나 만들어 최소한의 글쓰기 화면이 정상적으로 뜨는지 확인하고, 이미지 업로드·파일 업로드·자동 저장·내보내기·다크 모드 전환을 차례로 검수하는 것이 좋습니다. 기능이 하나라도 실패하면 서버 권한과 업로드 경로부터 먼저 점검해야 합니다.
그누보드5 환경에서는 어느 정도 검증과 권한 처리가 이미 존재하지만, 독립형에서는 업로드 검증과 입력 검증을 직접 준비해야 합니다. 허용 확장자, MIME 검사, 업로드 파일명 정규화, 저장 디렉터리 접근 제한, XSS 필터링 여부를 반드시 운영 전에 검토하십시오. 특히 코드 블록과 HTML 내보내기 기능을 함께 사용할 때는 뷰어 쪽 필터 정책을 명확히 해두는 것이 좋습니다.
| 이전 | 새 버전 | ||
|---|---|---|---|
| 1 | --- | 1 | --- |
| 2 | title: Standalone 사용 가이드 | 2 | title: Standalone 사용 가이드 |
| 3 | document_id: 04-standalone-guide | 3 | document_id: 04-standalone-guide |
| 4 | slug: 04-standalone-guide | 4 | slug: 04-standalone-guide |
| 5 | target_editor_version: 9.0.0 | 5 | target_editor_version: 9.0.0 |
| 6 | document_type: integration | 6 | document_type: integration |
| 7 | doc_type: integration | 7 | doc_type: integration |
| 8 | target_readers: [초보자, 웹마스터, 개발자, AI agent] | 8 | target_readers: [초보자, 웹마스터, 개발자, AI agent] |
| 9 | importance: High | 9 | importance: High |
| 10 | dependency: Medium | 10 | dependency: Medium |
| 11 | core_type: Integration | 11 | core_type: Integration |
| 12 | stability: [Version-Bound] | 12 | stability: [Version-Bound] |
| 13 | stable_anchor: [] | 13 | stable_anchor: [] |
| 14 | version_bound: [] | 14 | version_bound: [] |
| 15 | related_docs: [] | 15 | related_docs: [] |
| 16 | related_files: [] | 16 | related_files: [] |
| 17 | related_functions: [] | 17 | related_functions: [] |
| 18 | related_classes_modules: [] | 18 | related_classes_modules: [] |
| 19 | related_features: [] | 19 | related_features: [] |
| 20 | related_ui: [] | 20 | related_ui: [] |
| 21 | change_risk: 수정 범위를 넓게 잡으면 관련 기능과 문서 흐름에 영향이 생길 수 있습니다. | 21 | change_risk: 수정 범위를 넓게 잡으면 관련 기능과 문서 흐름에 영향이 생길 수 있습니다. |
| 22 | reading_order: 05 | 22 | reading_order: 05 |
| 23 | summary: T2Editor를 독립형으로 사용하는 방법과 주의사항 문서 | 23 | summary: T2Editor를 독립형으로 사용하는 방법과 주의사항 문서 |
| 24 | description: T2Editor를 독립형으로 사용하는 방법과 주의사항 | 24 | description: T2Editor를 독립형으로 사용하는 방법과 주의사항 |
| 25 | tags: [standalone, T2Editor, integration] | 25 | tags: [standalone, T2Editor, integration] |
| 26 | version_tag: 9.0.0 | 26 | version_tag: 9.0.0 |
| 27 | maintenance_difficulty: Medium | 27 | maintenance_difficulty: Medium |
| 28 | test_requirement: Medium | 28 | test_requirement: Medium |
| 29 | ai_agent_risk: Medium | 29 | ai_agent_risk: Medium |
| 30 | source_basis: [현재 코드 분석 기반, 웹 참고 자료 기반] | 30 | source_basis: [현재 코드 분석 기반, 웹 참고 자료 기반] |
| 31 | beginner_section_included: true | 31 | beginner_section_included: true |
| 32 | webmaster_section_included: true | 32 | webmaster_section_included: true |
| 33 | developer_section_included: true | 33 | developer_section_included: true |
| 34 | --- | 34 | --- |
| 35 | ## 독립형 사용 가이드 | 35 | ## 독립형 사용 가이드 |
| 36 | 36 | ||
| 37 | T2Editor는 그누보드5와 연동할 뿐만 아니라, 단독으로도 사용할 수 있는 구조로 설계되어 있습니다. 독립형으로 사용할 때에는 다음 사항을 고려해야 합니다: | 37 | T2Editor는 그누보드5와 연동할 뿐만 아니라, 단독으로도 사용할 수 있는 구조로 설계되어 있습니다. 독립형으로 사용할 때에는 다음 사항을 고려해야 합니다: |
| 38 | - **환경 요구 사항**: PHP 7.4 이상, GD 라이브러리 및 cURL 확장 모듈이 설치된 Apache 또는 Nginx 서버가 필요합니다. | 38 | - **환경 요구 사항**: PHP 7.4 이상, GD 라이브러리 및 cURL 확장 모듈이 설치된 Apache 또는 Nginx 서버가 필요합니다. |
| 39 | - **설치 위치**: 웹 루트 또는 원하는 경로에 `t2editor` 폴더를 업로드하고 적절한 URL로 접근합니다. | 39 | - **설치 위치**: 웹 루트 또는 원하는 경로에 `t2editor` 폴더를 업로드하고 적절한 URL로 접근합니다. |
| 40 | - **초기화**: `editor.lib.php`를 포함한 PHP 파일에서 에디터를 불러오고 초기 설정을 수행합니다. | 40 | - **초기화**: `editor.lib.php`를 포함한 PHP 파일에서 에디터를 불러오고 초기 설정을 수행합니다. |
| 41 | - **플러그인 관리**: 플러그인 로딩 및 우선순위 설정은 `editor.lib.php`의 설정을 따릅니다. | 41 | - **플러그인 관리**: 플러그인 로딩 및 우선순위 설정은 `editor.lib.php`의 설정을 따릅니다. |
| 42 | - **데이터 저장**: 독립형 사용 시에는 `/data`와 `/collab` 디렉터리를 서버에 생성하여 권한을 707로 설정해야 합니다. | 42 | - **데이터 저장**: 독립형 사용 시에는 `/data`와 `/collab` 디렉터리를 서버에 생성하여 권한을 707로 설정해야 합니다. |
| 43 | 43 | ||
| 44 | 독립형으로 사용할 경우 그누보드5의 게시판이나 폼과 연결되지 않으므로, 데이터 저장 및 표시를 위한 별도의 구현이 필요할 수 있습니다. | 44 | 독립형으로 사용할 경우 그누보드5의 게시판이나 폼과 연결되지 않으므로, 데이터 저장 및 표시를 위한 별도의 구현이 필요할 수 있습니다. |
| 45 | 45 | ||
| 46 | ## 참고 자료 | 46 | ## 참고 자료 |
| 47 | 47 | ||
| 48 | - 기능 설명: [DSclub T2Editor 서비스 페이지](https://dsclub.kr/service/editor) | 48 | - 기능 설명: [DSclub T2Editor 서비스 페이지](https://dsclub.kr/service/editor) |
| 49 | - 설치 안내: [DSclub T2Editor 서비스 페이지 - 설치·오류 안내](https://dsclub.kr/service/editor) | 49 | - 설치 안내: [DSclub T2Editor 서비스 페이지 - 설치·오류 안내](https://dsclub.kr/service/editor) |
| 50 | 50 | ||
| 51 | ## 독립형 운영 시 장점과 한계 | 51 | ## 독립형 운영 시 장점과 한계 |
| 52 | 52 | ||
| 53 | 독립형 운영의 가장 큰 장점은 그누보드5의 게시판 구조에 묶이지 않고 원하는 프로젝트에 바로 붙일 수 있다는 점입니다. 자체 CMS, 사내 문서 시스템, 고객 전용 입력 폼, 간단한 관리 콘솔 등에 쉽게 이식할 수 있습니다. 반면 게시물 저장, 권한 제어, 첨부파일 정리, 스팸 차단, 관리자 UI 같은 것은 직접 설계해야 하므로 “설치가 더 자유롭다”는 것이 곧 “운영도 더 쉽다”는 뜻은 아닙니다. | 53 | 독립형 운영의 가장 큰 장점은 그누보드5의 게시판 구조에 묶이지 않고 원하는 프로젝트에 바로 붙일 수 있다는 점입니다. 자체 CMS, 사내 문서 시스템, 고객 전용 입력 폼, 간단한 관리 콘솔 등에 쉽게 이식할 수 있습니다. 반면 게시물 저장, 권한 제어, 첨부파일 정리, 스팸 차단, 관리자 UI 같은 것은 직접 설계해야 하므로 “설치가 더 자유롭다”는 것이 곧 “운영도 더 쉽다”는 뜻은 아닙니다. |
| 54 | 54 | ||
| 55 | ## 권장 독립형 초기화 절차 | 55 | ## 권장 독립형 초기화 절차 |
| 56 | 56 | ||
| 57 | 독립형에서는 먼저 `config/t2_config.php`의 경로 상수와 URL 상수가 현재 배포 위치와 일치하는지 확인해야 합니다. 그 다음 `editor.lib.php`를 포함하는 테스트 페이지를 하나 만들어 최소한의 글쓰기 화면이 정상적으로 뜨는지 확인하고, 이미지 업로드·파일 업로드·자동 저장·내보내기·다크 모드 전환을 차례로 검수하는 것이 좋습니다. 기능이 하나라도 실패하면 서버 권한과 업로드 경로부터 먼저 점검해야 합니다. | 57 | 독립형에서는 먼저 `config/t2_config.php`의 경로 상수와 URL 상수가 현재 배포 위치와 일치하는지 확인해야 합니다. 그 다음 `editor.lib.php`를 포함하는 테스트 페이지를 하나 만들어 최소한의 글쓰기 화면이 정상적으로 뜨는지 확인하고, 이미지 업로드·파일 업로드·자동 저장·내보내기·다크 모드 전환을 차례로 검수하는 것이 좋습니다. 기능이 하나라도 실패하면 서버 권한과 업로드 경로부터 먼저 점검해야 합니다. |
| 58 | 58 | ||
| 59 | ## 독립형에 특히 필요한 보안 점검 | 59 | ## 독립형에 특히 필요한 보안 점검 |
| 60 | 60 | ||
| 61 | 그누보드5 환경에서는 어느 정도 검증과 권한 처리가 이미 존재하지만, 독립형에서는 업로드 검증과 입력 검증을 직접 준비해야 합니다. 허용 확장자, MIME 검사, 업로드 파일명 정규화, 저장 디렉터리 접근 제한, XSS 필터링 여부를 반드시 운영 전에 검토하십시오. 특히 코드 블록과 HTML 내보내기 기능을 함께 사용할 때는 뷰어 쪽 필터 정책을 명확히 해두는 것이 좋습니다. | 61 | 그누보드5 환경에서는 어느 정도 검증과 권한 처리가 이미 존재하지만, 독립형에서는 업로드 검증과 입력 검증을 직접 준비해야 합니다. 허용 확장자, MIME 검사, 업로드 파일명 정규화, 저장 디렉터리 접근 제한, XSS 필터링 여부를 반드시 운영 전에 검토하십시오. 특히 코드 블록과 HTML 내보내기 기능을 함께 사용할 때는 뷰어 쪽 필터 정책을 명확히 해두는 것이 좋습니다. |
| 62 | 62 | ||
| 63 | ## 참고 자료 | 63 | ## 참고 자료 |
| 64 | 64 | ||
| 65 | - DSclub T2Editor 서비스 페이지: https://dsclub.kr/service/editor | 65 | - DSclub T2Editor 서비스 페이지: https://dsclub.kr/service/editor |
| 66 | - DSclub 개발 및 관리 가이드: https://dsclub.kr/code/1403 | 66 | - DSclub 개발 및 관리 가이드: https://dsclub.kr/code/1403 |
| 67 | - SIR T2Editor 8.1.2 소개 글: https://sir.kr/boards/g5_plugin/15016 | 67 | - SIR T2Editor 8.1.2 소개 글: https://sir.kr/boards/g5_plugin/15016 |
| 68 | 68 | ||