WordPress 블로그 운영자가 쿠팡 파트너스 수익을 자동화할 수 있도록 돕는 플러그인입니다. 포스트 작성 시 글 주제에 맞는 쿠팡 상품을 자동으로 검색하여 본문에 삽입하며, 반응형 디자인으로 모바일과 데스크톱 모두에서 최적화된 광고 효과를 제공합니다.

• 포스트별 독립 설정 (NEW!)
  • 글쓰기 우측 메타박스에서 모든 설정 가능
  • 키워드, 상품 개수, 배치 위치를 포스트별로 설정
  • 저장 후 변경되지 않아 일관성 유지
  • 사용자 정의 필드 자동 숨김
• 키워드 자동 추출 (3단계)
  • 1차: 메타박스 'cptag' 값 사용
  • 2차: H1 제목에서 첫 번째 단어 추출
  • 3차: "추천" 키워드로 랜덤 상품 표시
• 개선된 캐싱 시스템 (NEW!)
  • 캐시 키에 키워드 + 상품 개수 포함
  • 정확한 캐시 관리로 설정 변경 즉시 반영
  • 1시간 캐시로 API 호출 최소화
• 스마트 배치 시스템
  • 본문 최하단 (기본값)
  • 마지막 H2 태그 직전
  • 포스트별로 선택 가능
• 디스클레이머 최상단 배치 (NEW!) - 쿠팡 파트너스 정책 완벽 준수
• 반응형 디자인 - 데스크톱 3열 그리드, 모바일 가로 슬라이드
• API Rate Limiting - 분당 10회 제한으로 안정적 운영
• CSS 독립성 강화 (NEW!) - cai- 네임스페이스로 테마 충돌 방지
• 이미지 크기 고정 (NEW!) - 256x256으로 통일하여 빠른 로딩
• 상품 표시 안 함 (NEW!) - 이 포스트에서 쿠팡 상품 표시 안 함 기능 추가

전체 프로세스는 5단계로 구성됩니다:

• (1) 포스트 작성 시 설정
  • 우측 메타박스에서 키워드, 상품 개수, 배치 위치 설정
  • 설정값이 포스트 메타데이터로 저장
  • 저장 후 변경되지 않아 일관성 유지
• (2) 키워드 추출
  • 포스트 로드 시 저장된 키워드 읽기
  • 없으면 H1 제목 → 기본 키워드 순서로 시도
• (3) 상품 검색
  • 포스트별 설정값 적용 (상품 개수, 이미지 크기)
  • 캐시 확인 (키워드 + 상품개수 조합)
  • 캐시 없으면 쿠팡 API 호출
  • HMAC-SHA256 인증 방식 사용
• (4) HTML 생성 및 삽입
  • 디스클레이머를 컨텐츠 최상단에 추가
  • 상품 카드 HTML 생성 (cai- 네임스페이스)
  • 포스트별 배치 위치에 삽입
• (5) 렌더링
  • CSS/JS 파일 로드
  • 반응형 레이아웃 적용
  • 모바일 슬라이드 인터랙션 활성화

1. 워드프레스 관리자 로그인
2. 좌측 메뉴: 플러그인 > 플러그인 추가 > 플러그인 업로드
3. 다운로드한 ZIP 파일 업로드
4. "활성화" 버튼 클릭

