# Image Format Converter Plus - 플러그인 파일 구조

```
image-format-converter/
├── image-format-converter.php (메인 플러그인 파일)
├── includes/
│   ├── class-image-converter.php (이미지 변환 핵심 코드)
│   ├── class-pixabay-api.php (Pixabay API 통합)
│   ├── class-admin-settings.php (관리자 설정 페이지)
│   └── class-core-web-vitals.php (Core Web Vitals 최적화)
├── assets/
│   ├── css/
│   │   ├── admin-style.css (관리자 페이지 스타일)
│   │   └── pixabay-modal.css (Pixabay 모달 스타일)
│   ├── js/
│   │   ├── admin-script.js (관리자 페이지 스크립트)
│   │   ├── pixabay-search.js (Pixabay 검색 스크립트)
│   │   └── gutenberg-integration.js (구텐베르크 통합)
│   └── img/
│       └── pixabay-logo.png (Pixabay 로고)
└── templates/
    └── pixabay-modal.php (Pixabay 검색 모달 템플릿)
	

이미지 포맷 변환기 플러스 - README.txt

플러그인명: 이미지 포맷 변환기 플러스
버전: 1.6
최종 수정일: 2025-06-16
제작자: 호텔천사
제작자 URL: https://webworks.co.kr

==== 플러그인 개요 ====

이 플러그인은 워드프레스 로딩 속도 향상을 위해 업로드되는 이미지를 자동으로 최적화합니다. PNG, JPG 파일을 WebP 형식으로 변환하고 이미지 크기를 자동 조정하며, Core Web Vitals 점수 향상을 위한 다양한 기능을 제공합니다. 또한 Pixabay API를 통해 무료 이미지를 쉽게 검색하고 추가할 수 있는 기능을 제공합니다.

==== 주요 기능 ====

1. 이미지 자동 변환 및 최적화
   - PNG, JPG 이미지를 WebP 형식으로 자동 변환
   - 이미지 크기 자동 조정 (최대, 중간, 작은 크기, 썸네일)
   - 압축률 조정으로 이미지 품질과 파일 크기 최적화
   - 작은 이미지는 크기 유지하고 형식만 변환 (품질 보존)

2. SEO 최적화
   - SEO 친화적인 파일명 관리
   - 자동 alt 태그 최적화
   - 이미지 메타데이터 보존 (선택 가능)

3. Core Web Vitals 최적화
   - 반응형 이미지 구현 (srcset과 sizes 속성 활용)
   - 이미지 지연 로딩 (Lazy Loading)
   - LCP(Largest Contentful Paint) 최적화를 위한 중요 이미지 우선 로드
   - 이미지 치수 명시로 CLS(Cumulative Layout Shift) 방지
   - 개선된 JavaScript 스크립트 로딩 (버그 수정)

4. Pixabay 무료 이미지 통합 (v1.5 신규 기능)
   - 글 작성 화면에서 Pixabay 이미지 검색 및 삽입
   - 다운로드된 이미지 자동 WebP 변환 및 최적화
   - 구텐베르크 편집기 통합

==== 설치 방법 ====

1. 플러그인 파일을 '/wp-content/plugins/image-format-converter/' 디렉토리에 업로드하세요.
2. 워드프레스 관리자 페이지에서 '플러그인' 메뉴로 이동하세요.
3. 플러그인 목록에서 '이미지 포맷 변환기 플러스'를 찾아 활성화하세요.
4. '이미지 관리' 메뉴에서 플러그인 설정을 구성하세요.

==== 필수 환경 ====

- PHP 7.4 이상
- WordPress 5.8 이상
- GD 라이브러리 또는 ImageMagick 지원 (WebP 변환 기능 사용 시)

==== 사용 방법 ====

1. 이미지 자동 변환
   - 플러그인을 활성화한 상태에서 미디어 라이브러리에 이미지를 업로드하면 자동으로 변환됩니다.
   - 관리자 설정에서 이미지 형식별 변환 옵션을 설정할 수 있습니다.

2. Pixabay 무료 이미지 사용
   - 글 작성 화면에서 '픽사베이 이미지 검색' 버튼을 클릭합니다.
   - 검색어를 입력하고 이미지 유형, 방향, 카테고리 등 필터를 설정합니다.
   - 검색 결과에서 원하는 이미지를 클릭하면 자동으로 다운로드되어 글에 삽입됩니다.
   - 다운로드된 이미지는 설정에 따라 자동으로 최적화됩니다.

3. 설정 구성
   - '이미지 관리' 메뉴에서 플러그인의 모든 설정을 구성할 수 있습니다.
   - 이미지 크기, 변환 옵션, SEO 설정, Core Web Vitals 최적화, Pixabay 통합 등 다양한 설정이 가능합니다.

==== 자주 묻는 질문 ====

Q: WebP 변환이 작동하지 않습니다. 어떻게 해야 하나요?
A: PHP에 GD 라이브러리가 설치되어 있고 WebP 지원이 활성화되어 있는지 확인하세요. 서버 환경에 따라 지원되지 않을 수 있습니다. 이 경우 플러그인은 자동으로 JPEG로 폴백합니다.

Q: 이미 업로드된 이미지는 어떻게 변환하나요?
A: 현재 버전은 새로 업로드되는 이미지만 자동 변환합니다. 기존 이미지는 별도의 이미지 일괄 변환 플러그인을 사용하시는 것을 권장합니다.

Q: Pixabay 이미지 사용 시 저작권 문제는 없나요?
A: Pixabay의 이미지는 무료로 사용 가능하며 상업적 용도로도 사용할 수 있습니다. 단, 가능한 경우 출처를 명시하는 것이 좋습니다.

Q: Core Web Vitals 점수가 얼마나 향상되나요?
A: 사이트 구조와 이미지 사용량에 따라 달라지지만, 대부분의 경우 LCP와 CLS 점수가 크게 개선됩니다. 특히 이미지가 많은 사이트에서 효과적입니다.

==== 변경 내역 ====
버전 1.6 (2025-06-16)
- Core Web Vitals 최적화 관련 JavaScript 출력 버그 수정
- LCP 버퍼링 스크립트가 콘텐츠 영역에 텍스트로 표시되는 문제 해결
- JavaScript 코드를 wp_footer 액션으로 이동하여 올바른 위치에 출력되도록 개선
- 코드 안정성 및 성능 향상

버전 1.5 (2025-04-21)
- Pixabay API 통합 기능 추가
- 구텐베르크 에디터 통합
- Core Web Vitals 최적화 기능 추가 (지연 로딩, 이미지 치수 명시, LCP 최적화)
- 코드 구조 개선 및 모듈화
- 관리자 인터페이스 개선

버전 1.0 (2025-04-19)
- 최초 릴리스
- PNG, JPG, WEBP 이미지 자동 변환 및 압축
- 반응형 이미지 리사이징
- SEO 최적화 (파일명, alt 태그)

==== 개발자 정보 ====

이 플러그인은 워드프레스 사이트의 이미지 최적화와 로딩 속도 향상을 위해 개발되었습니다. 문의사항이나 버그 리포트는 아래 연락처로 보내주세요.

개발자: 호텔천사
웹사이트: https://webworks.co.kr
이메일: contact@webworks.co.kr

==== 라이선스 ====

이 플러그인은 GPL v2 이상의 라이선스를 따릅니다.