사용법

플러그인

편집기에 기능을 더하는 플러그인을 설치하고 관리하는 방법, 그리고 플러그인을 만들어 올리는 개발자 페이지입니다. 편집기 안에서 플러그인을 쓰는 방법은 「에디터 플러그인」 문서를 보세요.

플러그인 탭

대시보드의 플러그인 탭에서 설치한 플러그인을 관리하고, 새 플러그인은 갤러리에서 찾습니다.

내 플러그인 — 내가 설치한 플러그인. 이름·판·개발자와 그 플러그인이 쓰는 권한이 보이고, 오른쪽에 켜기/끄기 스위치와 삭제 단추(휴지통)가 있습니다.
갤러리 › 플러그인 — 검수를 거쳐 공개된 플러그인 카드. 탭 오른쪽 위의 플러그인 둘러보기 링크나 머리글의 갤러리로 갑니다(로그인 없이도 볼 수 있습니다). 플러그인 자체는 지금 모두 무료이지만, 설치는 유료 요금제(Starter·Pro)에서 됩니다. 무료 요금제에서는 상세 창의 설치 단추가 흐리게 보이고 요금제 안내가 함께 나옵니다. 요금제가 끝나면 설치해 둔 플러그인도 편집기에서 불러오지 않습니다. 설치 목록은 그대로 남아 유료 요금제로 올리면 바로 다시 쓸 수 있습니다. 이미 설치한 카드에는 설치됨가 붙습니다.

설치는 파일을 내려받는 것이 아니라 계정에 묶는 것입니다. 설치하고 켜 둔 플러그인은 편집기를 열 때마다 불러오므로, 어느 컴퓨터에서 로그인해도 같은 플러그인이 있습니다. 이미 열려 있는 편집기에는 바로 나타나지 않으니 탭을 새로고침하거나 레이아웃을 다시 여세요.

관련 질문

플러그인은 어디서 설치해요?
확장 기능을 추가할 수 있나요?
플러그인은 유료인가요?

플러그인 설치

갤러리 › 플러그인에서 카드를 누릅니다. 상세 창이 열립니다.
개발자·판·필요한 편집기·가격와 이 플러그인이 할 수 있는 일 목록을 확인합니다.
설치을 누릅니다. 외부 서버에 연결하는 플러그인이면 단추가 동의하고 설치입니다(아래 「외부 서버에 연결하는 플러그인」).
내 플러그인에 나타나면 끝입니다. 편집기를 새로 열면 플러그인이 들어 있습니다.

필요한 편집기가 적힌 플러그인은 그 판 이상의 편집기에서만 불러옵니다. 계정이 고른 편집기 버전이 그보다 낮으면 레이아웃 작업 설정에서 버전을 올립니다(「대시보드」 문서의 「에디터 버전」).

관련 질문

플러그인을 설치했는데 편집기에 없어요
플러그인 설치 방법
필요한 편집기 판이 뭐예요?

권한

플러그인은 상세 창에 적힌 권한 안의 일만 할 수 있습니다. 권한은 다음과 같습니다.

레이아웃 읽기 — 열린 레이아웃의 쪽·개체·글 내용을 읽습니다.
레이아웃 고치기 — 개체·글·그림·쪽을 만들거나 고치거나 지웁니다. 모든 변경은 실행 취소할 수 있고 평소처럼 저장됩니다.
선택 — 지금 고른 개체를 알고 선택을 바꿉니다.
화면 — 도구 단추·메뉴·패널·대화상자를 편집기에 더합니다.
설정 저장 — 그 플러그인의 설정을 내 계정에 저장합니다(64KB까지).
외부 서버 연결 — 권한 이름 뒤에 서버 주소가 붙습니다. 그 서버와 데이터를 주고받을 수 있습니다.

플러그인은 편집기와 떨어진 격리된 곳(샌드박스)에서 돌아갑니다. 내 로그인 정보·다른 레이아웃·편집기 화면에는 닿지 못하고, 외부 서버 연결 권한이 없는 플러그인은 인터넷에 전혀 연결할 수 없습니다. 플러그인이 띄우는 패널과 창도 따로 격리된 창 안에서만 그립니다.

관련 질문

플러그인이 내 레이아웃을 마음대로 볼 수 있나요?
플러그인 권한은 무슨 뜻이에요?
플러그인이 내 계정 정보를 가져갈 수 있나요?

외부 서버에 연결하는 플러그인

외부 서버 연결 권한이 있는 플러그인(예: 상품 정보 서비스에서 데이터를 받아 레이아웃을 채우는 플러그인)은 상세 창에 경고가 함께 보입니다. "이 플러그인은 레이아웃 내용을 다음 서버로 보낼 수 있습니다:" 아래에 서버 주소와 개발자의 개인정보 처리방침 링크가 있습니다.

