=== ESM Web3 Social Connect ===
Contributors: moimland
Tags: social share, contact form, live chat, web3, kakao
Requires at least: 6.4
Tested up to: 7.1
Requires PHP: 7.4
Stable tag: 1.0.7.1
License: GPLv2 or later
License URI: https://www.gnu.org/licenses/gpl-2.0.html

Lightweight customer contact gateway with country-aware social sharing, live-connect links, direct inquiries, and an optional Web3 bridge.

== Description ==

ESM Web3 Social Connect brings several customer contact touchpoints into one lightweight WordPress plugin while keeping each module optional.

The plugin provides three practical contact layers:

1. Social Share — country-profile recommendations with administrator control.
2. Live Connect — lightweight links to messaging and support channels.
3. Direct Contact — a private WordPress inquiry form, inbox, email notification, and privacy tools.

An optional Web3 Bridge detects ESM Platform and exposes a connection point to Web3Home without duplicating wallet, identity, evaluation, reward, NFT, campaign, or airdrop engines.

The plugin works as a standalone WordPress plugin. ESM Platform is not required.

The plugin does not use GeoIP. Country recommendations come from the WordPress site locale or the administrator's explicit selection. Recommendations are editable defaults, never mandatory rules.

The plugin does not send telemetry, analytics, site URLs, administrator email addresses, or usage statistics to the developer.

== Features ==

* Korea-first, global country profile registry.
* Profiles for Korea, Japan, United States, India, Vietnam, Taiwan, Thailand, and Global.
* Sharing services: Facebook, X, Instagram, LinkedIn, WhatsApp, Telegram, LINE, Device Share, Copy Link, KakaoTalk, Naver BAND, and Naver Blog.
* Default article placement after article metadata when a compatible hook is available, otherwise before the main post content.
* Explicit local service icons and labels on desktop and mobile.
* Color and monochrome icon modes.
* Responsive administrator workspace with persistent plugin navigation.
* Bundled ko_KR translation and a POT template for localization.
* Post sharing is enabled by default. Pages are not automatically decorated.
* Global-first share-channel manager with drag-and-drop ordering and a live preview. The saved card order is the public article order.
* Live Connect uses administrator-configured links and does not preload chat SDKs.
* Direct Contact stores inquiries privately in WordPress, sends an email notification, and provides an administrator inbox with New / In progress / Done states.
* WordPress privacy policy helper, personal-data exporter, and personal-data eraser.
* Optional floating Contact Gateway, disabled by default.
* Optional ESM Web3 bridge, disabled by default.
* Legacy Korea SNS detection without automatic deactivation or data mutation.
* Page-cache friendly public sharing markup with no visitor-specific server state.

== Shortcodes ==

`[esm_w3sc_share]`

Renders the social-share bar manually.

`[esm_w3sc_live_connect]`

Renders configured live-connect links.

`[esm_w3sc_contact_form]`

Renders the internal direct-contact form when enabled.

`[esm_w3sc_contact_hub]`

Renders the contact gateway. ESM sites can place this inside an existing canonical mobile or bottom navigation instead of enabling another floating bar.

== External services ==

The plugin connects to third-party services only when a visitor actively clicks a configured share or live-connect button, except that the Kakao JavaScript SDK can be loaded after a KakaoTalk share click when the administrator has configured a Kakao JavaScript key.

KakaoTalk Share:
* Documentation: https://developers.kakao.com/docs/en/kakaotalk-share/js-link
* JavaScript SDK: https://developers.kakao.com/docs/en/javascript/download
* Privacy: https://www.kakao.com/policy/privacy

Naver BAND Share:
* Documentation: https://developers.band.us/develop/guide/share
* Privacy: https://policy.naver.com/policy/privacy.html

LINE Share:
* Documentation: https://developers.line.biz/en/docs/line-social-plugins/install-guide/using-line-share-buttons/
* Privacy: https://line.me/en/terms/policy/

Facebook:
* Service: https://www.facebook.com/
* Privacy: https://www.facebook.com/privacy/policy/

X:
* Service: https://x.com/
* Privacy: https://x.com/en/privacy

LinkedIn:
* Service: https://www.linkedin.com/
* Privacy: https://www.linkedin.com/legal/privacy-policy

WhatsApp:
* Service: https://www.whatsapp.com/
* Privacy: https://www.whatsapp.com/legal/privacy-policy

Telegram:
* Service: https://telegram.org/
* Privacy: https://telegram.org/privacy

ChannelTalk:
* The plugin only opens the administrator-configured ChannelTalk URL. It does not preload the ChannelTalk SDK.

== Privacy ==

Social-share and live-connect buttons are activated by visitor action. The plugin itself does not track visitors.

If Direct Contact is enabled, the site stores the fields entered by the visitor: name, phone number, email, subject, message, source URL, and submission time. This data is used to answer the inquiry. WordPress personal-data export and erase integrations are included.

