=== SNS SHARE · BlueCanvas ===
Tags: social sharing, kakao, naver, share buttons
Requires at least: 6.4
Tested up to: 7.1.2
Requires PHP: 7.4
Stable tag: 2.4.0
License: GPL-2.0-or-later
License URI: https://www.gnu.org/licenses/gpl-2.0.html

카카오톡, Facebook, X, Telegram, 네이버 밴드·블로그와 링크 복사를 지원하는 워드프레스 공유 버튼입니다.

== Description ==

설정 → SNS SHARE에서 공유할 채널, 순서, 표시 위치와 디자인을 선택하세요.
실시간 미리보기로 배치를 확인하고 변경 사항을 저장할 수 있습니다.

* 드래그 또는 위·아래 버튼으로 순서를 바꿀 수 있습니다.
* 본문 위·아래·양쪽, 왼쪽·가운데·오른쪽 정렬을 지원합니다.
* 아이콘만 표시하거나 채널 이름을 함께 표시할 수 있습니다.
* 버튼 모양 3종과 크기 3종을 제공합니다.
* 공개된 개별 글에서만 동작합니다. 목록·피드·미리보기·비밀번호 보호 글에는 표시하지 않습니다.
* 콘텐츠 유형이나 채널을 모두 해제하면 버튼이 표시되지 않습니다.
* 카카오 JavaScript 키가 없으면 카카오톡 버튼은 숨겨집니다.
* 링크 자동 복사가 실패하면 직접 복사할 주소를 보여줍니다.

홈페이지: https://bluecvs.com/sns_share.php
문의: 홈페이지의 공통 접수 폼을 이용해 주세요.

== Installation ==

1. 워드프레스와 PHP가 요구 버전 이상인지 확인하세요. 최신 보안 패치 적용을 권장합니다.
2. 플러그인 → 새 플러그인 추가 → 플러그인 업로드에서 ZIP을 업로드하고 활성화하세요.
3. 설정 → SNS SHARE에서 채널과 디자인을 선택하고 저장하세요.
4. 공개된 게시물을 열어 버튼 위치와 공유 동작을 확인하세요.

= 기존 2.3에서 업데이트 =

사이트를 백업한 뒤 새 ZIP을 업로드하고, 워드프레스가 기존 플러그인을 감지하면
현재 플러그인을 업로드한 파일로 교체하세요. ssb_settings 옵션을 계속 사용하므로
기존 채널·순서·표시 위치·정렬·콘텐츠 유형·유효한 카카오 키를 유지합니다.
새 디자인 항목은 기본값으로 시작합니다.

기존 플러그인이 다른 이름의 폴더에 설치되어 있다면 이전 버전을 먼저 비활성화하세요.
두 버전을 함께 활성화하면 새 버전은 중복 출력을 막기 위해 동작을 보류합니다.
이 플러그인은 제거 시 설정을 삭제하지 않습니다. 설정 초기화는 관리자 화면에서
명시적으로 실행할 수 있으며 카카오 키도 함께 지워집니다.

= 카카오톡 설정 =

1. Kakao Developers에서 앱을 선택하세요.
2. 앱 → 플랫폼 키 → JavaScript 키에서 키를 복사하세요.
3. JavaScript SDK 도메인에 실제 사이트 주소를 등록하세요.
4. 앱 → 제품 링크 관리 → 웹 도메인에 공유할 사이트 도메인을 등록하세요.
5. 플러그인에 JavaScript 키를 입력하고 저장한 뒤 게시물에서 공유를 확인하세요.

REST API 키나 Admin 키를 입력하지 마세요. JavaScript 키는 브라우저에 공개되는 키입니다.
대표 이미지가 있으면 이미지와 요약을 공유하고, 없으면 텍스트와 링크를 공유합니다.
공식 안내: https://developers.kakao.com/docs/ko/kakaotalk-share/js-link

== Frequently Asked Questions ==

= 무료인가요? =
개인·상업용 사이트에서 무료로 사용할 수 있습니다.

= 별도 통계나 추적 기능이 있나요? =
이 플러그인은 자체 분석 서버로 정보를 보내거나 공유 횟수를 수집하지 않습니다.
카카오톡을 켜고 키를 입력한 경우 해당 게시물에서 카카오 CDN의 JavaScript SDK를
불러옵니다. 공유 버튼을 누르면 선택한 서비스로 게시물 주소와 제목이 전달됩니다.
카카오톡은 대표 이미지와 글 요약도 사용합니다. 외부 서비스 이용에는 각 서비스의
정책이 적용됩니다. Facebook 앱 ID나 앱 시크릿을 입력할 필요가 없습니다.

= JavaScript를 끄면 어떻게 되나요? =
일반 공유 링크는 사용할 수 있습니다. 카카오톡과 링크 복사 버튼은 숨겨집니다.
관리자에서는 설정을 저장할 수 있지만 실시간 미리보기와 순서 변경은 제한됩니다.

= 테마에 따라 표시가 다른가요? =
글꼴과 간격은 테마 영향을 받을 수 있습니다. 테마가 표준 the_content 필터와
wp_head/wp_footer를 사용하는지 확인하세요. 특수 페이지 빌더는 별도 조정이 필요할 수 있습니다.
추가 CSS가 필요하면 워드프레스 테마의 추가 CSS 기능을 이용하세요.

== Changelog ==

= 2.4.0 — 2026-10-01 =
* 실시간 미리보기, 모바일 설정 화면, 스타일·모양·크기 선택을 추가했습니다.
* 키보드·터치로 채널 순서를 바꿀 수 있는 버튼을 추가했습니다.
* 콘텐츠 유형을 모두 해제해도 버튼이 표시되던 문제를 수정했습니다.
* 공유 URL의 한글·특수문자 인코딩과 Telegram·네이버·밴드 주소를 정리했습니다.
* 카카오 SDK를 2.8.3으로 갱신하고 무결성 속성 적용을 수정했습니다.
* 카카오 키가 없을 때 버튼을 숨기고, 대표 이미지·텍스트 템플릿을 구분했습니다.
* 링크 복사 권한 거부와 SDK 오류를 처리하고 사용자가 조치할 방법을 안내합니다.
* 설정값을 검증하고, 본문 출력과 CSS·스크립트 로딩 범위를 제한했습니다.
* 기존 ssb_settings 옵션을 유지하고 문서의 잘못된 안내를 정리했습니다.

== Upgrade Notice ==

= 2.4.0 =
워드프레스 6.4 이상, PHP 7.4 이상이 필요합니다. 업데이트 전 사이트를 백업하세요.
기존 설정은 유지됩니다. 카카오톡을 사용하는 경우 도메인 설정을 확인해 주세요.