적힌 서버에만 연결할 수 있고, 다른 주소로는 아무것도 보내지 못합니다.
연결하면 레이아웃 내용이 그 서버로 갈 수 있으므로, 서버 주소와 처리방침을 읽고 믿을 수 있을 때만 동의하고 설치을 누릅니다.

관련 질문

외부 서버 연결 권한은 위험한가요?
플러그인이 인터넷을 쓰나요?
동의하고 설치가 뭐예요?

켜기·끄기와 삭제

스위치를 끄면 다음에 편집기를 열 때부터 그 플러그인을 불러오지 않습니다. 다시 켜면 다시 불러옵니다.
삭제를 누르고 확인하면 내 플러그인에서 빠집니다. 그 플러그인으로 만든 개체는 레이아웃에 그대로 남고, 저장된 모습 그대로 보이고 인쇄됩니다(「에디터 플러그인」 문서의 「플러그인 개체」).
관리자가 막음 표시가 붙은 플러그인은 관리자가 막은 것이라 켤 수 없고 편집기에 불러오지 않습니다. 쓸 수 있는 판 없음은 지금 공개된 판이 없다는 뜻입니다.

관련 질문

플러그인을 잠깐 끄고 싶어요
플러그인을 지우면 만든 개체는 어떻게 돼요?
관리자가 막음이 떠요

플러그인 업그레이드

설치한 플러그인은 설치한 판을 계속 씁니다. 개발자가 새 판을 올려 검수를 통과해도 저절로 바뀌지 않고, 내가 업그레이드해야 새 판을 씁니다.

새 판이 나오면 내 플러그인의 그 플러그인 아래에 새 판 안내(새 판 번호)가 뜹니다. 새 판이 지금보다 많은 권한을 쓰면 새 권한이 필요하다고 함께 알립니다. 편집기의 플러그인 메뉴에도 업그레이드할 수 있다는 항목이 생깁니다.
업그레이드를 누르면 플러그인 업그레이드 창에 지금 판과 새 판 번호, 새로 쓰는 권한이 보입니다.
업그레이드를 누르면 다음에 편집기를 열 때부터 새 판을 불러옵니다.

업그레이드하지 않으면 편집기는 지금 쓰는 판을 계속 불러옵니다. 지금 쓰는 판이 회수되면 그보다 낮은 판 가운데 가장 높은 판을 쓰고, 낮은 판이 없을 때만 가장 가까운 새 판을 씁니다.

관련 질문

플러그인이 저절로 업데이트되나요?
플러그인 새 판은 어떻게 받아요?
업그레이드하지 않으면 플러그인이 안 되나요?

플러그인 개발자 페이지

플러그인을 직접 만들어 올리려면 내 정보 왼쪽 메뉴 아래의 개발자로 갑니다.

처음에는 개발자 신청 양식이 보입니다. 표시 이름(스토어에 개발자로 보이는 이름)과 연락처(이메일이나 웹 주소)를 적고, 개발자 약관에 동의한 뒤 신청하기를 누릅니다.
관리자가 확인하면 결과가 알림으로 옵니다. 반려되면 내용을 고쳐 다시 신청할 수 있습니다.
승인되면 이 페이지에 시작하기이 보입니다. SDK 내려받기으로 SDK(zip)를 받습니다. 도구·타입 정의·예제와 개발자 안내서(README.md)가 들어 있고, Node 18 이상이 필요합니다.
내 컴퓨터에서 플러그인을 만들고 SDK의 개발 서버를 띄운 뒤, 편집기 주소 끝에 pluginDev를 붙여 열면 그 플러그인을 바로 시험할 수 있습니다(승인된 개발자 계정과 이 컴퓨터(localhost)에서만). 개발 서버를 --open으로 띄우면 로그인 없이, 서버에 아무것도 저장하지 않는 시험용 새 레이아웃(샌드박스 편집기)으로 편집기가 열립니다. AI 에이전트는 터미널 명령으로 그 편집기에서 명령을 실행하고 쪽 그림을 받아 확인할 수 있습니다. 자세한 명령은 시작하기의 단계와 SDK 안의 README.md에 있습니다.
다 되면 SDK로 zip을 만들어 판 올리기의 zip 올리기로 올립니다(5MB·파일 200개 이하). 올린 판은 초안으로 남습니다.
판 목록에서 검수 요청을 누르면 관리자가 검수합니다. 검수 중에는 그 판을 고치거나 지울 수 없습니다. 승인·반려 결과와 검수 메모는 알림으로 오고, 판 목록에도 보입니다.
승인되면 갤러리 › 플러그인에 공개됩니다. 스토어에 보이기 스위치로 스토어에 보일지 정합니다.

고칠 때는 판 번호를 올려 새 판으로 올리고 다시 검수를 받습니다. 플러그인 API·외부 서버 연결 권한·검수 기준은 SDK 안의 README.md에 있습니다.

관련 질문

플러그인을 직접 만들 수 있나요?
플러그인 개발자 신청은 어디서 해요?
SDK는 어디서 받아요?
만든 플러그인을 스토어에 올리려면?