No IP address is stored by the plugin.

== Installation ==

1. Upload the plugin ZIP from Plugins > Add New > Upload Plugin, or install it from the WordPress.org Plugin Directory after publication.
2. Activate ESM Web3 Social Connect.
3. Open Web3 Social Connect > SNS Share.
4. Review the country profile, icons, and sharing services.
5. Configure a Kakao JavaScript key only if you want KakaoTalk SDK sharing.
6. Enable Live Connect and/or Direct Contact only when needed.
7. ESM Platform sites can optionally enable the Web3 Bridge.

== Frequently Asked Questions ==

= Does the plugin use GeoIP? =

No. It uses the WordPress site locale or an administrator-selected country profile.

= Does it require ESM Platform? =

No. The plugin works standalone. ESM Platform only enables the optional bridge contract.

= Does it add sharing buttons to Pages? =

No, not automatically. It automatically decorates singular Posts only. Use the shortcode for manual placement elsewhere.

= Does it load ChannelTalk or other chat SDKs on every page? =

No. Live Connect uses simple links. The Kakao JavaScript SDK is lazy-loaded after a Kakao share click when a key is configured.

= What happens if the old Korea SNS plugin is active? =

The settings dashboard shows a compatibility warning. ESM Web3 Social Connect never disables or edits another plugin automatically.

== Screenshots ==

1. Dashboard with customer-contact modules and current-site branding.
2. SNS Share settings with country profile and service icon selection.
3. Live Connect settings with channel setup guidance.
4. Direct Contact settings and privacy configuration.
5. Inquiry inbox with status management.
6. Web3 bridge settings.
7. Language and translation status.
8. Frontend article sharing buttons.

== Changelog ==

= 1.0.7.1 =
* Reworded the site-wide contact-hub guidance to use plain site-owner language instead of internal ESM terminology.

= 1.0.7 =
* Added always-visible administrator previews for Live Connect and Direct Contact using the same frontend presentation classes as the public shortcodes.
* Added clear shortcode guidance for Live Connect and expanded placement FAQ for pages, posts, widget areas and Site Editor templates.
* Added a Direct Contact shortcode preview with disabled sample fields to prevent accidental admin submissions.
* Kept the public shortcode behavior unchanged: modules still render publicly only when enabled and configured.

= 1.0.6 =
* Rebuilt the Social Share drag-and-drop manager with delegated initialization so it works even when the admin script is printed after DOMContentLoaded.
* Added reliable desktop HTML5 drag handling plus touch/pen pointer reordering.
* Rebuilt live preview initialization and checkbox event delegation so preview always reflects selected services and saved order.
* Isolated site-icon refresh errors from the Social Share manager so branding cannot stop drag-and-drop or preview initialization.

= 1.0.5 =
* Fixed the Social Share manager card layout so icons, check marks and labels remain aligned across WordPress admin themes.
* Removed per-card Global/Korea channel sublabels and simplified the share-service cards and preview UI.
* Default country profile fallback is now United States, and automatic profile detection reads the WordPress locale first and timezone as a secondary signal.

= 1.0.4 =
* Reworked Social Share administration around a global-first channel order.
* Added Instagram with device-share/copy fallback behavior.
* Added drag-and-drop ordering; the saved order is used on public Posts.
* Added a live share-bar preview that updates while selecting and reordering services.
* Refreshed the product-value banner with customer-facing feature and performance messaging.
* Added a WordPress-native auto-update toggle fallback for this plugin when the WordPress.org update metadata has not populated the Plugins table yet.
* Kept standalone operation, privacy behavior, Direct Contact, Live Connect, and Web3 Bridge unchanged.

= 1.0.3 =
* Restored automatic social-share output on singular Posts in WordPress block/default themes by using a queried-post fallback instead of requiring classic Loop state.
* Hardened administrator banner and notice text contrast for readability across WordPress admin color/customization environments.
* Preserved canonical Site Icon and migrated-site branding continuity from the previous maintenance build.

= 1.0.2 =
* Prefer the raw local WordPress Site Icon attachment for the admin “My Site” brand image.
* Reject stale foreign-host Site Icon URLs so migrated sites fall through to valid local/theme identity sources.

= 1.0.1 =
* Canonical WordPress Site Icon inheritance hotfix for plugin admin branding.

= 1.0.0 =
* First WordPress.org submission release.
* Country-aware social sharing with explicit service icons and labels.
* Live Connect links for messaging and support channels.
* Direct Contact form, private inbox, notification email, and privacy integrations.
* Optional ESM Web3Home bridge.
* Current WordPress site icon and site name inheritance in plugin admin pages.
* Responsive administrator navigation and ko_KR translation support.
* No developer telemetry, remote configuration, license gate, or alternate plugin update channel.
* WordPress.org just-in-time translation loading; no custom translation loader.
