WordPress 플러그인 – 커스텀 시작

2025년 05월 31일 by CRYUN in Workflow & Publishing, WordPress Pipeline
옵시디언

WordPress 플러그인을 사용해서 옵시디언 노트를 워드프레스로 포스팅할 때 몇가지( 아니 좀 많이… ) 이슈들이 있다.

그럭저럭 참고 적응해서 사용하자니, 포스팅을 쉽게 하고자 했던게 오히려 너무 힘들어져서 이슈들을 수정해서 사용하기로 했다.

원작자가 수정을 해주면 참 좋을텐데 보시다시피…

Wordpress 플러그인 스크린샷 1

1년째 멈춰버린 업데이트

사용자가 그렇게 많을 플러그인은 아니라서 그런지 업데이트가 멈춘지 한참이다.

앞으로 언제 수정될지 기약할 수 없기도 하고, 오픈소스의 장점이 뭐야, 내가 필요한 건 수정해서 사용하면 되는거잖아?

그래서 직접 수정하기로 했다.

Repository Fork


가장 먼저 한 것은 https://github.com/devbean/obsidian-wordpress 에서 일단 저장소를 내 저장소로 포크를 떴다.

내 수정 사항들은 내 입맛에 맞춰진 수정사항들이기 때문에 원작자 저장소에 영향을 끼치면 안되니까 포크를 통해 복사를 해왔다.

프로젝트 내려받기


포크된 저장소 기준으로 프로젝트를 내려받았다.

이건 그냥 라이더에서 깃 주소를 통해 프로젝트를 열면 되는 것이라서…

코드 스타일 수정 및 적용


일단 원본 코드의 분석이 필요했다.

하지만 원본 코드 스타일이 나와 달라 읽기가 무척 불편했다.

어차피 포크로 복사한 프로젝트이므로 내가 코드 분석을 편하게 할 수 있도록 코드 스타일을 수정 및 적용했다.

처음에는 커서에서 AI를 이용해서 전반적으로 스타일을 적용하려고 했으나 생각처럼 잘 되진 않았다.

그래서 그냥 라이더의 코드 포맷팅 옵션을 사용해서 코드 스타일을 수정하고 적용하였다.

그럭저럭 만족스럽게 수정된듯 하다.

Wordpress 플러그인 스크린샷 2

라이더는 그저 갓

플러그인 빌드 및 테스트 환경 구축하기


옵시디언에서 제공하는 공식 가이드를 따라 환경설정을 한다.

일단 빌드할 플러그인은 따로 있으므로 가이드에서 제공하는 튜토리얼용 플러그인은 따로 받지 않았다.

의존 패키지 설치

npm install
Bash

npm을 이용한다.

위 명령어를 통해 의존 패키지들을 설치한다.

물론 이전에 node.js가 설치되어 있어야 한다.

다음은 위 명령어의 결과이다.

added 207 packages, and audited 208 packages in 37s

65 packages are looking for funding
  run `npm fund` for details

2 vulnerabilities (1 low, 1 moderate)

To address all issues, run:
  npm audit fix

Run `npm audit` for details.
Bash

생각보다 설치된 패키지가 많다. 208개라니… 조금 당황스럽다.

설치 안내에서 이슈가 있는듯 하다. 안내대로 npm audit fix를 추가로 실행해준다.

removed 1 package, changed 2 packages, and audited 207 packages in 4s  
  
65 packages are looking for funding  
run `npm fund` for details
Bash

결과 안내 메시지로 봐선 잘 정리된것으로 보인다.

일단 빌드해보기

npm run dev
Bash

공식 가이드에 따라 위 명령어를 통해 빌드를 해보았다.

별 이슈 없이 컴파일이 완료되었으며 main.js파일이 갱신되었음을 알 수 있었다.

물론 내용은 고친게 없어서 정말 반영이 되었는지는 모르겠지만.

새로 빌드한 플러그인으로 교체하기

기존 플러그인 폴더에 main.js를 교체해주면 된다고 한다.

Wordpress 플러그인 스크린샷 3

커뮤니티 플러그인 폴더에 있는 내용이다.

저기에 있는 main.js를 교체하면 된다.

물론 옵시디언이 이미 실행되고 있다면 재실행을 해줘야 플러그인을 다시 로드한다.

AD