Namoman Korean Speller

Wopisanje

Namoman Korean Speller is a helper plugin for the WordPress Gutenberg editor that allows you to efficiently correct your Korean spelling and grammar. By using official WordPress Block APIs, it updates your content without damaging complex formatting like text colors, bold styles, or links.

This plugin uses an „External Integration Workflow“ where the user checks their text on professional external sites (like Naver or Bareun) and applies the results back to the editor. This approach ensures maximum privacy and server stability.

Namoman Korean Speller는 워드프레스 구텐베르크 에디터에서 작성 중인 글의 맞춤법을 효율적으로 교정할 수 있도록 돕는 플러그인입니다. 워드프레스 공식 API를 활용하여 서식 손상 없이 본문 내용을 안전하게 업데이트합니다.

이 플러그인은 사용자가 네이버나 바른 맞춤법 검사기 같은 외부 전문 사이트에서 텍스트를 검사하고 그 결과를 에디터로 다시 적용하는 „외부 연동 워크플로우“를 사용합니다. 이 방식은 완벽한 개인정보 보호와 서버 안정성을 보장합니다.

✨ Key Features

1. Optimized External Checker Integration
* Naver Checker: Best for quick checks of short sentences.
* Bareun Checker: Optimized for long-form posts and bulk checking.

2. Automatic Content Copy
* With a single click, your entire post content is copied to the clipboard, allowing you to paste and check immediately on external sites.

3. Format Preservation (Block API Based)
* Instead of raw text replacement, it uses the official WordPress Block API to preserve inline styles like colors, bold text, and links.

4. Recursive Block Support
* It correctly handles nested lists, headings, and paragraphs, ensuring that your block structure remains intact after correction.

✨ 주요 기능 (Korean)

1. 최적화된 외부 맞춤법 검사기 연동
* 네이버 검사기: 짧은 문장의 빠른 체크에 적합합니다.
* 바른 검사기: 긴 글 및 대량 교정에 최적화되어 있습니다.

2. 자동 본문 복사 기능
* 클릭 한 번으로 포스트 본문 전체가 클립보드에 복사되어 외부 검사기 사이트에 바로 붙여넣어 검사할 수 있습니다.

3. 서식 보존 (블록 API 기반)
* 단순 텍스트 치환 대신 워드프레스 공식 블록 API를 활용하여 글자 색상, 굵게, 링크 등 본문 내 서식을 손상 없이 안전하게 유지합니다.

4. 중첩 블록 지원
* 네스팅된 리스트, 제목, 문단 블록 등을 정확하게 파싱하고 처리하여 본문 구조를 원형 그대로 유지합니다.

🛠️ Usage

1. Open Sidebar: Click the „ABC Check“ icon in the top right corner of the editor.
2. Choose Checker: Click [Naver] or [Bareun] depending on your text length. (Content is auto-copied).
3. Check & Copy: Correct your spelling on the external site and copy the result.
4. Apply: Paste the result into the sidebar and click [Apply to Content].

🛠️ 사용 방법 (Korean)

1. 사이드바 열기: 에디터 우측 상단의 „ABC 맞춤법 검사“ 아이콘을 클릭합니다.
2. 검사기 선택: 글 길이에 따라 [네이버] 또는 [바른] 버튼을 클릭합니다. (본문 내용이 자동으로 복사됩니다).
3. 검사 및 복사: 열린 외부 검사기 창에서 맞춤법을 검사하고 결과물을 복사합니다.
4. 적용하기: 에디터 사이드바의 입력창에 결과물을 붙여넣고 [본문에 적용] 버튼을 누릅니다.

External services

This plugin integrates with third-party external services to provide spelling and grammar correction functionality. Depending on your choice, the following services are utilized:

1. Naver Speller API

* Service: Provided by Naver Corporation.
* Usage: Used to check short sentences and fetch the session passport key securely.
* Data Sent: User’s raw text is sent over HTTPS during spell check.
* Links: Naver Terms of Service, Naver Privacy Policy

1. Bareun AI API

* Service: Provided by Bareun AI.
* Usage: Used as a high-performance spell checking tool for long articles.
* Data Sent: User’s raw text is sent securely over HTTPS.
* Links: Bareun AI Home, Bareun AI Terms of Service, Bareun AI Privacy Policy

🌐 외부 서비스 안내 (Korean)

본 플러그인은 맞춤법 및 문법 교정 기능을 제공하기 위해 서드파티 외부 서비스와 연동합니다. 사용자의 선택에 따라 다음 서비스가 활용됩니다:

1. 네이버 맞춤법 검사기 API

* 제공처: Naver Corporation
* 용도: 짧은 문장 검사 및 보안 세션 패스포트 키 획득
* 전송 데이터: 맞춤법 검사 시 사용자의 원본 텍스트가 HTTPS를 통해 전송됨
* 링크: 네이버 서비스 이용약관, 네이버 개인정보 처리방침

1. 바른 AI API

* 제공처: Bareun AI
* 용도: 긴 문서 및 대량 텍스트 검사를 위한 고성능 맞춤법 교정
* 전송 데이터: 맞춤법 검사 시 사용자의 원본 텍스트가 HTTPS를 통해 안전하게 전송됨
* 링크: 바른 AI 홈, 바른 AI 서비스 이용약관, 바른 AI 개인정보 처리방침

🛠️ Build & Source Code

The human-readable source code of this plugin is fully open and included in the distributed package inside the src/ directory.

To build the minified/production assets:
1. Navigate to the plugin directory: cd wp-content/plugins/namoman-korean-speller
2. Install dependencies: npm install
3. Compile using WordPress scripts: npm run build