1. 쿠팡 파트너스 사이트 접속 (https://partners.coupang.com)
2. 상단 메뉴: 추가기능 → 파트너스 API
3. Access Key, Secret Key, Affiliate ID 발급
4. 워드프레스 관리자: 설정 > Coupang Auto Insert
5. 발급받은 API 정보 입력 후 저장

설정 > Coupang Auto Insert 페이지에서 다음 항목만 설정합니다:

[API 설정]

• Access Key: 쿠팡 API Access Key
• Secret Key: 쿠팡 API Secret Key
• Affiliate ID: 파트너스 ID (예: AF1234567)
• Sub ID: 채널 아이디 (선택사항)

[고급 설정]

• 캐시 유지 시간: 300~86400초 (기본 3600초)
• API 호출 제한: 1~50회/분 (권장 10회)

포스트 편집 화면 우측 "쿠팡 상품 설정" 메타박스 활용

📝 메타박스 구성:

• 🔍 검색 키워드 (cptag)
  • 이 포스트에서 검색할 쿠팡 상품 키워드 입력
  • 예: "노트북", "커피", "화장품"
  • 비워두면 제목에서 자동 추출
• 📦 노출 상품 개수
  • 3~10개 사이로 설정 가능
  • 기본값: 3개
  • 비워두면 기본값 사용
• 📍 배치 위치
  • 본문 최하단 (기본값)
  • 마지막 H2 태그 직전
• 📷 이미지 크기
  • 256x256 고정 (변경 불가)
  • 빠른 로딩과 일관된 디자인 보장

💡 사용 예시:

쿠팡 상품을 표시하고 싶지 않을 때:

• 이 포스트에서 쿠팡 상품 표시 안 함 체크
• 체크 시 나머지 필드 자동 비활성화 (회색 처리)

개선된 캐시 시스템 (v1.5.0):

• 캐시 키에 키워드 + 상품 개수 포함
• "가방 3개"와 "가방 5개"는 별도 캐시
• 포스트 설정 변경 시 자동으로 다른 캐시 사용

캐시 삭제가 필요한 경우:

• 전역 설정 변경 후 즉시 반영이 필요할 때
• 상품 정보 업데이트가 필요할 때
• Rate Limit 초과로 오류 발생 시

캐시 삭제 방법:

1. 설정 > Coupang Auto Insert
2. 하단 "캐시 관리" 섹션
3. "캐시 삭제" 버튼 클릭

• 버전 - v1.5.0 (2025-10-17)
• 라이선스 - GPL v2 or later
• 사용 제한 - 재배포 금지 (상업적 사용 불가능)
• 지원 - 없음 (README.txt 개발 문서 제공)
• 업데이트 - 뉴스레터를 통한 업데이트 제공

A: 기존 포스트는 전역 설정을 계속 사용하지만, 새로 작성하는 포스트부터는 메타박스에서 설정해야 합니다. 기존 포스트도 편집하여 메타박스에서 재설정하는 것을 권장합니다.

A: 포스트별 설정은 해당 포스트에만 적용되며 저장 후 변경되지 않습니다. 전역 설정은 API 키와 고급 설정만 관리하며, 상품 관련 설정은 모두 포스트별로 관리됩니다.

A: 이전에는 같은 키워드로 다른 개수를 요청해도 이전 캐시를 사용했지만, v1.5.0부터는 "가방 3개"와 "가방 5개"가 별도로 캐시되어 정확한 상품 개수가 표시됩니다.

A: 아니요. 쿠팡 파트너스 최종 승인 후 API 키를 발급받아야 사용 가능합니다.

A: 네, 무료 배포 중입니다. 하지만 기술 지원은 제공되지 않으며, README.txt 개발 문서를 참고하여 직접 문제를 해결해야 합니다.

A: 포스트 편집 화면 우측 "쿠팡 상품 설정" 메타박스 최상단의 "🚫 이 포스트에서 쿠팡 상품 표시 안 함" 체크박스를 선택하세요.

체크하면 나머지 설정 필드들이 자동으로 비활성화되며, 해당 포스트에서는 쿠팡 상품이 전혀 표시되지 않습니다.

A: v1.5.0부터는 포스트별로 직접 제어하는 방식으로 변경되었습니다. 각 포스트 편집 시 "상품 표시 안 함" 체크박스를 사용하면 됩니다.

이 방식이 카테고리 예외보다 더 직관적이고 실수가 적으며, 같은 카테고리 내에서도 포스트별로 다르게 설정할 수 있어 유연합니다.

A: 네, 개별 포스트(single post)에서만 자동으로 삽입됩니다. 메인 페이지나 카테고리 페이지에서는 표시되지 않습니다. cptag를 비워두면 해당 포스트에서는 표시되지 않습니다.

A: 캐시된 데이터를 우선적으로 사용하며, 관리자 페이지에 경고 알림이 표시됩니다. 1분 후 자동으로 복구됩니다.

A: 네, 소스 코드를 직접 수정할 수 있습니다. CSS 파일(coupang-products.css)과 PHP 파일을 수정하여 디자인과 기능을 변경할 수 있습니다. 단, 수정 후 재배포는 금지됩니다.

A: 다음 사항을 확인하세요:

• API 키가 올바르게 입력되었는지 확인
• 포스트 메타박스에서 cptag가 입력되었는지 확인
• Rate Limit 초과 여부 확인 (관리자 페이지)
• 캐시 삭제 후 재시도
• WordPress 디버그 모드 활성화하여 에러 로그 확인