[WordPress] WordPress Plugin 등록 방법

워드프레스 관리자 페이지의 '새 플러그인 추가' 화면에서 검색하여 바로 설치할 수 있게 하려면 WordPress.org 공식 플러그인 디렉토리에 플러그인을 등록해야 합니다.

이 과정을 단계별로 자세히 설명해 드릴게요.

WordPress.org 플러그인 디렉토리에 플러그인 등록하는 방법

1. 사전 준비:

   • 플러그인 가이드라인 준수: WordPress.org는 플러그인 등록을 위한 가이드라인을 제시합니다. 보안, 코딩 표준, 사용자 경험, 문서화 등에 대한 요구사항을 충족해야 합니다. 특히 라이선스 (보통 GPLv2 이상)를 명확히 해야 합니다.
   • readme.txt 파일 작성: 플러그인 디렉토리에 표시될 정보 (플러그인 설명, 설치 방법, FAQ, 변경 로그, 기여자, 요구되는 워드프레스/PHP 버전 등)는 표준 형식의 readme.txt 파일에 작성해야 합니다. 이 파일은 매우 중요하며, 정해진 양식에 맞춰야 정보가 제대로 표시됩니다.
   • 메인 PHP 파일 헤더: 플러그인의 메인 PHP 파일 상단에 워드프레스가 인식할 수 있는 표준 주석 헤더 (Plugin Name:, Version:, Author: 등)가 정확히 포함되어 있어야 합니다.
   • React 빌드 파일 포함: 플러그인 패키지에는 React 소스 코드가 아닌, 빌드(컴파일)된 JavaScript 및 CSS 파일이 포함되어야 합니다. PHP 코드에서는 wp_enqueue_script 와 wp_enqueue_style 함수를 사용하여 이 빌드된 파일들을 워드프레스 환경에 맞게 로드해야 합니다.

2. 플러그인 제출:

   • WordPress.org 계정: WordPress.org 계정이 필요합니다.
   • 플러그인 제출 페이지 접속: Add Your Plugin 페이지에 접속합니다.
   • 플러그인 업로드 및 정보 입력: 준비된 플러그인 zip 파일을 업로드하고 필요한 정보를 입력합니다. 이때 readme.txt 파일이 중요한 역할을 합니다.
   • 검토 대기: 제출된 플러그인은 WordPress.org의 자원봉사자 리뷰팀에 의해 검토됩니다. 가이드라인 준수 여부, 보안 문제 등을 확인하며, 이 과정은 며칠에서 몇 주까지 소요될 수 있습니다. 피드백이 오면 요구사항에 맞게 수정해야 할 수도 있습니다.

3. 승인 및 SVN 저장소 사용:

   • 승인: 플러그인이 승인되면, WordPress.org에서 해당 플러그인 전용 Subversion (SVN) 저장소를 제공해 줍니다.
   • SVN 클라이언트 설치: SVN 저장소에 파일을 올리고 관리하려면 SVN 클라이언트 프로그램이 필요합니다. (예: TortoiseSVN (Windows), 또는 커맨드라인 SVN)
   • 코드 업로드: 제공받은 SVN 저장소 주소와 계정 정보를 사용하여 플러그인 파일들을 업로드합니다. WordPress.org SVN 저장소는 다음과 같은 특정 디렉토리 구조를 사용합니다:
     • trunk: 현재 개발 중인 최신 버전의 코드를 여기에 둡니다. 플러그인의 안정적인 최신 버전 코드가 위치해야 합니다.
     • tags: 플러그인의 각 배포 버전(릴리스)을 위한 디렉토리입니다. 예를 들어, 버전 1.0을 출시할 때는 tags/1.0 디렉토리를 만들고 해당 버전의 코드를 복사해 넣습니다. 사용자는 이 tags 디렉토리에 있는 버전을 설치하게 됩니다.
     • assets: 플러그인 디렉토리 페이지에 표시될 아이콘, 배너 이미지, 스크린샷 등을 여기에 넣습니다. (예: assets/icon-128x128.png, assets/banner-772x250.jpg, assets/screenshot-1.png)
   • readme.txt 업데이트: SVN에 코드를 올릴 때 readme.txt 파일도 함께 올리고, 특히 Stable tag 헤더에 현재 안정적인 버전 번호 (보통 tags 디렉토리의 최신 버전 번호)를 정확히 명시해야 합니다.

4. 플러그인 디렉토리에 반영:

   • SVN 저장소의 trunk 와 tags 디렉토리에 코드가 올바르게 업로드되고 readme.txt 파일이 잘 작성되어 있으면, 잠시 후 WordPress.org 플러그인 디렉토리에 플러그인이 나타나고 '새 플러그인 추가' 페이지에서 검색 및 설치가 가능해집니다.

핵심 요약:

• 워드프레스 가이드라인을 준수하고 readme.txt 파일을 표준 형식에 맞게 작성해야 합니다.
• 플러그인을 WordPress.org에 제출하고 검토를 통과해야 합니다.
• 승인 후 제공되는 SVN 저장소에 정해진 구조(trunk, tags, assets)에 맞게 빌드된 플러그인 파일들을 업로드해야 합니다.
• 새 버전을 릴리스할 때는 tags 디렉토리에 해당 버전의 코드를 추가하고 readme.txt의 Stable tag를 업데이트해야 합니다.

참고 자료:

• 플러그인 개발 핸드북 (영문): https://developer.wordpress.org/plugins/
• 플러그인 가이드라인 (영문): https://developer.wordpress.org/plugins/wordpress-org/detailed-plugin-guidelines/
• readme.txt 파일 표준 (영문): https://developer.wordpress.org/plugins/wordpress-org/how-your-readme-txt-works/
• SVN 사용법 (영문): https://developer.wordpress.org/plugins/wordpress-org/how-to-use-subversion/

이 과정을 통해 직접 만드신 리액트 기반 플러그인을 전 세계 워드프레스 사용자들이 쉽게 검색하고 설치할 수 있게 될 것입니다. 궁금한 점이 있다면 언제든지 다시 질문해 주세요!