개요: 이 기사에서는 ONLYOFFICE Docs용 플러그인을 만드는 방법과 버전 7.2부터 사용할 수 있는 공식 플러그인 마켓플레이스에 플러그인을 게시하는 방법을 배웁니다.
ONLYOFFICE 문서 전통적인 의미의 일반 오피스 스위트가 아닙니다. 물론 문서, 스프레드시트, 프리젠테이션 작성 및 편집, 온라인 공유 및 공동 편집, 채울 수 있는 양식 만들기, PDF 파일 탐색 및 변환, 등등.
그러나 만드는 방법이 있습니다. 온리오피스 훨씬 더 강력합니다. 여기서 의미하는 것은 타사 플러그인, 즉 제품군의 표준 기능을 향상시키는 추가 소프트웨어 도구입니다. 예를 들어 플러그인을 사용하면 타사 서비스를 연결하거나 새 사용자 인터페이스 요소를 추가할 수 있습니다.
자신만의 플러그인을 만들기 전에 ONLYOFFICE 문서, 당신은 당신이 가지고 있는지 확인해야합니다 GitHub 계정 이 플랫폼으로 작업하는 방법의 기본 사항을 알고 있습니다. 이건 매우 중요합니다. GitHub를 처음 사용하는 경우 공식을 살펴볼 수 있습니다. GitHub 문서.
플러그인 생성 프로세스는 신중하게 따라야 하는 7단계로 나눌 수 있습니다.
플러그인 개발에 대해 자세히 알아보겠습니다.
먼저 GitHub 계정에 로그인하거나 없는 경우 계정을 생성해야 합니다. 그런 다음 다음 URL 주소에서 사용할 수 있는 ONLYOFFICE 플러그인 마켓플레이스 저장소의 포크를 만들어야 합니다.
https://github.com/ONLYOFFICE/onlyoffice.github.io.
결과적으로 다른 리포지토리가 생기고 해당 URL 주소는 다음과 같습니다.
https://github.com/YOUR-USERNAME/ONLYOFFICE/onlyoffice.github.io.
플러그인 마켓플레이스 저장소를 성공적으로 포크한 후 GitHub 페이지 테스트 목적으로 이 저장소의 사이트. 방법을 모르시면 다음을 참고하세요. 공식 GitHub 가이드.
이제 당신은 자신의 GitHub 페이지 사이트에서 포크를 컴퓨터에 복제할 때입니다.
마지막으로 다음 위치에 향후 플러그인을 위한 폴더를 만들어야 합니다.
onlyoffice.github.io/sdkjs-plugins/content/.
그게 다야. 필요한 예비 활동을 모두 완료했으며 다음 단계를 진행할 수 있습니다.
코딩을 아주 잘할 필요는 없지만 자신만의 플러그인을 만들기 위해서는 기본 코딩 지식이 확실히 필요합니다. ONLYOFFICE 문서.
간단히 말해서, 온리오피스 플러그인은 여러 파일이 있는 폴더입니다. 플러그인이 제대로 작동하려면 세 개의 파일을 만들어야 합니다.
이러한 필수 파일 외에도 플러그인 폴더에는 다른 파일이 포함될 수 있습니다. 예를 들어 아이콘, 플러그인 스타일, readme 파일, 타사 서비스 등이 있습니다. 아래에서 이러한 파일에 대한 자세한 정보를 찾을 수 있습니다.
플러그인에 대해 제대로 작동하는 코드를 작성하려면 필요한 것을 알아야 합니다. 행동 양식 그리고 이벤트.
플러그인용 코드를 작성하는 것만으로는 충분하지 않습니다. 또한 ONLYOFFICE 편집기의 필수적인 부분처럼 보이도록 스타일을 조정해야 합니다. 이렇게 하려면 ONLYOFFICE 스타일 시트를 index.html 위에서 설명한 파일:
버튼, 입력 컨트롤, 레이블 컨트롤, 로더 및 기타 요소를 추가할 수 있습니다.
예를 들어 플러그인에 콤보 상자를 추가하려면 다음을 사용할 수 있습니다. 선택2 기능:
$('#select_example').select2({ 데이터: [{id: 0, 텍스트:'항목 1'}, {id: 1, 텍스트:'항목 2'}, {id: 2, 텍스트:'항목 3 '}], minimumResultsForSearch: 무한대, 너비: '120px' });
삽입된 콤보 상자는 다음과 같습니다.
ONLYOFFICE 스타일 요소에 대한 자세한 내용은 찾을 수 있습니다. 여기.
영어 사용자만을 위한 플러그인을 만들려는 경우 이 단계를 건너뛸 수 있습니다. 그러나 플러그인을 다른 언어로 사용할 수 있게 하려면 플러그인 디렉토리에 translations 폴더를 만들고 해당 플러그인을 넣을 수 있습니다. .json 사용하려는 모든 언어에 대한 파일.
읽기 공식 API 문서 여기에서 플러그인을 올바르게 현지화하는 방법을 알아보세요.
ONLYOFFICE 마켓플레이스에서 사용할 수 있게 되기 전에 플러그인의 모양을 다듬으려면 다음을 추가해야 합니다. 에 대한 플러그인에 대한 간단한 설명, 버전, 개발자 이름 등이 있는 창
예를 들어, 이것은 에 대한 의 창 사진 편집기 플러그인:
플러그인에 대해 이러한 창을 만들 수 있으려면 다음을 따르십시오. 이 지침.
또한 플러그인에 대한 아이콘을 만들고 리소스 폴더에 넣어야 합니다. 일반적으로 플러그인이 ONLYOFFICE 플러그인 마켓플레이스에 올바르게 표시되려면 8개의 아이콘이 필요합니다. Light 및 Dark 인터페이스 테마용 아이콘 4개(125%, 150%, 175% 및 200% 크기 조정).
또한 readme 파일을 만들어 기본 플러그인 폴더에 넣을 수 있습니다. 이 파일에는 플러그인의 주요 기능에 대한 설명, 설치 지침, 알려진 문제 및 버그 등 다른 사용자에게 알리고 싶은 정보가 포함될 수 있습니다.
이제 플러그인이 준비되었으며 마켓플레이스에 게시하기 전에 제대로 테스트할 수 있습니다.
이제 위의 지침에 따라 이미 생성한 모든 파일을 플러그인 폴더에 넣을 차례입니다. 그런 다음 플러그인 폴더를 원격 저장소로 푸시하고 플러그인을 테스트합니다. ONLYOFFICE 데스크톱 편집기. 이를 위해 디버깅 모드에서 데스크톱 앱을 실행할 수 있습니다.
Linux에서는 다음을 사용하여 터미널을 열 수 있습니다. CTRL+ALT+T. 이후 경로를 입력합니다. ONLYOFFICE 데스크톱 편집기, 공백을 추가한 다음 지정 --ascdesktop-support-debug-info
:
"/opt/onlyoffice/desktopeditors/DesktopEditors" --ascdesktop-support-debug-info.
플러그인과 그 기능을 테스트하십시오.
모든 것이 정상이면 ONLYOFFICE 제품군인 ONLYOFFICE Docs의 웹 버전에서 플러그인을 테스트할 수도 있습니다. 즉, 플러그인을 새 확장으로 추가할 수 있습니다.
해당 확장을 생성하려면 다음을 열어야 합니다. onlyoffice.github.io/store/plugin-dev/extension/inject.js 파일을 만들고 GitHub 페이지 사이트의 플러그인 경로를 지정합니다. URL_TO_PLUGIN 변하기 쉬운:
var URL_TO_PLUGIN = " https://YOUR-USERNAME.github.io/onlyoffice.github.io/sdkjs-plugins/content/your-plugin/"
그만큼 onlyoffice.github.io/store/plugin-dev/extension 폴더는 필요한 확장자입니다. 웹 브라우저에 업로드하기만 하면 ONLYOFFICE 문서를 실행 에서 플러그인을 찾으십시오. 플러그인 관리자 에 플러그인 탭 상단 툴바에서 다음은 자세한 안내입니다. 플러그인을 추가하는 방법 웹 브라우저로.
플러그인이 의도한 대로 작동하면 마지막 단계를 진행할 수 있습니다.
축하해요! 플러그인 생성 프로세스를 거쳤으며 이제 다른 사용자가 플러그인을 사용할 수 있도록 할 수 있습니다. 이를 위해 포크에서 ONLYOFFICE 리포지토리로 풀 요청을 생성할 수 있습니다.
https://github.com/ONLYOFFICE/onlyoffice.github.io.
플러그인이 잘 작동하면 온리오피스 개발자가 풀 요청을 승인하고 플러그인이 온리오피스 플러그인 마켓플레이스. 이 경우 다른 사용자가 클릭 몇 번으로 마켓플레이스에서 설치할 수 있습니다.
이 기사가 도움이 되었기를 바랍니다. 아래 댓글에 여러분의 생각을 공유하는 것을 잊지 마세요.