=== Braspin Chat ===
Contributors: braspin
Tags: chat, live chat, customer engagement, websocket, super chat
Requires at least: 6.0
Tested up to: 7.0
Requires PHP: 8.0
Stable tag: 1.0.0
License: GPLv2 or later
License URI: https://www.gnu.org/licenses/gpl-2.0.html

Add Braspin Chat to your WordPress site without editing theme files.

== Description ==

Braspin Chat installs the Braspin Chat SDK on public WordPress pages through a simple settings screen.

The plugin is designed for site owners who do not want to edit theme code. After activation, open Braspin Chat in the WordPress side menu, enter the chat identifier and public key from your Braspin dashboard, choose a size preset, and enable the chat.

Main features:

* Choose where to display the chat: entire site, all pages and posts, pages only, posts only, or manually per content item.
* Insert the chat inside a page or post using the `[braspin_chat]` shortcode.
* Insert the chat with the native Braspin Chat Gutenberg block.
* Use the official Braspin production CDN automatically.
* Configure the WebSocket URL provided by Braspin.
* Select Portuguese, English, or Spanish.
* Choose size presets for the chat widget.
* Keep dynamic page mode disabled by default.
* Configure side shortcut, floating chat, minimized mode, mobile half-screen mode, resize handle, z-index, position, and optional colors.
* Preview visual settings and test SDK availability from WordPress admin.
* Organize chat header, shortcut, colors, behavior, and positioning in focused settings groups.
* Clearly distinguish dashboard default colors from optional custom colors.

= External services and privacy =

This plugin loads the Braspin Chat SDK from the official Braspin CDN and connects visitors to the configured Braspin WebSocket domain. These requests are necessary to display and operate the chat.

No Braspin service is contacted while chat display is disabled. The SDK is loaded only on a public page where an administrator has configured and enabled the chat, or when the administrator explicitly runs the connection test.

When enabled, the browser downloads executable JavaScript and CSS from the Braspin CDN and opens a connection to the configured Braspin WebSocket service. Messages and other information voluntarily submitted through the chat, together with technical information required to establish and protect the connection, can be transmitted to Braspin according to the Braspin account configuration, terms and privacy policy. The SDK may use browser storage for session, authentication and chat operation as described in the Braspin privacy policy.

The WordPress plugin itself stores only its configuration options, such as chat identifier, WebSocket URL, public key and display preferences. It does not add analytics or independently transmit WordPress administrator data to Braspin.

Service provider: Braspin
Service URL: https://braspin.com
Privacy policy: https://braspin.com/privacy
Terms: https://braspin.com/terms
SDK CDN: https://cdn.braspin.com/chat/
Support contact: contato@braspin.com

== Installation ==

1. Upload the plugin folder to `/wp-content/plugins/braspin-chat` or install the plugin ZIP from the WordPress admin.
2. Activate the plugin through the Plugins screen.
3. Go to Braspin Chat in the WordPress side menu.
4. Enter the chat identifier created in your Braspin dashboard.
5. Review the WebSocket URL provided by Braspin.
6. Enter the public key if you want to enable Super Chat.
7. Review the language and size options.
8. Choose where the chat should appear and save.
9. If you choose manual mode, edit a page or post and enable Braspin Chat in the editor sidebar.
10. To place the chat inside the content, add a WordPress Shortcode block and use `[braspin_chat]`.

== Frequently Asked Questions ==

= Do I need to edit my WordPress theme? =

No. The plugin loads the Braspin Chat SDK automatically when the chat is enabled.

= Can I enable the chat on only one page or post? =

Yes. In the Braspin Chat settings screen, choose manual mode. Then open the page or post editor and enable Braspin Chat for that content.

= Can I place the chat inside the page content? =

Yes. Add a Shortcode block in the WordPress editor and use `[braspin_chat]`. The shortcode renders the chat inline, without the side shortcut and without floating over the page by default.

You can override global options when needed:

`[braspin_chat width="100%" height="700px" resize="true" title="Page chat"]`

= What is the chat field? =

It is the chat identifier created in the Braspin dashboard.

= What is the public key used for? =

The public key identifies your Braspin account for Super Chat checkout.

= What does dynamic page mode do? =

Dynamic page mode sends the current WordPress URL as the chat page. Keep it disabled if the same chat should be shared across the whole site.

= Does this plugin collect data by itself? =

The plugin stores only its configuration options in WordPress. The Braspin Chat SDK communicates with Braspin services to operate the chat when enabled.

= How can I contact Braspin support? =

Send an email to contato@braspin.com.

== Screenshots ==

1. Main Braspin Chat configuration screen.
2. Grouped appearance settings, live preview and SDK diagnostics.
3. Braspin Chat block in the WordPress editor.

== Changelog ==

= 1.0.0 =
* Add production-ready validation, responsive settings, preview, diagnostics and Gutenberg block.
* Synchronize relevant SDK appearance, positioning and authentication options.
* Add translations, automated quality checks and WordPress.org assets.

= 0.0.13 =
* Update the SDK/plugin release version.

= 0.0.9 =
* Add signup callout to the settings header and keep the chat open by default on new installs.

= 0.0.8 =
* Preserve uppercase and lowercase characters in the chat identifier field.

= 0.0.7 =
* Update the SDK/plugin release version.

= 0.0.6 =
* Add shortcode overrides for all chat options and resize support.

= 0.0.5 =
* Add the entire site display mode and simplify display mode labels.

= 0.0.4 =
* Update the SDK/plugin release version.

= 0.0.3 =
* Move the settings screen to its own WordPress side menu with a chat icon.
* Add display modes for the entire site, pages, posts, all content, or manual per-content activation.

= 0.0.2 =
* Initial version prepared for WordPress.org review.
