DSc T2Editor Developers
DocumentationPlugins
Plugins

자동 등록 특수 플러그인 구현

Link Card 구현만을 기준으로 manifest 자동 등록과 좁은 이벤트 가로채기 원칙을 설명합니다.

자동 등록 특수 플러그인 구현

자동 등록은 일반 등록을 대체하는 기본 규칙이 아니라 명시적으로 선택하는 보조 기능이다. 이 문서는 /plugin/linkcard만 참고한다.

Manifest

{
  "autoload": true,
  "priority": 6
}

/extend/php/t2z_plugin_autoregister.php는 플러그인 설명자에서 plugin.json을 읽고 autoload: true인 항목만 활성 배열에 추가한다. manifest가 없거나 값이 false면 아무 일도 하지 않는다. 우선순위는 숫자로 정규화되며 이미 등록된 이름은 중복 추가하지 않는다.

현재 Link Card는 번들 기본 목록에도 명시되어 있고 manifest 자동 등록도 사용한다. 이는 다양한 런타임·data 설치 경로에서 누락을 방지하기 위한 중복 안전 구성이지, 모든 일반 플러그인에 권장하는 구조가 아니다.

이벤트를 좁게 가로채기

Link Card는 붙여넣기 내용이 단일 순수 URL이고 다른 붙여넣기 처리기가 소유하지 않은 경우에만 이벤트를 처리한다. 조건을 만족하지 않으면 즉시 false로 돌아가 기본 붙여넣기 흐름을 보존한다.

메타데이터와 서버 경계

  • 제목·설명·이미지·원본 URL을 복원 가능한 data-*와 안전한 출력 구조에 보존한다.
  • 메타데이터 수집 엔드포인트는 DNS·IP·redirect 단계마다 내부망과 위험 스킴을 차단한다.
  • 브라우저가 보내는 미리보기 값을 신뢰하지 않고 서버가 직접 제한 시간과 응답 크기를 적용한다.
  • 실패 시 일반 링크 또는 원문 URL이 남아야 한다.

자동 등록 여부와 저장·복원·보안 품질은 별개의 문제다. manifest 하나로 호스트 통합이나 안전성이 자동 보장되지 않는다.

기술 기준

T2Editor 10.4.0을 기반으로 작성되었으며, 동일한 구조와 계약을 유지하는 이후 버전에도 적용됩니다.

T2Editor 홈으로